@ulearning/ai-generative-frame 0.0.0-stage → 1.0.0-next.0

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 (323) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +233 -2
  3. package/dist/assistant-ui/entry.d.ts +34 -0
  4. package/dist/assistant-ui/entry.d.ts.map +1 -0
  5. package/dist/assistant-ui/entry.js +50 -0
  6. package/dist/assistant-ui/entry.js.map +1 -0
  7. package/dist/assistant-ui/extension.d.ts +18 -0
  8. package/dist/assistant-ui/extension.d.ts.map +1 -0
  9. package/dist/assistant-ui/extension.js +0 -0
  10. package/dist/assistant-ui/history.d.ts +15 -0
  11. package/dist/assistant-ui/history.d.ts.map +1 -0
  12. package/dist/assistant-ui/history.js +39 -0
  13. package/dist/assistant-ui/history.js.map +1 -0
  14. package/dist/assistant-ui/modelContext.d.ts +45 -0
  15. package/dist/assistant-ui/modelContext.d.ts.map +1 -0
  16. package/dist/assistant-ui/modelContext.js +88 -0
  17. package/dist/assistant-ui/modelContext.js.map +1 -0
  18. package/dist/assistant-ui/snapshotSaver.d.ts +11 -0
  19. package/dist/assistant-ui/snapshotSaver.d.ts.map +1 -0
  20. package/dist/assistant-ui/snapshotSaver.js +83 -0
  21. package/dist/assistant-ui/snapshotSaver.js.map +1 -0
  22. package/dist/assistant-ui/tool-calls.d.ts +21 -0
  23. package/dist/assistant-ui/tool-calls.d.ts.map +1 -0
  24. package/dist/assistant-ui/tool-calls.js +65 -0
  25. package/dist/assistant-ui/tool-calls.js.map +1 -0
  26. package/dist/assistant-ui/toolkit.d.ts +96 -0
  27. package/dist/assistant-ui/toolkit.d.ts.map +1 -0
  28. package/dist/assistant-ui/toolkit.js +456 -0
  29. package/dist/assistant-ui/toolkit.js.map +1 -0
  30. package/dist/assistant-ui/useSharedContext.d.ts +14 -0
  31. package/dist/assistant-ui/useSharedContext.d.ts.map +1 -0
  32. package/dist/assistant-ui/useSharedContext.js +27 -0
  33. package/dist/assistant-ui/useSharedContext.js.map +1 -0
  34. package/dist/assistant-ui.d.ts +3 -0
  35. package/dist/assistant-ui.d.ts.map +1 -0
  36. package/dist/assistant-ui.js +1 -0
  37. package/dist/bootstrap.d.ts +23 -0
  38. package/dist/bootstrap.d.ts.map +1 -0
  39. package/dist/bootstrap.js +78 -0
  40. package/dist/bootstrap.js.map +1 -0
  41. package/dist/csp.d.ts +25 -0
  42. package/dist/csp.d.ts.map +1 -0
  43. package/dist/csp.js +78 -0
  44. package/dist/csp.js.map +1 -0
  45. package/dist/index.d.ts +6 -0
  46. package/dist/index.d.ts.map +1 -0
  47. package/dist/index.js +5 -0
  48. package/dist/json-schema.d.ts +70 -0
  49. package/dist/json-schema.d.ts.map +1 -0
  50. package/dist/json-schema.js +163 -0
  51. package/dist/json-schema.js.map +1 -0
  52. package/dist/preview.d.ts +30 -0
  53. package/dist/preview.d.ts.map +1 -0
  54. package/dist/preview.js +60 -0
  55. package/dist/preview.js.map +1 -0
  56. package/dist/prompts/guidance.d.ts +41 -0
  57. package/dist/prompts/guidance.d.ts.map +1 -0
  58. package/dist/prompts/guidance.js +268 -0
  59. package/dist/prompts/guidance.js.map +1 -0
  60. package/dist/prompts.d.ts +2 -0
  61. package/dist/prompts.d.ts.map +1 -0
  62. package/dist/prompts.js +1 -0
  63. package/dist/protocol.d.ts +114 -0
  64. package/dist/protocol.d.ts.map +1 -0
  65. package/dist/protocol.js +49 -0
  66. package/dist/protocol.js.map +1 -0
  67. package/dist/repair/repair.d.ts +72 -0
  68. package/dist/repair/repair.d.ts.map +1 -0
  69. package/dist/repair/repair.js +103 -0
  70. package/dist/repair/repair.js.map +1 -0
  71. package/dist/repair.d.ts +2 -0
  72. package/dist/repair.d.ts.map +1 -0
  73. package/dist/repair.js +1 -0
  74. package/dist/rpc.d.ts +60 -0
  75. package/dist/rpc.d.ts.map +1 -0
  76. package/dist/rpc.js +127 -0
  77. package/dist/rpc.js.map +1 -0
  78. package/dist/runtime/diagnostics.d.ts +17 -0
  79. package/dist/runtime/diagnostics.d.ts.map +1 -0
  80. package/dist/runtime/diagnostics.js +128 -0
  81. package/dist/runtime/diagnostics.js.map +1 -0
  82. package/dist/runtime/generated.d.ts +2 -0
  83. package/dist/runtime/generated.d.ts.map +1 -0
  84. package/dist/runtime/generated.js +5 -0
  85. package/dist/runtime/generated.js.map +1 -0
  86. package/dist/runtime/index.d.ts +7 -0
  87. package/dist/runtime/index.d.ts.map +1 -0
  88. package/dist/runtime/index.js +264 -0
  89. package/dist/runtime/index.js.map +1 -0
  90. package/dist/runtime/morph.d.ts +51 -0
  91. package/dist/runtime/morph.d.ts.map +1 -0
  92. package/dist/runtime/morph.js +251 -0
  93. package/dist/runtime/morph.js.map +1 -0
  94. package/dist/runtime/screenshot.d.ts +23 -0
  95. package/dist/runtime/screenshot.d.ts.map +1 -0
  96. package/dist/runtime/screenshot.js +188 -0
  97. package/dist/runtime/screenshot.js.map +1 -0
  98. package/dist/runtime/size.d.ts +10 -0
  99. package/dist/runtime/size.d.ts.map +1 -0
  100. package/dist/runtime/size.js +21 -0
  101. package/dist/runtime/size.js.map +1 -0
  102. package/dist/runtime/storage.d.ts +4 -0
  103. package/dist/runtime/storage.d.ts.map +1 -0
  104. package/dist/runtime/storage.js +38 -0
  105. package/dist/runtime/storage.js.map +1 -0
  106. package/dist/spec/actions.d.ts +40 -0
  107. package/dist/spec/actions.d.ts.map +1 -0
  108. package/dist/spec/actions.js +53 -0
  109. package/dist/spec/actions.js.map +1 -0
  110. package/dist/spec/assistant-ui/thread.d.ts +66 -0
  111. package/dist/spec/assistant-ui/thread.d.ts.map +1 -0
  112. package/dist/spec/assistant-ui/thread.js +252 -0
  113. package/dist/spec/assistant-ui/thread.js.map +1 -0
  114. package/dist/spec/assistant-ui/toolkit.d.ts +33 -0
  115. package/dist/spec/assistant-ui/toolkit.d.ts.map +1 -0
  116. package/dist/spec/assistant-ui/toolkit.js +142 -0
  117. package/dist/spec/assistant-ui/toolkit.js.map +1 -0
  118. package/dist/spec/assistant-ui/web.d.ts +6 -0
  119. package/dist/spec/assistant-ui/web.d.ts.map +1 -0
  120. package/dist/spec/assistant-ui/web.js +48 -0
  121. package/dist/spec/assistant-ui/web.js.map +1 -0
  122. package/dist/spec/assistant-ui.d.ts +3 -0
  123. package/dist/spec/assistant-ui.d.ts.map +1 -0
  124. package/dist/spec/assistant-ui.js +1 -0
  125. package/dist/spec/calc.d.ts +8 -0
  126. package/dist/spec/calc.d.ts.map +1 -0
  127. package/dist/spec/calc.js +498 -0
  128. package/dist/spec/calc.js.map +1 -0
  129. package/dist/spec/catalog.d.ts +52 -0
  130. package/dist/spec/catalog.d.ts.map +1 -0
  131. package/dist/spec/catalog.js +104 -0
  132. package/dist/spec/catalog.js.map +1 -0
  133. package/dist/spec/expressions.d.ts +45 -0
  134. package/dist/spec/expressions.d.ts.map +1 -0
  135. package/dist/spec/expressions.js +199 -0
  136. package/dist/spec/expressions.js.map +1 -0
  137. package/dist/spec/patch.d.ts +20 -0
  138. package/dist/spec/patch.d.ts.map +1 -0
  139. package/dist/spec/patch.js +77 -0
  140. package/dist/spec/patch.js.map +1 -0
  141. package/dist/spec/pending.d.ts +15 -0
  142. package/dist/spec/pending.d.ts.map +1 -0
  143. package/dist/spec/pending.js +33 -0
  144. package/dist/spec/pending.js.map +1 -0
  145. package/dist/spec/pointer.d.ts +17 -0
  146. package/dist/spec/pointer.d.ts.map +1 -0
  147. package/dist/spec/pointer.js +88 -0
  148. package/dist/spec/pointer.js.map +1 -0
  149. package/dist/spec/prompt.d.ts +29 -0
  150. package/dist/spec/prompt.d.ts.map +1 -0
  151. package/dist/spec/prompt.js +145 -0
  152. package/dist/spec/prompt.js.map +1 -0
  153. package/dist/spec/render-spec.d.ts +50 -0
  154. package/dist/spec/render-spec.d.ts.map +1 -0
  155. package/dist/spec/render-spec.js +104 -0
  156. package/dist/spec/render-spec.js.map +1 -0
  157. package/dist/spec/resolve.d.ts +39 -0
  158. package/dist/spec/resolve.d.ts.map +1 -0
  159. package/dist/spec/resolve.js +51 -0
  160. package/dist/spec/resolve.js.map +1 -0
  161. package/dist/spec/resolved.d.ts +3 -0
  162. package/dist/spec/resolved.d.ts.map +1 -0
  163. package/dist/spec/resolved.js +36 -0
  164. package/dist/spec/resolved.js.map +1 -0
  165. package/dist/spec/state.d.ts +34 -0
  166. package/dist/spec/state.d.ts.map +1 -0
  167. package/dist/spec/state.js +111 -0
  168. package/dist/spec/state.js.map +1 -0
  169. package/dist/spec/stream.d.ts +50 -0
  170. package/dist/spec/stream.d.ts.map +1 -0
  171. package/dist/spec/stream.js +168 -0
  172. package/dist/spec/stream.js.map +1 -0
  173. package/dist/spec/tools.d.ts +3 -0
  174. package/dist/spec/tools.d.ts.map +1 -0
  175. package/dist/spec/tools.js +3 -0
  176. package/dist/spec/tree.d.ts +21 -0
  177. package/dist/spec/tree.d.ts.map +1 -0
  178. package/dist/spec/tree.js +27 -0
  179. package/dist/spec/tree.js.map +1 -0
  180. package/dist/spec/types.d.ts +66 -0
  181. package/dist/spec/types.d.ts.map +1 -0
  182. package/dist/spec/types.js +9 -0
  183. package/dist/spec/types.js.map +1 -0
  184. package/dist/spec/validate.d.ts +32 -0
  185. package/dist/spec/validate.d.ts.map +1 -0
  186. package/dist/spec/validate.js +264 -0
  187. package/dist/spec/validate.js.map +1 -0
  188. package/dist/spec/vue/SpecRenderer.d.ts +43 -0
  189. package/dist/spec/vue/SpecRenderer.d.ts.map +1 -0
  190. package/dist/spec/vue/SpecRenderer.js +357 -0
  191. package/dist/spec/vue/SpecRenderer.js.map +1 -0
  192. package/dist/spec/vue/useSpecStream.d.ts +19 -0
  193. package/dist/spec/vue/useSpecStream.d.ts.map +1 -0
  194. package/dist/spec/vue/useSpecStream.js +115 -0
  195. package/dist/spec/vue/useSpecStream.js.map +1 -0
  196. package/dist/spec/vue.d.ts +3 -0
  197. package/dist/spec/vue.d.ts.map +1 -0
  198. package/dist/spec/vue.js +3 -0
  199. package/dist/spec.d.ts +12 -0
  200. package/dist/spec.d.ts.map +1 -0
  201. package/dist/spec.js +8 -0
  202. package/dist/theme.d.ts +38 -0
  203. package/dist/theme.d.ts.map +1 -0
  204. package/dist/theme.js +370 -0
  205. package/dist/theme.js.map +1 -0
  206. package/dist/tools/define.d.ts +43 -0
  207. package/dist/tools/define.d.ts.map +1 -0
  208. package/dist/tools/define.js +31 -0
  209. package/dist/tools/define.js.map +1 -0
  210. package/dist/tools/edits.d.ts +19 -0
  211. package/dist/tools/edits.d.ts.map +1 -0
  212. package/dist/tools/edits.js +55 -0
  213. package/dist/tools/edits.js.map +1 -0
  214. package/dist/tools/registry.d.ts +19 -0
  215. package/dist/tools/registry.d.ts.map +1 -0
  216. package/dist/tools/registry.js +33 -0
  217. package/dist/tools/registry.js.map +1 -0
  218. package/dist/tools/tools.d.ts +88 -0
  219. package/dist/tools/tools.d.ts.map +1 -0
  220. package/dist/tools/tools.js +235 -0
  221. package/dist/tools/tools.js.map +1 -0
  222. package/dist/tools.d.ts +5 -0
  223. package/dist/tools.d.ts.map +1 -0
  224. package/dist/tools.js +5 -0
  225. package/dist/version.d.ts +2 -0
  226. package/dist/version.d.ts.map +1 -0
  227. package/dist/version.js +5 -0
  228. package/dist/version.js.map +1 -0
  229. package/dist/vue/Widget.d.ts +16 -0
  230. package/dist/vue/Widget.d.ts.map +1 -0
  231. package/dist/vue/Widget.js +58 -0
  232. package/dist/vue/Widget.js.map +1 -0
  233. package/dist/vue/sync.d.ts +19 -0
  234. package/dist/vue/sync.d.ts.map +1 -0
  235. package/dist/vue/sync.js +31 -0
  236. package/dist/vue/sync.js.map +1 -0
  237. package/dist/vue/themeStore.d.ts +23 -0
  238. package/dist/vue/themeStore.d.ts.map +1 -0
  239. package/dist/vue/themeStore.js +115 -0
  240. package/dist/vue/themeStore.js.map +1 -0
  241. package/dist/vue/useThemeTokens.d.ts +6 -0
  242. package/dist/vue/useThemeTokens.d.ts.map +1 -0
  243. package/dist/vue/useThemeTokens.js +49 -0
  244. package/dist/vue/useThemeTokens.js.map +1 -0
  245. package/dist/vue/useWidget.d.ts +10 -0
  246. package/dist/vue/useWidget.d.ts.map +1 -0
  247. package/dist/vue/useWidget.js +81 -0
  248. package/dist/vue/useWidget.js.map +1 -0
  249. package/dist/vue.d.ts +5 -0
  250. package/dist/vue.d.ts.map +1 -0
  251. package/dist/vue.js +4 -0
  252. package/dist/widget.d.ts +129 -0
  253. package/dist/widget.d.ts.map +1 -0
  254. package/dist/widget.js +655 -0
  255. package/dist/widget.js.map +1 -0
  256. package/package.json +125 -3
  257. package/src/assistant-ui/entry.ts +124 -0
  258. package/src/assistant-ui/extension.ts +19 -0
  259. package/src/assistant-ui/history.ts +63 -0
  260. package/src/assistant-ui/modelContext.ts +162 -0
  261. package/src/assistant-ui/snapshotSaver.ts +116 -0
  262. package/src/assistant-ui/tool-calls.ts +115 -0
  263. package/src/assistant-ui/toolkit.tsx +747 -0
  264. package/src/assistant-ui/useSharedContext.ts +40 -0
  265. package/src/assistant-ui.ts +14 -0
  266. package/src/bootstrap.ts +112 -0
  267. package/src/csp.ts +96 -0
  268. package/src/index.ts +44 -0
  269. package/src/json-schema.ts +353 -0
  270. package/src/preview.ts +120 -0
  271. package/src/prompts/guidance.ts +369 -0
  272. package/src/prompts.ts +8 -0
  273. package/src/protocol.ts +141 -0
  274. package/src/repair/repair.ts +202 -0
  275. package/src/repair.ts +11 -0
  276. package/src/rpc.ts +228 -0
  277. package/src/runtime/diagnostics.ts +165 -0
  278. package/src/runtime/generated.ts +2 -0
  279. package/src/runtime/index.ts +343 -0
  280. package/src/runtime/morph.ts +352 -0
  281. package/src/runtime/screenshot.ts +288 -0
  282. package/src/runtime/size.ts +17 -0
  283. package/src/runtime/storage.ts +49 -0
  284. package/src/spec/actions.ts +111 -0
  285. package/src/spec/assistant-ui/thread.ts +381 -0
  286. package/src/spec/assistant-ui/toolkit.tsx +295 -0
  287. package/src/spec/assistant-ui/web.tsx +63 -0
  288. package/src/spec/assistant-ui.ts +2 -0
  289. package/src/spec/calc.ts +598 -0
  290. package/src/spec/catalog.ts +196 -0
  291. package/src/spec/expressions.ts +301 -0
  292. package/src/spec/patch.ts +112 -0
  293. package/src/spec/pending.ts +36 -0
  294. package/src/spec/pointer.ts +170 -0
  295. package/src/spec/prompt.ts +243 -0
  296. package/src/spec/render-spec.ts +144 -0
  297. package/src/spec/resolve.ts +123 -0
  298. package/src/spec/resolved.ts +53 -0
  299. package/src/spec/state.ts +193 -0
  300. package/src/spec/stream.ts +230 -0
  301. package/src/spec/tools.ts +17 -0
  302. package/src/spec/tree.ts +37 -0
  303. package/src/spec/types.ts +51 -0
  304. package/src/spec/validate.ts +429 -0
  305. package/src/spec/vue/SpecRenderer.tsx +544 -0
  306. package/src/spec/vue/__tests__/harness.ts +50 -0
  307. package/src/spec/vue/useSpecStream.ts +162 -0
  308. package/src/spec/vue.ts +13 -0
  309. package/src/spec.ts +55 -0
  310. package/src/theme.ts +423 -0
  311. package/src/tools/define.ts +65 -0
  312. package/src/tools/edits.ts +73 -0
  313. package/src/tools/registry.ts +44 -0
  314. package/src/tools/tools.ts +361 -0
  315. package/src/tools.ts +32 -0
  316. package/src/version.ts +4 -0
  317. package/src/vue/Widget.tsx +74 -0
  318. package/src/vue/sync.ts +36 -0
  319. package/src/vue/themeStore.ts +157 -0
  320. package/src/vue/useThemeTokens.ts +71 -0
  321. package/src/vue/useWidget.ts +117 -0
  322. package/src/vue.ts +8 -0
  323. package/src/widget.ts +1080 -0
