skybridge 0.0.0-dev.ecf87cf → 0.0.0-dev.ed29eee

package/dist/web/mount-view.js

@@ -0,0 +1,46 @@
+/// <reference types="vite/client" />
+import { createElement, StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { installOpenAILoggingProxy } from "./proxy.js";
+let rootInstance = null;
+/**
+ * Mount a view's root React component into `#root`. Each view file's entry
+ * point should call this exactly once.
+ *
+ * Wraps the component in `StrictMode`, applies host-specific providers
+ * automatically (e.g. modal support for MCP Apps), and installs the dev-mode
+ * logging proxy for `window.openai` calls.
+ *
+ * @param component - Your root React element (already constructed, e.g. `<App />`).
+ *
+ * @example
+ * ```tsx
+ * // src/views/search.tsx
+ * import { mountView } from "skybridge/web";
+ * import { App } from "./App";
+ *
+ * mountView(<App />);
+ * ```
+ */
+export const mountView = (component) => {
+    const rootElement = document.getElementById("root");
+    if (!rootElement) {
+        throw new Error("Root element not found");
+    }
+    if (!rootInstance) {
+        rootInstance = createRoot(rootElement);
+    }
+    if (import.meta.env.DEV) {
+        installOpenAILoggingProxy();
+    }
+    const hostType = window.skybridge?.hostType;
+    (async () => {
+        let app = component;
+        if (hostType === "mcp-app") {
+            const { ModalProvider } = await import("./components/modal-provider.js");
+            app = createElement(ModalProvider, null, component);
+        }
+        rootInstance.render(createElement(StrictMode, null, app));
+    })();
+};
+//# sourceMappingURL=mount-view.js.map

package/dist/web/mount-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-view.js","sourceRoot":"","sources":["../../src/web/mount-view.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,IAAI,YAAY,GAAgB,IAAI,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAA0B,EAAE,EAAE;IACtD,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACxB,yBAAyB,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;IAE5C,CAAC,KAAK,IAAI,EAAE;QACV,IAAI,GAAG,GAAG,SAAS,CAAC;QACpB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YACzE,GAAG,GAAG,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACtD,CAAC;QACD,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,EAAE,CAAC;AACP,CAAC,CAAC","sourcesContent":["/// <reference types=\"vite/client\" />\n\nimport { createElement, StrictMode } from \"react\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { installOpenAILoggingProxy } from \"./proxy.js\";\n\nlet rootInstance: Root | null = null;\n\n/**\n * Mount a view's root React component into `#root`. Each view file's entry\n * point should call this exactly once.\n *\n * Wraps the component in `StrictMode`, applies host-specific providers\n * automatically (e.g. modal support for MCP Apps), and installs the dev-mode\n * logging proxy for `window.openai` calls.\n *\n * @param component - Your root React element (already constructed, e.g. `<App />`).\n *\n * @example\n * ```tsx\n * // src/views/search.tsx\n * import { mountView } from \"skybridge/web\";\n * import { App } from \"./App\";\n *\n * mountView(<App />);\n * ```\n */\nexport const mountView = (component: React.ReactNode) => {\n  const rootElement = document.getElementById(\"root\");\n  if (!rootElement) {\n    throw new Error(\"Root element not found\");\n  }\n\n  if (!rootInstance) {\n    rootInstance = createRoot(rootElement);\n  }\n\n  if (import.meta.env.DEV) {\n    installOpenAILoggingProxy();\n  }\n\n  const hostType = window.skybridge?.hostType;\n\n  (async () => {\n    let app = component;\n    if (hostType === \"mcp-app\") {\n      const { ModalProvider } = await import(\"./components/modal-provider.js\");\n      app = createElement(ModalProvider, null, component);\n    }\n    rootInstance.render(createElement(StrictMode, null, app));\n  })();\n};\n"]}

package/dist/web/plugin/data-llm.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web/plugin/data-llm.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-llm.test.js","sourceRoot":"","sources":["../../../src/web/plugin/data-llm.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { transform } from \"./transform-data-llm.js\";\n\ndescribe(\"data-llm plugin\", () => {\n  it(\"should transform JSX element with data-llm string attribute\", async () => {\n    const code = `\n      function Component() {\n        return <div data-llm=\"Test description\">Content</div>;\n      }\n    `;\n\n    const result = await transform(code, \"test.tsx\");\n\n    expect(result).not.toBeNull();\n    expect(result?.code).toContain(\"DataLLM\");\n    expect(result?.code).toContain('content=\"Test description\"');\n    expect(result?.code).not.toContain(\"data-llm\");\n  });\n\n  it(\"should transform JSX element with data-llm expression attribute\", async () => {\n    const code = `\n      function Component() {\n        const desc = \"Dynamic description\";\n        return <div data-llm={desc}>Content</div>;\n      }\n    `;\n\n    const result = await transform(code, \"test.tsx\");\n\n    expect(result).not.toBeNull();\n    expect(result?.code).toContain(\"DataLLM\");\n    expect(result?.code).toContain(\"content={desc}\");\n    expect(result?.code).not.toContain(\"data-llm\");\n  });\n\n  it(\"should add import for DataLLM when not present\", async () => {\n    const code = `\n      function Component() {\n        return <div data-llm=\"Test\">Content</div>;\n      }\n    `;\n\n    const result = await transform(code, \"test.tsx\");\n\n    expect(result).not.toBeNull();\n    expect(result?.code).toContain('import { DataLLM } from \"skybridge/web\"');\n  });\n\n  it(\"should handle DataLLM imports correctly\", async () => {\n    // No duplicate import\n    const codeWithImport = `\n      import { DataLLM } from \"skybridge/web\";\n      function Component() {\n        return <div data-llm=\"Test\">Content</div>;\n      }\n    `;\n    const result1 = await transform(codeWithImport, \"test.tsx\");\n    expect(\n      result1?.code.match(/import.*DataLLM.*from.*skybridge\\/web/g),\n    ).toHaveLength(1);\n\n    // Preserve other imports and add missing DataLLM\n    const codeWithOthers = `\n      import React from \"react\";\n      import { useState } from \"react\";\n      function Component() {\n        return <div data-llm=\"Test\">Content</div>;\n      }\n    `;\n    const result2 = await transform(codeWithOthers, \"test.tsx\");\n    expect(result2?.code).toContain('import React from \"react\"');\n    expect(result2?.code).toContain('import { useState } from \"react\"');\n    expect(result2?.code).toContain('import { DataLLM } from \"skybridge/web\"');\n  });\n\n  it(\"should handle complex JSX with multiple data-llm attributes\", async () => {\n    const code = `\n      function Component() {\n        return (\n          <div>\n            <section data-llm=\"Section 1\">\n              <p>Content 1</p>\n            </section>\n            <section data-llm=\"Section 2\">\n              <p>Content 2</p>\n            </section>\n          </div>\n        );\n      }\n    `;\n\n    const result = await transform(code, \"test.tsx\");\n\n    expect(result).toMatchSnapshot();\n  });\n});\n"]}

