skybridge 0.0.0-dev.ed8e93c → 0.0.0-dev.ed994f4

package/dist/web/hooks/use-view-state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-view-state.test.js","sourceRoot":"","sources":["../../../src/web/hooks/use-view-state.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { act, renderHook, waitFor } from \"@testing-library/react\";\nimport {\n  afterEach,\n  beforeEach,\n  describe,\n  expect,\n  it,\n  type Mock,\n  vi,\n} from \"vitest\";\nimport { McpAppAdaptor, McpAppBridge } from \"../bridges/mcp-app/index.js\";\nimport {\n  fireToolResultNotification,\n  getMcpAppHostPostMessageMock,\n  MockResizeObserver,\n} from \"./test/utils.js\";\nimport { useViewState } from \"./use-view-state.js\";\n\ndescribe(\"useViewState\", () => {\n  let OpenaiMock: { widgetState: unknown; setWidgetState: Mock };\n\n  beforeEach(() => {\n    OpenaiMock = {\n      widgetState: null,\n      setWidgetState: vi.fn().mockResolvedValue(undefined),\n    };\n    vi.stubGlobal(\"openai\", OpenaiMock);\n    vi.stubGlobal(\"skybridge\", { hostType: \"apps-sdk\" });\n  });\n\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    vi.resetAllMocks();\n  });\n\n  const defaultState = { count: 0, name: \"test\" };\n  const windowState = { count: 5, name: \"window\" };\n\n  it(\"should initialize with default state when window.openai.widgetState is null\", () => {\n    OpenaiMock.widgetState = null;\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(defaultState);\n  });\n\n  it(\"should initialize with window.openai.widgetState when available\", () => {\n    OpenaiMock.widgetState = { modelContent: windowState };\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(windowState);\n  });\n\n  it(\"should call window.openai.setWidgetState when setViewState is called with a new state\", async () => {\n    const { result } = renderHook(() => useViewState(defaultState));\n    const newState = { count: 10, name: \"updated\" };\n\n    act(() => {\n      result.current[1](newState);\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith({\n      modelContent: newState,\n      privateContent: {},\n    });\n    expect(result.current[0]).toEqual(newState);\n  });\n\n  it(\"should call window.openai.setWidgetState when setViewState is called with a function updater\", async () => {\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    act(() => {\n      result.current[1]((prev) => ({ ...prev, count: prev.count + 1 }));\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith({\n      modelContent: { count: 1, name: \"test\" },\n      privateContent: {},\n    });\n    expect(result.current[0]).toEqual({ count: 1, name: \"test\" });\n  });\n\n  it(\"should update state when window.openai.widgetState changes\", () => {\n    OpenaiMock.widgetState = { modelContent: defaultState };\n    const { result, rerender } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(defaultState);\n\n    // Simulate window.openai.widgetState changing\n    OpenaiMock.widgetState = { modelContent: windowState };\n    // Trigger re-render to simulate the useEffect running\n    rerender();\n\n    expect(result.current[0]).toEqual(windowState);\n  });\n});\n\ndescribe(\"useViewState (mcp-app host — localStorage persistence)\", () => {\n  beforeEach(() => {\n    vi.stubGlobal(\"parent\", { postMessage: getMcpAppHostPostMessageMock() });\n    vi.stubGlobal(\"skybridge\", { hostType: \"mcp-app\" });\n    vi.stubGlobal(\"ResizeObserver\", MockResizeObserver);\n    localStorage.clear();\n  });\n\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    vi.resetAllMocks();\n    McpAppBridge.resetInstance();\n    McpAppAdaptor.resetInstance();\n    localStorage.clear();\n  });\n\n  it(\"should persist state to localStorage when viewUUID is available\", async () => {\n    const viewUUID = \"test-uuid-123\";\n    const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 3, zoom: 150 });\n    });\n\n    expect(result.current[0]).toEqual({ page: 3, zoom: 150 });\n    expect(localStorage.length).toBe(1);\n  });\n\n  it(\"should restore state from localStorage when viewUUID arrives\", async () => {\n    const viewUUID = \"test-uuid-456\";\n    // Pre-seed with the sb:{timestamp}:{viewUUID} format\n    localStorage.setItem(\n      `sb:1700000000000:${viewUUID}`,\n      JSON.stringify({ page: 5, zoom: 200 }),\n    );\n\n    const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));\n\n    act(() => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    await waitFor(() => {\n      expect(result.current[0]).toEqual({ page: 5, zoom: 200 });\n    });\n  });\n\n  it(\"should not persist when no viewUUID is available\", () => {\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    act(() => {\n      result.current[1]({ page: 2 });\n    });\n\n    expect(result.current[0]).toEqual({ page: 2 });\n    expect(localStorage.length).toBe(0);\n  });\n\n  it(\"should handle corrupted localStorage data gracefully\", async () => {\n    const viewUUID = \"test-uuid-corrupt\";\n    localStorage.setItem(`sb:1700000000000:${viewUUID}`, \"not valid json{{{\");\n\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    act(() => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    await waitFor(() => {\n      expect(result.current[0]).toEqual({ page: 1 });\n    });\n  });\n\n  it(\"should refresh localStorage timestamp on each persist (LRU)\", async () => {\n    const viewUUID = \"lru-test-uuid\";\n    const oldKey = `sb:1000000000000:${viewUUID}`;\n    localStorage.setItem(oldKey, JSON.stringify({ page: 1 }));\n\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 2 });\n    });\n\n    // Old key removed, replaced with a new one (still just 1 entry)\n    expect(localStorage.getItem(oldKey)).toBeNull();\n    expect(localStorage.length).toBe(1);\n  });\n\n  it(\"should evict oldest entries when exceeding max storage entries\", async () => {\n    // Fill localStorage with 200 entries (the max)\n    for (let i = 0; i < 200; i++) {\n      localStorage.setItem(\n        `sb:${String(1000000000000 + i)}:old-uuid-${String(i).padStart(4, \"0\")}`,\n        JSON.stringify({ i }),\n      );\n    }\n    expect(localStorage.length).toBe(200);\n\n    const viewUUID = \"eviction-test-uuid\";\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 99 });\n    });\n\n    // Should have evicted the oldest entry to stay at 200\n    expect(localStorage.length).toBe(200);\n    expect(localStorage.getItem(\"sb:1000000000000:old-uuid-0000\")).toBeNull();\n  });\n});\n"]}

