skybridge 0.0.0-dev.fd6e4e8 → 0.0.0-dev.fd767e9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (309) hide show
  1. package/README.md +123 -124
  2. package/dist/cli/build-helpers.d.ts +7 -0
  3. package/dist/cli/build-helpers.js +82 -0
  4. package/dist/cli/build-helpers.js.map +1 -0
  5. package/dist/cli/build-helpers.test.js +64 -0
  6. package/dist/cli/build-helpers.test.js.map +1 -0
  7. package/dist/cli/detect-port.d.ts +2 -2
  8. package/dist/cli/detect-port.js +9 -20
  9. package/dist/cli/detect-port.js.map +1 -1
  10. package/dist/cli/header.js.map +1 -1
  11. package/dist/cli/resolve-views-dir.d.ts +1 -0
  12. package/dist/cli/resolve-views-dir.js +17 -0
  13. package/dist/cli/resolve-views-dir.js.map +1 -0
  14. package/dist/cli/run-command.js.map +1 -1
  15. package/dist/cli/telemetry.js.map +1 -1
  16. package/dist/cli/tunnel-control-server.d.ts +9 -0
  17. package/dist/cli/tunnel-control-server.js +31 -0
  18. package/dist/cli/tunnel-control-server.js.map +1 -0
  19. package/dist/cli/tunnel-control-server.test.js +39 -0
  20. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  21. package/dist/cli/tunnel-handler.d.ts +3 -0
  22. package/dist/cli/tunnel-handler.js +48 -0
  23. package/dist/cli/tunnel-handler.js.map +1 -0
  24. package/dist/cli/tunnel-handler.test.js +105 -0
  25. package/dist/cli/tunnel-handler.test.js.map +1 -0
  26. package/dist/cli/tunnel.d.ts +57 -0
  27. package/dist/cli/tunnel.js +154 -0
  28. package/dist/cli/tunnel.js.map +1 -0
  29. package/dist/cli/tunnel.test.js +190 -0
  30. package/dist/cli/tunnel.test.js.map +1 -0
  31. package/dist/cli/types.js.map +1 -1
  32. package/dist/cli/use-execute-steps.js.map +1 -1
  33. package/dist/cli/use-messages.js.map +1 -1
  34. package/dist/cli/use-nodemon.js +11 -2
  35. package/dist/cli/use-nodemon.js.map +1 -1
  36. package/dist/cli/use-open-browser.d.ts +1 -0
  37. package/dist/cli/use-open-browser.js +44 -0
  38. package/dist/cli/use-open-browser.js.map +1 -0
  39. package/dist/cli/use-open-tunnel-browser.d.ts +6 -0
  40. package/dist/cli/use-open-tunnel-browser.js +19 -0
  41. package/dist/cli/use-open-tunnel-browser.js.map +1 -0
  42. package/dist/cli/use-tunnel.d.ts +1 -1
  43. package/dist/cli/use-tunnel.js +102 -68
  44. package/dist/cli/use-tunnel.js.map +1 -1
  45. package/dist/cli/use-typescript-check.d.ts +1 -0
  46. package/dist/cli/use-typescript-check.js +42 -7
  47. package/dist/cli/use-typescript-check.js.map +1 -1
  48. package/dist/commands/build.d.ts +0 -1
  49. package/dist/commands/build.js +51 -8
  50. package/dist/commands/build.js.map +1 -1
  51. package/dist/commands/create.d.ts +9 -0
  52. package/dist/commands/create.js +30 -0
  53. package/dist/commands/create.js.map +1 -0
  54. package/dist/commands/dev.d.ts +1 -0
  55. package/dist/commands/dev.js +51 -2
  56. package/dist/commands/dev.js.map +1 -1
  57. package/dist/commands/start.js +7 -1
  58. package/dist/commands/start.js.map +1 -1
  59. package/dist/commands/telemetry/disable.js.map +1 -1
  60. package/dist/commands/telemetry/enable.js.map +1 -1
  61. package/dist/commands/telemetry/status.js.map +1 -1
  62. package/dist/server/asset-base-url-transform-plugin.d.ts +1 -0
  63. package/dist/server/asset-base-url-transform-plugin.js +17 -2
  64. package/dist/server/asset-base-url-transform-plugin.js.map +1 -1
  65. package/dist/server/asset-base-url-transform-plugin.test.js +80 -1
  66. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -1
  67. package/dist/server/auth.d.ts +20 -0
  68. package/dist/server/auth.js +28 -0
  69. package/dist/server/auth.js.map +1 -0
  70. package/dist/server/build-manifest.test.d.ts +1 -0
  71. package/dist/server/build-manifest.test.js +27 -0
  72. package/dist/server/build-manifest.test.js.map +1 -0
  73. package/dist/server/content-helpers.d.ts +40 -0
  74. package/dist/server/content-helpers.js +33 -0
  75. package/dist/server/content-helpers.js.map +1 -1
  76. package/dist/server/content-helpers.test.js +1 -1
  77. package/dist/server/content-helpers.test.js.map +1 -1
  78. package/dist/server/express.d.ts +1 -5
  79. package/dist/server/express.js +34 -10
  80. package/dist/server/express.js.map +1 -1
  81. package/dist/server/express.test.js +279 -71
  82. package/dist/server/express.test.js.map +1 -1
  83. package/dist/server/file-ref.d.ts +28 -0
  84. package/dist/server/file-ref.js +27 -0
  85. package/dist/server/file-ref.js.map +1 -0
  86. package/dist/server/index.d.ts +5 -3
  87. package/dist/server/index.js +4 -2
  88. package/dist/server/index.js.map +1 -1
  89. package/dist/server/inferUtilityTypes.d.ts +6 -6
  90. package/dist/server/inferUtilityTypes.js.map +1 -1
  91. package/dist/server/metric.js.map +1 -1
  92. package/dist/server/middleware.d.ts +16 -3
  93. package/dist/server/middleware.js.map +1 -1
  94. package/dist/server/middleware.test-d.js.map +1 -1
  95. package/dist/server/middleware.test.js.map +1 -1
  96. package/dist/server/server.d.ts +248 -41
  97. package/dist/server/server.js +327 -114
  98. package/dist/server/server.js.map +1 -1
  99. package/dist/server/templateHelper.d.ts +5 -7
  100. package/dist/server/templateHelper.js +3 -22
  101. package/dist/server/templateHelper.js.map +1 -1
  102. package/dist/server/templates.generated.d.ts +4 -0
  103. package/dist/server/templates.generated.js +47 -0
  104. package/dist/server/templates.generated.js.map +1 -0
  105. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  106. package/dist/server/tunnel-proxy-router.js +110 -0
  107. package/dist/server/tunnel-proxy-router.js.map +1 -0
  108. package/dist/server/tunnel-proxy-router.test.d.ts +1 -0
  109. package/dist/server/tunnel-proxy-router.test.js +229 -0
  110. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  111. package/dist/server/viewsDevServer.d.ts +14 -0
  112. package/dist/server/{widgetsDevServer.js → viewsDevServer.js} +6 -6
  113. package/dist/server/viewsDevServer.js.map +1 -0
  114. package/dist/test/utils.d.ts +7 -7
  115. package/dist/test/utils.js +21 -21
  116. package/dist/test/utils.js.map +1 -1
  117. package/dist/test/view.test.d.ts +1 -0
  118. package/dist/test/{widget.test.js → view.test.js} +173 -59
  119. package/dist/test/view.test.js.map +1 -0
  120. package/dist/version.js +1 -3
  121. package/dist/version.js.map +1 -1
  122. package/dist/web/bridges/apps-sdk/adaptor.d.ts +8 -3
  123. package/dist/web/bridges/apps-sdk/adaptor.js +35 -5
  124. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -1
  125. package/dist/web/bridges/apps-sdk/bridge.d.ts +1 -0
  126. package/dist/web/bridges/apps-sdk/bridge.js +1 -0
  127. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -1
  128. package/dist/web/bridges/apps-sdk/index.js.map +1 -1
  129. package/dist/web/bridges/apps-sdk/types.d.ts +8 -1
  130. package/dist/web/bridges/apps-sdk/types.js.map +1 -1
  131. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +11 -0
  132. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js +11 -0
  133. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -1
  134. package/dist/web/bridges/get-adaptor.d.ts +7 -0
  135. package/dist/web/bridges/get-adaptor.js +7 -0
  136. package/dist/web/bridges/get-adaptor.js.map +1 -1
  137. package/dist/web/bridges/index.js.map +1 -1
  138. package/dist/web/bridges/mcp-app/adaptor.d.ts +12 -7
  139. package/dist/web/bridges/mcp-app/adaptor.js +45 -30
  140. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -1
  141. package/dist/web/bridges/mcp-app/bridge.d.ts +4 -2
  142. package/dist/web/bridges/mcp-app/bridge.js +23 -1
  143. package/dist/web/bridges/mcp-app/bridge.js.map +1 -1
  144. package/dist/web/bridges/mcp-app/index.js.map +1 -1
  145. package/dist/web/bridges/mcp-app/types.js.map +1 -1
  146. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +12 -0
  147. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +12 -0
  148. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -1
  149. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -1
  150. package/dist/web/bridges/mcp-app/view-tools.test.d.ts +1 -0
  151. package/dist/web/bridges/mcp-app/view-tools.test.js +144 -0
  152. package/dist/web/bridges/mcp-app/view-tools.test.js.map +1 -0
  153. package/dist/web/bridges/types.d.ts +105 -10
  154. package/dist/web/bridges/types.js.map +1 -1
  155. package/dist/web/bridges/use-host-context.d.ts +5 -0
  156. package/dist/web/bridges/use-host-context.js +5 -0
  157. package/dist/web/bridges/use-host-context.js.map +1 -1
  158. package/dist/web/components/modal-provider.js +1 -1
  159. package/dist/web/components/modal-provider.js.map +1 -1
  160. package/dist/web/create-store.d.ts +26 -0
  161. package/dist/web/create-store.js +35 -9
  162. package/dist/web/create-store.js.map +1 -1
  163. package/dist/web/create-store.test.js +14 -16
  164. package/dist/web/create-store.test.js.map +1 -1
  165. package/dist/web/data-llm.d.ts +34 -1
  166. package/dist/web/data-llm.js +31 -3
  167. package/dist/web/data-llm.js.map +1 -1
  168. package/dist/web/data-llm.test.js +22 -22
  169. package/dist/web/data-llm.test.js.map +1 -1
  170. package/dist/web/generate-helpers.d.ts +16 -14
  171. package/dist/web/generate-helpers.js +16 -14
  172. package/dist/web/generate-helpers.js.map +1 -1
  173. package/dist/web/generate-helpers.test-d.js +30 -28
  174. package/dist/web/generate-helpers.test-d.js.map +1 -1
  175. package/dist/web/generate-helpers.test.js.map +1 -1
  176. package/dist/web/helpers/state.d.ts +2 -2
  177. package/dist/web/helpers/state.js +11 -11
  178. package/dist/web/helpers/state.js.map +1 -1
  179. package/dist/web/helpers/state.test.js +9 -9
  180. package/dist/web/helpers/state.test.js.map +1 -1
  181. package/dist/web/hooks/index.d.ts +5 -1
  182. package/dist/web/hooks/index.js +5 -1
  183. package/dist/web/hooks/index.js.map +1 -1
  184. package/dist/web/hooks/test/utils.d.ts +6 -2
  185. package/dist/web/hooks/test/utils.js +13 -2
  186. package/dist/web/hooks/test/utils.js.map +1 -1
  187. package/dist/web/hooks/use-call-tool.d.ts +45 -0
  188. package/dist/web/hooks/use-call-tool.js +28 -0
  189. package/dist/web/hooks/use-call-tool.js.map +1 -1
  190. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -1
  191. package/dist/web/hooks/use-call-tool.test.js +27 -6
  192. package/dist/web/hooks/use-call-tool.test.js.map +1 -1
  193. package/dist/web/hooks/use-display-mode.d.ts +20 -0
  194. package/dist/web/hooks/use-display-mode.js +20 -0
  195. package/dist/web/hooks/use-display-mode.js.map +1 -1
  196. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -1
  197. package/dist/web/hooks/use-display-mode.test.js.map +1 -1
  198. package/dist/web/hooks/use-download.d.ts +5 -0
  199. package/dist/web/hooks/use-download.js +8 -0
  200. package/dist/web/hooks/use-download.js.map +1 -0
  201. package/dist/web/hooks/use-download.test.d.ts +1 -0
  202. package/dist/web/hooks/use-download.test.js +95 -0
  203. package/dist/web/hooks/use-download.test.js.map +1 -0
  204. package/dist/web/hooks/use-files.d.ts +32 -0
  205. package/dist/web/hooks/use-files.js +32 -0
  206. package/dist/web/hooks/use-files.js.map +1 -1
  207. package/dist/web/hooks/use-files.test.js.map +1 -1
  208. package/dist/web/hooks/use-layout.d.ts +2 -0
  209. package/dist/web/hooks/use-layout.js +2 -0
  210. package/dist/web/hooks/use-layout.js.map +1 -1
  211. package/dist/web/hooks/use-layout.test.js.map +1 -1
  212. package/dist/web/hooks/use-open-external.d.ts +17 -0
  213. package/dist/web/hooks/use-open-external.js +16 -0
  214. package/dist/web/hooks/use-open-external.js.map +1 -1
  215. package/dist/web/hooks/use-open-external.test.js.map +1 -1
  216. package/dist/web/hooks/use-register-view-tool.d.ts +38 -0
  217. package/dist/web/hooks/use-register-view-tool.js +50 -0
  218. package/dist/web/hooks/use-register-view-tool.js.map +1 -0
  219. package/dist/web/hooks/use-request-close.d.ts +16 -0
  220. package/dist/web/hooks/use-request-close.js +21 -0
  221. package/dist/web/hooks/use-request-close.js.map +1 -0
  222. package/dist/web/hooks/use-request-close.test.d.ts +1 -0
  223. package/dist/web/hooks/use-request-close.test.js +52 -0
  224. package/dist/web/hooks/use-request-close.test.js.map +1 -0
  225. package/dist/web/hooks/use-request-modal.d.ts +16 -1
  226. package/dist/web/hooks/use-request-modal.js +19 -4
  227. package/dist/web/hooks/use-request-modal.js.map +1 -1
  228. package/dist/web/hooks/use-request-modal.test.js +1 -1
  229. package/dist/web/hooks/use-request-modal.test.js.map +1 -1
  230. package/dist/web/hooks/use-request-size.d.ts +20 -0
  231. package/dist/web/hooks/use-request-size.js +24 -0
  232. package/dist/web/hooks/use-request-size.js.map +1 -0
  233. package/dist/web/hooks/use-request-size.test.d.ts +1 -0
  234. package/dist/web/hooks/use-request-size.test.js +65 -0
  235. package/dist/web/hooks/use-request-size.test.js.map +1 -0
  236. package/dist/web/hooks/use-send-follow-up-message.d.ts +19 -1
  237. package/dist/web/hooks/use-send-follow-up-message.js +19 -2
  238. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -1
  239. package/dist/web/hooks/use-set-open-in-app-url.d.ts +17 -0
  240. package/dist/web/hooks/use-set-open-in-app-url.js +17 -0
  241. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -1
  242. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -1
  243. package/dist/web/hooks/use-tool-info.d.ts +53 -2
  244. package/dist/web/hooks/use-tool-info.js +30 -7
  245. package/dist/web/hooks/use-tool-info.js.map +1 -1
  246. package/dist/web/hooks/use-tool-info.test-d.js +11 -29
  247. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -1
  248. package/dist/web/hooks/use-tool-info.test.js +5 -5
  249. package/dist/web/hooks/use-tool-info.test.js.map +1 -1
  250. package/dist/web/hooks/use-user.d.ts +2 -0
  251. package/dist/web/hooks/use-user.js +2 -0
  252. package/dist/web/hooks/use-user.js.map +1 -1
  253. package/dist/web/hooks/use-user.test.js.map +1 -1
  254. package/dist/web/hooks/use-view-state.d.ts +25 -0
  255. package/dist/web/hooks/use-view-state.js +32 -0
  256. package/dist/web/hooks/use-view-state.js.map +1 -0
  257. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  258. package/dist/web/hooks/{use-widget-state.test.js → use-view-state.test.js} +17 -17
  259. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  260. package/dist/web/index.d.ts +1 -3
  261. package/dist/web/index.js +1 -2
  262. package/dist/web/index.js.map +1 -1
  263. package/dist/web/mount-view.d.ts +20 -0
  264. package/dist/web/{mount-widget.js → mount-view.js} +21 -2
  265. package/dist/web/mount-view.js.map +1 -0
  266. package/dist/web/plugin/data-llm.test.js.map +1 -1
  267. package/dist/web/plugin/plugin.d.ts +29 -1
  268. package/dist/web/plugin/plugin.js +113 -55
  269. package/dist/web/plugin/plugin.js.map +1 -1
  270. package/dist/web/plugin/scan-views.d.ts +16 -0
  271. package/dist/web/plugin/scan-views.js +88 -0
  272. package/dist/web/plugin/scan-views.js.map +1 -0
  273. package/dist/web/plugin/scan-views.test.d.ts +1 -0
  274. package/dist/web/plugin/scan-views.test.js +99 -0
  275. package/dist/web/plugin/scan-views.test.js.map +1 -0
  276. package/dist/web/plugin/transform-data-llm.js.map +1 -1
  277. package/dist/web/plugin/transform-data-llm.test.js.map +1 -1
  278. package/dist/web/plugin/{validate-widget.js → validate-view.js} +1 -1
  279. package/dist/web/plugin/validate-view.js.map +1 -0
  280. package/dist/web/plugin/validate-view.test.d.ts +1 -0
  281. package/dist/web/plugin/{validate-widget.test.js → validate-view.test.js} +6 -6
  282. package/dist/web/plugin/validate-view.test.js.map +1 -0
  283. package/dist/web/proxy.js.map +1 -1
  284. package/dist/web/types.d.ts +4 -0
  285. package/dist/web/types.js.map +1 -1
  286. package/package.json +20 -8
  287. package/dist/server/templates/development.hbs +0 -12
  288. package/dist/server/templates/production.hbs +0 -6
  289. package/dist/server/widgetsDevServer.d.ts +0 -14
  290. package/dist/server/widgetsDevServer.js.map +0 -1
  291. package/dist/test/widget.test.js.map +0 -1
  292. package/dist/web/hooks/use-widget-state.d.ts +0 -4
  293. package/dist/web/hooks/use-widget-state.js +0 -32
  294. package/dist/web/hooks/use-widget-state.js.map +0 -1
  295. package/dist/web/hooks/use-widget-state.test.js.map +0 -1
  296. package/dist/web/mount-widget.d.ts +0 -1
  297. package/dist/web/mount-widget.js.map +0 -1
  298. package/dist/web/plugin/scan-widgets.d.ts +0 -8
  299. package/dist/web/plugin/scan-widgets.js +0 -68
  300. package/dist/web/plugin/scan-widgets.js.map +0 -1
  301. package/dist/web/plugin/scan-widgets.test.js +0 -96
  302. package/dist/web/plugin/scan-widgets.test.js.map +0 -1
  303. package/dist/web/plugin/validate-widget.js.map +0 -1
  304. package/dist/web/plugin/validate-widget.test.js.map +0 -1
  305. /package/dist/{test/widget.test.d.ts → cli/build-helpers.test.d.ts} +0 -0
  306. /package/dist/{web/hooks/use-widget-state.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  307. /package/dist/{web/plugin/scan-widgets.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
  308. /package/dist/{web/plugin/validate-widget.test.d.ts → cli/tunnel.test.d.ts} +0 -0
  309. /package/dist/web/plugin/{validate-widget.d.ts → validate-view.d.ts} +0 -0
@@ -2,8 +2,8 @@ import { act, renderHook, waitFor } from "@testing-library/react";
2
2
  import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
3
3
  import { McpAppAdaptor, McpAppBridge } from "../bridges/mcp-app/index.js";
4
4
  import { fireToolResultNotification, getMcpAppHostPostMessageMock, MockResizeObserver, } from "./test/utils.js";
5
- import { useWidgetState } from "./use-widget-state.js";
6
- describe("useWidgetState", () => {
5
+ import { useViewState } from "./use-view-state.js";
6
+ describe("useViewState", () => {
7
7
  let OpenaiMock;
8
8
  beforeEach(() => {
9
9
  OpenaiMock = {
@@ -21,16 +21,16 @@ describe("useWidgetState", () => {
21
21
  const windowState = { count: 5, name: "window" };
22
22
  it("should initialize with default state when window.openai.widgetState is null", () => {
23
23
  OpenaiMock.widgetState = null;
24
- const { result } = renderHook(() => useWidgetState(defaultState));
24
+ const { result } = renderHook(() => useViewState(defaultState));
25
25
  expect(result.current[0]).toEqual(defaultState);
26
26
  });
27
27
  it("should initialize with window.openai.widgetState when available", () => {
28
28
  OpenaiMock.widgetState = { modelContent: windowState };
29
- const { result } = renderHook(() => useWidgetState(defaultState));
29
+ const { result } = renderHook(() => useViewState(defaultState));
30
30
  expect(result.current[0]).toEqual(windowState);
31
31
  });
32
- it("should call window.openai.setWidgetState when setWidgetState is called with a new state", async () => {
33
- const { result } = renderHook(() => useWidgetState(defaultState));
32
+ it("should call window.openai.setWidgetState when setViewState is called with a new state", async () => {
33
+ const { result } = renderHook(() => useViewState(defaultState));
34
34
  const newState = { count: 10, name: "updated" };
35
35
  act(() => {
36
36
  result.current[1](newState);
@@ -41,8 +41,8 @@ describe("useWidgetState", () => {
41
41
  });
42
42
  expect(result.current[0]).toEqual(newState);
43
43
  });
44
- it("should call window.openai.setWidgetState when setWidgetState is called with a function updater", async () => {
45
- const { result } = renderHook(() => useWidgetState(defaultState));
44
+ it("should call window.openai.setWidgetState when setViewState is called with a function updater", async () => {
45
+ const { result } = renderHook(() => useViewState(defaultState));
46
46
  act(() => {
47
47
  result.current[1]((prev) => ({ ...prev, count: prev.count + 1 }));
48
48
  });
@@ -54,7 +54,7 @@ describe("useWidgetState", () => {
54
54
  });
55
55
  it("should update state when window.openai.widgetState changes", () => {
56
56
  OpenaiMock.widgetState = { modelContent: defaultState };
57
- const { result, rerender } = renderHook(() => useWidgetState(defaultState));
57
+ const { result, rerender } = renderHook(() => useViewState(defaultState));
58
58
  expect(result.current[0]).toEqual(defaultState);
59
59
  // Simulate window.openai.widgetState changing
60
60
  OpenaiMock.widgetState = { modelContent: windowState };
@@ -63,7 +63,7 @@ describe("useWidgetState", () => {
63
63
  expect(result.current[0]).toEqual(windowState);
64
64
  });
65
65
  });
66
- describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
66
+ describe("useViewState (mcp-app host — localStorage persistence)", () => {
67
67
  beforeEach(() => {
68
68
  vi.stubGlobal("parent", { postMessage: getMcpAppHostPostMessageMock() });
69
69
  vi.stubGlobal("skybridge", { hostType: "mcp-app" });
@@ -79,7 +79,7 @@ describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
79
79
  });
80
80
  it("should persist state to localStorage when viewUUID is available", async () => {
81
81
  const viewUUID = "test-uuid-123";
82
- const { result } = renderHook(() => useWidgetState({ page: 1, zoom: 100 }));
82
+ const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));
83
83
  await act(async () => {
84
84
  fireToolResultNotification({
85
85
  content: [{ type: "text", text: "result" }],
@@ -97,7 +97,7 @@ describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
97
97
  const viewUUID = "test-uuid-456";
98
98
  // Pre-seed with the sb:{timestamp}:{viewUUID} format
99
99
  localStorage.setItem(`sb:1700000000000:${viewUUID}`, JSON.stringify({ page: 5, zoom: 200 }));
100
- const { result } = renderHook(() => useWidgetState({ page: 1, zoom: 100 }));
100
+ const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));
101
101
  act(() => {
102
102
  fireToolResultNotification({
103
103
  content: [{ type: "text", text: "result" }],
@@ -110,7 +110,7 @@ describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
110
110
  });
111
111
  });
112
112
  it("should not persist when no viewUUID is available", () => {
113
- const { result } = renderHook(() => useWidgetState({ page: 1 }));
113
+ const { result } = renderHook(() => useViewState({ page: 1 }));
114
114
  act(() => {
115
115
  result.current[1]({ page: 2 });
116
116
  });
@@ -120,7 +120,7 @@ describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
120
120
  it("should handle corrupted localStorage data gracefully", async () => {
121
121
  const viewUUID = "test-uuid-corrupt";
122
122
  localStorage.setItem(`sb:1700000000000:${viewUUID}`, "not valid json{{{");
123
- const { result } = renderHook(() => useWidgetState({ page: 1 }));
123
+ const { result } = renderHook(() => useViewState({ page: 1 }));
124
124
  act(() => {
125
125
  fireToolResultNotification({
126
126
  content: [{ type: "text", text: "result" }],
@@ -136,7 +136,7 @@ describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
136
136
  const viewUUID = "lru-test-uuid";
137
137
  const oldKey = `sb:1000000000000:${viewUUID}`;
138
138
  localStorage.setItem(oldKey, JSON.stringify({ page: 1 }));
139
- const { result } = renderHook(() => useWidgetState({ page: 1 }));
139
+ const { result } = renderHook(() => useViewState({ page: 1 }));
140
140
  await act(async () => {
141
141
  fireToolResultNotification({
142
142
  content: [{ type: "text", text: "result" }],
@@ -158,7 +158,7 @@ describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
158
158
  }
159
159
  expect(localStorage.length).toBe(200);
160
160
  const viewUUID = "eviction-test-uuid";
161
- const { result } = renderHook(() => useWidgetState({ page: 1 }));
161
+ const { result } = renderHook(() => useViewState({ page: 1 }));
162
162
  await act(async () => {
163
163
  fireToolResultNotification({
164
164
  content: [{ type: "text", text: "result" }],
@@ -174,4 +174,4 @@ describe("useWidgetState (mcp-app host — localStorage persistence)", () => {
174
174
  expect(localStorage.getItem("sb:1000000000000:old-uuid-0000")).toBeNull();
175
175
  });
176
176
  });
177
- //# sourceMappingURL=use-widget-state.test.js.map
177
+ //# sourceMappingURL=use-view-state.test.js.map
@@ -0,0 +1 @@
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"]}
@@ -3,7 +3,5 @@ export { createStore } from "./create-store.js";
3
3
  export * from "./data-llm.js";
4
4
  export { generateHelpers } from "./generate-helpers.js";
5
5
  export * from "./hooks/index.js";
6
- export { mountWidget } from "./mount-widget.js";
7
- export type { SkybridgePluginOptions } from "./plugin/plugin.js";
8
- export { skybridge } from "./plugin/plugin.js";
6
+ export { mountView } from "./mount-view.js";
9
7
  export * from "./types.js";
package/dist/web/index.js CHANGED
@@ -3,7 +3,6 @@ export { createStore } from "./create-store.js";
3
3
  export * from "./data-llm.js";
4
4
  export { generateHelpers } from "./generate-helpers.js";
5
5
  export * from "./hooks/index.js";
6
- export { mountWidget } from "./mount-widget.js";
7
- export { skybridge } from "./plugin/plugin.js";
6
+ export { mountView } from "./mount-view.js";
8
7
  export * from "./types.js";
9
8
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
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,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,cAAc,YAAY,CAAC"}
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"]}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Mount a view's root React component into `#root`. Each view file's entry
3
+ * point should call this exactly once.
4
+ *
5
+ * Wraps the component in `StrictMode`, applies host-specific providers
6
+ * automatically (e.g. modal support for MCP Apps), and installs the dev-mode
7
+ * logging proxy for `window.openai` calls.
8
+ *
9
+ * @param component - Your root React element (already constructed, e.g. `<App />`).
10
+ *
11
+ * @example
12
+ * ```tsx
13
+ * // src/views/search.tsx
14
+ * import { mountView } from "skybridge/web";
15
+ * import { App } from "./App";
16
+ *
17
+ * mountView(<App />);
18
+ * ```
19
+ */
20
+ export declare const mountView: (component: React.ReactNode) => void;
@@ -3,7 +3,26 @@ import { createElement, StrictMode } from "react";
3
3
  import { createRoot } from "react-dom/client";
4
4
  import { installOpenAILoggingProxy } from "./proxy.js";
5
5
  let rootInstance = null;
6
- export const mountWidget = (component) => {
6
+ /**
7
+ * Mount a view's root React component into `#root`. Each view file's entry
8
+ * point should call this exactly once.
9
+ *
10
+ * Wraps the component in `StrictMode`, applies host-specific providers
11
+ * automatically (e.g. modal support for MCP Apps), and installs the dev-mode
12
+ * logging proxy for `window.openai` calls.
13
+ *
14
+ * @param component - Your root React element (already constructed, e.g. `<App />`).
15
+ *
16
+ * @example
17
+ * ```tsx
18
+ * // src/views/search.tsx
19
+ * import { mountView } from "skybridge/web";
20
+ * import { App } from "./App";
21
+ *
22
+ * mountView(<App />);
23
+ * ```
24
+ */
25
+ export const mountView = (component) => {
7
26
  const rootElement = document.getElementById("root");
8
27
  if (!rootElement) {
9
28
  throw new Error("Root element not found");
@@ -24,4 +43,4 @@ export const mountWidget = (component) => {
24
43
  rootInstance.render(createElement(StrictMode, null, app));
25
44
  })();
26
45
  };
27
- //# sourceMappingURL=mount-widget.js.map
46
+ //# sourceMappingURL=mount-view.js.map
@@ -0,0 +1 @@
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"]}
@@ -1 +1 @@
1
- {"version":3,"file":"data-llm.test.js","sourceRoot":"","sources":["../../../src/web/plugin/data-llm.test.ts"],"names":[],"mappings":"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"}
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"]}
@@ -1,5 +1,33 @@
1
1
  import type { Plugin } from "vite";
2
+ /** Options for the {@link skybridge} Vite plugin. */
2
3
  export interface SkybridgePluginOptions {
3
- widgetsDir?: string;
4
+ /** Directory scanned for view modules. Defaults to `"src/views"`. */
5
+ viewsDir?: string;
4
6
  }
7
+ /**
8
+ * Vite plugin that wires a Skybridge project's view files into Vite.
9
+ *
10
+ * For each `.tsx` / `.jsx` file in `viewsDir` with a default export, the
11
+ * plugin:
12
+ * - exposes a virtual entry that calls {@link mountView} with the view's
13
+ * default export,
14
+ * - generates `.skybridge/views.d.ts` to augment {@link ViewNameRegistry} so
15
+ * {@link ViewName} narrows to the actual view names,
16
+ * - rewrites `<DataLLM>` JSX so the host can extract its content,
17
+ * - warns in dev if a view file is missing a default export.
18
+ *
19
+ * Add it to your `vite.config.ts` alongside `@vitejs/plugin-react`.
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * // vite.config.ts
24
+ * import { defineConfig } from "vite";
25
+ * import react from "@vitejs/plugin-react";
26
+ * import { skybridge } from "skybridge/vite";
27
+ *
28
+ * export default defineConfig({
29
+ * plugins: [react(), skybridge({ viewsDir: "src/views" })],
30
+ * });
31
+ * ```
32
+ */
5
33
  export declare function skybridge(options?: SkybridgePluginOptions): Plugin;
@@ -1,46 +1,81 @@
1
- import { isAbsolute, resolve } from "node:path";
2
- import { discoverWidgetsSync, writeWidgetsDts, } from "./scan-widgets.js";
1
+ import { isAbsolute, relative, resolve } from "node:path";
2
+ import { assertUniqueViewNames, discoverViewsSync, scanViewsSync, writeViewsDts, } from "./scan-views.js";
3
3
  import { transform as dataLlmTransform } from "./transform-data-llm.js";
4
- import { hasDefaultExport } from "./validate-widget.js";
5
- const VIRTUAL_PREFIX = "/_skybridge/widget/";
6
- const VIRTUAL_MODULE_PREFIX = "\0skybridge:widget:";
7
- function buildVirtualEntry(widgetFilePath) {
8
- const normalized = widgetFilePath.replace(/\\/g, "/");
4
+ import { hasDefaultExport } from "./validate-view.js";
5
+ const VIRTUAL_PREFIX = "/_skybridge/view/";
6
+ const VIRTUAL_MODULE_PREFIX = "\0skybridge:view:";
7
+ function buildVirtualEntry(viewFilePath) {
8
+ const normalized = viewFilePath.replace(/\\/g, "/");
9
9
  return [
10
- `import { mountWidget } from "skybridge/web";`,
10
+ `import { mountView } from "skybridge/web";`,
11
11
  `import Component from "${normalized}";`,
12
12
  `import { createElement } from "react";`,
13
- `mountWidget(createElement(Component));`,
13
+ `mountView(createElement(Component));`,
14
14
  ].join("\n");
15
15
  }
16
- function buildWidgetEntryRe(widgetsDir) {
17
- const escaped = widgetsDir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
16
+ function getViewEntryPattern(viewsDir) {
17
+ const escaped = viewsDir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
18
18
  return new RegExp(`${escaped}\\/(?:[^/]+\\.(?:jsx|tsx)|[^/]+\\/index\\.(?:tsx|jsx))(?:\\?.*)?$`);
19
19
  }
20
+ /**
21
+ * Vite plugin that wires a Skybridge project's view files into Vite.
22
+ *
23
+ * For each `.tsx` / `.jsx` file in `viewsDir` with a default export, the
24
+ * plugin:
25
+ * - exposes a virtual entry that calls {@link mountView} with the view's
26
+ * default export,
27
+ * - generates `.skybridge/views.d.ts` to augment {@link ViewNameRegistry} so
28
+ * {@link ViewName} narrows to the actual view names,
29
+ * - rewrites `<DataLLM>` JSX so the host can extract its content,
30
+ * - warns in dev if a view file is missing a default export.
31
+ *
32
+ * Add it to your `vite.config.ts` alongside `@vitejs/plugin-react`.
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * // vite.config.ts
37
+ * import { defineConfig } from "vite";
38
+ * import react from "@vitejs/plugin-react";
39
+ * import { skybridge } from "skybridge/vite";
40
+ *
41
+ * export default defineConfig({
42
+ * plugins: [react(), skybridge({ viewsDir: "src/views" })],
43
+ * });
44
+ * ```
45
+ */
20
46
  export function skybridge(options) {
21
- const rawWidgetsDir = options?.widgetsDir ?? "src/views";
22
- let resolvedWidgetsDir;
47
+ const rawViewsDir = options?.viewsDir ?? "src/views";
48
+ let resolvedViewsDir;
23
49
  let projectRoot;
24
- let widgetMap = new Map();
25
- let widgetEntryRe;
50
+ let viewMap = new Map();
51
+ let viewEntryPattern;
26
52
  return {
27
53
  name: "skybridge",
28
54
  enforce: "pre",
55
+ // Read by `skybridge build` to resolve viewsDir before `tsc -b` runs.
56
+ api: { viewsDir: rawViewsDir },
29
57
  config(config) {
30
58
  projectRoot = config.root || process.cwd();
31
- resolvedWidgetsDir = isAbsolute(rawWidgetsDir)
32
- ? rawWidgetsDir
33
- : resolve(projectRoot, rawWidgetsDir);
34
- widgetEntryRe = buildWidgetEntryRe(resolvedWidgetsDir);
35
- const widgets = discoverWidgetsSync(resolvedWidgetsDir);
36
- widgetMap = new Map(widgets.map((w) => [w.name, w]));
37
- writeWidgetsDts(projectRoot, widgets);
59
+ resolvedViewsDir = isAbsolute(rawViewsDir)
60
+ ? rawViewsDir
61
+ : resolve(projectRoot, rawViewsDir);
62
+ viewEntryPattern = getViewEntryPattern(resolvedViewsDir);
63
+ const views = discoverViewsSync(resolvedViewsDir);
64
+ viewMap = new Map(views.map((v) => [v.name, v]));
65
+ writeViewsDts(projectRoot, views);
38
66
  const input = {};
39
- for (const widget of widgets) {
40
- input[widget.name] = `${VIRTUAL_PREFIX}${widget.name}`;
67
+ for (const view of views) {
68
+ input[view.name] = `${VIRTUAL_PREFIX}${view.name}`;
41
69
  }
42
70
  return {
43
71
  base: "/assets",
72
+ // Fixes "Invalid hook call" on createStore by forcing a single
73
+ // copy of React. Under pnpm's isolated node_modules, zustand
74
+ // inside `skybridge` resolves React from skybridge's own
75
+ // dependencies while the host app loads its own copy
76
+ resolve: {
77
+ dedupe: ["react", "react-dom"],
78
+ },
44
79
  build: {
45
80
  outDir: "dist/assets",
46
81
  emptyOutDir: true,
@@ -51,26 +86,19 @@ export function skybridge(options) {
51
86
  input,
52
87
  },
53
88
  },
54
- // Pre-bundle widget deps at startup so the first tool invocation
89
+ // Pre-bundle view deps at startup so the first tool invocation
55
90
  // doesn't hit Vite's on-demand re-optimization path (which sends
56
91
  // `full-reload` over HMR — in our iframe flow the parent host
57
- // can't honour a reload, and the widget silently never mounts).
92
+ // can't honour a reload, and the view silently never mounts).
58
93
  optimizeDeps: {
59
- // Scan widget files so transitive user deps (zod, tailwind, etc.)
94
+ // Scan view files so transitive user deps (zod, tailwind, etc.)
60
95
  // get pre-bundled at startup.
61
96
  entries: [
62
- `${resolvedWidgetsDir}/*.{tsx,jsx}`,
63
- `${resolvedWidgetsDir}/*/index.{tsx,jsx}`,
64
- ],
65
- // Framework deps imported by the synthesized virtual entry.
66
- // The scanner can't see the virtual module source, so we must
67
- // list these explicitly.
68
- include: [
69
- "react",
70
- "react-dom/client",
71
- "react/jsx-runtime",
72
- "skybridge/web",
97
+ `${resolvedViewsDir}/*.{tsx,jsx}`,
98
+ `${resolvedViewsDir}/*/index.{tsx,jsx}`,
73
99
  ],
100
+ include: ["react", "react-dom/client", "react/jsx-runtime"],
101
+ exclude: ["skybridge/web"],
74
102
  },
75
103
  experimental: {
76
104
  renderBuiltUrl: (filename) => {
@@ -84,7 +112,7 @@ export function skybridge(options) {
84
112
  resolveId(id) {
85
113
  if (id.startsWith(VIRTUAL_PREFIX)) {
86
114
  const name = id.slice(VIRTUAL_PREFIX.length);
87
- if (widgetMap.has(name)) {
115
+ if (viewMap.has(name)) {
88
116
  return `${VIRTUAL_MODULE_PREFIX}${name}`;
89
117
  }
90
118
  }
@@ -93,36 +121,66 @@ export function skybridge(options) {
93
121
  load(id) {
94
122
  if (id.startsWith(VIRTUAL_MODULE_PREFIX)) {
95
123
  const name = id.slice(VIRTUAL_MODULE_PREFIX.length);
96
- const widget = widgetMap.get(name);
97
- if (widget) {
98
- return buildVirtualEntry(widget.filePath);
124
+ const view = viewMap.get(name);
125
+ if (view) {
126
+ return buildVirtualEntry(view.filePath);
99
127
  }
100
128
  }
101
129
  return null;
102
130
  },
103
131
  configureServer(server) {
104
- if (!resolvedWidgetsDir) {
132
+ if (!resolvedViewsDir) {
105
133
  const root = server.config.root || process.cwd();
106
- resolvedWidgetsDir = isAbsolute(rawWidgetsDir)
107
- ? rawWidgetsDir
108
- : resolve(root, rawWidgetsDir);
134
+ resolvedViewsDir = isAbsolute(rawViewsDir)
135
+ ? rawViewsDir
136
+ : resolve(root, rawViewsDir);
109
137
  projectRoot = root;
110
- widgetEntryRe = buildWidgetEntryRe(resolvedWidgetsDir);
138
+ viewEntryPattern = getViewEntryPattern(resolvedViewsDir);
111
139
  }
112
- server.watcher.add(resolvedWidgetsDir);
140
+ server.watcher.add(resolvedViewsDir);
141
+ // Track which view files we've already warned about so a rescan
142
+ // triggered by an unrelated edit doesn't re-emit the same warning.
143
+ let knownInvalid = new Set();
113
144
  const rescan = () => {
114
- const widgets = discoverWidgetsSync(resolvedWidgetsDir);
115
- widgetMap = new Map(widgets.map((w) => [w.name, w]));
116
- writeWidgetsDts(projectRoot, widgets);
145
+ try {
146
+ // Surface broken view files. Without this, files lacking a
147
+ // default export are silently dropped from the input and the
148
+ // user has no idea why their widget never mounts.
149
+ const { valid, invalid } = scanViewsSync(resolvedViewsDir);
150
+ const nextInvalid = new Set(invalid.map((v) => v.filePath));
151
+ for (const filePath of nextInvalid) {
152
+ if (!knownInvalid.has(filePath)) {
153
+ server.config.logger.warn(`[skybridge] view file "${relative(projectRoot, filePath)}" is missing a default export — it won't be served until fixed.`);
154
+ }
155
+ }
156
+ for (const filePath of knownInvalid) {
157
+ if (!nextInvalid.has(filePath)) {
158
+ server.config.logger.info(`[skybridge] view file "${relative(projectRoot, filePath)}" resolved.`);
159
+ }
160
+ }
161
+ knownInvalid = nextInvalid;
162
+ assertUniqueViewNames(valid);
163
+ viewMap = new Map(valid.map((v) => [v.name, v]));
164
+ writeViewsDts(projectRoot, valid);
165
+ }
166
+ catch (err) {
167
+ // assertUniqueViewNames throws on duplicate view names. Catch so
168
+ // chokidar's listener chain doesn't surface it as unhandled and
169
+ // crash the dev server — previous viewMap stays active until
170
+ // the user fixes the conflict.
171
+ const message = err instanceof Error ? err.message : String(err);
172
+ server.config.logger.error(`[skybridge] view rescan failed: ${message}`);
173
+ }
117
174
  };
175
+ // Initial scan emits warnings for broken files that exist at startup.
176
+ rescan();
118
177
  server.watcher.on("add", rescan);
178
+ server.watcher.on("change", rescan);
119
179
  server.watcher.on("unlink", rescan);
120
180
  },
121
181
  async transform(code, id) {
122
- if (widgetEntryRe?.test(id)) {
123
- if (!hasDefaultExport(code, id)) {
124
- this.warn(`Widget file "${id.split("/").pop()}" is missing a default export.`);
125
- }
182
+ if (viewEntryPattern?.test(id) && !hasDefaultExport(code, id)) {
183
+ this.warn(`View file "${id.split("/").pop()}" is missing a default export.`);
126
184
  }
127
185
  return await dataLlmTransform(code, id);
128
186
  },
@@ -1 +1 @@
1
- {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/web/plugin/plugin.ts"],"names":[],"mappings":"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"}
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\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.\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 // 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 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"]}
@@ -0,0 +1,16 @@
1
+ export interface DiscoveredView {
2
+ name: string;
3
+ filePath: string;
4
+ }
5
+ export interface InvalidView {
6
+ filePath: string;
7
+ }
8
+ export declare function scanViewsSync(viewsDir: string): {
9
+ valid: DiscoveredView[];
10
+ invalid: InvalidView[];
11
+ };
12
+ export declare function assertUniqueViewNames(views: DiscoveredView[]): void;
13
+ export declare function discoverViewsSync(viewsDir: string): DiscoveredView[];
14
+ export declare function generateViewsDts(views: DiscoveredView[]): string;
15
+ export declare function writeViewsDts(projectRoot: string, views: DiscoveredView[]): void;
16
+ export declare function scanAndWriteViewsDts(projectRoot?: string, viewsDir?: string): void;