package/dist/web/plugin/plugin-build.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web/plugin/plugin-build.test.js

@@ -0,0 +1,54 @@
+// @vitest-environment node
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { build } from "vite";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { skybridge } from "./plugin.js";
+/**
+ * Full `vite build` over a fixture whose stylesheet contains a `url()`. The
+ * unit test pins the `renderBuiltUrl` contract; this one proves Vite actually
+ * accepts what the plugin returns.
+ */
+describe("skybridge plugin build", () => {
+    let root;
+    beforeEach(() => {
+        root = mkdtempSync(join(tmpdir(), "skybridge-build-"));
+        mkdirSync(join(root, "views"), { recursive: true });
+        mkdirSync(join(root, "src"), { recursive: true });
+        writeFileSync(join(root, "src/demo.woff2"), Buffer.alloc(64, 1));
+        writeFileSync(join(root, "src/styles.css"), [
+            "@font-face {",
+            '  font-family: "Demo";',
+            '  src: url("./demo.woff2") format("woff2");',
+            "}",
+        ].join("\n"));
+        writeFileSync(join(root, "src/entry.js"), `import "./styles.css";\n`);
+    });
+    afterEach(() => {
+        rmSync(root, { recursive: true, force: true });
+    });
+    it("builds a view stylesheet that references a font", async () => {
+        const result = await build({
+            root,
+            logLevel: "silent",
+            plugins: [skybridge({ viewsDir: join(root, "views") })],
+            build: {
+                // Force the font to be emitted as a file rather than inlined, so the
+                // stylesheet actually carries a `url()`.
+                assetsInlineLimit: 0,
+                rollupOptions: { input: { entry: join(root, "src/entry.js") } },
+            },
+        });
+        const outputs = (Array.isArray(result) ? result : [result]).flatMap((bundle) => ("output" in bundle ? bundle.output : []));
+        const css = outputs.find((chunk) => chunk.type === "asset" && chunk.fileName.endsWith(".css"));
+        if (css?.type !== "asset") {
+            throw new Error("no CSS asset was emitted");
+        }
+        // The font resolves relative to the stylesheet, which the server hands out
+        // from `${serverUrl}/assets/` — no runtime expression, which CSS can't run.
+        expect(String(css.source)).toMatch(/url\(\.\/demo-[\w-]+\.woff2\)/);
+        expect(String(css.source)).not.toContain("window.skybridge");
+    });
+});
+//# sourceMappingURL=plugin-build.test.js.map

package/dist/web/plugin/plugin-build.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-build.test.js","sourceRoot":"","sources":["../../../src/web/plugin/plugin-build.test.ts"],"names":[],"mappings":"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","sourcesContent":["// @vitest-environment node\nimport { mkdirSync, mkdtempSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { build } from \"vite\";\nimport { afterEach, beforeEach, describe, expect, it } from \"vitest\";\nimport { skybridge } from \"./plugin.js\";\n\n/**\n * Full `vite build` over a fixture whose stylesheet contains a `url()`. The\n * unit test pins the `renderBuiltUrl` contract; this one proves Vite actually\n * accepts what the plugin returns.\n */\ndescribe(\"skybridge plugin build\", () => {\n  let root: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-build-\"));\n    mkdirSync(join(root, \"views\"), { recursive: true });\n    mkdirSync(join(root, \"src\"), { recursive: true });\n\n    writeFileSync(join(root, \"src/demo.woff2\"), Buffer.alloc(64, 1));\n    writeFileSync(\n      join(root, \"src/styles.css\"),\n      [\n        \"@font-face {\",\n        '  font-family: \"Demo\";',\n        '  src: url(\"./demo.woff2\") format(\"woff2\");',\n        \"}\",\n      ].join(\"\\n\"),\n    );\n    writeFileSync(join(root, \"src/entry.js\"), `import \"./styles.css\";\\n`);\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"builds a view stylesheet that references a font\", async () => {\n    const result = await build({\n      root,\n      logLevel: \"silent\",\n      plugins: [skybridge({ viewsDir: join(root, \"views\") })],\n      build: {\n        // Force the font to be emitted as a file rather than inlined, so the\n        // stylesheet actually carries a `url()`.\n        assetsInlineLimit: 0,\n        rollupOptions: { input: { entry: join(root, \"src/entry.js\") } },\n      },\n    });\n\n    const outputs = (Array.isArray(result) ? result : [result]).flatMap(\n      (bundle) => (\"output\" in bundle ? bundle.output : []),\n    );\n    const css = outputs.find(\n      (chunk) => chunk.type === \"asset\" && chunk.fileName.endsWith(\".css\"),\n    );\n    if (css?.type !== \"asset\") {\n      throw new Error(\"no CSS asset was emitted\");\n    }\n\n    // The font resolves relative to the stylesheet, which the server hands out\n    // from `${serverUrl}/assets/` — no runtime expression, which CSS can't run.\n    expect(String(css.source)).toMatch(/url\\(\\.\\/demo-[\\w-]+\\.woff2\\)/);\n    expect(String(css.source)).not.toContain(\"window.skybridge\");\n  });\n});\n"]}

