@alloy-js/core 0.23.0-dev.12 → 0.23.0-dev.15

package/dist/dev/src/write-output.js.map

@@ -1 +1 @@
-{"version":3,"names":["dirname","relative","resolve","AlloyHost","traverseOutput","writeOutput","output","basePath","visitDirectory","directory","path","exists","console","log","process","cwd","mkdir","visitFile","file","write","contents","source","sourcePath","target","read","stream"],"sources":["../../../src/write-output.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,OAAO,EAAEC,QAAQ,EAAEC,OAAO,QAAQ,OAAO;AAClD,SAASC,SAAS,QAAQ,sBAAsB;AAEhD,SAASC,cAAc,QAAQ,YAAY;AAC3C;AACA;AACA;AACA;AACA,OAAO,eAAeC,WAAWA,CAC/BC,MAAuB,EACvBC,QAAgB,GAAG,EAAE,EACrB;EACA,OAAO,MAAMH,cAAc,CAACE,MAAM,EAAE;IAClC,MAAME,cAAcA,CAACC,SAAS,EAAE;MAC9B,MAAMC,IAAI,GAAGR,OAAO,CAACK,QAAQ,EAAEE,SAAS,CAACC,IAAI,CAAC;MAC9C,IAAI,MAAMP,SAAS,CAACQ,MAAM,CAACD,IAAI,CAAC,EAAE;QAChC;MACF;MACA;MACAE,OAAO,CAACC,GAAG,CAAC,QAAQ,EAAEZ,QAAQ,CAACa,OAAO,CAACC,GAAG,CAAC,CAAC,EAAEL,IAAI,CAAC,CAAC;MACpD,MAAMP,SAAS,CAACa,KAAK,CAACN,IAAI,CAAC;IAC7B,CAAC;IACD,MAAMO,SAASA,CAACC,IAAI,EAAE;MACpB,IAAI,UAAU,IAAIA,IAAI,EAAE;QACtB,MAAMR,IAAI,GAAGR,OAAO,CAACK,QAAQ,EAAEW,IAAI,CAACR,IAAI,CAAC;QACzC,IAAI,MAAMP,SAAS,CAACQ,MAAM,CAACD,IAAI,CAAC,EAAE;UAChC;UACAE,OAAO,CAACC,GAAG,CAAC,WAAW,EAAEZ,QAAQ,CAACa,OAAO,CAACC,GAAG,CAAC,CAAC,EAAEL,IAAI,CAAC,CAAC;QACzD,CAAC,MAAM;UACL;UACAE,OAAO,CAACC,GAAG,CAAC,QAAQ,EAAEZ,QAAQ,CAACa,OAAO,CAACC,GAAG,CAAC,CAAC,EAAEL,IAAI,CAAC,CAAC;QACtD;QAEA,MAAMP,SAAS,CAACgB,KAAK,CAACT,IAAI,EAAEQ,IAAI,CAACE,QAAQ,CAAC;MAC5C,CAAC,MAAM;QACL;QACA,MAAMC,MAAM,GAAGnB,OAAO,CAACK,QAAQ,EAAEW,IAAI,CAACI,UAAU,CAAC;QACjD,MAAMC,MAAM,GAAGrB,OAAO,CAACK,QAAQ,EAAEW,IAAI,CAACR,IAAI,CAAC;QAC3C,IAAI,MAAMP,SAAS,CAACQ,MAAM,CAACY,MAAM,CAAC,EAAE;UAClC;UACAX,OAAO,CAACC,GAAG,CAAC,WAAW,EAAEZ,QAAQ,CAACa,OAAO,CAACC,GAAG,CAAC,CAAC,EAAEQ,MAAM,CAAC,CAAC;QAC3D,CAAC,MAAM;UACL;UACAX,OAAO,CAACC,GAAG,CAAC,MAAM,EAAEZ,QAAQ,CAACa,OAAO,CAACC,GAAG,CAAC,CAAC,EAAEQ,MAAM,CAAC,CAAC;QACtD;QACA,MAAMpB,SAAS,CAACa,KAAK,CAAChB,OAAO,CAACuB,MAAM,CAAC,CAAC;QACtC,MAAMpB,SAAS,CAACgB,KAAK,CAACI,MAAM,EAAEpB,SAAS,CAACqB,IAAI,CAACH,MAAM,CAAC,CAACI,MAAM,CAAC,CAAC,CAAC;MAChE;IACF;EACF,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["dirname","relative","resolve","AlloyHost","cwd","traverseOutput","writeOutput","output","basePath","visitDirectory","directory","path","exists","console","log","mkdir","visitFile","file","write","contents","source","sourcePath","target","read","stream"],"sources":["../../../src/write-output.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,OAAO,EAAEC,QAAQ,EAAEC,OAAO,QAAQ,OAAO;AAClD,SAASC,SAAS,QAAQ,sBAAsB;AAChD,SAASC,GAAG,QAAQ,qBAAqB;AAEzC,SAASC,cAAc,QAAQ,YAAY;AAC3C;AACA;AACA;AACA;AACA,OAAO,eAAeC,WAAWA,CAC/BC,MAAuB,EACvBC,QAAgB,GAAG,EAAE,EACrB;EACA,OAAO,MAAMH,cAAc,CAACE,MAAM,EAAE;IAClC,MAAME,cAAcA,CAACC,SAAS,EAAE;MAC9B,MAAMC,IAAI,GAAGT,OAAO,CAACM,QAAQ,EAAEE,SAAS,CAACC,IAAI,CAAC;MAC9C,IAAI,MAAMR,SAAS,CAACS,MAAM,CAACD,IAAI,CAAC,EAAE;QAChC;MACF;MACA;MACAE,OAAO,CAACC,GAAG,CAAC,QAAQ,EAAEb,QAAQ,CAACG,GAAG,CAAC,CAAC,EAAEO,IAAI,CAAC,CAAC;MAC5C,MAAMR,SAAS,CAACY,KAAK,CAACJ,IAAI,CAAC;IAC7B,CAAC;IACD,MAAMK,SAASA,CAACC,IAAI,EAAE;MACpB,IAAI,UAAU,IAAIA,IAAI,EAAE;QACtB,MAAMN,IAAI,GAAGT,OAAO,CAACM,QAAQ,EAAES,IAAI,CAACN,IAAI,CAAC;QACzC,IAAI,MAAMR,SAAS,CAACS,MAAM,CAACD,IAAI,CAAC,EAAE;UAChC;UACAE,OAAO,CAACC,GAAG,CAAC,WAAW,EAAEb,QAAQ,CAACG,GAAG,CAAC,CAAC,EAAEO,IAAI,CAAC,CAAC;QACjD,CAAC,MAAM;UACL;UACAE,OAAO,CAACC,GAAG,CAAC,QAAQ,EAAEb,QAAQ,CAACG,GAAG,CAAC,CAAC,EAAEO,IAAI,CAAC,CAAC;QAC9C;QAEA,MAAMR,SAAS,CAACe,KAAK,CAACP,IAAI,EAAEM,IAAI,CAACE,QAAQ,CAAC;MAC5C,CAAC,MAAM;QACL;QACA,MAAMC,MAAM,GAAGlB,OAAO,CAACM,QAAQ,EAAES,IAAI,CAACI,UAAU,CAAC;QACjD,MAAMC,MAAM,GAAGpB,OAAO,CAACM,QAAQ,EAAES,IAAI,CAACN,IAAI,CAAC;QAC3C,IAAI,MAAMR,SAAS,CAACS,MAAM,CAACU,MAAM,CAAC,EAAE;UAClC;UACAT,OAAO,CAACC,GAAG,CAAC,WAAW,EAAEb,QAAQ,CAACG,GAAG,CAAC,CAAC,EAAEkB,MAAM,CAAC,CAAC;QACnD,CAAC,MAAM;UACL;UACAT,OAAO,CAACC,GAAG,CAAC,MAAM,EAAEb,QAAQ,CAACG,GAAG,CAAC,CAAC,EAAEkB,MAAM,CAAC,CAAC;QAC9C;QACA,MAAMnB,SAAS,CAACY,KAAK,CAACf,OAAO,CAACsB,MAAM,CAAC,CAAC;QACtC,MAAMnB,SAAS,CAACe,KAAK,CAACI,MAAM,EAAEnB,SAAS,CAACoB,IAAI,CAACH,MAAM,CAAC,CAACI,MAAM,CAAC,CAAC,CAAC;MAChE;IACF;EACF,CAAC,CAAC;AACJ","ignoreList":[]}

package/dist/dev/test/browser-build.test.js

@@ -1,86 +1,85 @@
-import { execSync } from "child_process";
 import { existsSync, mkdirSync, rmSync, writeFileSync } from "fs";
 import { join } from "path";
+import { build } from "vite";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
-const testDir = join(__dirname, ".temp", "vite-test-project");
-describe("Browser Build Test", () => {
+const tempDir = join(__dirname, ".temp", "browser-build-test");
+const entryFile = join(tempDir, "entry.js");
+
+/**
+ * Bundles `@alloy-js/core` for the browser using Vite and returns
+ * the concatenated output code.
+ *
+ * Uses the `browser` export condition from the package exports map,
+ * which resolves to the compiled browser entry. This requires the
+ * package to be built first (the CI pipeline and `pnpm build` handle
+ * this automatically).
+ */
+async function bundleForBrowser() {
+  const result = await build({
+    configFile: false,
+    logLevel: "silent",
+    resolve: {
+      conditions: ["browser", "import"]
+    },
+    // Disable automatic process.env replacement so we can detect leaks
+    define: {},
+    build: {
+      write: false,
+      minify: false,
+      rollupOptions: {
+        input: entryFile,
+        output: {
+          format: "es"
+        },
+        // Disable tree-shaking so we catch process.* references in ANY
+        // code path, even if it would be removed in a production build.
+        treeshake: false,
+        external: id => {
+          // Bundle @alloy-js packages — these are what we're validating
+          if (id.startsWith("@alloy-js/")) return false;
+          // Bundle relative/absolute imports (intra-package)
+          if (id.startsWith(".") || id.startsWith("/")) return false;
+          // Externalize third-party deps (vue, pathe, picocolors, …)
+          return true;
+        }
+      }
+    }
+  });
+  const output = Array.isArray(result) ? result[0] : result;
+  const chunks = output.output.filter(o => o.type === "chunk");
+  return chunks.map(c => c.code).join("\n");
+}
+describe("browser build", () => {
   beforeAll(() => {
-    // Cleanup previous runs
-    if (existsSync(testDir)) {
-      rmSync(testDir, {
+    if (existsSync(tempDir)) {
+      rmSync(tempDir, {
         recursive: true,
         force: true
       });
     }
-
-    // Create a temporary Vite project
-    mkdirSync(testDir, {
+    mkdirSync(tempDir, {
       recursive: true
     });
-    execSync("npm init -y", {
-      cwd: testDir
-    });
-    execSync("npm install vite", {
-      cwd: testDir
-    });
-    execSync("npm install ../../..", {
-      cwd: testDir
-    });
-
-    // Create a minimal Vite app
-    writeFileSync(join(testDir, "index.js"), `
-        import { writeOutput } from "@alloy-js/core";
-        console.log("Alloy-js core imported successfully!", writeOutput);
-      `);
-    writeFileSync(join(testDir, "vite.config.js"), `
-        import { defineConfig } from "vite";
-    
-        export default defineConfig({
-          build: {
-            outDir: "dist",
-            target: "esnext",
-          }
-        });
-      `);
-
-    // Create an index.html file
-    writeFileSync(join(testDir, "index.html"), `
-      <!DOCTYPE html>
-      <html lang="en">
-      <head>
-        <meta charset="UTF-8">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        <title>Vite Test</title>
-      </head>
-      <body>
-        <script type="module" src="/index.js"></script>
-      </body>
-      </html>
-      `);
-    writeFileSync(join(testDir, "package.json"), JSON.stringify({
-      type: "module",
-      scripts: {
-        build: "vite build"
-      }
-    }, null, 2));
-  }, 30_000);
-  it("Vite should build successfully", () => {
-    // Run Vite build process and wait for completion
-    expect(() => {
-      execSync("npm run build", {
-        cwd: testDir,
-        stdio: "inherit"
-      });
-    }).not.toThrow();
-  }, 10000);
+    writeFileSync(entryFile, 'export * from "@alloy-js/core";\n');
+  });
   afterAll(() => {
-    // Ensure testDir exists before attempting to remove it
-    if (existsSync(testDir)) {
-      rmSync(testDir, {
+    if (existsSync(tempDir)) {
+      rmSync(tempDir, {
         recursive: true,
         force: true
       });
     }
   });
+  it("should bundle for browser without Node.js polyfills", async () => {
+    const code = await bundleForBrowser();
+
+    // The browser bundle must not reference the Node.js `process` global.
+    // If this fails, a file is using process.env / process.cwd / etc.
+    // without going through host/node-host.ts (or another browser-overridden module).
+    expect(code).not.toMatch(/\bprocess\./);
+
+    // Should not contain static require("node:…") calls
+    expect(code).not.toMatch(/require\(\s*["']node:/);
+  }, 30_000);
 });
 //# sourceMappingURL=browser-build.test.js.map

package/dist/dev/test/browser-build.test.js.map

@@ -1 +1 @@
-{"version":3,"names":["execSync","existsSync","mkdirSync","rmSync","writeFileSync","join","afterAll","beforeAll","describe","expect","it","testDir","__dirname","recursive","force","cwd","JSON","stringify","type","scripts","build","stdio","not","toThrow"],"sources":["../../../test/browser-build.test.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAQ,QAAQ,eAAe;AACxC,SAASC,UAAU,EAAEC,SAAS,EAAEC,MAAM,EAAEC,aAAa,QAAQ,IAAI;AACjE,SAASC,IAAI,QAAQ,MAAM;AAC3B,SAASC,QAAQ,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAElE,MAAMC,OAAO,GAAGN,IAAI,CAACO,SAAS,EAAE,OAAO,EAAE,mBAAmB,CAAC;AAE7DJ,QAAQ,CAAC,oBAAoB,EAAE,MAAM;EACnCD,SAAS,CAAC,MAAM;IACd;IACA,IAAIN,UAAU,CAACU,OAAO,CAAC,EAAE;MACvBR,MAAM,CAACQ,OAAO,EAAE;QAAEE,SAAS,EAAE,IAAI;QAAEC,KAAK,EAAE;MAAK,CAAC,CAAC;IACnD;;IAEA;IACAZ,SAAS,CAACS,OAAO,EAAE;MAAEE,SAAS,EAAE;IAAK,CAAC,CAAC;IAEvCb,QAAQ,CAAC,aAAa,EAAE;MAAEe,GAAG,EAAEJ;IAAQ,CAAC,CAAC;IACzCX,QAAQ,CAAC,kBAAkB,EAAE;MAAEe,GAAG,EAAEJ;IAAQ,CAAC,CAAC;IAC9CX,QAAQ,CAAC,sBAAsB,EAAE;MAAEe,GAAG,EAAEJ;IAAQ,CAAC,CAAC;;IAElD;IACAP,aAAa,CACXC,IAAI,CAACM,OAAO,EAAE,UAAU,CAAC,EACzB;AACN;AACA;AACA,OACI,CAAC;IAEDP,aAAa,CACXC,IAAI,CAACM,OAAO,EAAE,gBAAgB,CAAC,EAC/B;AACN;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OACI,CAAC;;IAED;IACAP,aAAa,CACXC,IAAI,CAACM,OAAO,EAAE,YAAY,CAAC,EAC3B;AACN;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OACI,CAAC;IAEDP,aAAa,CACXC,IAAI,CAACM,OAAO,EAAE,cAAc,CAAC,EAC7BK,IAAI,CAACC,SAAS,CACZ;MACEC,IAAI,EAAE,QAAQ;MACdC,OAAO,EAAE;QACPC,KAAK,EAAE;MACT;IACF,CAAC,EACD,IAAI,EACJ,CACF,CACF,CAAC;EACH,CAAC,EAAE,MAAM,CAAC;EAEVV,EAAE,CAAC,gCAAgC,EAAE,MAAM;IACzC;IACAD,MAAM,CAAC,MAAM;MACXT,QAAQ,CAAC,eAAe,EAAE;QAAEe,GAAG,EAAEJ,OAAO;QAAEU,KAAK,EAAE;MAAU,CAAC,CAAC;IAC/D,CAAC,CAAC,CAACC,GAAG,CAACC,OAAO,CAAC,CAAC;EAClB,CAAC,EAAE,KAAK,CAAC;EAETjB,QAAQ,CAAC,MAAM;IACb;IACA,IAAIL,UAAU,CAACU,OAAO,CAAC,EAAE;MACvBR,MAAM,CAACQ,OAAO,EAAE;QAAEE,SAAS,EAAE,IAAI;QAAEC,KAAK,EAAE;MAAK,CAAC,CAAC;IACnD;EACF,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["existsSync","mkdirSync","rmSync","writeFileSync","join","build","afterAll","beforeAll","describe","expect","it","tempDir","__dirname","entryFile","bundleForBrowser","result","configFile","logLevel","resolve","conditions","define","write","minify","rollupOptions","input","output","format","treeshake","external","id","startsWith","Array","isArray","chunks","filter","o","type","map","c","code","recursive","force","not","toMatch"],"sources":["../../../test/browser-build.test.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,UAAU,EAAEC,SAAS,EAAEC,MAAM,EAAEC,aAAa,QAAQ,IAAI;AACjE,SAASC,IAAI,QAAQ,MAAM;AAC3B,SAASC,KAAK,QAAuB,MAAM;AAC3C,SAASC,QAAQ,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAElE,MAAMC,OAAO,GAAGP,IAAI,CAACQ,SAAS,EAAE,OAAO,EAAE,oBAAoB,CAAC;AAC9D,MAAMC,SAAS,GAAGT,IAAI,CAACO,OAAO,EAAE,UAAU,CAAC;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAeG,gBAAgBA,CAAA,EAAoB;EACjD,MAAMC,MAAM,GAAG,MAAMV,KAAK,CAAC;IACzBW,UAAU,EAAE,KAAK;IACjBC,QAAQ,EAAE,QAAQ;IAClBC,OAAO,EAAE;MACPC,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ;IAClC,CAAC;IACD;IACAC,MAAM,EAAE,CAAC,CAAC;IACVf,KAAK,EAAE;MACLgB,KAAK,EAAE,KAAK;MACZC,MAAM,EAAE,KAAK;MACbC,aAAa,EAAE;QACbC,KAAK,EAAEX,SAAS;QAChBY,MAAM,EAAE;UAAEC,MAAM,EAAE;QAAK,CAAC;QACxB;QACA;QACAC,SAAS,EAAE,KAAK;QAChBC,QAAQ,EAAGC,EAAE,IAAK;UAChB;UACA,IAAIA,EAAE,CAACC,UAAU,CAAC,YAAY,CAAC,EAAE,OAAO,KAAK;UAC7C;UACA,IAAID,EAAE,CAACC,UAAU,CAAC,GAAG,CAAC,IAAID,EAAE,CAACC,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK;UAC1D;UACA,OAAO,IAAI;QACb;MACF;IACF;EACF,CAAC,CAAC;EAEF,MAAML,MAAM,GACVM,KAAK,CAACC,OAAO,CAACjB,MAAM,CAAC,GACnBA,MAAM,CAAC,CAAC,CAAC,GACTA,MAAkC;EACtC,MAAMkB,MAAM,GAAGR,MAAM,CAACA,MAAM,CAACS,MAAM,CAChCC,CAAC,IAAgCA,CAAC,CAACC,IAAI,KAAK,OAC/C,CAAC;EACD,OAAOH,MAAM,CAACI,GAAG,CAAEC,CAAC,IAAKA,CAAC,CAACC,IAAI,CAAC,CAACnC,IAAI,CAAC,IAAI,CAAC;AAC7C;AAEAI,QAAQ,CAAC,eAAe,EAAE,MAAM;EAC9BD,SAAS,CAAC,MAAM;IACd,IAAIP,UAAU,CAACW,OAAO,CAAC,EAAE;MACvBT,MAAM,CAACS,OAAO,EAAE;QAAE6B,SAAS,EAAE,IAAI;QAAEC,KAAK,EAAE;MAAK,CAAC,CAAC;IACnD;IACAxC,SAAS,CAACU,OAAO,EAAE;MAAE6B,SAAS,EAAE;IAAK,CAAC,CAAC;IACvCrC,aAAa,CAACU,SAAS,EAAE,mCAAmC,CAAC;EAC/D,CAAC,CAAC;EAEFP,QAAQ,CAAC,MAAM;IACb,IAAIN,UAAU,CAACW,OAAO,CAAC,EAAE;MACvBT,MAAM,CAACS,OAAO,EAAE;QAAE6B,SAAS,EAAE,IAAI;QAAEC,KAAK,EAAE;MAAK,CAAC,CAAC;IACnD;EACF,CAAC,CAAC;EAEF/B,EAAE,CAAC,qDAAqD,EAAE,YAAY;IACpE,MAAM6B,IAAI,GAAG,MAAMzB,gBAAgB,CAAC,CAAC;;IAErC;IACA;IACA;IACAL,MAAM,CAAC8B,IAAI,CAAC,CAACG,GAAG,CAACC,OAAO,CAAC,aAAa,CAAC;;IAEvC;IACAlC,MAAM,CAAC8B,IAAI,CAAC,CAACG,GAAG,CAACC,OAAO,CAAC,uBAAuB,CAAC;EACnD,CAAC,EAAE,MAAM,CAAC;AACZ,CAAC,CAAC","ignoreList":[]}

package/dist/dev/testing/create-test-wrapper.js

@@ -1,7 +1,55 @@
 import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
 import { Declaration, For, namekey, Output, shallowReactive } from "../src/index.js";
+
 /**
- * Generic test wrapper creator.
+ * Test harness returned by {@link createTestWrapper}.
+ */
+
+/**
+ * Create a reusable test harness for a language package. Returns a `Wrapper`
+ * component (wraps content in `<Output>` + `<SourceFile>`) and a `defkey`
+ * helper that creates stable namekeys for pre-declaring symbols.
+ *
+ * @remarks
+ *
+ * Downstream consumers import and call this from the language package's
+ * `testing/` entrypoint. The `Wrapper` automatically declares symbols
+ * created by `defkey` before rendering children, so tests can reference
+ * symbols without explicit `<Declaration>` boilerplate.
+ *
+ * @example
+ * ```ts
+ * // In your language package's testing/ entrypoint:
+ * import { FileComponent } from "./components/index.js"; // your language package's top-level file component
+ * import { createTestWrapper, type TestWrapper } from "@alloy-js/core/testing";
+ *
+ * export function createMyLangTestWrapper(): TestWrapper {
+ *   return createTestWrapper({
+ *     filePath: "test.ext",
+ *     useScope: useMyLangScope,
+ *     makeSymbol: (nk, scope) => new MyOutputSymbol(nk, scope),
+ *     SourceFile: FileComponent,
+ *   });
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Extend your language test factory to accept and forward namePolicy:
+ * export function createMyLangTestWrapper(namePolicy?: NamePolicy<string>): TestWrapper {
+ *   return createTestWrapper({ ...langOpts, namePolicy });
+ * }
+ *
+ * // In a name-policy test:
+ * const { Wrapper } = createMyLangTestWrapper(myNamePolicy);
+ * const fooKey = namekey("foo"); // namekey(), not defkey — name policy applies
+ * // namekey() schedules no pre-declaration; the test body must declare the symbol.
+ * expect(
+ *   <Wrapper>
+ *     <MyDeclaration refkey={fooKey} name="foo" />
+ *   </Wrapper>
+ * ).toRenderTo("FOO");
+ * ```
  */
 export function createTestWrapper(opts) {
   const seen = shallowReactive(new Map());
@@ -30,6 +78,12 @@ export function createTestWrapper(opts) {
   function Wrapper(props) {
     const SF = opts.SourceFile;
     return _$createComponent(Output, {
+      get namePolicy() {
+        return opts.namePolicy;
+      },
+      get nameConflictResolver() {
+        return opts.nameConflictResolver;
+      },
       get children() {
         return _$createComponent(SF, {
           get path() {
@@ -47,24 +101,24 @@ export function createTestWrapper(opts) {
                 }
               }, {
                 fileName: import.meta.url,
-                lineNumber: 61,
+                lineNumber: 140,
                 columnNumber: 22
               })
             }, {
               fileName: import.meta.url,
-              lineNumber: 60,
+              lineNumber: 139,
               columnNumber: 11
             }), _$memo(() => props.children, false, "props.children")];
           }
         }, {
           fileName: import.meta.url,
-          lineNumber: 59,
+          lineNumber: 138,
           columnNumber: 9
         });
       }
     }, {
       fileName: import.meta.url,
-      lineNumber: 58,
+      lineNumber: 134,
       columnNumber: 7
     });
   }

package/dist/dev/testing/create-test-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"names":["Declaration","For","namekey","Output","shallowReactive","createTestWrapper","opts","seen","Map","created","defkey","name","existing","get","nk","ignoreNamePolicy","ignoreNameConflict","set","createSymbol","scope","useScope","Error","sym","makeSymbol","Wrapper","props","SF","SourceFile","_$createComponent","children","path","filePath","each","values","joiner","symbol","fileName","import","meta","url","lineNumber","columnNumber","_$memo"],"sources":["../../../testing/create-test-wrapper.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAEEA,WAAW,EACXC,GAAG,EAEHC,OAAO,EACPC,MAAM,EAENC,eAAe,QACV,iBAAiB;AAOxB;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAG/BC,IAKD,EAAe;EACd,MAAMC,IAAI,GAAGH,eAAe,CAAC,IAAII,GAAG,CAAkB,CAAC,CAAC;EACxD,MAAMC,OAAO,GAAG,IAAID,GAAG,CAAmB,CAAC;EAE3C,SAASE,MAAMA,CAACC,IAAY,EAAW;IACrC,MAAMC,QAAQ,GAAGL,IAAI,CAACM,GAAG,CAACF,IAAI,CAAC;IAC/B,IAAIC,QAAQ,EAAE,OAAOA,QAAQ;IAC7B,MAAME,EAAE,GAAGZ,OAAO,CAACS,IAAI,EAAE;MACvBI,gBAAgB,EAAE,IAAI;MACtBC,kBAAkB,EAAE;IACtB,CAAC,CAAC;IACFT,IAAI,CAACU,GAAG,CAACN,IAAI,EAAEG,EAAE,CAAC;IAClB,OAAOA,EAAE;EACX;EAEA,SAASI,YAAYA,CAACJ,EAAW,EAAE;IACjC,MAAMF,QAAQ,GAAGH,OAAO,CAACI,GAAG,CAACC,EAAE,CAAC;IAChC,IAAIF,QAAQ,EAAE,OAAOA,QAAQ;IAC7B,MAAMO,KAAK,GAAGb,IAAI,CAACc,QAAQ,CAAC,CAAC;IAC7B,IAAI,CAACD,KAAK,EAAE;MACV,MAAM,IAAIE,KAAK,CAAC,8CAA8CP,EAAE,CAACH,IAAI,EAAE,CAAC;IAC1E;IACA,MAAMW,GAAG,GAAGhB,IAAI,CAACiB,UAAU,CAACT,EAAE,EAAEK,KAAK,CAAC;IACtCV,OAAO,CAACQ,GAAG,CAACH,EAAE,EAAEQ,GAAG,CAAC;IACpB,OAAOA,GAAG;EACZ;EAEA,SAASE,OAAOA,CAACC,KAA6B,EAAE;IAC9C,MAAMC,EAAE,GAAGpB,IAAI,CAACqB,UAAU;IAC1B,OAAAC,iBAAA,CACGzB,MAAM;MAAA,IAAA0B,SAAA;QAAA,OAAAD,iBAAA,CACJF,EAAE;UAAA,IAACI,IAAIA,CAAA;YAAA,OAAExB,IAAI,CAACyB,QAAQ;UAAA;UAAA,IAAAF,SAAA;YAAA,QAAAD,iBAAA,CACpB3B,GAAG;cAAA,IAAC+B,IAAIA,CAAA;gBAAA,OAAE,CAAC,GAAGzB,IAAI,CAAC0B,MAAM,CAAC,CAAC,CAAC;cAAA;cAAEC,MAAM;cAAAL,QAAA,EACjCf,EAAE,IAAAc,iBAAA,CAAM5B,WAAW;gBAAA,IAACmC,MAAMA,CAAA;kBAAA,OAAEjB,YAAY,CAACJ,EAAE,CAAC;gBAAA;cAAA;gBAAAsB,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;gBAAAC,UAAA;gBAAAC,YAAA;cAAA;YAAI;cAAAL,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;cAAAC,UAAA;cAAAC,YAAA;YAAA,IAAAC,MAAA,OAEnDjB,KAAK,CAACI,QAAQ;UAAA;QAAA;UAAAO,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;UAAAC,UAAA;UAAAC,YAAA;QAAA;MAAA;IAAA;MAAAL,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;MAAAC,UAAA;MAAAC,YAAA;IAAA;EAIvB;EAEA,OAAO;IAAEjB,OAAO;IAAEd;EAAO,CAAC;AAC5B","ignoreList":[]}
+{"version":3,"names":["Declaration","For","namekey","Output","shallowReactive","createTestWrapper","opts","seen","Map","created","defkey","name","existing","get","nk","ignoreNamePolicy","ignoreNameConflict","set","createSymbol","scope","useScope","Error","sym","makeSymbol","Wrapper","props","SF","SourceFile","_$createComponent","namePolicy","nameConflictResolver","children","path","filePath","each","values","joiner","symbol","fileName","import","meta","url","lineNumber","columnNumber","_$memo"],"sources":["../../../testing/create-test-wrapper.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/testing/extend-expect.js

@@ -3,6 +3,26 @@ import "vitest";
 import { expect } from "vitest";
 import { flushJobs, flushJobsAsync } from "../src/scheduler.js";
 import { dedent } from "./render.js";
+
+/**
+ * Print options passed to `toRenderTo` / `toRenderToAsync`. These override
+ * the per-`SourceFile` print settings for the duration of the assertion,
+ * which is useful when forcing line-breaking with a narrow `printWidth` in
+ * tests without needing extremely long inputs.
+ *
+ * @example
+ * ```ts
+ * expect(<MyList items={["a", "b", "c"]} />).toRenderTo(
+ *   `
+ *   a,
+ *   b,
+ *   c
+ *   `,
+ *   { printWidth: 10 }
+ * );
+ * ```
+ */
+
 expect.extend({
   toRenderTo(received, expectedRaw, renderOptions) {
     const tree = renderTree(received);

package/dist/dev/testing/extend-expect.js.map

@@ -1 +1 @@
-{"version":3,"names":["getContextForRenderNode","getDiagnosticsForTree","printTree","renderTree","expect","flushJobs","flushJobsAsync","dedent","extend","toRenderTo","received","expectedRaw","renderOptions","tree","actual","getFilesFromTree","validateRender","isNot","toRenderToAsync","toHaveDiagnostics","expectedDiagnostics","diagnostics","validateDiagnostics","toHaveDiagnosticsAsync","isAsymmetricMatcher","value","$$typeof","Symbol","for","message","expected","actualStr","Object","keys","length","values","pass","dedentExpected","key","entries","every","asymmetricMatch","map","d","severity","i","actualDiag","expectedDiag","messageMatches","RegExp","test","undefined","options","files","collectSourceFiles","root","Array","isArray","context","meta","sourceFile","path","printWidth","printOptions","tabWidth","useTabs","visitChildren","child"],"sources":["../../../testing/extend-expect.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["getContextForRenderNode","getDiagnosticsForTree","printTree","renderTree","expect","flushJobs","flushJobsAsync","dedent","extend","toRenderTo","received","expectedRaw","renderOptions","tree","actual","getFilesFromTree","validateRender","isNot","toRenderToAsync","toHaveDiagnostics","expectedDiagnostics","diagnostics","validateDiagnostics","toHaveDiagnosticsAsync","isAsymmetricMatcher","value","$$typeof","Symbol","for","message","expected","actualStr","Object","keys","length","values","pass","dedentExpected","key","entries","every","asymmetricMatch","map","d","severity","i","actualDiag","expectedDiag","messageMatches","RegExp","test","undefined","options","files","collectSourceFiles","root","Array","isArray","context","meta","sourceFile","path","printWidth","printOptions","tabWidth","useTabs","visitChildren","child"],"sources":["../../../testing/extend-expect.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/testing/index.js

@@ -1,4 +1,4 @@
-import "./extend-expect.js";
 export * from "./create-test-wrapper.js";
+export * from "./extend-expect.js";
 export * from "./render.js";
 //# sourceMappingURL=index.js.map

package/dist/dev/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../testing/index.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAO,oBAAoB;AAC3B;AACA,cAAc,aAAa","ignoreList":[]}
+{"version":3,"names":[],"sources":["../../../testing/index.ts"],"sourcesContent":[null],"mappings":"AAAA;AACA,cAAc,oBAAoB;AAClC,cAAc,aAAa","ignoreList":[]}

package/dist/dev/testing/render.js

@@ -1,8 +1,19 @@
 import { printTree, renderTree } from "../src/index.js";
 export { printTree } from "../src/index.js";
+
+/**
+ * Render a JSX element tree to a string. Convenience wrapper combining
+ * `renderTree` and `printTree`.
+ */
 export function renderToString(element) {
   return printTree(renderTree(element));
 }
+
+/**
+ * Dedented template literal tag. Strips leading/trailing blank lines and
+ * removes the common leading whitespace from all lines — useful for
+ * multi-line expected output in tests.
+ */
 export function d(strings, ...values) {
   // Combine the strings and values
   const result = strings.reduce((acc, str, i) => acc + str + (values[i] ?? ""), "");

package/dist/dev/testing/render.js.map

@@ -1 +1 @@
-{"version":3,"names":["printTree","renderTree","renderToString","element","d","strings","values","result","reduce","acc","str","i","dedent","replace","match","indent","dedented","split","map","line","startsWith","slice","length","join"],"sources":["../../../testing/render.ts"],"sourcesContent":[null],"mappings":"AAAA,SAAmBA,SAAS,EAAEC,UAAU,QAAQ,iBAAiB;AAEjE,SAASD,SAAS,QAAQ,iBAAiB;AAE3C,OAAO,SAASE,cAAcA,CAACC,OAAiB,EAAE;EAChD,OAAOH,SAAS,CAACC,UAAU,CAACE,OAAO,CAAC,CAAC;AACvC;AAEA,OAAO,SAASC,CAACA,CAACC,OAA6B,EAAE,GAAGC,MAAa,EAAU;EACzE;EACA,MAAMC,MAAM,GAAGF,OAAO,CAACG,MAAM,CAC3B,CAACC,GAAG,EAAEC,GAAG,EAAEC,CAAC,KAAKF,GAAG,GAAGC,GAAG,IAAIJ,MAAM,CAACK,CAAC,CAAC,IAAI,EAAE,CAAC,EAC9C,EACF,CAAC;EAED,OAAOC,MAAM,CAACL,MAAM,CAAC;AACvB;AAEA,OAAO,SAASK,MAAMA,CAACF,GAAW,EAAU;EAC1C;EACAA,GAAG,GAAGA,GAAG,CAACG,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;;EAErC;EACA,MAAMC,KAAK,GAAGJ,GAAG,CAACI,KAAK,CAAC,SAAS,CAAC;EAClC,MAAMC,MAAM,GAAGD,KAAK,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE;;EAEpC;EACA,MAAME,QAAQ,GAAGN,GAAG,CACjBO,KAAK,CAAC,IAAI,CAAC,CACXC,GAAG,CAAEC,IAAI,IAAMA,IAAI,CAACC,UAAU,CAACL,MAAM,CAAC,GAAGI,IAAI,CAACE,KAAK,CAACN,MAAM,CAACO,MAAM,CAAC,GAAGH,IAAK,CAAC,CAC3EI,IAAI,CAAC,IAAI,CAAC;EAEb,OAAOP,QAAQ;AACjB","ignoreList":[]}
+{"version":3,"names":["printTree","renderTree","renderToString","element","d","strings","values","result","reduce","acc","str","i","dedent","replace","match","indent","dedented","split","map","line","startsWith","slice","length","join"],"sources":["../../../testing/render.ts"],"sourcesContent":[null],"mappings":"AAAA,SAAmBA,SAAS,EAAEC,UAAU,QAAQ,iBAAiB;AAEjE,SAASD,SAAS,QAAQ,iBAAiB;;AAE3C;AACA;AACA;AACA;AACA,OAAO,SAASE,cAAcA,CAACC,OAAiB,EAAE;EAChD,OAAOH,SAAS,CAACC,UAAU,CAACE,OAAO,CAAC,CAAC;AACvC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,CAACA,CAACC,OAA6B,EAAE,GAAGC,MAAa,EAAU;EACzE;EACA,MAAMC,MAAM,GAAGF,OAAO,CAACG,MAAM,CAC3B,CAACC,GAAG,EAAEC,GAAG,EAAEC,CAAC,KAAKF,GAAG,GAAGC,GAAG,IAAIJ,MAAM,CAACK,CAAC,CAAC,IAAI,EAAE,CAAC,EAC9C,EACF,CAAC;EAED,OAAOC,MAAM,CAACL,MAAM,CAAC;AACvB;AAEA,OAAO,SAASK,MAAMA,CAACF,GAAW,EAAU;EAC1C;EACAA,GAAG,GAAGA,GAAG,CAACG,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;;EAErC;EACA,MAAMC,KAAK,GAAGJ,GAAG,CAACI,KAAK,CAAC,SAAS,CAAC;EAClC,MAAMC,MAAM,GAAGD,KAAK,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE;;EAEpC;EACA,MAAME,QAAQ,GAAGN,GAAG,CACjBO,KAAK,CAAC,IAAI,CAAC,CACXC,GAAG,CAAEC,IAAI,IAAMA,IAAI,CAACC,UAAU,CAACL,MAAM,CAAC,GAAGI,IAAI,CAACE,KAAK,CAACN,MAAM,CAACO,MAAM,CAAC,GAAGH,IAAK,CAAC,CAC3EI,IAAI,CAAC,IAAI,CAAC;EAEb,OAAOP,QAAQ;AACjB","ignoreList":[]}

package/dist/src/binder.d.ts

@@ -71,7 +71,9 @@ export interface Binder {
  * * **commonScope**: global scope, because this is the most specific scope that contains both the declaration and the reference.
  * * **pathUp**: [namespace scope 2], because this is the scope between the reference and the common scope.
  * * **pathDown**: [namespace scope 1], because this is the scope between the common scope and the declaration
- * * **memberPath**: [foo, bar], because we resolved a member symbol and these are the symbols that lead from the base declaration to the member symbol.
+ * * **memberPath**: [bar]
+ * * **lexicalDeclaration**: foo
+ * For deeper chains (e.g., foo.bar.baz where bar and baz are member symbols, foo is not): memberPath = [bar, baz], lexicalDeclaration = foo.
  */
 export interface ResolutionResult<TScope extends OutputScope, TSymbol extends OutputSymbol> {
     /**
@@ -108,8 +110,8 @@ export interface ResolutionResult<TScope extends OutputScope, TSymbol extends Ou
      */
     commonScope: TScope | undefined;
     /**
-     * When resolving a member symbol, this is the path of symbols that lead from
-     * the lexical declaration to the member symbol.
+     * Member symbols from the lexical declaration (exclusive) to the resolved symbol
+     * (inclusive). Empty when resolving a non-member symbol.
      */
     memberPath: TSymbol[];
 }
@@ -121,6 +123,36 @@ export interface MemberDescriptor {
     symbol: OutputSymbol;
     isMemberAccess: boolean;
 }
+/**
+ * A callable interface invoked by the binder when two or more symbols in the
+ * same scope share a name. The resolver mutates symbol names to eliminate
+ * conflicts (e.g., appending `_2`, `_3`).
+ *
+ * @remarks
+ * The resolver is called with the shared `name` and all symbols in the scope
+ * that have that original name. Rename a symbol by assigning to `symbol.name`.
+ * Symbols with `ignoreNameConflict: true` are excluded. The default resolver
+ * keeps the first symbol unchanged and renames subsequent ones
+ * `originalName + "_2"`, `originalName + "_3"`, etc.
+ *
+ * Assigned names pass through the active name policy before being stored;
+ * design suffixes to produce the correct final name after policy
+ * transformation, or set `ignoreNamePolicy` on the symbol after resolution.
+ *
+ * Conflict detection is keyed on `originalName`
+ * (see {@link OutputSymbol.originalName}). Symbols that differ in original
+ * name but normalize to the same policy-applied name are never detected as
+ * conflicting.
+ *
+ * @example
+ * ```ts
+ * const resolver: NameConflictResolver = (name, symbols) => {
+ *   for (let i = 1; i < symbols.length; i++) {
+ *     symbols[i].name = symbols[i].originalName + "_" + (i + 1);
+ *   }
+ * };
+ * ```
+ */
 export interface NameConflictResolver {
     (name: string, symbols: OutputSymbol[]): void;
 }
@@ -141,7 +173,28 @@ export interface MemberResolutionContext<TScope extends OutputScope> {
     isMemberAccess: boolean;
 }
 /**
+ * A callback that performs access-control filtering during member resolution.
  *
+ * @remarks
+ *
+ * When provided to {@link ResolveDeclarationByKeyOptions}, it entirely replaces
+ * the default checks (ownership assertion and `isMemberSymbol` assertion).
+ *
+ * **Contract:**
+ * - **Return `void`** to accept the member.
+ * - **Throw an error** to reject the member — the error propagates to the caller,
+ *   matching the behavior of the default checks.
+ *
+ * @example
+ * ```ts
+ * const resolver: MemberResolver<MyScope, MySymbol> = (owner, member, ctx) => {
+ *   if (member.isPrivate && !ctx.isMemberAccess) {
+ *     throw new Error(`${member.name} is not accessible here`);
+ *   }
+ * };
+ * ```
+ *
+ * @see {@link MemberResolutionContext} for available context properties.
  */
 export interface MemberResolver<TScope extends OutputScope, TSymbol extends OutputSymbol> {
     (owner: TSymbol, member: TSymbol, context: MemberResolutionContext<TScope>): void;
@@ -152,7 +205,44 @@ export interface ResolveDeclarationByKeyOptions<TScope extends OutputScope, TSym
 export interface BinderOptions {
     nameConflictResolver?: NameConflictResolver;
 }
+/**
+ * Construct a scope instance and register it with devtools. Prefer this over
+ * calling `new` directly so that debugging tools can track the scope.
+ *
+ * @remarks
+ *
+ * Inside a component, obtain the current scope with `useScope()` and pass it
+ * as the `parentScope` constructor argument so the new scope is wired into
+ * the scope tree.
+ *
+ * @example
+ * ```tsx
+ * function MyScope(props) {
+ *   const parentScope = useScope();
+ *   const scope = createScope(MyScope, "scope-name", parentScope);
+ *   return <Scope value={scope}>{props.children}</Scope>;
+ * }
+ * ```
+ *
+ * @param ctor - The scope subclass constructor.
+ * @param args - Positional arguments forwarded directly to the scope
+ * constructor; see {@link OutputScope} for the base-class constructor
+ * signature.
+ */
 export declare function createScope<TScope extends OutputScope, Args extends unknown[]>(ctor: new (...args: Args) => TScope, ...args: Args): TScope;
+/**
+ * Construct a symbol instance and register it with devtools. Prefer this over
+ * calling `new` directly so that debugging tools can track the symbol.
+ *
+ * @remarks
+ *
+ * Binder registration (via `useBinder()` + `notifySymbolCreated()`) happens
+ * inside the `OutputSymbol` constructor regardless of whether you use
+ * `createSymbol` or `new`. This helper only adds devtools registration.
+ *
+ * @param ctor - The symbol subclass constructor.
+ * @param args - Arguments forwarded to the constructor.
+ */
 export declare function createSymbol<TSymbol extends OutputSymbol, Args extends unknown[]>(ctor: new (...args: Args) => TSymbol, ...args: Args): TSymbol;
 export declare function createOutputBinder(options?: BinderOptions): Binder;
 /**
@@ -181,6 +271,20 @@ export declare function symbolForRefkey(refkey: Refkeyable): Ref<OutputSymbol |
 declare const createSymbolsSymbol: unique symbol;
 export declare function getSymbolCreator(creator: SymbolCreator): SymbolCreator[typeof createSymbolsSymbol];
 export declare function getSymbolCreatorSymbol(): typeof createSymbolsSymbol;
+/**
+ * An object that can register symbols into a binder. Pass instances to the
+ * `externals` prop of `<Output>` to make library symbols resolvable.
+ *
+ * @remarks
+ * `SymbolCreator` is a low-level core mechanism for eager symbol registration.
+ * The recommended pattern for language packages is lazy self-registration:
+ * implement `[TO_SYMBOL]()` on descriptors to call `useBinder()`, create and
+ * cache symbols per binder via a `WeakMap`, and register them into the
+ * appropriate scope automatically. This approach does not require `externals`.
+ * See the C# package's `createLibrary()` for a reference implementation.
+ *
+ * See {@link TO_SYMBOL} and {@link REFKEYABLE}.
+ */
 export interface SymbolCreator {
     [createSymbolsSymbol](binder: Binder): void;
 }

package/dist/src/binder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binder.d.ts","sourceRoot":"","sources":["../../src/binder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binder.d.ts","sourceRoot":"","sources":["../../src/binder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAA0B,MAAM,iBAAiB,CAAC;AAOxE,OAAO,EAKL,MAAM,EACN,UAAU,EAEX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;OAMG;IACH,uBAAuB,CACrB,MAAM,SAAS,WAAW,GAAG,WAAW,EACxC,OAAO,SAAS,YAAY,GAAG,YAAY,EAE3C,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GACxD,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAEtD;;;OAGG;IACH,kBAAkB,CAAC,OAAO,SAAS,YAAY,EAC7C,MAAM,EAAE,UAAU,GACjB,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAE5B;;OAEG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,gBAAgB,CAC/B,MAAM,SAAS,WAAW,EAC1B,OAAO,SAAS,YAAY;IAE5B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;;;OAMG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;;OAGG;IACH,UAAU,EAAE,OAAO,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,MAAM,SAAS,WAAW;IACjE;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,cAAc,CAC7B,MAAM,SAAS,WAAW,EAC1B,OAAO,SAAS,YAAY;IAE5B,CACE,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACvC,IAAI,CAAC;CACT;AACD,MAAM,WAAW,8BAA8B,CAC7C,MAAM,SAAS,WAAW,EAC1B,OAAO,SAAS,YAAY;IAE5B,cAAc,CAAC,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClD;AACD,MAAM,WAAW,aAAa;IAC5B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,MAAM,SAAS,WAAW,EAAE,IAAI,SAAS,OAAO,EAAE,EAC5E,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,EACnC,GAAG,IAAI,EAAE,IAAI,GACZ,MAAM,CAIR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,OAAO,SAAS,YAAY,EAC5B,IAAI,SAAS,OAAO,EAAE,EACtB,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,GAAG,OAAO,CAI9D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CA0dtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,MAAM,SAAS,WAAW,EAC1B,OAAO,SAAS,YAAY,EAE5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAM,GAC5D,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoDxC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,2DAMjD;AAED,QAAA,MAAM,mBAAmB,EAAE,OAAO,MAAiB,CAAC;AACpD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,GACrB,aAAa,CAAC,OAAO,mBAAmB,CAAC,CAE3C;AAED,wBAAgB,sBAAsB,IAAI,OAAO,mBAAmB,CAEnE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,mBAAmB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C"}