handoff-app-next 2.0.0-canary.1

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 (1578) hide show
  1. package/Changelog.md +2069 -0
  2. package/License.md +19 -0
  3. package/README.md +461 -0
  4. package/components.json +21 -0
  5. package/config/config.template.js +95 -0
  6. package/config/config.template.ts +54 -0
  7. package/config/docs/design.md +14 -0
  8. package/config/docs/foundations/border-radius.md +6 -0
  9. package/config/docs/foundations/colors.md +7 -0
  10. package/config/docs/foundations/effects.md +8 -0
  11. package/config/docs/foundations/elevation.md +6 -0
  12. package/config/docs/foundations/focus.md +6 -0
  13. package/config/docs/foundations/fonts.md +7 -0
  14. package/config/docs/foundations/grid.md +21 -0
  15. package/config/docs/foundations/icon.md +6 -0
  16. package/config/docs/foundations/icons.md +6 -0
  17. package/config/docs/foundations/logo.md +7 -0
  18. package/config/docs/foundations/logos.md +7 -0
  19. package/config/docs/foundations/motion.md +6 -0
  20. package/config/docs/foundations/spacing.md +7 -0
  21. package/config/docs/foundations/typography.md +8 -0
  22. package/config/docs/foundations.md +44 -0
  23. package/config/docs/guidelines.md +11 -0
  24. package/config/docs/index.md +9 -0
  25. package/config/docs/playground.md +14 -0
  26. package/config/docs/system/figma-sync.md +14 -0
  27. package/config/docs/system/tokens/foundations/colors.md +24 -0
  28. package/config/docs/system/tokens/foundations/effects.md +21 -0
  29. package/config/docs/system/tokens/foundations/spacing.md +22 -0
  30. package/config/docs/system/tokens/foundations/typography.md +24 -0
  31. package/config/docs/system.md +13 -0
  32. package/config/templates/component/template.hbs +6 -0
  33. package/config/templates/component/template.js +0 -0
  34. package/config/templates/component/template.json +45 -0
  35. package/config/templates/component/template.scss +2 -0
  36. package/config/templates/page.md +11 -0
  37. package/config/templates/page.mdx +49 -0
  38. package/config/templates/template.html +7 -0
  39. package/dist/app/components/Component/Cards.d.ts +25 -0
  40. package/dist/app/components/Component/Cards.jsx +27 -0
  41. package/dist/app/lib/adapter-kit/types.d.ts +581 -0
  42. package/dist/app/lib/adapter-kit/types.js +36 -0
  43. package/dist/app/lib/hubspot-field-map.d.ts +170 -0
  44. package/dist/app/lib/hubspot-field-map.js +538 -0
  45. package/dist/app/lib/hubspot-module/build-module.d.ts +136 -0
  46. package/dist/app/lib/hubspot-module/build-module.js +122 -0
  47. package/dist/app/lib/hubspot-module/context.d.ts +111 -0
  48. package/dist/app/lib/hubspot-module/context.js +228 -0
  49. package/dist/app/lib/hubspot-module/fields/boolean.d.ts +8 -0
  50. package/dist/app/lib/hubspot-module/fields/boolean.js +22 -0
  51. package/dist/app/lib/hubspot-module/fields/button.d.ts +19 -0
  52. package/dist/app/lib/hubspot-module/fields/button.js +66 -0
  53. package/dist/app/lib/hubspot-module/fields/fields.d.ts +20 -0
  54. package/dist/app/lib/hubspot-module/fields/fields.js +93 -0
  55. package/dist/app/lib/hubspot-module/fields/generic.d.ts +33 -0
  56. package/dist/app/lib/hubspot-module/fields/generic.js +150 -0
  57. package/dist/app/lib/hubspot-module/fields/hubdb.d.ts +14 -0
  58. package/dist/app/lib/hubspot-module/fields/hubdb.js +155 -0
  59. package/dist/app/lib/hubspot-module/fields/image.d.ts +27 -0
  60. package/dist/app/lib/hubspot-module/fields/image.js +59 -0
  61. package/dist/app/lib/hubspot-module/fields/menu.d.ts +8 -0
  62. package/dist/app/lib/hubspot-module/fields/menu.js +12 -0
  63. package/dist/app/lib/hubspot-module/fields/object.d.ts +11 -0
  64. package/dist/app/lib/hubspot-module/fields/object.js +31 -0
  65. package/dist/app/lib/hubspot-module/fields/select.d.ts +17 -0
  66. package/dist/app/lib/hubspot-module/fields/select.js +37 -0
  67. package/dist/app/lib/hubspot-module/fields/text.d.ts +15 -0
  68. package/dist/app/lib/hubspot-module/fields/text.js +63 -0
  69. package/dist/app/lib/hubspot-module/fields/url.d.ts +35 -0
  70. package/dist/app/lib/hubspot-module/fields/url.js +57 -0
  71. package/dist/app/lib/hubspot-module/fields/utils.d.ts +20 -0
  72. package/dist/app/lib/hubspot-module/fields/utils.js +33 -0
  73. package/dist/app/lib/hubspot-module/fields/video.d.ts +21 -0
  74. package/dist/app/lib/hubspot-module/fields/video.js +70 -0
  75. package/dist/app/lib/hubspot-module/index.d.ts +20 -0
  76. package/dist/app/lib/hubspot-module/index.js +17 -0
  77. package/dist/app/lib/hubspot-module/transpile.d.ts +27 -0
  78. package/dist/app/lib/hubspot-module/transpile.js +658 -0
  79. package/dist/app/lib/hubspot-module/types.d.ts +204 -0
  80. package/dist/app/lib/hubspot-module/types.js +47 -0
  81. package/dist/app/lib/hubspot-module-build.d.ts +33 -0
  82. package/dist/app/lib/hubspot-module-build.js +41 -0
  83. package/dist/app-builder/build.d.ts +21 -0
  84. package/dist/app-builder/build.js +649 -0
  85. package/dist/app-builder/client-config.d.ts +17 -0
  86. package/dist/app-builder/client-config.js +106 -0
  87. package/dist/app-builder/config-diff/index.d.ts +4 -0
  88. package/dist/app-builder/config-diff/index.js +3 -0
  89. package/dist/app-builder/config-diff/registry.d.ts +9 -0
  90. package/dist/app-builder/config-diff/registry.js +15 -0
  91. package/dist/app-builder/config-diff/snapshot.d.ts +13 -0
  92. package/dist/app-builder/config-diff/snapshot.js +38 -0
  93. package/dist/app-builder/config-diff/strategies/pattern.d.ts +2 -0
  94. package/dist/app-builder/config-diff/strategies/pattern.js +66 -0
  95. package/dist/app-builder/config-diff/types.d.ts +33 -0
  96. package/dist/app-builder/config-diff/types.js +1 -0
  97. package/dist/app-builder/index.d.ts +6 -0
  98. package/dist/app-builder/index.js +4 -0
  99. package/dist/app-builder/path-contract.d.ts +23 -0
  100. package/dist/app-builder/path-contract.js +60 -0
  101. package/dist/app-builder/paths.d.ts +24 -0
  102. package/dist/app-builder/paths.js +82 -0
  103. package/dist/app-builder/watchers/component.d.ts +15 -0
  104. package/dist/app-builder/watchers/component.js +58 -0
  105. package/dist/app-builder/watchers/utils.d.ts +14 -0
  106. package/dist/app-builder/watchers/utils.js +31 -0
  107. package/dist/app-builder/watchers.d.ts +44 -0
  108. package/dist/app-builder/watchers.js +299 -0
  109. package/dist/app-builder/websocket.d.ts +12 -0
  110. package/dist/app-builder/websocket.js +56 -0
  111. package/dist/cache/build-cache.d.ts +169 -0
  112. package/dist/cache/build-cache.js +421 -0
  113. package/dist/cache/file-state.d.ts +58 -0
  114. package/dist/cache/file-state.js +122 -0
  115. package/dist/cache/index.d.ts +3 -0
  116. package/dist/cache/index.js +6 -0
  117. package/dist/cache/push-state.d.ts +69 -0
  118. package/dist/cache/push-state.js +156 -0
  119. package/dist/cli/create.d.ts +5 -0
  120. package/dist/cli/create.js +301 -0
  121. package/dist/cli/eject.d.ts +17 -0
  122. package/dist/cli/eject.js +82 -0
  123. package/dist/cli/fetch-design-md.d.ts +14 -0
  124. package/dist/cli/fetch-design-md.js +62 -0
  125. package/dist/cli/figma-audit.d.ts +7 -0
  126. package/dist/cli/figma-audit.js +55 -0
  127. package/dist/cli/init-claude-core.d.ts +26 -0
  128. package/dist/cli/init-claude-core.js +81 -0
  129. package/dist/cli/make.d.ts +12 -0
  130. package/dist/cli/make.js +178 -0
  131. package/dist/cli/scaffold.d.ts +5 -0
  132. package/dist/cli/scaffold.js +504 -0
  133. package/dist/cli/sync/apply-declaration-pull.d.ts +14 -0
  134. package/dist/cli/sync/apply-declaration-pull.js +184 -0
  135. package/dist/cli/sync/apply-pull.d.ts +24 -0
  136. package/dist/cli/sync/apply-pull.js +174 -0
  137. package/dist/cli/sync/cli-auth-store.d.ts +12 -0
  138. package/dist/cli/sync/cli-auth-store.js +44 -0
  139. package/dist/cli/sync/collect-build-artifacts.d.ts +17 -0
  140. package/dist/cli/sync/collect-build-artifacts.js +143 -0
  141. package/dist/cli/sync/collect-referenced-images.d.ts +36 -0
  142. package/dist/cli/sync/collect-referenced-images.js +165 -0
  143. package/dist/cli/sync/declaration-patch.d.ts +9 -0
  144. package/dist/cli/sync/declaration-patch.js +196 -0
  145. package/dist/cli/sync/hash.d.ts +2 -0
  146. package/dist/cli/sync/hash.js +11 -0
  147. package/dist/cli/sync/open-browser.d.ts +5 -0
  148. package/dist/cli/sync/open-browser.js +37 -0
  149. package/dist/cli/sync/push-provenance.d.ts +25 -0
  150. package/dist/cli/sync/push-provenance.js +82 -0
  151. package/dist/cli/sync/push-registry-content.d.ts +132 -0
  152. package/dist/cli/sync/push-registry-content.js +854 -0
  153. package/dist/cli/sync/push-shared-assets.d.ts +26 -0
  154. package/dist/cli/sync/push-shared-assets.js +33 -0
  155. package/dist/cli/sync/resolve-declaration-payload.d.ts +8 -0
  156. package/dist/cli/sync/resolve-declaration-payload.js +208 -0
  157. package/dist/cli/sync/resolve-declaration.d.ts +5 -0
  158. package/dist/cli/sync/resolve-declaration.js +12 -0
  159. package/dist/cli/sync/run-cli-login.d.ts +9 -0
  160. package/dist/cli/sync/run-cli-login.js +81 -0
  161. package/dist/cli/sync/run-history-purge.d.ts +19 -0
  162. package/dist/cli/sync/run-history-purge.js +112 -0
  163. package/dist/cli/sync/run-pull.d.ts +9 -0
  164. package/dist/cli/sync/run-pull.js +92 -0
  165. package/dist/cli/sync/run-push.d.ts +47 -0
  166. package/dist/cli/sync/run-push.js +585 -0
  167. package/dist/cli/sync/run-sync-status.d.ts +2 -0
  168. package/dist/cli/sync/run-sync-status.js +30 -0
  169. package/dist/cli/sync/sync-remote-env.d.ts +14 -0
  170. package/dist/cli/sync/sync-remote-env.js +52 -0
  171. package/dist/cli/sync/sync-state.d.ts +15 -0
  172. package/dist/cli/sync/sync-state.js +26 -0
  173. package/dist/cli/tokens/ensure-default-brand.d.ts +18 -0
  174. package/dist/cli/tokens/ensure-default-brand.js +95 -0
  175. package/dist/cli/tokens/migrate-legacy.d.ts +23 -0
  176. package/dist/cli/tokens/migrate-legacy.js +213 -0
  177. package/dist/cli/tokens/parse-css-brands.d.ts +25 -0
  178. package/dist/cli/tokens/parse-css-brands.js +148 -0
  179. package/dist/cli/tokens/transform.d.ts +12 -0
  180. package/dist/cli/tokens/transform.js +126 -0
  181. package/dist/cli.d.ts +2 -0
  182. package/dist/cli.js +56 -0
  183. package/dist/commands/audit/figma-components.d.ts +8 -0
  184. package/dist/commands/audit/figma-components.js +27 -0
  185. package/dist/commands/build/app.d.ts +8 -0
  186. package/dist/commands/build/app.js +22 -0
  187. package/dist/commands/build/components.d.ts +7 -0
  188. package/dist/commands/build/components.js +17 -0
  189. package/dist/commands/build/hubspot.d.ts +56 -0
  190. package/dist/commands/build/hubspot.js +177 -0
  191. package/dist/commands/dev/index.d.ts +6 -0
  192. package/dist/commands/dev/index.js +14 -0
  193. package/dist/commands/eject/config.d.ts +6 -0
  194. package/dist/commands/eject/config.js +14 -0
  195. package/dist/commands/eject/pages.d.ts +6 -0
  196. package/dist/commands/eject/pages.js +14 -0
  197. package/dist/commands/eject/theme.d.ts +6 -0
  198. package/dist/commands/eject/theme.js +14 -0
  199. package/dist/commands/fetch/index.d.ts +6 -0
  200. package/dist/commands/fetch/index.js +14 -0
  201. package/dist/commands/history-purge.d.ts +19 -0
  202. package/dist/commands/history-purge.js +52 -0
  203. package/dist/commands/index.d.ts +1 -0
  204. package/dist/commands/index.js +66 -0
  205. package/dist/commands/init/index.d.ts +5 -0
  206. package/dist/commands/init/index.js +12 -0
  207. package/dist/commands/init/vercel.d.ts +6 -0
  208. package/dist/commands/init/vercel.js +99 -0
  209. package/dist/commands/init-claude.d.ts +9 -0
  210. package/dist/commands/init-claude.js +47 -0
  211. package/dist/commands/login.d.ts +9 -0
  212. package/dist/commands/login.js +28 -0
  213. package/dist/commands/logout.d.ts +6 -0
  214. package/dist/commands/logout.js +16 -0
  215. package/dist/commands/make/component.d.ts +7 -0
  216. package/dist/commands/make/component.js +23 -0
  217. package/dist/commands/make/page.d.ts +8 -0
  218. package/dist/commands/make/page.js +33 -0
  219. package/dist/commands/make/template.d.ts +8 -0
  220. package/dist/commands/make/template.js +33 -0
  221. package/dist/commands/mcp-init.d.ts +12 -0
  222. package/dist/commands/mcp-init.js +94 -0
  223. package/dist/commands/mcp-token.d.ts +7 -0
  224. package/dist/commands/mcp-token.js +23 -0
  225. package/dist/commands/prepare-runtime.d.ts +7 -0
  226. package/dist/commands/prepare-runtime.js +28 -0
  227. package/dist/commands/pull.d.ts +7 -0
  228. package/dist/commands/pull.js +18 -0
  229. package/dist/commands/push-all.d.ts +23 -0
  230. package/dist/commands/push-all.js +146 -0
  231. package/dist/commands/push-assets.d.ts +8 -0
  232. package/dist/commands/push-assets.js +40 -0
  233. package/dist/commands/push-tokens.d.ts +8 -0
  234. package/dist/commands/push-tokens.js +40 -0
  235. package/dist/commands/push.d.ts +14 -0
  236. package/dist/commands/push.js +75 -0
  237. package/dist/commands/scaffold/index.d.ts +6 -0
  238. package/dist/commands/scaffold/index.js +15 -0
  239. package/dist/commands/start/index.d.ts +6 -0
  240. package/dist/commands/start/index.js +14 -0
  241. package/dist/commands/sync-status.d.ts +6 -0
  242. package/dist/commands/sync-status.js +14 -0
  243. package/dist/commands/tokens-build.d.ts +7 -0
  244. package/dist/commands/tokens-build.js +104 -0
  245. package/dist/commands/types.d.ts +5 -0
  246. package/dist/commands/types.js +1 -0
  247. package/dist/commands/utils.d.ts +18 -0
  248. package/dist/commands/utils.js +19 -0
  249. package/dist/commands/validate/components.d.ts +7 -0
  250. package/dist/commands/validate/components.js +19 -0
  251. package/dist/commands/validate.d.ts +11 -0
  252. package/dist/commands/validate.js +163 -0
  253. package/dist/commands/vercel-build.d.ts +7 -0
  254. package/dist/commands/vercel-build.js +81 -0
  255. package/dist/config/declaration-module-load.d.ts +6 -0
  256. package/dist/config/declaration-module-load.js +68 -0
  257. package/dist/config/defaults.d.ts +16 -0
  258. package/dist/config/defaults.js +60 -0
  259. package/dist/config/helpers.d.ts +7 -0
  260. package/dist/config/helpers.js +29 -0
  261. package/dist/config/index.d.ts +7 -0
  262. package/dist/config/index.js +11 -0
  263. package/dist/config/loader.d.ts +20 -0
  264. package/dist/config/loader.js +107 -0
  265. package/dist/config/normalizers/declaration.d.ts +11 -0
  266. package/dist/config/normalizers/declaration.js +122 -0
  267. package/dist/config/normalizers/pattern.d.ts +8 -0
  268. package/dist/config/normalizers/pattern.js +31 -0
  269. package/dist/config/runtime.d.ts +42 -0
  270. package/dist/config/runtime.js +337 -0
  271. package/dist/config/validator.d.ts +9 -0
  272. package/dist/config/validator.js +22 -0
  273. package/dist/declarations/codegen.d.ts +57 -0
  274. package/dist/declarations/codegen.js +279 -0
  275. package/dist/declarations/helpers.d.ts +6 -0
  276. package/dist/declarations/helpers.js +20 -0
  277. package/dist/declarations/index.d.ts +2 -0
  278. package/dist/declarations/index.js +1 -0
  279. package/dist/declarations/types.d.ts +193 -0
  280. package/dist/declarations/types.js +1 -0
  281. package/dist/figma/component-linking.d.ts +164 -0
  282. package/dist/figma/component-linking.js +1080 -0
  283. package/dist/figma/image-fills.d.ts +32 -0
  284. package/dist/figma/image-fills.js +211 -0
  285. package/dist/generated/build-meta.d.ts +4 -0
  286. package/dist/generated/build-meta.js +6 -0
  287. package/dist/index.d.ts +115 -0
  288. package/dist/index.js +301 -0
  289. package/dist/pipeline/archive.d.ts +19 -0
  290. package/dist/pipeline/archive.js +62 -0
  291. package/dist/pipeline/components.d.ts +5 -0
  292. package/dist/pipeline/components.js +7 -0
  293. package/dist/pipeline/documentation.d.ts +3 -0
  294. package/dist/pipeline/documentation.js +64 -0
  295. package/dist/pipeline/figma.d.ts +11 -0
  296. package/dist/pipeline/figma.js +142 -0
  297. package/dist/pipeline/hubspot/config.d.ts +179 -0
  298. package/dist/pipeline/hubspot/config.js +171 -0
  299. package/dist/pipeline/hubspot/emit.d.ts +101 -0
  300. package/dist/pipeline/hubspot/emit.js +283 -0
  301. package/dist/pipeline/index.d.ts +14 -0
  302. package/dist/pipeline/index.js +34 -0
  303. package/dist/pipeline/patterns.d.ts +8 -0
  304. package/dist/pipeline/patterns.js +8 -0
  305. package/dist/pipeline/styles.d.ts +10 -0
  306. package/dist/pipeline/styles.js +127 -0
  307. package/dist/pipeline/validation.d.ts +6 -0
  308. package/dist/pipeline/validation.js +23 -0
  309. package/dist/transformers/docgen/index.d.ts +24 -0
  310. package/dist/transformers/docgen/index.js +244 -0
  311. package/dist/transformers/plugins/csf-render.d.ts +5 -0
  312. package/dist/transformers/plugins/csf-render.js +406 -0
  313. package/dist/transformers/plugins/handlebars-previews.d.ts +12 -0
  314. package/dist/transformers/plugins/handlebars-previews.js +128 -0
  315. package/dist/transformers/plugins/index.d.ts +11 -0
  316. package/dist/transformers/plugins/index.js +10 -0
  317. package/dist/transformers/plugins/slot-probe-candidates.d.ts +159 -0
  318. package/dist/transformers/plugins/slot-probe-candidates.js +279 -0
  319. package/dist/transformers/plugins/slot-probe.d.ts +66 -0
  320. package/dist/transformers/plugins/slot-probe.js +298 -0
  321. package/dist/transformers/plugins/ssr-render.d.ts +33 -0
  322. package/dist/transformers/plugins/ssr-render.js +531 -0
  323. package/dist/transformers/plugins.d.ts +14 -0
  324. package/dist/transformers/plugins.js +15 -0
  325. package/dist/transformers/preview/component/api.d.ts +22 -0
  326. package/dist/transformers/preview/component/api.js +146 -0
  327. package/dist/transformers/preview/component/artifacts.d.ts +3 -0
  328. package/dist/transformers/preview/component/artifacts.js +103 -0
  329. package/dist/transformers/preview/component/build-shared-bundles.d.ts +83 -0
  330. package/dist/transformers/preview/component/build-shared-bundles.js +400 -0
  331. package/dist/transformers/preview/component/builder.d.ts +29 -0
  332. package/dist/transformers/preview/component/builder.js +638 -0
  333. package/dist/transformers/preview/component/css.d.ts +68 -0
  334. package/dist/transformers/preview/component/css.js +219 -0
  335. package/dist/transformers/preview/component/field-annotations.d.ts +129 -0
  336. package/dist/transformers/preview/component/field-annotations.js +325 -0
  337. package/dist/transformers/preview/component/html.d.ts +21 -0
  338. package/dist/transformers/preview/component/html.js +80 -0
  339. package/dist/transformers/preview/component/javascript.d.ts +24 -0
  340. package/dist/transformers/preview/component/javascript.js +162 -0
  341. package/dist/transformers/preview/component/normalizer.d.ts +35 -0
  342. package/dist/transformers/preview/component/normalizer.js +56 -0
  343. package/dist/transformers/preview/component/playwright-shared.d.ts +70 -0
  344. package/dist/transformers/preview/component/playwright-shared.js +164 -0
  345. package/dist/transformers/preview/component/preview-assets.d.ts +55 -0
  346. package/dist/transformers/preview/component/preview-assets.js +144 -0
  347. package/dist/transformers/preview/component/preview-merge.d.ts +53 -0
  348. package/dist/transformers/preview/component/preview-merge.js +50 -0
  349. package/dist/transformers/preview/component/preview-select.d.ts +86 -0
  350. package/dist/transformers/preview/component/preview-select.js +150 -0
  351. package/dist/transformers/preview/component/preview-server.d.ts +41 -0
  352. package/dist/transformers/preview/component/preview-server.js +112 -0
  353. package/dist/transformers/preview/component/preview-validation.d.ts +64 -0
  354. package/dist/transformers/preview/component/preview-validation.js +194 -0
  355. package/dist/transformers/preview/component/previews.d.ts +9 -0
  356. package/dist/transformers/preview/component/previews.js +6 -0
  357. package/dist/transformers/preview/component/screenshot.d.ts +90 -0
  358. package/dist/transformers/preview/component/screenshot.js +282 -0
  359. package/dist/transformers/preview/component/serialized-elements.d.ts +86 -0
  360. package/dist/transformers/preview/component/serialized-elements.js +118 -0
  361. package/dist/transformers/preview/component/summary.d.ts +6 -0
  362. package/dist/transformers/preview/component/summary.js +41 -0
  363. package/dist/transformers/preview/component.d.ts +13 -0
  364. package/dist/transformers/preview/component.js +26 -0
  365. package/dist/transformers/preview/height-reporter.d.ts +27 -0
  366. package/dist/transformers/preview/height-reporter.js +32 -0
  367. package/dist/transformers/preview/pattern/api.d.ts +11 -0
  368. package/dist/transformers/preview/pattern/api.js +58 -0
  369. package/dist/transformers/preview/pattern/builder.d.ts +17 -0
  370. package/dist/transformers/preview/pattern/builder.js +149 -0
  371. package/dist/transformers/preview/pattern/html.d.ts +25 -0
  372. package/dist/transformers/preview/pattern/html.js +95 -0
  373. package/dist/transformers/preview/slots.d.ts +109 -0
  374. package/dist/transformers/preview/slots.js +13 -0
  375. package/dist/transformers/preview/types.d.ts +292 -0
  376. package/dist/transformers/preview/types.js +7 -0
  377. package/dist/transformers/types.d.ts +60 -0
  378. package/dist/transformers/types.js +1 -0
  379. package/dist/transformers/utils/build.d.ts +27 -0
  380. package/dist/transformers/utils/build.js +77 -0
  381. package/dist/transformers/utils/csf.d.ts +16 -0
  382. package/dist/transformers/utils/csf.js +29 -0
  383. package/dist/transformers/utils/handlebars.d.ts +32 -0
  384. package/dist/transformers/utils/handlebars.js +73 -0
  385. package/dist/transformers/utils/html.d.ts +18 -0
  386. package/dist/transformers/utils/html.js +40 -0
  387. package/dist/transformers/utils/index.d.ts +13 -0
  388. package/dist/transformers/utils/index.js +20 -0
  389. package/dist/transformers/utils/module.d.ts +13 -0
  390. package/dist/transformers/utils/module.js +41 -0
  391. package/dist/transformers/utils/schema-loader.d.ts +19 -0
  392. package/dist/transformers/utils/schema-loader.js +61 -0
  393. package/dist/transformers/utils/schema.d.ts +33 -0
  394. package/dist/transformers/utils/schema.js +517 -0
  395. package/dist/transformers/utils/string.d.ts +36 -0
  396. package/dist/transformers/utils/string.js +52 -0
  397. package/dist/transformers/utils/svg-sprite.d.ts +16 -0
  398. package/dist/transformers/utils/svg-sprite.js +114 -0
  399. package/dist/transformers/utils/usage.d.ts +23 -0
  400. package/dist/transformers/utils/usage.js +282 -0
  401. package/dist/transformers/utils/vite-logger.d.ts +2 -0
  402. package/dist/transformers/utils/vite-logger.js +30 -0
  403. package/dist/transformers/validation/runner.d.ts +67 -0
  404. package/dist/transformers/validation/runner.js +277 -0
  405. package/dist/transformers/vite-config.d.ts +3 -0
  406. package/dist/transformers/vite-config.js +18 -0
  407. package/dist/tsconfig.tsbuildinfo +1 -0
  408. package/dist/types/config.d.ts +472 -0
  409. package/dist/types/config.js +1 -0
  410. package/dist/types/font.d.ts +3 -0
  411. package/dist/types/font.js +1 -0
  412. package/dist/types/handoff-sync.d.ts +132 -0
  413. package/dist/types/handoff-sync.js +5 -0
  414. package/dist/types/history-purge.d.ts +112 -0
  415. package/dist/types/history-purge.js +18 -0
  416. package/dist/types/icon.d.ts +8 -0
  417. package/dist/types/icon.js +1 -0
  418. package/dist/types/preview.d.ts +138 -0
  419. package/dist/types/preview.js +1 -0
  420. package/dist/types/validation.d.ts +200 -0
  421. package/dist/types/validation.js +11 -0
  422. package/dist/utils/asset-upload-limits.d.ts +87 -0
  423. package/dist/utils/asset-upload-limits.js +129 -0
  424. package/dist/utils/design-md.d.ts +55 -0
  425. package/dist/utils/design-md.js +107 -0
  426. package/dist/utils/duration.d.ts +2 -0
  427. package/dist/utils/duration.js +2 -0
  428. package/dist/utils/filter.d.ts +31 -0
  429. package/dist/utils/filter.js +109 -0
  430. package/dist/utils/fs.d.ts +8 -0
  431. package/dist/utils/fs.js +31 -0
  432. package/dist/utils/index.d.ts +6 -0
  433. package/dist/utils/index.js +6 -0
  434. package/dist/utils/line-diff.d.ts +25 -0
  435. package/dist/utils/line-diff.js +74 -0
  436. package/dist/utils/logger.d.ts +50 -0
  437. package/dist/utils/logger.js +158 -0
  438. package/dist/utils/path.d.ts +21 -0
  439. package/dist/utils/path.js +50 -0
  440. package/dist/utils/port.d.ts +15 -0
  441. package/dist/utils/port.js +38 -0
  442. package/dist/utils/rich-text.d.ts +228 -0
  443. package/dist/utils/rich-text.js +1087 -0
  444. package/dist/validators/axe.d.ts +47 -0
  445. package/dist/validators/axe.js +222 -0
  446. package/dist/validators/contrast.d.ts +33 -0
  447. package/dist/validators/contrast.js +235 -0
  448. package/dist/validators/index.d.ts +30 -0
  449. package/dist/validators/index.js +26 -0
  450. package/dist/validators/schema.d.ts +34 -0
  451. package/dist/validators/schema.js +138 -0
  452. package/docs/DEPENDENCIES.md +26 -0
  453. package/docs/DEPLOYMENT.md +110 -0
  454. package/docs/LOCAL-RIG.md +305 -0
  455. package/docs/README.md +15 -0
  456. package/docs/REGISTRY-SETUP.md +353 -0
  457. package/docs/STANDALONE-INSTALL.md +70 -0
  458. package/docs/WORKSPACE-PACKAGE-JSON.md +125 -0
  459. package/docs/api.md +657 -0
  460. package/docs/api_spec.yaml +450 -0
  461. package/docs/cli.md +86 -0
  462. package/docs/schemas/component.schema.json +167 -0
  463. package/docs/schemas/examples/button.json +83 -0
  464. package/drizzle.config.ts +10 -0
  465. package/package.json +271 -0
  466. package/postcss.config.mjs +8 -0
  467. package/scripts/assert-standalone-install.mjs +60 -0
  468. package/src/app/app/[...slug]/DocCatchAllClient.tsx +103 -0
  469. package/src/app/app/[...slug]/page.tsx +101 -0
  470. package/src/app/app/account/AccountClient.tsx +116 -0
  471. package/src/app/app/account/IntegrationsSection.tsx +273 -0
  472. package/src/app/app/account/SanityCard.tsx +473 -0
  473. package/src/app/app/account/ai-cost/page.tsx +141 -0
  474. package/src/app/app/account/appearance/AppearanceClient.tsx +433 -0
  475. package/src/app/app/account/appearance/page.tsx +52 -0
  476. package/src/app/app/account/integrations/page.tsx +37 -0
  477. package/src/app/app/account/layout.tsx +82 -0
  478. package/src/app/app/account/page.tsx +41 -0
  479. package/src/app/app/account/users/UsersClient.tsx +244 -0
  480. package/src/app/app/account/users/page.tsx +36 -0
  481. package/src/app/app/actions/ai-generate.ts +25 -0
  482. package/src/app/app/actions/components.ts +126 -0
  483. package/src/app/app/actions/patterns.ts +289 -0
  484. package/src/app/app/admin/ai-cost/AiCostClient.tsx +236 -0
  485. package/src/app/app/admin/ai-cost/page.tsx +56 -0
  486. package/src/app/app/admin/builds/BuildsClient.tsx +527 -0
  487. package/src/app/app/admin/builds/page.tsx +41 -0
  488. package/src/app/app/admin/integrations/page.tsx +32 -0
  489. package/src/app/app/admin/pages/PagesClient.tsx +282 -0
  490. package/src/app/app/admin/pages/edit/PageEditorClient.tsx +157 -0
  491. package/src/app/app/admin/pages/edit/page.tsx +48 -0
  492. package/src/app/app/admin/pages/page.tsx +31 -0
  493. package/src/app/app/admin/protection/ProtectionClient.tsx +235 -0
  494. package/src/app/app/admin/protection/page.tsx +33 -0
  495. package/src/app/app/admin/reference/ReferenceClient.tsx +150 -0
  496. package/src/app/app/admin/reference/page.tsx +38 -0
  497. package/src/app/app/admin/users/page.tsx +11 -0
  498. package/src/app/app/api/account/route.ts +36 -0
  499. package/src/app/app/api/admin/builds/status/route.ts +34 -0
  500. package/src/app/app/api/admin/cleanup-versions/route.ts +64 -0
  501. package/src/app/app/api/admin/contract-limit-audit/route.ts +126 -0
  502. package/src/app/app/api/admin/contract-render-audit/route.ts +116 -0
  503. package/src/app/app/api/admin/field-bridge-audit/route.ts +152 -0
  504. package/src/app/app/api/admin/migrate/route.ts +47 -0
  505. package/src/app/app/api/admin/playground-turns/route.ts +85 -0
  506. package/src/app/app/api/admin/purge-history/route.ts +119 -0
  507. package/src/app/app/api/auth/[...nextauth]/route.ts +30 -0
  508. package/src/app/app/api/component/[...path]/route.ts +141 -0
  509. package/src/app/app/api/component-artifact/[...path]/route.ts +18 -0
  510. package/src/app/app/api/components/route.ts +78 -0
  511. package/src/app/app/api/figma-plugin/auth/device/route.ts +40 -0
  512. package/src/app/app/api/figma-plugin/auth/revoke/route.ts +15 -0
  513. package/src/app/app/api/figma-plugin/auth/token/route.ts +50 -0
  514. package/src/app/app/api/figma-plugin/foundations/commit/route.ts +111 -0
  515. package/src/app/app/api/figma-plugin/foundations/preview/route.ts +69 -0
  516. package/src/app/app/api/figma-plugin/foundations/route.ts +49 -0
  517. package/src/app/app/api/handoff/admin/appearance/route.ts +80 -0
  518. package/src/app/app/api/handoff/admin/backfill-artifact-blobs/route.ts +48 -0
  519. package/src/app/app/api/handoff/admin/build-tasks/kill/route.ts +43 -0
  520. package/src/app/app/api/handoff/admin/build-tasks/route.ts +21 -0
  521. package/src/app/app/api/handoff/admin/invite/route.ts +18 -0
  522. package/src/app/app/api/handoff/admin/normalize-previews/route.ts +107 -0
  523. package/src/app/app/api/handoff/admin/reference-materials/route.ts +69 -0
  524. package/src/app/app/api/handoff/admin/remove/route.ts +18 -0
  525. package/src/app/app/api/handoff/admin/resend-invite/route.ts +18 -0
  526. package/src/app/app/api/handoff/admin/role/route.ts +18 -0
  527. package/src/app/app/api/handoff/admin/users/route.ts +16 -0
  528. package/src/app/app/api/handoff/ai/analyze-layout-guide/route.ts +172 -0
  529. package/src/app/app/api/handoff/ai/analyze-layout-guide/wireframe-style/wireframe-example-1.png +0 -0
  530. package/src/app/app/api/handoff/ai/analyze-layout-guide/wireframe-style/wireframe-example-2.png +0 -0
  531. package/src/app/app/api/handoff/ai/chat/route.ts +217 -0
  532. package/src/app/app/api/handoff/ai/component-screenshot/route.ts +43 -0
  533. package/src/app/app/api/handoff/ai/debug-foundation-raster/route.ts +162 -0
  534. package/src/app/app/api/handoff/ai/design-artifact/[id]/clone/route.ts +68 -0
  535. package/src/app/app/api/handoff/ai/design-artifact/[id]/public/route.ts +37 -0
  536. package/src/app/app/api/handoff/ai/design-artifact/[id]/route.ts +99 -0
  537. package/src/app/app/api/handoff/ai/design-artifact/[id]/status/route.ts +44 -0
  538. package/src/app/app/api/handoff/ai/design-artifact/route.ts +405 -0
  539. package/src/app/app/api/handoff/ai/design-artifact-extract/route.ts +37 -0
  540. package/src/app/app/api/handoff/ai/design-generation-job/[id]/route.ts +67 -0
  541. package/src/app/app/api/handoff/ai/design-generation-jobs/route.ts +23 -0
  542. package/src/app/app/api/handoff/ai/design-jobs/run/route.ts +102 -0
  543. package/src/app/app/api/handoff/ai/extract-url/route.ts +34 -0
  544. package/src/app/app/api/handoff/ai/foundation-preview/route.ts +44 -0
  545. package/src/app/app/api/handoff/ai/generate-component/route.ts +137 -0
  546. package/src/app/app/api/handoff/ai/generate-design/route.ts +210 -0
  547. package/src/app/app/api/handoff/ai/generate-image/route.ts +72 -0
  548. package/src/app/app/api/handoff/ai/generate-pattern/route.ts +86 -0
  549. package/src/app/app/api/handoff/ai/playground-chat/refine/route.ts +52 -0
  550. package/src/app/app/api/handoff/ai/playground-chat/route.ts +102 -0
  551. package/src/app/app/api/handoff/ai/status/route.ts +14 -0
  552. package/src/app/app/api/handoff/artifact-asset/route.ts +88 -0
  553. package/src/app/app/api/handoff/assets/[id]/raw/route.ts +49 -0
  554. package/src/app/app/api/handoff/assets/[id]/route.ts +76 -0
  555. package/src/app/app/api/handoff/assets/collections/route.ts +54 -0
  556. package/src/app/app/api/handoff/assets/confirm/route.ts +80 -0
  557. package/src/app/app/api/handoff/assets/icon-sets/route.ts +47 -0
  558. package/src/app/app/api/handoff/assets/presign/route.ts +41 -0
  559. package/src/app/app/api/handoff/assets/route.ts +89 -0
  560. package/src/app/app/api/handoff/assets/upload/route.ts +152 -0
  561. package/src/app/app/api/handoff/assets/usages/[id]/route.ts +21 -0
  562. package/src/app/app/api/handoff/assets/usages/route.ts +69 -0
  563. package/src/app/app/api/handoff/auth/request-reset/route.ts +9 -0
  564. package/src/app/app/api/handoff/auth/reset-password/route.ts +17 -0
  565. package/src/app/app/api/handoff/capture/health/route.ts +86 -0
  566. package/src/app/app/api/handoff/capture/jobs/route.ts +75 -0
  567. package/src/app/app/api/handoff/capture/run/route.ts +112 -0
  568. package/src/app/app/api/handoff/changelog/pushes/route.ts +49 -0
  569. package/src/app/app/api/handoff/changelog/route.ts +28 -0
  570. package/src/app/app/api/handoff/changes/why/route.ts +41 -0
  571. package/src/app/app/api/handoff/cms/connections/route.ts +182 -0
  572. package/src/app/app/api/handoff/cms/sanity/callback/route.ts +18 -0
  573. package/src/app/app/api/handoff/cms/sanity/categories/route.ts +146 -0
  574. package/src/app/app/api/handoff/cms/sanity/connect/route.ts +15 -0
  575. package/src/app/app/api/handoff/cms/sanity/publish/route.ts +161 -0
  576. package/src/app/app/api/handoff/cms/sanity/token/route.ts +87 -0
  577. package/src/app/app/api/handoff/components/[id]/screenshot.png/route.ts +101 -0
  578. package/src/app/app/api/handoff/components/[id]/thumbnail.svg/route.ts +158 -0
  579. package/src/app/app/api/handoff/components/build/route.ts +26 -0
  580. package/src/app/app/api/handoff/components/history/contract/route.ts +33 -0
  581. package/src/app/app/api/handoff/components/history/route.ts +35 -0
  582. package/src/app/app/api/handoff/components/history/version/route.ts +36 -0
  583. package/src/app/app/api/handoff/components/route.ts +56 -0
  584. package/src/app/app/api/handoff/components/validation/route.ts +36 -0
  585. package/src/app/app/api/handoff/design/workspace/brand-imagery-image/route.ts +75 -0
  586. package/src/app/app/api/handoff/design/workspace/route.ts +163 -0
  587. package/src/app/app/api/handoff/figma/component-properties/route.ts +34 -0
  588. package/src/app/app/api/handoff/figma/components/route.ts +21 -0
  589. package/src/app/app/api/handoff/figma/components/sync/route.ts +50 -0
  590. package/src/app/app/api/handoff/figma/fetch/route.ts +126 -0
  591. package/src/app/app/api/handoff/guest/assets/route.ts +52 -0
  592. package/src/app/app/api/handoff/guest/enter/route.ts +169 -0
  593. package/src/app/app/api/handoff/guest/submission/route.ts +209 -0
  594. package/src/app/app/api/handoff/guest/submission/submit/route.ts +63 -0
  595. package/src/app/app/api/handoff/image-slots/route.ts +24 -0
  596. package/src/app/app/api/handoff/navigation/prune/route.ts +106 -0
  597. package/src/app/app/api/handoff/pages/route.ts +90 -0
  598. package/src/app/app/api/handoff/patterns/[id]/clone/route.ts +69 -0
  599. package/src/app/app/api/handoff/patterns/[id]/manifest/route.ts +102 -0
  600. package/src/app/app/api/handoff/patterns/[id]/notes/route.ts +101 -0
  601. package/src/app/app/api/handoff/patterns/[id]/route.ts +41 -0
  602. package/src/app/app/api/handoff/patterns/[id]/thumbnail.svg/route.ts +70 -0
  603. package/src/app/app/api/handoff/patterns/route.ts +77 -0
  604. package/src/app/app/api/handoff/reference-materials/route.ts +40 -0
  605. package/src/app/app/api/handoff/review/[id]/route.ts +172 -0
  606. package/src/app/app/api/handoff/review/[id]/voice/route.ts +58 -0
  607. package/src/app/app/api/handoff/review/route.ts +31 -0
  608. package/src/app/app/api/handoff/share/[token]/route.ts +82 -0
  609. package/src/app/app/api/handoff/share/links/route.ts +48 -0
  610. package/src/app/app/api/handoff/share/route.ts +172 -0
  611. package/src/app/app/api/handoff/site-protection/route.ts +85 -0
  612. package/src/app/app/api/handoff/site-protection/unlock/route.ts +62 -0
  613. package/src/app/app/api/handoff/templates/[id]/submissions/route.ts +41 -0
  614. package/src/app/app/api/mcp/route.ts +39 -0
  615. package/src/app/app/api/oauth/authorization-server-metadata/route.ts +30 -0
  616. package/src/app/app/api/oauth/authorize/route.ts +158 -0
  617. package/src/app/app/api/oauth/device/approve/route.ts +32 -0
  618. package/src/app/app/api/oauth/device/route.ts +34 -0
  619. package/src/app/app/api/oauth/protected-resource-metadata/route.ts +26 -0
  620. package/src/app/app/api/oauth/register/route.ts +43 -0
  621. package/src/app/app/api/oauth/token/route.ts +94 -0
  622. package/src/app/app/api/openapi/route.ts +38 -0
  623. package/src/app/app/api/patterns/route.ts +8 -0
  624. package/src/app/app/api/registry/assets/ingest/route.ts +204 -0
  625. package/src/app/app/api/registry/assets/ingest-figma-fills/route.ts +81 -0
  626. package/src/app/app/api/registry/components/[id]/previews/[previewId]/route.ts +56 -0
  627. package/src/app/app/api/registry/components/[id]/previews/route.ts +66 -0
  628. package/src/app/app/api/registry/config/route.ts +50 -0
  629. package/src/app/app/api/registry/dtcg/download/route.ts +78 -0
  630. package/src/app/app/api/registry/dtcg/route.ts +133 -0
  631. package/src/app/app/api/registry/fonts/route.ts +67 -0
  632. package/src/app/app/api/registry/icons/download/route.ts +52 -0
  633. package/src/app/app/api/registry/icons/route.ts +47 -0
  634. package/src/app/app/api/registry/image-slots/route.ts +68 -0
  635. package/src/app/app/api/registry/logo.svg/route.ts +45 -0
  636. package/src/app/app/api/registry/logos/route.ts +47 -0
  637. package/src/app/app/api/registry/navigation/route.ts +52 -0
  638. package/src/app/app/api/registry/pages/route.ts +67 -0
  639. package/src/app/app/api/registry/theme/route.ts +51 -0
  640. package/src/app/app/api/registry/theme.css/route.ts +34 -0
  641. package/src/app/app/api/registry/tokens/route.ts +59 -0
  642. package/src/app/app/api/sync/changes/route.ts +24 -0
  643. package/src/app/app/api/sync/shared-assets/route.ts +79 -0
  644. package/src/app/app/api/sync/status/route.ts +12 -0
  645. package/src/app/app/api/sync/upload/route.ts +109 -0
  646. package/src/app/app/assets/AssetsClient.tsx +670 -0
  647. package/src/app/app/assets/[id]/AssetDetailClient.tsx +319 -0
  648. package/src/app/app/assets/[id]/page.tsx +8 -0
  649. package/src/app/app/assets/fonts/page.tsx +5 -0
  650. package/src/app/app/assets/logos/page.tsx +5 -0
  651. package/src/app/app/assets/page.tsx +5 -0
  652. package/src/app/app/cli/device/CliDeviceClient.tsx +104 -0
  653. package/src/app/app/cli/device/page.tsx +45 -0
  654. package/src/app/app/design/DesignClient.tsx +1682 -0
  655. package/src/app/app/design/SessionHistoryPanel.tsx +116 -0
  656. package/src/app/app/design/assets/[id]/page.tsx +11 -0
  657. package/src/app/app/design/assets/icons/page.tsx +8 -0
  658. package/src/app/app/design/assets/page.tsx +8 -0
  659. package/src/app/app/design/library/[id]/SavedDesignDetailClient.tsx +892 -0
  660. package/src/app/app/design/library/[id]/page.tsx +40 -0
  661. package/src/app/app/design/library/[id]/share/SharePublicClient.tsx +107 -0
  662. package/src/app/app/design/library/[id]/share/page.tsx +22 -0
  663. package/src/app/app/design/library/page.tsx +12 -0
  664. package/src/app/app/design/page.tsx +158 -0
  665. package/src/app/app/design/settings/SettingsClient.tsx +648 -0
  666. package/src/app/app/design/settings/page.tsx +41 -0
  667. package/src/app/app/design/settings/settings-constants.ts +96 -0
  668. package/src/app/app/design/v1/DesignClient.tsx +1316 -0
  669. package/src/app/app/design/v1/page.tsx +103 -0
  670. package/src/app/app/design/workbench-session.ts +54 -0
  671. package/src/app/app/design/workbench-types.ts +72 -0
  672. package/src/app/app/dev/local-setup/LocalSetupClient.tsx +119 -0
  673. package/src/app/app/dev/local-setup/McpSetupSection.tsx +174 -0
  674. package/src/app/app/dev/local-setup/page.tsx +5 -0
  675. package/src/app/app/developer/api/route.ts +13 -0
  676. package/src/app/app/developer/cli/page.tsx +192 -0
  677. package/src/app/app/developer/layout.tsx +57 -0
  678. package/src/app/app/developer/local-setup/page.tsx +37 -0
  679. package/src/app/app/developer/mcp/page.tsx +74 -0
  680. package/src/app/app/developer/page.tsx +111 -0
  681. package/src/app/app/developer/push-pull/page.tsx +130 -0
  682. package/src/app/app/fonts/[filename]/route.ts +41 -0
  683. package/src/app/app/foundations/[...slug]/page.tsx +83 -0
  684. package/src/app/app/foundations/assets/[id]/page.tsx +35 -0
  685. package/src/app/app/foundations/assets/page.tsx +31 -0
  686. package/src/app/app/foundations/border-radius/page.tsx +179 -0
  687. package/src/app/app/foundations/colors/page.tsx +166 -0
  688. package/src/app/app/foundations/effects/page.tsx +124 -0
  689. package/src/app/app/foundations/elevation/page.tsx +209 -0
  690. package/src/app/app/foundations/error.tsx +22 -0
  691. package/src/app/app/foundations/grid/page.tsx +315 -0
  692. package/src/app/app/foundations/icons/IconsPageClient.tsx +100 -0
  693. package/src/app/app/foundations/icons/[name]/SingleIconClient.tsx +231 -0
  694. package/src/app/app/foundations/icons/[name]/page.tsx +44 -0
  695. package/src/app/app/foundations/icons/page.tsx +58 -0
  696. package/src/app/app/foundations/logo/page.tsx +213 -0
  697. package/src/app/app/foundations/motion/page.tsx +228 -0
  698. package/src/app/app/foundations/page.tsx +65 -0
  699. package/src/app/app/foundations/spacing/page.tsx +171 -0
  700. package/src/app/app/foundations/typography/page.tsx +115 -0
  701. package/src/app/app/layout.tsx +131 -0
  702. package/src/app/app/library/LibraryClient.tsx +567 -0
  703. package/src/app/app/library/page.tsx +46 -0
  704. package/src/app/app/login/LoginClient.tsx +75 -0
  705. package/src/app/app/login/page.tsx +33 -0
  706. package/src/app/app/page.tsx +178 -0
  707. package/src/app/app/patterns/PatternBrowserClient.tsx +263 -0
  708. package/src/app/app/patterns/page.tsx +14 -0
  709. package/src/app/app/playground/PlaygroundClient.tsx +84 -0
  710. package/src/app/app/playground/[id]/page.tsx +215 -0
  711. package/src/app/app/playground/page.tsx +79 -0
  712. package/src/app/app/providers.tsx +72 -0
  713. package/src/app/app/reset-password/ResetPasswordClient.tsx +89 -0
  714. package/src/app/app/reset-password/page.tsx +24 -0
  715. package/src/app/app/review/ReviewClient.tsx +31 -0
  716. package/src/app/app/review/page.tsx +56 -0
  717. package/src/app/app/s/[token]/page.tsx +317 -0
  718. package/src/app/app/setup/SetupClient.tsx +87 -0
  719. package/src/app/app/setup/actions.ts +53 -0
  720. package/src/app/app/setup/page.tsx +28 -0
  721. package/src/app/app/system/FigmaFetchControls.tsx +163 -0
  722. package/src/app/app/system/FigmaSyncPanel.tsx +357 -0
  723. package/src/app/app/system/NewComponentForm.tsx +272 -0
  724. package/src/app/app/system/SystemPageClient.tsx +137 -0
  725. package/src/app/app/system/changelog/ChangelogClient.tsx +608 -0
  726. package/src/app/app/system/changelog/page.tsx +28 -0
  727. package/src/app/app/system/component/[component]/ComponentAssetsPanel.tsx +108 -0
  728. package/src/app/app/system/component/[component]/ComponentDetailClient.tsx +420 -0
  729. package/src/app/app/system/component/[component]/ComponentImageSlotsPanel.tsx +163 -0
  730. package/src/app/app/system/component/[component]/ComponentVersionHistory.tsx +430 -0
  731. package/src/app/app/system/component/[component]/VersionCompare.tsx +267 -0
  732. package/src/app/app/system/component/[component]/page.tsx +68 -0
  733. package/src/app/app/system/component/page.tsx +5 -0
  734. package/src/app/app/system/figma-sync/FigmaSyncPageClient.tsx +35 -0
  735. package/src/app/app/system/figma-sync/page.tsx +21 -0
  736. package/src/app/app/system/health/ComponentHealthTable.tsx +217 -0
  737. package/src/app/app/system/health/HealthDashboardClient.tsx +141 -0
  738. package/src/app/app/system/health/RuleBreakdownTable.tsx +123 -0
  739. package/src/app/app/system/health/ScoreBadge.tsx +58 -0
  740. package/src/app/app/system/health/TrendChart.tsx +76 -0
  741. package/src/app/app/system/health/ValidatorBreakdownBars.tsx +35 -0
  742. package/src/app/app/system/health/health-types.ts +7 -0
  743. package/src/app/app/system/health/page.tsx +100 -0
  744. package/src/app/app/system/page.tsx +21 -0
  745. package/src/app/app/system/pattern/[pattern]/PatternDetailClient.tsx +216 -0
  746. package/src/app/app/system/pattern/[pattern]/page.tsx +53 -0
  747. package/src/app/app/system/pattern/page.tsx +5 -0
  748. package/src/app/app/unlock/UnlockClient.tsx +100 -0
  749. package/src/app/app/unlock/page.tsx +40 -0
  750. package/src/app/components/Auth/AuthControls.tsx +146 -0
  751. package/src/app/components/Brief/BuildList.tsx +78 -0
  752. package/src/app/components/Brief/BuildPanel.tsx +460 -0
  753. package/src/app/components/Brief/export-blocks.ts +47 -0
  754. package/src/app/components/Chat/ChatActionCard.tsx +97 -0
  755. package/src/app/components/Chat/ChatChangelogFeed.tsx +252 -0
  756. package/src/app/components/Chat/ChatComponentGrid.tsx +144 -0
  757. package/src/app/components/Chat/ChatContext.tsx +192 -0
  758. package/src/app/components/Chat/ChatDrawer.tsx +162 -0
  759. package/src/app/components/Chat/ChatFab.tsx +41 -0
  760. package/src/app/components/Chat/ChatInput.tsx +150 -0
  761. package/src/app/components/Chat/ChatMessage.tsx +125 -0
  762. package/src/app/components/Chat/ChatValidationPanel.tsx +161 -0
  763. package/src/app/components/CloudFeatureGate.tsx +27 -0
  764. package/src/app/components/Component/BestPracticesCard.tsx +36 -0
  765. package/src/app/components/Component/Cards.tsx +76 -0
  766. package/src/app/components/Component/ComponentLists.tsx +279 -0
  767. package/src/app/components/Component/ComponentWorkbenchDialog.tsx +230 -0
  768. package/src/app/components/Component/InlineComponentEditor.tsx +163 -0
  769. package/src/app/components/Component/PageSliceResolver.tsx +81 -0
  770. package/src/app/components/Component/Preview.tsx +1091 -0
  771. package/src/app/components/Component/slices/BestPracticesSlice.tsx +14 -0
  772. package/src/app/components/Component/slices/CardsSlice.tsx +17 -0
  773. package/src/app/components/Component/slices/ComponentDisplaySlice.tsx +101 -0
  774. package/src/app/components/Component/slices/PropertiesSlice.tsx +24 -0
  775. package/src/app/components/Component/slices/TextSlice.tsx +23 -0
  776. package/src/app/components/Component/slices/ValidationResultsSlice.tsx +31 -0
  777. package/src/app/components/Component/slices/index.ts +14 -0
  778. package/src/app/components/Component/usePreviews.ts +97 -0
  779. package/src/app/components/ComponentDesignTokens.tsx +271 -0
  780. package/src/app/components/ComponentGuidelines.tsx +21 -0
  781. package/src/app/components/ComponentNotFound.tsx +35 -0
  782. package/src/app/components/ComponentSearch.tsx +96 -0
  783. package/src/app/components/CopyCode.tsx +59 -0
  784. package/src/app/components/CopyToClipboard.tsx +63 -0
  785. package/src/app/components/Design/DevHandoffPanel.tsx +481 -0
  786. package/src/app/components/DownloadTokens.tsx +78 -0
  787. package/src/app/components/Footer.tsx +46 -0
  788. package/src/app/components/Foundations/BrandColorSwatches.tsx +151 -0
  789. package/src/app/components/Foundations/ColorContrast.tsx +179 -0
  790. package/src/app/components/Foundations/ColorGrid.tsx +199 -0
  791. package/src/app/components/Foundations/ColorInfo.tsx +64 -0
  792. package/src/app/components/Foundations/ColorSpaces.tsx +119 -0
  793. package/src/app/components/Foundations/ColorTailwind.tsx +58 -0
  794. package/src/app/components/Foundations/ColorsDisplay.tsx +136 -0
  795. package/src/app/components/Foundations/DisplayLogo.tsx +16 -0
  796. package/src/app/components/Foundations/IconCatalogGrid.tsx +145 -0
  797. package/src/app/components/Foundations/ProvenanceBadge.tsx +40 -0
  798. package/src/app/components/Foundations/RulesSheet.tsx +204 -0
  799. package/src/app/components/Foundations/TokenOutputTabs.tsx +88 -0
  800. package/src/app/components/Foundations/TypographyExample.tsx +275 -0
  801. package/src/app/components/Guest/GuestAuthoring.tsx +589 -0
  802. package/src/app/components/Guest/GuestEditor.tsx +157 -0
  803. package/src/app/components/Hero.tsx +42 -0
  804. package/src/app/components/InlineEdit/InlineEditField.tsx +162 -0
  805. package/src/app/components/InlineEdit/InlineEditHeader.tsx +98 -0
  806. package/src/app/components/Layout/BuildBadge.tsx +90 -0
  807. package/src/app/components/Layout/Header.tsx +54 -0
  808. package/src/app/components/Layout/Main.tsx +84 -0
  809. package/src/app/components/Markdown/CodeHighlight.tsx +328 -0
  810. package/src/app/components/Markdown/MarkdownComponents.tsx +270 -0
  811. package/src/app/components/Markdown/MarkdownEditor.tsx +153 -0
  812. package/src/app/components/Markdown/WysiwygEditor.tsx +364 -0
  813. package/src/app/components/Markdown/wysiwyg.css +89 -0
  814. package/src/app/components/ModeSwitcher.tsx +29 -0
  815. package/src/app/components/NavLink.tsx +26 -0
  816. package/src/app/components/Navigation/AnchorNav.tsx +94 -0
  817. package/src/app/components/Navigation/AnchorNavLink.tsx +41 -0
  818. package/src/app/components/Navigation/AnchorNavNew.tsx +27 -0
  819. package/src/app/components/Navigation/MainNav.tsx +84 -0
  820. package/src/app/components/Navigation/MobileNav.tsx +123 -0
  821. package/src/app/components/Navigation/PrevNextNav.tsx +53 -0
  822. package/src/app/components/Navigation/SideNav.tsx +336 -0
  823. package/src/app/components/Navigation/anchor-slugify.ts +6 -0
  824. package/src/app/components/Playground/AiChatPanel.tsx +1483 -0
  825. package/src/app/components/Playground/ComponentCard.tsx +65 -0
  826. package/src/app/components/Playground/ComponentLibrary.tsx +228 -0
  827. package/src/app/components/Playground/CoverImagePicker.tsx +281 -0
  828. package/src/app/components/Playground/EditContext.tsx +247 -0
  829. package/src/app/components/Playground/EditSheet.tsx +82 -0
  830. package/src/app/components/Playground/FieldGuardrailsContext.ts +31 -0
  831. package/src/app/components/Playground/FieldLinkContext.ts +138 -0
  832. package/src/app/components/Playground/FieldMediaContext.ts +50 -0
  833. package/src/app/components/Playground/FindingsList.tsx +149 -0
  834. package/src/app/components/Playground/MediaBrowser.tsx +397 -0
  835. package/src/app/components/Playground/PageChecks.tsx +71 -0
  836. package/src/app/components/Playground/PageTitle.tsx +93 -0
  837. package/src/app/components/Playground/PlaygroundBuilder.tsx +1271 -0
  838. package/src/app/components/Playground/PlaygroundContext.tsx +990 -0
  839. package/src/app/components/Playground/PlaygroundWorkbench.tsx +260 -0
  840. package/src/app/components/Playground/Preview.tsx +1465 -0
  841. package/src/app/components/Playground/PublishToSanityDialog.tsx +468 -0
  842. package/src/app/components/Playground/SavePatternDialog.tsx +231 -0
  843. package/src/app/components/Playground/ShareTemplate.tsx +503 -0
  844. package/src/app/components/Playground/SortableItem.tsx +94 -0
  845. package/src/app/components/Playground/Wizard/ApiKeySettings.tsx +139 -0
  846. package/src/app/components/Playground/Wizard/PageImporter.tsx +384 -0
  847. package/src/app/components/Playground/Wizard/WizardDialog.tsx +329 -0
  848. package/src/app/components/Playground/Wizard/llm-client.ts +87 -0
  849. package/src/app/components/Playground/Wizard/prompt-builder.ts +134 -0
  850. package/src/app/components/Playground/Wizard/response-parser.ts +80 -0
  851. package/src/app/components/Playground/fields/ButtonField.tsx +24 -0
  852. package/src/app/components/Playground/fields/Field.tsx +344 -0
  853. package/src/app/components/Playground/fields/FieldLabel.tsx +9 -0
  854. package/src/app/components/Playground/fields/FunctionField.tsx +19 -0
  855. package/src/app/components/Playground/fields/ImageField.tsx +239 -0
  856. package/src/app/components/Playground/fields/LinkField.tsx +24 -0
  857. package/src/app/components/Playground/fields/RawJsonField.tsx +60 -0
  858. package/src/app/components/Playground/fields/RichTextField.tsx +220 -0
  859. package/src/app/components/Playground/fields/SelectField.tsx +55 -0
  860. package/src/app/components/Playground/fields/SlotField.tsx +40 -0
  861. package/src/app/components/Playground/fields/TextField.tsx +125 -0
  862. package/src/app/components/Playground/fields/VideoFileField.tsx +67 -0
  863. package/src/app/components/Playground/fields/content-only.ts +121 -0
  864. package/src/app/components/Playground/fields/field-type.ts +84 -0
  865. package/src/app/components/Playground/fields/reseed.ts +140 -0
  866. package/src/app/components/Playground/inline-edit-script.ts +596 -0
  867. package/src/app/components/Playground/link-guard-script.ts +50 -0
  868. package/src/app/components/Playground/types.ts +76 -0
  869. package/src/app/components/Playground/usePublishToSanity.ts +153 -0
  870. package/src/app/components/Review/ReviewQueueClient.tsx +288 -0
  871. package/src/app/components/SideNav/Custom.tsx +40 -0
  872. package/src/app/components/SideNavNew.tsx +280 -0
  873. package/src/app/components/Typography/Headers.tsx +50 -0
  874. package/src/app/components/Validation/ValidationFrameworkResults.tsx +208 -0
  875. package/src/app/components/Validation/ValidationResults.tsx +60 -0
  876. package/src/app/components/cards/CardsWithIcons.tsx +38 -0
  877. package/src/app/components/context/AuthUiContext.tsx +13 -0
  878. package/src/app/components/context/ConfigContext.tsx +43 -0
  879. package/src/app/components/context/HandoffCapabilitiesContext.tsx +40 -0
  880. package/src/app/components/context/HotReloadProvider.tsx +38 -0
  881. package/src/app/components/context/PreviewContext.tsx +135 -0
  882. package/src/app/components/library/AssetCard.tsx +166 -0
  883. package/src/app/components/library/KindPicker.tsx +66 -0
  884. package/src/app/components/library/LaneTabs.tsx +54 -0
  885. package/src/app/components/library/LifecycleBadge.tsx +28 -0
  886. package/src/app/components/library/LifecyclePicker.tsx +53 -0
  887. package/src/app/components/library/MetaControl.tsx +294 -0
  888. package/src/app/components/library/OwnerAttribution.tsx +106 -0
  889. package/src/app/components/library/PageNotes.tsx +191 -0
  890. package/src/app/components/library/PageOrigin.tsx +124 -0
  891. package/src/app/components/library/VisibilityBadge.tsx +25 -0
  892. package/src/app/components/library/VisibilityPicker.tsx +56 -0
  893. package/src/app/components/library/index.ts +7 -0
  894. package/src/app/components/ui/accordion.tsx +49 -0
  895. package/src/app/components/ui/alert.tsx +39 -0
  896. package/src/app/components/ui/attachment.tsx +204 -0
  897. package/src/app/components/ui/badge.tsx +32 -0
  898. package/src/app/components/ui/breadcrumb.tsx +68 -0
  899. package/src/app/components/ui/bubble.tsx +125 -0
  900. package/src/app/components/ui/button.tsx +45 -0
  901. package/src/app/components/ui/card.tsx +76 -0
  902. package/src/app/components/ui/collapsible.tsx +9 -0
  903. package/src/app/components/ui/dialog.tsx +80 -0
  904. package/src/app/components/ui/drawer.tsx +103 -0
  905. package/src/app/components/ui/dropdown-menu.tsx +176 -0
  906. package/src/app/components/ui/input.tsx +22 -0
  907. package/src/app/components/ui/json-tree-view.tsx +250 -0
  908. package/src/app/components/ui/label.tsx +24 -0
  909. package/src/app/components/ui/marker.tsx +69 -0
  910. package/src/app/components/ui/message-scroller.tsx +130 -0
  911. package/src/app/components/ui/message.tsx +92 -0
  912. package/src/app/components/ui/mobile-nav.tsx +95 -0
  913. package/src/app/components/ui/navigation-menu.tsx +116 -0
  914. package/src/app/components/ui/popover.tsx +31 -0
  915. package/src/app/components/ui/radio-group.tsx +36 -0
  916. package/src/app/components/ui/select.tsx +132 -0
  917. package/src/app/components/ui/separator.tsx +29 -0
  918. package/src/app/components/ui/sheet.tsx +140 -0
  919. package/src/app/components/ui/sidebar.tsx +609 -0
  920. package/src/app/components/ui/skeleton.tsx +15 -0
  921. package/src/app/components/ui/switch.tsx +29 -0
  922. package/src/app/components/ui/table.tsx +60 -0
  923. package/src/app/components/ui/tabs.tsx +53 -0
  924. package/src/app/components/ui/textarea.tsx +19 -0
  925. package/src/app/components/ui/toggle-group.tsx +51 -0
  926. package/src/app/components/ui/toggle.tsx +39 -0
  927. package/src/app/components/ui/tooltip.tsx +30 -0
  928. package/src/app/components/util/colors.ts +93 -0
  929. package/src/app/components/util/dtcg.ts +50 -0
  930. package/src/app/components/util/index.ts +963 -0
  931. package/src/app/components/util/theme-provider.tsx +11 -0
  932. package/src/app/components/util/token.ts +70 -0
  933. package/src/app/components.json +21 -0
  934. package/src/app/css/index.css +275 -0
  935. package/src/app/css/theme.css +14 -0
  936. package/src/app/css.d.ts +1 -0
  937. package/src/app/hooks/use-mobile.tsx +17 -0
  938. package/src/app/instrumentation.ts +39 -0
  939. package/src/app/lib/adapter-kit/errors.ts +141 -0
  940. package/src/app/lib/adapter-kit/types.ts +637 -0
  941. package/src/app/lib/admin-build-tasks-types.ts +41 -0
  942. package/src/app/lib/api-path.ts +12 -0
  943. package/src/app/lib/asset-search.ts +167 -0
  944. package/src/app/lib/asset-types.ts +88 -0
  945. package/src/app/lib/asset-upload-source.ts +314 -0
  946. package/src/app/lib/auth.ts +244 -0
  947. package/src/app/lib/authoring-guardrails.ts +591 -0
  948. package/src/app/lib/authoring-shapes.ts +261 -0
  949. package/src/app/lib/authz/guest.ts +131 -0
  950. package/src/app/lib/authz/notes.ts +102 -0
  951. package/src/app/lib/authz/policy.ts +228 -0
  952. package/src/app/lib/authz/review.ts +180 -0
  953. package/src/app/lib/authz/vocab.ts +175 -0
  954. package/src/app/lib/brief-components.ts +212 -0
  955. package/src/app/lib/build-audits.ts +239 -0
  956. package/src/app/lib/capture-chromium-plan.ts +123 -0
  957. package/src/app/lib/capture-determinism.ts +397 -0
  958. package/src/app/lib/capture-kinds.ts +207 -0
  959. package/src/app/lib/change-digest.ts +108 -0
  960. package/src/app/lib/chat-turn-guards.ts +149 -0
  961. package/src/app/lib/cli-sync-jwt.ts +110 -0
  962. package/src/app/lib/client/poll-generation-job.ts +85 -0
  963. package/src/app/lib/client-name.ts +29 -0
  964. package/src/app/lib/cms-migration-prompt.ts +99 -0
  965. package/src/app/lib/component-capture.ts +156 -0
  966. package/src/app/lib/component-id.ts +14 -0
  967. package/src/app/lib/component-thumbnail.ts +200 -0
  968. package/src/app/lib/composition-summary.ts +84 -0
  969. package/src/app/lib/content-length-plan.ts +512 -0
  970. package/src/app/lib/contract-limit-audit.ts +228 -0
  971. package/src/app/lib/contract-render-audit.ts +208 -0
  972. package/src/app/lib/data/component-row.ts +121 -0
  973. package/src/app/lib/data/components-digest.ts +116 -0
  974. package/src/app/lib/data/dynamic-provider.ts +765 -0
  975. package/src/app/lib/data/has-payload.ts +18 -0
  976. package/src/app/lib/data/hybrid-provider.ts +6 -0
  977. package/src/app/lib/data/index.ts +45 -0
  978. package/src/app/lib/data/menu-merge.ts +417 -0
  979. package/src/app/lib/data/page-metadata.ts +85 -0
  980. package/src/app/lib/data/pattern-merge.ts +78 -0
  981. package/src/app/lib/data/static-provider.ts +237 -0
  982. package/src/app/lib/data/types.ts +125 -0
  983. package/src/app/lib/db/auto-migrate.ts +205 -0
  984. package/src/app/lib/db/bootstrap-admin.ts +45 -0
  985. package/src/app/lib/db/capture-job-queries.ts +333 -0
  986. package/src/app/lib/db/changelog-queries.ts +623 -0
  987. package/src/app/lib/db/cms-connection-config.ts +21 -0
  988. package/src/app/lib/db/cms-connection-queries.ts +218 -0
  989. package/src/app/lib/db/component-artifact-queries.ts +115 -0
  990. package/src/app/lib/db/component-facets.ts +535 -0
  991. package/src/app/lib/db/component-preview-queries.ts +224 -0
  992. package/src/app/lib/db/component-version-queries.ts +682 -0
  993. package/src/app/lib/db/dialect.ts +15 -0
  994. package/src/app/lib/db/event-log-store.ts +47 -0
  995. package/src/app/lib/db/grant-queries.ts +827 -0
  996. package/src/app/lib/db/history-purge-plan.ts +446 -0
  997. package/src/app/lib/db/history-purge.ts +233 -0
  998. package/src/app/lib/db/index.ts +92 -0
  999. package/src/app/lib/db/migrations/0000_init.sql +226 -0
  1000. package/src/app/lib/db/migrations/0001_design_workspace.sql +12 -0
  1001. package/src/app/lib/db/migrations/0002_boring_ricochet.sql +50 -0
  1002. package/src/app/lib/db/migrations/0003_demonic_flatman.sql +41 -0
  1003. package/src/app/lib/db/migrations/0004_validation_runs.sql +18 -0
  1004. package/src/app/lib/db/migrations/0005_component_versions.sql +21 -0
  1005. package/src/app/lib/db/migrations/0006_token_and_page_changes.sql +40 -0
  1006. package/src/app/lib/db/migrations/0007_design_spec.sql +9 -0
  1007. package/src/app/lib/db/migrations/0008_design_generation_jobs.sql +22 -0
  1008. package/src/app/lib/db/migrations/0009_assets.sql +80 -0
  1009. package/src/app/lib/db/migrations/0010_registry_dtcg.sql +13 -0
  1010. package/src/app/lib/db/migrations/0011_dtcg_brands.sql +5 -0
  1011. package/src/app/lib/db/migrations/0012_icon_logo_registry.sql +13 -0
  1012. package/src/app/lib/db/migrations/0013_registry_fonts.sql +13 -0
  1013. package/src/app/lib/db/migrations/0014_asset_blobs.sql +9 -0
  1014. package/src/app/lib/db/migrations/0015_appearance.sql +7 -0
  1015. package/src/app/lib/db/migrations/0016_image_slots.sql +16 -0
  1016. package/src/app/lib/db/migrations/0017_component_preview.sql +20 -0
  1017. package/src/app/lib/db/migrations/0018_token_change_details.sql +26 -0
  1018. package/src/app/lib/db/migrations/0019_change_why.sql +18 -0
  1019. package/src/app/lib/db/migrations/0020_pattern_change.sql +17 -0
  1020. package/src/app/lib/db/migrations/0021_mcp_oauth_connector.sql +37 -0
  1021. package/src/app/lib/db/migrations/0022_dtcg_source.sql +21 -0
  1022. package/src/app/lib/db/migrations/0023_perf_indexes.sql +30 -0
  1023. package/src/app/lib/db/migrations/0024_phase_b_visibility.sql +40 -0
  1024. package/src/app/lib/db/migrations/0027_guest_authoring.sql +49 -0
  1025. package/src/app/lib/db/migrations/0028_invite_to_build.sql +99 -0
  1026. package/src/app/lib/db/migrations/0029_pages_templates_reflow.sql +121 -0
  1027. package/src/app/lib/db/migrations/0030_retire_briefs.sql +71 -0
  1028. package/src/app/lib/db/migrations/0031_drop_brief_columns.sql +32 -0
  1029. package/src/app/lib/db/migrations/0033_site_protection.sql +45 -0
  1030. package/src/app/lib/db/migrations/0034_brand_imagery.sql +8 -0
  1031. package/src/app/lib/db/migrations/0035_history_provenance.sql +42 -0
  1032. package/src/app/lib/db/migrations/0036_cms_connections.sql +68 -0
  1033. package/src/app/lib/db/migrations/0037_component_preview_purpose.sql +17 -0
  1034. package/src/app/lib/db/migrations/0038_capture_job.sql +87 -0
  1035. package/src/app/lib/db/migrations/meta/0000_snapshot.json +1424 -0
  1036. package/src/app/lib/db/migrations/meta/0002_snapshot.json +1644 -0
  1037. package/src/app/lib/db/migrations/meta/0003_snapshot.json +1820 -0
  1038. package/src/app/lib/db/migrations/meta/_journal.json +258 -0
  1039. package/src/app/lib/db/note-queries.ts +184 -0
  1040. package/src/app/lib/db/pattern-write.ts +1094 -0
  1041. package/src/app/lib/db/property-delta.ts +117 -0
  1042. package/src/app/lib/db/push-grouping.ts +256 -0
  1043. package/src/app/lib/db/queries.ts +2426 -0
  1044. package/src/app/lib/db/registry-queries.ts +607 -0
  1045. package/src/app/lib/db/schema-active.ts +2 -0
  1046. package/src/app/lib/db/schema-pg.ts +1201 -0
  1047. package/src/app/lib/db/schema.ts +2 -0
  1048. package/src/app/lib/db/seed.ts +117 -0
  1049. package/src/app/lib/db/sync-queries.ts +542 -0
  1050. package/src/app/lib/db/token-flatten.ts +95 -0
  1051. package/src/app/lib/db/validation-queries.ts +82 -0
  1052. package/src/app/lib/db/version-baseline.ts +42 -0
  1053. package/src/app/lib/design-workspace-client.ts +194 -0
  1054. package/src/app/lib/design-workspace-format.ts +294 -0
  1055. package/src/app/lib/docx-copy.ts +279 -0
  1056. package/src/app/lib/dtcg-axes.ts +138 -0
  1057. package/src/app/lib/dtcg-normalizer.ts +370 -0
  1058. package/src/app/lib/edit-operations.ts +275 -0
  1059. package/src/app/lib/email.ts +199 -0
  1060. package/src/app/lib/error-summary.ts +79 -0
  1061. package/src/app/lib/evals/cases.ts +678 -0
  1062. package/src/app/lib/evals/copy-coverage.ts +147 -0
  1063. package/src/app/lib/evals/copy-decks.ts +296 -0
  1064. package/src/app/lib/field-lens.ts +308 -0
  1065. package/src/app/lib/field-marks.ts +206 -0
  1066. package/src/app/lib/figma-plugin-contract.ts +104 -0
  1067. package/src/app/lib/figma-sync-types.ts +56 -0
  1068. package/src/app/lib/generated/build-meta.ts +8 -0
  1069. package/src/app/lib/guest-editable.ts +371 -0
  1070. package/src/app/lib/handoff-capabilities.ts +91 -0
  1071. package/src/app/lib/health-types.ts +324 -0
  1072. package/src/app/lib/hubspot-field-map.ts +770 -0
  1073. package/src/app/lib/hubspot-module/build-module.ts +238 -0
  1074. package/src/app/lib/hubspot-module/context.ts +259 -0
  1075. package/src/app/lib/hubspot-module/fields/boolean.ts +24 -0
  1076. package/src/app/lib/hubspot-module/fields/button.ts +70 -0
  1077. package/src/app/lib/hubspot-module/fields/fields.ts +104 -0
  1078. package/src/app/lib/hubspot-module/fields/generic.ts +183 -0
  1079. package/src/app/lib/hubspot-module/fields/hubdb.ts +168 -0
  1080. package/src/app/lib/hubspot-module/fields/image.ts +65 -0
  1081. package/src/app/lib/hubspot-module/fields/menu.ts +14 -0
  1082. package/src/app/lib/hubspot-module/fields/object.ts +42 -0
  1083. package/src/app/lib/hubspot-module/fields/select.ts +43 -0
  1084. package/src/app/lib/hubspot-module/fields/text.ts +68 -0
  1085. package/src/app/lib/hubspot-module/fields/url.ts +57 -0
  1086. package/src/app/lib/hubspot-module/fields/utils.ts +36 -0
  1087. package/src/app/lib/hubspot-module/fields/video.ts +75 -0
  1088. package/src/app/lib/hubspot-module/index.ts +30 -0
  1089. package/src/app/lib/hubspot-module/transpile.ts +727 -0
  1090. package/src/app/lib/hubspot-module/types.ts +238 -0
  1091. package/src/app/lib/hubspot-module-build.ts +50 -0
  1092. package/src/app/lib/image-bytes.ts +133 -0
  1093. package/src/app/lib/image-dimensions.ts +214 -0
  1094. package/src/app/lib/image-field-write.ts +51 -0
  1095. package/src/app/lib/image-generation-request.ts +142 -0
  1096. package/src/app/lib/image-target.ts +175 -0
  1097. package/src/app/lib/json-shape.ts +121 -0
  1098. package/src/app/lib/library-image-seed.ts +236 -0
  1099. package/src/app/lib/login-required-messages.ts +17 -0
  1100. package/src/app/lib/mcp/apps/component-gallery.bundle.ts +2 -0
  1101. package/src/app/lib/mcp/apps/component-gallery.client.ts +208 -0
  1102. package/src/app/lib/mcp/apps/component-preview.bundle.ts +2 -0
  1103. package/src/app/lib/mcp/apps/component-preview.client.ts +140 -0
  1104. package/src/app/lib/mcp/apps/token-palette.bundle.ts +2 -0
  1105. package/src/app/lib/mcp/apps/token-palette.client.ts +199 -0
  1106. package/src/app/lib/mcp/contract-report.ts +200 -0
  1107. package/src/app/lib/mcp/create-server.ts +2622 -0
  1108. package/src/app/lib/mcp/history-shapes.ts +72 -0
  1109. package/src/app/lib/mcp/project-profile.ts +82 -0
  1110. package/src/app/lib/mcp/scaffold-helpers.ts +93 -0
  1111. package/src/app/lib/mcp/stack-guides/bootstrap-handlebars.md +62 -0
  1112. package/src/app/lib/mcp/stack-guides/react-scss.md +7 -0
  1113. package/src/app/lib/mcp/stack-guides/react-tailwind.md +9 -0
  1114. package/src/app/lib/mcp/stack-guides/tailwind-handlebars.md +142 -0
  1115. package/src/app/lib/mcp/stack-guides.ts +68 -0
  1116. package/src/app/lib/mcp/tool-catalog.ts +132 -0
  1117. package/src/app/lib/mcp-auth.ts +85 -0
  1118. package/src/app/lib/merge-block-values.ts +868 -0
  1119. package/src/app/lib/normalize-preview-values.ts +244 -0
  1120. package/src/app/lib/notify.ts +213 -0
  1121. package/src/app/lib/oauth-scopes.ts +33 -0
  1122. package/src/app/lib/page-exemplars.ts +112 -0
  1123. package/src/app/lib/page-manifest.ts +162 -0
  1124. package/src/app/lib/page-provenance.ts +231 -0
  1125. package/src/app/lib/page-slug.ts +68 -0
  1126. package/src/app/lib/page-title.ts +44 -0
  1127. package/src/app/lib/page-urls.ts +41 -0
  1128. package/src/app/lib/passwords.ts +33 -0
  1129. package/src/app/lib/pattern-payload.ts +122 -0
  1130. package/src/app/lib/pattern-thumbnail.ts +234 -0
  1131. package/src/app/lib/placeholder-audit.ts +196 -0
  1132. package/src/app/lib/placeholder-copy.ts +370 -0
  1133. package/src/app/lib/playground-prompt-link.ts +46 -0
  1134. package/src/app/lib/preview-groups.ts +107 -0
  1135. package/src/app/lib/preview-purpose-labels.ts +37 -0
  1136. package/src/app/lib/preview-purpose.ts +37 -0
  1137. package/src/app/lib/preview-render-target.ts +27 -0
  1138. package/src/app/lib/preview-url.ts +15 -0
  1139. package/src/app/lib/publish-to-sanity-state.ts +605 -0
  1140. package/src/app/lib/rate-limit.ts +75 -0
  1141. package/src/app/lib/remote-handoff-client.ts +33 -0
  1142. package/src/app/lib/sanity-assets.ts +211 -0
  1143. package/src/app/lib/sanity-categories.ts +178 -0
  1144. package/src/app/lib/sanity-config.ts +266 -0
  1145. package/src/app/lib/sanity-integration-state.ts +235 -0
  1146. package/src/app/lib/sanity-mapping.ts +3284 -0
  1147. package/src/app/lib/sanity-portable-text.ts +640 -0
  1148. package/src/app/lib/sanity-publish.ts +337 -0
  1149. package/src/app/lib/sanity-references.ts +295 -0
  1150. package/src/app/lib/server/admin-users.ts +162 -0
  1151. package/src/app/lib/server/ai-client.ts +633 -0
  1152. package/src/app/lib/server/ai-proxy.ts +70 -0
  1153. package/src/app/lib/server/api-gate.ts +148 -0
  1154. package/src/app/lib/server/appearance.ts +169 -0
  1155. package/src/app/lib/server/asset-generation-worker.ts +133 -0
  1156. package/src/app/lib/server/asset-ingest-store.ts +55 -0
  1157. package/src/app/lib/server/asset-ingest.ts +347 -0
  1158. package/src/app/lib/server/auth-reset.ts +107 -0
  1159. package/src/app/lib/server/capture-browser.ts +130 -0
  1160. package/src/app/lib/server/capture-harness.ts +319 -0
  1161. package/src/app/lib/server/capture-worker.ts +178 -0
  1162. package/src/app/lib/server/change-why.ts +195 -0
  1163. package/src/app/lib/server/cli-device-oauth.ts +159 -0
  1164. package/src/app/lib/server/cms-providers.ts +53 -0
  1165. package/src/app/lib/server/component-build-preload.cjs +3 -0
  1166. package/src/app/lib/server/component-build-worker.ts +196 -0
  1167. package/src/app/lib/server/component-builder.ts +96 -0
  1168. package/src/app/lib/server/component-capture-reads.ts +172 -0
  1169. package/src/app/lib/server/component-generation-context.ts +165 -0
  1170. package/src/app/lib/server/component-generation-images.ts +40 -0
  1171. package/src/app/lib/server/component-generation-llm.ts +232 -0
  1172. package/src/app/lib/server/component-generation-run.ts +289 -0
  1173. package/src/app/lib/server/component-generation-schedule.ts +12 -0
  1174. package/src/app/lib/server/component-preview-screenshot.ts +111 -0
  1175. package/src/app/lib/server/component-scaffold.ts +88 -0
  1176. package/src/app/lib/server/component-visual-compare.ts +90 -0
  1177. package/src/app/lib/server/design-artifact-persist.ts +49 -0
  1178. package/src/app/lib/server/design-asset-extractor.ts +414 -0
  1179. package/src/app/lib/server/design-asset-schedule.ts +36 -0
  1180. package/src/app/lib/server/design-asset-worker-spawn.ts +64 -0
  1181. package/src/app/lib/server/design-asset-worker.ts +24 -0
  1182. package/src/app/lib/server/design-generation-worker.ts +281 -0
  1183. package/src/app/lib/server/design-prompt-builder.ts +322 -0
  1184. package/src/app/lib/server/design-spec-generator.ts +739 -0
  1185. package/src/app/lib/server/design-spec-types.ts +219 -0
  1186. package/src/app/lib/server/design-system-context.ts +141 -0
  1187. package/src/app/lib/server/design-token-summary.ts +133 -0
  1188. package/src/app/lib/server/design-workspace.ts +230 -0
  1189. package/src/app/lib/server/dev-handoff.ts +334 -0
  1190. package/src/app/lib/server/doc-pages.ts +442 -0
  1191. package/src/app/lib/server/event-log.ts +138 -0
  1192. package/src/app/lib/server/fetch-asset-bytes.ts +161 -0
  1193. package/src/app/lib/server/figma-audit-api.ts +188 -0
  1194. package/src/app/lib/server/figma-auth.ts +113 -0
  1195. package/src/app/lib/server/figma-fetch-runner.ts +241 -0
  1196. package/src/app/lib/server/figma-fetch-worker.ts +130 -0
  1197. package/src/app/lib/server/figma-fetch.ts +90 -0
  1198. package/src/app/lib/server/figma-fills-ingest.ts +201 -0
  1199. package/src/app/lib/server/figma-plugin-properties-sync.ts +438 -0
  1200. package/src/app/lib/server/figma-sync-service.ts +1076 -0
  1201. package/src/app/lib/server/find-assets.ts +53 -0
  1202. package/src/app/lib/server/foundation-image.tsx +671 -0
  1203. package/src/app/lib/server/generation-queue-health.ts +108 -0
  1204. package/src/app/lib/server/guest-context.ts +62 -0
  1205. package/src/app/lib/server/guest-session.ts +153 -0
  1206. package/src/app/lib/server/handoff-app-paths.ts +77 -0
  1207. package/src/app/lib/server/handoff-component-patch.ts +123 -0
  1208. package/src/app/lib/server/handoff-config-load.ts +29 -0
  1209. package/src/app/lib/server/handoff-config-project.ts +104 -0
  1210. package/src/app/lib/server/mcp-oauth-connector.ts +269 -0
  1211. package/src/app/lib/server/node-tsx-worker-launcher.cjs +32 -0
  1212. package/src/app/lib/server/oauth-state.ts +83 -0
  1213. package/src/app/lib/server/passphrase.ts +121 -0
  1214. package/src/app/lib/server/pattern-api-map.ts +123 -0
  1215. package/src/app/lib/server/playground-chat.ts +1890 -0
  1216. package/src/app/lib/server/public-api-paths.ts +34 -0
  1217. package/src/app/lib/server/reference-material-generator.ts +341 -0
  1218. package/src/app/lib/server/reference-material-ids.ts +8 -0
  1219. package/src/app/lib/server/reference-material-persist.ts +25 -0
  1220. package/src/app/lib/server/reference-material-schedule.ts +13 -0
  1221. package/src/app/lib/server/registry-cache.ts +110 -0
  1222. package/src/app/lib/server/request-public-url.ts +19 -0
  1223. package/src/app/lib/server/runtime-config.ts +43 -0
  1224. package/src/app/lib/server/s3-assets.ts +188 -0
  1225. package/src/app/lib/server/sanity-connection.ts +176 -0
  1226. package/src/app/lib/server/sanity-oauth.ts +34 -0
  1227. package/src/app/lib/server/scaffold-args.ts +392 -0
  1228. package/src/app/lib/server/secret-box.ts +85 -0
  1229. package/src/app/lib/server/serverless-chromium.ts +93 -0
  1230. package/src/app/lib/server/share-link-token.ts +106 -0
  1231. package/src/app/lib/server/site-protection.ts +145 -0
  1232. package/src/app/lib/server/spawn-tsx-worker.ts +47 -0
  1233. package/src/app/lib/server/store-image-asset.ts +220 -0
  1234. package/src/app/lib/server/token-freshness.ts +23 -0
  1235. package/src/app/lib/server/unlock-cookie.ts +70 -0
  1236. package/src/app/lib/server/upload-asset-to-library.ts +128 -0
  1237. package/src/app/lib/server/url-extract.ts +117 -0
  1238. package/src/app/lib/server/voice-audit.ts +209 -0
  1239. package/src/app/lib/set-at-args-path.ts +36 -0
  1240. package/src/app/lib/site-gate.ts +374 -0
  1241. package/src/app/lib/slot-capabilities.ts +487 -0
  1242. package/src/app/lib/source-copy.ts +295 -0
  1243. package/src/app/lib/storage/artifact-images.ts +225 -0
  1244. package/src/app/lib/storage/capture-artifacts.ts +109 -0
  1245. package/src/app/lib/swap-image-src.ts +121 -0
  1246. package/src/app/lib/sync-auth.ts +124 -0
  1247. package/src/app/lib/tool-payload.ts +101 -0
  1248. package/src/app/lib/turn-log.ts +78 -0
  1249. package/src/app/lib/url-safety.ts +46 -0
  1250. package/src/app/lib/utils.ts +35 -0
  1251. package/src/app/lib/workbench-level.ts +56 -0
  1252. package/src/app/middleware-hook.mjs +2 -0
  1253. package/src/app/next-env.d.ts +6 -0
  1254. package/src/app/next.config.mjs +355 -0
  1255. package/src/app/postcss.config.mjs +8 -0
  1256. package/src/app/proxy.ts +133 -0
  1257. package/src/app/public/assets/css/preview.css +27 -0
  1258. package/src/app/public/assets/design/blocks/callout-cta.jpg +0 -0
  1259. package/src/app/public/assets/design/blocks/carousel.png +0 -0
  1260. package/src/app/public/assets/design/blocks/container.png +0 -0
  1261. package/src/app/public/assets/design/blocks/customer-stories.jpg +0 -0
  1262. package/src/app/public/assets/design/blocks/faq.jpg +0 -0
  1263. package/src/app/public/assets/design/blocks/features-comparison.jpg +0 -0
  1264. package/src/app/public/assets/design/blocks/table.jpg +0 -0
  1265. package/src/app/public/assets/images/blocks.svg +150 -0
  1266. package/src/app/public/assets/images/check-circle.svg +10 -0
  1267. package/src/app/public/assets/images/colors.svg +186 -0
  1268. package/src/app/public/assets/images/components.png +0 -0
  1269. package/src/app/public/assets/images/components.svg +183 -0
  1270. package/src/app/public/assets/images/illustration-sample-2.svg +102 -0
  1271. package/src/app/public/assets/images/illustration-sample-3.svg +124 -0
  1272. package/src/app/public/assets/images/illustration-sample-bw-1.svg +84 -0
  1273. package/src/app/public/assets/images/illustration-sample-bw-2.svg +88 -0
  1274. package/src/app/public/assets/images/illustration-sample-bw-3.svg +125 -0
  1275. package/src/app/public/assets/images/illustration-sample.svg +110 -0
  1276. package/src/app/public/assets/images/typography.svg +279 -0
  1277. package/src/app/public/assets/images/usage-correct.png +0 -0
  1278. package/src/app/public/assets/images/usage-wrong.png +0 -0
  1279. package/src/app/public/assets/images/x-circle.svg +10 -0
  1280. package/src/app/public/assets/js/preview.js +90 -0
  1281. package/src/app/public/assets/svg/activity.svg +1 -0
  1282. package/src/app/public/assets/svg/add.svg +1 -0
  1283. package/src/app/public/assets/svg/airplay.svg +1 -0
  1284. package/src/app/public/assets/svg/alert-circle.svg +1 -0
  1285. package/src/app/public/assets/svg/alert-octagon.svg +1 -0
  1286. package/src/app/public/assets/svg/alert-triangle.svg +1 -0
  1287. package/src/app/public/assets/svg/align-center.svg +1 -0
  1288. package/src/app/public/assets/svg/align-justify.svg +1 -0
  1289. package/src/app/public/assets/svg/align-left.svg +1 -0
  1290. package/src/app/public/assets/svg/arrow-down-circle.svg +1 -0
  1291. package/src/app/public/assets/svg/arrow-left-circle.svg +1 -0
  1292. package/src/app/public/assets/svg/arrow-right-circle.svg +1 -0
  1293. package/src/app/public/assets/svg/arrow-right.svg +4 -0
  1294. package/src/app/public/assets/svg/arrow-up-circle.svg +1 -0
  1295. package/src/app/public/assets/svg/bell-off.svg +1 -0
  1296. package/src/app/public/assets/svg/bell.svg +1 -0
  1297. package/src/app/public/assets/svg/camera.svg +1 -0
  1298. package/src/app/public/assets/svg/cast.svg +1 -0
  1299. package/src/app/public/assets/svg/check.svg +1 -0
  1300. package/src/app/public/assets/svg/clock.svg +1 -0
  1301. package/src/app/public/assets/svg/code.svg +1 -0
  1302. package/src/app/public/assets/svg/component-accordion.svg +56 -0
  1303. package/src/app/public/assets/svg/component-alert.svg +34 -0
  1304. package/src/app/public/assets/svg/component-button.svg +63 -0
  1305. package/src/app/public/assets/svg/component-checkbox.svg +41 -0
  1306. package/src/app/public/assets/svg/component-input.svg +30 -0
  1307. package/src/app/public/assets/svg/component-modal.svg +63 -0
  1308. package/src/app/public/assets/svg/component-pagination.svg +82 -0
  1309. package/src/app/public/assets/svg/component-radio.svg +15 -0
  1310. package/src/app/public/assets/svg/component-select.svg +48 -0
  1311. package/src/app/public/assets/svg/component-switch.svg +6 -0
  1312. package/src/app/public/assets/svg/component-table.svg +45 -0
  1313. package/src/app/public/assets/svg/component-tabs.svg +34 -0
  1314. package/src/app/public/assets/svg/component-tooltip.svg +60 -0
  1315. package/src/app/public/assets/svg/component.svg +48 -0
  1316. package/src/app/public/assets/svg/copy.svg +1 -0
  1317. package/src/app/public/assets/svg/delivery.svg +1 -0
  1318. package/src/app/public/assets/svg/download.svg +1 -0
  1319. package/src/app/public/assets/svg/file-jpg.svg +20 -0
  1320. package/src/app/public/assets/svg/file-svg.svg +31 -0
  1321. package/src/app/public/assets/svg/file-zip.svg +24 -0
  1322. package/src/app/public/assets/svg/hero-brand-assets.svg +44 -0
  1323. package/src/app/public/assets/svg/hero-colors.svg +10 -0
  1324. package/src/app/public/assets/svg/hero-components.svg +68 -0
  1325. package/src/app/public/assets/svg/hero-design.svg +20 -0
  1326. package/src/app/public/assets/svg/hero-effects.svg +1 -0
  1327. package/src/app/public/assets/svg/illustration-sample.svg +82 -0
  1328. package/src/app/public/assets/svg/image.svg +8 -0
  1329. package/src/app/public/assets/svg/link.svg +1 -0
  1330. package/src/app/public/assets/svg/logo.svg +8 -0
  1331. package/src/app/public/assets/svg/moon.svg +1 -0
  1332. package/src/app/public/assets/svg/motiv-logo-dark-example.svg +11 -0
  1333. package/src/app/public/assets/svg/motiv-logo-example.svg +11 -0
  1334. package/src/app/public/assets/svg/plus-circle.svg +1 -0
  1335. package/src/app/public/assets/svg/react.svg +10 -0
  1336. package/src/app/public/assets/svg/search-laptop.svg +20 -0
  1337. package/src/app/public/assets/svg/search.svg +1 -0
  1338. package/src/app/public/assets/svg/send.svg +10 -0
  1339. package/src/app/public/assets/svg/share.svg +1 -0
  1340. package/src/app/public/assets/svg/small-accordion.svg +9 -0
  1341. package/src/app/public/assets/svg/small-button.svg +9 -0
  1342. package/src/app/public/assets/svg/small-pagination.svg +14 -0
  1343. package/src/app/public/assets/svg/small-radio.svg +15 -0
  1344. package/src/app/public/assets/svg/small-select.svg +9 -0
  1345. package/src/app/public/assets/svg/small-table.svg +16 -0
  1346. package/src/app/public/assets/svg/small-toggle.svg +9 -0
  1347. package/src/app/public/assets/svg/sun.svg +1 -0
  1348. package/src/app/public/assets/svg/token-alignment.svg +5 -0
  1349. package/src/app/public/assets/svg/token-border-radius.svg +3 -0
  1350. package/src/app/public/assets/svg/token-border-width.svg +10 -0
  1351. package/src/app/public/assets/svg/token-spacing-horizontal.svg +8 -0
  1352. package/src/app/public/assets/svg/token-spacing-vertical.svg +8 -0
  1353. package/src/app/public/assets/svg/token-type-small.svg +5 -0
  1354. package/src/app/public/assets/svg/x.svg +1 -0
  1355. package/src/app/public/assets/svg/zap.svg +1 -0
  1356. package/src/app/public/favicon.ico +0 -0
  1357. package/src/app/public/fonts/readme.md +4 -0
  1358. package/src/app/public/handoff-logo.svg +38 -0
  1359. package/src/app/public/logo.svg +13 -0
  1360. package/src/app/public/openapi.yaml +1818 -0
  1361. package/src/app/public/robots.txt +0 -0
  1362. package/src/app/tsconfig.json +53 -0
  1363. package/src/app/types/middleware-hook.d.ts +10 -0
  1364. package/src/app/types/next-auth-augmentation.d.ts +20 -0
  1365. package/src/app-builder/README.md +43 -0
  1366. package/src/app-builder/build.ts +741 -0
  1367. package/src/app-builder/client-config.ts +124 -0
  1368. package/src/app-builder/config-diff/index.ts +4 -0
  1369. package/src/app-builder/config-diff/registry.ts +23 -0
  1370. package/src/app-builder/config-diff/snapshot.ts +51 -0
  1371. package/src/app-builder/config-diff/strategies/pattern.ts +80 -0
  1372. package/src/app-builder/config-diff/types.ts +36 -0
  1373. package/src/app-builder/index.ts +7 -0
  1374. package/src/app-builder/path-contract.ts +81 -0
  1375. package/src/app-builder/paths.ts +90 -0
  1376. package/src/app-builder/watchers/component.ts +72 -0
  1377. package/src/app-builder/watchers/utils.ts +44 -0
  1378. package/src/app-builder/watchers.ts +345 -0
  1379. package/src/app-builder/websocket.ts +72 -0
  1380. package/src/cache/README.md +49 -0
  1381. package/src/cache/build-cache.ts +567 -0
  1382. package/src/cache/file-state.ts +170 -0
  1383. package/src/cache/index.ts +46 -0
  1384. package/src/cache/push-state.ts +201 -0
  1385. package/src/cli/README.md +12 -0
  1386. package/src/cli/create.ts +366 -0
  1387. package/src/cli/eject.ts +93 -0
  1388. package/src/cli/fetch-design-md.ts +60 -0
  1389. package/src/cli/figma-audit.ts +76 -0
  1390. package/src/cli/init-claude-core.ts +111 -0
  1391. package/src/cli/make.ts +203 -0
  1392. package/src/cli/scaffold.ts +651 -0
  1393. package/src/cli/sync/apply-declaration-pull.ts +257 -0
  1394. package/src/cli/sync/apply-pull.ts +223 -0
  1395. package/src/cli/sync/cli-auth-store.ts +51 -0
  1396. package/src/cli/sync/collect-build-artifacts.ts +159 -0
  1397. package/src/cli/sync/collect-referenced-images.ts +204 -0
  1398. package/src/cli/sync/declaration-patch.ts +192 -0
  1399. package/src/cli/sync/hash.ts +12 -0
  1400. package/src/cli/sync/open-browser.ts +37 -0
  1401. package/src/cli/sync/push-provenance.ts +109 -0
  1402. package/src/cli/sync/push-registry-content.ts +1025 -0
  1403. package/src/cli/sync/push-shared-assets.ts +62 -0
  1404. package/src/cli/sync/resolve-declaration-payload.ts +231 -0
  1405. package/src/cli/sync/resolve-declaration.ts +18 -0
  1406. package/src/cli/sync/run-cli-login.ts +110 -0
  1407. package/src/cli/sync/run-history-purge.ts +142 -0
  1408. package/src/cli/sync/run-pull.ts +112 -0
  1409. package/src/cli/sync/run-push.ts +702 -0
  1410. package/src/cli/sync/run-sync-status.ts +37 -0
  1411. package/src/cli/sync/sync-remote-env.ts +64 -0
  1412. package/src/cli/sync/sync-state.ts +42 -0
  1413. package/src/cli/tokens/ensure-default-brand.ts +115 -0
  1414. package/src/cli/tokens/migrate-legacy.ts +261 -0
  1415. package/src/cli/tokens/parse-css-brands.ts +208 -0
  1416. package/src/cli/tokens/transform.ts +134 -0
  1417. package/src/cli.ts +62 -0
  1418. package/src/commands/README.md +25 -0
  1419. package/src/commands/audit/figma-components.ts +37 -0
  1420. package/src/commands/build/app.ts +32 -0
  1421. package/src/commands/build/components.ts +25 -0
  1422. package/src/commands/build/hubspot.ts +267 -0
  1423. package/src/commands/dev/index.ts +20 -0
  1424. package/src/commands/eject/config.ts +20 -0
  1425. package/src/commands/eject/pages.ts +20 -0
  1426. package/src/commands/eject/theme.ts +20 -0
  1427. package/src/commands/fetch/index.ts +20 -0
  1428. package/src/commands/history-purge.ts +67 -0
  1429. package/src/commands/index.ts +67 -0
  1430. package/src/commands/init/index.ts +17 -0
  1431. package/src/commands/init/vercel.ts +112 -0
  1432. package/src/commands/init-claude.ts +61 -0
  1433. package/src/commands/login.ts +39 -0
  1434. package/src/commands/logout.ts +22 -0
  1435. package/src/commands/make/component.ts +34 -0
  1436. package/src/commands/make/page.ts +47 -0
  1437. package/src/commands/make/template.ts +47 -0
  1438. package/src/commands/mcp-init.ts +111 -0
  1439. package/src/commands/mcp-token.ts +32 -0
  1440. package/src/commands/prepare-runtime.ts +39 -0
  1441. package/src/commands/pull.ts +28 -0
  1442. package/src/commands/push-all.ts +202 -0
  1443. package/src/commands/push-assets.ts +52 -0
  1444. package/src/commands/push-tokens.ts +52 -0
  1445. package/src/commands/push.ts +91 -0
  1446. package/src/commands/scaffold/index.ts +22 -0
  1447. package/src/commands/start/index.ts +20 -0
  1448. package/src/commands/sync-status.ts +21 -0
  1449. package/src/commands/tokens-build.ts +118 -0
  1450. package/src/commands/types.ts +6 -0
  1451. package/src/commands/utils.ts +21 -0
  1452. package/src/commands/validate/components.ts +27 -0
  1453. package/src/commands/validate.ts +189 -0
  1454. package/src/commands/vercel-build.ts +96 -0
  1455. package/src/config/README.md +32 -0
  1456. package/src/config/declaration-module-load.ts +74 -0
  1457. package/src/config/defaults.ts +78 -0
  1458. package/src/config/helpers.ts +43 -0
  1459. package/src/config/index.ts +16 -0
  1460. package/src/config/loader.ts +131 -0
  1461. package/src/config/normalizers/declaration.ts +180 -0
  1462. package/src/config/normalizers/pattern.ts +56 -0
  1463. package/src/config/runtime.ts +426 -0
  1464. package/src/config/validator.ts +24 -0
  1465. package/src/declarations/codegen.ts +367 -0
  1466. package/src/declarations/helpers.ts +36 -0
  1467. package/src/declarations/index.ts +20 -0
  1468. package/src/declarations/types.ts +214 -0
  1469. package/src/figma/component-linking.ts +1415 -0
  1470. package/src/figma/image-fills.ts +247 -0
  1471. package/src/generated/build-meta.ts +8 -0
  1472. package/src/index.d.ts +13 -0
  1473. package/src/index.ts +369 -0
  1474. package/src/pipeline/README.md +21 -0
  1475. package/src/pipeline/archive.ts +75 -0
  1476. package/src/pipeline/components.ts +9 -0
  1477. package/src/pipeline/documentation.ts +77 -0
  1478. package/src/pipeline/figma.ts +173 -0
  1479. package/src/pipeline/hubspot/config.ts +288 -0
  1480. package/src/pipeline/hubspot/emit.ts +385 -0
  1481. package/src/pipeline/index.ts +38 -0
  1482. package/src/pipeline/patterns.ts +12 -0
  1483. package/src/pipeline/styles.ts +154 -0
  1484. package/src/pipeline/validation.ts +25 -0
  1485. package/src/stacks/bootstrap-handlebars.md +117 -0
  1486. package/src/stacks/react-scss.md +126 -0
  1487. package/src/stacks/react-tailwind.md +123 -0
  1488. package/src/stacks/tailwind-handlebars.md +142 -0
  1489. package/src/transformers/README.md +19 -0
  1490. package/src/transformers/docgen/index.ts +305 -0
  1491. package/src/transformers/plugins/csf-render.ts +485 -0
  1492. package/src/transformers/plugins/handlebars-previews.ts +194 -0
  1493. package/src/transformers/plugins/index.ts +14 -0
  1494. package/src/transformers/plugins/slot-probe-candidates.ts +386 -0
  1495. package/src/transformers/plugins/slot-probe.ts +366 -0
  1496. package/src/transformers/plugins/ssr-render.ts +622 -0
  1497. package/src/transformers/plugins.ts +17 -0
  1498. package/src/transformers/preview/component/api.ts +175 -0
  1499. package/src/transformers/preview/component/artifacts.ts +112 -0
  1500. package/src/transformers/preview/component/build-shared-bundles.ts +453 -0
  1501. package/src/transformers/preview/component/builder.ts +754 -0
  1502. package/src/transformers/preview/component/css.ts +253 -0
  1503. package/src/transformers/preview/component/field-annotations.ts +400 -0
  1504. package/src/transformers/preview/component/html.ts +96 -0
  1505. package/src/transformers/preview/component/javascript.ts +182 -0
  1506. package/src/transformers/preview/component/normalizer.ts +83 -0
  1507. package/src/transformers/preview/component/playwright-shared.ts +183 -0
  1508. package/src/transformers/preview/component/preview-assets.ts +158 -0
  1509. package/src/transformers/preview/component/preview-merge.ts +95 -0
  1510. package/src/transformers/preview/component/preview-select.ts +184 -0
  1511. package/src/transformers/preview/component/preview-server.ts +128 -0
  1512. package/src/transformers/preview/component/preview-validation.ts +255 -0
  1513. package/src/transformers/preview/component/previews.ts +12 -0
  1514. package/src/transformers/preview/component/screenshot.ts +306 -0
  1515. package/src/transformers/preview/component/serialized-elements.ts +124 -0
  1516. package/src/transformers/preview/component/summary.ts +54 -0
  1517. package/src/transformers/preview/component.ts +31 -0
  1518. package/src/transformers/preview/height-reporter.ts +37 -0
  1519. package/src/transformers/preview/pattern/api.ts +83 -0
  1520. package/src/transformers/preview/pattern/builder.ts +192 -0
  1521. package/src/transformers/preview/pattern/html.ts +115 -0
  1522. package/src/transformers/preview/slots.ts +105 -0
  1523. package/src/transformers/preview/types.ts +302 -0
  1524. package/src/transformers/types.ts +68 -0
  1525. package/src/transformers/utils/build.ts +85 -0
  1526. package/src/transformers/utils/csf.ts +48 -0
  1527. package/src/transformers/utils/handlebars.ts +92 -0
  1528. package/src/transformers/utils/html.ts +44 -0
  1529. package/src/transformers/utils/index.ts +27 -0
  1530. package/src/transformers/utils/module.ts +54 -0
  1531. package/src/transformers/utils/schema-loader.ts +68 -0
  1532. package/src/transformers/utils/schema.ts +569 -0
  1533. package/src/transformers/utils/string.ts +55 -0
  1534. package/src/transformers/utils/svg-sprite.ts +139 -0
  1535. package/src/transformers/utils/usage.ts +317 -0
  1536. package/src/transformers/utils/vite-logger.ts +33 -0
  1537. package/src/transformers/validation/runner.ts +351 -0
  1538. package/src/transformers/vite-config.ts +21 -0
  1539. package/src/types/README.md +12 -0
  1540. package/src/types/config.ts +482 -0
  1541. package/src/types/font.ts +3 -0
  1542. package/src/types/handoff-sync.ts +145 -0
  1543. package/src/types/history-purge.ts +141 -0
  1544. package/src/types/icon.ts +8 -0
  1545. package/src/types/preview.ts +136 -0
  1546. package/src/types/validation.ts +213 -0
  1547. package/src/utils/README.md +14 -0
  1548. package/src/utils/asset-upload-limits.ts +157 -0
  1549. package/src/utils/design-md.ts +152 -0
  1550. package/src/utils/duration.ts +3 -0
  1551. package/src/utils/filter.ts +134 -0
  1552. package/src/utils/fs.ts +35 -0
  1553. package/src/utils/index.ts +6 -0
  1554. package/src/utils/line-diff.ts +80 -0
  1555. package/src/utils/logger.ts +176 -0
  1556. package/src/utils/path.ts +61 -0
  1557. package/src/utils/port.ts +46 -0
  1558. package/src/utils/rich-text.ts +1202 -0
  1559. package/src/validators/axe.ts +288 -0
  1560. package/src/validators/contrast.ts +270 -0
  1561. package/src/validators/index.ts +42 -0
  1562. package/src/validators/schema.ts +191 -0
  1563. package/tailwind.config.ts +96 -0
  1564. package/templates/default/README.md.tpl +15 -0
  1565. package/templates/default/components/button/Button.jsx.tpl +64 -0
  1566. package/templates/default/components/button/Button.tsx.tpl +92 -0
  1567. package/templates/default/components/button/button.react.handoff.js.tpl +31 -0
  1568. package/templates/default/components/button/button.react.handoff.ts.tpl +31 -0
  1569. package/templates/default/env.tpl +2 -0
  1570. package/templates/default/gitignore.tpl +7 -0
  1571. package/templates/default/handoff.config.js.tpl +216 -0
  1572. package/templates/default/handoff.config.ts.tpl +196 -0
  1573. package/templates/default/handoff.config.with-examples.js.tpl +215 -0
  1574. package/templates/default/handoff.config.with-examples.ts.tpl +208 -0
  1575. package/templates/default/package.json.tpl +19 -0
  1576. package/templates/default/tsconfig.json.tpl +24 -0
  1577. package/templates/workflows/hubspot-deploy.yml +134 -0
  1578. package/tsconfig.json +30 -0