package/dist/web/plugin/plugin.d.ts

@@ -0,0 +1,39 @@
+import type { Plugin } from "vite";
+/** Options for the {@link skybridge} Vite plugin. */
+export interface SkybridgePluginOptions {
+    /** Directory scanned for view modules. Defaults to `"src/views"`. */
+    viewsDir?: string;
+    /**
+     * Package names to leave unbundled when `skybridge build` bundles the server
+     * for deployment. Use it for dependencies esbuild can't resolve or load —
+     * typically optional native modules pulled in by a transitive dependency.
+     */
+    serverExternal?: string[];
+}
+/**
+ * Vite plugin that wires a Skybridge project's view files into Vite.
+ *
+ * For each `.tsx` / `.jsx` file in `viewsDir` with a default export, the
+ * plugin:
+ * - exposes a virtual entry that calls {@link mountView} with the view's
+ *   default export,
+ * - generates `.skybridge/views.d.ts` to augment {@link ViewNameRegistry} so
+ *   {@link ViewName} narrows to the actual view names,
+ * - rewrites `<DataLLM>` JSX so the host can extract its content,
+ * - warns in dev if a view file is missing a default export.
+ *
+ * Add it to your `vite.config.ts` alongside `@vitejs/plugin-react`.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite";
+ * import react from "@vitejs/plugin-react";
+ * import { skybridge } from "skybridge/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [react(), skybridge({ viewsDir: "src/views" })],
+ * });
+ * ```
+ */
+export declare function skybridge(options?: SkybridgePluginOptions): Plugin;

package/dist/web/plugin/plugin.js

