@rhinostone/swig 2.1.0 → 2.3.0

package/.playwright-mcp/page-2026-04-22T15-51-54-206Z.yml

@@ -1,676 +0,0 @@
-- generic [ref=e2]:
-  - region "Skip to main content":
-    - link "Skip to main content" [ref=e3] [cursor=pointer]:
-      - /url: "#__docusaurus_skipToContent_fallback"
-  - navigation "Main" [ref=e4]:
-    - generic [ref=e5]:
-      - generic [ref=e6]:
-        - link "Gina logo Gina" [ref=e7] [cursor=pointer]:
-          - /url: /docs/
-          - img "Gina logo" [ref=e9]
-          - generic [ref=e10]: Gina
-        - link "Docs" [ref=e11] [cursor=pointer]:
-          - /url: /docs/intro
-        - link "Tutorials" [ref=e12] [cursor=pointer]:
-          - /url: /docs/tutorials
-        - link "Swig" [ref=e13] [cursor=pointer]:
-          - /url: /docs/swig/
-        - link "Roadmap" [ref=e14] [cursor=pointer]:
-          - /url: /docs/roadmap
-      - generic [ref=e15]:
-        - link "v0.3.6(opens in new tab)" [ref=e16] [cursor=pointer]:
-          - /url: https://github.com/gina-io/gina/releases
-          - text: v0.3.6
-          - img "(opens in new tab)" [ref=e17]
-        - link "GitHub(opens in new tab)" [ref=e19] [cursor=pointer]:
-          - /url: https://github.com/gina-io/gina
-          - text: GitHub
-          - img "(opens in new tab)" [ref=e20]
-        - button "Switch between dark and light mode (currently system mode)" [disabled] [ref=e23]:
-          - img [ref=e24]
-        - textbox "Search" [ref=e28]
-  - generic [ref=e31]:
-    - complementary [ref=e32]:
-      - generic [ref=e33]:
-        - generic [ref=e34]:
-          - link "@rhinostone/swig v1.6.0" [ref=e35] [cursor=pointer]:
-            - /url: https://www.npmjs.com/package/@rhinostone/swig
-            - generic [ref=e36]: "@rhinostone/swig"
-            - generic [ref=e37]: v1.6.0
-          - link "gina-io/swig on GitHub" [ref=e38] [cursor=pointer]:
-            - /url: https://github.com/gina-io/swig
-            - img [ref=e39]
-        - navigation "Docs sidebar" [ref=e42]:
-          - list [ref=e43]:
-            - listitem [ref=e44]:
-              - link "Overview" [ref=e45] [cursor=pointer]:
-                - /url: /docs/swig/
-                - img [ref=e47]
-                - generic "Overview" [ref=e50]
-            - listitem [ref=e51]:
-              - link "Getting Started" [ref=e52] [cursor=pointer]:
-                - /url: /docs/swig/getting-started
-                - img [ref=e54]
-                - generic "Getting Started" [ref=e59]
-            - listitem [ref=e60]:
-              - link "Template Syntax" [ref=e61] [cursor=pointer]:
-                - /url: /docs/swig/syntax
-                - img [ref=e63]
-                - generic "Template Syntax" [ref=e66]
-            - listitem [ref=e67]:
-              - link "Tags" [ref=e68] [cursor=pointer]:
-                - /url: /docs/swig/tags
-                - img [ref=e70]
-                - generic "Tags" [ref=e72]
-            - listitem [ref=e73]:
-              - link "Filters" [ref=e74] [cursor=pointer]:
-                - /url: /docs/swig/filters
-                - img [ref=e76]
-                - generic "Filters" [ref=e78]
-            - listitem [ref=e79]:
-              - link "API" [ref=e80] [cursor=pointer]:
-                - /url: /docs/swig/api
-                - img [ref=e82]
-                - generic "API" [ref=e85]
-            - listitem [ref=e86]:
-              - link "Loaders" [ref=e87] [cursor=pointer]:
-                - /url: /docs/swig/loaders
-                - img [ref=e89]
-                - generic "Loaders" [ref=e93]
-            - listitem [ref=e94]:
-              - link "Extending Swig" [ref=e95] [cursor=pointer]:
-                - /url: /docs/swig/extending
-                - img [ref=e97]
-                - generic "Extending Swig" [ref=e99]
-            - listitem [ref=e100]:
-              - link "CLI" [ref=e101] [cursor=pointer]:
-                - /url: /docs/swig/cli
-                - img [ref=e103]
-                - generic "CLI" [ref=e105]
-            - listitem [ref=e106]:
-              - link "Browser Usage" [ref=e107] [cursor=pointer]:
-                - /url: /docs/swig/browser
-                - img [ref=e109]
-                - generic "Browser Usage" [ref=e111]
-            - listitem [ref=e112]:
-              - link "Security" [ref=e113] [cursor=pointer]:
-                - /url: /docs/swig/security
-                - img [ref=e115]
-                - generic "Security" [ref=e117]
-            - listitem [ref=e118]:
-              - generic [ref=e119]:
-                - link "Twig Frontend" [ref=e120] [cursor=pointer]:
-                  - /url: /docs/swig/twig/
-                  - generic "Twig Frontend" [ref=e121]
-                - button "Collapse sidebar category 'Twig Frontend'" [expanded] [ref=e122] [cursor=pointer]
-              - list [ref=e123]:
-                - listitem [ref=e124]:
-                  - link "Parity" [ref=e125] [cursor=pointer]:
-                    - /url: /docs/swig/twig/parity
-                    - generic "Parity" [ref=e126]
-                - listitem [ref=e127]:
-                  - link "Non-Goals" [ref=e128] [cursor=pointer]:
-                    - /url: /docs/swig/twig/non-goals
-                    - generic "Non-Goals" [ref=e129]
-                - listitem [ref=e130]:
-                  - link "From upstream Twig" [ref=e131] [cursor=pointer]:
-                    - /url: /docs/swig/twig/migration
-                    - generic "From upstream Twig" [ref=e132]
-                - listitem [ref=e133]:
-                  - link "Browser Usage" [ref=e134] [cursor=pointer]:
-                    - /url: /docs/swig/twig/browser
-                    - img [ref=e136]
-                    - generic "Browser Usage" [ref=e138]
-            - listitem [ref=e139]:
-              - link "Migration Guide" [ref=e140] [cursor=pointer]:
-                - /url: /docs/swig/migration
-                - img [ref=e142]
-                - generic "Migration Guide" [ref=e144]
-    - main [ref=e145]:
-      - generic [ref=e147]:
-        - generic [ref=e149]:
-          - article [ref=e150]:
-            - navigation "Breadcrumbs" [ref=e151]:
-              - list [ref=e152]:
-                - listitem [ref=e153]:
-                  - link "Home page" [ref=e154] [cursor=pointer]:
-                    - /url: /docs/
-                    - img [ref=e155]
-                - listitem [ref=e157]:
-                  - link "Twig Frontend" [ref=e158] [cursor=pointer]:
-                    - /url: /docs/swig/twig/
-                - listitem [ref=e159]:
-                  - generic [ref=e160]: Non-Goals
-            - generic [ref=e161]:
-              - heading "Twig Non-Goals" [level=1] [ref=e163]
-              - generic [ref=e164]:
-                - generic [ref=e165]:
-                  - generic [ref=e166]:
-                    - img [ref=e167]
-                    - text: 6 min read
-                  - generic [ref=e170]: Intermediate
-                - generic [ref=e171]:
-                  - generic [ref=e172]: Prerequisites
-                  - list [ref=e173]:
-                    - listitem [ref=e174]:
-                      - link "Overview" [ref=e175] [cursor=pointer]:
-                        - /url: /docs/swig/twig/
-                    - listitem [ref=e176]:
-                      - link "Parity" [ref=e177] [cursor=pointer]:
-                        - /url: /docs/swig/twig/parity
-                    - listitem [ref=e178]:
-                      - link "Security — the parser is the boundary" [ref=e179] [cursor=pointer]:
-                        - /url: /docs/swig/security#the-parser-is-the-boundary
-              - paragraph [ref=e180]:
-                - code [ref=e181]: "@rhinostone/swig-twig"
-                - text: is a
-                - strong [ref=e182]: strict subset
-                - text: of upstream PHP Twig. Syntax outside the subset throws at parse time rather than silently producing a template that behaves differently from upstream. This page enumerates each rejection, the error message produced, and the rationale.
-              - paragraph [ref=e183]: "The rejections fall into three buckets:"
-              - list [ref=e184]:
-                - listitem [ref=e185]:
-                  - strong [ref=e186]: Sandbox / extension tags
-                  - text: that rely on runtime features swig-core does not expose.
-                - listitem [ref=e187]:
-                  - strong [ref=e188]: Deferred features
-                  - text: that will likely ship later but need dedicated IR design work.
-                - listitem [ref=e189]:
-                  - strong [ref=e190]: Intentional security rejections
-                  - text: where silent acceptance would weaken the CVE-2023-25345 guard perimeter.
-              - heading "Unsupported tagsDirect link to Unsupported tags" [level=2] [ref=e191]:
-                - text: Unsupported tags
-                - link "Direct link to Unsupported tags" [ref=e192] [cursor=pointer]:
-                  - /url: "#unsupported-tags"
-                  - text: "#"
-              - paragraph [ref=e193]:
-                - text: All of the following throw a generic
-                - code [ref=e194]: Unexpected tag "<name>"
-                - text: "error at parse time. They split into two categories:"
-              - list [ref=e195]:
-                - listitem [ref=e196]:
-                  - strong [ref=e197]: Won't support (security).
-                  - text: Threat-model calls; unlikely to change.
-                - listitem [ref=e198]:
-                  - strong [ref=e199]: Deferred.
-                  - text: Design work awaiting demand —
-                  - link "open an issue" [ref=e200] [cursor=pointer]:
-                    - /url: https://github.com/gina-io/swig/issues
-                  - text: if you hit one.
-              - heading "Won't support (security)Direct link to Won't support (security)" [level=3] [ref=e201]:
-                - text: Won't support (security)
-                - link "Direct link to Won't support (security)" [ref=e202] [cursor=pointer]:
-                  - /url: "#wont-support-security"
-                  - text: "#"
-              - table [ref=e203]:
-                - rowgroup [ref=e204]:
-                  - row "Tag Upstream purpose Why rejected" [ref=e205]:
-                    - columnheader "Tag" [ref=e206]
-                    - columnheader "Upstream purpose" [ref=e207]
-                    - columnheader "Why rejected" [ref=e208]
-                - rowgroup [ref=e209]:
-                  - 'row "{% sandbox %} Restrict the template runtime (whitelist tags, filters, functions). swig-twig''s threat model declares template source trusted (see Security — the parser is the boundary). Inverting that requires closing runtime bracket access (foo[varname] where varname resolves to \"__proto__\" — a known unclosable gap), re-auditing every .safe=true filter as attacker-reachable, and accepting that new Function(...) compiles the attacker-controlled source. A partial sandbox that users trust is strictly worse than none." [ref=e210]':
-                    - 'cell "{% sandbox %}" [ref=e211]':
-                      - code [ref=e212]: "{% sandbox %}"
-                    - cell "Restrict the template runtime (whitelist tags, filters, functions)." [ref=e213]
-                    - cell "swig-twig's threat model declares template source trusted (see Security — the parser is the boundary). Inverting that requires closing runtime bracket access (foo[varname] where varname resolves to \"__proto__\" — a known unclosable gap), re-auditing every .safe=true filter as attacker-reachable, and accepting that new Function(...) compiles the attacker-controlled source. A partial sandbox that users trust is strictly worse than none." [ref=e214]:
-                      - text: swig-twig's threat model declares template source trusted (see
-                      - link "Security — the parser is the boundary" [ref=e215] [cursor=pointer]:
-                        - /url: /docs/swig/security#the-parser-is-the-boundary
-                      - text: ). Inverting that requires closing runtime bracket access (
-                      - code [ref=e216]: foo[varname]
-                      - text: where varname resolves to
-                      - code [ref=e217]: "\"__proto__\""
-                      - text: — a
-                      - link "known unclosable gap" [ref=e218] [cursor=pointer]:
-                        - /url: /docs/swig/security#what-the-guards-do-not-protect-against
-                      - text: ), re-auditing every
-                      - code [ref=e219]: .safe=true
-                      - text: filter as attacker-reachable, and accepting that
-                      - code [ref=e220]: new Function(...)
-                      - text: compiles the attacker-controlled source. A partial sandbox that users trust is strictly worse than none.
-                  - 'row "{% do %} Evaluate an expression for its side effects. Every token-swallowing tag is a new _dangerousProps audit site, duplicated across frontend and backend (see CVE-2023-25345 Phase 2). Small surface widening, for pure sugar over {{ foo.method() }} — autoescape already discards the return value." [ref=e221]':
-                    - 'cell "{% do %}" [ref=e222]':
-                      - code [ref=e223]: "{% do %}"
-                    - cell "Evaluate an expression for its side effects." [ref=e224]
-                    - 'cell "Every token-swallowing tag is a new _dangerousProps audit site, duplicated across frontend and backend (see CVE-2023-25345 Phase 2). Small surface widening, for pure sugar over {{ foo.method() }} — autoescape already discards the return value." [ref=e225]':
-                      - text: Every token-swallowing tag is a new
-                      - code [ref=e226]: _dangerousProps
-                      - text: audit site, duplicated across frontend and backend (see
-                      - link "CVE-2023-25345 Phase 2" [ref=e227] [cursor=pointer]:
-                        - /url: /docs/swig/security#cve-2023-25345--arbitrary-code-execution-via-__proto__
-                      - text: ). Small surface widening, for pure sugar over
-                      - code [ref=e228]: "{{ foo.method() }}"
-                      - text: — autoescape already discards the return value.
-              - heading "DeferredDirect link to Deferred" [level=3] [ref=e229]:
-                - text: Deferred
-                - link "Direct link to Deferred" [ref=e230] [cursor=pointer]:
-                  - /url: "#deferred"
-                  - text: "#"
-              - table [ref=e231]:
-                - rowgroup [ref=e232]:
-                  - row "Tag Upstream purpose Why not yet" [ref=e233]:
-                    - columnheader "Tag" [ref=e234]
-                    - columnheader "Upstream purpose" [ref=e235]
-                    - columnheader "Why not yet" [ref=e236]
-                - rowgroup [ref=e237]:
-                  - 'row "{% embed %} Include with block-override. Compound of include + block remapping. Most commonly requested of the three — likely to ship in a later minor if demand shows up." [ref=e238]':
-                    - 'cell "{% embed %}" [ref=e239]':
-                      - code [ref=e240]: "{% embed %}"
-                    - cell "Include with block-override." [ref=e241]
-                    - cell "Compound of include + block remapping. Most commonly requested of the three — likely to ship in a later minor if demand shows up." [ref=e242]:
-                      - text: Compound of
-                      - code [ref=e243]: include
-                      - text: + block remapping. Most commonly requested of the three — likely to ship in a later minor if demand shows up.
-                  - 'row "{% use %} Pull blocks in from a \"trait\" template without inheriting it. Block composition is expressible via extends + include today. Needs a dedicated IR node." [ref=e244]':
-                    - 'cell "{% use %}" [ref=e245]':
-                      - code [ref=e246]: "{% use %}"
-                    - cell "Pull blocks in from a \"trait\" template without inheriting it." [ref=e247]
-                    - cell "Block composition is expressible via extends + include today. Needs a dedicated IR node." [ref=e248]:
-                      - text: Block composition is expressible via
-                      - code [ref=e249]: extends
-                      - text: +
-                      - code [ref=e250]: include
-                      - text: today. Needs a dedicated IR node.
-                  - 'row "{% deprecated %} Emit a deprecation warning from within a template. Trivial to build; low demand in swig-twig''s likely audience." [ref=e251]':
-                    - 'cell "{% deprecated %}" [ref=e252]':
-                      - code [ref=e253]: "{% deprecated %}"
-                    - cell "Emit a deprecation warning from within a template." [ref=e254]
-                    - cell "Trivial to build; low demand in swig-twig's likely audience." [ref=e255]
-              - paragraph [ref=e256]: "If you need one of these, either:"
-              - list [ref=e257]:
-                - listitem [ref=e258]:
-                  - text: Express the same intent with supported tags (e.g.
-                  - code [ref=e259]: extends
-                  - text: +
-                  - code [ref=e260]: block
-                  - text: for trait-style composition).
-                - listitem [ref=e261]:
-                  - text: Register a
-                  - link "custom tag" [ref=e262] [cursor=pointer]:
-                    - /url: /docs/swig/extending#custom-tags
-                  - text: scoped to your application.
-                - listitem [ref=e263]:
-                  - link "Open an issue" [ref=e264] [cursor=pointer]:
-                    - /url: https://github.com/gina-io/swig/issues
-                  - text: with a concrete use case — especially for the "Deferred" rows.
-              - heading "Macro kwargsDirect link to Macro kwargs" [level=2] [ref=e265]:
-                - text: Macro kwargs
-                - link "Direct link to Macro kwargs" [ref=e266] [cursor=pointer]:
-                  - /url: "#macro-kwargs"
-                  - text: "#"
-              - paragraph [ref=e267]: "Upstream Twig supports positional and keyword macro calls:"
-              - code [ref=e271]:
-                - generic [ref=e272]: "{% macro field(name, value=null, class=\"\") %}…{% endmacro %}"
-                - generic [ref=e273]: "{{ field(\"email\", value=user.email, class=\"required\") }}"
-              - paragraph [ref=e274]:
-                - text: swig-twig accepts the positional form —
-                - code [ref=e275]: "{{ field(\"email\", user.email, \"required\") }}"
-                - text: — but
-                - strong [ref=e276]: rejects the keyword-argument form
-                - text: . Lowering kwargs needs a per-macro parameter map in the IR, plus a runtime dispatcher in
-                - code [ref=e277]: swig-core
-                - text: . That landed on the Phase 4 target list but slipped past alpha.5.
-              - paragraph [ref=e278]: "Workarounds:"
-              - list [ref=e279]:
-                - listitem [ref=e280]:
-                  - text: "Pass an object literal and destructure inside the macro:"
-                  - code [ref=e284]:
-                    - generic [ref=e285]: "{% macro field(args) %}{{ args.name }} — {{ args.class ?? \"\" }}{% endmacro %}"
-                    - generic [ref=e286]: "{{ field({ name: \"email\", class: \"required\" }) }}"
-                - listitem [ref=e287]: Order positional parameters from most-commonly-passed to least-commonly-passed so defaults "fall off the right."
-              - 'heading "Dynamic {% extends %} and {% from %}Direct link to dynamic--extends--and--from-" [level=2] [ref=e288]':
-                - text: Dynamic
-                - code [ref=e289]: "{% extends %}"
-                - text: and
-                - code [ref=e290]: "{% from %}"
-                - link "Direct link to dynamic--extends--and--from-" [ref=e291] [cursor=pointer]:
-                  - /url: "#dynamic--extends--and--from-"
-                  - text: "#"
-              - paragraph [ref=e292]:
-                - text: Both tags require the path to be a
-                - strong [ref=e293]: string literal
-                - text: ". Expressions throw:"
-              - table [ref=e294]:
-                - rowgroup [ref=e295]:
-                  - row "Shape Accepted? Error" [ref=e296]:
-                    - columnheader "Shape" [ref=e297]
-                    - columnheader "Accepted?" [ref=e298]
-                    - columnheader "Error" [ref=e299]
-                - rowgroup [ref=e300]:
-                  - 'row "{% extends \"base.twig\" %} Yes —" [ref=e301]':
-                    - 'cell "{% extends \"base.twig\" %}" [ref=e302]':
-                      - code [ref=e303]: "{% extends \"base.twig\" %}"
-                    - cell "Yes" [ref=e304]
-                    - cell "—" [ref=e305]
-                  - 'row "{% extends parent_template %} No Dynamic \"extends\" is not supported — parent path must be a string literal" [ref=e306]':
-                    - 'cell "{% extends parent_template %}" [ref=e307]':
-                      - code [ref=e308]: "{% extends parent_template %}"
-                    - cell "No" [ref=e309]
-                    - cell "Dynamic \"extends\" is not supported — parent path must be a string literal" [ref=e310]:
-                      - code [ref=e311]: Dynamic "extends" is not supported — parent path must be a string literal
-                  - 'row "{% extends cond ? \"a.twig\" : \"b.twig\" %} No Same as above." [ref=e312]':
-                    - 'cell "{% extends cond ? \"a.twig\" : \"b.twig\" %}" [ref=e313]':
-                      - code [ref=e314]: "{% extends cond ? \"a.twig\" : \"b.twig\" %}"
-                    - cell "No" [ref=e315]
-                    - cell "Same as above." [ref=e316]
-                  - 'row "{% from \"macros.twig\" import foo %} Yes —" [ref=e317]':
-                    - 'cell "{% from \"macros.twig\" import foo %}" [ref=e318]':
-                      - code [ref=e319]: "{% from \"macros.twig\" import foo %}"
-                    - cell "Yes" [ref=e320]
-                    - cell "—" [ref=e321]
-                  - 'row "{% from dynamic_path import foo %} No Dynamic \"from\" is not supported — path must be a string literal" [ref=e322]':
-                    - 'cell "{% from dynamic_path import foo %}" [ref=e323]':
-                      - code [ref=e324]: "{% from dynamic_path import foo %}"
-                    - cell "No" [ref=e325]
-                    - cell "Dynamic \"from\" is not supported — path must be a string literal" [ref=e326]:
-                      - code [ref=e327]: Dynamic "from" is not supported — path must be a string literal
-              - paragraph [ref=e328]:
-                - text: "Rationale: swig's"
-                - code [ref=e329]: getParents()
-                - text: walks the inheritance chain at parse time so it can cache compiled templates by resolved filename. A dynamic parent would either break that caching (recompile on every render) or require a runtime loader path that none of the built-in loaders support today. The string-literal requirement keeps compiled output deterministic and lets the shared cache work.
-              - paragraph [ref=e330]:
-                - text: "Workaround:"
-                - strong [ref=e331]: dispatch in the caller
-                - text: and render the selected template directly.
-              - code [ref=e335]:
-                - generic [ref=e336]: "var template = (flavor === 'admin') ? 'page_admin.twig' : 'page_public.twig';"
-                - generic [ref=e337]: "twig.renderFile(template, { /* locals */ });"
-              - paragraph [ref=e338]:
-                - text: Wrapping
-                - code [ref=e339]: "{% extends %}"
-                - text: in
-                - code [ref=e340]: "{% if %}"
-                - text: blocks does not work — the parent link is resolved at parse time, so whichever
-                - code [ref=e341]: extends
-                - text: the parser sees last wins regardless of the runtime condition. This applies whether you use the (currently
-                - link "deferred" [ref=e342] [cursor=pointer]:
-                  - /url: "#conditional-branches-deferred"
-                - text: )
-                - code [ref=e343]: "{% if %}…{% else %}…{% endif %}"
-                - text: form or paired
-                - code [ref=e344]: "{% if %}"
-                - text: blocks. Dispatch in the caller is the only working path.
-              - paragraph [ref=e345]:
-                - code [ref=e346]: include
-                - text: is not affected — its path can be any expression.
-              - heading "Bracket-notation setDirect link to bracket-notation-set" [level=2] [ref=e347]:
-                - text: Bracket-notation
-                - code [ref=e348]: set
-                - link "Direct link to bracket-notation-set" [ref=e349] [cursor=pointer]:
-                  - /url: "#bracket-notation-set"
-                  - text: "#"
-              - paragraph [ref=e350]: "Dot-path LHS is supported; bracket-notation LHS throws:"
-              - table [ref=e351]:
-                - rowgroup [ref=e352]:
-                  - row "Shape Accepted? Error" [ref=e353]:
-                    - columnheader "Shape" [ref=e354]
-                    - columnheader "Accepted?" [ref=e355]
-                    - columnheader "Error" [ref=e356]
-                - rowgroup [ref=e357]:
-                  - 'row "{% set foo = 1 %} Yes —" [ref=e358]':
-                    - 'cell "{% set foo = 1 %}" [ref=e359]':
-                      - code [ref=e360]: "{% set foo = 1 %}"
-                    - cell "Yes" [ref=e361]
-                    - cell "—" [ref=e362]
-                  - 'row "{% set foo.bar = 1 %} Yes —" [ref=e363]':
-                    - 'cell "{% set foo.bar = 1 %}" [ref=e364]':
-                      - code [ref=e365]: "{% set foo.bar = 1 %}"
-                    - cell "Yes" [ref=e366]
-                    - cell "—" [ref=e367]
-                  - 'row "{% set foo[\"bar\"] = 1 %} No Bracket-notation assignment is not supported in \"set\" (use dot-path notation)" [ref=e368]':
-                    - 'cell "{% set foo[\"bar\"] = 1 %}" [ref=e369]':
-                      - code [ref=e370]: "{% set foo[\"bar\"] = 1 %}"
-                    - cell "No" [ref=e371]
-                    - cell "Bracket-notation assignment is not supported in \"set\" (use dot-path notation)" [ref=e372]:
-                      - code [ref=e373]: Bracket-notation assignment is not supported in "set" (use dot-path notation)
-                  - 'row "{% set foo[dynamic_key] = 1 %} No Same as above." [ref=e374]':
-                    - 'cell "{% set foo[dynamic_key] = 1 %}" [ref=e375]':
-                      - code [ref=e376]: "{% set foo[dynamic_key] = 1 %}"
-                    - cell "No" [ref=e377]
-                    - cell "Same as above." [ref=e378]
-              - paragraph [ref=e379]:
-                - text: "Rationale: bracket-notation writes at runtime can reach through the prototype chain ("
-                - code [ref=e380]: foo["__proto__"]["x"] = …
-                - text: ) in ways that the parse-time
-                - code [ref=e381]: _dangerousProps
-                - text: check cannot fully enclose. Dot-path writes are statically analysable — each segment is a lexer-validated identifier — and the native swig frontend already went through this audit during
-                - link "CVE-2023-25345 Phase 2" [ref=e382] [cursor=pointer]:
-                  - /url: /docs/swig/security#cve-2023-25345--arbitrary-code-execution-via-__proto__
-                - text: . swig-twig inherits the same perimeter.
-              - heading "Conditional branches (deferred)Direct link to Conditional branches (deferred)" [level=2] [ref=e383]:
-                - text: Conditional branches (deferred)
-                - link "Direct link to Conditional branches (deferred)" [ref=e384] [cursor=pointer]:
-                  - /url: "#conditional-branches-deferred"
-                  - text: "#"
-              - paragraph [ref=e385]:
-                - text: Upstream Twig supports multi-branch conditionals —
-                - code [ref=e386]: "{% if %} … {% elseif %} … {% else %} … {% endif %}"
-                - text: — and an empty-fallback form on
-                - code [ref=e387]: "{% for %}"
-                - text: —
-                - code [ref=e388]: "{% for %} … {% else %} … {% endfor %}"
-                - text: (runs when the iterable is empty). swig-twig alpha.8 ships only the single-branch form.
-              - table [ref=e389]:
-                - rowgroup [ref=e390]:
-                  - row "Shape Accepted? Error" [ref=e391]:
-                    - columnheader "Shape" [ref=e392]
-                    - columnheader "Accepted?" [ref=e393]
-                    - columnheader "Error" [ref=e394]
-                - rowgroup [ref=e395]:
-                  - 'row "{% if x %}…{% endif %} Yes —" [ref=e396]':
-                    - 'cell "{% if x %}…{% endif %}" [ref=e397]':
-                      - code [ref=e398]: "{% if x %}…{% endif %}"
-                    - cell "Yes" [ref=e399]
-                    - cell "—" [ref=e400]
-                  - 'row "{% if x %}…{% else %}…{% endif %} No Unexpected tag \"else\"" [ref=e401]':
-                    - 'cell "{% if x %}…{% else %}…{% endif %}" [ref=e402]':
-                      - code [ref=e403]: "{% if x %}…{% else %}…{% endif %}"
-                    - cell "No" [ref=e404]
-                    - cell "Unexpected tag \"else\"" [ref=e405]:
-                      - code [ref=e406]: Unexpected tag "else"
-                  - 'row "{% if x %}…{% elseif y %}…{% endif %} No Unexpected tag \"elseif\"" [ref=e407]':
-                    - 'cell "{% if x %}…{% elseif y %}…{% endif %}" [ref=e408]':
-                      - code [ref=e409]: "{% if x %}…{% elseif y %}…{% endif %}"
-                    - cell "No" [ref=e410]
-                    - cell "Unexpected tag \"elseif\"" [ref=e411]:
-                      - code [ref=e412]: Unexpected tag "elseif"
-                  - 'row "{% for x in items %}…{% endfor %} Yes —" [ref=e413]':
-                    - 'cell "{% for x in items %}…{% endfor %}" [ref=e414]':
-                      - code [ref=e415]: "{% for x in items %}…{% endfor %}"
-                    - cell "Yes" [ref=e416]
-                    - cell "—" [ref=e417]
-                  - 'row "{% for x in items %}…{% else %}…{% endfor %} No Unexpected tag \"else\"" [ref=e418]':
-                    - 'cell "{% for x in items %}…{% else %}…{% endfor %}" [ref=e419]':
-                      - code [ref=e420]: "{% for x in items %}…{% else %}…{% endfor %}"
-                    - cell "No" [ref=e421]
-                    - cell "Unexpected tag \"else\"" [ref=e422]:
-                      - code [ref=e423]: Unexpected tag "else"
-              - paragraph [ref=e424]:
-                - text: "Rationale: the single-branch shape shipped first to unblock the rest of the Twig parser surface. Multi-branch lowering needs a dedicated branch-chain IR node plus the frontend handler that consumes"
-                - code [ref=e425]: else
-                - text: /
-                - code [ref=e426]: elseif
-                - text: tokens without pushing them on the open-tag stack. Not blocking
-                - code [ref=e427]: 2.0.0
-                - text: stable.
-                - link "Open an issue" [ref=e428] [cursor=pointer]:
-                  - /url: https://github.com/gina-io/swig/issues
-                - text: with a concrete use case to prioritise.
-              - paragraph [ref=e429]: "Workarounds that parse under alpha.8:"
-              - list [ref=e430]:
-                - listitem [ref=e431]:
-                  - strong [ref=e432]:
-                    - code [ref=e433]: "{% if %} / {% else %}"
-                    - text: → two
-                    - code [ref=e434]: if
-                    - text: blocks with
-                    - code [ref=e435]: not
-                    - text: ":"
-                  - code [ref=e439]:
-                    - generic [ref=e440]: "{% if x %}yes{% endif %}"
-                    - generic [ref=e441]: "{% if not x %}no{% endif %}"
-                - listitem [ref=e442]:
-                  - strong [ref=e443]:
-                    - code [ref=e444]: "{% if %} / {% elseif %} / {% else %}"
-                    - text: → nested
-                    - code [ref=e445]: if
-                    - text: ":"
-                  - code [ref=e449]:
-                    - generic [ref=e450]: "{% if x %}a{% endif %}"
-                    - generic [ref=e451]: "{% if not x %}"
-                    - generic [ref=e452]: "{% if y %}b{% endif %}"
-                    - generic [ref=e453]: "{% if not y %}c{% endif %}"
-                    - generic [ref=e454]: "{% endif %}"
-                  - text: Uglier than the native form but semantically equivalent.
-                - listitem [ref=e455]:
-                  - strong [ref=e456]:
-                    - code [ref=e457]: "{% for … %}{% else %}…{% endfor %}"
-                    - text: → guard with
-                    - code [ref=e458]: "{% if items|length %}"
-                    - text: "before the loop:"
-                  - code [ref=e462]:
-                    - generic [ref=e463]: "{% if items|length %}"
-                    - generic [ref=e464]: "{% for item in items %}{{ item }}{% endfor %}"
-                    - generic [ref=e465]: "{% endif %}"
-                    - generic [ref=e466]: "{% if not items|length %}empty{% endif %}"
-              - heading "Other known gapsDirect link to Other known gaps" [level=2] [ref=e467]:
-                - text: Other known gaps
-                - link "Direct link to Other known gaps" [ref=e468] [cursor=pointer]:
-                  - /url: "#other-known-gaps"
-                  - text: "#"
-              - paragraph [ref=e469]: "These are tracked but not yet implemented:"
-              - list [ref=e470]:
-                - listitem [ref=e471]:
-                  - strong [ref=e472]:
-                    - code [ref=e473]: date_modify
-                    - text: filter.
-                  - text: Relies on DateTime-object mutation; deferred.
-                - listitem [ref=e474]:
-                  - strong [ref=e475]:
-                    - text: Locale-aware
-                    - code [ref=e476]: date
-                    - text: /
-                    - code [ref=e477]: number_format
-                    - text: .
-                  - text: swig-twig's
-                  - code [ref=e478]: date
-                  - text: uses the shared PHP-style formatter from
-                  - code [ref=e479]: "@rhinostone/swig-core"
-                  - text: ; locale rules (weekday names, currency formats) are not plumbed through yet.
-                - listitem [ref=e480]:
-                  - strong [ref=e481]: Runtime bracket-access guard.
-                  - code [ref=e482]: "{{ foo[varname] }}"
-                  - text: with
-                  - code [ref=e483]: varname
-                  - text: resolving to
-                  - code [ref=e484]: "\"__proto__\""
-                  - text: at runtime is not blocked. Documented at the engine level — see
-                  - link "Security — what the guards do NOT protect against" [ref=e485] [cursor=pointer]:
-                    - /url: /docs/swig/security#what-the-guards-do-not-protect-against
-                  - text: .
-              - heading "Reporting a rejection that feels wrongDirect link to Reporting a rejection that feels wrong" [level=2] [ref=e486]:
-                - text: Reporting a rejection that feels wrong
-                - link "Direct link to Reporting a rejection that feels wrong" [ref=e487] [cursor=pointer]:
-                  - /url: "#reporting-a-rejection-that-feels-wrong"
-                  - text: "#"
-              - paragraph [ref=e488]:
-                - text: If the rejection you hit isn't listed here, please
-                - link "open an issue on gina-io/swig" [ref=e489] [cursor=pointer]:
-                  - /url: https://github.com/gina-io/swig/issues
-                  - text: open an issue on
-                  - code [ref=e490]: gina-io/swig
-                - text: with a minimal reproducer — we track rejections against the design-doc subset and may be able to promote a gap to a supported feature.
-            - generic [ref=e491]:
-              - generic [ref=e492]:
-                - generic [ref=e493]: Was this page helpful?
-                - generic [ref=e494]:
-                  - button "Yes, this was helpful" [ref=e495] [cursor=pointer]:
-                    - generic [ref=e496]: 👍
-                    - generic [ref=e497]: –
-                  - button "No, this was not helpful" [ref=e498] [cursor=pointer]:
-                    - generic [ref=e499]: 👎
-                    - generic [ref=e500]: –
-              - link "Edit this page" [ref=e504] [cursor=pointer]:
-                - /url: https://github.com/gina-io/docs/tree/main/docs/swig/twig/non-goals.mdx
-                - img [ref=e505]
-                - text: Edit this page
-          - navigation "Docs pages" [ref=e509]:
-            - link "Previous « Parity" [ref=e510] [cursor=pointer]:
-              - /url: /docs/swig/twig/parity
-              - generic [ref=e511]: Previous
-              - generic [ref=e512]: « Parity
-            - link "Next From upstream Twig »" [ref=e513] [cursor=pointer]:
-              - /url: /docs/swig/twig/migration
-              - generic [ref=e514]: Next
-              - generic [ref=e515]: From upstream Twig »
-        - list [ref=e519]:
-          - listitem [ref=e520]:
-            - link "Unsupported tags" [ref=e521] [cursor=pointer]:
-              - /url: "#unsupported-tags"
-            - list [ref=e522]:
-              - listitem [ref=e523]:
-                - link "Won't support (security)" [ref=e524] [cursor=pointer]:
-                  - /url: "#wont-support-security"
-              - listitem [ref=e525]:
-                - link "Deferred" [ref=e526] [cursor=pointer]:
-                  - /url: "#deferred"
-          - listitem [ref=e527]:
-            - link "Macro kwargs" [ref=e528] [cursor=pointer]:
-              - /url: "#macro-kwargs"
-          - listitem [ref=e529]:
-            - 'link "Dynamic {% extends %} and {% from %}" [ref=e530] [cursor=pointer]':
-              - /url: "#dynamic--extends--and--from-"
-              - text: Dynamic
-              - code [ref=e531]: "{% extends %}"
-              - text: and
-              - code [ref=e532]: "{% from %}"
-          - listitem [ref=e533]:
-            - link "Bracket-notation set" [ref=e534] [cursor=pointer]:
-              - /url: "#bracket-notation-set"
-              - text: Bracket-notation
-              - code [ref=e535]: set
-          - listitem [ref=e536]:
-            - link "Conditional branches (deferred)" [ref=e537] [cursor=pointer]:
-              - /url: "#conditional-branches-deferred"
-          - listitem [ref=e538]:
-            - link "Other known gaps" [ref=e539] [cursor=pointer]:
-              - /url: "#other-known-gaps"
-          - listitem [ref=e540]:
-            - link "Reporting a rejection that feels wrong" [ref=e541] [cursor=pointer]:
-              - /url: "#reporting-a-rejection-that-feels-wrong"
-  - contentinfo [ref=e542]:
-    - generic [ref=e543]:
-      - generic [ref=e544]:
-        - generic [ref=e545]:
-          - generic [ref=e546]: Docs
-          - list [ref=e547]:
-            - listitem [ref=e548]:
-              - link "Getting Started" [ref=e549] [cursor=pointer]:
-                - /url: /docs/intro
-        - generic [ref=e550]:
-          - generic [ref=e551]: Community
-          - list [ref=e552]:
-            - listitem [ref=e553]:
-              - link "GitHub Issues(opens in new tab)" [ref=e554] [cursor=pointer]:
-                - /url: https://github.com/gina-io/gina/issues
-                - text: GitHub Issues
-                - img "(opens in new tab)" [ref=e555]
-            - listitem [ref=e557]:
-              - link "GitHub Discussions(opens in new tab)" [ref=e558] [cursor=pointer]:
-                - /url: https://github.com/gina-io/gina/discussions
-                - text: GitHub Discussions
-                - img "(opens in new tab)" [ref=e559]
-            - listitem [ref=e561]:
-              - link "Support Gina" [ref=e562] [cursor=pointer]:
-                - /url: /docs/support
-        - generic [ref=e563]:
-          - generic [ref=e564]: More
-          - list [ref=e565]:
-            - listitem [ref=e566]:
-              - link "npm(opens in new tab)" [ref=e567] [cursor=pointer]:
-                - /url: https://www.npmjs.com/package/gina
-                - text: npm
-                - img "(opens in new tab)" [ref=e568]
-      - generic [ref=e571]: Copyright © 2009-2026 gina-io.
-  - button "Collapse sidebar" [ref=e573] [cursor=pointer]:
-    - img [ref=e574]