@rhinostone/swig 2.0.0-alpha.7 → 2.0.0

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

@@ -0,0 +1,676 @@
+- 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]