@@ -0,0 +1,1465 @@
1
+ 'use client';
2
+
3
+ import React, { useEffect, useRef, useState } from 'react';
4
+ import { cn } from '../../lib/utils';
5
+
6
+ import Handlebars from 'handlebars';
7
+ import { registerFieldMarkHelper } from '@/lib/field-marks';
8
+ import { toWireArgs } from '@handoff/utils/rich-text';
9
+ import { INLINE_EDIT_CSS, inlineEditScript } from './inline-edit-script';
10
+ import { getLinkGuardScript } from './link-guard-script';
11
+ import { PlaygroundComponent, SelectedPlaygroundComponent } from './types';
12
+
13
+ /**
14
+ * Register all Handlebars helpers needed by component templates.
15
+ * Mirrors the build-pipeline's registerHandlebarsHelpers (from
16
+ * src/transformers/utils/handlebars.ts) but without Node-only deps.
17
+ * Called before every Handlebars compile to guarantee parity.
18
+ */
19
+ function registerPlaygroundHelpers() {
20
+ // `{{#field 'name'}}` marks where a field renders, for inline editing (roadmap F.1). The mark format lives in
21
+ // `lib/field-marks.ts` because the editor has to read back exactly what this writes.
22
+ registerFieldMarkHelper(Handlebars);
23
+
24
+ Handlebars.registerHelper('eq', function (a: any, b: any) {
25
+ return a === b;
26
+ });
27
+
28
+ Handlebars.registerHelper('ne', function (a: any, b: any) {
29
+ return a !== b;
30
+ });
31
+
32
+ Handlebars.registerHelper('and', function (this: any, ...args: any[]) {
33
+ const options = args.pop();
34
+ return args.every(Boolean) ? options.fn(this) : options.inverse(this);
35
+ });
36
+
37
+ Handlebars.registerHelper('or', function (this: any, ...args: any[]) {
38
+ const options = args.pop();
39
+ return args.some(Boolean) ? options.fn(this) : options.inverse(this);
40
+ });
41
+
42
+ Handlebars.registerHelper('not', function (value: any) {
43
+ return !value;
44
+ });
45
+
46
+ Handlebars.registerHelper('gt', function (a: any, b: any) { return a > b; });
47
+ Handlebars.registerHelper('gte', function (a: any, b: any) { return a >= b; });
48
+ Handlebars.registerHelper('lt', function (a: any, b: any) { return a < b; });
49
+ Handlebars.registerHelper('lte', function (a: any, b: any) { return a <= b; });
50
+
51
+ Handlebars.registerHelper('concat', function (...args: any[]) {
52
+ args.pop(); // remove Handlebars options
53
+ return args.join('');
54
+ });
55
+
56
+ Handlebars.registerHelper('json', function (context: any) {
57
+ return JSON.stringify(context);
58
+ });
59
+
60
+ Handlebars.registerHelper('default', function (value: any, fallback: any) {
61
+ return value != null && value !== '' ? value : fallback;
62
+ });
63
+
64
+ Handlebars.registerHelper('capitalize', function (str: any) {
65
+ if (typeof str !== 'string') return str;
66
+ return str.charAt(0).toUpperCase() + str.slice(1);
67
+ });
68
+
69
+ Handlebars.registerHelper('lowercase', function (str: any) {
70
+ return typeof str === 'string' ? str.toLowerCase() : str;
71
+ });
72
+
73
+ Handlebars.registerHelper('uppercase', function (str: any) {
74
+ return typeof str === 'string' ? str.toUpperCase() : str;
75
+ });
76
+ }
77
+
78
+ /**
79
+ * Build the context object that Handlebars templates expect.
80
+ * Mirrors `createHandlebarsContext` from the build-time pipeline but
81
+ * without Node-only dependencies.
82
+ */
83
+ function createPlaygroundHandlebarsContext(
84
+ component: PlaygroundComponent,
85
+ data: any,
86
+ basePath: string
87
+ ) {
88
+ const previewCssLink = component.options?.preview?.css
89
+ ? `\n<link rel="stylesheet" href="${component.options.preview.css}">`
90
+ : '';
91
+ return {
92
+ style:
93
+ `<link rel="stylesheet" href="${basePath}/api/component/main.css">` +
94
+ `<link rel="stylesheet" href="${basePath}/api/component/${component.id}.css">\n` +
95
+ `<link rel="stylesheet" href="${basePath}/assets/css/preview.css">` +
96
+ previewCssLink,
97
+ script:
98
+ `<script src="${basePath}/api/component/${component.id}.js"></script>\n` +
99
+ `<script src="${basePath}/assets/js/preview.js"></script>` +
100
+ `<script>var fields = ${JSON.stringify(component.properties || {})};</script>`,
101
+ // Portable Text → HTML on the way to the template. Handlebars' `{{{bodySlot}}}` has always been handed a
102
+ // string and still is, which is what keeps the Handlebars registry untouched by roadmap 7 — identity for a string value.
103
+ properties: toWireArgs(data || component.data || {}, component.properties),
104
+ fields: component.properties || {},
105
+ title: component.title,
106
+ };
107
+ }
108
+
109
+ /**
110
+ * Render a Handlebars component with the build-time-equivalent context.
111
+ */
112
+ export function renderHandlebarsPreview(
113
+ component: PlaygroundComponent,
114
+ data: any = null,
115
+ basePath: string = ''
116
+ ): string {
117
+ registerPlaygroundHelpers();
118
+ const context = createPlaygroundHandlebarsContext(component, data, basePath);
119
+ const template = Handlebars.compile(component.code);
120
+ return template(context);
121
+ }
122
+
123
+ // Vendor-isolated bundles (roadmap 6.6): the tiny per-component `-client.mjs`
124
+ // entries import react / react-dom / the component library by BARE specifier,
125
+ // resolved via an importmap served at /api/component/hvendor-importmap.json.
126
+ // The document exposes a readiness promise (`window.__handoffImportmapReady`)
127
+ // that every dynamic `import()` awaits, filled one of two ways — see
128
+ // `importmapReadyScript`. Whatever fills it must run from a CLASSIC script (an
129
+ // inline `type="module"` would trigger the import-map lockout) and BEFORE any
130
+ // `import()`. Older self-contained bundles simply ignore the (possibly absent)
131
+ // importmap, so this degrades cleanly.
132
+ const IMPORTMAP_FILE = 'hvendor-importmap.json';
133
+
134
+ /**
135
+ * The importmap text these documents inline, resolved ONCE for the app.
136
+ *
137
+ * Read from the parent document, which is same-origin with the API and can always reach it — unlike the
138
+ * canvas, which cannot. Kept as a resolved string so the synchronous render paths can use it too.
139
+ */
140
+ let importmapText: string | null = null;
141
+ const importmapLoads = new Map<string, Promise<string | null>>();
142
+
143
+ /**
144
+ * Fetch the shared importmap once, from the PARENT document.
145
+ *
146
+ * Re-stringified from the parsed JSON rather than passed through verbatim, so only a valid map is ever
147
+ * inlined; anything else resolves null and the document falls back to fetching for itself. A failure is
148
+ * cached like a success — the canvas rebuilds on every edit, and a project with no importmap must not
149
+ * re-ask for one each time. Falling back is not a degraded canvas, just an in-frame fetch.
150
+ */
151
+ export function loadSharedImportmap(basePath: string): Promise<string | null> {
152
+ const cached = importmapLoads.get(basePath);
153
+ if (cached) return cached;
154
+ const load = fetch(`${basePath}/api/component/${IMPORTMAP_FILE}`)
155
+ .then((r) => (r.ok ? r.json() : null))
156
+ .then((map) => (map && typeof map === 'object' ? JSON.stringify(map) : null))
157
+ .catch(() => null)
158
+ .then((text) => {
159
+ importmapText = text;
160
+ return text;
161
+ });
162
+ importmapLoads.set(basePath, load);
163
+ return load;
164
+ }
165
+
166
+ /**
167
+ * Head scripts that make `window.__handoffImportmapReady` resolvable, preferring a STATIC importmap.
168
+ *
169
+ * Inlining matters because the canvas is an opaque-origin iframe (`sandbox="allow-scripts"`, no
170
+ * `allow-same-origin`): a fetch from inside it is cross-origin, so it needs the artifact route to send CORS
171
+ * headers, and when that is missing — as it was until the JSON route learned to — the fetch fails *silently*,
172
+ * no importmap is inserted, every block's bare `import 'react'` fails to resolve, and the canvas quietly shows
173
+ * static default snapshots instead of the edited content. A map we already hold has no such failure mode, so
174
+ * hydration should not depend on the frame being able to ask for it.
175
+ *
176
+ * The static tag must precede any module script; it does, since everything else here is a classic script and
177
+ * the block loaders await the promise before their dynamic `import()`.
178
+ *
179
+ * `map` null (nothing loaded yet, or no importmap in this project) keeps the original runtime fetch.
180
+ */
181
+ function importmapReadyScript(basePath: string, map: string | null): string {
182
+ if (map) {
183
+ // `<\/` so a URL in the map cannot close this script element early. Valid JSON escaping, so the
184
+ // browser still parses the map.
185
+ return `<script type="importmap">${map.replace(/<\//g, '<\\/')}</script>
186
+ <script>window.__handoffImportmapReady = Promise.resolve();</script>`;
187
+ }
188
+ return `<script>
189
+ window.__handoffImportmapReady = fetch(${JSON.stringify(basePath)} + '/api/component/${IMPORTMAP_FILE}')
190
+ .then(function(r){ return r.ok ? r.json() : null; })
191
+ .then(function(map){ try { if (map) { var s=document.createElement('script'); s.type='importmap'; s.textContent=JSON.stringify(map); document.head.appendChild(s); } } catch(e){} })
192
+ .catch(function(){});
193
+ </script>`;
194
+ }
195
+
196
+ /**
197
+ * Construct an iframe HTML document that loads a React/CSF component module
198
+ * and renders it with the given props. The module is served from
199
+ * `/api/component/{id}-client.mjs` and exposes `render(container, props)`
200
+ * and `update(props)` functions. The iframe listens for `postMessage`
201
+ * events to re-render with new props without reloading the module.
202
+ */
203
+ export function renderReactPreview(
204
+ component: PlaygroundComponent,
205
+ data: any = null,
206
+ basePath: string = '',
207
+ /** When set (composite canvas), only apply postMessage updates targeting this block id. */
208
+ blockId?: string | null,
209
+ /**
210
+ * The shared importmap, to inline. Defaults to whatever `loadSharedImportmap` has resolved — this entry
211
+ * point is synchronous, so it cannot wait for a cold load; the first render falls back to the runtime
212
+ * fetch and the load it kicks off makes every later one static.
213
+ */
214
+ importmap: string | null = importmapText
215
+ ): string {
216
+ if (!importmap) void loadSharedImportmap(basePath);
217
+ // The props JSON the baked `-client.mjs` `__map` reads. Portable Text must never reach it — it would render
218
+ // `[object Object]` on every component until the whole registry was rebuilt and re-pushed.
219
+ const props = JSON.stringify(toWireArgs(data || component.data || {}, component.properties));
220
+ // Escape the static HTML so it's safe inside a JSON script tag.
221
+ const fallbackHtml = JSON.stringify(component.html || '');
222
+ const previewCssLink = component.options?.preview?.css
223
+ ? `\n <link rel="stylesheet" href="${component.options.preview.css}" />`
224
+ : '';
225
+ const blockFilter = blockId
226
+ ? `if (event.data.blockId && event.data.blockId !== ${JSON.stringify(blockId)}) return;`
227
+ : '';
228
+ return `<!DOCTYPE html>
229
+ <html>
230
+ <head>
231
+ ${importmapReadyScript(basePath, importmap)}
232
+ <link rel="stylesheet" href="${basePath}/api/registry/theme.css" />
233
+ <link rel="stylesheet" href="${basePath}/api/component/main.css" />
234
+ <link rel="stylesheet" href="${basePath}/api/component/${component.id}.css" />
235
+ <link rel="stylesheet" href="${basePath}/assets/css/preview.css" />${previewCssLink}
236
+ </head>
237
+ <body>
238
+ <div id="root"></div>
239
+ <script id="__PROPS__" type="application/json">${props}</script>
240
+ <script id="__FALLBACK__" type="application/json">${fallbackHtml}</script>
241
+ <script>
242
+ var container = document.getElementById('root');
243
+ var initialProps = JSON.parse(document.getElementById('__PROPS__').textContent || '{}');
244
+ var fallbackHtml = JSON.parse(document.getElementById('__FALLBACK__').textContent || '""');
245
+
246
+ // Await importmap injection, then load the (bare-specifier) client module.
247
+ (window.__handoffImportmapReady || Promise.resolve())
248
+ .then(function () { return import('${basePath}/api/component/${component.id}-client.mjs'); })
249
+ .then(function (m) {
250
+ m.render(container, initialProps);
251
+ window.addEventListener('message', function (event) {
252
+ if (event.data && event.data.type === 'update-props') {
253
+ ${blockFilter}
254
+ m.update(event.data.props);
255
+ }
256
+ });
257
+ })
258
+ .catch(function () {
259
+ // module not available — render static HTML snapshot instead
260
+ if (fallbackHtml) container.innerHTML = fallbackHtml;
261
+ });
262
+ </script>
263
+ </body>
264
+ </html>`;
265
+ }
266
+
267
+ /**
268
+ * Format-aware render dispatcher. Returns rendered HTML for the component.
269
+ */
270
+ export async function renderPreview(
271
+ component: PlaygroundComponent,
272
+ data: any = null,
273
+ basePath: string = ''
274
+ ): Promise<string> {
275
+ if (component.format === 'react') {
276
+ // Async, so it can wait for the shared importmap and inline it rather than leaving the frame to fetch.
277
+ return renderReactPreview(component, data, basePath, null, await loadSharedImportmap(basePath));
278
+ }
279
+ return renderHandlebarsPreview(component, data, basePath);
280
+ }
281
+
282
+ export function previewRenderedHtml(html: string, basePath: string = ''): string {
283
+ return `<html>
284
+ <head>
285
+ <link rel="stylesheet" href="${basePath}/api/component/main.css" />
286
+ </head>
287
+ <body>
288
+ ${html}
289
+ </body>
290
+ <script src="${basePath}/api/component/main.js"></script>
291
+ </html>`;
292
+ }
293
+
294
+ function escapeAttr(str: string): string {
295
+ return str.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
296
+ }
297
+
298
+ const BLOCK_CONTROLS_CSS = `
299
+ .playground-block{position:relative}
300
+ .playground-block::after{content:'';position:absolute;inset:0;pointer-events:none;border:2px solid transparent;transition:border-color .15s;z-index:9998}
301
+ .playground-block:hover::after{border-color:rgba(59,130,246,.45)}
302
+ .playground-block-toolbar{position:absolute;top:8px;left:8px;display:flex;align-items:center;gap:4px;opacity:0;transition:opacity .15s;z-index:9999}
303
+ .playground-block:hover .playground-block-toolbar{opacity:1}
304
+ .playground-block-title{background:rgba(59,130,246,.9);color:#fff;font-size:11px;font-weight:500;padding:3px 8px;border-radius:4px;line-height:1.3;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;white-space:nowrap}
305
+ .playground-block-btn{background:#fff;border:1px solid rgba(0,0,0,.12);border-radius:4px;width:26px;height:26px;display:flex;align-items:center;justify-content:center;cursor:pointer;padding:0;box-shadow:0 1px 3px rgba(0,0,0,.08);transition:background .1s,border-color .1s;color:#374151}
306
+ .playground-block-btn:hover{background:#f3f4f6}
307
+ .playground-block-btn.delete:hover{background:#fef2f2;border-color:#fca5a5;color:#ef4444}
308
+ `;
309
+
310
+ /**
311
+ * `allowDelete: false` renders the hover toolbar with **edit only**.
312
+ *
313
+ * Used by the read-only-structure surfaces (roadmap E.5): a guest filling in a template, and a frozen
314
+ * template being viewed. They still need to click a block to edit its content — they must not be able to
315
+ * remove it, and offering a control that will be refused is worse than not offering it.
316
+ *
317
+ * @param restoreScrollY Where the canvas was scrolled to before this document replaced the last one. Every
318
+ * committed edit rebuilds the whole `srcdoc` — there is no partial update, because a Handlebars block is a
319
+ * rendered HTML string — so without this the page jumps to the top on each change. Tolerable while edits came
320
+ * from the rail; unusable once you are editing text in the canvas itself (roadmap F.2). The parent cannot read
321
+ * the frame's scroll position (opaque origin), so the frame reports it and the parent hands it back on rebuild.
322
+ */
323
+ function getBlockControlsScript(allowDelete = true, restoreScrollY = 0): string {
324
+ const editSvg = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z"/><path d="m15 5 4 4"/></svg>';
325
+ const trashSvg = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 6h18"/><path d="M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6"/><path d="M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2"/></svg>';
326
+
327
+ return `
328
+ (function(){
329
+ // One block's toolbar. Also published as window.__hfDecorateBlock, because a block inserted into the live
330
+ // document later (a revealed chat insert, see getBlockPatchScript) arrives after this pass ran.
331
+ function decorate(block){
332
+ if(block.querySelector(':scope > .playground-block-toolbar'))return;
333
+ var id=block.getAttribute('data-block-id');
334
+ var title=block.getAttribute('data-block-title');
335
+ var tb=document.createElement('div');
336
+ tb.className='playground-block-toolbar';
337
+ tb.innerHTML='<span class="playground-block-title">'+title+'</span>'
338
+ +'<button class="playground-block-btn edit" title="Edit">${editSvg}</button>'
339
+ +${allowDelete ? `'<button class="playground-block-btn delete" title="Remove">${trashSvg}</button>'` : "''"};
340
+ block.insertBefore(tb,block.firstChild);
341
+ tb.addEventListener('click',function(e){
342
+ var btn=e.target.closest('.playground-block-btn');
343
+ if(!btn)return;
344
+ e.stopPropagation();e.preventDefault();
345
+ var action=btn.classList.contains('edit')?'edit':'delete';
346
+ window.parent.postMessage({type:'playground-block-action',action:action,blockId:id},'*');
347
+ });
348
+ }
349
+ document.querySelectorAll('.playground-block').forEach(decorate);
350
+ window.__hfDecorateBlock=decorate;
351
+
352
+ // Selecting a block in the rail should bring it into view. The reverse direction already worked —
353
+ // clicking a block in the canvas selected it — so the canvas could scroll you to a block but the
354
+ // list could not, which reads as the click doing nothing. Matters more since the rail now swaps to
355
+ // the editor on select: without this you lose your place in the page entirely.
356
+ window.addEventListener('message',function(event){
357
+ if(!event.data||event.data.type!=='playground-scroll-to-block')return;
358
+ var target=document.querySelector('.playground-block[data-block-id="'+event.data.blockId+'"]');
359
+ if(!target)return;
360
+ target.scrollIntoView({behavior:'smooth',block:'start'});
361
+ });
362
+
363
+ // Where we are in the page, reported so the next rebuild can put us back. Coalesced to one message per frame:
364
+ // scroll fires far faster than the parent needs, and the parent only ever keeps the latest.
365
+ var pending=false;
366
+ window.addEventListener('scroll',function(){
367
+ if(pending)return;
368
+ pending=true;
369
+ requestAnimationFrame(function(){
370
+ pending=false;
371
+ window.parent.postMessage({type:'playground-scroll',y:window.scrollY},'*');
372
+ });
373
+ },{passive:true});
374
+
375
+ ${
376
+ restoreScrollY > 0
377
+ ? `
378
+ // Restored twice on purpose: once now, when stylesheets have applied and the layout is broadly right, and again
379
+ // after \`load\`, because images finishing changes the document height — a scroll set past the height the document
380
+ // had a moment ago is silently clamped, landing you short of where you were.
381
+ //
382
+ // The retry is abandoned if you moved yourself, detected from *input* events rather than by comparing scroll
383
+ // positions: a clamped restore also leaves \`scrollY\` far from the target, so position alone cannot tell
384
+ // "the user scrolled away" from "the restore did not reach".
385
+ var restoreY=${Math.round(restoreScrollY)};
386
+ var userMoved=false;
387
+ ['wheel','touchstart','keydown','mousedown'].forEach(function(t){
388
+ window.addEventListener(t,function(){userMoved=true;},{passive:true,once:true});
389
+ });
390
+ window.scrollTo(0,restoreY);
391
+ window.addEventListener('load',function(){
392
+ if(!userMoved) window.scrollTo(0,restoreY);
393
+ });`
394
+ : ''
395
+ }
396
+ })();
397
+ `;
398
+ }
399
+
400
+ /**
401
+ * The frame's half of live block patching.
402
+ *
403
+ * A pure content edit (chat changeset, rail commit) re-renders ONE Handlebars block's HTML; swapping the
404
+ * whole `srcdoc` for that threw away every block's DOM, the scroll position, and any open overlay. This
405
+ * listener replaces just the addressed block's markup inside its `.playground-block` wrapper — the wrapper
406
+ * itself, its toolbar, and their listeners all survive.
407
+ *
408
+ * Two things to keep honest:
409
+ * - the toolbar is a child of the wrapper, injected by `getBlockControlsScript`; it is lifted out before the
410
+ * innerHTML write and put back after, listeners intact.
411
+ * - the inline-edit script's marks for this block now point into detached DOM — the `hf-block-patched` event
412
+ * tells it to re-collect (see `inlineEditScript`). Fired document-level because the two scripts share a
413
+ * document but no scope.
414
+ *
415
+ * `<script>` tags inside patched markup do not execute (innerHTML semantics) — for an UPDATE that is fine:
416
+ * the block's scripts loaded with the original document and stay loaded.
417
+ */
418
+ function getBlockPatchScript(): string {
419
+ return `
420
+ (function(){
421
+ // ── DOM morph ─────────────────────────────────────────────────────────────
422
+ // The new markup comes as one HTML string, but for a copy edit almost all of it is identical to the
423
+ // live DOM. Diffing the two trees pairwise means only the nodes that actually changed are touched —
424
+ // and only THEY fade, instead of the whole block. Index-paired, not keyed: both sides come from the
425
+ // same template, so for content edits the structure lines up; where it does not, the mismatched
426
+ // subtree is replaced wholesale and fades as a region.
427
+ //
428
+ // Two passes over the same deterministic walk: pass 1 (mutate=false) only reports the live elements
429
+ // that WILL change, so they can fade out while still showing the old content; pass 2 (mutate=true)
430
+ // applies the changes and reports what should fade back in. Comment nodes (the {{#field}} marks) are
431
+ // synced silently — they render nothing, so they never fade.
432
+
433
+ function attrsDiffer(a,b){
434
+ if(a.attributes.length!==b.attributes.length)return true;
435
+ for(var i=0;i<b.attributes.length;i++){
436
+ var at=b.attributes[i];
437
+ if(a.getAttribute(at.name)!==at.value)return true;
438
+ }
439
+ return false;
440
+ }
441
+ function syncAttrs(a,b){
442
+ var changed=false;
443
+ for(var i=0;i<b.attributes.length;i++){
444
+ var at=b.attributes[i];
445
+ if(a.getAttribute(at.name)!==at.value){a.setAttribute(at.name,at.value);changed=true;}
446
+ }
447
+ for(var j=a.attributes.length-1;j>=0;j--){
448
+ var n=a.attributes[j].name;
449
+ if(!b.hasAttribute(n)){a.removeAttribute(n);changed=true;}
450
+ }
451
+ return changed;
452
+ }
453
+ function hostOf(node){return node.nodeType===1?node:node.parentElement;}
454
+
455
+ function morphChildren(live,next,mutate,out){
456
+ // The toolbar is ours, injected by the controls script — it is not in the incoming markup and must
457
+ // be invisible to the diff.
458
+ var lk=[];
459
+ for(var i=0;i<live.childNodes.length;i++){
460
+ var c=live.childNodes[i];
461
+ if(c.nodeType===1&&c.classList&&c.classList.contains('playground-block-toolbar'))continue;
462
+ lk.push(c);
463
+ }
464
+ var nk=next.childNodes;
465
+ var max=Math.max(lk.length,nk.length);
466
+ for(var k=0;k<max;k++){
467
+ var a=lk[k],b=nk[k];
468
+ if(a&&!b){
469
+ if(mutate){if(a.parentNode)a.parentNode.removeChild(a);}
470
+ else if(hostOf(a))out.push(hostOf(a));
471
+ continue;
472
+ }
473
+ if(!a&&b){
474
+ if(mutate){
475
+ var added=document.importNode(b,true);
476
+ live.appendChild(added);
477
+ out.push(added.nodeType===1?added:live);
478
+ } else {
479
+ out.push(live);
480
+ }
481
+ continue;
482
+ }
483
+ if(a.nodeType===3&&b.nodeType===3){
484
+ if(a.data!==b.data){
485
+ if(mutate)a.data=b.data;
486
+ if(hostOf(a))out.push(hostOf(a));
487
+ }
488
+ continue;
489
+ }
490
+ if(a.nodeType===8&&b.nodeType===8){
491
+ if(mutate&&a.data!==b.data)a.data=b.data;
492
+ continue;
493
+ }
494
+ if(a.nodeType===1&&b.nodeType===1&&a.tagName===b.tagName){
495
+ if(mutate){if(syncAttrs(a,b))out.push(a);}
496
+ else if(attrsDiffer(a,b))out.push(a);
497
+ morphChildren(a,b,mutate,out);
498
+ continue;
499
+ }
500
+ // Different node kinds at the same position — replace the subtree, fade it as a region.
501
+ if(mutate){
502
+ var repl=document.importNode(b,true);
503
+ if(a.parentNode)a.parentNode.replaceChild(repl,a);
504
+ out.push(repl.nodeType===1?repl:hostOf(repl)||live);
505
+ } else if(hostOf(a)){
506
+ out.push(hostOf(a));
507
+ }
508
+ }
509
+ }
510
+
511
+ function setFade(els,opacity,ms){
512
+ els.forEach(function(el){
513
+ if(!el||el.nodeType!==1)return;
514
+ el.style.transition='opacity '+ms+'ms ease';
515
+ el.style.opacity=opacity;
516
+ });
517
+ }
518
+ function clearFade(els){
519
+ els.forEach(function(el){
520
+ if(!el||el.nodeType!==1)return;
521
+ el.style.transition='';
522
+ el.style.opacity='';
523
+ });
524
+ }
525
+
526
+ // ── Reorder (FLIP) ────────────────────────────────────────────────────────
527
+ // A sidebar drag permutes the same blocks; rebuilding the document for that threw away the live DOM
528
+ // and could not animate. The wrappers are MOVED into the new order, then classic FLIP: measure old
529
+ // positions, move, invert with transforms so nothing visually jumps, and transition the transforms
530
+ // away so each block slides to its new place. Moved, not recreated — toolbars, listeners, marks and
531
+ // the selection highlight all ride along.
532
+ window.addEventListener('message',function(event){
533
+ var d=event.data;
534
+ if(!d||d.type!=='playground-reorder-blocks'||!Array.isArray(d.order))return;
535
+ var list=document.querySelectorAll('.playground-block');
536
+ if(!list.length)return;
537
+ var parent=list[0].parentNode;
538
+ var blocks={};
539
+ var first={};
540
+ list.forEach(function(b){
541
+ var id=b.getAttribute('data-block-id');
542
+ blocks[id]=b;
543
+ first[id]=b.getBoundingClientRect().top;
544
+ });
545
+ d.order.forEach(function(id){
546
+ var b=blocks[id];
547
+ if(b)parent.appendChild(b);
548
+ });
549
+ d.order.forEach(function(id){
550
+ var b=blocks[id];
551
+ if(!b)return;
552
+ var delta=first[id]-b.getBoundingClientRect().top;
553
+ b.style.transition='none';
554
+ b.style.transform=delta?('translateY('+delta+'px)'):'';
555
+ });
556
+ // Style flush so the inverted positions are committed before the play transition starts.
557
+ void document.body.offsetWidth;
558
+ Object.keys(blocks).forEach(function(id){
559
+ var b=blocks[id];
560
+ b.style.transition='transform 300ms ease';
561
+ b.style.transform='';
562
+ });
563
+ setTimeout(function(){
564
+ Object.keys(blocks).forEach(function(id){
565
+ blocks[id].style.transition='';
566
+ });
567
+ },340);
568
+ });
569
+
570
+ // ── Insert (reveal) ───────────────────────────────────────────────────────
571
+ // A chat changeset that ADDS blocks used to rebuild the document, which swapped the page in one frame.
572
+ // Instead the new wrappers are inserted at their final places, invisible, so layout is final at once —
573
+ // and everything visible from here on is a transform or an opacity, never a height. FLIP keeps the
574
+ // existing blocks painted where they were (the page just grew by the new blocks' height, as blank tail);
575
+ // the parent zooms the card out to fit that final height, then says "play": the existing blocks slide
576
+ // to their laid-out places, opening the gaps, and the new blocks fade into them.
577
+ //
578
+ // parent: playground-insert-blocks {order, blocks} → frame stages, replies playground-insert-staged {h}
579
+ // parent: zooms out, then playground-insert-play → frame slides + fades, replies playground-insert-done
580
+ //
581
+ // Removal is the same choreography run backwards — playground-remove-blocks {ids} stages the leaving
582
+ // blocks (still in flow, so nothing moves yet) and replies with the CURRENT height; the parent zooms out
583
+ // to fit that, says "play", and the leaving blocks fade out before the survivors slide up to close the
584
+ // gaps. Same messages back to the parent, so the zoom-out / hold / zoom-in on that side is shared.
585
+ var reveal=null;
586
+ function revealFinish(){
587
+ if(!reveal)return null;
588
+ var r=reveal;reveal=null;
589
+ r.timers.forEach(clearTimeout);
590
+ r.existing.forEach(function(b){b.style.transition='';b.style.transform='';b.style.willChange='';});
591
+ r.entering.forEach(function(b){b.style.transition='';b.style.transform='';b.style.opacity='';b.style.willChange='';});
592
+ // A removal cut short still removes: the end state is the page without them.
593
+ r.leaving.forEach(function(b){if(b.parentNode)b.parentNode.removeChild(b);});
594
+ // The inline-edit script's marks for the new blocks: wired once, when the block is final.
595
+ r.entering.forEach(function(b){
596
+ document.dispatchEvent(new CustomEvent('hf-block-patched',{detail:{blockId:b.getAttribute('data-block-id')}}));
597
+ });
598
+ return r;
599
+ }
600
+ function pageHeight(){
601
+ var h=0;var kids=document.body.children;
602
+ for(var k=0;k<kids.length;k++){
603
+ var e=kids[k];var r=e.getBoundingClientRect();
604
+ var tf=e.style?e.style.transform||'':'';var at=tf.indexOf('translateY(');
605
+ var bottom=r.bottom-(at>=0?parseFloat(tf.slice(at+11))||0:0);
606
+ if(bottom>h)h=bottom;
607
+ }
608
+ return Math.ceil(h);
609
+ }
610
+ window.addEventListener('message',function(event){
611
+ var d=event.data;
612
+ if(!d||d.type!=='playground-insert-blocks'||!Array.isArray(d.order)||!Array.isArray(d.blocks))return;
613
+ // A reveal still running when the next one arrives snaps to its end state first.
614
+ revealFinish();
615
+ var list=document.querySelectorAll('.playground-block');
616
+ if(!list.length)return;
617
+ var parent=list[0].parentNode;
618
+ var byId={};var first={};
619
+ list.forEach(function(b){var id=b.getAttribute('data-block-id');byId[id]=b;first[id]=b.offsetTop;});
620
+ var incoming={};
621
+ d.blocks.forEach(function(nb){incoming[nb.blockId]=nb;});
622
+ var entering=[];
623
+ // Walk the final order; each new block goes before the nearest block that follows it and is already in
624
+ // the document. Existing wrappers are never detached — a re-appended iframe or video inside one reloads.
625
+ for(var i=0;i<d.order.length;i++){
626
+ var id=d.order[i];
627
+ var nb=incoming[id];
628
+ if(!nb||byId[id])continue;
629
+ var el=document.createElement('div');
630
+ el.className='playground-block';
631
+ el.setAttribute('data-block-id',String(nb.blockId));
632
+ el.setAttribute('data-block-title',String(nb.title||''));
633
+ el.innerHTML=String(nb.html||'');
634
+ if(window.__hfDecorateBlock)window.__hfDecorateBlock(el);
635
+ el.style.transition='none';
636
+ el.style.opacity='0';
637
+ el.style.transform='translateY(14px)';
638
+ el.style.willChange='opacity,transform';
639
+ var ref=null;
640
+ for(var j=i+1;j<d.order.length;j++){if(byId[d.order[j]]){ref=byId[d.order[j]];break;}}
641
+ parent.insertBefore(el,ref);
642
+ byId[id]=el;
643
+ entering.push(el);
644
+ }
645
+ if(!entering.length)return;
646
+ var existing=Array.prototype.slice.call(list);
647
+ // FLIP invert: offsetTop ignores transforms, so re-running this against a changed layout stays exact.
648
+ function invert(){
649
+ existing.forEach(function(b){
650
+ var delta=first[b.getAttribute('data-block-id')]-b.offsetTop;
651
+ b.style.transition='none';
652
+ b.style.willChange='transform';
653
+ b.style.transform=delta?('translateY('+delta+'px)'):'';
654
+ });
655
+ }
656
+ invert();
657
+ void document.body.offsetWidth;
658
+ var r={existing:existing,entering:entering,leaving:[],timers:[]};
659
+ reveal=r;
660
+ // Images in the new blocks change their height as they land. Wait for them — briefly — so the height
661
+ // the parent zooms to is the final one, then re-invert against the settled layout.
662
+ var pending=[];
663
+ entering.forEach(function(b){
664
+ Array.prototype.forEach.call(b.querySelectorAll('img'),function(im){if(!im.complete)pending.push(im);});
665
+ });
666
+ var settle=pending.length
667
+ ?Promise.race([
668
+ Promise.all(pending.map(function(im){return new Promise(function(res){
669
+ im.addEventListener('load',res,{once:true});im.addEventListener('error',res,{once:true});
670
+ });})),
671
+ new Promise(function(res){setTimeout(res,400);})
672
+ ])
673
+ :Promise.resolve();
674
+ settle.then(function(){
675
+ if(reveal!==r)return;
676
+ invert();
677
+ window.parent.postMessage({type:'playground-insert-staged',h:pageHeight()},'*');
678
+ });
679
+ });
680
+ window.addEventListener('message',function(event){
681
+ var d=event.data;
682
+ if(!d||d.type!=='playground-remove-blocks'||!Array.isArray(d.ids))return;
683
+ revealFinish();
684
+ var leaving=[];var existing=[];
685
+ var gone={};d.ids.forEach(function(id){gone[String(id)]=true;});
686
+ document.querySelectorAll('.playground-block').forEach(function(b){
687
+ if(gone[b.getAttribute('data-block-id')])leaving.push(b);else existing.push(b);
688
+ });
689
+ if(!leaving.length)return;
690
+ leaving.forEach(function(b){b.style.willChange='opacity,transform';});
691
+ reveal={existing:existing,entering:[],leaving:leaving,timers:[]};
692
+ // Nothing has moved: the height the parent fits is the page as it stands, about to shrink.
693
+ window.parent.postMessage({type:'playground-insert-staged',h:pageHeight()},'*');
694
+ });
695
+ window.addEventListener('message',function(event){
696
+ var d=event.data;
697
+ if(!d||d.type!=='playground-insert-play'||!reveal)return;
698
+ var r=reveal;
699
+ if(r.leaving.length){
700
+ // Fade the leaving blocks out where they sit, then take them out of flow and FLIP the survivors from
701
+ // their old positions to the closed-up layout — the same slide the insert plays, in the other direction.
702
+ r.leaving.forEach(function(b){
703
+ b.style.transition='opacity 340ms ease, transform 340ms cubic-bezier(.2,.8,.2,1)';
704
+ b.style.opacity='0';
705
+ b.style.transform='translateY(14px)';
706
+ });
707
+ r.timers.push(setTimeout(function(){
708
+ if(reveal!==r)return;
709
+ var first={};
710
+ r.existing.forEach(function(b){first[b.getAttribute('data-block-id')]=b.offsetTop;});
711
+ // The block that takes the first leaving block's place is where the eye should land afterwards.
712
+ var landing=null;
713
+ for(var n=r.leaving[0].nextSibling;n;n=n.nextSibling){if(n.classList&&n.classList.contains('playground-block')){landing=n;break;}}
714
+ r.leaving.forEach(function(b){if(b.parentNode)b.parentNode.removeChild(b);});
715
+ r.leaving=[];
716
+ r.existing.forEach(function(b){
717
+ var delta=first[b.getAttribute('data-block-id')]-b.offsetTop;
718
+ b.style.transition='none';
719
+ b.style.willChange='transform';
720
+ b.style.transform=delta?('translateY('+delta+'px)'):'';
721
+ });
722
+ void document.body.offsetWidth;
723
+ r.existing.forEach(function(b){
724
+ b.style.transition='transform 420ms cubic-bezier(.2,.8,.2,1)';
725
+ b.style.transform='';
726
+ });
727
+ r.timers.push(setTimeout(function(){
728
+ revealFinish();
729
+ var top=landing?landing.getBoundingClientRect().top:0;
730
+ window.parent.postMessage({type:'playground-insert-done',firstTop:top},'*');
731
+ },r.existing.length?440:0));
732
+ },360));
733
+ return;
734
+ }
735
+ r.existing.forEach(function(b){
736
+ b.style.transition='transform 420ms cubic-bezier(.2,.8,.2,1)';
737
+ b.style.transform='';
738
+ });
739
+ r.timers.push(setTimeout(function(){
740
+ r.entering.forEach(function(b){
741
+ b.style.transition='opacity 340ms ease, transform 340ms cubic-bezier(.2,.8,.2,1)';
742
+ b.style.opacity='1';
743
+ b.style.transform='';
744
+ });
745
+ r.timers.push(setTimeout(function(){
746
+ var done=revealFinish();
747
+ var firstTop=done&&done.entering.length?done.entering[0].getBoundingClientRect().top:0;
748
+ window.parent.postMessage({type:'playground-insert-done',firstTop:firstTop},'*');
749
+ },380));
750
+ },r.existing.length?420:0));
751
+ });
752
+
753
+ window.addEventListener('message',function(event){
754
+ var d=event.data;
755
+ if(!d||d.type!=='playground-replace-block-html')return;
756
+ var block=document.querySelector('.playground-block[data-block-id="'+d.blockId+'"]');
757
+ if(!block)return;
758
+
759
+ // A second patch arriving mid-animation cancels the pending apply — only the newest markup lands.
760
+ if(block.__hfPatchTimer){clearTimeout(block.__hfPatchTimer);block.__hfPatchTimer=null;}
761
+ if(block.__hfCleanupTimer){clearTimeout(block.__hfCleanupTimer);block.__hfCleanupTimer=null;}
762
+
763
+ var tpl=document.createElement('template');
764
+ tpl.innerHTML=String(d.html||'');
765
+
766
+ // Live typing (the rail editor posts instant:true on every keystroke): apply the morph with no
767
+ // fade at all. The fade below reads as the canvas "acknowledging" a deliberate edit; per keystroke
768
+ // it reads as the whole block flickering.
769
+ if(d.instant){
770
+ try{
771
+ var quiet=[];
772
+ morphChildren(block,tpl.content,true,quiet);
773
+ }catch(err){
774
+ var tb=block.querySelector('.playground-block-toolbar');
775
+ if(tb&&tb.parentElement===block)tb.remove();else tb=null;
776
+ block.innerHTML=String(d.html||'');
777
+ if(tb)block.insertBefore(tb,block.firstChild);
778
+ }
779
+ document.dispatchEvent(new CustomEvent('hf-block-patched',{detail:{blockId:d.blockId}}));
780
+ return;
781
+ }
782
+
783
+ function finish(fadeIn){
784
+ document.dispatchEvent(new CustomEvent('hf-block-patched',{detail:{blockId:d.blockId}}));
785
+ if(!fadeIn.length)return;
786
+ setFade(fadeIn,'0',0);
787
+ void block.offsetWidth;
788
+ setFade(fadeIn,'1',200);
789
+ block.__hfCleanupTimer=setTimeout(function(){
790
+ block.__hfCleanupTimer=null;
791
+ clearFade(fadeIn);
792
+ },230);
793
+ }
794
+
795
+ try{
796
+ var willChange=[];
797
+ morphChildren(block,tpl.content,false,willChange);
798
+ if(!willChange.length){
799
+ // Nothing differs beyond comments/marks — sync those silently, no animation at all.
800
+ var silent=[];
801
+ morphChildren(block,tpl.content,true,silent);
802
+ document.dispatchEvent(new CustomEvent('hf-block-patched',{detail:{blockId:d.blockId}}));
803
+ return;
804
+ }
805
+ setFade(willChange,'0',150);
806
+ block.__hfPatchTimer=setTimeout(function(){
807
+ block.__hfPatchTimer=null;
808
+ var fadeIn=[];
809
+ morphChildren(block,tpl.content,true,fadeIn);
810
+ clearFade(willChange);
811
+ finish(fadeIn);
812
+ },160);
813
+ }catch(err){
814
+ // The diff is best-effort; the swap is the guarantee. Whole-block fade, as before the morph.
815
+ block.style.transition='opacity 150ms ease';
816
+ block.style.opacity='0';
817
+ block.__hfPatchTimer=setTimeout(function(){
818
+ block.__hfPatchTimer=null;
819
+ var toolbar=block.querySelector('.playground-block-toolbar');
820
+ if(toolbar&&toolbar.parentElement===block)toolbar.remove();else toolbar=null;
821
+ block.innerHTML=String(d.html||'');
822
+ if(toolbar)block.insertBefore(toolbar,block.firstChild);
823
+ document.dispatchEvent(new CustomEvent('hf-block-patched',{detail:{blockId:d.blockId}}));
824
+ void block.offsetWidth;
825
+ block.style.transition='opacity 200ms ease';
826
+ block.style.opacity='1';
827
+ block.__hfCleanupTimer=setTimeout(function(){
828
+ block.__hfCleanupTimer=null;
829
+ block.style.transition='';
830
+ block.style.opacity='';
831
+ },230);
832
+ },160);
833
+ }
834
+ });
835
+ })();
836
+ `;
837
+ }
838
+
839
+ /**
840
+ * Click-to-target selection (chat scoping).
841
+ *
842
+ * A click on a block reports it to the parent, which owns the selection state and answers with
843
+ * `playground-select-block` — this script only paints: an inset blue edge on the selected block,
844
+ * monochrome-and-dimmed on everything else. Toolbar buttons and inline-edit field hits stopPropagation
845
+ * before the document-level listener here sees them, so those clicks keep their own meanings.
846
+ */
847
+ const BLOCK_SELECT_CSS = `
848
+ .playground-block{transition:filter .2s ease,opacity .2s ease}
849
+ /* Rail hover mirrored onto the canvas: translucent, so it reads as "pointing at", not "selected". */
850
+ .hf-block-hover{outline:3px solid rgba(37,99,235,.45)}
851
+ /* Outline, not box-shadow: the block's content paints over an inset shadow on its wrapper, while an
852
+ outline draws on top of descendants. Inset offset so it hugs the block edge. #2563eb = the rail
853
+ highlight's blue-600, so the canvas and the list agree on what selection looks like. Declared after
854
+ the hover rule so a hovered selected block stays solid. */
855
+ .hf-block-selected{outline:3px solid #2563eb}
856
+ .hf-block-dimmed{filter:grayscale(1);opacity:.6}
857
+ `;
858
+
859
+ function getBlockSelectScript(): string {
860
+ return `
861
+ (function(){
862
+ document.addEventListener('click',function(e){
863
+ var t=e.target;
864
+ var block=t&&t.closest?t.closest('.playground-block'):null;
865
+ if(!block)return;
866
+ window.parent.postMessage({type:'playground-block-click',blockId:block.getAttribute('data-block-id')},'*');
867
+ });
868
+ window.addEventListener('message',function(event){
869
+ var d=event.data;
870
+ if(!d||d.type!=='playground-select-block')return;
871
+ var id=d.blockId||null;
872
+ document.querySelectorAll('.playground-block').forEach(function(b){
873
+ var sel=!!id&&b.getAttribute('data-block-id')===id;
874
+ b.classList.toggle('hf-block-selected',sel);
875
+ b.classList.toggle('hf-block-dimmed',!!id&&!sel);
876
+ });
877
+ });
878
+
879
+ // Hover linking, both directions. Out: which block the pointer is over, reported on change so the
880
+ // rail can light the matching row. In: the rail's hovered row painted here as a translucent outline.
881
+ var hovered=null;
882
+ function reportHover(id){
883
+ if(id===hovered)return;
884
+ hovered=id;
885
+ window.parent.postMessage({type:'playground-block-hover',blockId:id},'*');
886
+ }
887
+ document.addEventListener('mouseover',function(e){
888
+ var b=e.target&&e.target.closest?e.target.closest('.playground-block'):null;
889
+ reportHover(b?b.getAttribute('data-block-id'):null);
890
+ });
891
+ document.addEventListener('mouseout',function(e){
892
+ // Leaving the document entirely — mouseleave does not bubble, so this is the reliable signal.
893
+ if(!e.relatedTarget)reportHover(null);
894
+ });
895
+ window.addEventListener('message',function(event){
896
+ var d=event.data;
897
+ if(!d||d.type!=='playground-hover-block')return;
898
+ var id=d.blockId||null;
899
+ document.querySelectorAll('.playground-block').forEach(function(b){
900
+ b.classList.toggle('hf-block-hover',!!id&&b.getAttribute('data-block-id')===id);
901
+ });
902
+ });
903
+ })();
904
+ `;
905
+ }
906
+
907
+ export async function constructComponentPreview(
908
+ components: SelectedPlaygroundComponent[],
909
+ basePath: string = '',
910
+ options?: {
911
+ injectBlockControls?: boolean;
912
+ allowDelete?: boolean;
913
+ /**
914
+ * Inline editing on `{{#field}}` marks (roadmap F.2). Off unless asked for: a read-only surface must not
915
+ * offer an editor, and a React block carries no marks so the script no-ops there anyway.
916
+ */
917
+ inlineEdit?: boolean;
918
+ /**
919
+ * Guardrail limits so the overlay shows the same counter the rail does, as
920
+ * `{ [blockId]: { [fieldPath]: maxLength } }`.
921
+ *
922
+ * Nested per block because two components can declare different limits for the same field name — `title` at
923
+ * 60 on one and 80 on another — and a flat map showed one block the other's number.
924
+ */
925
+ fieldLimits?: Record<string, Record<string, number>>;
926
+ /**
927
+ * Field paths a text overlay may edit. Anything absent gets no affordance — see `textEditableFieldPaths`
928
+ * for the two shapes that made a whitelist necessary rather than optional.
929
+ */
930
+ editableFields?: string[];
931
+ /**
932
+ * Scroll offset to land at, from the frame's own last report. Passed on a rebuild so a committed edit does
933
+ * not send the reader back to the top of the page — see `getBlockControlsScript`.
934
+ */
935
+ restoreScrollY?: number;
936
+ /** Field paths whose overlay commits markup rather than words — roadmap F.2b. */
937
+ richtextFields?: string[];
938
+ /**
939
+ * Answer `scroll-to-block` and `highlight-field` **without** offering any editing.
940
+ *
941
+ * The review canvas has no block controls and no inline editing, which meant clicking a finding could not show
942
+ * you the thing it was about — the message went to a frame with nothing listening. This injects the same mark
943
+ * script with an empty editable list: it collects the marks and answers the two navigation messages, and
944
+ * because no field is listed as editable it adds no hit areas, no hover reporting and no click-to-edit.
945
+ */
946
+ fieldNavigation?: boolean;
947
+ /** Neutralise anchors and forms, so a click in the canvas cannot navigate the frame away — see `getLinkGuardScript`. */
948
+ interceptLinks?: boolean;
949
+ /** Click-to-target selection for chat scoping — see `getBlockSelectScript`. */
950
+ blockSelection?: boolean;
951
+ /**
952
+ * The parent's wrapper scrolls, not this frame — pairs with `<Preview scrollHost>`.
953
+ *
954
+ * Injects a reporter that keeps the parent told of the document's height (so it can size the frame to its
955
+ * full content) and answers `scroll-to-block` with the block's document position, because `scrollIntoView`
956
+ * inside a frame that no longer scrolls cannot reach a scroller on the other side of the sandbox boundary.
957
+ */
958
+ hostScroll?: boolean;
959
+ /**
960
+ * The shared importmap, to inline instead of having the canvas fetch it — see `importmapReadyScript`.
961
+ * Omit it and the map is loaded (once) from the parent document.
962
+ */
963
+ importmap?: string | null;
964
+ }
965
+ ): Promise<string> {
966
+ const importmap = options?.importmap ?? (await loadSharedImportmap(basePath));
967
+ let bodyInner = '';
968
+ const reactScripts: string[] = [];
969
+ const cssOverrides = new Set<string>();
970
+ const componentCssIds = new Set<string>();
971
+ const injectControls = options?.injectBlockControls ?? false;
972
+ /**
973
+ * Blocks are wrapped for navigation as well as for controls.
974
+ *
975
+ * `scroll-to-block` finds its target by `.playground-block[data-block-id]`, and that wrapper only existed when
976
+ * controls were injected — so on the review canvas the selector matched nothing and the jump was a no-op even
977
+ * once a listener existed.
978
+ */
979
+ const wrapBlocks = injectControls || (options?.fieldNavigation ?? false);
980
+ let reactIdx = 0;
981
+
982
+ for (const component of components) {
983
+ if (component.options?.preview?.css) {
984
+ cssOverrides.add(component.options.preview.css);
985
+ }
986
+ // Every block's own stylesheet, whatever its format. The single-block preview always linked
987
+ // `/api/component/<id>.css`; the canvas did so for React blocks only, so a Handlebars block whose rules
988
+ // were not also in `main.css` rendered bare here and styled everywhere else.
989
+ componentCssIds.add(component.id);
990
+
991
+ let blockHtml: string;
992
+ if (component.format === 'react') {
993
+ const suffix = `_pg_${reactIdx++}`;
994
+ const rootId = `root${suffix}`;
995
+ const propsId = `__PROPS__${suffix}`;
996
+ const fallbackId = `__FALLBACK__${suffix}`;
997
+ const propsJson = JSON.stringify(toWireArgs(component.data ?? {}, component.properties));
998
+ const fallbackHtml = JSON.stringify(component.html || '');
999
+ const bid = component.uniqueId || '';
1000
+ blockHtml =
1001
+ `<script id="${propsId}" type="application/json">${propsJson}</script>` +
1002
+ `<script id="${fallbackId}" type="application/json">${fallbackHtml}</script>` +
1003
+ `<div id="${rootId}"></div>`;
1004
+ // Classic script (NOT type="module") so the shared importmap can be
1005
+ // injected first; each block awaits `__handoffImportmapReady` before its
1006
+ // dynamic import so bare-specifier vendors resolve. See importmapReadyScript.
1007
+ reactScripts.push(` <script>
1008
+ (function(){
1009
+ var blockId = ${JSON.stringify(bid)};
1010
+ var container = document.getElementById(${JSON.stringify(rootId)});
1011
+ var el = document.getElementById(${JSON.stringify(propsId)});
1012
+ var initialProps = el ? JSON.parse(el.textContent || '{}') : {};
1013
+ var fb = document.getElementById(${JSON.stringify(fallbackId)});
1014
+ var fallbackHtml = fb ? JSON.parse(fb.textContent || '""') : '';
1015
+ (window.__handoffImportmapReady || Promise.resolve())
1016
+ .then(function(){ return import('${basePath}/api/component/${component.id}-client.mjs'); })
1017
+ .then(function(m) {
1018
+ m.render(container, initialProps);
1019
+ window.addEventListener('message', function (event) {
1020
+ if (!event.data || event.data.type !== 'update-props') return;
1021
+ if (event.data.blockId && event.data.blockId !== blockId) return;
1022
+ m.update(event.data.props);
1023
+ /**
1024
+ * Tell the inline editor this block was patched — the React counterpart of the event
1025
+ * \`playground-replace-block-html\` already fires for a patched Handlebars block.
1026
+ *
1027
+ * It is what closes an overlay that is now floating over re-rendered markup. *Finding* the new
1028
+ * marks is the observer's job in \`inline-edit-script\`: React commits asynchronously, so no
1029
+ * number of frames' delay here is a promise that the new nodes exist yet.
1030
+ */
1031
+ requestAnimationFrame(function () {
1032
+ document.dispatchEvent(new CustomEvent('hf-block-patched', { detail: { blockId: blockId } }));
1033
+ });
1034
+ });
1035
+ })
1036
+ .catch(function() {
1037
+ // module not available — render static HTML snapshot instead
1038
+ if (fallbackHtml) container.innerHTML = fallbackHtml;
1039
+ });
1040
+ })();
1041
+ </script>`);
1042
+ } else if (component.rendered) {
1043
+ blockHtml = component.rendered;
1044
+ } else {
1045
+ blockHtml = component.html || '';
1046
+ }
1047
+
1048
+ if (wrapBlocks && component.uniqueId) {
1049
+ bodyInner += `<div class="playground-block" data-block-id="${escapeAttr(component.uniqueId)}" data-block-title="${escapeAttr(component.title)}">${blockHtml}</div>`;
1050
+ } else {
1051
+ bodyInner += blockHtml;
1052
+ }
1053
+ }
1054
+
1055
+ const perComponentCss = Array.from(componentCssIds)
1056
+ .map((id) => `\n <link rel="stylesheet" href="${basePath}/api/component/${id}.css" />`)
1057
+ .join('');
1058
+
1059
+ const cssOverrideLinks = Array.from(cssOverrides)
1060
+ .map((href) => `\n <link rel="stylesheet" href="${href}" />`)
1061
+ .join('');
1062
+
1063
+ const controlsStyle = injectControls ? `<style>${BLOCK_CONTROLS_CSS}</style>` : '';
1064
+ const controlsScript = injectControls
1065
+ ? `<script>${getBlockControlsScript(options?.allowDelete ?? true, options?.restoreScrollY ?? 0)}</script>`
1066
+ : '';
1067
+ const marksScript = (options?.inlineEdit ?? false) || (options?.fieldNavigation ?? false);
1068
+ const inlineEditStyle = marksScript ? `<style>${INLINE_EDIT_CSS}</style>` : '';
1069
+ // After the controls script, so its click handler is registered first and the field handler can stop the
1070
+ // event before "select this block" swallows it.
1071
+ //
1072
+ // The editable lists are emptied when this is navigation only: one script, and "may this be edited" stays a
1073
+ // single question answered in one place rather than a second near-copy of the mark walker.
1074
+ const inlineEditJs = marksScript
1075
+ ? `<script>${inlineEditScript(
1076
+ options?.fieldLimits ?? {},
1077
+ options?.inlineEdit ? (options.editableFields ?? []) : [],
1078
+ options?.inlineEdit ? (options.richtextFields ?? []) : []
1079
+ )}</script>`
1080
+ : '';
1081
+ const linkGuardJs = options?.interceptLinks ? `<script>${getLinkGuardScript()}</script>` : '';
1082
+ const hostScrollJs = options?.hostScroll ? `<script>${getHostScrollScript()}</script>` : '';
1083
+ // Patching addresses blocks by their wrapper, so it rides with wrapBlocks — a canvas without wrappers
1084
+ // has nothing to patch into and falls back to full rebuilds.
1085
+ const blockPatchJs = wrapBlocks ? `<script>${getBlockPatchScript()}</script>` : '';
1086
+ const blockSelectJs =
1087
+ options?.blockSelection && wrapBlocks ? `<style>${BLOCK_SELECT_CSS}</style><script>${getBlockSelectScript()}</script>` : '';
1088
+
1089
+ // Body margin zeroed before the theme loads: the canvas stacks blocks edge to edge, and a registry whose theme
1090
+ // carries no reset (or serves empty) otherwise shows the browser's 8px default around the page.
1091
+ return `<html>
1092
+ <head>
1093
+ ${importmapReadyScript(basePath, importmap)}
1094
+ <style>body{margin:0}</style>
1095
+ <link rel="stylesheet" href="${basePath}/api/registry/theme.css" />
1096
+ <link rel="stylesheet" href="${basePath}/api/component/main.css" />
1097
+ <link rel="stylesheet" href="${basePath}/assets/css/preview.css" />${perComponentCss}${cssOverrideLinks}
1098
+ ${controlsStyle}${inlineEditStyle}
1099
+ </head>
1100
+ <body>
1101
+ ${bodyInner}
1102
+ </body>
1103
+ <script src="${basePath}/api/component/main.js"></script>
1104
+ ${reactScripts.join('\n')}
1105
+ ${controlsScript}
1106
+ ${inlineEditJs}
1107
+ ${linkGuardJs}
1108
+ ${hostScrollJs}
1109
+ ${blockPatchJs}
1110
+ ${blockSelectJs}
1111
+ </html>`;
1112
+ }
1113
+
1114
+ /**
1115
+ * The frame's half of host scrolling (see the `hostScroll` option and `<Preview scrollHost>`).
1116
+ *
1117
+ * Height first: the parent sizes the frame to the whole document, so its wrapper — not this window — is the
1118
+ * scroller. ResizeObserver rather than a one-shot measure because images and fonts finishing change the height
1119
+ * after `load`, and a frame sized to the height the document had a moment ago clips the tail of the page.
1120
+ *
1121
+ * Then navigation: `getBlockControlsScript` answers `scroll-to-block` with `scrollIntoView`, which is right when
1122
+ * this window scrolls and a silent no-op when it does not — a non-scrolling frame cannot reach the parent's
1123
+ * scroller across the sandbox boundary. So the request is answered a second way: with the block's document
1124
+ * position, for the parent to scroll its wrapper to. Since this window never scrolls, `getBoundingClientRect().top`
1125
+ * IS the document position — no scroll offset to add back.
1126
+ */
1127
+ function getHostScrollScript(): string {
1128
+ return `
1129
+ (function(){
1130
+ // The wrapper scrolls; this window must never show its own scrollbar. Belt and braces with the height
1131
+ // report below: a fractional-pixel mismatch between the reported height and the laid-out frame is enough
1132
+ // for the frame to decide it overflows and grow a phantom scrollbar.
1133
+ document.documentElement.style.overflow='hidden';
1134
+ // overflow:hidden stops the scrollBAR, not programmatic scrolling: focus, selection and
1135
+ // scrollIntoView can still shift this window inside its clipped viewport, which reads as the top of
1136
+ // the page being cut off. This window must never scroll — the parent's wrapper is the scroller — so
1137
+ // any drift is snapped straight back.
1138
+ window.addEventListener('scroll',function(){
1139
+ if(window.scrollX||window.scrollY)window.scrollTo(0,0);
1140
+ },{passive:true});
1141
+ // CONTENT height, not scrollHeight. scrollHeight is floored at the viewport, and the viewport here IS the
1142
+ // frame height the parent set from the previous report — a feedback loop that could grow but never shrink,
1143
+ // leaving a short page inside a full-canvas-height card. The bottom edge of the body's children is the
1144
+ // page's real extent, and it is immune to the loop (this window never scrolls, so viewport-relative rects
1145
+ // ARE document positions).
1146
+ var lastH=0;
1147
+ var post=function(){
1148
+ var h=0;
1149
+ var kids=document.body?document.body.children:[];
1150
+ for(var i=0;i<kids.length;i++){
1151
+ var k=kids[i];
1152
+ var r=k.getBoundingClientRect();
1153
+ // Layout position, not painted position: a block mid-slide (the FLIP moves in getBlockPatchScript)
1154
+ // carries an inline translateY, and a height read through it shrinks and snaps back with the animation.
1155
+ var tf=k.style?k.style.transform||'':'';
1156
+ var at=tf.indexOf('translateY(');
1157
+ var shift=at>=0?parseFloat(tf.slice(at+11))||0:0;
1158
+ var bottom=r.bottom-shift;
1159
+ if(bottom>h)h=bottom;
1160
+ }
1161
+ // settled: whether this height is from a fully loaded document. A reloading document (any srcdoc
1162
+ // rebuild) parses progressively and reports partial heights on the way — the parent ignores those
1163
+ // once it has a real height, so a rebuild that ends at the same height never moves the card.
1164
+ lastH=Math.ceil(h);
1165
+ window.parent.postMessage({type:'playground-canvas-height',h:lastH,settled:document.readyState==='complete'},'*');
1166
+ };
1167
+ if(typeof ResizeObserver!=='undefined'){
1168
+ var ro=new ResizeObserver(post);
1169
+ ro.observe(document.documentElement);
1170
+ if(document.body)ro.observe(document.body);
1171
+ }
1172
+ // A sandboxed frame can be handed its viewport AFTER load, and a background document may never run the
1173
+ // rendering steps that deliver the observer's callback — so a report of nothing keeps trying, briefly.
1174
+ var retries=0;
1175
+ var retry=function(){
1176
+ if(lastH>0||retries>=8)return;
1177
+ retries++;
1178
+ setTimeout(function(){post();retry();},250);
1179
+ };
1180
+ window.addEventListener('load',function(){post();retry();});
1181
+ post();
1182
+ window.addEventListener('message',function(event){
1183
+ if(!event.data||event.data.type!=='playground-scroll-to-block')return;
1184
+ var target=document.querySelector('.playground-block[data-block-id="'+event.data.blockId+'"]');
1185
+ if(!target)return;
1186
+ window.parent.postMessage({type:'playground-scroll-to-block-at',y:target.getBoundingClientRect().top},'*');
1187
+ });
1188
+ })();
1189
+ `;
1190
+ }
1191
+
1192
+ interface PreviewProps {
1193
+ html: string;
1194
+ className?: string;
1195
+ iframeRef?: React.RefObject<HTMLIFrameElement | null>;
1196
+ /**
1197
+ * Scroll in a padded wrapper around a full-content-height frame, instead of edge-to-edge inside the frame.
1198
+ * The document must be built with `hostScroll: true` — the wrapper is sized by the frame's height reports.
1199
+ */
1200
+ scrollHost?: boolean;
1201
+ /**
1202
+ * Viewport emulation width for the frame, e.g. `'768px'` (`scrollHost` only). The wrapper — the canvas the
1203
+ * reader sees and scrolls — keeps its size; only the frame narrows, centered, so the document lays out at
1204
+ * the device width without the whole canvas jumping around it.
1205
+ */
1206
+ frameWidth?: string;
1207
+ /**
1208
+ * Visual zoom of the frame, e.g. `0.7` (`scrollHost` only). Purely optical: the document keeps its layout
1209
+ * width (`frameWidth` at 100% still lays out to the wrapper's width), then the frame is transform-scaled
1210
+ * down, with a sizing box keeping the layout height honest so the wrapper's scroll extent matches what is
1211
+ * visible.
1212
+ */
1213
+ frameScale?: number;
1214
+ /** Fired when the muted canvas AROUND the page card is clicked (`scrollHost` only) — used to deselect. */
1215
+ onBackdropClick?: () => void;
1216
+ }
1217
+
1218
+ /** Breathing room around the canvas page when the wrapper scrolls (`scrollHost`). */
1219
+ const SCROLL_HOST_PADDING = 30;
1220
+
1221
+ /**
1222
+ * The reveal (a chat insert, see `playground-insert-blocks` in getBlockPatchScript): how long the card takes
1223
+ * to zoom out to the page's final height and back, how long it rests zoomed out once the new blocks are in,
1224
+ * and how far out it may go — a ten-screen page still has to stay legible.
1225
+ */
1226
+ const REVEAL_ZOOM_MS = 480;
1227
+ const REVEAL_HOLD_MS = 450;
1228
+ const REVEAL_MIN_SCALE = 0.25;
1229
+
1230
+ export default function Preview({
1231
+ html,
1232
+ className,
1233
+ iframeRef: externalRef,
1234
+ scrollHost,
1235
+ frameWidth,
1236
+ frameScale,
1237
+ onBackdropClick,
1238
+ }: PreviewProps) {
1239
+ const internalRef = useRef<HTMLIFrameElement>(null);
1240
+ const ref = externalRef || internalRef;
1241
+ const wrapperRef = useRef<HTMLDivElement>(null);
1242
+ const [frameHeight, setFrameHeight] = useState(0);
1243
+ /** Mirror for the message handler, whose effect deliberately doesn't re-subscribe per height change. */
1244
+ const frameHeightRef = useRef(0);
1245
+
1246
+ /**
1247
+ * The wrapper's scroll position, banked when a rebuild swaps the document out.
1248
+ *
1249
+ * A committed edit replaces the whole `srcdoc`; the frame keeps its old height until the new document
1250
+ * reports one, but that first report can be *shorter* than where the reader was, clamping the wrapper to
1251
+ * the top. So the position is saved at the swap and reinstated after the next height report — once, and
1252
+ * skipped if the reader has scrolled in the meantime (their new position wins over their old one).
1253
+ */
1254
+ const savedScrollRef = useRef(0);
1255
+ const restorePendingRef = useRef(false);
1256
+
1257
+ /**
1258
+ * The reveal's zoom, overriding `frameScale` while a chat insert plays out. `slowZoom` keeps the card's
1259
+ * transitions at the reveal's pace for the zoom back too, after the override itself is gone.
1260
+ */
1261
+ const [revealState, setRevealState] = useState<{ scale: number | null; slow: boolean; html: string } | null>(null);
1262
+ // Bound to the document it was staged in: a rebuild replaces that document, and the zoom snaps back with it.
1263
+ const reveal = revealState && revealState.html === html ? revealState : null;
1264
+ const revealScale = reveal?.scale ?? null;
1265
+ const slowZoom = reveal?.slow ?? false;
1266
+ const revealTimersRef = useRef<number[]>([]);
1267
+ const clearRevealTimers = () => {
1268
+ revealTimersRef.current.forEach((t) => window.clearTimeout(t));
1269
+ revealTimersRef.current = [];
1270
+ };
1271
+ /**
1272
+ * Mirrors for the message handler, which does not re-subscribe per render: the document it is talking to
1273
+ * (a reveal is tagged with it) and the scale the reveal departs from and returns to — the toolbar's, read
1274
+ * live so a zoom toggle mid-reveal still lands.
1275
+ */
1276
+ const htmlRef = useRef(html);
1277
+ const baseScaleRef = useRef(1);
1278
+ useEffect(() => {
1279
+ htmlRef.current = html;
1280
+ baseScaleRef.current = scrollHost ? (frameScale ?? 1) : 1;
1281
+ });
1282
+
1283
+ // A ref so the message handler reads the current scale without re-subscribing on every toggle.
1284
+ const scaleRef = useRef(1);
1285
+ scaleRef.current = scrollHost ? (revealScale ?? frameScale ?? 1) : 1;
1286
+
1287
+ useEffect(() => {
1288
+ if (!scrollHost) return;
1289
+ // Runs after the srcdoc swap is committed, but the frame's height attribute is unchanged until the new
1290
+ // document reports in — so scrollTop still reads the pre-swap position here.
1291
+ savedScrollRef.current = wrapperRef.current?.scrollTop ?? 0;
1292
+ restorePendingRef.current = true;
1293
+ // A reveal mid-flight in the replaced document has nothing left to drive.
1294
+ clearRevealTimers();
1295
+ }, [html, scrollHost]);
1296
+ useEffect(() => clearRevealTimers, []);
1297
+
1298
+ useEffect(() => {
1299
+ if (!scrollHost) return;
1300
+ const handler = (event: MessageEvent) => {
1301
+ // Height and navigation reports from OUR frame only — every canvas on the page posts to the same window.
1302
+ if (event.source !== ref.current?.contentWindow) return;
1303
+ if (event.data?.type === 'playground-canvas-height' && typeof event.data.h === 'number') {
1304
+ // Mid-load reports are applied only while we have no height at all (the very first render).
1305
+ // Afterwards the card holds its size through a rebuild and moves once, to the settled height —
1306
+ // letting partial-parse heights through made it shrink and snap back on every reorder.
1307
+ if (event.data.settled === false && frameHeightRef.current > 0) return;
1308
+ frameHeightRef.current = event.data.h;
1309
+ setFrameHeight(event.data.h);
1310
+ if (restorePendingRef.current) {
1311
+ restorePendingRef.current = false;
1312
+ const top = savedScrollRef.current;
1313
+ // Next frame: the height set above must be laid out before the scroll can reach past the old extent.
1314
+ requestAnimationFrame(() => wrapperRef.current?.scrollTo({ top }));
1315
+ }
1316
+ return;
1317
+ }
1318
+ if (event.data?.type === 'playground-scroll-to-block-at' && typeof event.data.y === 'number') {
1319
+ // The reported y is a document position inside the frame — scaled to what the wrapper actually shows —
1320
+ // and the frame starts after the wrapper's padding.
1321
+ const y = event.data.y * scaleRef.current;
1322
+ wrapperRef.current?.scrollTo({ top: Math.max(0, y + SCROLL_HOST_PADDING - 8), behavior: 'smooth' });
1323
+ return;
1324
+ }
1325
+ // The frame has staged a chat insert: the new blocks are in the document, invisible, and `h` is the
1326
+ // page's final height. Zoom out so all of it fits the canvas, then tell the frame to play.
1327
+ if (event.data?.type === 'playground-insert-staged' && typeof event.data.h === 'number') {
1328
+ clearRevealTimers();
1329
+ const h = event.data.h;
1330
+ const base = baseScaleRef.current;
1331
+ const viewport = (wrapperRef.current?.clientHeight ?? 0) - 2 * SCROLL_HOST_PADDING;
1332
+ // Fit the whole page, never zoom IN for it, and never past legibility.
1333
+ const fit = viewport > 0 && h > 0 ? Math.min(base, Math.max(REVEAL_MIN_SCALE, viewport / h)) : base;
1334
+ frameHeightRef.current = h;
1335
+ setFrameHeight(h);
1336
+ setRevealState({ scale: fit, slow: true, html: htmlRef.current });
1337
+ wrapperRef.current?.scrollTo({ top: 0, behavior: 'smooth' });
1338
+ // No zoom to wait for when the page already fits — a beat, so the eye lands before things move.
1339
+ const wait = fit < base - 0.001 ? REVEAL_ZOOM_MS + 40 : 120;
1340
+ revealTimersRef.current.push(
1341
+ window.setTimeout(() => {
1342
+ ref.current?.contentWindow?.postMessage({ type: 'playground-insert-play' }, '*');
1343
+ }, wait)
1344
+ );
1345
+ return;
1346
+ }
1347
+ // The new blocks are in. Rest, ease back to the toolbar's zoom, then bring the first new block into view.
1348
+ if (event.data?.type === 'playground-insert-done') {
1349
+ const firstTop = typeof event.data.firstTop === 'number' ? event.data.firstTop : 0;
1350
+ clearRevealTimers();
1351
+ revealTimersRef.current.push(
1352
+ window.setTimeout(() => {
1353
+ setRevealState((cur) => (cur ? { ...cur, scale: null } : cur));
1354
+ revealTimersRef.current.push(
1355
+ window.setTimeout(() => {
1356
+ setRevealState(null);
1357
+ const y = firstTop * baseScaleRef.current;
1358
+ wrapperRef.current?.scrollTo({ top: Math.max(0, y + SCROLL_HOST_PADDING - 8), behavior: 'smooth' });
1359
+ }, REVEAL_ZOOM_MS + 40)
1360
+ );
1361
+ }, REVEAL_HOLD_MS)
1362
+ );
1363
+ }
1364
+ };
1365
+ window.addEventListener('message', handler);
1366
+ return () => window.removeEventListener('message', handler);
1367
+ }, [scrollHost, ref]);
1368
+
1369
+ // Opaque-origin sandbox (no allow-same-origin) so the frame can't reach the
1370
+ // registry's cookies/auth (§14). We feed the document via `srcdoc` rather than
1371
+ // writing to contentDocument (which requires same-origin). The frame still
1372
+ // receives prop updates via postMessage and loads its module cross-origin
1373
+ // (the /api/component route serves modules with CORS).
1374
+ /**
1375
+ * The wrapper's content width in px, so every animated size below is a plain pixel number.
1376
+ *
1377
+ * This is what keeps the card and the frame in lockstep mid-animation: earlier revisions expressed the
1378
+ * frame's width as a percentage of the animating card, and a transition interpolating px on one element
1379
+ * against %-of-a-moving-parent on another resolves differently at every intermediate frame — flashing bare
1380
+ * card around the content. With pixel endpoints everywhere, one transition rule serves both the viewport
1381
+ * morph and the zoom, with no coordination between the two elements.
1382
+ */
1383
+ const [wrapperWidth, setWrapperWidth] = useState(0);
1384
+ useEffect(() => {
1385
+ if (!scrollHost) return;
1386
+ const el = wrapperRef.current;
1387
+ if (!el) return;
1388
+ const ro = new ResizeObserver((entries) => {
1389
+ const w = entries[0]?.contentRect.width;
1390
+ if (typeof w === 'number') setWrapperWidth(w);
1391
+ });
1392
+ ro.observe(el);
1393
+ return () => ro.disconnect();
1394
+ }, [scrollHost]);
1395
+
1396
+ if (scrollHost) {
1397
+ const scale = revealScale ?? frameScale ?? 1;
1398
+ // The reveal's zoom is slower and eases harder than the toolbar toggle; both elements below share it.
1399
+ const zoomTransition = slowZoom
1400
+ ? { transitionDuration: `${REVEAL_ZOOM_MS}ms`, transitionTimingFunction: 'cubic-bezier(.2,.8,.2,1)' }
1401
+ : { transitionDuration: '300ms' };
1402
+ const narrowed = Boolean(frameWidth && frameWidth !== '100%');
1403
+ // The document's layout width, unscaled: the emulated device width, or the canvas itself.
1404
+ const layoutWidth = narrowed ? parseFloat(frameWidth!) : wrapperWidth;
1405
+ const measured = layoutWidth > 0 && frameHeight > 0;
1406
+ return (
1407
+ <div
1408
+ ref={wrapperRef}
1409
+ // gray-100 in light mode; the theme token still carries dark mode, where a fixed light gray would glare.
1410
+ className={cn('h-full w-full overflow-y-auto bg-gray-100 dark:bg-muted', className)}
1411
+ style={{ padding: SCROLL_HOST_PADDING }}
1412
+ // The wrapper itself, not anything inside it: a click that reached a child (the page card, the
1413
+ // frame) has a meaning of its own — only the bare canvas around the page deselects.
1414
+ onClick={(e) => {
1415
+ if (e.target === wrapperRef.current) onBackdropClick?.();
1416
+ }}
1417
+ >
1418
+ {/* Sizing box: the SCALED footprint, and the only scroll extent — a transform doesn't shrink the
1419
+ layout box, and browsers can still count the untransformed box toward the scroll area, so this
1420
+ clips. It also carries the page chrome: on the unscaled sizer the 1px ring stays crisp at any
1421
+ zoom, and as a ring (a box-shadow) rather than a border it needs no layout room — at full width
1422
+ even 1px of real border overflows the wrapper into a horizontal scrollbar. */}
1423
+ <div
1424
+ className="mx-auto overflow-hidden rounded-lg bg-background shadow-md ring-1 ring-border transition-[width,height]"
1425
+ style={{
1426
+ width: measured ? layoutWidth * scale : '100%',
1427
+ height: measured ? frameHeight * scale : '100%',
1428
+ ...zoomTransition,
1429
+ }}
1430
+ >
1431
+ {/* The card: the page at its UNscaled layout size, transform-scaled into the sizer. All animation
1432
+ lives here and on the sizer — same pixel endpoints, same transition — while the frame inside
1433
+ is inert and simply fills the card, in sync at every animation frame by definition. */}
1434
+ <div
1435
+ className="origin-top-left transition-[width,transform]"
1436
+ style={{
1437
+ width: measured ? layoutWidth : '100%',
1438
+ height: measured ? frameHeight : '100%',
1439
+ transform: scale !== 1 ? `scale(${scale})` : undefined,
1440
+ ...zoomTransition,
1441
+ }}
1442
+ >
1443
+ <iframe
1444
+ ref={ref}
1445
+ className="block h-full w-full border-0"
1446
+ title="Component Preview"
1447
+ sandbox="allow-scripts"
1448
+ srcDoc={html}
1449
+ />
1450
+ </div>
1451
+ </div>
1452
+ </div>
1453
+ );
1454
+ }
1455
+
1456
+ return (
1457
+ <iframe
1458
+ ref={ref}
1459
+ className={cn('h-full w-full', className)}
1460
+ title="Component Preview"
1461
+ sandbox="allow-scripts"
1462
+ srcDoc={html}
1463
+ />
1464
+ );
1465
+ }