@rhinostone/swig 2.0.0-alpha.7 → 2.0.0

package/.playwright-mcp/page-2026-04-22T15-53-11-277Z.yml

@@ -0,0 +1,632 @@
+- 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)" [ref=e23] [cursor=pointer]:
+          - img [ref=e24]
+        - generic [ref=e27]:
+          - textbox "Search" [ref=e28]
+          - generic:
+            - generic: ⌘
+            - generic: K
+  - 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]: Browser Usage
+            - generic [ref=e161]:
+              - heading "Twig in the Browser" [level=1] [ref=e163]
+              - generic [ref=e164]:
+                - generic [ref=e165]:
+                  - generic [ref=e166]:
+                    - img [ref=e167]
+                    - text: 4 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 "Swig Browser Usage" [ref=e177] [cursor=pointer]:
+                        - /url: /docs/swig/browser
+                    - listitem [ref=e178]:
+                      - link "Security — the parser is the boundary" [ref=e179] [cursor=pointer]:
+                        - /url: /docs/swig/security#the-parser-is-the-boundary
+                    - listitem [ref=e180]:
+                      - link "Loaders" [ref=e181] [cursor=pointer]:
+                        - /url: /docs/swig/loaders
+              - paragraph [ref=e182]:
+                - code [ref=e183]: "@rhinostone/swig-twig"
+                - text: runs in the browser the same way
+                - code [ref=e184]: "@rhinostone/swig"
+                - text: does — memory loader only, no
+                - code [ref=e185]: fs
+                - text: access, identical autoescape and CVE-2023-25345 guard perimeter inherited from
+                - code [ref=e186]: "@rhinostone/swig-core"
+                - text: . The package does not ship a pre-built browser bundle; consumers bundle through their own toolchain (esbuild, Vite, Webpack, Rollup).
+              - paragraph [ref=e187]:
+                - text: "This page covers the Twig-specific bits: how to bundle, how to install the peer-dependency pair during alpha, and a minimal first-template example using Twig syntax. For the shared-engine flow — AOT pre-compile + prime + render, memory-loader idiom, cache semantics,"
+                - code [ref=e188]: swig run
+                - text: warnings — see
+                - link "Swig Browser Usage" [ref=e189] [cursor=pointer]:
+                  - /url: /docs/swig/browser
+                - text: . It applies verbatim because both frontends lower to the same
+                - code [ref=e190]: swig-core
+                - text: backend.
+              - heading "ArchitectureDirect link to Architecture" [level=2] [ref=e191]:
+                - text: Architecture
+                - link "Direct link to Architecture" [ref=e192] [cursor=pointer]:
+                  - /url: "#architecture"
+                  - text: "#"
+              - paragraph [ref=e193]: "Same flow as native swig, with two deltas:"
+              - list [ref=e194]:
+                - listitem [ref=e195]:
+                  - text: The entry point is
+                  - code [ref=e196]: "@rhinostone/swig-twig"
+                  - text: instead of
+                  - code [ref=e197]: "@rhinostone/swig"
+                  - text: .
+                - listitem [ref=e198]:
+                  - text: Your bundler resolves both
+                  - code [ref=e199]: "@rhinostone/swig-twig"
+                  - text: and its peer
+                  - code [ref=e200]: "@rhinostone/swig-core"
+                  - text: .
+              - heading "InstallDirect link to Install" [level=2] [ref=e201]:
+                - text: Install
+                - link "Direct link to Install" [ref=e202] [cursor=pointer]:
+                  - /url: "#install"
+                  - text: "#"
+              - generic [ref=e204]:
+                - code [ref=e206]:
+                  - generic [ref=e207]: npm install @rhinostone/swig-twig@alpha @rhinostone/swig-core@alpha
+                - button "Copy code to clipboard" [ref=e209] [cursor=pointer]:
+                  - generic [ref=e210]:
+                    - img [ref=e211]
+                    - img [ref=e213]
+              - paragraph [ref=e215]:
+                - text: During the
+                - code [ref=e216]: 2.0.0-alpha.x
+                - text: cycle the IR ABI is unstable across minors, so
+                - code [ref=e217]: "@rhinostone/swig-twig"
+                - text: "'s"
+                - code [ref=e218]: peerDependencies
+                - text: pin
+                - code [ref=e219]: "@rhinostone/swig-core"
+                - text: to the
+                - strong [ref=e220]: exact matching version
+                - text: (no caret). Install both together at the same alpha — mixing minors is not supported.
+              - generic [ref=e222]:
+                - code [ref=e224]:
+                  - generic [ref=e225]: // package.json — example consumer during alpha
+                  - generic [ref=e226]: "{"
+                  - generic [ref=e227]: "\"dependencies\": {"
+                  - generic [ref=e228]: "\"@rhinostone/swig-core\": \"2.0.0-alpha.8\","
+                  - generic [ref=e229]: "\"@rhinostone/swig-twig\": \"2.0.0-alpha.8\""
+                  - generic [ref=e230]: "}"
+                  - generic [ref=e231]: "}"
+                - button "Copy code to clipboard" [ref=e233] [cursor=pointer]:
+                  - generic [ref=e234]:
+                    - img [ref=e235]
+                    - img [ref=e237]
+              - paragraph [ref=e239]:
+                - text: At
+                - code [ref=e240]: 2.0.0
+                - text: stable the pin loosens to
+                - code [ref=e241]: ^2.0.0
+                - text: .
+              - heading "Bundle with esbuildDirect link to Bundle with esbuild" [level=2] [ref=e242]:
+                - text: Bundle with esbuild
+                - link "Direct link to Bundle with esbuild" [ref=e243] [cursor=pointer]:
+                  - /url: "#bundle-with-esbuild"
+                  - text: "#"
+              - paragraph [ref=e244]: "Minimal recipe. Two things to wire up:"
+              - list [ref=e245]:
+                - listitem [ref=e246]:
+                  - code [ref=e247]: fs
+                  - text: is stubbed to an empty object (the filesystem loader at
+                  - code [ref=e248]: "@rhinostone/swig-core/lib/loaders/filesystem.js"
+                  - text: guards itself when
+                  - code [ref=e249]: fs.readFileSync
+                  - text: is missing, so an empty stub is enough to make it a no-op in the browser).
+                - listitem [ref=e250]:
+                  - code [ref=e251]: path
+                  - text: is aliased to
+                  - link "path-browserify" [ref=e252] [cursor=pointer]:
+                    - /url: https://www.npmjs.com/package/path-browserify
+                    - code [ref=e253]: path-browserify
+                  - text: because the shared loader normalises paths.
+              - paragraph [ref=e254]:
+                - text: This mirrors the native-swig build recipe at
+                - link "gina-io/swig/Makefile:58" [ref=e255] [cursor=pointer]:
+                  - /url: https://github.com/gina-io/swig/blob/develop/Makefile#L58
+                - text: .
+              - generic [ref=e257]:
+                - code [ref=e259]:
+                  - generic [ref=e260]: // entry.js
+                  - generic [ref=e261]: var twig = require('@rhinostone/swig-twig');
+                  - generic [ref=e262]: "twig.setDefaults({"
+                  - generic [ref=e263]: "loader: twig.loaders.memory({"
+                  - generic [ref=e264]: "'greeting.twig': 'Hello {{ name|upper }}!'"
+                  - generic [ref=e265]: "})"
+                  - generic [ref=e266]: "});"
+                  - generic [ref=e267]: window.twig = twig;
+                - button "Copy code to clipboard" [ref=e269] [cursor=pointer]:
+                  - generic [ref=e270]:
+                    - img [ref=e271]
+                    - img [ref=e273]
+              - generic [ref=e276]:
+                - code [ref=e278]:
+                  - generic [ref=e279]: // stubs/fs.js — empty stub, turns the filesystem loader into a no-op
+                  - generic [ref=e280]: "module.exports = {};"
+                - button "Copy code to clipboard" [ref=e282] [cursor=pointer]:
+                  - generic [ref=e283]:
+                    - img [ref=e284]
+                    - img [ref=e286]
+              - generic [ref=e289]:
+                - code [ref=e291]:
+                  - generic [ref=e292]: // build.js
+                  - generic [ref=e293]: "require('esbuild').build({"
+                  - generic [ref=e294]: "entryPoints: ['entry.js'],"
+                  - generic [ref=e295]: "bundle: true,"
+                  - generic [ref=e296]: "format: 'iife',"
+                  - generic [ref=e297]: "outfile: 'dist/browser.js',"
+                  - generic [ref=e298]: "alias: {"
+                  - generic [ref=e299]: "fs: './stubs/fs.js',"
+                  - generic [ref=e300]: "path: 'path-browserify'"
+                  - generic [ref=e301]: "},"
+                  - generic [ref=e302]: "minify: true,"
+                  - generic [ref=e303]: "sourcemap: true"
+                  - generic [ref=e304]: "}).catch(function (err) { console.error(err); process.exit(1); });"
+                - button "Copy code to clipboard" [ref=e306] [cursor=pointer]:
+                  - generic [ref=e307]:
+                    - img [ref=e308]
+                    - img [ref=e310]
+              - generic [ref=e313]:
+                - code [ref=e315]:
+                  - generic [ref=e316]: node build.js
+                - button "Copy code to clipboard" [ref=e318] [cursor=pointer]:
+                  - generic [ref=e319]:
+                    - img [ref=e320]
+                    - img [ref=e322]
+              - paragraph [ref=e324]:
+                - text: Load it with a
+                - code [ref=e325]: <script>
+                - text: "tag:"
+              - generic [ref=e327]:
+                - code [ref=e329]:
+                  - generic [ref=e330]: <!doctype html>
+                  - generic [ref=e331]: <html>
+                  - generic [ref=e332]: <body>
+                  - generic [ref=e333]: <div id="out"></div>
+                  - generic [ref=e334]:
+                    - text: <script src="dist/browser.js">
+                    - text: </script>
+                  - generic [ref=e335]: <script>
+                  - generic [ref=e336]: "var out = window.twig.render('Hello {{ name|upper }}!', {"
+                  - generic [ref=e337]: "locals: { name: 'world' }"
+                  - generic [ref=e338]: "});"
+                  - generic [ref=e339]: document.querySelector('#out').textContent = out;
+                  - generic [ref=e340]: // → "Hello WORLD!"
+                  - generic [ref=e341]: </script>
+                  - generic [ref=e342]: </body>
+                  - generic [ref=e343]: </html>
+                - button "Copy code to clipboard" [ref=e345] [cursor=pointer]:
+                  - generic [ref=e346]:
+                    - img [ref=e347]
+                    - img [ref=e349]
+              - paragraph [ref=e351]:
+                - strong [ref=e352]: Other bundlers follow the same shape.
+                - link "Vite" [ref=e353] [cursor=pointer]:
+                  - /url: https://vitejs.dev/
+                - text: and
+                - link "Rollup" [ref=e354] [cursor=pointer]:
+                  - /url: https://rollupjs.org/
+                - text: use
+                - code [ref=e355]: resolve.alias
+                - text: (Vite) or the
+                - link "@rollup/plugin-alias" [ref=e356] [cursor=pointer]:
+                  - /url: https://www.npmjs.com/package/@rollup/plugin-alias
+                  - code [ref=e357]: "@rollup/plugin-alias"
+                - text: plugin.
+                - link "Webpack" [ref=e358] [cursor=pointer]:
+                  - /url: https://webpack.js.org/
+                - text: uses
+                - code [ref=e359]: resolve.alias
+                - text: +
+                - code [ref=e360]: "resolve.fallback: { fs: false }"
+                - text: ". The requirement is always: stub"
+                - code [ref=e361]: fs
+                - text: ", alias"
+                - code [ref=e362]: path
+                - text: .
+              - heading "Extends + includeDirect link to Extends + include" [level=2] [ref=e363]:
+                - text: Extends + include
+                - link "Direct link to Extends + include" [ref=e364] [cursor=pointer]:
+                  - /url: "#extends--include"
+                  - text: "#"
+              - paragraph [ref=e365]:
+                - text: For templates using
+                - code [ref=e366]: "{% extends %}"
+                - text: or
+                - code [ref=e367]: "{% include %}"
+                - text: ", prime the memory loader with every referenced file before rendering:"
+              - generic [ref=e369]:
+                - code [ref=e371]:
+                  - generic [ref=e372]: "twig.setDefaults({"
+                  - generic [ref=e373]: "loader: twig.loaders.memory({"
+                  - generic [ref=e374]: "'layout.twig': '<!doctype html><title>{{ title }}</title>{% block body %}{% endblock %}',"
+                  - generic [ref=e375]: "'page.twig': '{% extends \"layout.twig\" %}{% block body %}Hello {{ name|upper }}!{% endblock %}'"
+                  - generic [ref=e376]: "})"
+                  - generic [ref=e377]: "});"
+                  - generic [ref=e378]: "twig.renderFile('page.twig', { title: 'Hi', name: 'world' });"
+                  - generic [ref=e379]: // → "<!doctype html><title>Hi</title>Hello WORLD!"
+                - generic [ref=e380]:
+                  - button "Toggle word wrap" [ref=e381] [cursor=pointer]:
+                    - img [ref=e382]
+                  - button "Copy code to clipboard" [ref=e384] [cursor=pointer]:
+                    - generic [ref=e385]:
+                      - img [ref=e386]
+                      - img [ref=e388]
+              - paragraph [ref=e390]:
+                - text: The loader contract is identical across frontends — see
+                - link "Loaders" [ref=e391] [cursor=pointer]:
+                  - /url: /docs/swig/loaders
+                - text: .
+              - heading "AOT pre-compilationDirect link to AOT pre-compilation" [level=2] [ref=e392]:
+                - text: AOT pre-compilation
+                - link "Direct link to AOT pre-compilation" [ref=e393] [cursor=pointer]:
+                  - /url: "#aot-pre-compilation"
+                  - text: "#"
+              - paragraph [ref=e394]:
+                - text: If bundle size or cold-render latency matters, pre-compile Twig templates to plain JavaScript at build time, ship only the runtime (the compiled
+                - code [ref=e395]: _output += …
+                - text: functions) to the browser, and skip the parser entirely. The flow is identical to native swig's — see
+                - link "Swig Browser Usage → Pre-compile + prime + render" [ref=e396] [cursor=pointer]:
+                  - /url: /docs/swig/browser#pre-compile--prime--render
+                - text: . The compiled output is the same shape regardless of which frontend produced it, because both lower to
+                - code [ref=e397]: swig-core
+                - text: IR before codegen.
+              - heading "Bundle sizeDirect link to Bundle size" [level=2] [ref=e398]:
+                - text: Bundle size
+                - link "Direct link to Bundle size" [ref=e399] [cursor=pointer]:
+                  - /url: "#bundle-size"
+                  - text: "#"
+              - paragraph [ref=e400]:
+                - text: As of
+                - code [ref=e401]: 2.0.0-alpha.8
+                - text: ", a minified browser bundle of"
+                - code [ref=e402]: "@rhinostone/swig-twig"
+                - text: plus its transitive
+                - code [ref=e403]: "@rhinostone/swig-core"
+                - text: dependency weighs approximately
+                - strong [ref=e404]: 82 KB minified
+                - text: (~27 KB gzipped) via esbuild
+                - code [ref=e405]: "--minify --format=iife"
+                - text: — measured against an entry point that imports the default Twig instance, wires up a memory loader, and exposes it on
+                - code [ref=e406]: window.twig
+                - text: .
+              - paragraph [ref=e407]: For perf-critical paths, prefer AOT pre-compilation (previous section) — the runtime footprint drops substantially because the lexer and parser are not shipped.
+              - heading "Security modelDirect link to Security model" [level=2] [ref=e408]:
+                - text: Security model
+                - link "Direct link to Security model" [ref=e409] [cursor=pointer]:
+                  - /url: "#security-model"
+                  - text: "#"
+              - paragraph [ref=e410]:
+                - code [ref=e411]: "@rhinostone/swig-twig"
+                - text: inherits every security guarantee of
+                - code [ref=e412]: "@rhinostone/swig-core"
+                - text: ":"
+              - list [ref=e413]:
+                - listitem [ref=e414]:
+                  - strong [ref=e415]: Autoescape is on by default.
+                  - text: HTML entities are escaped on every
+                  - code [ref=e416]: "{{ … }}"
+                  - text: output unless the expression is explicitly marked
+                  - code [ref=e417]: safe
+                  - text: (built-in filter) or produced by a user filter declaring
+                  - code [ref=e418]: .safe = true
+                  - text: .
+                - listitem [ref=e419]:
+                  - strong [ref=e420]:
+                    - text: CVE-2023-25345
+                    - code [ref=e421]: _dangerousProps
+                    - text: guards.
+                  - code [ref=e422]: __proto__
+                  - text: ","
+                  - code [ref=e423]: constructor
+                  - text: ", and"
+                  - code [ref=e424]: prototype
+                  - text: are rejected at parse time in every context that writes to
+                  - code [ref=e425]: _ctx
+                  - text: ": dotted access, bracket-notation with string literals,"
+                  - code [ref=e426]: "{% set %}"
+                  - text: LHS,
+                  - code [ref=e427]: "{% for %}"
+                  - text: loop variables,
+                  - code [ref=e428]: "{% macro %}"
+                  - text: names, and
+                  - code [ref=e429]: "{% import %}"
+                  - text: aliases. The guards are frontend-agnostic — both native swig and Twig run them.
+                - listitem [ref=e430]:
+                  - strong [ref=e431]: Template source is trusted.
+                  - text: Same model as upstream Twig, Jinja2, and Django. Never pass user-controlled strings directly to
+                  - code [ref=e432]: twig.render(source, locals)
+                  - text: ; keep locals data-only.
+              - paragraph [ref=e433]:
+                - text: See
+                - link "Security — the parser is the boundary" [ref=e434] [cursor=pointer]:
+                  - /url: /docs/swig/security#the-parser-is-the-boundary
+                - text: for the full story.
+              - heading "GotchasDirect link to Gotchas" [level=2] [ref=e435]:
+                - text: Gotchas
+                - link "Direct link to Gotchas" [ref=e436] [cursor=pointer]:
+                  - /url: "#gotchas"
+                  - text: "#"
+              - list [ref=e437]:
+                - listitem [ref=e438]:
+                  - strong [ref=e439]: Filesystem loader throws in the browser.
+                  - text: Always call
+                  - code [ref=e440]: "twig.setDefaults({ loader: twig.loaders.memory({}) })"
+                  - text: at module init time — before any render.
+                - listitem [ref=e441]:
+                  - strong [ref=e442]: Peer-dependency pinning.
+                  - text: During alpha,
+                  - code [ref=e443]: "@rhinostone/swig-core"
+                  - text: and
+                  - code [ref=e444]: "@rhinostone/swig-twig"
+                  - text: must be installed at the
+                  - strong [ref=e445]: exact same version
+                  - text: . Bundlers that rely on npm's
+                  - code [ref=e446]: node_modules/@rhinostone/swig-core
+                  - text: symlink (as in a workspace dev checkout) can mask a missing
+                  - code [ref=e447]: dependencies
+                  - text: declaration. Verify by bundling against a fresh
+                  - code [ref=e448]: node_modules
+                  - text: .
+                - listitem [ref=e449]:
+                  - strong [ref=e450]: Cache persistence.
+                  - text: The compiled-template cache lives on the Twig instance — reset on page reload. Hot-reload consumers should call
+                  - code [ref=e451]: twig.invalidateCache()
+                  - text: before re-priming.
+                - listitem [ref=e452]:
+                  - strong [ref=e453]:
+                    - code [ref=e454]: swig run
+                    - text: is not a sandbox.
+                  - text: Same warning as the native frontend — the function body is
+                  - code [ref=e455]: eval
+                  - text: "'d. Never hand user-controlled strings to it."
+              - heading "Gina's browser buildDirect link to Gina's browser build" [level=2] [ref=e456]:
+                - text: Gina's browser build
+                - link "Direct link to Gina's browser build" [ref=e457] [cursor=pointer]:
+                  - /url: "#ginas-browser-build"
+                  - text: "#"
+              - paragraph [ref=e458]:
+                - text: Gina's vendored browser build at
+                - code [ref=e459]: framework/v*/core/deps/swig-client/swig.js
+                - text: currently ships the native-swig bundle only. A vendored swig-twig bundle is scheduled for the
+                - code [ref=e460]: 2.0.0
+                - text: stable release; track progress in the
+                - link "project roadmap" [ref=e461] [cursor=pointer]:
+                  - /url: https://github.com/gina-io/swig/blob/develop/ROADMAP.md
+                - text: .
+            - generic [ref=e462]:
+              - generic [ref=e463]:
+                - generic [ref=e464]: Was this page helpful?
+                - generic [ref=e465]:
+                  - button "Yes, this was helpful" [ref=e466] [cursor=pointer]:
+                    - generic [ref=e467]: 👍
+                    - generic [ref=e468]: –
+                  - button "No, this was not helpful" [ref=e469] [cursor=pointer]:
+                    - generic [ref=e470]: 👎
+                    - generic [ref=e471]: –
+              - link "Edit this page" [ref=e475] [cursor=pointer]:
+                - /url: https://github.com/gina-io/docs/tree/main/docs/swig/twig/browser.mdx
+                - img [ref=e476]
+                - text: Edit this page
+          - navigation "Docs pages" [ref=e480]:
+            - link "Previous « From upstream Twig" [ref=e481] [cursor=pointer]:
+              - /url: /docs/swig/twig/migration
+              - generic [ref=e482]: Previous
+              - generic [ref=e483]: « From upstream Twig
+            - link "Next Migration Guide »" [ref=e484] [cursor=pointer]:
+              - /url: /docs/swig/migration
+              - generic [ref=e485]: Next
+              - generic [ref=e486]: Migration Guide »
+        - list [ref=e490]:
+          - listitem [ref=e491]:
+            - link "Architecture" [ref=e492] [cursor=pointer]:
+              - /url: "#architecture"
+          - listitem [ref=e493]:
+            - link "Install" [ref=e494] [cursor=pointer]:
+              - /url: "#install"
+          - listitem [ref=e495]:
+            - link "Bundle with esbuild" [ref=e496] [cursor=pointer]:
+              - /url: "#bundle-with-esbuild"
+          - listitem [ref=e497]:
+            - link "Extends + include" [ref=e498] [cursor=pointer]:
+              - /url: "#extends--include"
+          - listitem [ref=e499]:
+            - link "AOT pre-compilation" [ref=e500] [cursor=pointer]:
+              - /url: "#aot-pre-compilation"
+          - listitem [ref=e501]:
+            - link "Bundle size" [ref=e502] [cursor=pointer]:
+              - /url: "#bundle-size"
+          - listitem [ref=e503]:
+            - link "Security model" [ref=e504] [cursor=pointer]:
+              - /url: "#security-model"
+          - listitem [ref=e505]:
+            - link "Gotchas" [ref=e506] [cursor=pointer]:
+              - /url: "#gotchas"
+          - listitem [ref=e507]:
+            - link "Gina's browser build" [ref=e508] [cursor=pointer]:
+              - /url: "#ginas-browser-build"
+  - contentinfo [ref=e509]:
+    - generic [ref=e510]:
+      - generic [ref=e511]:
+        - generic [ref=e512]:
+          - generic [ref=e513]: Docs
+          - list [ref=e514]:
+            - listitem [ref=e515]:
+              - link "Getting Started" [ref=e516] [cursor=pointer]:
+                - /url: /docs/intro
+        - generic [ref=e517]:
+          - generic [ref=e518]: Community
+          - list [ref=e519]:
+            - listitem [ref=e520]:
+              - link "GitHub Issues(opens in new tab)" [ref=e521] [cursor=pointer]:
+                - /url: https://github.com/gina-io/gina/issues
+                - text: GitHub Issues
+                - img "(opens in new tab)" [ref=e522]
+            - listitem [ref=e524]:
+              - link "GitHub Discussions(opens in new tab)" [ref=e525] [cursor=pointer]:
+                - /url: https://github.com/gina-io/gina/discussions
+                - text: GitHub Discussions
+                - img "(opens in new tab)" [ref=e526]
+            - listitem [ref=e528]:
+              - link "Support Gina" [ref=e529] [cursor=pointer]:
+                - /url: /docs/support
+        - generic [ref=e530]:
+          - generic [ref=e531]: More
+          - list [ref=e532]:
+            - listitem [ref=e533]:
+              - link "npm(opens in new tab)" [ref=e534] [cursor=pointer]:
+                - /url: https://www.npmjs.com/package/gina
+                - text: npm
+                - img "(opens in new tab)" [ref=e535]
+      - generic [ref=e538]: Copyright © 2009-2026 gina-io.
+  - button "Collapse sidebar" [ref=e540] [cursor=pointer]:
+    - img [ref=e541]