@@ -0,0 +1,357 @@
1
+ import { getAtPointer } from "../pointer.js";
2
+ import { evaluateCondition, resolveProps } from "../expressions.js";
3
+ import { createStateStore } from "../state.js";
4
+ import { childIdsOf, repeatItems, safePointer } from "../tree.js";
5
+ import { createActionDispatcher } from "../actions.js";
6
+ import { PENDING_DOT_STYLE, PENDING_STYLE, animatePendingDots } from "../pending.js";
7
+ import { rejectedPropType } from "../resolved.js";
8
+ import { Fragment, computed, defineComponent, h, inject, onActivated, onBeforeUnmount, onDeactivated, onErrorCaptured, onMounted, onUpdated, provide, shallowRef, watch } from "vue";
9
+ // src/spec/vue/SpecRenderer.tsx
10
+ const SpecContext = Symbol("SpecRenderer");
11
+ const PendingDots = defineComponent({ setup() {
12
+ const host = shallowRef(null);
13
+ let stop;
14
+ const start = () => {
15
+ stop?.();
16
+ stop = host.value ? animatePendingDots(host.value) : void 0;
17
+ };
18
+ onMounted(start);
19
+ onActivated(start);
20
+ onDeactivated(() => {
21
+ stop?.();
22
+ stop = void 0;
23
+ });
24
+ onBeforeUnmount(() => {
25
+ stop?.();
26
+ stop = void 0;
27
+ });
28
+ return () => h("span", {
29
+ ref: host,
30
+ "data-gf-spec-placeholder": "pending",
31
+ "aria-hidden": "true",
32
+ style: PENDING_STYLE
33
+ }, Array.from({ length: 3 }, (_, key) => h("span", {
34
+ key,
35
+ style: PENDING_DOT_STYLE
36
+ })));
37
+ } });
38
+ const SpecPlaceholder = defineComponent((props) => () => props.reason === "pending" ? h(PendingDots) : h("div", {
39
+ "data-gf-spec-placeholder": props.reason,
40
+ role: "note",
41
+ title: props.id + ": " + props.message,
42
+ style: {
43
+ fontSize: "12px",
44
+ padding: "4px 8px",
45
+ margin: "2px 0",
46
+ border: "1px dashed currentColor",
47
+ borderRadius: "6px",
48
+ opacity: .6
49
+ }
50
+ }, props.message), {
51
+ name: "SpecPlaceholder",
52
+ props: [
53
+ "id",
54
+ "reason",
55
+ "message"
56
+ ]
57
+ });
58
+ const ElementBoundary = defineComponent((props, { slots }) => {
59
+ const error = shallowRef(null);
60
+ watch(() => props.element, () => {
61
+ error.value = null;
62
+ }, { flush: "sync" });
63
+ onErrorCaptured((cause) => {
64
+ const caught = cause instanceof Error ? cause : new Error(String(cause));
65
+ error.value = caught;
66
+ props.onError(caught);
67
+ return false;
68
+ });
69
+ return () => error.value ? props.fallback(error.value) : slots.default?.();
70
+ }, {
71
+ name: "SpecElementBoundary",
72
+ props: [
73
+ "element",
74
+ "onError",
75
+ "fallback"
76
+ ]
77
+ });
78
+ function renderChildren(ids, scope, ancestors) {
79
+ const occurrences = /* @__PURE__ */ new Map();
80
+ return ids.map((id) => {
81
+ if (typeof id !== "string") return null;
82
+ const occurrence = occurrences.get(id) ?? 0;
83
+ occurrences.set(id, occurrence + 1);
84
+ return h(ElementView, {
85
+ key: id + ":" + occurrence,
86
+ id,
87
+ scope,
88
+ ancestors
89
+ });
90
+ });
91
+ }
92
+ const ElementView = defineComponent((props) => {
93
+ const context = inject(SpecContext);
94
+ let last;
95
+ let accepted;
96
+ const commit = () => {
97
+ if (accepted !== void 0) last = accepted;
98
+ };
99
+ onMounted(commit);
100
+ onUpdated(commit);
101
+ return () => {
102
+ const ctx = context.value;
103
+ const { id, scope, ancestors } = props;
104
+ const Placeholder = ctx.placeholder;
105
+ const raw = Object.hasOwn(ctx.spec.elements, id) ? ctx.spec.elements[id] : void 0;
106
+ const element = raw && typeof raw === "object" && typeof raw.type === "string" ? raw : void 0;
107
+ const invalid = element && ctx.invalid(element);
108
+ accepted = invalid ? void 0 : element;
109
+ if (ancestors.includes(id)) return h(Placeholder, {
110
+ id,
111
+ reason: "cycle",
112
+ message: "\"" + id + "\" contains itself"
113
+ });
114
+ if (!element) return ctx.streaming ? null : h(Placeholder, {
115
+ id,
116
+ reason: "missing",
117
+ message: "Missing element \"" + id + "\""
118
+ });
119
+ if (!evaluateCondition(element.visible, {
120
+ ...scope,
121
+ state: ctx.state
122
+ })) return null;
123
+ const Impl = Object.hasOwn(ctx.components, element.type) ? ctx.components[element.type] : void 0;
124
+ if (!Impl || ctx.catalog && !ctx.catalog.component(element.type)) return ctx.streaming ? null : h(Placeholder, {
125
+ id,
126
+ reason: "unknown-type",
127
+ message: "Unknown component \"" + element.type + "\""
128
+ });
129
+ if (invalid && !ctx.streaming) return h(Placeholder, {
130
+ id,
131
+ reason: "invalid-props",
132
+ message: invalid
133
+ });
134
+ const shown = invalid ? last : element;
135
+ if (shown?.type !== element.type) return null;
136
+ return h(ElementBoundary, {
137
+ element: shown,
138
+ onError: (error) => context.value.onError?.(error, { elementId: id }),
139
+ fallback: (error) => context.value.streaming ? null : h(context.value.placeholder, {
140
+ id,
141
+ reason: "error",
142
+ message: shown.type + " failed: " + error.message
143
+ })
144
+ }, { default: () => h(ResolvedElement, {
145
+ key: shown.type,
146
+ id,
147
+ element: shown,
148
+ Impl,
149
+ scope,
150
+ ancestors: [...ancestors, id]
151
+ }) });
152
+ };
153
+ }, {
154
+ name: "SpecElement",
155
+ props: [
156
+ "id",
157
+ "scope",
158
+ "ancestors"
159
+ ]
160
+ });
161
+ const ResolvedElement = defineComponent((input) => {
162
+ const context = inject(SpecContext);
163
+ const resolved = computed(() => resolveProps(input.element.props, {
164
+ ...input.scope,
165
+ state: context.value.state
166
+ }));
167
+ const rejected = computed(() => rejectedPropType(context.value.catalog?.propsSchema(input.element.type), resolved.value.props));
168
+ let last;
169
+ const shown = computed(() => rejected.value ? last : resolved.value);
170
+ const commit = () => {
171
+ if (!rejected.value) last = resolved.value;
172
+ };
173
+ onMounted(commit);
174
+ onUpdated(commit);
175
+ let previousWatch;
176
+ watch(() => ({
177
+ state: context.value.state,
178
+ element: input.element,
179
+ scope: input.scope,
180
+ dispatch: context.value.dispatch
181
+ }), () => {
182
+ const ctx = context.value;
183
+ const next = /* @__PURE__ */ new Map();
184
+ for (const path of Object.keys(input.element.watch ?? {})) {
185
+ const value = getAtPointer(ctx.state, safePointer(path));
186
+ next.set(path, value);
187
+ if (previousWatch?.has(path) && !Object.is(previousWatch.get(path), value)) ctx.dispatch(input.element.watch[path], {
188
+ ...input.scope,
189
+ elementId: input.id,
190
+ trigger: path,
191
+ kind: "watch"
192
+ });
193
+ }
194
+ previousWatch = next;
195
+ }, {
196
+ immediate: true,
197
+ flush: "post"
198
+ });
199
+ const emit = (event, payload) => {
200
+ const bound = input.element.on?.[event];
201
+ if (bound) context.value.dispatch(bound, {
202
+ ...input.scope,
203
+ elementId: input.id,
204
+ trigger: event,
205
+ kind: "event",
206
+ payload
207
+ });
208
+ };
209
+ const setProp = (name, value) => {
210
+ const path = shown.value?.bindings[name];
211
+ if (path !== void 0) context.value.store.set(path, value, "replace");
212
+ };
213
+ return () => {
214
+ const ctx = context.value;
215
+ const { id, element, Impl, scope, ancestors } = input;
216
+ if (rejected.value && !ctx.streaming) return h(ctx.placeholder, {
217
+ id,
218
+ reason: "invalid-props",
219
+ message: element.type + ": " + rejected.value
220
+ });
221
+ const current = shown.value;
222
+ if (!current) return null;
223
+ const children = element.repeat && typeof element.repeat.path === "string" ? repeatItems(element.repeat, ctx.state)?.map((item) => h(Fragment, { key: item.key }, renderChildren(childIdsOf(element, "default"), item.scope, ancestors))) ?? null : renderChildren(childIdsOf(element, "default"), scope, ancestors);
224
+ const named = {};
225
+ for (const [name, ids] of Object.entries(element.slots ?? {})) if (Array.isArray(ids)) named[name] = renderChildren(ids, scope, ancestors);
226
+ const slots = Object.fromEntries(Object.entries(named).map(([name, nodes]) => [name, () => nodes]));
227
+ return h(Impl, {
228
+ id,
229
+ element,
230
+ props: current.props,
231
+ children,
232
+ bindings: current.bindings,
233
+ slots: named,
234
+ emit,
235
+ setProp,
236
+ state: ctx.store,
237
+ streaming: ctx.streaming
238
+ }, {
239
+ ...slots,
240
+ default: () => children
241
+ });
242
+ };
243
+ }, {
244
+ name: "ResolvedSpecElement",
245
+ props: [
246
+ "id",
247
+ "element",
248
+ "Impl",
249
+ "scope",
250
+ "ancestors"
251
+ ]
252
+ });
253
+ const SpecRenderer = defineComponent((props) => {
254
+ const emptyState = {};
255
+ const ownStore = createStateStore(props.spec.state ?? emptyState);
256
+ const store = computed(() => props.state ?? ownStore);
257
+ const snapshot = shallowRef(store.value.getState());
258
+ const active = shallowRef(false);
259
+ onMounted(() => {
260
+ active.value = true;
261
+ });
262
+ onActivated(() => {
263
+ active.value = true;
264
+ });
265
+ onDeactivated(() => {
266
+ active.value = false;
267
+ });
268
+ onBeforeUnmount(() => {
269
+ active.value = false;
270
+ });
271
+ watch([store, active], ([current, enabled], _old, onCleanup) => {
272
+ snapshot.value = current.getState();
273
+ if (!enabled) return;
274
+ let subscribed = true;
275
+ const stop = current.subscribe(() => {
276
+ if (subscribed) snapshot.value = current.getState();
277
+ });
278
+ snapshot.value = current.getState();
279
+ onCleanup(() => {
280
+ subscribed = false;
281
+ stop();
282
+ });
283
+ }, {
284
+ immediate: true,
285
+ flush: "sync"
286
+ });
287
+ watch(() => [props.state, props.spec.state], ([external, seed]) => {
288
+ if (!external) ownStore.seed(seed ?? emptyState);
289
+ }, { flush: "pre" });
290
+ const dispatch = computed(() => createActionDispatcher({
291
+ store: store.value,
292
+ ...props.catalog ? { catalog: props.catalog } : {},
293
+ onAction: (name, params, context) => {
294
+ if (props.handlers && Object.hasOwn(props.handlers, name)) return props.handlers[name](params, context);
295
+ if (!props.onAction) throw new Error("No handler for action \"" + name + "\"");
296
+ return props.onAction(name, params, context);
297
+ },
298
+ onError: (error) => {
299
+ if (props.onError) props.onError(error, {});
300
+ else console.warn("[generative-frame]", error.message);
301
+ }
302
+ }));
303
+ const invalid = computed(() => {
304
+ const catalog = props.catalog;
305
+ const cache = /* @__PURE__ */ new WeakMap();
306
+ return (element) => {
307
+ if (!catalog) return void 0;
308
+ let message = cache.get(element);
309
+ if (message === void 0) {
310
+ const issues = catalog.validateProps(element.type, element.props);
311
+ message = issues.length ? element.type + ": " + issues.slice(0, 2).map((issue) => (issue.path === "/" ? "props" : issue.path.slice(1)) + " " + issue.message).join("; ") : null;
312
+ cache.set(element, message);
313
+ }
314
+ return message ?? void 0;
315
+ };
316
+ });
317
+ const ctx = computed(() => ({
318
+ spec: props.spec,
319
+ components: props.components,
320
+ catalog: props.catalog,
321
+ store: store.value,
322
+ state: snapshot.value,
323
+ dispatch: dispatch.value,
324
+ streaming: props.streaming ?? false,
325
+ placeholder: props.placeholder ?? SpecPlaceholder,
326
+ invalid: invalid.value,
327
+ onError: props.onError
328
+ }));
329
+ provide(SpecContext, ctx);
330
+ return () => [props.spec.root ? h(ElementView, {
331
+ key: "root",
332
+ id: props.spec.root,
333
+ scope: {},
334
+ ancestors: []
335
+ }) : null, props.streaming ? h(props.placeholder ?? SpecPlaceholder, {
336
+ key: "pending",
337
+ id: "",
338
+ reason: "pending",
339
+ message: "The spec is streaming"
340
+ }) : null];
341
+ }, {
342
+ name: "SpecRenderer",
343
+ props: [
344
+ "spec",
345
+ "components",
346
+ "catalog",
347
+ "state",
348
+ "handlers",
349
+ "onAction",
350
+ "onError",
351
+ "streaming",
352
+ "placeholder"
353
+ ]
354
+ });
355
+ export { SpecPlaceholder, SpecRenderer };
356
+
357
+ //# sourceMappingURL=SpecRenderer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpecRenderer.js","names":["computed","defineComponent","Fragment","h","inject","onActivated","onBeforeUnmount","onDeactivated","onErrorCaptured","onMounted","onUpdated","provide","shallowRef","watch","Component","ComputedRef","InjectionKey","VNodeChild","createActionDispatcher","ActionDispatcher","ActionHandler","ActionSource","Catalog","evaluateCondition","resolveProps","ExpressionContext","animatePendingDots","PENDING_DOT_STYLE","PENDING_STYLE","getAtPointer","rejectedPropType","createStateStore","SpecStateStore","childIdsOf","repeatItems","safePointer","Spec","SpecElement","SpecComponentProps","Record","id","element","props","P","children","slots","emit","event","payload","setProp","name","value","bindings","state","streaming","SpecComponents","SpecPlaceholderProps","reason","message","SpecRendererProps","spec","components","catalog","handlers","onAction","params","context","onError","error","Error","elementId","placeholder","RenderContext","store","dispatch","invalid","SpecContext","Symbol","Scope","Pick","PendingDots","setup","host","HTMLSpanElement","stop","start","undefined","ref","style","Array","from","length","_","key","SpecPlaceholder","role","title","fontSize","padding","margin","border","borderRadius","opacity","BoundaryProps","fallback","ElementBoundary","flush","cause","caught","String","default","renderChildren","ids","scope","ancestors","occurrences","Map","map","occurrence","get","set","ElementView","last","accepted","commit","ctx","Placeholder","raw","Object","hasOwn","elements","type","includes","visible","Impl","component","shown","ResolvedElement","Resolved","ReturnType","input","resolved","rejected","propsSchema","previousWatch","next","path","keys","has","is","trigger","kind","immediate","bound","on","current","repeat","item","named","entries","isArray","fromEntries","nodes","SpecRenderer","emptyState","ownStore","snapshot","getState","active","enabled","_old","onCleanup","subscribed","subscribe","const","external","seed","console","warn","cache","WeakMap","issues","validateProps","slice","issue","join","root"],"sources":["../../../src/spec/vue/SpecRenderer.tsx"],"sourcesContent":["import {\n computed,\n defineComponent,\n Fragment,\n h,\n inject,\n onActivated,\n onBeforeUnmount,\n onDeactivated,\n onErrorCaptured,\n onMounted,\n onUpdated,\n provide,\n shallowRef,\n watch,\n type Component,\n type ComputedRef,\n type InjectionKey,\n type VNodeChild,\n} from \"vue\";\nimport {\n createActionDispatcher,\n type ActionDispatcher,\n type ActionHandler,\n type ActionSource,\n} from \"../actions\";\nimport type { Catalog } from \"../catalog\";\nimport {\n evaluateCondition,\n resolveProps,\n type ExpressionContext,\n} from \"../expressions\";\nimport {\n animatePendingDots,\n PENDING_DOT_STYLE,\n PENDING_STYLE,\n} from \"../pending\";\nimport { getAtPointer } from \"../pointer\";\nimport { rejectedPropType } from \"../resolved\";\nimport { createStateStore, type SpecStateStore } from \"../state\";\nimport { childIdsOf, repeatItems, safePointer } from \"../tree\";\nimport type { Spec, SpecElement } from \"../types\";\nexport type SpecComponentProps<\n P extends Record<string, unknown> = Record<string, unknown>,\n> = {\n id: string;\n element: SpecElement;\n props: P;\n /** The rendered default slot, also supplied as a native Vue default slot. */\n children: VNodeChild;\n /** Named slot nodes, also supplied as native Vue named slots. */\n slots: Record<string, VNodeChild>;\n emit(event: string, payload?: unknown): void;\n setProp(name: string, value: unknown): void;\n bindings: Record<string, string>;\n state: SpecStateStore;\n streaming: boolean;\n};\nexport type SpecComponents = Record<string, Component>;\nexport type SpecPlaceholderProps = {\n id: string;\n reason:\n | \"missing\"\n | \"pending\"\n | \"unknown-type\"\n | \"invalid-props\"\n | \"cycle\"\n | \"error\";\n message: string;\n};\nexport type SpecRendererProps = {\n spec: Spec;\n components: SpecComponents;\n catalog?: Catalog;\n state?: SpecStateStore;\n handlers?: Record<string, ActionHandler>;\n onAction?: (\n name: string,\n params: Record<string, unknown>,\n context: ActionSource & { state: SpecStateStore },\n ) => unknown;\n onError?: (error: Error, context: { elementId?: string }) => void;\n streaming?: boolean;\n placeholder?: Component;\n};\ntype RenderContext = {\n spec: Spec;\n components: SpecComponents;\n catalog: Catalog | undefined;\n store: SpecStateStore;\n state: Record<string, unknown>;\n dispatch: ActionDispatcher;\n streaming: boolean;\n placeholder: Component;\n invalid: (element: SpecElement) => string | undefined;\n onError: SpecRendererProps[\"onError\"];\n};\nconst SpecContext: InjectionKey<ComputedRef<RenderContext>> =\n Symbol(\"SpecRenderer\");\ntype Scope = Pick<ExpressionContext, \"item\" | \"index\" | \"itemPath\">;\nconst PendingDots = defineComponent({\n setup() {\n const host = shallowRef<HTMLSpanElement | null>(null);\n let stop: (() => void) | undefined;\n const start = () => {\n stop?.();\n stop = host.value ? animatePendingDots(host.value) : undefined;\n };\n onMounted(start);\n onActivated(start);\n onDeactivated(() => {\n stop?.();\n stop = undefined;\n });\n onBeforeUnmount(() => {\n stop?.();\n stop = undefined;\n });\n return () =>\n h(\n \"span\",\n {\n ref: host,\n \"data-gf-spec-placeholder\": \"pending\",\n \"aria-hidden\": \"true\",\n style: PENDING_STYLE,\n },\n Array.from({ length: 3 }, (_, key) =>\n h(\"span\", { key, style: PENDING_DOT_STYLE }),\n ),\n );\n },\n});\nexport const SpecPlaceholder = defineComponent(\n (props: SpecPlaceholderProps) => () =>\n props.reason === \"pending\"\n ? h(PendingDots)\n : h(\n \"div\",\n {\n \"data-gf-spec-placeholder\": props.reason,\n role: \"note\",\n title: props.id + \": \" + props.message,\n style: {\n fontSize: \"12px\",\n padding: \"4px 8px\",\n margin: \"2px 0\",\n border: \"1px dashed currentColor\",\n borderRadius: \"6px\",\n opacity: 0.6,\n },\n },\n props.message,\n ),\n { name: \"SpecPlaceholder\", props: [\"id\", \"reason\", \"message\"] },\n);\ntype BoundaryProps = {\n element: SpecElement;\n onError: (error: Error) => void;\n fallback: (error: Error) => VNodeChild;\n};\nconst ElementBoundary = defineComponent(\n (props: BoundaryProps, { slots }) => {\n const error = shallowRef<Error | null>(null);\n watch(\n () => props.element,\n () => {\n error.value = null;\n },\n { flush: \"sync\" },\n );\n onErrorCaptured((cause) => {\n const caught = cause instanceof Error ? cause : new Error(String(cause));\n error.value = caught;\n props.onError(caught);\n return false;\n });\n return () =>\n error.value ? props.fallback(error.value) : slots.default?.();\n },\n { name: \"SpecElementBoundary\", props: [\"element\", \"onError\", \"fallback\"] },\n);\nfunction renderChildren(\n ids: readonly unknown[],\n scope: Scope,\n ancestors: readonly string[],\n): VNodeChild[] {\n const occurrences = new Map<string, number>();\n return ids.map((id) => {\n if (typeof id !== \"string\") return null;\n const occurrence = occurrences.get(id) ?? 0;\n occurrences.set(id, occurrence + 1);\n return h(ElementView, { key: id + \":\" + occurrence, id, scope, ancestors });\n });\n}\nconst ElementView = defineComponent(\n (props: { id: string; scope: Scope; ancestors: readonly string[] }) => {\n const context = inject(SpecContext)!;\n let last: SpecElement | undefined;\n let accepted: SpecElement | undefined;\n const commit = () => {\n if (accepted !== undefined) last = accepted;\n };\n onMounted(commit);\n onUpdated(commit);\n return () => {\n const ctx = context.value;\n const { id, scope, ancestors } = props;\n const Placeholder = ctx.placeholder;\n const raw = Object.hasOwn(ctx.spec.elements, id)\n ? ctx.spec.elements[id]\n : undefined;\n const element =\n raw && typeof raw === \"object\" && typeof raw.type === \"string\"\n ? raw\n : undefined;\n const invalid = element && ctx.invalid(element);\n accepted = invalid ? undefined : element;\n if (ancestors.includes(id))\n return h(Placeholder, {\n id,\n reason: \"cycle\",\n message: '\"' + id + '\" contains itself',\n });\n if (!element)\n return ctx.streaming\n ? null\n : h(Placeholder, {\n id,\n reason: \"missing\",\n message: 'Missing element \"' + id + '\"',\n });\n if (!evaluateCondition(element.visible, { ...scope, state: ctx.state }))\n return null;\n const Impl = Object.hasOwn(ctx.components, element.type)\n ? ctx.components[element.type]\n : undefined;\n if (!Impl || (ctx.catalog && !ctx.catalog.component(element.type)))\n return ctx.streaming\n ? null\n : h(Placeholder, {\n id,\n reason: \"unknown-type\",\n message: 'Unknown component \"' + element.type + '\"',\n });\n if (invalid && !ctx.streaming)\n return h(Placeholder, {\n id,\n reason: \"invalid-props\",\n message: invalid,\n });\n const shown = invalid ? last : element;\n if (shown?.type !== element.type) return null;\n return h(\n ElementBoundary,\n {\n element: shown,\n onError: (error) => context.value.onError?.(error, { elementId: id }),\n fallback: (error) =>\n context.value.streaming\n ? null\n : h(context.value.placeholder, {\n id,\n reason: \"error\",\n message: shown.type + \" failed: \" + error.message,\n }),\n },\n {\n default: () =>\n h(ResolvedElement, {\n key: shown.type,\n id,\n element: shown,\n Impl,\n scope,\n ancestors: [...ancestors, id],\n }),\n },\n );\n };\n },\n { name: \"SpecElement\", props: [\"id\", \"scope\", \"ancestors\"] },\n);\ntype Resolved = ReturnType<typeof resolveProps>;\nconst ResolvedElement = defineComponent(\n (input: {\n id: string;\n element: SpecElement;\n Impl: Component;\n scope: Scope;\n ancestors: readonly string[];\n }) => {\n const context = inject(SpecContext)!;\n const resolved = computed(() =>\n resolveProps(input.element.props, {\n ...input.scope,\n state: context.value.state,\n }),\n );\n const rejected = computed(() =>\n rejectedPropType(\n context.value.catalog?.propsSchema(input.element.type),\n resolved.value.props,\n ),\n );\n let last: Resolved | undefined;\n const shown = computed(() => (rejected.value ? last : resolved.value));\n const commit = () => {\n if (!rejected.value) last = resolved.value;\n };\n onMounted(commit);\n onUpdated(commit);\n let previousWatch: Map<string, unknown> | undefined;\n watch(\n () => ({\n state: context.value.state,\n element: input.element,\n scope: input.scope,\n dispatch: context.value.dispatch,\n }),\n () => {\n const ctx = context.value;\n const next = new Map<string, unknown>();\n for (const path of Object.keys(input.element.watch ?? {})) {\n const value = getAtPointer(ctx.state, safePointer(path));\n next.set(path, value);\n if (\n previousWatch?.has(path) &&\n !Object.is(previousWatch.get(path), value)\n )\n void ctx.dispatch(input.element.watch![path], {\n ...input.scope,\n elementId: input.id,\n trigger: path,\n kind: \"watch\",\n });\n }\n previousWatch = next;\n },\n { immediate: true, flush: \"post\" },\n );\n const emit = (event: string, payload?: unknown) => {\n const bound = input.element.on?.[event];\n if (bound)\n void context.value.dispatch(bound, {\n ...input.scope,\n elementId: input.id,\n trigger: event,\n kind: \"event\",\n payload,\n });\n };\n const setProp = (name: string, value: unknown) => {\n const path = shown.value?.bindings[name];\n if (path !== undefined) context.value.store.set(path, value, \"replace\");\n };\n return () => {\n const ctx = context.value;\n const { id, element, Impl, scope, ancestors } = input;\n if (rejected.value && !ctx.streaming)\n return h(ctx.placeholder, {\n id,\n reason: \"invalid-props\",\n message: element.type + \": \" + rejected.value,\n });\n const current = shown.value;\n if (!current) return null;\n const children =\n element.repeat && typeof element.repeat.path === \"string\"\n ? (repeatItems(element.repeat, ctx.state)?.map((item) =>\n h(\n Fragment,\n { key: item.key },\n renderChildren(\n childIdsOf(element, \"default\"),\n item.scope,\n ancestors,\n ),\n ),\n ) ?? null)\n : renderChildren(childIdsOf(element, \"default\"), scope, ancestors);\n const named: Record<string, VNodeChild> = {};\n for (const [name, ids] of Object.entries(element.slots ?? {}))\n if (Array.isArray(ids))\n named[name] = renderChildren(ids, scope, ancestors);\n const slots = Object.fromEntries(\n Object.entries(named).map(([name, nodes]) => [name, () => nodes]),\n );\n return h(\n Impl,\n {\n id,\n element,\n props: current.props,\n children,\n bindings: current.bindings,\n slots: named,\n emit,\n setProp,\n state: ctx.store,\n streaming: ctx.streaming,\n },\n { ...slots, default: () => children },\n );\n };\n },\n {\n name: \"ResolvedSpecElement\",\n props: [\"id\", \"element\", \"Impl\", \"scope\", \"ancestors\"],\n },\n);\nexport const SpecRenderer = defineComponent(\n (props: SpecRendererProps) => {\n const emptyState: Record<string, unknown> = {};\n const ownStore = createStateStore(props.spec.state ?? emptyState);\n const store = computed(() => props.state ?? ownStore);\n const snapshot = shallowRef(store.value.getState());\n const active = shallowRef(false);\n onMounted(() => {\n active.value = true;\n });\n onActivated(() => {\n active.value = true;\n });\n onDeactivated(() => {\n active.value = false;\n });\n onBeforeUnmount(() => {\n active.value = false;\n });\n watch(\n [store, active],\n ([current, enabled], _old, onCleanup) => {\n snapshot.value = current.getState();\n if (!enabled) return;\n let subscribed = true;\n const stop = current.subscribe(() => {\n if (subscribed) snapshot.value = current.getState();\n });\n snapshot.value = current.getState();\n onCleanup(() => {\n subscribed = false;\n stop();\n });\n },\n { immediate: true, flush: \"sync\" },\n );\n watch(\n () => [props.state, props.spec.state] as const,\n ([external, seed]) => {\n if (!external) ownStore.seed(seed ?? emptyState);\n },\n { flush: \"pre\" },\n );\n const dispatch = computed(() =>\n createActionDispatcher({\n store: store.value,\n ...(props.catalog ? { catalog: props.catalog } : {}),\n onAction: (name, params, context) => {\n if (props.handlers && Object.hasOwn(props.handlers, name))\n return props.handlers[name]!(params, context);\n if (!props.onAction)\n throw new Error('No handler for action \"' + name + '\"');\n return props.onAction(name, params, context);\n },\n onError: (error) => {\n if (props.onError) props.onError(error, {});\n else console.warn(\"[generative-frame]\", error.message);\n },\n }),\n );\n const invalid = computed(() => {\n const catalog = props.catalog;\n const cache = new WeakMap<SpecElement, string | null>();\n return (element: SpecElement): string | undefined => {\n if (!catalog) return undefined;\n let message = cache.get(element);\n if (message === undefined) {\n const issues = catalog.validateProps(element.type, element.props);\n message = issues.length\n ? element.type +\n \": \" +\n issues\n .slice(0, 2)\n .map(\n (issue) =>\n (issue.path === \"/\" ? \"props\" : issue.path.slice(1)) +\n \" \" +\n issue.message,\n )\n .join(\"; \")\n : null;\n cache.set(element, message);\n }\n return message ?? undefined;\n };\n });\n const ctx = computed<RenderContext>(() => ({\n spec: props.spec,\n components: props.components,\n catalog: props.catalog,\n store: store.value,\n state: snapshot.value,\n dispatch: dispatch.value,\n streaming: props.streaming ?? false,\n placeholder: props.placeholder ?? SpecPlaceholder,\n invalid: invalid.value,\n onError: props.onError,\n }));\n provide(SpecContext, ctx);\n return () => [\n props.spec.root\n ? h(ElementView, {\n key: \"root\",\n id: props.spec.root,\n scope: {},\n ancestors: [],\n })\n : null,\n props.streaming\n ? h(props.placeholder ?? SpecPlaceholder, {\n key: \"pending\",\n id: \"\",\n reason: \"pending\",\n message: \"The spec is streaming\",\n })\n : null,\n ];\n },\n {\n name: \"SpecRenderer\",\n props: [\n \"spec\",\n \"components\",\n \"catalog\",\n \"state\",\n \"handlers\",\n \"onAction\",\n \"onError\",\n \"streaming\",\n \"placeholder\",\n ],\n },\n);\n"],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import { type MaybeRefOrGetter, type ShallowRef } from "vue";
2
+ import { type SpecStreamError, type SpecStreamMode } from "../stream.js";
3
+ import { type Spec } from "../types.js";
4
+ export type UseSpecStreamOptions = {
5
+ source?: string;
6
+ complete?: boolean;
7
+ mode?: SpecStreamMode;
8
+ initial?: Spec;
9
+ };
10
+ export type UseSpecStreamResult = {
11
+ spec: Readonly<ShallowRef<Spec>>;
12
+ text: Readonly<ShallowRef<string>>;
13
+ errors: Readonly<ShallowRef<SpecStreamError[]>>;
14
+ push(chunk: string): void;
15
+ end(): void;
16
+ reset(): void;
17
+ };
18
+ export declare function useSpecStream(options?: MaybeRefOrGetter<UseSpecStreamOptions>): UseSpecStreamResult;
19
+ //# sourceMappingURL=useSpecStream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useSpecStream.d.ts","mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,KAAK;AACZ,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,cAAW;AAClB,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,aAAU;AAC/C,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM;IACf,QAAQ,CAAC,EAAE,OAAO;IAClB,IAAI,CAAC,EAAE,cAAc;IACrB,OAAO,CAAC,EAAE,IAAI;CACf;AACD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IACzB,GAAG,IAAI,IAAI;IACX,KAAK,IAAI,IAAI;CACd;AAUD,wBAAgB,aAAa,CAC3B,OAAO,GAAE,gBAAgB,CAAC,oBAAoB,CAAM,GACnD,mBAAmB","names":[],"ignoreList":[],"sources":["../../../src/spec/vue/useSpecStream.ts"],"sourcesContent":[null]}
@@ -0,0 +1,115 @@
1
+ import { emptySpec } from "../types.js";
2
+ import { createSpecStream, parseSpecStream } from "../stream.js";
3
+ import { computed, onScopeDispose, shallowRef, toValue, watch } from "vue";
4
+ // src/spec/vue/useSpecStream.ts
5
+ function useSpecStream(options = {}) {
6
+ const generation = shallowRef(0);
7
+ const snapshot = shallowRef({
8
+ spec: toValue(options).initial ?? emptySpec(),
9
+ text: "",
10
+ errors: []
11
+ });
12
+ const followed = shallowRef(null);
13
+ let follower = null;
14
+ let imperative = null;
15
+ let disposed = false;
16
+ const start = () => {
17
+ const { initial, mode = "jsonl" } = toValue(options);
18
+ return createSpecStream({
19
+ mode,
20
+ ...initial ? { initial } : {}
21
+ });
22
+ };
23
+ watch(() => [
24
+ toValue(options).source,
25
+ toValue(options).complete ?? false,
26
+ toValue(options).mode ?? "jsonl",
27
+ generation.value
28
+ ], ([source, complete, mode, currentGeneration]) => {
29
+ if (source === void 0) {
30
+ followed.value = null;
31
+ return;
32
+ }
33
+ const initial = toValue(options).initial;
34
+ if (complete) {
35
+ const result = parseSpecStream(source, {
36
+ mode,
37
+ ...initial ? { initial } : {}
38
+ });
39
+ follower = null;
40
+ followed.value = {
41
+ spec: result.spec,
42
+ text: result.text,
43
+ errors: result.errors
44
+ };
45
+ return;
46
+ }
47
+ if (!follower || follower.mode !== mode || follower.generation !== currentGeneration || !source.startsWith(follower.consumed)) follower = {
48
+ stream: start(),
49
+ consumed: "",
50
+ mode,
51
+ generation: currentGeneration,
52
+ text: "",
53
+ errors: []
54
+ };
55
+ if (source.length > follower.consumed.length) {
56
+ const update = follower.stream.push(source.slice(follower.consumed.length));
57
+ follower.consumed = source;
58
+ if (update.text) follower.text += update.text;
59
+ if (update.errors.length) follower.errors = [...follower.errors, ...update.errors];
60
+ }
61
+ followed.value = {
62
+ spec: follower.stream.spec,
63
+ text: follower.text,
64
+ errors: follower.errors
65
+ };
66
+ }, {
67
+ immediate: true,
68
+ flush: "pre"
69
+ });
70
+ onScopeDispose(() => {
71
+ disposed = true;
72
+ follower = null;
73
+ imperative = null;
74
+ });
75
+ const current = computed(() => followed.value ?? snapshot.value);
76
+ return {
77
+ spec: computed(() => current.value.spec),
78
+ text: computed(() => current.value.text),
79
+ errors: computed(() => current.value.errors),
80
+ push(chunk) {
81
+ if (disposed) return;
82
+ imperative ??= start();
83
+ const update = imperative.push(chunk);
84
+ const previous = snapshot.value;
85
+ if (update.spec !== previous.spec || update.text || update.errors.length) snapshot.value = {
86
+ spec: update.spec,
87
+ text: previous.text + update.text,
88
+ errors: update.errors.length ? [...previous.errors, ...update.errors] : previous.errors
89
+ };
90
+ },
91
+ end() {
92
+ if (disposed || !imperative) return;
93
+ const result = imperative.result();
94
+ imperative = null;
95
+ snapshot.value = {
96
+ spec: result.spec,
97
+ text: result.text,
98
+ errors: result.errors
99
+ };
100
+ },
101
+ reset() {
102
+ if (disposed) return;
103
+ imperative = null;
104
+ generation.value++;
105
+ snapshot.value = {
106
+ spec: toValue(options).initial ?? emptySpec(),
107
+ text: "",
108
+ errors: []
109
+ };
110
+ }
111
+ };
112
+ }
113
+ export { useSpecStream };
114
+
115
+ //# sourceMappingURL=useSpecStream.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useSpecStream.js","names":[],"sources":["../../../src/spec/vue/useSpecStream.ts"],"sourcesContent":["import {\n computed,\n onScopeDispose,\n shallowRef,\n toValue,\n watch,\n type MaybeRefOrGetter,\n type ShallowRef,\n} from \"vue\";\nimport {\n createSpecStream,\n parseSpecStream,\n type SpecStream,\n type SpecStreamError,\n type SpecStreamMode,\n} from \"../stream\";\nimport { emptySpec, type Spec } from \"../types\";\nexport type UseSpecStreamOptions = {\n source?: string;\n complete?: boolean;\n mode?: SpecStreamMode;\n initial?: Spec;\n};\nexport type UseSpecStreamResult = {\n spec: Readonly<ShallowRef<Spec>>;\n text: Readonly<ShallowRef<string>>;\n errors: Readonly<ShallowRef<SpecStreamError[]>>;\n push(chunk: string): void;\n end(): void;\n reset(): void;\n};\ntype Snapshot = { spec: Spec; text: string; errors: SpecStreamError[] };\ntype Follower = {\n stream: SpecStream;\n consumed: string;\n mode: SpecStreamMode;\n generation: number;\n text: string;\n errors: SpecStreamError[];\n};\nexport function useSpecStream(\n options: MaybeRefOrGetter<UseSpecStreamOptions> = {},\n): UseSpecStreamResult {\n const generation = shallowRef(0);\n const snapshot = shallowRef<Snapshot>({\n spec: toValue(options).initial ?? emptySpec(),\n text: \"\",\n errors: [],\n });\n const followed = shallowRef<Snapshot | null>(null);\n let follower: Follower | null = null;\n let imperative: SpecStream | null = null;\n let disposed = false;\n const start = () => {\n const { initial, mode = \"jsonl\" } = toValue(options);\n return createSpecStream({ mode, ...(initial ? { initial } : {}) });\n };\n watch(\n () =>\n [\n toValue(options).source,\n toValue(options).complete ?? false,\n toValue(options).mode ?? \"jsonl\",\n generation.value,\n ] as const,\n ([source, complete, mode, currentGeneration]) => {\n if (source === undefined) {\n followed.value = null;\n return;\n }\n const initial = toValue(options).initial;\n if (complete) {\n const result = parseSpecStream(source, {\n mode,\n ...(initial ? { initial } : {}),\n });\n follower = null;\n followed.value = {\n spec: result.spec,\n text: result.text,\n errors: result.errors,\n };\n return;\n }\n if (\n !follower ||\n follower.mode !== mode ||\n follower.generation !== currentGeneration ||\n !source.startsWith(follower.consumed)\n ) {\n follower = {\n stream: start(),\n consumed: \"\",\n mode,\n generation: currentGeneration,\n text: \"\",\n errors: [],\n };\n }\n if (source.length > follower.consumed.length) {\n const update = follower.stream.push(\n source.slice(follower.consumed.length),\n );\n follower.consumed = source;\n if (update.text) follower.text += update.text;\n if (update.errors.length)\n follower.errors = [...follower.errors, ...update.errors];\n }\n followed.value = {\n spec: follower.stream.spec,\n text: follower.text,\n errors: follower.errors,\n };\n },\n { immediate: true, flush: \"pre\" },\n );\n onScopeDispose(() => {\n disposed = true;\n follower = null;\n imperative = null;\n });\n const current = computed(() => followed.value ?? snapshot.value);\n return {\n spec: computed(() => current.value.spec),\n text: computed(() => current.value.text),\n errors: computed(() => current.value.errors),\n push(chunk) {\n if (disposed) return;\n imperative ??= start();\n const update = imperative.push(chunk);\n const previous = snapshot.value;\n if (update.spec !== previous.spec || update.text || update.errors.length)\n snapshot.value = {\n spec: update.spec,\n text: previous.text + update.text,\n errors: update.errors.length\n ? [...previous.errors, ...update.errors]\n : previous.errors,\n };\n },\n end() {\n if (disposed || !imperative) return;\n const result = imperative.result();\n imperative = null;\n snapshot.value = {\n spec: result.spec,\n text: result.text,\n errors: result.errors,\n };\n },\n reset() {\n if (disposed) return;\n imperative = null;\n generation.value++;\n snapshot.value = {\n spec: toValue(options).initial ?? emptySpec(),\n text: \"\",\n errors: [],\n };\n },\n };\n}\n"],"mappings":";;;;AAwCA,SAAgB,cACd,UAAkD,CAAC,GAC9B;CACrB,MAAM,aAAa,WAAW,CAAC;CAC/B,MAAM,WAAW,WAAqB;EACpC,MAAM,QAAQ,OAAO,CAAC,CAAC,WAAW,UAAU;EAC5C,MAAM;EACN,QAAQ,CAAC;CACX,CAAC;CACD,MAAM,WAAW,WAA4B,IAAI;CACjD,IAAI,WAA4B;CAChC,IAAI,aAAgC;CACpC,IAAI,WAAW;CACf,MAAM,cAAc;EAClB,MAAM,EAAE,SAAS,OAAO,YAAY,QAAQ,OAAO;EACnD,OAAO,iBAAiB;GAAE;GAAM,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;EAAG,CAAC;CACnE;CACA,YAEI;EACE,QAAQ,OAAO,CAAC,CAAC;EACjB,QAAQ,OAAO,CAAC,CAAC,YAAY;EAC7B,QAAQ,OAAO,CAAC,CAAC,QAAQ;EACzB,WAAW;CACb,IACD,CAAC,QAAQ,UAAU,MAAM,uBAAuB;EAC/C,IAAI,WAAW,KAAA,GAAW;GACxB,SAAS,QAAQ;GACjB;EACF;EACA,MAAM,UAAU,QAAQ,OAAO,CAAC,CAAC;EACjC,IAAI,UAAU;GACZ,MAAM,SAAS,gBAAgB,QAAQ;IACrC;IACA,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;GAC/B,CAAC;GACD,WAAW;GACX,SAAS,QAAQ;IACf,MAAM,OAAO;IACb,MAAM,OAAO;IACb,QAAQ,OAAO;GACjB;GACA;EACF;EACA,IACE,CAAC,YACD,SAAS,SAAS,QAClB,SAAS,eAAe,qBACxB,CAAC,OAAO,WAAW,SAAS,QAAQ,GAEpC,WAAW;GACT,QAAQ,MAAM;GACd,UAAU;GACV;GACA,YAAY;GACZ,MAAM;GACN,QAAQ,CAAC;EACX;EAEF,IAAI,OAAO,SAAS,SAAS,SAAS,QAAQ;GAC5C,MAAM,SAAS,SAAS,OAAO,KAC7B,OAAO,MAAM,SAAS,SAAS,MAAM,CACvC;GACA,SAAS,WAAW;GACpB,IAAI,OAAO,MAAM,SAAS,QAAQ,OAAO;GACzC,IAAI,OAAO,OAAO,QAChB,SAAS,SAAS,CAAC,GAAG,SAAS,QAAQ,GAAG,OAAO,MAAM;EAC3D;EACA,SAAS,QAAQ;GACf,MAAM,SAAS,OAAO;GACtB,MAAM,SAAS;GACf,QAAQ,SAAS;EACnB;CACF,GACA;EAAE,WAAW;EAAM,OAAO;CAAM,CAClC;CACA,qBAAqB;EACnB,WAAW;EACX,WAAW;EACX,aAAa;CACf,CAAC;CACD,MAAM,UAAU,eAAe,SAAS,SAAS,SAAS,KAAK;CAC/D,OAAO;EACL,MAAM,eAAe,QAAQ,MAAM,IAAI;EACvC,MAAM,eAAe,QAAQ,MAAM,IAAI;EACvC,QAAQ,eAAe,QAAQ,MAAM,MAAM;EAC3C,KAAK,OAAO;GACV,IAAI,UAAU;GACd,eAAe,MAAM;GACrB,MAAM,SAAS,WAAW,KAAK,KAAK;GACpC,MAAM,WAAW,SAAS;GAC1B,IAAI,OAAO,SAAS,SAAS,QAAQ,OAAO,QAAQ,OAAO,OAAO,QAChE,SAAS,QAAQ;IACf,MAAM,OAAO;IACb,MAAM,SAAS,OAAO,OAAO;IAC7B,QAAQ,OAAO,OAAO,SAClB,CAAC,GAAG,SAAS,QAAQ,GAAG,OAAO,MAAM,IACrC,SAAS;GACf;EACJ;EACA,MAAM;GACJ,IAAI,YAAY,CAAC,YAAY;GAC7B,MAAM,SAAS,WAAW,OAAO;GACjC,aAAa;GACb,SAAS,QAAQ;IACf,MAAM,OAAO;IACb,MAAM,OAAO;IACb,QAAQ,OAAO;GACjB;EACF;EACA,QAAQ;GACN,IAAI,UAAU;GACd,aAAa;GACb,WAAW;GACX,SAAS,QAAQ;IACf,MAAM,QAAQ,OAAO,CAAC,CAAC,WAAW,UAAU;IAC5C,MAAM;IACN,QAAQ,CAAC;GACX;EACF;CACF;AACF"}
@@ -0,0 +1,3 @@
1
+ export { SpecRenderer, SpecPlaceholder, type SpecComponentProps, type SpecComponents, type SpecPlaceholderProps, type SpecRendererProps, } from "./vue/SpecRenderer.js";
2
+ export { useSpecStream, type UseSpecStreamOptions, type UseSpecStreamResult, } from "./vue/useSpecStream.js";
3
+ //# sourceMappingURL=vue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vue.d.ts","mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,uBAAoB;AAC3B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,wBAAqB","names":[],"ignoreList":[],"sources":["../../src/spec/vue.ts"],"sourcesContent":[null]}
@@ -0,0 +1,3 @@
1
+ import { SpecPlaceholder, SpecRenderer } from "./vue/SpecRenderer.js";
2
+ import { useSpecStream } from "./vue/useSpecStream.js";
3
+ export { SpecPlaceholder, SpecRenderer, useSpecStream };
package/dist/spec.d.ts ADDED
@@ -0,0 +1,12 @@
1
+ export type { ActionBinding, Condition, PatchOperation, Spec, SpecElement, } from "./spec/types.js";
2
+ export { emptySpec } from "./spec/types.js";
3
+ export { defineCatalog, type ActionDefinition, type Catalog, type CatalogDefinition, type ComponentDefinition, type PropsSchema, } from "./spec/catalog.js";
4
+ export type { SpecPromptOptions } from "./spec/prompt.js";
5
+ export { createSpecStream, parseSpecStream, type CreateSpecStreamOptions, type SpecStream, type SpecStreamError, type SpecStreamMode, type SpecStreamResult, type SpecStreamUpdate, } from "./spec/stream.js";
6
+ export { applyPatch } from "./spec/patch.js";
7
+ export { formatSpecIssues, validateSpec, type SpecIssue, type SpecIssueCode, type SpecValidation, type ValidateSpecOptions, } from "./spec/validate.js";
8
+ export { createStateStore, type SpecStateStore, type SpecStateWrite, type StateListener, type StateStoreOptions, } from "./spec/state.js";
9
+ export { resolveSpec, type ResolveSpecOptions, type ResolvedAction, type ResolvedElement, } from "./spec/resolve.js";
10
+ export type { ActionHandler, ActionSource } from "./spec/actions.js";
11
+ export type { JsonSchema, JsonSchemaType, StandardSchemaLike, } from "./json-schema.js";
12
+ //# sourceMappingURL=spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spec.d.ts","mappings":"AAAA,YAAY,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,IAAI,EACJ,WAAW,GACZ,MAAM,iBAAc;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAc;AACxC,OAAO,EACL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,mBAAgB;AACvB,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAe;AACtD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,kBAAe;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAc;AACzC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAiB;AACxB,OAAO,EACL,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,iBAAc;AACrB,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,mBAAgB;AACvB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAgB;AACjE,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,kBAAe","names":[],"ignoreList":[],"sources":["../src/spec.ts"],"sourcesContent":[null]}
package/dist/spec.js ADDED
@@ -0,0 +1,8 @@
1
+ import { emptySpec } from "./spec/types.js";
2
+ import { defineCatalog } from "./spec/catalog.js";
3
+ import { applyPatch } from "./spec/patch.js";
4
+ import { createSpecStream, parseSpecStream } from "./spec/stream.js";
5
+ import { formatSpecIssues, validateSpec } from "./spec/validate.js";
6
+ import { createStateStore } from "./spec/state.js";
7
+ import { resolveSpec } from "./spec/resolve.js";
8
+ export { applyPatch, createSpecStream, createStateStore, defineCatalog, emptySpec, formatSpecIssues, parseSpecStream, resolveSpec, validateSpec };
@@ -0,0 +1,38 @@
1
+ import type { ColorScheme } from "./protocol.js";
2
+ /** Theme values sent into a widget frame, keyed by CSS custom property name. */
3
+ export type ThemeTokens = {
4
+ colorScheme: ColorScheme;
5
+ variables: Record<string, string>;
6
+ };
7
+ export type ThemeTokenName = "--color-background" | "--color-surface" | "--color-surface-muted" | "--color-text" | "--color-text-muted" | "--color-text-subtle" | "--color-border" | "--color-border-strong" | "--color-accent" | "--color-accent-text" | "--color-danger" | "--color-success" | "--color-warning" | "--color-info" | "--chart-1" | "--chart-2" | "--chart-3" | "--chart-4" | "--chart-5" | "--chart-6" | "--font-sans" | "--font-mono" | "--radius-sm" | "--radius-md" | "--radius-lg";
8
+ export type ThemeTokenInfo = {
9
+ name: ThemeTokenName;
10
+ group: "surface" | "text" | "border" | "accent" | "status" | "chart" | "type" | "shape";
11
+ usage: string;
12
+ };
13
+ /** The canonical tokens every frame defines, in prompt order. */
14
+ export declare const THEME_TOKENS: readonly ThemeTokenInfo[];
15
+ export declare const DEFAULT_LIGHT_TOKENS: ThemeTokens;
16
+ export declare const DEFAULT_DARK_TOKENS: ThemeTokens;
17
+ export declare const defaultThemeTokens: (scheme: ColorScheme) => ThemeTokens;
18
+ /**
19
+ * Where `readThemeTokens` looks for each canonical token, first match wins.
20
+ * The defaults read the canonical name, then the shadcn/ui variable.
21
+ */
22
+ export type ThemeTokenSources = Partial<Record<ThemeTokenName, string | readonly string[]>>;
23
+ export declare const DEFAULT_TOKEN_SOURCES: Record<ThemeTokenName, readonly string[]>;
24
+ /** Infers the color scheme an element renders in. */
25
+ export declare function detectColorScheme(element: Element): ColorScheme;
26
+ /**
27
+ * Reads the host page's theme into canonical tokens. Tokens the page does not
28
+ * define fall back to the built-in palette for the detected color scheme.
29
+ */
30
+ export declare function readThemeTokens(element?: Element, sources?: ThemeTokenSources): ThemeTokens;
31
+ /**
32
+ * Maps canonical tokens onto the MCP Apps standard style variables, so
33
+ * widgets written for MCP Apps hosts pick up the host theme too.
34
+ */
35
+ export declare function toMcpAppsVariables(tokens: ThemeTokens): Record<string, string>;
36
+ /** Every variable a frame receives: canonical tokens plus their MCP Apps aliases. */
37
+ export declare function themeVariables(tokens: ThemeTokens): Record<string, string>;
38
+ //# sourceMappingURL=theme.d.ts.map