[{"data":1,"prerenderedAt":315},["ShallowReactive",2],{"doc:\u002Fguides\u002Fcompatibility":3,"nav:guides":266},{"doc":4,"source":265},{"id":5,"title":6,"body":7,"description":251,"extension":258,"meta":259,"navigation":260,"path":261,"seo":262,"stem":263,"__hash__":264},"guides\u002Fguides\u002Fcompatibility.md","Version compatibility",{"type":8,"value":9,"toc":250},"minimark",[10,14,19,23,27,30,65,77,81,152,178,187,191,194],[11,12,6],"h1",{"id":13},"version-compatibility",[15,16,18],"h2",{"id":17},"zig","Zig",[20,21,22],"p",{},"zig-pkl builds with Zig 0.17.0. CI also builds and tests against Zig master, but that job does not block releases and master is not supported.",[15,24,26],{"id":25},"pkl","Pkl",[20,28,29],{},"Evaluation works with Pkl 0.25.3 and newer. CI runs the conformance suite, the integration tests, and every example against the latest patch release of each minor version:",[31,32,33,45],"table",{},[34,35,36],"thead",{},[37,38,39,42],"tr",{},[40,41,26],"th",{},[40,43,44],{},"Status",[46,47,48,57],"tbody",{},[37,49,50,54],{},[51,52,53],"td",{},"0.25.3, 0.26.3, 0.27.2, 0.28.2, 0.29.1, 0.30.2, 0.31.1",[51,55,56],{},"tested on Linux x86_64",[37,58,59,62],{},[51,60,61],{},"0.32.2",[51,63,64],{},"tested on Linux x86_64 and aarch64, macOS aarch64, and Windows x86_64",[20,66,67,68,72,73,76],{},"Code generation needs Pkl 0.32.2. ",[69,70,71],"code",{},"zig_pkl.supported_pkl"," is the newest release tested, and ",[69,74,75],{},"zig_pkl.version.minimum_supported"," the oldest.",[15,78,80],{"id":79},"settings-that-need-a-newer-release","Settings that need a newer release",[31,82,83,93],{},[34,84,85],{},[37,86,87,90],{},[40,88,89],{},"Setting",[40,91,92],{},"Oldest Pkl",[46,94,95,109,122,132,142],{},[37,96,97,106],{},[51,98,99,102,103],{},[69,100,101],{},"http.proxy",", ",[69,104,105],{},"http.ca_certificates",[51,107,108],{},"0.26",[37,110,111,119],{},[51,112,113,102,116],{},[69,114,115],{},"external_module_readers",[69,117,118],{},"external_resource_readers",[51,120,121],{},"0.27",[37,123,124,129],{},[51,125,126],{},[69,127,128],{},"http.rewrites",[51,130,131],{},"0.29",[37,133,134,139],{},[51,135,136],{},[69,137,138],{},"trace_mode",[51,140,141],{},"0.30",[37,143,144,149],{},[51,145,146],{},[69,147,148],{},"http.headers",[51,150,151],{},"0.32",[20,153,154,157,158,161,162,165,166,169,170,173,174,177],{},[69,155,156],{},"createEvaluator"," checks these against the server version and fails with ",[69,159,160],{},"error.UnsupportedVersion"," instead of sending a request that an older server would misread or ignore. The version is learned lazily: options that every supported release accepts are sent without asking, and the first options that need a newer release start ",[69,163,164],{},"pkl --version"," in the background while the request is in flight. Pass ",[69,167,168],{},"InitOptions.version = .{ .known = version }"," to ",[69,171,172],{},"Manager.initWithOptions"," when you already know the version, or ",[69,175,176],{},".unchecked"," to skip the check.",[20,179,180,183,184,186],{},[69,181,182],{},"zig_pkl.getVersion(allocator, io, \"pkl\")"," runs ",[69,185,164],{}," and parses the result.",[15,188,190],{"id":189},"behavior-that-differs-by-release","Behavior that differs by release",[20,192,193],{},"These are differences in Pkl that zig-pkl smooths over or that show up in your programs:",[195,196,197,209,220,230,243],"ul",{},[198,199,200,201,204,205,208],"li",{},"Pkl before 0.30 sends class and type alias values without a name or module URI. zig-pkl decodes them with empty ",[69,202,203],{},"name"," and ",[69,206,207],{},"module_uri",".",[198,210,211,214,215,208],{},[69,212,213],{},"resolvedEvaluatorSettings"," exists only from Pkl 0.32. zig-pkl resolves project paths itself, so projects behave the same on every release; see ",[216,217,219],"a",{"href":218},"projects","Projects",[198,221,222,225,226,229],{},[69,223,224],{},"output.bytes"," exists from Pkl 0.29, and ",[69,227,228],{},"Bytes"," values from 0.29.",[198,231,232,233,235,236,239,240,208],{},"Pkl before 0.29 exits when an allow list entry is not a valid regular expression, so ",[69,234,156],{}," fails with ",[69,237,238],{},"error.Closed"," rather than ",[69,241,242],{},"error.Rejected",[198,244,245,246,249],{},"Pkl 0.30 and newer exit when an evaluator has no allowed modules. zig-pkl refuses those options with ",[69,247,248],{},"error.NoAllowedModules"," on every release.",{"title":251,"searchDepth":252,"depth":252,"links":253},"",2,[254,255,256,257],{"id":17,"depth":252,"text":18},{"id":25,"depth":252,"text":26},{"id":79,"depth":252,"text":80},{"id":189,"depth":252,"text":190},"md",{},true,"\u002Fguides\u002Fcompatibility",{"title":6,"description":251},"guides\u002Fcompatibility","4z7haktKi1euvc3stME8pE69V0HT70YeYoAeptWp5UU","docs\u002Fguides\u002Fcompatibility.md",[267,268,272,276,280,284,288,292,296,300,303,307,311],{"title":6,"path":261,"stem":263},{"title":269,"path":270,"stem":271},"Concurrency","\u002Fguides\u002Fconcurrency","guides\u002Fconcurrency",{"title":273,"path":274,"stem":275},"Errors","\u002Fguides\u002Ferrors","guides\u002Ferrors",{"title":277,"path":278,"stem":279},"Evaluation","\u002Fguides\u002Fevaluation","guides\u002Fevaluation",{"title":281,"path":282,"stem":283},"External readers","\u002Fguides\u002Fexternal-readers","guides\u002Fexternal-readers",{"title":285,"path":286,"stem":287},"Installation","\u002Fguides\u002Finstallation","guides\u002Finstallation",{"title":289,"path":290,"stem":291},"Logging","\u002Fguides\u002Flogging","guides\u002Flogging",{"title":293,"path":294,"stem":295},"Migrating from pkl-zig","\u002Fguides\u002Fmigration","guides\u002Fmigration",{"title":297,"path":298,"stem":299},"Ownership","\u002Fguides\u002Fownership","guides\u002Fownership",{"title":219,"path":301,"stem":302},"\u002Fguides\u002Fprojects","guides\u002Fprojects",{"title":304,"path":305,"stem":306},"Quick start","\u002Fguides\u002Fquickstart","guides\u002Fquickstart",{"title":308,"path":309,"stem":310},"Readers","\u002Fguides\u002Freaders","guides\u002Freaders",{"title":312,"path":313,"stem":314},"Security","\u002Fguides\u002Fsecurity","guides\u002Fsecurity",1792908673088]