@@ -0,0 +1,200 @@
+import { isAbsolute, relative, resolve } from "node:path";
+import { assertUniqueViewNames, discoverViewsSync, scanViewsSync, writeViewsDts, } from "./scan-views.js";
+import { transform as dataLlmTransform } from "./transform-data-llm.js";
+import { hasDefaultExport } from "./validate-view.js";
+const VIRTUAL_PREFIX = "/_skybridge/view/";
+const VIRTUAL_MODULE_PREFIX = "\0skybridge:view:";
+function buildVirtualEntry(viewFilePath) {
+    const normalized = viewFilePath.replace(/\\/g, "/");
+    return [
+        `import { mountView } from "skybridge/web";`,
+        `import Component from "${normalized}";`,
+        `import { createElement } from "react";`,
+        `mountView(createElement(Component));`,
+    ].join("\n");
+}
+function getViewEntryPattern(viewsDir) {
+    const escaped = viewsDir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`${escaped}\\/(?:[^/]+\\.(?:jsx|tsx)|[^/]+\\/index\\.(?:tsx|jsx))(?:\\?.*)?$`);
+}
+/**
+ * Vite plugin that wires a Skybridge project's view files into Vite.
+ *
+ * For each `.tsx` / `.jsx` file in `viewsDir` with a default export, the
+ * plugin:
+ * - exposes a virtual entry that calls {@link mountView} with the view's
+ *   default export,
+ * - generates `.skybridge/views.d.ts` to augment {@link ViewNameRegistry} so
+ *   {@link ViewName} narrows to the actual view names,
+ * - rewrites `<DataLLM>` JSX so the host can extract its content,
+ * - warns in dev if a view file is missing a default export.
+ *
+ * Add it to your `vite.config.ts` alongside `@vitejs/plugin-react`.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite";
+ * import react from "@vitejs/plugin-react";
+ * import { skybridge } from "skybridge/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [react(), skybridge({ viewsDir: "src/views" })],
+ * });
+ * ```
+ */
+export function skybridge(options) {
+    const rawViewsDir = options?.viewsDir ?? "src/views";
+    let resolvedViewsDir;
+    let projectRoot;
+    let viewMap = new Map();
+    let viewEntryPattern;
+    return {
+        name: "skybridge",
+        enforce: "pre",
+        // Read by `skybridge build` to resolve viewsDir before `tsc -b` runs, and
+        // to feed esbuild's external list when bundling the server.
+        api: { viewsDir: rawViewsDir, serverExternal: options?.serverExternal },
+        config(config) {
+            projectRoot = config.root || process.cwd();
+            resolvedViewsDir = isAbsolute(rawViewsDir)
+                ? rawViewsDir
+                : resolve(projectRoot, rawViewsDir);
+            viewEntryPattern = getViewEntryPattern(resolvedViewsDir);
+            const views = discoverViewsSync(resolvedViewsDir);
+            viewMap = new Map(views.map((v) => [v.name, v]));
+            writeViewsDts(projectRoot, views);
+            const input = {};
+            for (const view of views) {
+                input[view.name] = `${VIRTUAL_PREFIX}${view.name}`;
+            }
+            return {
+                base: "/assets",
+                // Fixes "Invalid hook call" on createStore by forcing a single
+                // copy of React. Under pnpm's isolated node_modules, zustand
+                // inside `skybridge` resolves React from skybridge's own
+                // dependencies while the host app loads its own copy
+                resolve: {
+                    dedupe: ["react", "react-dom"],
+                },
+                build: {
+                    outDir: "dist/assets",
+                    emptyOutDir: true,
+                    manifest: true,
+                    minify: true,
+                    cssCodeSplit: false,
+                    rollupOptions: {
+                        input,
+                    },
+                },
+                // Pre-bundle view deps at startup so the first tool invocation
+                // doesn't hit Vite's on-demand re-optimization path (which sends
+                // `full-reload` over HMR — in our iframe flow the parent host
+                // can't honour a reload, and the view silently never mounts).
+                optimizeDeps: {
+                    // Scan view files so transitive user deps (zod, tailwind, etc.)
+                    // get pre-bundled at startup.
+                    entries: [
+                        `${resolvedViewsDir}/*.{tsx,jsx}`,
+                        `${resolvedViewsDir}/*/index.{tsx,jsx}`,
+                    ],
+                    include: ["react", "react-dom/client", "react/jsx-runtime"],
+                },
+                experimental: {
+                    renderBuiltUrl: (filename, { hostType }) => {
+                        // Views render inside a host sandbox iframe, so `import.meta.url`
+                        // points at the sandbox domain rather than the Skybridge server.
+                        // JS asset references have to be resolved at runtime against
+                        // `window.skybridge.serverUrl` so they follow tunnels too.
+                        if (hostType === "js") {
+                            return {
+                                runtime: `window.skybridge.serverUrl + "/assets/${filename}"`,
+                            };
+                        }
+                        // CSS has nowhere to evaluate a runtime expression — `vite:css-post`
+                        // throws on one. It doesn't need it either: the stylesheet is served
+                        // from `${serverUrl}/assets/…` and a relative `url()` resolves
+                        // against the stylesheet's own URL, tunnel origin included.
+                        return { relative: true };
+                    },
+                },
+            };
+        },
+        resolveId(id) {
+            if (id.startsWith(VIRTUAL_PREFIX)) {
+                const name = id.slice(VIRTUAL_PREFIX.length);
+                if (viewMap.has(name)) {
+                    return `${VIRTUAL_MODULE_PREFIX}${name}`;
+                }
+            }
+            return null;
+        },
+        load(id) {
+            if (id.startsWith(VIRTUAL_MODULE_PREFIX)) {
+                const name = id.slice(VIRTUAL_MODULE_PREFIX.length);
+                const view = viewMap.get(name);
+                if (view) {
+                    return buildVirtualEntry(view.filePath);
+                }
+            }
+            return null;
+        },
+        configureServer(server) {
+            if (!resolvedViewsDir) {
+                const root = server.config.root || process.cwd();
+                resolvedViewsDir = isAbsolute(rawViewsDir)
+                    ? rawViewsDir
+                    : resolve(root, rawViewsDir);
+                projectRoot = root;
+                viewEntryPattern = getViewEntryPattern(resolvedViewsDir);
+            }
+            server.watcher.add(resolvedViewsDir);
+            // Track which view files we've already warned about so a rescan
+            // triggered by an unrelated edit doesn't re-emit the same warning.
+            let knownInvalid = new Set();
+            const rescan = () => {
+                try {
+                    // Surface broken view files. Without this, files lacking a
+                    // default export are silently dropped from the input and the
+                    // user has no idea why their widget never mounts.
+                    const { valid, invalid } = scanViewsSync(resolvedViewsDir);
+                    const nextInvalid = new Set(invalid.map((v) => v.filePath));
+                    for (const filePath of nextInvalid) {
+                        if (!knownInvalid.has(filePath)) {
+                            server.config.logger.warn(`[skybridge] view file "${relative(projectRoot, filePath)}" is missing a default export — it won't be served until fixed.`);
+                        }
+                    }
+                    for (const filePath of knownInvalid) {
+                        if (!nextInvalid.has(filePath)) {
+                            server.config.logger.info(`[skybridge] view file "${relative(projectRoot, filePath)}" resolved.`);
+                        }
+                    }
+                    knownInvalid = nextInvalid;
+                    assertUniqueViewNames(valid);
+                    viewMap = new Map(valid.map((v) => [v.name, v]));
+                    writeViewsDts(projectRoot, valid);
+                }
+                catch (err) {
+                    // assertUniqueViewNames throws on duplicate view names. Catch so
+                    // chokidar's listener chain doesn't surface it as unhandled and
+                    // crash the dev server — previous viewMap stays active until
+                    // the user fixes the conflict.
+                    const message = err instanceof Error ? err.message : String(err);
+                    server.config.logger.error(`[skybridge] view rescan failed: ${message}`);
+                }
+            };
+            // Initial scan emits warnings for broken files that exist at startup.
+            rescan();
+            server.watcher.on("add", rescan);
+            server.watcher.on("change", rescan);
+            server.watcher.on("unlink", rescan);
+        },
+        async transform(code, id) {
+            if (viewEntryPattern?.test(id) && !hasDefaultExport(code, id)) {
+                this.warn(`View file "${id.split("/").pop()}" is missing a default export.`);
+            }
+            return await dataLlmTransform(code, id);
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/web/plugin/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/web/plugin/plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute, relative, resolve } from \"node:path\";\nimport type { Plugin, ViteDevServer } from \"vite\";\nimport {\n  assertUniqueViewNames,\n  type DiscoveredView,\n  discoverViewsSync,\n  scanViewsSync,\n  writeViewsDts,\n} from \"./scan-views.js\";\nimport { transform as dataLlmTransform } from \"./transform-data-llm.js\";\nimport { hasDefaultExport } from \"./validate-view.js\";\n\nconst VIRTUAL_PREFIX = \"/_skybridge/view/\";\nconst VIRTUAL_MODULE_PREFIX = \"\\0skybridge:view:\";\n\n/** Options for the {@link skybridge} Vite plugin. */\nexport interface SkybridgePluginOptions {\n  /** Directory scanned for view modules. Defaults to `\"src/views\"`. */\n  viewsDir?: string;\n  /**\n   * Package names to leave unbundled when `skybridge build` bundles the server\n   * for deployment. Use it for dependencies esbuild can't resolve or load —\n   * typically optional native modules pulled in by a transitive dependency.\n   */\n  serverExternal?: string[];\n}\n\nfunction buildVirtualEntry(viewFilePath: string): string {\n  const normalized = viewFilePath.replace(/\\\\/g, \"/\");\n  return [\n    `import { mountView } from \"skybridge/web\";`,\n    `import Component from \"${normalized}\";`,\n    `import { createElement } from \"react\";`,\n    `mountView(createElement(Component));`,\n  ].join(\"\\n\");\n}\n\nfunction getViewEntryPattern(viewsDir: string): RegExp {\n  const escaped = viewsDir.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  return new RegExp(\n    `${escaped}\\\\/(?:[^/]+\\\\.(?:jsx|tsx)|[^/]+\\\\/index\\\\.(?:tsx|jsx))(?:\\\\?.*)?$`,\n  );\n}\n\n/**\n * Vite plugin that wires a Skybridge project's view files into Vite.\n *\n * For each `.tsx` / `.jsx` file in `viewsDir` with a default export, the\n * plugin:\n * - exposes a virtual entry that calls {@link mountView} with the view's\n *   default export,\n * - generates `.skybridge/views.d.ts` to augment {@link ViewNameRegistry} so\n *   {@link ViewName} narrows to the actual view names,\n * - rewrites `<DataLLM>` JSX so the host can extract its content,\n * - warns in dev if a view file is missing a default export.\n *\n * Add it to your `vite.config.ts` alongside `@vitejs/plugin-react`.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { defineConfig } from \"vite\";\n * import react from \"@vitejs/plugin-react\";\n * import { skybridge } from \"skybridge/vite\";\n *\n * export default defineConfig({\n *   plugins: [react(), skybridge({ viewsDir: \"src/views\" })],\n * });\n * ```\n */\nexport function skybridge(options?: SkybridgePluginOptions): Plugin {\n  const rawViewsDir = options?.viewsDir ?? \"src/views\";\n  let resolvedViewsDir: string;\n  let projectRoot: string;\n  let viewMap = new Map<string, DiscoveredView>();\n  let viewEntryPattern: RegExp;\n\n  return {\n    name: \"skybridge\",\n    enforce: \"pre\",\n    // Read by `skybridge build` to resolve viewsDir before `tsc -b` runs, and\n    // to feed esbuild's external list when bundling the server.\n    api: { viewsDir: rawViewsDir, serverExternal: options?.serverExternal },\n\n    config(config) {\n      projectRoot = config.root || process.cwd();\n      resolvedViewsDir = isAbsolute(rawViewsDir)\n        ? rawViewsDir\n        : resolve(projectRoot, rawViewsDir);\n      viewEntryPattern = getViewEntryPattern(resolvedViewsDir);\n\n      const views = discoverViewsSync(resolvedViewsDir);\n      viewMap = new Map(views.map((v) => [v.name, v]));\n      writeViewsDts(projectRoot, views);\n\n      const input: Record<string, string> = {};\n      for (const view of views) {\n        input[view.name] = `${VIRTUAL_PREFIX}${view.name}`;\n      }\n\n      return {\n        base: \"/assets\",\n        // Fixes \"Invalid hook call\" on createStore by forcing a single\n        // copy of React. Under pnpm's isolated node_modules, zustand\n        // inside `skybridge` resolves React from skybridge's own\n        // dependencies while the host app loads its own copy\n        resolve: {\n          dedupe: [\"react\", \"react-dom\"],\n        },\n        build: {\n          outDir: \"dist/assets\",\n          emptyOutDir: true,\n          manifest: true,\n          minify: true,\n          cssCodeSplit: false,\n          rollupOptions: {\n            input,\n          },\n        },\n        // Pre-bundle view deps at startup so the first tool invocation\n        // doesn't hit Vite's on-demand re-optimization path (which sends\n        // `full-reload` over HMR — in our iframe flow the parent host\n        // can't honour a reload, and the view silently never mounts).\n        optimizeDeps: {\n          // Scan view files so transitive user deps (zod, tailwind, etc.)\n          // get pre-bundled at startup.\n          entries: [\n            `${resolvedViewsDir}/*.{tsx,jsx}`,\n            `${resolvedViewsDir}/*/index.{tsx,jsx}`,\n          ],\n          include: [\"react\", \"react-dom/client\", \"react/jsx-runtime\"],\n        },\n        experimental: {\n          renderBuiltUrl: (filename, { hostType }) => {\n            // Views render inside a host sandbox iframe, so `import.meta.url`\n            // points at the sandbox domain rather than the Skybridge server.\n            // JS asset references have to be resolved at runtime against\n            // `window.skybridge.serverUrl` so they follow tunnels too.\n            if (hostType === \"js\") {\n              return {\n                runtime: `window.skybridge.serverUrl + \"/assets/${filename}\"`,\n              };\n            }\n            // CSS has nowhere to evaluate a runtime expression — `vite:css-post`\n            // throws on one. It doesn't need it either: the stylesheet is served\n            // from `${serverUrl}/assets/…` and a relative `url()` resolves\n            // against the stylesheet's own URL, tunnel origin included.\n            return { relative: true };\n          },\n        },\n      };\n    },\n\n    resolveId(id) {\n      if (id.startsWith(VIRTUAL_PREFIX)) {\n        const name = id.slice(VIRTUAL_PREFIX.length);\n        if (viewMap.has(name)) {\n          return `${VIRTUAL_MODULE_PREFIX}${name}`;\n        }\n      }\n      return null;\n    },\n\n    load(id) {\n      if (id.startsWith(VIRTUAL_MODULE_PREFIX)) {\n        const name = id.slice(VIRTUAL_MODULE_PREFIX.length);\n        const view = viewMap.get(name);\n        if (view) {\n          return buildVirtualEntry(view.filePath);\n        }\n      }\n      return null;\n    },\n\n    configureServer(server: ViteDevServer) {\n      if (!resolvedViewsDir) {\n        const root = server.config.root || process.cwd();\n        resolvedViewsDir = isAbsolute(rawViewsDir)\n          ? rawViewsDir\n          : resolve(root, rawViewsDir);\n        projectRoot = root;\n        viewEntryPattern = getViewEntryPattern(resolvedViewsDir);\n      }\n\n      server.watcher.add(resolvedViewsDir);\n      // Track which view files we've already warned about so a rescan\n      // triggered by an unrelated edit doesn't re-emit the same warning.\n      let knownInvalid = new Set<string>();\n      const rescan = () => {\n        try {\n          // Surface broken view files. Without this, files lacking a\n          // default export are silently dropped from the input and the\n          // user has no idea why their widget never mounts.\n          const { valid, invalid } = scanViewsSync(resolvedViewsDir);\n          const nextInvalid = new Set(invalid.map((v) => v.filePath));\n\n          for (const filePath of nextInvalid) {\n            if (!knownInvalid.has(filePath)) {\n              server.config.logger.warn(\n                `[skybridge] view file \"${relative(projectRoot, filePath)}\" is missing a default export — it won't be served until fixed.`,\n              );\n            }\n          }\n          for (const filePath of knownInvalid) {\n            if (!nextInvalid.has(filePath)) {\n              server.config.logger.info(\n                `[skybridge] view file \"${relative(projectRoot, filePath)}\" resolved.`,\n              );\n            }\n          }\n          knownInvalid = nextInvalid;\n\n          assertUniqueViewNames(valid);\n          viewMap = new Map(valid.map((v) => [v.name, v]));\n          writeViewsDts(projectRoot, valid);\n        } catch (err) {\n          // assertUniqueViewNames throws on duplicate view names. Catch so\n          // chokidar's listener chain doesn't surface it as unhandled and\n          // crash the dev server — previous viewMap stays active until\n          // the user fixes the conflict.\n          const message = err instanceof Error ? err.message : String(err);\n          server.config.logger.error(\n            `[skybridge] view rescan failed: ${message}`,\n          );\n        }\n      };\n\n      // Initial scan emits warnings for broken files that exist at startup.\n      rescan();\n      server.watcher.on(\"add\", rescan);\n      server.watcher.on(\"change\", rescan);\n      server.watcher.on(\"unlink\", rescan);\n    },\n\n    async transform(code, id) {\n      if (viewEntryPattern?.test(id) && !hasDefaultExport(code, id)) {\n        this.warn(\n          `View file \"${id.split(\"/\").pop()}\" is missing a default export.`,\n        );\n      }\n\n      return await dataLlmTransform(code, id);\n    },\n  };\n}\n"]}