package/dist/{src/web → web}/index.d.ts

@@ -1,7 +1,7 @@
+export * from "./bridges/index.js";
 export { createStore } from "./create-store.js";
 export * from "./data-llm.js";
 export { generateHelpers } from "./generate-helpers.js";
 export * from "./hooks/index.js";
-export { mountWidget } from "./mount-widget.js";
-export { skybridge } from "./plugin/plugin.js";
+export { mountView } from "./mount-view.js";
 export * from "./types.js";

package/dist/{src/web → web}/index.js

@@ -1,8 +1,8 @@
+export * from "./bridges/index.js";
 export { createStore } from "./create-store.js";
 export * from "./data-llm.js";
 export { generateHelpers } from "./generate-helpers.js";
 export * from "./hooks/index.js";
-export { mountWidget } from "./mount-widget.js";
-export { skybridge } from "./plugin/plugin.js";
+export { mountView } from "./mount-view.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./bridges/index.js\";\nexport { createStore } from \"./create-store.js\";\nexport * from \"./data-llm.js\";\nexport { generateHelpers } from \"./generate-helpers.js\";\nexport * from \"./hooks/index.js\";\nexport { mountView } from \"./mount-view.js\";\nexport * from \"./types.js\";\n"]}

package/dist/web/mount-view.d.ts

@@ -0,0 +1 @@
+export declare const mountView: (component: React.ReactNode) => void;

package/dist/{src/web/mount-widget.js → web/mount-view.js}

