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,640 @@
1
+ import { htmlToBlocks } from '@portabletext/block-tools';
2
+ import { Schema } from '@sanity/schema';
3
+ import { parseHTML } from 'linkedom';
4
+ import * as xpath from 'xpath';
5
+
6
+ /**
7
+ * Rich text on its way into Sanity.
8
+ *
9
+ * **The whole point of this module is that it has one door.** `richTextToPortableText` is the only way the
10
+ * mapper turns an editor value into Portable Text, and everything below it — the compiled schema, the DOM
11
+ * parse, block-tools — is implementation. Roadmap 7 phase A makes the playground store Portable Text
12
+ * directly (`PORTABLE-TEXT-PLAN.md` §4), at which point the body of that function shrinks to "re-key and
13
+ * localise" and the three heavy dependencies leave with it. Callers do not change, because callers never
14
+ * knew.
15
+ *
16
+ * That is also why the function accepts a value rather than a string: once the stored value is already
17
+ * Portable Text it arrives here as an array, and the swap is a branch that is already written.
18
+ */
19
+
20
+ /**
21
+ * The rich-text contracts the React registry declares (`studio/.../blocks/blockContent.tsx`).
22
+ *
23
+ * They are not interchangeable, and picking the wrong one is silent: a `blockquote` written into a
24
+ * `titleBlockContent` field is a style the Studio has no entry for, which renders as an unstyled block with a
25
+ * warning — the kind of thing nobody notices until it is on a screen in front of a client.
26
+ *
27
+ * `richBlockContent` joined the list with the content-split and cards blocks, whose bodies declare it rather
28
+ * than `blockContent`. It is *not* a superset: its H1 is `h1Large`, not `h1`, so writing a `blockContent`
29
+ * value into one of those fields is exactly the silent mis-style described above.
30
+ */
31
+ export type BlockContentVariant =
32
+ | 'blockContent'
33
+ | 'simpleBlockContent'
34
+ | 'titleBlockContent'
35
+ | 'richBlockContent'
36
+ | 'splitCardContent'
37
+ | 'mediaCardContent'
38
+ | 'tableBlockContent'
39
+ | 'twoColumnContentRichBlockContent';
40
+
41
+ /** Styles each variant declares. Anything outside its set is downgraded, never dropped. */
42
+ const STYLES: Record<BlockContentVariant, ReadonlySet<string>> = {
43
+ blockContent: new Set([
44
+ 'normal',
45
+ 'h1',
46
+ 'h1Regular',
47
+ 'h2',
48
+ 'h2Regular',
49
+ 'h2LargeRegular',
50
+ 'h3',
51
+ 'h3Regular',
52
+ 'h4',
53
+ 'h4Regular',
54
+ 'h5',
55
+ 'h5Regular',
56
+ 'h6',
57
+ 'blockquote',
58
+ ]),
59
+ simpleBlockContent: new Set(['normal', 'small', 'largeTitle', 'h2', 'h3', 'h4', 'h5', 'h6']),
60
+ /**
61
+ * Note there is no `h1` here and that is not an omission: in `titleBlockContent` the H1 *is* `normal`
62
+ * (the style is titled "Heading1"). So an `<h1>` narrowing to `normal` is a promotion, not a loss.
63
+ */
64
+ titleBlockContent: new Set(['normal', 'h1alternate', 'h2', 'h3', 'h4', 'h5', 'h6']),
65
+ /**
66
+ * Long-form body content. Note `h1Large` / `h1LargeRegular` where the others say `h1` — an `<h1>` therefore
67
+ * narrows to `normal` here, which is the right answer for a field that is always a *body*, and the reason
68
+ * this variant exists rather than borrowing `blockContent`'s list.
69
+ */
70
+ richBlockContent: new Set([
71
+ 'normal',
72
+ 'small',
73
+ 'h1Large',
74
+ 'h1LargeRegular',
75
+ 'h2',
76
+ 'h2Regular',
77
+ 'h2LargeRegular',
78
+ 'h3',
79
+ 'h3Regular',
80
+ 'h4',
81
+ 'h4Regular',
82
+ 'h5',
83
+ 'h5Regular',
84
+ 'h6',
85
+ 'blockquote',
86
+ ]),
87
+ /**
88
+ * The card variants, and the reason this module grew a per-variant *default* style.
89
+ *
90
+ * `splitCardContent` declares no `normal` at all — its body style is `bodyText`, and its headings are a
91
+ * ladder of sizes with names of their own. Narrowing an unknown style to `normal` there writes a style the
92
+ * field has never heard of, which is the exact silent mis-style the variants exist to prevent.
93
+ */
94
+ splitCardContent: new Set([
95
+ 'titleLarge',
96
+ 'titleMedium',
97
+ 'titleMediumNormal',
98
+ 'mainText',
99
+ 'subtitle1',
100
+ 'subtitle2',
101
+ 'bodyText',
102
+ 'smallText',
103
+ ]),
104
+ /** Three styles and no more: a title, a pull quote, and a body — which this one does spell `normal`. */
105
+ mediaCardContent: new Set(['title', 'quote', 'normal']),
106
+ /** A table cell. One style, because a heading inside a cell is what the header row is for. */
107
+ tableBlockContent: new Set(['normal']),
108
+ /**
109
+ * The two-column body. It declares no `styles` at all, which is not "no styles": an omitted list means
110
+ * Sanity's own defaults, and those are `normal` plus the six headings plus a quote. Writing the default
111
+ * out is the only way this module can narrow against it.
112
+ */
113
+ twoColumnContentRichBlockContent: new Set([
114
+ 'normal',
115
+ 'h1',
116
+ 'h2',
117
+ 'h3',
118
+ 'h4',
119
+ 'h5',
120
+ 'h6',
121
+ 'blockquote',
122
+ ]),
123
+ };
124
+
125
+ /**
126
+ * The style a block lands on when the target declares nothing for it.
127
+ *
128
+ * `normal` everywhere it exists, which is every variant the front end inherited from `blockContent`.
129
+ * `splitCardContent` is the one that does not have it, so its body style is named here rather than assumed
130
+ * at the call site — a caller that has to know which variant lacks `normal` is a caller that will get it
131
+ * wrong on the next variant.
132
+ */
133
+ const DEFAULT_STYLE: Record<BlockContentVariant, string> = {
134
+ blockContent: 'normal',
135
+ simpleBlockContent: 'normal',
136
+ titleBlockContent: 'normal',
137
+ richBlockContent: 'normal',
138
+ splitCardContent: 'bodyText',
139
+ mediaCardContent: 'normal',
140
+ tableBlockContent: 'normal',
141
+ twoColumnContentRichBlockContent: 'normal',
142
+ };
143
+
144
+ /**
145
+ * Heading (and quote) tags a variant renames rather than declares.
146
+ *
147
+ * The four `blockContent` descendants spell their headings `h1`…`h6`, so the deserializer's own output is
148
+ * already in their vocabulary and this table is empty for them — which is what keeps their output
149
+ * byte-identical. The two card variants rename every one, so without the table an `<h2>` in a split card
150
+ * would fall all the way to the default body style and a heading an author wrote would render as a
151
+ * paragraph.
152
+ *
153
+ * The orders below are the variants' own rendered sizes, not their titles: `splitCardContent` labels
154
+ * `mainText` "Title (5XL)" and draws it at 1.5rem, smaller than the 1.875rem it labels "Title (4XL)". The
155
+ * ladder follows what a reader sees.
156
+ */
157
+ const TAG_STYLES: Record<BlockContentVariant, Readonly<Record<string, string>>> = {
158
+ blockContent: {},
159
+ simpleBlockContent: {},
160
+ titleBlockContent: {},
161
+ richBlockContent: {},
162
+ splitCardContent: {
163
+ h1: 'titleLarge',
164
+ h2: 'titleMedium',
165
+ h3: 'titleMediumNormal',
166
+ h4: 'mainText',
167
+ h5: 'subtitle1',
168
+ h6: 'subtitle2',
169
+ // No quote style of its own; `mainText` is the size the card draws a pull quote at.
170
+ blockquote: 'mainText',
171
+ },
172
+ mediaCardContent: {
173
+ h1: 'title',
174
+ h2: 'title',
175
+ h3: 'title',
176
+ h4: 'quote',
177
+ h5: 'quote',
178
+ h6: 'quote',
179
+ blockquote: 'quote',
180
+ },
181
+ tableBlockContent: {},
182
+ twoColumnContentRichBlockContent: {},
183
+ };
184
+
185
+ /** Where a variant declares no lists, a `listItem` is a style the Studio cannot draw. */
186
+ const LISTS: Record<BlockContentVariant, ReadonlySet<string>> = {
187
+ blockContent: new Set(),
188
+ simpleBlockContent: new Set(['bullet', 'number']),
189
+ titleBlockContent: new Set(),
190
+ richBlockContent: new Set(),
191
+ splitCardContent: new Set(['bullet', 'number']),
192
+ mediaCardContent: new Set(),
193
+ tableBlockContent: new Set(['bullet', 'number']),
194
+ // Also the Sanity default, for the same reason as its styles: the field declares no `lists` key.
195
+ twoColumnContentRichBlockContent: new Set(['bullet', 'number']),
196
+ };
197
+
198
+ /** `left`/`center`/`right` are alignment decorators, not text styling — kept as-is. */
199
+ const DEFAULT_DECORATORS = new Set(['strong', 'em', 'underline', 'left', 'center', 'right']);
200
+
201
+ /**
202
+ * Decorators each variant declares. Every `blockContent` descendant declares the same six, so they share
203
+ * one set; `mediaCardContent` declares two, and a mark outside a field's own list renders as a warning in
204
+ * the Studio exactly as an undeclared style does.
205
+ */
206
+ const DECORATORS: Record<BlockContentVariant, ReadonlySet<string>> = {
207
+ blockContent: DEFAULT_DECORATORS,
208
+ simpleBlockContent: DEFAULT_DECORATORS,
209
+ titleBlockContent: DEFAULT_DECORATORS,
210
+ richBlockContent: DEFAULT_DECORATORS,
211
+ splitCardContent: DEFAULT_DECORATORS,
212
+ mediaCardContent: new Set(['strong', 'em']),
213
+ // Both declare their decorators explicitly, and neither lists the three alignment marks.
214
+ tableBlockContent: new Set(['strong', 'em', 'underline']),
215
+ twoColumnContentRichBlockContent: new Set(['strong', 'em', 'underline']),
216
+ };
217
+
218
+ export interface PortableTextSpan {
219
+ _type: 'span';
220
+ _key: string;
221
+ text: string;
222
+ marks: string[];
223
+ }
224
+
225
+ export interface PortableTextBlock {
226
+ _type: string;
227
+ _key: string;
228
+ style?: string;
229
+ listItem?: string;
230
+ level?: number;
231
+ markDefs?: Record<string, unknown>[];
232
+ children?: PortableTextSpan[];
233
+ [key: string]: unknown;
234
+ }
235
+
236
+ /**
237
+ * The schema block-tools deserializes against.
238
+ *
239
+ * A deliberate **superset** of the three variants rather than one schema per variant: the deserializer's job
240
+ * is to notice that an `<h1>` is an h1 and a `<blockquote>` is a quote, and a schema that omits them makes it
241
+ * throw the information away before this module can decide what to do with it. Narrowing happens afterwards,
242
+ * where the target field is known.
243
+ *
244
+ * `Schema.compile` is not cheap, so it runs once per process. Lazily, because importing this module must not
245
+ * cost anything on a request that never touches rich text.
246
+ */
247
+ let compiled: unknown = null;
248
+ function blockContentType(): unknown {
249
+ if (compiled) return compiled;
250
+ const schema = Schema.compile({
251
+ name: 'handoffRichText',
252
+ types: [
253
+ {
254
+ name: 'richText',
255
+ type: 'array',
256
+ of: [
257
+ {
258
+ type: 'block',
259
+ styles: [
260
+ { title: 'Normal', value: 'normal' },
261
+ { title: 'H1', value: 'h1' },
262
+ { title: 'H2', value: 'h2' },
263
+ { title: 'H3', value: 'h3' },
264
+ { title: 'H4', value: 'h4' },
265
+ { title: 'H5', value: 'h5' },
266
+ { title: 'H6', value: 'h6' },
267
+ { title: 'Quote', value: 'blockquote' },
268
+ ],
269
+ lists: [
270
+ { title: 'Bullet', value: 'bullet' },
271
+ { title: 'Numbered', value: 'number' },
272
+ ],
273
+ marks: {
274
+ decorators: [
275
+ { title: 'Strong', value: 'strong' },
276
+ { title: 'Emphasis', value: 'em' },
277
+ { title: 'Underline', value: 'underline' },
278
+ ],
279
+ annotations: [
280
+ {
281
+ name: 'link',
282
+ type: 'object',
283
+ title: 'Link',
284
+ fields: [{ name: 'href', type: 'url', title: 'URL' }],
285
+ },
286
+ ],
287
+ },
288
+ },
289
+ ],
290
+ },
291
+ ],
292
+ });
293
+ compiled = schema.get('richText');
294
+ return compiled;
295
+ }
296
+
297
+ function isPortableTextArray(value: unknown): value is PortableTextBlock[] {
298
+ return (
299
+ Array.isArray(value) &&
300
+ value.every((v) => typeof v === 'object' && v !== null && typeof (v as { _type?: unknown })._type === 'string')
301
+ );
302
+ }
303
+
304
+ /**
305
+ * Plain text out of anything the playground might have stored.
306
+ *
307
+ * Used where the Sanity field is a plain string but the editor was a rich-text one — better a correct
308
+ * sentence than a `<p>` rendered as literal characters on a client's screen.
309
+ */
310
+ export function portableTextToPlainText(blocks: unknown): string {
311
+ if (typeof blocks === 'string') return stripTags(blocks);
312
+ if (!Array.isArray(blocks)) return '';
313
+ return blocks
314
+ .map((block) => {
315
+ const children = (block as PortableTextBlock)?.children;
316
+ if (Array.isArray(children)) return children.map((c) => c?.text ?? '').join('');
317
+ if (typeof (block as { html?: unknown })?.html === 'string') return stripTags((block as { html: string }).html);
318
+ return '';
319
+ })
320
+ .filter(Boolean)
321
+ .join('\n\n')
322
+ .trim();
323
+ }
324
+
325
+ function stripTags(html: string): string {
326
+ return html
327
+ .replace(/<br\s*\/?>/gi, '\n')
328
+ .replace(/<\/(p|div|h[1-6]|li)>/gi, '\n')
329
+ .replace(/<[^>]*>/g, '')
330
+ .replace(/&nbsp;/g, ' ')
331
+ .replace(/&amp;/g, '&')
332
+ .replace(/&lt;/g, '<')
333
+ .replace(/&gt;/g, '>')
334
+ .replace(/&quot;/g, '"')
335
+ .replace(/&#39;/g, "'")
336
+ .replace(/\n{3,}/g, '\n\n')
337
+ .trim();
338
+ }
339
+
340
+ export interface RichTextOptions {
341
+ /** Which of the three contracts the value is going into. Decides style and list narrowing. */
342
+ variant?: BlockContentVariant;
343
+ /**
344
+ * Prefix for every generated `_key`. Positional and deterministic, never random: a re-publish of an
345
+ * unchanged page must produce a byte-identical document, or the Studio's history fills with edits nobody
346
+ * made and the demo's "publish again" is a diff.
347
+ */
348
+ keyPrefix?: string;
349
+ /**
350
+ * Force every text block to one style — the caller has decided what this run of text *is*.
351
+ *
352
+ * For the composed fields: a quote card stores its quote, its author and the author's role in one
353
+ * rich-text field, separated only by the style each line carries. The style comes from which argument the
354
+ * line was read from, not from anything in the line's own markup, so a stray `<h2>` in the quote field is
355
+ * still the quote.
356
+ *
357
+ * Narrowed like any other style: a value the target variant does not declare falls to its default rather
358
+ * than being written.
359
+ */
360
+ style?: string;
361
+ }
362
+
363
+ /**
364
+ * HTML (or already-Portable-Text) → Portable Text for a named registry field.
365
+ *
366
+ * The one door. Everything about *how* — the DOM, `@sanity/schema`, block-tools — is behind it and is
367
+ * expected to be deleted when the playground starts storing Portable Text natively.
368
+ */
369
+ export function richTextToPortableText(value: unknown, options: RichTextOptions = {}): PortableTextBlock[] {
370
+ const variant = options.variant ?? 'blockContent';
371
+ const prefix = options.keyPrefix ?? '';
372
+ const forced = options.style;
373
+
374
+ // Already Portable Text — the post-phase-A path, and it is the cheap one: re-key and narrow, no parsing.
375
+ if (isPortableTextArray(value)) return normalize(value as PortableTextBlock[], variant, prefix, forced);
376
+
377
+ /**
378
+ * A list of paragraphs.
379
+ *
380
+ * The third shape the playground stores a body in, after a string and Portable Text: a long-form field
381
+ * whose editor works paragraph by paragraph hands over `['…', '…']`. Joined rather than special-cased,
382
+ * so it goes through the same deserializer and gets the same style narrowing. Before this it fell past
383
+ * the string check and converted to nothing at all — a body that vanished without a report.
384
+ */
385
+ const source =
386
+ Array.isArray(value) && value.every((item) => typeof item === 'string')
387
+ ? (value as string[])
388
+ .filter((paragraph) => paragraph.trim())
389
+ .map((paragraph) => (/<[a-z][\s\S]*>/i.test(paragraph) ? paragraph : `<p>${escapeHtml(paragraph)}</p>`))
390
+ .join('')
391
+ : value;
392
+
393
+ if (typeof source !== 'string' || !source.trim()) return [];
394
+
395
+ /**
396
+ * A bare sentence is not HTML, but `htmlToBlocks` is happy to treat it as a body fragment. Wrapping it in a
397
+ * `<p>` rather than special-casing it keeps one code path — the playground stores both spellings depending
398
+ * on whether a field has ever been through the rich-text editor.
399
+ */
400
+ const html = /<[a-z][\s\S]*>/i.test(source) ? source : `<p>${escapeHtml(source)}</p>`;
401
+
402
+ const blocks = htmlToBlocks(html, blockContentType() as never, {
403
+ parseHtml: parseFragment,
404
+ }) as unknown as PortableTextBlock[];
405
+
406
+ return normalize(blocks, variant, prefix, forced);
407
+ }
408
+
409
+ /** Already a whole document (Word and Google Docs paste both are) rather than a body fragment. */
410
+ const IS_DOCUMENT = /<(?:!doctype\s+html|html[\s>]|body[\s>])/i;
411
+
412
+ /**
413
+ * The DOM block-tools parses against.
414
+ *
415
+ * **This must not be jsdom, and the reason is a deploy, not a preference.** jsdom is on Next's default
416
+ * `serverExternalPackages` list, so Turbopack does not bundle it — it emits a runtime `require('jsdom')`
417
+ * inside the lambda. jsdom@29's tree (`html-encoding-sniffer` → `@exodus/bytes`) reaches an ESM-only file
418
+ * through that `require`, and on the deployed Node the whole route *module* fails to load with
419
+ * `ERR_REQUIRE_ESM`. The symptom is not a 500 from the handler; it is a 500 instead of the handler, so
420
+ * `POST /api/handoff/cms/sanity/publish` answered 500 even unauthenticated while its siblings answered 401.
421
+ * Nothing caught it locally because plain `node` silently allows that require — reproduce it with
422
+ * `node --no-experimental-require-module -e "require('jsdom')"`.
423
+ *
424
+ * linkedom is not on that external list, so Turbopack bundles it and there is no runtime `require` to fail.
425
+ * jsdom stays where it belongs: the CLI-side slot probes, which run under a normal Node process.
426
+ *
427
+ * The `<html><body>` wrapper is not decoration. `parseHTML('<p>x</p>')` gives linkedom a document whose
428
+ * `documentElement` *is* the `<p>` and whose `body` is empty, and block-tools deserializes `doc.body` — so
429
+ * without the wrapper every input silently produces zero blocks. jsdom supplied that wrapper implicitly.
430
+ * It has to be conditional for the same reason: wrapping input that is *already* a document nests a second
431
+ * `<html>` inside the body, and linkedom drops the loose text around it.
432
+ */
433
+ function parseFragment(html: string): Document {
434
+ const { document } = parseHTML(IS_DOCUMENT.test(html) ? html : `<html><body>${html}</body></html>`);
435
+ /**
436
+ * linkedom emits a *separate* text node per character reference — `Non&nbsp;breaking` parses to
437
+ * `["Non", " ", "breaking"]` where an HTML parser gives one node. block-tools' whitespace
438
+ * preprocessor then collapses each node on its own, so a space that happens to sit between two entities
439
+ * becomes a whitespace-only node and is dropped: `&amp; &lt;` came out as `&<`. `normalize()` merges
440
+ * adjacent text nodes, which is the state a real parser hands over, and restores byte-for-byte parity.
441
+ */
442
+ document.normalize();
443
+ return withXPath(document as unknown as Document);
444
+ }
445
+
446
+ /**
447
+ * `xpath`'s `parse` (the compiled-expression API) is real but undeclared in the package's bundled `.d.ts`,
448
+ * which only types the `select` helpers. Declared here rather than reached for through `select`, because
449
+ * `select` re-parses on every call and cannot be handed the `isHtml` flag this shim depends on.
450
+ */
451
+ type ParsedXPath = {
452
+ select(options: { node: Node; isHtml?: boolean; namespaces?: (prefix: string) => string | undefined }): Node[];
453
+ };
454
+ const parseXPath = (xpath as unknown as { parse(expression: string): ParsedXPath }).parse;
455
+
456
+ /** Parsed XPath expressions, keyed by source. The preprocessors ask for the same handful every call. */
457
+ const xpathCache = new Map<string, ParsedXPath>();
458
+
459
+ /**
460
+ * `document.evaluate`, because block-tools' preprocessors are not optional.
461
+ *
462
+ * Every `htmlToBlocks` call runs six preprocessors before a single rule fires, and three of them
463
+ * (`preprocessGDocs`, `preprocessHTML`, `preprocessNotion`) open with `doc.evaluate(...)` unconditionally —
464
+ * `preprocessHTML` is the one that matters for ordinary input, since it is what strips comments, `<style>`,
465
+ * `<script>` and stray body text nodes. Neither linkedom nor happy-dom implements XPath, so a DOM without
466
+ * this shim does not "mostly work": the very first preprocessor throws `doc.evaluate is not a function` and
467
+ * every input converts to nothing.
468
+ *
469
+ * The `xpath` package is a real XPath 1.0 engine over plain DOM nodes, so this is not a pattern-match on the
470
+ * expressions block-tools happens to use today — Word and Google Docs paste, which lean on the exotic paths,
471
+ * keep working. `isHtml` is what makes `/html/body/text()` match linkedom's uppercase `nodeName`s; without
472
+ * it, name tests silently match nothing and the result is the same "converts to nothing" failure, only
473
+ * quieter.
474
+ *
475
+ * Only the two accessor shapes the preprocessors read are implemented (`iterateNext` for
476
+ * ORDERED_NODE_ITERATOR_TYPE, `snapshotLength`/`snapshotItem` for the snapshot types). This is not a
477
+ * standards-complete `XPathResult`.
478
+ */
479
+ function withXPath(document: Document): Document {
480
+ // Cast through `unknown`: the DOM lib types `evaluate` as returning a full `XPathResult`, and this shim
481
+ // deliberately returns only the accessors block-tools reads.
482
+ const target = document as unknown as { evaluate?: unknown };
483
+ if (typeof target.evaluate === 'function') return document;
484
+
485
+ target.evaluate = (
486
+ expression: string,
487
+ contextNode: Node,
488
+ resolver?: ((prefix: string) => string | null) | null
489
+ ) => {
490
+ let parsed = xpathCache.get(expression);
491
+ if (!parsed) {
492
+ parsed = parseXPath(expression);
493
+ xpathCache.set(expression, parsed);
494
+ }
495
+
496
+ const nodes = parsed.select({
497
+ node: contextNode,
498
+ isHtml: true,
499
+ ...(typeof resolver === 'function' ? { namespaces: (prefix: string) => resolver(prefix) ?? undefined } : {}),
500
+ }) as Node[];
501
+
502
+ let cursor = 0;
503
+ return {
504
+ snapshotLength: nodes.length,
505
+ snapshotItem: (index: number) => nodes[index] ?? null,
506
+ iterateNext: () => nodes[cursor++] ?? null,
507
+ };
508
+ };
509
+
510
+ return document;
511
+ }
512
+
513
+ function escapeHtml(text: string): string {
514
+ return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
515
+ }
516
+
517
+ /**
518
+ * Re-key positionally, narrow styles to the target contract, and give every link mark the shape the React registry's
519
+ * `link` annotation actually declares.
520
+ */
521
+ function normalize(
522
+ blocks: PortableTextBlock[],
523
+ variant: BlockContentVariant,
524
+ prefix: string,
525
+ forced?: string
526
+ ): PortableTextBlock[] {
527
+ const styles = STYLES[variant];
528
+ const lists = LISTS[variant];
529
+ const decorators = DECORATORS[variant];
530
+ const tags = TAG_STYLES[variant];
531
+ const fallbackStyle = DEFAULT_STYLE[variant];
532
+ /**
533
+ * Narrow one style to the target's vocabulary: keep what it declares, translate what it renames, and
534
+ * otherwise fall to its own body style. The three steps are in that order because a variant that both
535
+ * declares `h2` and renames it does not exist — and if one ever does, "what the field declares" is the
536
+ * answer that cannot be wrong.
537
+ */
538
+ const narrow = (style: string | undefined): string => {
539
+ if (style && styles.has(style)) return style;
540
+ if (style && tags[style]) return tags[style];
541
+ return fallbackStyle;
542
+ };
543
+ // A forced style is narrowed once, not once per block: the caller's decision is about the whole run.
544
+ const forcedStyle = forced === undefined ? undefined : narrow(forced);
545
+
546
+ return blocks.map((block, i) => {
547
+ const key = `${prefix}b${i}`;
548
+ if (block._type !== 'block') {
549
+ // `html`, `embed` and friends pass through with a deterministic key and nothing else touched.
550
+ return { ...block, _key: key };
551
+ }
552
+
553
+ /**
554
+ * markDefs are re-keyed first, because a span's `marks` reference them by key. Re-keying the spans and
555
+ * forgetting the mapping is how a link silently becomes an un-annotated run of text.
556
+ */
557
+ const defs = Array.isArray(block.markDefs) ? block.markDefs : [];
558
+ const remap = new Map<string, string>();
559
+ const markDefs = defs.map((def, d) => {
560
+ const next = `${key}d${d}`;
561
+ const previous = (def as { _key?: string })._key;
562
+ if (typeof previous === 'string') remap.set(previous, next);
563
+ const normalized: Record<string, unknown> = { ...def, _key: next };
564
+ /**
565
+ * The React registry's link annotation is `defineWysiwygLinkField`, whose discriminator is `linkType`. Block-tools
566
+ * emits `{_type:'link', href}` and nothing else, and a link without `linkType` renders as no link at
567
+ * all — the field is there, the anchor is not.
568
+ */
569
+ if (normalized._type === 'link' && !normalized.linkType) normalized.linkType = 'href';
570
+ return normalized;
571
+ });
572
+
573
+ const children = (Array.isArray(block.children) ? block.children : []).map((child, c) => ({
574
+ ...child,
575
+ _type: 'span' as const,
576
+ _key: `${key}s${c}`,
577
+ text: typeof child?.text === 'string' ? child.text : '',
578
+ marks: (Array.isArray(child?.marks) ? child.marks : [])
579
+ .map((mark: string) => remap.get(mark) ?? mark)
580
+ // A decorator the target does not declare would render as a warning; a mark that points at a
581
+ // markDef we kept is fine by definition.
582
+ .filter((mark: string) => decorators.has(mark) || markDefs.some((d) => d._key === mark)),
583
+ }));
584
+
585
+ const out: PortableTextBlock = {
586
+ ...block,
587
+ _type: 'block',
588
+ _key: key,
589
+ // Unknown style → the target's own body style. Never dropped and never passed through: a red field in
590
+ // the Studio is the worst artefact a demo can produce, and an absent style is a different bug from a
591
+ // wrong one.
592
+ style: forcedStyle ?? narrow(block.style),
593
+ markDefs,
594
+ children,
595
+ };
596
+
597
+ if (block.listItem && lists.has(block.listItem)) {
598
+ out.listItem = block.listItem;
599
+ out.level = typeof block.level === 'number' ? block.level : 1;
600
+ } else {
601
+ delete out.listItem;
602
+ delete out.level;
603
+ }
604
+
605
+ return out;
606
+ });
607
+ }
608
+
609
+ /**
610
+ * Flatten anything that is not a text block into text blocks.
611
+ *
612
+ * `simpleBlockContent` declares `{type:'block'}` and nothing else — no `embed`, no `html`. So a value that
613
+ * legitimately carries an escape-hatch `{_type:'html'}` member (which `blockContent` and `titleBlockContent`
614
+ * both accept) has to be turned into readable text before it goes into a simple field, rather than written as
615
+ * an object the Studio will refuse to open.
616
+ *
617
+ * Text, not silence: dropping the member loses an author's content with no trace, and the alternative — an
618
+ * invalid document — loses the whole page.
619
+ */
620
+ export function flattenHtmlBlocksForSimpleContent(blocks: PortableTextBlock[]): PortableTextBlock[] {
621
+ if (!Array.isArray(blocks)) return [];
622
+ return blocks
623
+ .map((block, i) => {
624
+ if (block?._type === 'block') return block;
625
+ const carrier = block as unknown as { html?: unknown; code?: unknown };
626
+ const source =
627
+ typeof carrier?.html === 'string' ? carrier.html : typeof carrier?.code === 'string' ? carrier.code : '';
628
+ const text = stripTags(source);
629
+ if (!text) return null;
630
+ const key = block?._key ?? `f${i}`;
631
+ return {
632
+ _type: 'block',
633
+ _key: key,
634
+ style: 'normal',
635
+ markDefs: [],
636
+ children: [{ _type: 'span' as const, _key: `${key}s0`, text, marks: [] }],
637
+ } as PortableTextBlock;
638
+ })
639
+ .filter(Boolean) as PortableTextBlock[];
640
+ }