package/dist/web/plugin/plugin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web/plugin/plugin.test.js

@@ -0,0 +1,61 @@
+import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { skybridge } from "./plugin.js";
+function getRenderBuiltUrl(root) {
+    const plugin = skybridge({ viewsDir: join(root, "views") });
+    const hook = plugin.config;
+    if (!hook) {
+        throw new Error("plugin.config is not defined");
+    }
+    const handler = typeof hook === "function" ? hook : hook.handler;
+    const config = handler.call(
+    // biome-ignore lint/suspicious/noExplicitAny: vitest harness for plugin hook
+    {}, { root }, { command: "build", mode: "production" });
+    const renderBuiltUrl = config.experimental?.renderBuiltUrl;
+    if (!renderBuiltUrl) {
+        throw new Error("experimental.renderBuiltUrl is not defined");
+    }
+    return renderBuiltUrl;
+}
+describe("skybridge plugin renderBuiltUrl", () => {
+    let root;
+    beforeEach(() => {
+        root = mkdtempSync(join(tmpdir(), "skybridge-plugin-"));
+        mkdirSync(join(root, "views"), { recursive: true });
+    });
+    afterEach(() => {
+        rmSync(root, { recursive: true, force: true });
+    });
+    // Assets referenced from JS can't use `import.meta.url`: views render in a
+    // host sandbox iframe (web-sandbox.oaiusercontent.com), so the module origin
+    // doesn't point back at the Skybridge server. They have to be resolved at
+    // runtime against `window.skybridge.serverUrl` instead.
+    it("resolves JS asset references against window.skybridge.serverUrl", () => {
+        const renderBuiltUrl = getRenderBuiltUrl(root);
+        expect(renderBuiltUrl("assets/logo-BXtQ8kd2.png", {
+            hostId: "assets/view-CwF9pQ1a.js",
+            hostType: "js",
+            type: "asset",
+            ssr: false,
+        })).toEqual({
+            runtime: `window.skybridge.serverUrl + "/assets/assets/logo-BXtQ8kd2.png"`,
+        });
+    });
+    // Reproducer for the CSS build failure: Vite has nowhere to evaluate a
+    // runtime expression inside a stylesheet, so `{ runtime }` makes
+    // `vite:css-post` throw for any `url()` in CSS. It isn't needed either — the
+    // stylesheet is served from `${serverUrl}/assets/…`, and a relative `url()`
+    // resolves against the stylesheet's own URL, tunnel origin included.
+    it("resolves CSS asset references relatively", () => {
+        const renderBuiltUrl = getRenderBuiltUrl(root);
+        expect(renderBuiltUrl("assets/demo-0IQFxQqs.woff2", {
+            hostId: "assets/style-DmQ2xY7b.css",
+            hostType: "css",
+            type: "asset",
+            ssr: false,
+        })).toEqual({ relative: true });
+    });
+});
+//# sourceMappingURL=plugin.test.js.map