@@ -3,7 +3,7 @@ import { createElement, StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 import { installOpenAILoggingProxy } from "./proxy.js";
 let rootInstance = null;
-export const mountWidget = (component) => {
+export const mountView = (component) => {
     const rootElement = document.getElementById("root");
     if (!rootElement) {
         throw new Error("Root element not found");
@@ -14,6 +14,14 @@ export const mountWidget = (component) => {
     if (import.meta.env.DEV) {
         installOpenAILoggingProxy();
     }
-    rootInstance.render(createElement(StrictMode, null, component));
+    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-widget.js.map
+//# 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,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\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.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "vite";
+export interface SkybridgePluginOptions {
+    viewsDir?: string;
+}
+export declare function skybridge(options?: SkybridgePluginOptions): Plugin;

package/dist/web/plugin/plugin.js

@@ -0,0 +1,156 @@
+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))(?:\\?.*)?$`);
+}
+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.
+        api: { viewsDir: rawViewsDir },
+        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",
+                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"],
+                    exclude: ["skybridge/web"],
+                },
+                experimental: {
+                    renderBuiltUrl: (filename) => {
+                        return {
+                            runtime: `window.skybridge.serverUrl + "/assets/${filename}"`,
+                        };
+                    },
+                },
+            };
+        },
+        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\nexport interface SkybridgePluginOptions {\n  viewsDir?: 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\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.\n    api: { viewsDir: rawViewsDir },\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        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          exclude: [\"skybridge/web\"],\n        },\n        experimental: {\n          renderBuiltUrl: (filename) => {\n            return {\n              runtime: `window.skybridge.serverUrl + \"/assets/${filename}\"`,\n            };\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/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 {};

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

@@ -0,0 +1,99 @@
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { discoverViewsSync, scanAndWriteViewsDts, scanViewsSync, writeViewsDts, } from "./scan-views.js";
+const DEFAULT_EXPORT = "export default function V() { return null; }";
+describe("discoverViewsSync", () => {
+    let root;
+    let viewsDir;
+    beforeEach(() => {
+        root = mkdtempSync(join(tmpdir(), "skybridge-scan-"));
+        viewsDir = join(root, "views");
+        mkdirSync(viewsDir, { recursive: true });
+    });
+    afterEach(() => {
+        rmSync(root, { recursive: true, force: true });
+    });
+    it("picks up flat and dir-index views", () => {
+        writeFileSync(join(viewsDir, "a.tsx"), DEFAULT_EXPORT);
+        mkdirSync(join(viewsDir, "my-view"));
+        writeFileSync(join(viewsDir, "my-view/index.tsx"), DEFAULT_EXPORT);
+        expect(discoverViewsSync(viewsDir)
+            .map((v) => v.name)
+            .sort()).toEqual(["a", "my-view"]);
+    });
+    it("throws on duplicate view names (flat + dir-index collision)", () => {
+        writeFileSync(join(viewsDir, "dup.tsx"), DEFAULT_EXPORT);
+        mkdirSync(join(viewsDir, "dup"));
+        writeFileSync(join(viewsDir, "dup/index.tsx"), DEFAULT_EXPORT);
+        expect(() => discoverViewsSync(viewsDir)).toThrow(/duplicate view name "dup"/);
+    });
+});
+describe("scanViewsSync", () => {
+    let root;
+    let viewsDir;
+    beforeEach(() => {
+        root = mkdtempSync(join(tmpdir(), "skybridge-scan-views-"));
+        viewsDir = join(root, "views");
+        mkdirSync(viewsDir, { recursive: true });
+    });
+    afterEach(() => {
+        rmSync(root, { recursive: true, force: true });
+    });
+    it("returns valid and invalid views from a flat layout", () => {
+        writeFileSync(join(viewsDir, "ok.tsx"), DEFAULT_EXPORT);
+        writeFileSync(join(viewsDir, "broken.tsx"), "export const Foo = () => null;");
+        const { valid, invalid } = scanViewsSync(viewsDir);
+        expect(valid.map((v) => v.name).sort()).toEqual(["ok"]);
+        expect(invalid).toEqual([{ filePath: join(viewsDir, "broken.tsx") }]);
+    });
+    it("flags an index file in a view dir that lacks a default export", () => {
+        mkdirSync(join(viewsDir, "broken"));
+        writeFileSync(join(viewsDir, "broken/index.tsx"), "export const Foo = () => null;");
+        const { valid, invalid } = scanViewsSync(viewsDir);
+        expect(valid).toEqual([]);
+        expect(invalid).toEqual([{ filePath: join(viewsDir, "broken/index.tsx") }]);
+    });
+    it("ignores top-level index.tsx (treated as a barrel, not a view)", () => {
+        writeFileSync(join(viewsDir, "index.tsx"), "export const Foo = () => null;");
+        const { valid, invalid } = scanViewsSync(viewsDir);
+        expect(valid).toEqual([]);
+        expect(invalid).toEqual([]);
+    });
+});
+describe("writeViewsDts", () => {
+    let root;
+    beforeEach(() => {
+        root = mkdtempSync(join(tmpdir(), "skybridge-dts-"));
+    });
+    afterEach(() => {
+        rmSync(root, { recursive: true, force: true });
+    });
+    it("is a no-op when content is unchanged", () => {
+        const views = [{ name: "a", filePath: "/a.tsx" }];
+        writeViewsDts(root, views);
+        const dtsPath = join(root, ".skybridge", "views.d.ts");
+        const firstMtime = statSync(dtsPath).mtimeMs;
+        writeViewsDts(root, views);
+        expect(statSync(dtsPath).mtimeMs).toBe(firstMtime);
+    });
+});
+describe("scanAndWriteViewsDts", () => {
+    let root;
+    beforeEach(() => {
+        root = mkdtempSync(join(tmpdir(), "skybridge-scan-dts-"));
+        mkdirSync(join(root, "src/views"), { recursive: true });
+        writeFileSync(join(root, "src/views/hello.tsx"), DEFAULT_EXPORT);
+    });
+    afterEach(() => {
+        rmSync(root, { recursive: true, force: true });
+    });
+    it("writes a views.d.ts that augments skybridge/server with discovered view names", () => {
+        scanAndWriteViewsDts(root);
+        const content = readFileSync(join(root, ".skybridge/views.d.ts"), "utf-8");
+        expect(content).toContain('declare module "skybridge/server"');
+        expect(content).toContain('"hello": true;');
+    });
+});
+//# sourceMappingURL=scan-views.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scan-views.test.js","sourceRoot":"","sources":["../../../src/web/plugin/scan-views.test.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  mkdirSync,\n  mkdtempSync,\n  readFileSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { afterEach, beforeEach, describe, expect, it } from \"vitest\";\nimport {\n  discoverViewsSync,\n  scanAndWriteViewsDts,\n  scanViewsSync,\n  writeViewsDts,\n} from \"./scan-views.js\";\n\nconst DEFAULT_EXPORT = \"export default function V() { return null; }\";\n\ndescribe(\"discoverViewsSync\", () => {\n  let root: string;\n  let viewsDir: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-scan-\"));\n    viewsDir = join(root, \"views\");\n    mkdirSync(viewsDir, { recursive: true });\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"picks up flat and dir-index views\", () => {\n    writeFileSync(join(viewsDir, \"a.tsx\"), DEFAULT_EXPORT);\n    mkdirSync(join(viewsDir, \"my-view\"));\n    writeFileSync(join(viewsDir, \"my-view/index.tsx\"), DEFAULT_EXPORT);\n\n    expect(\n      discoverViewsSync(viewsDir)\n        .map((v) => v.name)\n        .sort(),\n    ).toEqual([\"a\", \"my-view\"]);\n  });\n\n  it(\"throws on duplicate view names (flat + dir-index collision)\", () => {\n    writeFileSync(join(viewsDir, \"dup.tsx\"), DEFAULT_EXPORT);\n    mkdirSync(join(viewsDir, \"dup\"));\n    writeFileSync(join(viewsDir, \"dup/index.tsx\"), DEFAULT_EXPORT);\n\n    expect(() => discoverViewsSync(viewsDir)).toThrow(\n      /duplicate view name \"dup\"/,\n    );\n  });\n});\n\ndescribe(\"scanViewsSync\", () => {\n  let root: string;\n  let viewsDir: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-scan-views-\"));\n    viewsDir = join(root, \"views\");\n    mkdirSync(viewsDir, { recursive: true });\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"returns valid and invalid views from a flat layout\", () => {\n    writeFileSync(join(viewsDir, \"ok.tsx\"), DEFAULT_EXPORT);\n    writeFileSync(\n      join(viewsDir, \"broken.tsx\"),\n      \"export const Foo = () => null;\",\n    );\n\n    const { valid, invalid } = scanViewsSync(viewsDir);\n\n    expect(valid.map((v) => v.name).sort()).toEqual([\"ok\"]);\n    expect(invalid).toEqual([{ filePath: join(viewsDir, \"broken.tsx\") }]);\n  });\n\n  it(\"flags an index file in a view dir that lacks a default export\", () => {\n    mkdirSync(join(viewsDir, \"broken\"));\n    writeFileSync(\n      join(viewsDir, \"broken/index.tsx\"),\n      \"export const Foo = () => null;\",\n    );\n\n    const { valid, invalid } = scanViewsSync(viewsDir);\n\n    expect(valid).toEqual([]);\n    expect(invalid).toEqual([{ filePath: join(viewsDir, \"broken/index.tsx\") }]);\n  });\n\n  it(\"ignores top-level index.tsx (treated as a barrel, not a view)\", () => {\n    writeFileSync(\n      join(viewsDir, \"index.tsx\"),\n      \"export const Foo = () => null;\",\n    );\n\n    const { valid, invalid } = scanViewsSync(viewsDir);\n\n    expect(valid).toEqual([]);\n    expect(invalid).toEqual([]);\n  });\n});\n\ndescribe(\"writeViewsDts\", () => {\n  let root: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-dts-\"));\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"is a no-op when content is unchanged\", () => {\n    const views = [{ name: \"a\", filePath: \"/a.tsx\" }];\n    writeViewsDts(root, views);\n\n    const dtsPath = join(root, \".skybridge\", \"views.d.ts\");\n    const firstMtime = statSync(dtsPath).mtimeMs;\n\n    writeViewsDts(root, views);\n    expect(statSync(dtsPath).mtimeMs).toBe(firstMtime);\n  });\n});\n\ndescribe(\"scanAndWriteViewsDts\", () => {\n  let root: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-scan-dts-\"));\n    mkdirSync(join(root, \"src/views\"), { recursive: true });\n    writeFileSync(join(root, \"src/views/hello.tsx\"), DEFAULT_EXPORT);\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"writes a views.d.ts that augments skybridge/server with discovered view names\", () => {\n    scanAndWriteViewsDts(root);\n\n    const content = readFileSync(join(root, \".skybridge/views.d.ts\"), \"utf-8\");\n    expect(content).toContain('declare module \"skybridge/server\"');\n    expect(content).toContain('\"hello\": true;');\n  });\n});\n"]}

package/dist/{src/web → web}/plugin/transform-data-llm.js

@@ -8,10 +8,12 @@ function createBabelPlugin(t) {
                     state.hasDataLLMImport = false;
                     state.needsDataLLMImport = false;
                     for (const node of path.node.body) {
-                        if (!t.isImportDeclaration(node))
+                        if (!t.isImportDeclaration(node)) {
                             continue;
-                        if (node.source.value !== LLM_IMPORT_SOURCE)
+                        }
+                        if (node.source.value !== LLM_IMPORT_SOURCE) {
                             continue;
+                        }
                         const hasSpecifier = node.specifiers.some((s) => t.isImportSpecifier(s) &&
                             t.isIdentifier(s.imported, { name: "DataLLM" }));
                         if (hasSpecifier) {
@@ -34,8 +36,9 @@ function createBabelPlugin(t) {
                 const attributes = opening.attributes;
                 const llmAttributeIndex = attributes.findIndex((attribute) => t.isJSXAttribute(attribute) &&
                     t.isJSXIdentifier(attribute.name, { name: "data-llm" }));
-                if (llmAttributeIndex === -1)
+                if (llmAttributeIndex === -1) {
                     return;
+                }
                 const llmAttribute = attributes[llmAttributeIndex];
                 let contentExpression;
                 if (t.isStringLiteral(llmAttribute.value)) {
@@ -82,7 +85,7 @@ export const transform = async (code, id) => {
         sourceFileName: id,
     };
     const result = transformSync(code, babelOptions);
-    if (!result || !result.code) {
+    if (!result?.code) {
         return null;
     }
     return {

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform-data-llm.js","sourceRoot":"","sources":["../../../src/web/plugin/transform-data-llm.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginObj, TransformOptions, types } from \"@babel/core\";\n\nconst LLM_IMPORT_SOURCE = \"skybridge/web\";\n\ninterface State {\n  hasDataLLMImport?: boolean;\n  needsDataLLMImport?: boolean;\n}\n\nfunction createBabelPlugin(t: typeof types): PluginObj<State> {\n  return {\n    name: \"data-llm-babel\",\n\n    visitor: {\n      Program: {\n        enter(path, state) {\n          state.hasDataLLMImport = false;\n          state.needsDataLLMImport = false;\n\n          for (const node of path.node.body) {\n            if (!t.isImportDeclaration(node)) {\n              continue;\n            }\n            if (node.source.value !== LLM_IMPORT_SOURCE) {\n              continue;\n            }\n\n            const hasSpecifier = node.specifiers.some(\n              (s) =>\n                t.isImportSpecifier(s) &&\n                t.isIdentifier(s.imported, { name: \"DataLLM\" }),\n            );\n\n            if (hasSpecifier) {\n              state.hasDataLLMImport = true;\n              break;\n            }\n          }\n        },\n\n        exit(path, state) {\n          if (state.needsDataLLMImport && !state.hasDataLLMImport) {\n            const importDecl = t.importDeclaration(\n              [\n                t.importSpecifier(\n                  t.identifier(\"DataLLM\"),\n                  t.identifier(\"DataLLM\"),\n                ),\n              ],\n              t.stringLiteral(LLM_IMPORT_SOURCE),\n            );\n\n            path.node.body.unshift(importDecl);\n          }\n        },\n      },\n\n      JSXElement(path, state) {\n        const opening = path.node.openingElement;\n        const attributes = opening.attributes;\n\n        const llmAttributeIndex = attributes.findIndex(\n          (attribute) =>\n            t.isJSXAttribute(attribute) &&\n            t.isJSXIdentifier(attribute.name, { name: \"data-llm\" }),\n        );\n\n        if (llmAttributeIndex === -1) {\n          return;\n        }\n\n        const llmAttribute = attributes[\n          llmAttributeIndex\n        ] as types.JSXAttribute;\n\n        let contentExpression: types.Expression;\n\n        if (t.isStringLiteral(llmAttribute.value)) {\n          contentExpression = llmAttribute.value;\n        } else if (t.isJSXExpressionContainer(llmAttribute.value)) {\n          contentExpression = llmAttribute.value.expression as types.Expression;\n        } else {\n          return;\n        }\n\n        const contentAttr = t.jsxAttribute(\n          t.jsxIdentifier(\"content\"),\n          t.isStringLiteral(contentExpression)\n            ? contentExpression\n            : t.jsxExpressionContainer(contentExpression),\n        );\n\n        const filteredAttributes = attributes.filter(\n          (_, index) => index !== llmAttributeIndex,\n        );\n        const newOpening = t.jsxOpeningElement(\n          opening.name,\n          filteredAttributes,\n          opening.selfClosing,\n        );\n\n        const elementWithoutLlm = t.jsxElement(\n          newOpening,\n          path.node.closingElement,\n          path.node.children,\n          path.node.selfClosing,\n        );\n\n        const llmOpening = t.jsxOpeningElement(t.jsxIdentifier(\"DataLLM\"), [\n          contentAttr,\n        ]);\n        const llmClosing = t.jsxClosingElement(t.jsxIdentifier(\"DataLLM\"));\n\n        const wrapped = t.jsxElement(\n          llmOpening,\n          llmClosing,\n          [elementWithoutLlm],\n          false,\n        );\n\n        state.needsDataLLMImport = true;\n        path.replaceWith(wrapped);\n      },\n    },\n  };\n}\n\nexport const transform = async (code: string, id: string) => {\n  if (!/\\.(jsx|tsx)$/.test(id)) {\n    return null;\n  }\n\n  if (id.includes(\"node_modules\")) {\n    return null;\n  }\n\n  // Dynamic import to ensure @babel/core is only loaded in Node.js context\n  const { types: t, transformSync } = await import(\"@babel/core\");\n\n  const babelOptions: TransformOptions = {\n    plugins: [createBabelPlugin(t)],\n    parserOpts: {\n      plugins: [\"jsx\", \"typescript\"],\n    },\n    filename: id,\n    sourceFileName: id,\n  };\n\n  const result = transformSync(code, babelOptions);\n\n  if (!result?.code) {\n    return null;\n  }\n\n  return {\n    code: result.code,\n    map: result.map || null,\n  };\n};\n"]}

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

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