package/dist/web/plugin/plugin.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.js","sourceRoot":"","sources":["../../../src/web/plugin/plugin.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, mkdtempSync, rmSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { UserConfig } from \"vite\";\nimport { afterEach, beforeEach, describe, expect, it } from \"vitest\";\nimport { skybridge } from \"./plugin.js\";\n\ntype RenderBuiltUrl = NonNullable<\n  NonNullable<UserConfig[\"experimental\"]>[\"renderBuiltUrl\"]\n>;\n\nfunction getRenderBuiltUrl(root: string): RenderBuiltUrl {\n  const plugin = skybridge({ viewsDir: join(root, \"views\") });\n  const hook = plugin.config;\n  if (!hook) {\n    throw new Error(\"plugin.config is not defined\");\n  }\n  const handler = typeof hook === \"function\" ? hook : hook.handler;\n  const config = handler.call(\n    // biome-ignore lint/suspicious/noExplicitAny: vitest harness for plugin hook\n    {} as any,\n    { root },\n    { command: \"build\", mode: \"production\" },\n  ) as UserConfig;\n\n  const renderBuiltUrl = config.experimental?.renderBuiltUrl;\n  if (!renderBuiltUrl) {\n    throw new Error(\"experimental.renderBuiltUrl is not defined\");\n  }\n  return renderBuiltUrl;\n}\n\ndescribe(\"skybridge plugin renderBuiltUrl\", () => {\n  let root: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-plugin-\"));\n    mkdirSync(join(root, \"views\"), { recursive: true });\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  // Assets referenced from JS can't use `import.meta.url`: views render in a\n  // host sandbox iframe (web-sandbox.oaiusercontent.com), so the module origin\n  // doesn't point back at the Skybridge server. They have to be resolved at\n  // runtime against `window.skybridge.serverUrl` instead.\n  it(\"resolves JS asset references against window.skybridge.serverUrl\", () => {\n    const renderBuiltUrl = getRenderBuiltUrl(root);\n\n    expect(\n      renderBuiltUrl(\"assets/logo-BXtQ8kd2.png\", {\n        hostId: \"assets/view-CwF9pQ1a.js\",\n        hostType: \"js\",\n        type: \"asset\",\n        ssr: false,\n      }),\n    ).toEqual({\n      runtime: `window.skybridge.serverUrl + \"/assets/assets/logo-BXtQ8kd2.png\"`,\n    });\n  });\n\n  // Reproducer for the CSS build failure: Vite has nowhere to evaluate a\n  // runtime expression inside a stylesheet, so `{ runtime }` makes\n  // `vite:css-post` throw for any `url()` in CSS. It isn't needed either — the\n  // stylesheet is served from `${serverUrl}/assets/…`, and a relative `url()`\n  // resolves against the stylesheet's own URL, tunnel origin included.\n  it(\"resolves CSS asset references relatively\", () => {\n    const renderBuiltUrl = getRenderBuiltUrl(root);\n\n    expect(\n      renderBuiltUrl(\"assets/demo-0IQFxQqs.woff2\", {\n        hostId: \"assets/style-DmQ2xY7b.css\",\n        hostType: \"css\",\n        type: \"asset\",\n        ssr: false,\n      }),\n    ).toEqual({ relative: true });\n  });\n});\n"]}

package/dist/web/plugin/scan-views.d.ts

@@ -0,0 +1,16 @@
+export interface DiscoveredView {
+    name: string;
+    filePath: string;
+}
+export interface InvalidView {
+    filePath: string;
+}
+export declare function scanViewsSync(viewsDir: string): {
+    valid: DiscoveredView[];
+    invalid: InvalidView[];
+};
+export declare function assertUniqueViewNames(views: DiscoveredView[]): void;
+export declare function discoverViewsSync(viewsDir: string): DiscoveredView[];
+export declare function generateViewsDts(views: DiscoveredView[]): string;
+export declare function writeViewsDts(projectRoot: string, views: DiscoveredView[]): void;
+export declare function scanAndWriteViewsDts(projectRoot?: string, viewsDir?: string): void;

package/dist/web/plugin/scan-views.js

@@ -0,0 +1,88 @@
+import { globSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, parse, resolve } from "node:path";
+import { hasDefaultExport } from "./validate-view.js";
+export function scanViewsSync(viewsDir) {
+    const flatPattern = resolve(viewsDir, "*.{tsx,jsx}");
+    const dirPattern = resolve(viewsDir, "*/index.{tsx,jsx}");
+    const flatFiles = globSync(flatPattern).map((file) => ({
+        name: parse(file).name,
+        filePath: file,
+    }));
+    const dirFiles = globSync(dirPattern).map((file) => ({
+        name: basename(dirname(file)),
+        filePath: file,
+    }));
+    // A barrel file like `views/foo/index.tsx` (no default export) must not
+    // falsely collide with a sibling `views/foo.tsx`. Drop top-level `index`
+    // before splitting valid vs invalid.
+    const candidates = [...flatFiles, ...dirFiles].filter((v) => v.name !== "index");
+    const valid = [];
+    const invalid = [];
+    for (const candidate of candidates) {
+        const code = readFileSync(candidate.filePath, "utf-8");
+        if (hasDefaultExport(code, candidate.filePath)) {
+            valid.push(candidate);
+        }
+        else {
+            invalid.push({
+                filePath: candidate.filePath,
+            });
+        }
+    }
+    return { valid, invalid };
+}
+export function assertUniqueViewNames(views) {
+    const nameMap = new Map();
+    for (const view of views) {
+        const paths = nameMap.get(view.name) ?? [];
+        paths.push(view.filePath);
+        nameMap.set(view.name, paths);
+    }
+    for (const [name, paths] of nameMap) {
+        if (paths.length > 1) {
+            throw new Error(`skybridge: duplicate view name "${name}" resolved from:\n  - ${paths.join("\n  - ")}\nRename one of the files to avoid the conflict.`);
+        }
+    }
+}
+export function discoverViewsSync(viewsDir) {
+    const { valid } = scanViewsSync(viewsDir);
+    assertUniqueViewNames(valid);
+    return valid;
+}
+export function generateViewsDts(views) {
+    const entries = views.map((v) => `    "${v.name}": true;`).join("\n");
+    return [
+        "export {};",
+        "",
+        'declare module "skybridge/server" {',
+        "  interface ViewNameRegistry {",
+        entries,
+        "  }",
+        "}",
+        "",
+    ].join("\n");
+}
+export function writeViewsDts(projectRoot, views) {
+    const dir = join(projectRoot, ".skybridge");
+    mkdirSync(dir, { recursive: true });
+    const filePath = join(dir, "views.d.ts");
+    const content = generateViewsDts(views);
+    try {
+        const existing = readFileSync(filePath, "utf-8");
+        if (existing === content) {
+            return;
+        }
+    }
+    catch {
+        // File doesn't exist yet
+    }
+    writeFileSync(filePath, content, "utf-8");
+}
+export function scanAndWriteViewsDts(projectRoot, viewsDir) {
+    const root = projectRoot ?? process.cwd();
+    const rawDir = viewsDir ?? "src/views";
+    const resolvedDir = isAbsolute(rawDir) ? rawDir : resolve(root, rawDir);
+    const views = discoverViewsSync(resolvedDir);
+    writeViewsDts(root, views);
+}
+//# sourceMappingURL=scan-views.js.map

package/dist/web/plugin/scan-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-views.js","sourceRoot":"","sources":["../../../src/web/plugin/scan-views.ts"],"names":[],"mappings":"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","sourcesContent":["import { globSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { basename, dirname, isAbsolute, join, parse, resolve } from \"node:path\";\nimport { hasDefaultExport } from \"./validate-view.js\";\n\nexport interface DiscoveredView {\n  name: string;\n  filePath: string;\n}\n\nexport interface InvalidView {\n  filePath: string;\n}\n\nexport function scanViewsSync(viewsDir: string): {\n  valid: DiscoveredView[];\n  invalid: InvalidView[];\n} {\n  const flatPattern = resolve(viewsDir, \"*.{tsx,jsx}\");\n  const dirPattern = resolve(viewsDir, \"*/index.{tsx,jsx}\");\n\n  const flatFiles = globSync(flatPattern).map((file) => ({\n    name: parse(file).name,\n    filePath: file,\n  }));\n\n  const dirFiles = globSync(dirPattern).map((file) => ({\n    name: basename(dirname(file)),\n    filePath: file,\n  }));\n\n  // A barrel file like `views/foo/index.tsx` (no default export) must not\n  // falsely collide with a sibling `views/foo.tsx`. Drop top-level `index`\n  // before splitting valid vs invalid.\n  const candidates = [...flatFiles, ...dirFiles].filter(\n    (v) => v.name !== \"index\",\n  );\n\n  const valid: DiscoveredView[] = [];\n  const invalid: InvalidView[] = [];\n  for (const candidate of candidates) {\n    const code = readFileSync(candidate.filePath, \"utf-8\");\n    if (hasDefaultExport(code, candidate.filePath)) {\n      valid.push(candidate);\n    } else {\n      invalid.push({\n        filePath: candidate.filePath,\n      });\n    }\n  }\n\n  return { valid, invalid };\n}\n\nexport function assertUniqueViewNames(views: DiscoveredView[]): void {\n  const nameMap = new Map<string, string[]>();\n  for (const view of views) {\n    const paths = nameMap.get(view.name) ?? [];\n    paths.push(view.filePath);\n    nameMap.set(view.name, paths);\n  }\n\n  for (const [name, paths] of nameMap) {\n    if (paths.length > 1) {\n      throw new Error(\n        `skybridge: duplicate view name \"${name}\" resolved from:\\n  - ${paths.join(\"\\n  - \")}\\nRename one of the files to avoid the conflict.`,\n      );\n    }\n  }\n}\n\nexport function discoverViewsSync(viewsDir: string): DiscoveredView[] {\n  const { valid } = scanViewsSync(viewsDir);\n  assertUniqueViewNames(valid);\n  return valid;\n}\n\nexport function generateViewsDts(views: DiscoveredView[]): string {\n  const entries = views.map((v) => `    \"${v.name}\": true;`).join(\"\\n\");\n  return [\n    \"export {};\",\n    \"\",\n    'declare module \"skybridge/server\" {',\n    \"  interface ViewNameRegistry {\",\n    entries,\n    \"  }\",\n    \"}\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nexport function writeViewsDts(\n  projectRoot: string,\n  views: DiscoveredView[],\n): void {\n  const dir = join(projectRoot, \".skybridge\");\n  mkdirSync(dir, { recursive: true });\n\n  const filePath = join(dir, \"views.d.ts\");\n  const content = generateViewsDts(views);\n\n  try {\n    const existing = readFileSync(filePath, \"utf-8\");\n    if (existing === content) {\n      return;\n    }\n  } catch {\n    // File doesn't exist yet\n  }\n\n  writeFileSync(filePath, content, \"utf-8\");\n}\n\nexport function scanAndWriteViewsDts(\n  projectRoot?: string,\n  viewsDir?: string,\n): void {\n  const root = projectRoot ?? process.cwd();\n  const rawDir = viewsDir ?? \"src/views\";\n  const resolvedDir = isAbsolute(rawDir) ? rawDir : resolve(root, rawDir);\n\n  const views = discoverViewsSync(resolvedDir);\n  writeViewsDts(root, views);\n}\n"]}

package/dist/web/plugin/scan-views.test.d.ts

@@ -0,0 +1 @@
+export {};