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
package/Changelog.md ADDED
@@ -0,0 +1,2069 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to
7
+ [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
8
+
9
+ ## \[1.2.2] - 2026-04-09
10
+
11
+ This patch release clears ESLint failures in the Next.js app pages and aligns
12
+ several code paths with the compiler target so production builds succeed without
13
+ enabling `--downlevelIteration`.
14
+
15
+ ### Change
16
+
17
+ * Altered the avaliable types to the SlotMetadata so the default can handle
18
+ a wide variaty of types - `default?: string | number | boolean | object | any[] | null;`
19
+
20
+ ### Lint and code quality
21
+
22
+ * Resolved `no-else-return`, `no-unused-vars`, `camelcase`, `prefer-const`,
23
+ `eqeqeq`, `no-nested-ternary`, `no-lonely-if`, and `no-use-before-define`
24
+ across static pages (catch-all docs, assets, foundations, home, system, and
25
+ design-token foundation pages).
26
+ * Removed or refactored unused `getStaticProps` context parameters, props, and
27
+ locals; normalized naming (e.g. font machine keys); simplified icon detail
28
+ routing query handling.
29
+ * Reordered helper components (token color/effect/typography tables, component
30
+ token previews) ahead of page components where required for declaration order.
31
+ * Converted `getComponentPreviews` to a hoisted `function` declaration and
32
+ refactored the component token table for clearer control flow.
33
+
34
+ ### Build / TypeScript compatibility
35
+
36
+ * Avoid iterating `Map` / `Set` / `Iterable` / `matchAll` results directly in
37
+ `for...of` where the compile target requires it: use `Array.from(...)` or
38
+ equivalent helpers in the config-diff registry, snapshot diff, CSF import
39
+ parsing, and component artifact sync.
40
+
41
+ ## \[1.2.1] - 2026-04-08
42
+
43
+ This is a minor release that fixes a bug in the new config diff calculator.
44
+ Under some conditions, this would fail depending on your node configuration.
45
+
46
+ ## \[1.2.0] - 2026-04-03
47
+
48
+ This release introduces support for patterns and significantly
49
+ modernizes the configuration and declaration workflow. It expands Handoff from
50
+ documenting individual components to documenting larger design-system
51
+ compositions, while also improving TypeScript support, preview usability, and
52
+ overall build and development reliability.
53
+
54
+ ### Patterns
55
+
56
+ * Added support for design system patterns as a new documentation
57
+ layer above individual components.
58
+ * Patterns support composing multiple component previews into a single page.
59
+ * Pattern definitions can reference existing named component previews or
60
+ provide inline args for custom pattern-specific compositions.
61
+ * Added support for `entries.patterns`, allowing projects to register composed
62
+ design-system patterns alongside components.
63
+ * Added pattern summary and detail artifacts so patterns behave as first-class
64
+ generated output alongside components.
65
+
66
+ ### Typed Config and Declaration Workflow
67
+
68
+ * Added support for typed TypeScript and JavaScript config and declaration
69
+ files across the project workflow.
70
+ * Established TypeScript-based config and declaration files as the preferred
71
+ convention, while continuing to support JavaScript, CJS, and JSON where
72
+ applicable.
73
+ * Added clear config resolution precedence when multiple root config files are
74
+ present.
75
+ * Introduced the `.handoff.ts` and `.handoff.js` declaration convention for
76
+ components and patterns.
77
+ * Introduced structured helper APIs including `defineConfig`,
78
+ `defineReactComponent`, `defineHandlebarsComponent`,
79
+ `defineCsfComponent`, and `definePattern`.
80
+ * Updated runtime loading and normalization so typed declarations and modern
81
+ config shapes work consistently across the pipeline.
82
+ * Updated scaffolding and CLI flows to support both TypeScript and JavaScript
83
+ project setup.
84
+ * Updated generated examples and component scaffolds to follow the new
85
+ `.handoff.*` declaration convention.
86
+
87
+ ### Usage Snippets and Preview Improvements
88
+
89
+ * Added usage snippets as a new documentation feature, with output that
90
+ reflects the currently selected preview variant.
91
+ * Expanded CSF preview handling to produce more useful implementation examples
92
+ for React and Storybook-style components.
93
+ * Improved story and preview resolution so generated documentation is more
94
+ actionable for engineers consuming the design system.
95
+ * Enhanced code display behavior to better support usage-oriented
96
+ documentation rather than only static rendered output.
97
+
98
+ ### General Improvements
99
+
100
+ * Improved incremental build and watch behavior so changes trigger more
101
+ selective and reliable rebuilds.
102
+ * Added better cleanup of stale generated artifacts to keep component and
103
+ pattern output in sync as files change or are removed.
104
+ * Improved summary artifact maintenance during rebuilds so generated API output
105
+ stays aligned with the current source of truth.
106
+ * Enhanced logging with clearer scoped output across Handoff, Vite, and Next.js
107
+ processes.
108
+ * Improved child-process logging and development server reporting to make local
109
+ debugging and build visibility better.
110
+
111
+ ## \[1.1.3] - 2026-03-27
112
+
113
+ This release reworks the markdown page rendering system with four improvements:
114
+ n-level deep routing, automatic table-of-contents generation, standardized code
115
+ block styling, and GitHub Flavored Markdown table support.
116
+
117
+ ### Features
118
+
119
+ * **N-level deep markdown routing** — Replaced the fixed two-level routing
120
+ (`[level1]` / `[level1]/[level2]`) with a single `[...slug]` catch-all route
121
+ that supports markdown pages at any directory depth. A new recursive
122
+ `buildCatchAllStaticPaths` function walks `config/docs` and `pages`
123
+ directories to collect `.md` files at any nesting level. The sidebar menu now
124
+ also recursively scans directories to surface deeply nested pages.
125
+
126
+ * **Automatic table of contents** — The existing but unused `PageTOC` component
127
+ is now wired into the catch-all markdown page. It scans rendered headings
128
+ (h1–h6) via a `MutationObserver` and populates the right-hand "On This Page"
129
+ anchor nav automatically. Fixed a timing bug where headings were scanned
130
+ before the markdown content was in the DOM, and fixed anchor IDs that were
131
+ incorrectly prefixed with `#` (producing `##id` in URLs).
132
+
133
+ * **Standardized code block styling** — Markdown fenced code blocks now render
134
+ with a toolbar header matching the site's `CodeHighlight` component: a
135
+ language icon, filename or language label, and a copy-to-clipboard button. A
136
+ new `remarkCodeMeta` remark plugin preserves the fence info string so metadata
137
+ like ` ```bash filename="deploy.sh" ` is parsed and displayed. The Prism
138
+ theme respects dark mode via `next-themes`, and registered languages now
139
+ include bash, css, scss, jsx, tsx, typescript, yaml, handlebars, and more.
140
+
141
+ * **Markdown table support** — Added `remark-gfm` to all `ReactMarkdown`
142
+ instances across the codebase (17 files). Pipe tables, strikethrough,
143
+ autolinks, and task lists now render correctly. Tables are styled via Tailwind
144
+ Typography's `.prose table` defaults.
145
+
146
+ ### Bug Fixes
147
+
148
+ * **New components not detected in dev mode** — `npm run start` now watches
149
+ the parent component directories (from `config.entries.components`) for
150
+ newly created components. Previously, only components known at startup had
151
+ their files watched; adding a new component directory required restarting
152
+ the dev server. A new `watchComponentDirectories` watcher detects when a
153
+ config file (`.json` / `.js` / `.cjs`) appears in a new subdirectory,
154
+ reloads the runtime config, restarts the component and configuration
155
+ watchers, and processes the new component automatically.
156
+
157
+ * **Heading anchor IDs truncated** — The markdown heading anchor generator
158
+ was only reading the first child node (`children[0]`) instead of the full
159
+ heading text, producing single-character or partial IDs (e.g. `id="u"`
160
+ instead of `id="using-icons-in-templates"`). A new `extractText` helper
161
+ recursively walks all children to build the complete anchor slug.
162
+
163
+ * **Fenced code blocks without a language unstyled** — Bare ` ``` `
164
+ blocks (no language identifier) now receive the same styled treatment as
165
+ language-tagged blocks: toolbar, copy button, and themed background.
166
+ Inline code is unaffected.
167
+
168
+ * **Code blocks pushing page width** — Added `min-w-0` and `max-w-full` on
169
+ the code block wrapper and the grid content column to prevent wide code
170
+ from stretching the layout and pushing the TOC off-screen.
171
+
172
+ * **Frontmatter menu duplicated by auto-scan** — When a markdown page
173
+ defines its sidebar menu via frontmatter `menu`, the automatic directory
174
+ scanner no longer appends duplicate entries. Auto-scanning now only runs
175
+ as a fallback when no frontmatter menu is present.
176
+
177
+ * **`.prose` max-width too narrow** — Overrode Tailwind Typography's default
178
+ `max-width: 65ch` on `.prose` to `100%` so markdown content fills the
179
+ available container width.
180
+
181
+ ### Changed
182
+
183
+ * Deleted `src/app/pages/[level1]/index.tsx` and
184
+ `src/app/pages/[level1]/[level2]/index.tsx` (replaced by `[...slug]`).
185
+ * Removed `buildL1StaticPaths`, `buildL2StaticPaths`, and the `SubPageType`
186
+ interface from `src/app/components/util/index.ts`.
187
+ * `ComponentGuidelines` now uses `MarkdownComponents` and the remark plugins
188
+ for consistent rendering.
189
+ * Added `system/tokens/**` paths to `knownPaths` to prevent catch-all route
190
+ conflicts with dedicated token pages.
191
+
192
+ ### Security Patch
193
+
194
+ * Brace Expansion was updated to prevent a memory exhaustion issue.
195
+
196
+ ## \[1.1.2] - 2026-03-26
197
+
198
+ This release improves integration with downstream platforms (for example HubSpot) by letting
199
+ projects register their own Handlebars helpers during preview generation, instead of relying
200
+ only on Handoff’s built-in `field` and `eq` helpers.
201
+
202
+ ### Feature
203
+
204
+ **`hooks.registerHandlebarsHelpers`** — New optional hook in `handoff.config.js`. After Handoff
205
+ registers its default preview helpers, your callback runs with the Handlebars runtime, the
206
+ current `componentId`, the component `properties` (slot metadata), and a flag for inspect-mode
207
+ renders (`injectFieldWrappers`). Use `handlebars.registerHelper` (and block helpers as needed)
208
+ to add helpers that are only available while building component preview HTML—so templates can
209
+ stay platform-specific without forking Handoff.
210
+
211
+ Typical uses: block helpers that wrap regions meant for a host page’s header or footer, or a
212
+ helper that serializes a value as JSON for inline scripts. Those behaviors are **not** shipped
213
+ as core helpers; you define them in config so each project controls naming and semantics.
214
+
215
+ See `docs/api.md` (Hooks → `registerHandlebarsHelpers`) for the full signature and README
216
+ “Configuration hooks” for a quick pointer.
217
+
218
+ ### Example: JSON in templates
219
+
220
+ If you register a `json` helper in `hooks.registerHandlebarsHelpers`, like this
221
+
222
+ ```
223
+ hooks: {
224
+ registerHandlebarsHelpers: ({ handlebars, componentId }) => {
225
+ // Register 'json' as a simple (non-block) helper
226
+ handlebars.registerHelper('json', (value, data) => {
227
+ return new handlebars.SafeString(JSON.stringify(value, null, 2));
228
+ });
229
+ }
230
+ }
231
+ ```
232
+
233
+ Then your templates can do:
234
+
235
+ ```
236
+ <script type="text/javascript">
237
+ window.barChartData = {{{json properties.data}}};
238
+ </script>
239
+ ```
240
+
241
+ with output shaped by your helper implementation (for example serialized JSON for chart data).
242
+
243
+ ## \[1.1.1] - 2026-03-12
244
+
245
+ This patch release focuses on Windows stabilization and consistency across environments.
246
+
247
+ It includes targeted fixes to reduce platform-specific issues in local development and documentation rendering, especially around path handling, routing/navigation behavior, and runtime update detection. These changes aim to make behavior on Windows align more closely with Mac and Linux, with no intended breaking changes.
248
+
249
+ Also includes a fallback for components with empty previews definitions, preventing preview generation failures during builds.
250
+
251
+ ## \[1.1.0] - 2026-03-05
252
+
253
+ This release introduces two major new features. First, handoff now can do automatic
254
+ type detection in typescript files. By using a new library we wrote to leverage the
255
+ typescript engine, we can automatically extract types from your components and give
256
+ you visiblity into the type architecture across your whole project.
257
+
258
+ Second, we've long wanted to support the Storybook component story format, and this
259
+ release provides robust support for stories expressed as tsx or js files.
260
+
261
+ This release also does significant cleanup and quality of life improvements. We've
262
+ fixed some longstanding annoyances, and continue to focus the application.
263
+
264
+ ### Automatic type documentation
265
+
266
+ * Integrated **handoff-docgen** for component documentation: props and types are
267
+ inferred from React/TSX components and merged with story data where available.
268
+ * Properties table shows inferred types, default values, and descriptions from
269
+ component source and story argTypes.
270
+ * Empty state message when no properties are documented; improved layout and
271
+ formatting for inline and default values in the Preview component.
272
+
273
+ ### CSF support
274
+
275
+ * Components can use Storybook-style Component Story Format (`.stories.tsx` / `.stories.js`).
276
+ Stories are parsed to generate variants, args, and argTypes for the component page.
277
+ * CSF parsing supports deep type nesting and correctly shows nested items for both
278
+ Handlebars and CSF components.
279
+ * New example component `example-csf` demonstrates CSF integration alongside the
280
+ existing Handlebars and React examples.
281
+
282
+ ### Component page and code display
283
+
284
+ * **Handlebars formatting:** Code highlight now supports Handlebars (`.hbs`) templates—
285
+ syntax highlighting uses the correct language instead of plain HTML.
286
+ * Handlebars components no longer show rendered HTML in the Code snippet dropdown;
287
+ the template source is shown correctly.
288
+ * Empty code tabs are filtered from the dropdown; HTML fallback for inactive states
289
+ removed for clearer code view.
290
+ * Preview dropdown shows the active variant instead of a placeholder; style loading
291
+ and incremental component summary updates fixed in watch mode.
292
+ * Prev/next navigation respects component group boundaries and hides invalid links.
293
+
294
+ ### Cleanup and internal changes
295
+
296
+ * Removed legacy integration directory and relocated component scaffolding templates
297
+ under `integration/components/` (e.g. `example`, `example-csf`, `example-react`).
298
+ * Removed legacy shared styles pipeline; `makeComponent` and config now use
299
+ `config.entries.components` consistently.
300
+ * Removed deprecated `serverRuntimeConfig` usage, outdated `.env.example` with
301
+ incorrect variable names, and the patch-package workaround where no longer needed.
302
+ * Dependencies cleanup and package updates.
303
+ * Internal reorg: new `app-builder` (build, watchers, client config, websocket),
304
+ pipeline split into `pipeline/` (archive, components, figma, styles, validation),
305
+ config split into `config/` (defaults, loader, runtime, validator), and READMEs
306
+ added for major modules.
307
+ * Global CSS/JS bundles now build on startup in dev mode; watcher added to rebuild
308
+ main bundles and components when global entry files change.
309
+ * Stale JSDoc and command descriptions updated.
310
+
311
+ ## \[1.0.6] - 2026-02-24
312
+
313
+ Version 1.0.4 fixed an issue when running Handoff in subpaths (eg.
314
+ https://mysite.com/folder/handoff). We discovered a minor bug in that fix that
315
+ causes some menu constructs to work poorly. This release fixes that issue.
316
+
317
+ ## \[1.0.5] - 2026-02-19
318
+
319
+ This is a minor improvement release that extends the quickstart released in the
320
+ 1.0.4. It extends the quickstart to work from the Handoff-CLI when installed
321
+ globally. You can use `handoff-app init` to initialize a new project.
322
+
323
+ ## \[1.0.4] - 2026-02-19
324
+
325
+ Bugfixes, UX improvements to the component page, improvements to react docgen,
326
+ a new quickstart command, and security fixes.
327
+
328
+ ## New Quickstart
329
+
330
+ * Running `npx create-handoff-app` will scaffold up a new handoff project
331
+ in the current directory. The wizard will walk you through either creating
332
+ an empty project, or scaffolding a simple initial component and frontend
333
+ stack.
334
+
335
+ ## UX Features
336
+
337
+ * Properties of a component are now nested, with indications of the number and
338
+ type of children properties. This makes it easier to understand how properties
339
+ are structured and related
340
+ * The API response documentation is now a tree view, rather a formated JSON
341
+ object. This makes it much easier to see and reason about the JSON response.
342
+
343
+ ## Bug Fixes
344
+
345
+ * The API preview would through a 500 error under some conditions
346
+ * Using TSX components would cause an error in the code preview if the tsx component
347
+ used some kinds of valid react formatting.
348
+ * If you create pages without a declared weight, handoff would throw an error
349
+ * There was an old structure in the way we used handlebars that surfaces a warning
350
+ on build. We've updated that method.
351
+ * We removed an old page template that was no longer needed.
352
+ * The API calls to the component url were not working well in subpaths.
353
+
354
+ ## Type Gen
355
+
356
+ * When using TSX instead of handlebars, the properties can be automatically
357
+ generated from the exported type. This version improves the parsing of those
358
+ types, to descend into object and array subtypes and parse out the specific
359
+ subtypes included there.
360
+
361
+ ## API Additions
362
+
363
+ * The pipeline now generates an icon sprite and an icon manifest file. These
364
+ files are loaded into the root of the /api.
365
+ * You can fetch the sprite file at `/api/icons-sprite.svg`
366
+ * You can fetch the manifest at `/api/icons-sprite-manifest.json`
367
+
368
+ ## Security
369
+
370
+ * Updating Next to 15.5.12 to close a security risk with server side rendered components.
371
+ Since Handoff does not use server side rendered components, handoff sites are not
372
+ vulnerable to this risks.
373
+
374
+ ## QoL Improvements
375
+
376
+ * Fixes a bug in webpack that made the include path lookups fail. @handoff and @/util now
377
+ works properly.
378
+
379
+ ## \[1.0.3]
380
+
381
+ This this version was skipped.
382
+
383
+ ## \[1.0.2] - 2026-01-12
384
+
385
+ Bugfixes focused on developer quality of life.
386
+
387
+ ### Bugfix
388
+
389
+ * When developing in handoff, changes to components cause the Nextjs HMR to fail
390
+ resulting in a 404 error. This patch resolves a race condition in the HMR, by
391
+ preventing double write of the next config.
392
+ * Patch an issue where the example component doesn't load in a clean project
393
+
394
+ ## \[1.0.1] - 2025-12-28
395
+
396
+ A minor bugfix release that fixes some issues when running handoff-app as a
397
+ CLI tool.
398
+
399
+ ## \[1.0.0] - 2025-12-23
400
+
401
+ This release marks Handoff 1.0, a stable and mature version of the Handoff
402
+ toolchain. Handoff is designed to help teams build robust design systems and
403
+ reliable design-to-development pipelines by making it easy to extract structured
404
+ data from Figma and scaffold API-driven systems with minimal overhead.
405
+
406
+ ### Handoff Key 1.0.0 Features
407
+
408
+ * Automated Figma token and metadata extraction via REST API
409
+ * Design system documentation app mixing automated and custom docs
410
+ * Robust REST API for consuming tokens, components, and documentation in applications
411
+ and pipelines
412
+ * Flexible, hookable API for describing and building components agnostic to framework
413
+ and infrastructure
414
+
415
+ ### Changes since 0.18.0
416
+
417
+ This release patches several small bugs and smooths several small issues in the
418
+ UX. It also removes the `dist` directory from this repo, so that compiled code
419
+ is not stored with the repo.
420
+
421
+ ### Bugfixes
422
+
423
+ * When running handoff locally in dev mode (`npm run start`) the component build
424
+ wasn't automatically firing. This was caused by removing versions but not
425
+ adjusting the path tracking.
426
+ * Fixed an issue were custom components, lacking the figmaComponentId, were
427
+ creating dropdowns for varying the properties based on the previews.
428
+
429
+ ### DX Changes
430
+
431
+ * Components linked to Figma components (via figmaComponentId) will
432
+ automatically display properties pulled from figma, and allow users to see
433
+ all the variants by altering properties.
434
+ * Improvements to the custom theme handling for handoff sites. The theme css in
435
+ the project will now be read in and can use tailwind and css structures to
436
+ extend the theme of the app.
437
+ * Removed lorem ipsum from default pages
438
+
439
+ ### UI
440
+
441
+ * The component search and filtering experience has been significantly improved
442
+ * Fixed several UI issues with dark mode.
443
+ * Fixed foundation token anchor links
444
+
445
+ ### Chore
446
+
447
+ * Remove dist folder from the handoff-app repository
448
+
449
+ ## \[0.18.0] - 2025-12-15
450
+
451
+ We consider this to be our 1.0.0 pre release candidate. We consider all Handoff
452
+ APIs (component construction, REST api, and library) to be stable and mature.
453
+
454
+ ## Major Changes
455
+
456
+ ### Interactive Component Scaffolding
457
+
458
+ * **New `scaffold` Command**: Quickly generate component stubs from your Figma tokens using our new interactive CLI tool.
459
+ * **Smart Detection**: The tool automatically checks your `tokens.json` against local files to identify which Figma components are missing implementations and suggests stubs for them.
460
+ * **Improved CLI Experience**: Smoother, more modern terminal interface with clearer prompts and guidance.
461
+
462
+ ### Faster Builds
463
+
464
+ * **Incremental Builds**: We've introduced a new caching system that significantly speeds up build times by only processing components that have actually changed.
465
+ * **Optimized Updates**: The build process now intelligently merges data, making updates faster and more efficient for large design systems.
466
+
467
+ ### Enhanced Stability & Diagnostics
468
+
469
+ * **Clearer Logging**: We've completely overhauled application logging to provide cleaner, more consistent, and easier-to-read output in your terminal.
470
+ * **Improved App Startup**: The application initialization and file watching processes have been hardened to be more stable and reliable during development.
471
+ * **Better Error Reporting**: Removed confusing error messages to ensure that the logs you see are relevant and actionable.
472
+
473
+ ### Streamlined Configuration
474
+
475
+ * **Unified Runtime Config**: We've simplified how integrations and configurations are handled, making the internal system more robust and easier to maintain.
476
+ * **Legacy Cleanup**: We've removed deprecated "exportable" component commands and configurations to reduce clutter and focus on the modern integration workflow.
477
+ * **Changelog Removal**: The internal design token changelog feature has been removed to streamline the pipeline
478
+
479
+ ### Additional Improvements
480
+
481
+ **Component Discovery & Navigation**
482
+
483
+ * **Enhanced Component List**: Added new filtering, sorting, and grouping options to the component list, making it easier to find what you need in large libraries.
484
+ * **Seamless Navigation**: Added "Previous" and "Next" buttons to documentation pages for easier browsing between components.
485
+
486
+ ### CLI & Developer Experience\*\*
487
+
488
+ * **Config Ejection**: You can now easily eject the default configuration into a local JS file using the updated `eject` command.
489
+ * **Documentation Engine Update**: Switched from MDX to a more robust Markdown implementation to improve stability.
490
+ * **Syntax Highlighting**: Fixed issues with code block syntax highlighting in documentation.
491
+ * **Security Updates**: Applied important security patches for Next.js and React 19 dependencies.
492
+
493
+ ### UI Improvements
494
+
495
+ * **Tailwind 4**: The handoff application now runs tailwind 4 for improved customziation and modern UI features
496
+ * **Color Page**: Significant improvements to color data to show much more detail about color use
497
+ * **Component Search**: Added component search and filtering on system landing page
498
+ * **Improved Stack Navigation**: Added next previous navigation to component pages
499
+ * **More Markdown Customization**: Adding markdown content to the home page to allow customization
500
+ * **Config Ejection**:
501
+
502
+ ## Specific changes
503
+
504
+ ### Component API Changes
505
+
506
+ * Components can now be explicitly linked to the figma component allowing ongoing
507
+ property, description, and metadata sync via the `figma_component_id` property.
508
+ * Components no longer use semver versioning in the component structure. You will
509
+ have to migrate to a flat directory structure where the component files are in the
510
+ root of the component directory
511
+ * Instead of {component\_id}/1.0.0/{data}, the structure should be {component\_id}/{data}
512
+
513
+ ### CLI Changes
514
+
515
+ * Adds a command `handoff-app scaffold` that will look at your figma file for
516
+ published components, and suggest components for handoff.
517
+ * Will launch a wizard that will scaffold simple components for each Figma
518
+ component and link them to the figma reference
519
+ * `make:page` will now only create `.md` pages
520
+ * `handoff-app build:app` can now accept a switch `--skip-components` which
521
+ will bypass component build. This is especially useful for speeding CI/CD builds
522
+ * `eject:config` now ejexts a typed js config file instead of a JSON config
523
+ * Removes the following commands related to legacy infrastructure
524
+ * `make:exportable`
525
+ * `make:integrationStyles`
526
+ * `eject:schema`
527
+ * `eject:exportables`
528
+ * `make:schema`
529
+
530
+ ### DX Changes
531
+
532
+ * React component properties will automatically generate properties in the
533
+ REST api and the app UI, generated from the properties and types of the component
534
+ * The handoff config will now be
535
+ * The logging has been rewritten to provide better clarity and eliminate noise
536
+ * The prompting has been rewritten to provide cleaner interactions
537
+
538
+ ### Security Fixes
539
+
540
+ * Handoff is not affected by the React2Shell vulnerabilities because it uses
541
+ no server side React components. Version 18 updates to the latest 15 release of
542
+ NextJS and React 19 to minimize false positives in dependency reporting.
543
+
544
+ ### Bug Fixes
545
+
546
+ * Hooking into the vite css configuration would break typing if your local vite didn't
547
+ match the vite bundled with handoff.
548
+
549
+ ## \[0.17.1] - 2025-11-13
550
+
551
+ This patch improves docs-site component loading and resolves a state-mutation issue.
552
+
553
+ ### Bug Fixes
554
+
555
+ * Improved docs-site component loading to ensure components render correctly.
556
+ * Implemented deep cloning to avoid accidental mutations of `defaultComponent`.
557
+
558
+ ## \[0.17.0] - 2025-08-06
559
+
560
+ ## Major Highlights
561
+
562
+ ### Vite Migration
563
+
564
+ The project has transitioned from Webpack to Vite as the new build tool. This significantly improves performance, simplifies configuration, and lays the groundwork for future extensibility. Legacy integration steps and commands related to Webpack have been removed.
565
+
566
+ ### Modularization via `handoff-core`
567
+
568
+ Core token pipeline logic has been extracted into a new shared package: `handoff-core`.
569
+ This change makes the internal architecture of `handoff-app` cleaner and enables easier maintenance across related tools like the Figma plugin.
570
+
571
+ ### SSR and Hydration Support
572
+
573
+ Initial support for Server-Side Rendering (SSR) and hydration is now available.
574
+
575
+ * SSR is enabled for static previews and production-ready rendering
576
+ * Hydration allows React components to become interactive after being statically rendered
577
+ * These features are considered stable but may still evolve in upcoming releases
578
+
579
+ ### JavaScript-Based Configuration
580
+
581
+ All configuration files now support JavaScript in addition to JSON.
582
+ You can now define your config using `handoff.config.js` or `handoff.config.cjs`, and other related files (such as component config files) also support JS formats.
583
+ JSON is still supported, but JavaScript usage is encouraged for better flexibility.
584
+
585
+ ## Hook-Based Extensibility
586
+
587
+ A new hook system allows developers to customize parts of the build and schema pipeline.
588
+ **Available hooks:**
589
+
590
+ * `validateComponent`
591
+ * `ssrBuildConfig`
592
+ * `clientBuildConfig`
593
+ * `getSchemaFromExports`
594
+ * `schemaToProperties`
595
+ * `jsBuildConfig`
596
+ * `cssBuildConfig`
597
+ * `htmlBuildConfig`
598
+
599
+ ## Additional Features
600
+
601
+ * Component schema export support to help generate documentation tables and property lists
602
+ * Preview filtering to improve navigation in large component libraries
603
+ * New transform generates `.tsx` pages from `.mdx` for better compatibility with typed docs
604
+ * Replaced use of unofficial Next.js APIs with `cross-spawn` for build and dev processes
605
+ * More informative error handling and validation messages
606
+ * Default doc format now set to `.mdx`
607
+
608
+ ## Cleanup and Refactors
609
+
610
+ * Removed deprecated integrations and plugin code
611
+ * Dropped part of unused dependencies including `axios`
612
+ * Standardized configuration logic and naming
613
+ * Improved fallback behavior for missing component CSS or schema
614
+ * Cleaned up type definitions and utility functions
615
+
616
+ ## Compatibility Notes
617
+
618
+ * Now tested with React 19 and Next.js 15
619
+ * Older React and Next versions may no longer be compatible
620
+
621
+ ## \[0.16.0] - 2025-06-03
622
+
623
+ This release is a major reorganization of Handoff. We've preserved the core
624
+ Figma Token ETL behavior, but this release significantly rethinks and improves
625
+ the documentation application.
626
+
627
+ **This is a significant breaking change. We recommend starting from a fresh
628
+ project.** Its possible to upgrade an existing Handoff project, but its
629
+ easier to start fresh. Previous versions of handoff depended on specific
630
+ structure. We're working to remove any structure or conventions, so you can
631
+ use handoff in any project as you see fit.
632
+
633
+ Contact us if you need help upgrading a legacy project handoff@convertiv.com.
634
+
635
+ ### Justification
636
+
637
+ The Handoff documentation app was initial designed to complement the token e
638
+ xtraction and document simple tokens. Over time, we added the ability to
639
+ document Figma components in the application. We supported integrations that
640
+ would allow users to describe Figma components in code.
641
+
642
+ As we built out more complex design system documentation, we quickly hit the limits
643
+ of what we could build and describe with that simple system. We needed a way
644
+ to flexibly describe components - both defined in Figma, and standalone custom
645
+ components. There are other open source products like Storybook that have some
646
+ of this functionality but we were looking for a more flexible, and robust
647
+ architecture for describing and distributing components across ecosystems.
648
+
649
+ This release does a number major things -
650
+
651
+ * Introduces a new component architecture, allowing users to describe components
652
+ using handlebars, css, and JSON
653
+ * These components are built, compiled, and validated on each handoff build. The
654
+ build system is designed to be highly configurable.
655
+ * Each component has a set of typed properties allowing users to pass pass in
656
+ data to the component, and visualize variations
657
+ * Components can be annotated with metadata to allow users to provide robust
658
+ usage guidelines.
659
+ * Each component is semver versioned
660
+ *
661
+ * Publishes a robust API at /api/components.json that allows remote systems to
662
+ query the
663
+ * Each component is published at /api/component/{name}.json. This allows systems
664
+ to fetch just the relevant component.
665
+ * Completely redesigns and rearchitects the application.
666
+ * Redesigned using shadCn tailwind components
667
+ * Reorganized the information architecture to default to best practice in
668
+ organizing foundations, systems and guidelines.
669
+ * This architecture and design can be customized
670
+
671
+ See the demo site at demo.handoff.com and the demo code at h
672
+ https://github.com/Convertiv/handoff-demo to have a sample of how this should be
673
+ structured
674
+
675
+ ## Component Structure
676
+
677
+ In this version components should be stored at `{integrationPath}/components`.
678
+ Each integration should be in a folder with a unique name. This name will be
679
+ used as the id for the component.
680
+
681
+ Within each component folder, there should be at least one folder, named
682
+ with a semver name. The structure of this should look like
683
+
684
+ * {integrationPath}
685
+ * components
686
+ * component1
687
+ * 1.0.0
688
+ * component1.json - Describes the component in a JSON format documented below
689
+ * component1.hbs - A handlebar template to describe the markup of the component
690
+ * component1.scss - An optional style sheet to include with the project
691
+ * component1.js - An optional js file to include with the project
692
+
693
+ ### Minimum Component JSON
694
+
695
+ This is a sample json component to show how you can structure the component
696
+ documenation. Most of this is metadata used to construct robust documentation
697
+ for users.
698
+
699
+ The two important semantic sections are `previews` and `properties`. Properties
700
+ defines a list of properties the component accepts. They are defined using the
701
+ OpenAPI json specification.
702
+
703
+ Once you define a list of properties, you can then define a list of previews.
704
+ Each preview defines values for the properties. Handoff will then render a set
705
+ of html previews of your component. This way you can render variations
706
+ simply.
707
+
708
+ ```JSON
709
+ {
710
+ "title": "Accordion",
711
+ "image": "https://placehold.co/1360x900",
712
+ "description": "Collapsible sections for toggling sections of content on and off.",
713
+ "figma": "https://www.figma.com/design/<figma-file-key>/Design-System?node-id=301-598",
714
+ "type": "block",
715
+ "group": "Accordion",
716
+ "categories": ["Components"],
717
+ "tags": ["accordion"],
718
+ "should_do": ["Show a list of items in an accordion format.", "Allow users to expand and collapse each item individually."],
719
+ "should_not_do": ["Use this component for a large number of items."],
720
+ "changelog": [
721
+ {
722
+ "version": "1.0.0",
723
+ "date": "2021-01-01",
724
+ "changes": ["Initial version."]
725
+ }
726
+ ],
727
+ "previews": {
728
+ "generic": {
729
+ "title": "Generic",
730
+ "values": {
731
+ "id": "accordion",
732
+ "items": [
733
+ {
734
+ "id": "accordion-item-1",
735
+ "title": "Accordion Item 1",
736
+ "paragraph": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco.",
737
+ "image": {
738
+ "url": "https://placehold.co/1360x900",
739
+ "alt": "Image alt text"
740
+ }
741
+ },
742
+ }
743
+ ]
744
+ }
745
+ }
746
+ },
747
+ "properties": {
748
+ "id": {
749
+ "name": "ID",
750
+ "description": "Unique identifier for the accordion.",
751
+ "type": "text",
752
+ "default": "accordion",
753
+ "rules": {
754
+ "required": true,
755
+ "content": {
756
+ "min": 5,
757
+ "max": 25
758
+ },
759
+ "pattern": "^[a-z0-9-]+$"
760
+ }
761
+ },
762
+ "items": {
763
+ "name": "Items",
764
+ "description": "Accordion items",
765
+ "type": "array",
766
+ "items": {
767
+ "type": "object",
768
+ "properties": {
769
+ "id": {
770
+ "name": "ID",
771
+ "description": "Unique identifier for the accordion item.",
772
+ "type": "text",
773
+ "default": "accordion-item-1",
774
+ "rules": {
775
+ "required": true,
776
+ "content": {
777
+ "min": 5,
778
+ "max": 25
779
+ },
780
+ "pattern": "^[a-z0-9-]+$"
781
+ }
782
+ },
783
+ "title": {
784
+ "name": "Title",
785
+ "description": "Title of the accordion item.",
786
+ "type": "text",
787
+ "default": "Accordion Item 1",
788
+ "rules": {
789
+ "required": true,
790
+ "content": {
791
+ "min": 5,
792
+ "max": 25
793
+ }
794
+ }
795
+ },
796
+ "paragraph": {
797
+ "name": "Paragraph",
798
+ "description": "Paragraph of the accordion item.",
799
+ "type": "text",
800
+ "default": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco.",
801
+ "rules": {
802
+ "required": true,
803
+ "content": {
804
+ "min": 5,
805
+ "max": 100
806
+ }
807
+ }
808
+ },
809
+ "image": {
810
+ "name": "Image",
811
+ "description": "Image of the accordion item.",
812
+ "type": "image",
813
+ "default": {
814
+ "url": "https://placehold.co/1360x900",
815
+ "alt": "Image alt text"
816
+ },
817
+ "rules": {
818
+ "required": true,
819
+ "dimensions": {
820
+ "min": {
821
+ "width": 1360,
822
+ "height": 900
823
+ },
824
+ "max": {
825
+ "width": 1360,
826
+ "height": 900
827
+ }
828
+ }
829
+ }
830
+ }
831
+ }
832
+ },
833
+ "rules": {
834
+ "required": true,
835
+ "min": 1,
836
+ "max": 10
837
+ }
838
+ }
839
+ }
840
+ }
841
+ ```
842
+
843
+ ### Handlebars Templates
844
+
845
+ We anticipate allowing other templating systems in the future, but in this
846
+ version, we support handlebars with limited logic. Using Handlebars allows
847
+ us to create a simple system that will be compatible with most downstream
848
+ platforms.
849
+
850
+ There are two special feature of this handlebars file -
851
+
852
+ * `#field` This allows you wrap a field in a tag. This allows handoff to inject
853
+ metadata around a field to make the field inline editable, and to allow us to
854
+ open a sidebar with metadata about the property. You don't have to use this
855
+ but its helpful.
856
+ * `style` and `script` - These tags allow us to inject automatically the built
857
+ script and style artifacts.
858
+
859
+ ```html
860
+ <head>
861
+ {{{style}}} {{{script}}}
862
+ </head>
863
+ <body class="preview-body">
864
+ <section class="py-lg-12 py-8">
865
+ <div class="container">
866
+ <div class="row justify-content-center">
867
+ <div class="col-12 col-lg-10">
868
+ <div class="accordion accordion-spaced" id="{{properties.id}}">
869
+ {{#each properties.items}}
870
+ <div class="accordion-item">
871
+ <h3 class="accordion-header" id="{{../properties.id}}-heading-{{this.id}}">
872
+ <button
873
+ class="accordion-button"
874
+ type="button"
875
+ data-bs-toggle="collapse"
876
+ data-bs-target="#{{../properties.id}}-collapse-{{this.id}}"
877
+ aria-expanded="true"
878
+ aria-controls="{{../properties.id}}-collapse-{{this.id}}"
879
+ >
880
+ {{#field "items.title" }}{{this.title}}{{/field}}
881
+ </button>
882
+ </h3>
883
+ <div
884
+ id="{{../properties.id}}-collapse-{{this.id}}"
885
+ class="accordion-collapse collapse"
886
+ aria-labelledby="{{this.id}}"
887
+ data-bs-parent="#{{../properties.id}}-heading-{{this.id}}"
888
+ >
889
+ <div class="accordion-body w-lg-90 mx-lg-auto fs-lg">
890
+ <p>{{#field "items.paragraph" }}{{this.paragraph}}{{/field}}</p>
891
+ </div>
892
+ </div>
893
+ </div>
894
+ {{/each}}
895
+ </div>
896
+ </div>
897
+ </div>
898
+ </div>
899
+ </section>
900
+ </body>
901
+ ```
902
+
903
+ ### Bugfixes
904
+
905
+ ## \[0.15.2] - 2024-12-11
906
+
907
+ This release fixes a small bug when pulling foundation tokens with nested names.
908
+
909
+ ### Bugfixes
910
+
911
+ * Figma's name schema delivers names as {group}/{name}. If your foundation
912
+ (color, shadow, etc) names include a slash `Blue/100` Handoff would only grab
913
+ the first part of that name, and construct the token excluding the remaining
914
+ data. This patch resolves that so instead of getting `primitive-blue` you will
915
+ now get `primitive-blue-100` as your token.
916
+
917
+ ## \[0.15.1] - 2024-11-27
918
+
919
+ This is a minor release to fix several small typing issues that cause problems
920
+ in the linter when running as a local NPM package.
921
+
922
+ ### Bugfixes
923
+
924
+ * Fixes a typing issue in the transformers when including the handoff core package
925
+ * Fixes a typing issue when including the ReferenceObject type
926
+
927
+ ## \[0.15.0] - 2024-11-05
928
+
929
+ This release allows Figma foundation styles - Colors, Typography, and Effects
930
+ to create variable references in component styles in CSS, SASS, and Style
931
+ Dictionaries. It also adds shared style support in snippets to make it easier
932
+ to structure and reuse styles across multiple large components.
933
+
934
+ ### Features
935
+
936
+ * Figma foundation styles - Colors, Typography, and Effects - are now linked to
937
+ component styles in the tokens export. This allows you to use foundation styles
938
+ as variables in component styles in CSS, SASS, and Style Dictionaries.
939
+ * To enable, set `useVariables` to `true` in the `handoff.config.json` file.
940
+ * You can also enable variable support via the `.env` var
941
+ `HANDOFF_USE_VARIABLES`. You can use a boolean or string ("true"/"false")
942
+ * When enabled, Handoff will create variable references in the component styles
943
+ for the foundation styles wherever possible instead of using the string value.
944
+ * For example a color foundation style `Blue` in the `Primary` color group
945
+ with value `#FF0000` will be referenced as `var(--color-primary-blue)` in
946
+ the component styles instead of `#FF0000`.
947
+ * This feature is disabled by default.
948
+ * Added support for shared styles in snippets. Shared Styles exist to allow users
949
+ to separate styles used across multiple components from the styles unique to
950
+ each component.
951
+ * To use a shared style in a snippet, add a `{{ sharedStyles }}` to your snippet
952
+ HTML file. Handoff will replace this with the shared styles from the Figma
953
+ file.
954
+ * Created a `shared.scss` or `shared.css` file in the `integration/snippets`
955
+ directory to define the shared styles.
956
+ * If the shared styles are defined in a `shared.scss` file, Handoff will compile
957
+ the shared styles to CSS and include them in the snippet.
958
+
959
+ ### Changes
960
+
961
+ * The default configuration now has a `useVariables` property set to `false` to
962
+ maintain backward compatibility.
963
+ * The default snippets.html file now includes a `{{ sharedStyles }}` token to
964
+ support shared styles in snippets. This value will be empty if no shared styles
965
+ exists.
966
+
967
+ ## \[0.14.1] - 2024-10-28
968
+
969
+ This release introduces greater flexibility for custom integrations and general improvements to CLI handling.
970
+
971
+ ### Changes
972
+
973
+ * Added support for custom integration paths with the `-i <path-to-integration>` CLI argument.
974
+ * Can be used with commands like `fetch`, `start`, `build:app`, etc.
975
+ * Defaults to the `integration` directory if the argument isn't specified, ensuring backward compatibility.
976
+
977
+ ### Improvements
978
+
979
+ * Enhanced CLI command management:
980
+ * Switched to `yargs` for improved CLI parsing.
981
+ * Each command now has a dedicated handler file for better modularity.
982
+ * Improved the docs app build process:
983
+ * Introduced a cleanup procedure that ensures only files present in the working directory are included in the final build.
984
+
985
+ ## \[0.14.0] - 2024-09-26
986
+
987
+ This release enables creation of complex documentation pages, with storybook
988
+ compatible formats. It has two main features - MDX support for adding react
989
+ components to your documentation pages, and Snippet Previews - a system for
990
+ using Handoff's existing html build process to create complex component
991
+ previews.
992
+
993
+ ### Features
994
+
995
+ * **MDX Support** Support for MDX files in Handoff Documentation App
996
+ * [MDX Files](https://mdxjs.com/) Markdown files with react components
997
+ * Any react component can be imported
998
+ * Handoff exposes a number of custom react components that you can use in
999
+ MDX pages to build
1000
+ * **Snippet Previews** Create html snippets that will render as a preview with
1001
+ html, js, css and sass code below the preview
1002
+ * Place a file ending with `.html` in the `/integration/snippets` file or
1003
+ run the `make:snippet [name]` cli command
1004
+ * Handoff will detect the file and make it available to the `SnippetPreview`
1005
+ component
1006
+ * If Handoff detects a snippet file ending in js or scss, with the same name
1007
+ as the html file, Handoff will automatically use webpack and node-sass to
1008
+ build those files and make the compiled code available to html template.
1009
+ * If Handoff detects a css file with the same name, it will use that file
1010
+ for styling the preview
1011
+ * The `html` file is a Mustache template. At present there are two variables
1012
+ that can be used in these files
1013
+ * `{{{style}}}` a compressed inline style of either the compiled sass code
1014
+ or the raw css code provided.
1015
+ * `{{{script}}}` a compressed inline script of the output of the js compilation
1016
+ * In your MDX files you can display the snippets using `SnippetPreview`. This
1017
+ component accepts 2 - 3 properties, plus a react fragment as the children.
1018
+ * `title` accepts a string as the `h2` title. Set to false or exclude if you
1019
+ don't want it
1020
+ * `id` is the name of your snippet `{name}.html` The snippet will load dynamical
1021
+ * `height` accepts a string to set the height of the preview. If you leave it
1022
+ off, Handoff will set the height of the preview automatically from the contents
1023
+ of the snippet.
1024
+
1025
+ ```jsx
1026
+ <SnippetPreview title="A Testimonial Component" id="testimonial" height="725px">
1027
+ <p>Render a testimonial inline with other content.</p>
1028
+ </SnippetPreview>
1029
+ ```
1030
+
1031
+ ### Additional CLI Commands
1032
+
1033
+ * `build:snippets <name>` will either rebuild all the snippets for you, or if an
1034
+ optional name is passed, will rebuild a single snippet
1035
+ * `rename:snippet <source> <destination>` will rename a snippet and its js and scss
1036
+ files
1037
+
1038
+ ### Bugfixes
1039
+
1040
+ * Fixes a bug introduced in 0.13.0 where the integration preprocess would try to
1041
+ execute handlebars insertion even on non text files
1042
+ * Fixes a bug in the foundation page templates where the markdown would be included
1043
+ outside of the section wrapper
1044
+ * Fixes a bug in the `start` command where every doc page would be flagged as
1045
+ changed on watch.
1046
+
1047
+ ## \[0.13.2] - 2024-09-18
1048
+
1049
+ This release addresses several developer experience issues
1050
+
1051
+ ### Bugfixes
1052
+
1053
+ * When an integration compiles SASS code, the token injection was injecting components that had no instances in Figma. This causes integrations to fail if the designer had published a component, but not annotated them in Figma with the plugin. This release checks to see if the component has any instances in the Figma export and skips injection for components that are not yet annotated in Figma
1054
+ * When running `eject:integration` or `make:integration` the default integration is exported, but it is not built. This causes a weird developer experience if you try to `build:app` without `build:integration` first. This patch adds the `build:integration` logic to execute after `eject` or `make` as well as before `build:app` to ensure that if an integration exists, the integration is built before building or serving the app
1055
+ * If an an `build:app` fails while building the integration preview sass code the error messages were not clear, and didn't explain that you could use `--debug` to make them more clear. The error message has been improved and now alerts users to the `--debug` flag to help them debug their integration.
1056
+ * When ejecting an integration with the `--force` flag, the force now triggers an overwrite rather than failing.
1057
+
1058
+ ## \[0.13.1] - 2024-09-17
1059
+
1060
+ This release fixes a couple of small path issues that affect running 0.13.0 from the global path.
1061
+
1062
+ ### Bugfixes
1063
+
1064
+ * Fix a path issue in the ComponentDesignTokens component that causes an error when run from the global namespace
1065
+ * Prevents typescript compile errors with the react-scroll `<Link>` component
1066
+
1067
+ ## \[0.13.0] - 2024-09-08
1068
+
1069
+ ### Changes
1070
+
1071
+ * **Integration System Overhaul**
1072
+ * **Local Integrations Only:** From this release onward, only local (ejected) integrations are supported. Handoff will automatically use the locally found integration.
1073
+ * Create a new local integration using `handoff-app make:integration` (or `eject:integration` which is still supported as an alias).
1074
+ * Since there is no need to specify integration information, integration options in `handoff.config.json` such as name and version are no longer recognized, making the integration section of `handoff.config.json` obsolete.
1075
+ * **Introduction of `integration.config.json`:**
1076
+ * This new file replaces the old `figma.options` section in `handoff.config.json` as well as all transformer related options within the legacy schemas as this file now contains all integration-specific details, including those options previously managed manually across different places.
1077
+ * This change leaves the `figma.options` section in `handoff.config.json` no longer supported and also means that all transformer options have been removed from legacy schemas (exportables), rendering this section no longer supported as well.
1078
+ * **Documentation App Configuration Changes:**
1079
+ * View of the component pages is now managed from within the integration(s), more specifically within the newly introduced `view.config.json` files, located in the respective component’s directory within the integration’s templates folder.
1080
+ * As a result the `demo` options section in all legacy schemas has now been removed and is no longer supported by Handoff.
1081
+
1082
+ * **Legacy Schema Updates**
1083
+ * **Local Schema Requirement:** Legacy schemas (exportables) are now only supported if ejected. The `use_legacy_definitions` option in `handoff.config.json` is no longer supported.
1084
+ * **Automatic Schema Consumption:** Handoff now automatically consumes all locally found schemas. The `figma.definitions` section in `handoff.config.json` is deprecated.
1085
+
1086
+ ### Upgrading from Earlier Releases
1087
+
1088
+ * **For Projects with Local Integrations:**
1089
+ 1. Temporarily rename your current local integration directory.
1090
+ 2. Create a new local integration using `handoff-app make:integration`.
1091
+ 3. Transfer the contents from your old integration (excluding `integration.config.json`) to the new directory (merge).
1092
+ 4. Update options in `integration.config.json` if needed.
1093
+ 5. Remove the old integration directory.
1094
+ * **For Projects Without Local Integrations:**
1095
+ 1. Create a new local integration using `handoff-app make:integration`. This will use a Bootstrap 5.3 template.
1096
+ 2. If previously using Bootstrap 5.2, update the integration contents accordingly. [Bootstrap 5.2 template](https://github.com/Convertiv/handoff-app/tree/v0.12.2/config/integrations/bootstrap/5.2).
1097
+ 3. Update `integration.config.json` options if necessary.
1098
+ * **For Projects with Legacy Schemas:**
1099
+ 1. Eject legacy schemas using `handoff-app eject:exportables`.
1100
+ 2. If schemas are already ejected:
1101
+ * Verify that transformer options are in `integration.config.json`.
1102
+ * Verify that demo options are in `view.config.json` files of respective components.
1103
+ * Temporarily rename the directory containing legacy schemas.
1104
+ * Re-eject schemas and move custom schemas into the new exportables.
1105
+ * Optionally, update custom schemas to remove obsolete options.
1106
+ * **For Projects with `handoff.config.json`:**
1107
+ 1. Merge options from `figma.options` to the `integration.config.json` file as necessary.
1108
+ 2. Optionally remove deprecated sections: `figma.options`, `figma.definitions`, `figma`, `integration`, and `use_legacy_definitions`.
1109
+
1110
+ ## \[0.12.2] - 2024-08-21
1111
+
1112
+ ### Changes
1113
+
1114
+ * Integration bundle used for the docs app is no longer being built during `fetch` and `build:integration` steps.
1115
+
1116
+ ## \[0.12.1] - 2024-06-18
1117
+
1118
+ ### Changes
1119
+
1120
+ * Added support for the `cssRootClass` property in the Handoff Figma plugin metadata.
1121
+
1122
+ ### Improvements
1123
+
1124
+ * Enhanced handling of unnamed parts, resolving visibility issues in the documentation previews.
1125
+
1126
+ ## \[0.12.0] - 2024-06-11
1127
+
1128
+ ### Changes
1129
+
1130
+ * All environment variables now contain the `HANDOFF_` prefix.
1131
+ * After updating to version 0.12.0, all environment variables need to be updated to reflect the new variable names:
1132
+ * `FIGMA_BASE_URL` -> `HANDOFF_FIGMA_BASE_URL`
1133
+ * `DEV_ACCESS_TOKEN` -> `HANDOFF_DEV_ACCESS_TOKEN`
1134
+ * `FIGMA_PROJECT_ID` -> `HANDOFF_FIGMA_PROJECT_ID`
1135
+ * `OUTPUT_DIR` -> `HANDOFF_OUTPUT_DIR`
1136
+ * `SITES_DIR` -> `HANDOFF_SITES_DIR`
1137
+ * `USE_HANDOFF_PLUGIN` -> `HANDOFF_USE_HANDOFF_PLUGIN`
1138
+ * `CREATE_ASSETS_ZIP_FILES` -> `HANDOFF_CREATE_ASSETS_ZIP_FILES`
1139
+ * The default integration is no longer pre-defined.
1140
+ * Bootstrap 5.3 is no longer set as the default integration.
1141
+ * To continue using the Bootstrap 5.3 integration in your project, ensure the configuration is ejected (`handoff-app eject:config`) and update it by setting the `integration` property to `{name: 'bootstrap', version: '5.3'}`.
1142
+ * All default options specified in the configuration that are used by the exporter and transformer have been removed.
1143
+ * To continue using the defaults present before the 0.12.0 release, ensure the configuration is ejected (`handoff-app eject:config`) and update the `figma.options` property to the [previous default value](https://github.com/Convertiv/handoff-app/blob/2a396145e7366732ae6a0e15cdf2226641d40a12/src/config.ts#L36-L59).
1144
+ * The logo placeholder copy showing spacing and orientation has been removed allowing users to add custom content via Markdown.
1145
+
1146
+ ### Improvements
1147
+
1148
+ * Handoff now appends to existing `.env` files instead of overriding them if the file already exists.
1149
+ * Introduced normalization of numeric values in `.css` and `.scss` files, along with correct indentations. This ensures that the generated files are valid for any local linting tools your project might use.
1150
+ * Configuration ejected by the `handoff-app eject:integration` command is now the same as the one ejected by the `handoff-app eject:config` command.
1151
+ * Handoff no longer uses the `iframe-resizer` package.
1152
+ * Resolved potential security issues by updating to newer versions of the `axios` and `next` packages.
1153
+
1154
+ ## \[0.11.0] - 2024-05-23
1155
+
1156
+ ### Bugfixes
1157
+
1158
+ * Issue that was causing the `handoff-app start` command to malfunction has been fixed.
1159
+ * The `Reference error: name is not defined` issue that occurred when a component specified in the schema was missing from the Figma file has been resolved. The `name` reference has been replaced with a correct identifier.
1160
+ * Icon sizes have been corrected.
1161
+
1162
+ ### Changes
1163
+
1164
+ * **Integration with Handoff Figma Plugin**: This release now seamlessly integrates with the Handoff Figma Plugin by default.
1165
+ * As a result, the local schema will not be used by default.
1166
+ * If you prefer to continue using local schemas, set `USE_HANDOFF_PLUGIN="FALSE"` in your `.env` file.
1167
+ * Internal module working directory has been relocated from `./src` to `./.handoff`
1168
+
1169
+ ## \[0.10.0] - 2024-01-16
1170
+
1171
+ ### Improvements
1172
+
1173
+ * Docs App:
1174
+ * Updated docs app to present components without associated content and assets more elegantly.
1175
+ * Improved the component pages by showing only the "Tokens" tab when no previews are detected; the "Overview" tab is hidden in such cases.
1176
+ * Configuration Handling:
1177
+ * Eliminated the need for `handoff.state.json` file.
1178
+ * All required parameters are now passed to the docs app through environment variables (`process.env`), defined in the project's respective `next.config.js` file.
1179
+ * Replaced `getConfig` with the more secure `getClientConfig` function.
1180
+ * New function returns only configurations that can be safely exposed on the client side.
1181
+
1182
+ ### Changes
1183
+
1184
+ * Handoff Figma Plugin Support:
1185
+ * Introduced initial support for the Handoff Figma Plugin.
1186
+ * Currently an opt-in feature as development is ongoing.
1187
+ * Can be enabled by setting `USE_HANDOFF_PLUGIN="TRUE"` in your `.env` file.
1188
+ * This functionality allows Handoff to extract metadata directly from the Figma file. Local JSON definitions are completely ignored in this case.
1189
+ * Will become the default behavior in the 1.0.0 release!
1190
+ * Deprecation Notice:
1191
+ * Deprecated local exportable component JSON definitions.
1192
+ * Still usable, but will be completely removed and ignored before the 1.0.0 release.
1193
+ * Components, parts, and related definitions should be defined with the Handoff Figma Plugin prior to the 1.0.0 release.
1194
+
1195
+ ## \[0.9.3] - 2023-11-23
1196
+
1197
+ ### Improvements
1198
+
1199
+ * It's now possible to declare conditions for exportable component parts. Condition dictates should the part be built based on provided condition (e.g. does a specific variant property have a certain value etc.).
1200
+ * Handoff will now process all component sets found within the frame in which the component set that matches the search is found. Previously it was limited to process only one (first) extra component set while others were ignored.
1201
+
1202
+ ### Changes
1203
+
1204
+ * Component preview title will no longer default to the value of the first variant property if no distinctive value is found. Empty value is now used instead.
1205
+
1206
+ ### Bugfixes
1207
+
1208
+ * Update of the app source will now update the watched app without having to restart the watch process (issue introduced in version 0.9.0).
1209
+
1210
+ ## \[0.9.2] - 2023-11-21
1211
+
1212
+ ### Improvements
1213
+
1214
+ * Handoff now supports both **personal access** and **OAuth2 bearer** tokens. If Handoff detects that a access token used starts with "Bearer " it will use the `Authorization` header to send the token as part of any Figma API request. In any other case, `X-Figma-Token` header will be used.
1215
+
1216
+ ## \[0.9.1] - 2023-11-14
1217
+
1218
+ ### Changes
1219
+
1220
+ * Footer component has been brought back into the app and is now visible on all pages.
1221
+ * Introduced token maps export feature which exports generated tokens alongside their respective values in form in JSON files (key/value object). Tokens for individual components/foundations are exported into the `tokens/maps` directory of the designated export directory as individual files while the `tokens-map` file, which contains all available tokens, gets exported into the designated export directory root.
1222
+
1223
+ ### Improvements
1224
+
1225
+ * Added additional logging into the app's `next.config.js` file alongside improved path resolving for custom themes.
1226
+
1227
+ ### Maintenance
1228
+
1229
+ * Updated the `.npmignore` file to reflect latest `.gitignore` changes made in the last release.
1230
+
1231
+ ## \[0.9.0] - 2023-11-10
1232
+
1233
+ This release focuses heavily on better support for environments on which multiple projects are being exported and built. All of the changes introduced in this release should provide better experience when working on such environments as well as resolve some of the issues which would occur when different projects would use same working directories.
1234
+
1235
+ ### Changes
1236
+
1237
+ * Handoff exports and builds are now updated to support export and build of multiple projects. Each respective output is now located in the subdirectory that matches the exported project id (e.g. /exports/{figmaProjectId}). This change prevents issues where one project would override handoff output of another project in environments where multiple Figma projects are being handled.
1238
+ * Due to the change in the output directory structure, Bootstrap integration has been updated with a @exported alias which is set to point to export directory of the current project for which the integration is being built.
1239
+ * Alongside existing support for customized app assets via the `public` directory, it’s now also possible to create a `public-{figmaProjectId}` directory which gets used only when the project with the respective Figma project id is being built. If the `public` directory is used, assets located in that directory will be applied to all projects.
1240
+ * Handoff state file now always includes the Figma project id.
1241
+ * Initial anonymization of the config file that gets loaded into the app to prevent secrets from being exposed on the client side.
1242
+ * Improvements to path resolving for custom app theme(s).
1243
+ * Restructure and improvements of the configuration:
1244
+ * `poweredBy` option is now called `attribution` and has been moved into `app` config key.
1245
+ * `next_base_path` option is now called `base_path` and has been moved into the `app` config key.
1246
+ * Following options have also been moved into the `app` config key: `theme`, `title`, `client`, `google_tag_manager`, `type_copy`, `type_sort`, `color_sort`, `component_sort`
1247
+ * `logo` and `favicon` options have been removed (it’s still possible to use custom assets but their name must match the default names).
1248
+ * Misc.
1249
+
1250
+ ### Bugfixes
1251
+
1252
+ * Resolved the wrong favicon path issue when app base path was set/used.
1253
+
1254
+ ### Migrate to a New Version
1255
+
1256
+ * Due to the restructure of the configuration, any local configuration (if exists) needs to be updated to match the new structure. Recommended way is to create a backup of the current local configuration(s) and to re-eject of the handoff configuration. Use the backup of the local configuration to update the up-to-date configuration ejected earlier. This process will ensure all the configuration options are defined correctly.
1257
+ * Since the export and app output directory structures have been updated, any custom script that relies on the old output path(s) should be updated to support new structure that includes the project id subdirectory.
1258
+
1259
+ ## \[0.8.8] - 2023-10-19
1260
+
1261
+ ### Bugfixes
1262
+
1263
+ * Fixed the issue build client file issue introduced in the 0.8.7 version.
1264
+
1265
+ ### Other
1266
+
1267
+ * Replaced the wrong date for the 0.8.7 release in the changelog with the correct one.
1268
+
1269
+ ## \[0.8.7] - 2023-10-19
1270
+
1271
+ ### Improvements
1272
+
1273
+ * Improved the way in which the handoff state is being utilized to prevent concurrency issues from occurring.
1274
+ * Improved path resolving across the project to prevent issues with wrong export directory being used from occurring.
1275
+ * Added more options to easily adjust some of the build process steps.
1276
+ * General quality improvements.
1277
+
1278
+ ## \[0.8.6] - 2023-10-12
1279
+
1280
+ ### Bugfixes
1281
+
1282
+ * Introduced cleanup prior to copying the integration files to the destination directory. This resolves the issue where deleted integration source files would still be present in the destination directory after running the integration build command.
1283
+ * Resolved a issue introduced in one of the prior releases where the design token name (variable) rendered in the tooltip of the design token value wasn't being displayed correctly.
1284
+
1285
+ ## \[0.8.5] - 2023-10-05
1286
+
1287
+ Miscellaneous improvements to ejecting of integrations, integration handling and building of previews to make it easier for the exported integration to be included in a bootstrap project.
1288
+
1289
+ ## \[0.8.4] - 2023-10-02
1290
+
1291
+ Handoff users reported a bug in `handoff-app build:app` last week. The bug didn't manifest in regression testing. This error was traced to typings in a dependency of `next`.
1292
+
1293
+ ### Bugfix
1294
+
1295
+ * Nextjs released 13.5.x which has conflict with the handoff build. This release instructs package.json to stay with 13.4.x while the conflict is resolved.
1296
+
1297
+ ## \[0.8.3] - 2023-09-27
1298
+
1299
+ ### Changes
1300
+
1301
+ * Added support for custom export path. This allows anyone using Handoff app to specity a path into which a copy of the exported tokens should be placed simply by defining `EXPORT_PATH` within the .env file.
1302
+
1303
+ ### Improvements
1304
+
1305
+ * Better handling of ejected themes.
1306
+
1307
+ ## \[0.8.2] - 2023-09-21
1308
+
1309
+ ### Changes
1310
+
1311
+ This release is focused on enabling Handoff users to disable any of the built in components (esentially prevent them from being exported). While this was possible in previous releases, it could cause issues when running the integration builds.
1312
+
1313
+ This improvements was achieved by:
1314
+
1315
+ * Moving component specific SCSS variables into respective files which can be included (imported) when tokens used in those files are considered to be present.
1316
+ * Implementing the SCSS import tokens which enables the main SCSS integration file to use import tokens in place where the import statements for component tokens, maps and extensions would usually be placed. Import tokens get replaced with actual import statements during the integration build. Following import tokens are supported with this release:
1317
+ * `//<#HANDOFF.TOKENS.TYPES#>`
1318
+ * `//<#HANDOFF.TOKENS.SASS#>`
1319
+ * `//<#HANDOFF.TOKENS.CSS#>`
1320
+ * `//<#HANDOFF.MAPS#>`
1321
+ * `//<#HANDOFF.EXTENSIONS#>`
1322
+
1323
+ As a side effect, the `node-sass-glob-importer` package depenedency is no longer needed as there is no longer need for "globbing" to be used when doing imports of exported component tokens since `//<#HANDOFF.TOKENS.TYPES#>`, `//<#HANDOFF.TOKENS.SASS#>` and `//<#HANDOFF.TOKENS.CSS#>` import tokens now provide basically the same functionality.
1324
+
1325
+ Because of changes mentioned above, this release does require some modifications to the **already ejected integrations** in order for the project to be completely compatible with the new version of Handoff.
1326
+
1327
+ Here are the steps that need to be done:
1328
+
1329
+ #### 1. Remove glob import statements and replace them with respective import tokens
1330
+
1331
+ Replace glob import lines with the respective import tokens. Note that design foundation tokens are manually imported as the tokens only handle imports related to the exported components.
1332
+
1333
+ *Before the new release:*
1334
+
1335
+ ```scss
1336
+ @import './exported/tokens/types/*';
1337
+ @import './exported/tokens/sass/*';
1338
+ @import './exported/tokens/css/*';
1339
+ ```
1340
+
1341
+ *With the new release:*
1342
+
1343
+ ```scss
1344
+ @import './exported/tokens/types/typography';
1345
+ @import './exported/tokens/types/effects';
1346
+ @import './exported/tokens/types/colors';
1347
+ //<#HANDOFF.TOKENS.TYPES#>
1348
+ @import './exported/tokens/sass/typography';
1349
+ @import './exported/tokens/sass/effects';
1350
+ @import './exported/tokens/sass/colors';
1351
+ //<#HANDOFF.TOKENS.SASS#>
1352
+ @import './exported/tokens/css/typography';
1353
+ @import './exported/tokens/css/effects';
1354
+ @import './exported/tokens/css/colors';
1355
+ //<#HANDOFF.TOKENS.CSS#>
1356
+ ```
1357
+
1358
+ #### 2. Include the (exported) component specific variables by using HANDOFF.MAPS import token
1359
+
1360
+ Add the `//<#HANDOFF.MAPS#>` replace token below the `@import 'variables'` statement. This will ensure that all variables related to the exported (built-in) components are correctly loaded.
1361
+
1362
+ *Before the new release:*
1363
+
1364
+ ```scss
1365
+ $prefix: '';
1366
+ @import 'variables';
1367
+ ```
1368
+
1369
+ *With the new release:*
1370
+
1371
+ ```scss
1372
+ $prefix: '';
1373
+ @import 'variables';
1374
+ //<#HANDOFF.MAPS#>
1375
+ ```
1376
+
1377
+ #### 3. Replace the imports statements used to extend default Bootstrap components with HANDOFF.EXTENSIONS import token
1378
+
1379
+ Replace all import statements used to extend the default Bootstrap components with the new `//<#HANDOFF.EXTENSIONS#>` import token to ensure that only those files that are related to the components that are actually being exported get imported.
1380
+
1381
+ *Before the new release:*
1382
+
1383
+ ```scss
1384
+ @import 'extended/alert';
1385
+ @import 'extended/button';
1386
+ @import 'extended/checkbox';
1387
+ ...
1388
+ ```
1389
+
1390
+ *With the new release:*
1391
+
1392
+ ```scss
1393
+ //<#HANDOFF.EXTENSIONS#>
1394
+ ```
1395
+
1396
+ #### 4. Eject the latest version of the integration used
1397
+
1398
+ Due to changes made to the `variables.scss` file and most of the scss files in the `maps` directory for the the Bootstrap version 5.2 and 5.3 interations, it's recommended to do a integration eject (after updating to Handoff 0.8.2) to ensure that your project continues to work correctly. Please remember to do a backup of your current work before doing this.
1399
+
1400
+ ### Bugfixes
1401
+
1402
+ * Updated the preview client build to not include the main SASS integration file as a extra integration in order to prevent redundant loading of the integration which caused the client bundle size to be double the size than it really needed to be while also causing few more issues in the new release where the styles wouldn't get applied correctly.
1403
+
1404
+ ## \[0.8.1] - 2023-09-06
1405
+
1406
+ ### Cleanup
1407
+
1408
+ * Updated `Token` interface so that all properties other than `property` or `value` are now moved to `metadata`.
1409
+ * Updates to reflect the changes made to the `Token` interface.
1410
+ * General improvements to code quality and consistency.
1411
+
1412
+ ## \[0.8.0] - 2023-08-22
1413
+
1414
+ This release is focused primarily on improving the way Handoff fetches data from figma. These changes are subtle, and do not bring any major use experience change. As we used Handoff with a wider variety of Figma design systems, we noticed that the schemas couldn't quite capture all of the various component structures.
1415
+
1416
+ In Figma, every component has a set of properties. These are used for categorizing the component and declaring use and behavior. These are things like - type, theme, state etc. Handoff's schemas allowed you to choose which of those properties would be pulled from a component, but did not allow you to rename or declare custom properties. This is because these properties often create semantic or behavioral meaning.
1417
+
1418
+ This release allows you to name and configure these properties, and map them to the sematic or behavioral meaning. This allows designers to name things according to internal conventions, localize prop names, and declare new custom properties to ingest.
1419
+
1420
+ ### Changes
1421
+
1422
+ * Exportable (JSON file) now has a updated syntax to share variant over multiple design components based on the variant props.
1423
+ * `supportedVariantProps` now accepts an object rather than an array. This object has two properties `design` and `layout`. Users should declare the props that should be pulled as an array of each of these props. The props should be the name as it is in Figma, not the old key names Handoff used to require.
1424
+ * The previous templates for css and scss token patterns have been removed in favor of `tokenNameSegments`. This a tokenized array of strings that allow you to generate token names for each component following a pattern.
1425
+ * In the `demo` section, under the tabs, you can now declare the default value for each property.
1426
+ * In the `demo` section, under `designTokens` you can explicitly declare all the values of a property to show on the demo page.
1427
+ * Previously you could do `State(:disabled)` which would automatically apply the "disabled" state to all design components, distinctive only by the theme (which means light theme would have one shared disabled state while dark theme would have a different one).
1428
+ * The update allows you to do this `State(:disabled/Theme)` which removes the need for us to know what the theme variant property is and to allow users to distinct over any variant property they have and desire.
1429
+ * This allows handoff to choose NOT to group/distinct by any variant property. Previously this was not possible as if there was a theme variant property present, it would be automatically used to group by it.
1430
+ * Paths for preview templates now account for all variant properties, but, if some of them are missing in the integration templates folder for the component, it will be dismissed and we will try starting from the next one (for example, if theme is not there as a folder, we will ignore it and proceed to the next variant prop and so on). This also removes the need for us to know what the theme variant property is as we don't need to filter them out based on if it's a theme variant prop or not.
1431
+ * Component titles in the app now have a smarter way of automatically determining the title of the preview component. This is achieved by looking into the filters used to display the previews of the components and decide which variant property you probably want to use in the name of the component preview.
1432
+
1433
+ ### Bugfixes
1434
+
1435
+ * Node Sass version has been locked at version `1.64.2`. `1.65.0` introduces a breaking change and we need to update the maps before upgrading to it.
1436
+
1437
+ ### Documentation
1438
+
1439
+ * The repository readme has been rewritten to follow the standard npm readme format.
1440
+
1441
+ ## \[0.7.4] - 2023-07-31
1442
+
1443
+ ### Changes
1444
+
1445
+ * Allows handoff to load files from a `public` dir in the working root so that assets can be published to the app
1446
+
1447
+ ## \[0.7.3] - 2023-07-31
1448
+
1449
+ This release allows custom theme files in the working directory to override the main theme
1450
+
1451
+ ### Changes
1452
+
1453
+ * Added `eject:theme` which will eject the currently set theme into `theme/main.scss`
1454
+ * A new config `theme` has been added to allow toggling between themes. At present only a single default theme is provided
1455
+ * Improvements to cli help text
1456
+
1457
+ ### Cleanup
1458
+
1459
+ * Removes unneeded template files from the root dir
1460
+
1461
+ ## \[0.7.2] - 2023-07-31
1462
+
1463
+ This release improves existing functionalities and issue detected within the design system app.
1464
+
1465
+ ### Changes
1466
+
1467
+ * Component style maps placed in `integration/scss` are now read in at build time allowing developers to provide custom scss mappings for components.
1468
+ * If a folder `theme/main.scss` is found in the working root of the project, that file will be included at build time to allow styling the app.
1469
+ * Globbing is now supported in scss integrations allowing more flexible ingest of component variables
1470
+ * Added `make:page` command to CLI for creating custom pages or editing existing pages
1471
+ * Adds a flattening algorithm when color blending on properties that do not support blending like `color` and `border-color`
1472
+ * Purge the app build cache when restarting the app to prevent cache from holding old copies of customized files.
1473
+
1474
+ ### Bugfixes
1475
+
1476
+ * Fixes a bug with a missing `border-style` property when fetching from figma
1477
+ * Resolves issues where scss files in custom integration were not read.
1478
+
1479
+ ## \[0.7.1] - 2023-07-21
1480
+
1481
+ This release improves existing functionalities and issue detected within the design system app.
1482
+
1483
+ ### Changes
1484
+
1485
+ * Added button to download AWS Style Dictionary tokens for exportables and foundations being colors, effects and typography.
1486
+ * Introduced `DocumentationWithTokensProps` interface to reduce redundancy in the codebase.
1487
+ * Added `make:template` command to CLI for creating custom templates
1488
+
1489
+ ### Bugfixes
1490
+
1491
+ * Ensures design system app didn't check the project path for defined exportables.
1492
+ * Ensures that individual design system app pages read locally defined exportables
1493
+ * Corrects bug in capitalization of autogenerated exportable
1494
+ * Fixes a typing bug in the app that would throw a build error when running without dependencies
1495
+
1496
+ ## \[0.7.0] - 2023-07-14
1497
+
1498
+ This release introduces support for AWS Style Dictionaries - https://amzn.github.io/style-dictionary/#/. Style dictionary is a widely used token format that can be compiled down to a number of application formats using the AWS Style Dictionary CLI tool.
1499
+
1500
+ You will find the new style dictionary output in the exported artifact at `./exported/tokens/sd`.
1501
+
1502
+ ### Changes
1503
+
1504
+ * Added support for Style Dictionary export.
1505
+ * `ValueProperty` is now `Token` and it can now carry additional metadata (added `isSupportedCssProperty` metadata property).
1506
+ * All transformers now return data as the same `TransformerOutput` interface type. All other interfaces such as `CssTransformerOutput` and `ScssTransformerOutput` have been removed entirely.
1507
+ * Updated function and variable names to be more concise and provide more information about what they do.
1508
+ * Restructured the documentation app to use CSS variables in preparation for user theming. Following styles can be changed:
1509
+ * Global typography, header, side nav and anchor nav. Custom user theme examples coming in the next release.
1510
+ * General quality of life improvements.
1511
+
1512
+ ### Bugfix
1513
+
1514
+ * Updated readme to correct quickstart guide for CLI
1515
+ * Fixes a bug where the integration is ejected but not read, even when the integration is set to custom.
1516
+ * Remove defunct default icons from top of assets page
1517
+
1518
+ ## \[0.6.1] - 2023-06-28
1519
+
1520
+ ### Bugfixes
1521
+
1522
+ * Resolves an issue with level two paths in the app not rendering right
1523
+ * Resolves an issue if the project env is set to production but the app start mode is run
1524
+
1525
+ ## \[0.6.0] - 2023-06-28
1526
+
1527
+ 0.6.0 introduces two major new tools that will make it much easier to integrate Handoff with existing projects and data pipelines. This release also reorganizes the Handoff code to make the pipeline significantly more robust, easier to extend, and easier to use in existing projects. Our goal with this release is to establish a stable Typescript API as we approach a 1.0 release.
1528
+
1529
+ ### Features
1530
+
1531
+ #### Handoff CLI
1532
+
1533
+ Handoff now comes with a CLI toolchain that allows you to run Handoff commands in any context. This CLI replaces the installer from previous versions to scaffold up projects in a directory.
1534
+
1535
+ * Can be installed globally as a node binary `npm i -g handoff-app`
1536
+ * Run in any directory using `handoff-app <command>`
1537
+ * Will detect in the current working root and use that config if present
1538
+ * Has sane default configs that will work for normal projects
1539
+ * All configurations are sparse, so you can override a single config file and the rest of the config will inherit the defaults
1540
+ * Allows users to make config or eject the default config into the current working root
1541
+ * Can be run interactively to configure a project or non-interactively with `env` variables
1542
+ * Run `handoff-app --help` for a full list of commands
1543
+ * See https://github.com/Convertiv/handoff-app/blob/main/docs/cli.md for documentation
1544
+
1545
+ #### Handoff Typescript API
1546
+
1547
+ Handoff now exposes a full typescript API published as commonjs modules. This API will allow you to use Handoff in your Node 16+ javascript or typescript projects. With just a few lines of code you can have Handoff run programmatically.
1548
+
1549
+ This API supersedes and replaces the plugin architecture introduced in 0.5.0. The API call structure is maintained, but now the API can be used directly in existing Node applications and can be used with typescript.
1550
+
1551
+ Here's a simple example that will fetch the data down. This example expects a DEV\_ACCESS\_TOKEN and a FIGMA\_PROJECT\_ID env variable, or those to be provided in `process.env`. If not supplied, they will be prompted for when the pipeline is run.
1552
+
1553
+ ```js
1554
+ import Handoff from 'handoff-app';
1555
+ const handoff = new Handoff({
1556
+ title: 'Handoff Bootstrap',
1557
+ integration: {
1558
+ name: 'bootstrap',
1559
+ version: '5.3',
1560
+ },
1561
+ });
1562
+ await handoff.fetch();
1563
+ ```
1564
+
1565
+ * Fully typed API + full access to all the pipeline functions for transforming the tokens
1566
+ * Methods to support fetching tokens, building the documentation app, building the integration, and running the app locally for testing
1567
+ * A hook system allowing javascript functions to be passed as callbacks to be executed at points in the pipeline
1568
+
1569
+ ```js
1570
+ // This hook will execute after the integration step and allow you to extract
1571
+ // data from the pipeline and write it to a file
1572
+ handoff.postIntegration((documentationObject: DocumentationObject, data: HookReturn[]) => {
1573
+ const colors = documentationObject.design.color.map((color) => {
1574
+ return {
1575
+ name: color.name,
1576
+ value: color.value,
1577
+ };
1578
+ });
1579
+ data.push({
1580
+ filename: 'colors.json',
1581
+ data: JSON.stringify(colors, null, 2),
1582
+ });
1583
+ return data;
1584
+ });
1585
+ ```
1586
+
1587
+ * API matches the methods of the CLI so you can script in code what you can do with the CLI
1588
+ * See https://github.com/Convertiv/handoff-app/blob/main/docs/api.md for documentation
1589
+
1590
+ ### Improvements
1591
+
1592
+ * The handoff code base was refactored to eliminate the monorepo architecture and consolidate on a more coherent package architecture. This refactoring eliminated a number of weak points and improves reliability.
1593
+ * Sharing code between the data pipeline and the Nextjs documentation app is safer
1594
+ * The hook architecture introduced in 0.5 was fragile and less secure than we wanted. This reorganization makes a much more robust API, with full access to the typings
1595
+ * The previous structure merged configurations in a way that could fail easily. The new architecture reads and merges the various Handoff configurations in a much more robust manor.
1596
+ * Previously handoff required a folder architecture, with the proper files, and could fail if those files were moved. Now Handoff can be run in an empty directory, and can accommodate configs being added and removed during operation.
1597
+ * Upgrade Nextjs from 12 to 13 providing cleaner, faster application builds
1598
+ * Tailwind integration hook has been added to the pipeline
1599
+
1600
+ ### Bugfixes
1601
+
1602
+ * Fixes several style issues in the Bootstrap 5.3 release
1603
+ * Corrects a missing caret in Bootstrap 5.2 and 5.3 selects
1604
+
1605
+ ## \[0.5.3] - 2023-06-16
1606
+
1607
+ This release adds Bootstrap 5.3 support with dark mode disabled by default.
1608
+
1609
+ ### Changes
1610
+
1611
+ * Added Bootstrap 5.3 integration
1612
+ * Bootstrap 5.3 is now the default integration
1613
+ * Updated color preview in the Next.js app to work with color values such as linear-gradient(...) and rgba(...)
1614
+
1615
+ ### Bugfixes
1616
+
1617
+ * Resolved a value normalization error in the Next.js app when normalizing value with multiple color layers
1618
+
1619
+ ##### How to switch integrations
1620
+
1621
+ To use an integration change `client-config.js` to desired integration and version. For example:
1622
+
1623
+ ```
1624
+ integration: {
1625
+ name: 'bootstrap',
1626
+ version: '5.3',
1627
+ },
1628
+ ```
1629
+
1630
+ Currently supported integrations:
1631
+
1632
+ * Bootstrap 5.2
1633
+ * Bootstrap 5.3
1634
+
1635
+ ## \[0.5.2] - 2023-06-14
1636
+
1637
+ ### Changes
1638
+
1639
+ * Tokens, changelog and previews are now read form the file system using the `fs.readFileSync` instead of the `import` statement.
1640
+ * Updated the Next.js app pages to utilize `getStaticProps` for fetching of the configuration and the exported tokens.
1641
+ * Removed `componentExists` utility method as it's no longer used
1642
+ * Removed `mapComponentSize` utility method as it's no longer used
1643
+
1644
+ ### Bugfixes
1645
+
1646
+ * By changing the way in which the configuration, tokens, changelog and previews are read and passed into the pages a bug has been resolved that would occur while running the `fetch` command while the `dev` command was already running which would cause the app from stop responding correctly and would require app restart.
1647
+
1648
+ ## \[0.5.1] - 2023-06-01
1649
+
1650
+ ### Changes
1651
+
1652
+ * Minor release to increment the installer default version
1653
+ * Adding documentation to exportables folder
1654
+
1655
+ ## \[0.5.0] - 2023-06-01
1656
+
1657
+ 0.5.0 brings two major improvements
1658
+
1659
+ * Exportable schemas for Figma components
1660
+ * Allows Handoff to connect to any component set in Figma
1661
+ * Defines semantic meaning for components
1662
+ * Automatically generates well formed tokens based on object type
1663
+ * Javascript plugins for each integration
1664
+ * Hooks into the Figma extraction and transformation
1665
+ * Allows Handoff projects to customize the artifacts
1666
+ * Created to support Tailwind theme.js and Wordpress theme.json artifacts
1667
+
1668
+ Also in 0.5.0 is improved bootstrap 5.2 support, a simple tailwind color
1669
+ integration, and a cluster of bugfixes.
1670
+
1671
+ ### Major Features
1672
+
1673
+ #### Exportable schemas
1674
+
1675
+ Exportable schemas allows Handoff to connect to any component sets in Figma and
1676
+ generate tokens. In simple json, developers can define the structure of a Figma
1677
+ component and what tokens to extract from each element. This allows Handoff to
1678
+ adapt to the component set of any Figma file, and define semantic meaning for the
1679
+ Figma component. This will enable many features going forward, including -
1680
+
1681
+ * Figma Linting
1682
+ * Component Change Detection and Changelog
1683
+ * Automatic Figma Schema Detection
1684
+
1685
+ Exportables are stored in `./exportables`. In 0.5.0 we only support exportable
1686
+ components, so put component definitions in `./exportables/components`.
1687
+ An exportable consists of 3 components -
1688
+
1689
+ * Metadata - describe the component (id, group)
1690
+ * Options - control how the component is rendered in Handoff (tokens, preview)
1691
+ * Parts - define the semantic structure of the Figma component
1692
+
1693
+ ##### How to use exportables
1694
+
1695
+ Using exportables will allow quick tokenization of new components. For example,
1696
+ here is an annotated exportable for badges, a component not currently supported
1697
+ by handoff. https://www.handoff.com/docs/customization/exportables/#badgejson
1698
+ If you add this file to `exportables/components` and add `components/badge`
1699
+ to the `figma.definitions` in your config.js, Handoff will start looking for a
1700
+ Badges component set, and generate tokens, css, scss, and types for you.
1701
+
1702
+ With no other changes, handoff will create a set of badge token files for you.
1703
+ For example, it will render something like this for css variables -
1704
+ https://gist.github.com/<handle>/<id>. You can see
1705
+ that creates a comprehensive list of all the tokens you would need to render
1706
+ badges in a css frontend framework.
1707
+
1708
+ If you want badges to work in the Handoff component preview as well, you would
1709
+ need to add a badge template to `integration/templates/badge/default.html`.
1710
+ That file would look like this for Bootstrap 5.2 -
1711
+ https://www.handoff.com/docs/customization/exportables/#adding-a-template-to-preview-the-new-exportable.
1712
+
1713
+ You would also want to map these tokens to the framework. This is how you might
1714
+ do that in Bootstrap 5.2, adding this file to `integration/sass/extended/badge.scss`
1715
+ https://www.handoff.com/docs/customization/exportables/#mapping-the-new-exportable-to-scss
1716
+
1717
+ #### Integration Plugin
1718
+
1719
+ Handoff allows users to integrate with particular frontend frameworks. We call
1720
+ these integrations. We currently support bootstrap 5.2 out of the box.
1721
+
1722
+ 0.5.0 now allows these integrations to hook into the data extraction pipeline
1723
+ and modify the output, and optionally write files to the exported directory.
1724
+ This will allow developers to tailor the Figma data pipeline to their needs.
1725
+
1726
+ ##### How to use the Integration Plugin
1727
+
1728
+ To use this feature, create a `plugin.js` in the `integration` folder of your
1729
+ project. This plugin will have access to any of the core node.js libraries
1730
+ you need. Export a sandbox module like this -
1731
+
1732
+ ```
1733
+ sandbox.exports = {
1734
+ postCssTransformer: (documentationObject, css) => {
1735
+ // Modify the css variables prior to save
1736
+ return css;
1737
+ },
1738
+ }
1739
+ ```
1740
+
1741
+ In this example, the plugin has the full documentation object available,
1742
+ allowing it to query the object and then modify the css variables as needed.
1743
+
1744
+ Here's a simple plugin example that will read the tokens and write a simple
1745
+ json file with an array of colors in it. -
1746
+ https://www.handoff.com/docs/customization/plugins/#simple-example
1747
+
1748
+ Here is a comprehensive plugin.js showing all the options in 0.5.0 -
1749
+ https://www.handoff.com/docs/customization/plugins/#full-example
1750
+
1751
+ #### Bootstrap 5.2 Mapping Improvements
1752
+
1753
+ In 0.5.0 the Bootstrap 5.2 integration was rewritten to simplify and rationalize
1754
+ the way that tokens are being used. Since Bootstrap 5.2 is the first end to end
1755
+ Handoff integration, these improvements will form the template for other
1756
+ integrations.
1757
+
1758
+ #### Simple Tailwind 3.3 Integration
1759
+
1760
+ This release has a simple version of a Tailwind integration. It only supports
1761
+ colors and typography right now. Its in this release to start testing with
1762
+ simple tailwind projects.
1763
+
1764
+ To test it out, change the integration in the `config.js` to this -
1765
+
1766
+ ```
1767
+ integration: {
1768
+ name: 'tailwind',
1769
+ version: '3.3',
1770
+ },
1771
+ }
1772
+ ```
1773
+
1774
+ ### Bugfixes
1775
+
1776
+ * The new exportable schema has normalized the token output, fixing several small
1777
+ inconsistencies in the way tokens were created.
1778
+ * Fixes a warning caused by loading the config into the next app outside of the
1779
+ static properties
1780
+
1781
+ ## \[0.4.3] - 2023-04-19
1782
+
1783
+ Continuing incremental improvement over the 0.4.0 release. This release fixes
1784
+ a couple of small build inconsistencies, improves debug mode when running the
1785
+ build and fetch, and creates a fast run mode.
1786
+
1787
+ ### Improvements
1788
+
1789
+ * Errors in the webpack execution will now cause the fetch script to halt and
1790
+ bubble up into the error handling.
1791
+ * Running build/fetch with `-- --debug` will now send the error trace from the
1792
+ webpack when building a preview. This is especially useful when there is an error
1793
+ either in the template or scss maps.
1794
+ * Running build/fetch with `-- --fast` will execute the script but if there is
1795
+ already a built temp directory, it will use the built dir rather than recreating
1796
+ it. This speeds up runtime significantly. If this option is supplied but the
1797
+ temp dir does not yet exist, it will be created.
1798
+
1799
+ ### Bugfixes
1800
+
1801
+ * The transformer stand alone pipelines weren't working. This release fixes that
1802
+ so executing `npm run transform:preview` or
1803
+ `node node_modules/handoff-app/scripts/fetch.js preview` will properly execute
1804
+ just a single portion of the pipeline rather than the whole pipeline.
1805
+ * The default component guidelines were not rendering the `<ul>` wrapper for the
1806
+ subsequent lists.
1807
+ * The bootstrap 5.2 scss mapping had an error that caused the carrot and icon
1808
+ on error and disabled state select boxes to display incorrectly.
1809
+
1810
+ ## \[0.4.2] - 2023-04-16
1811
+
1812
+ When 0.4.0 was released, we found a structural problem with the way
1813
+ integrations were published into projects. 0.4.1 resolved a couple of issues,
1814
+ but a couple of significant new pieces of code were required to fully resolve
1815
+ the issue.
1816
+
1817
+ The resolution is fixing paths so that they work properly when running the
1818
+ handoff source as well as running handoff in a project.
1819
+
1820
+ ### Bugfixes
1821
+
1822
+ * Build and Start scripts were restructured to handle sparsely merging sass and
1823
+ templates into the source directory.
1824
+ * The integration transformer was restructured to support correct path
1825
+ * The webpack config has been altered to support paths in projects
1826
+ * The bootstrap templates were updated to use this updated path structure
1827
+
1828
+ ### Improvements
1829
+
1830
+ * The figma exporter built library built code is now published to the repo to
1831
+ make it easier to test pre release code
1832
+ * A default config is now part of the project so that projects that can inherit
1833
+ a config rather than having to keep their config up to date.
1834
+ * The installer now has the proper script paths in the package
1835
+
1836
+ ## \[0.4.1] - 2023-04-16
1837
+
1838
+ ### Bugfixes
1839
+
1840
+ * Fixes a typing error in the project config
1841
+ * Fixes an issue where the path of the integrations are relative to the project
1842
+ * Fixes an issue where local integrations aren't properly merged on watch
1843
+ * Updates the installed template to match the latest desired state
1844
+
1845
+ ## \[0.4.0] - 2023-04-16
1846
+
1847
+ This release introduces two major new features - framework integrations
1848
+ and much better color support. The color support is straightforward - Handoff
1849
+ now supports much broader color options from Figma including gradients (linear
1850
+ and radial), as well as layered colors, alpha channels and blend modes.
1851
+
1852
+ Framework integrations is Handoff's new plugin architecture for integrating
1853
+ tokens with popular web and application frameworks. Previous versions of Handoff
1854
+ were tightly coupled with Boostrap 5.2 as a proof of concept.
1855
+
1856
+ To integrate tokens into applications, the tokens need to be mapped to the
1857
+ the files you'll need. In web applications, this means mapping css and sass
1858
+ variables to existing variables, or extending classes with the tokens.
1859
+
1860
+ When fetch is run, any files added to the `integration` folder will be merged
1861
+ with the selected integration. The sass files will be published to
1862
+ `/exported/{integration}-tokens`
1863
+
1864
+ Integrations also move the templates into integrations so each framework
1865
+ integration can define the markup for each component, type, and state. This
1866
+ allows handoff to include default markup for common frontend frameworks.
1867
+
1868
+ ### Frontend Integration Support
1869
+
1870
+ * Creates integrations plugin architecture
1871
+ * Extracts Bootstrap 5.2 from the sass and templates into an integration template
1872
+ * Sets Bootstrap 5.2 as the default integration
1873
+ * Adds an integration configuration to allow projects to define which integration
1874
+ it will use
1875
+ * The `exported/variables` file was renamed to `exported/tokens`
1876
+ * A new directory is exported to `exported/{integration}-tokens` containing the
1877
+ maps and extended sass integration files.
1878
+ * The installer now creates a `/integration` folder that will be merged with
1879
+ the configured integration sass and templates.
1880
+ * A zip file called tokens.zip is exported to the public directory containing
1881
+ all of the exported artifacts - json, integration, sass, and css tokens
1882
+
1883
+ ### Configuration changes
1884
+
1885
+ * `integration` is an object that contains two properties `name` and
1886
+ `version`. If you set `integration.name` to `custom` and `version` to `null`
1887
+ the project will expect a fully defined integration in the `/integration` dir.
1888
+ * `figma` is an object that allows customization of how components are fetched.
1889
+ * `figma.components` contains a list of the components
1890
+ * Each component can be defined. For example `figma.components.button` will
1891
+ define how buttons are fetched from figma.
1892
+ * The `search` property determines the library component and name of the frame
1893
+ to look in for the component. Setting `figma.components.button.search` to
1894
+ `Unicorn` will try to find a button structure in a library object called
1895
+ `Unicorn`.
1896
+ * The `size` property of each component will define a size map allowing projects
1897
+ to map figma sizes to token names.
1898
+
1899
+ ### New Color Support
1900
+
1901
+ * **Gradient Color Support** Linear and Radial gradients are now imported from
1902
+ figma. The tokens JSON structure has changed to make it better support complex
1903
+ color objects.
1904
+ * `hex`, `type`, and `rgb` properties were dropped from the ColorObject
1905
+ * `value` contains the CSS set of color values, either as hex, rgb, rgba, or
1906
+ gradients
1907
+ * `blend` contains a set of blend modes as CSS values that map against the
1908
+ colors
1909
+ * **Blend Modes and Color Layers** Tokens are now exported for blend modes and
1910
+ color layers. Handoff can pull multiple layers out of the color styles, and
1911
+ will build the proper blend mode CSS for use in the project.
1912
+
1913
+ ### Upgrade Notes
1914
+
1915
+ * Create a folder `/integration` in the root of the project to hold integration
1916
+ configuration.
1917
+ * Any template customizations should be moved into the `/integration/templates`
1918
+ directory.
1919
+ * Any sass customizations to the existing project structure should be be moved
1920
+ to `/integration/sass` and modified to match the new structure.
1921
+
1922
+ ### Other Features
1923
+
1924
+ * Each component and foundation now has buttons for downloading the tokens for
1925
+ that component.
1926
+ * The dashboard now has a button for downloading all tokens as a zip file.
1927
+
1928
+ ### Security Update
1929
+
1930
+ * Webpack was updated to 5.79.0 to address a security issue
1931
+ * node-sass was removed from the figma-exporter library since it is no longer
1932
+ needed by the system.
1933
+
1934
+ ## \[0.3.1] - 2023-04-03
1935
+
1936
+ This release fixes two small bugs, one that throws an error on builds because
1937
+ of a missing type declaration in the config.
1938
+
1939
+ ### Bugfixes
1940
+
1941
+ * Builds against 0.3.0 are failing because of a missing type. Effects is missing
1942
+ from the return type of the DocumentObjects. This adds that type to fix.
1943
+ * RGBA Colors are listed on the foundations as percent instead of 255 values.
1944
+ This changes the display values, without changing the generated tokens.
1945
+
1946
+ ## \[0.3.0] - 2023-03-31
1947
+
1948
+ This release creates base foundation tokens in the /exported directory. This
1949
+ is a major step forward allowing projects to use color, typography and effects as
1950
+ named tokens in projects in addition to component tokens.
1951
+
1952
+ ### Changes
1953
+
1954
+ * Adds foundation token css and scss files so projects can reference colors,
1955
+ typography and effects.
1956
+ * Tokens are exported to the /exported folder
1957
+ * Foundation token files follow the form - {type of foundation}.scss contains
1958
+ the css vars and {type of foundation}\_vars.scss contains the scss variables
1959
+ * Color tokens are either hex for solid colors or rgba for alpha channel colors
1960
+ * Two color map arrays are provided $color-groups and $color-names
1961
+ * Color tokens are in the form $color-{group}-{name}: {hex/rgba};
1962
+ * Typography tokens support
1963
+ * font-family
1964
+ * font-size
1965
+ * font-weight
1966
+ * line-height
1967
+ * letter-spacing
1968
+ * paragraph-spacing
1969
+ * One Typography map is provided $type-sizes
1970
+ * Typography tokens are in the form $typography-{size}-{property}: {value}
1971
+ * Effects are are currently limited to drop and inner shadows
1972
+ * Effects include a map of effect names $effects
1973
+ * Effects are in the form $effect-{name}: {shadow definition}
1974
+
1975
+ ### Bugfixes
1976
+
1977
+ * Adds the proper sidebar menu icon for effects
1978
+
1979
+ ## \[0.2.1] - 2023-03-28
1980
+
1981
+ This release fixes a small typo in the installer. The version in the installed
1982
+ package version was set to ^0.1.0 rather than ^0.2.0. This release fixes that.
1983
+
1984
+ ### Changes
1985
+
1986
+ * Changes template for installer to match latest version
1987
+
1988
+ ## \[0.2.0] - 2023-03-23
1989
+
1990
+ ### Changes
1991
+
1992
+ * Significant improvements to the markdown pages.
1993
+ * Adds syntax highlighting for markdown pages and blocks.
1994
+ * Just wrap your code in single ticks or create blocks with three ticks.
1995
+ * Currently support highlighting for CSS/SCSS, HTML, Javascript/Typescript,
1996
+ Yaml and Bash. Use ` ```{type}` to define the syntax. For example ` ```js`.
1997
+ * Adds anchor links to markdown h{n} tags to allow deep linking to headers.
1998
+ * Adds line numbering to all code blocks.
1999
+ * Improves the installation experience with better help text.
2000
+ * Provides Node 16+ version checking on installation to make it clear.
2001
+
2002
+ ### Bug
2003
+
2004
+ * Improves handling of missing components in Figma. If its not found:
2005
+ * An alert is shown in the fetch output.
2006
+ * The component page is hidden in the menu and the components list.
2007
+ * A 404 page is shown if the missing component is accessed directly.
2008
+ * Fixes a grouping issue where opacity was in an undefined group on the buttons
2009
+ page.
2010
+ * Fixes a problem with blur radius and spread values on shadow tokens
2011
+
2012
+ ## \[0.1.5] - 2023-03-10
2013
+
2014
+ ### Bug
2015
+
2016
+ * Installer is missing a package json script
2017
+
2018
+ ### Changes
2019
+
2020
+ * Iconography link on Branded Assets page is incorrect & broken
2021
+ * Style Guide - has typo & still has a "TODO" mentioned in copy
2022
+
2023
+ ## \[0.1.4] - 2023-03-09
2024
+
2025
+ ### Bugfixes
2026
+
2027
+ * Fixes a build issue with types on NextJS build
2028
+ * Adds a npm script to run the installer for the figma exporter without dev deps
2029
+
2030
+ ## \[0.1.3] - 2023-03-09
2031
+
2032
+ ### Changes
2033
+
2034
+ * Improving changelog for previous changes
2035
+
2036
+ ### Bugfixes
2037
+
2038
+ * Fixes a bug where the installer was deploying with outdated css for custom
2039
+ previews
2040
+
2041
+ ## \[0.1.2] - 2023-03-09
2042
+
2043
+ ### Bugfixes
2044
+
2045
+ * Fixing installer package json version b2d58c5
2046
+
2047
+ ## \[0.1.1] - 2023-03-09
2048
+
2049
+ ### Bugfixes
2050
+
2051
+ * Fixes script naming for installed sites
2052
+
2053
+ ## \[0.1.0] - 2023-03-09
2054
+
2055
+ ### Changes
2056
+
2057
+ * Creates the initial public version of Handoff
2058
+ * High level initial feature list
2059
+ * Builds pipeline from Figma to generate tokens from well structured file
2060
+ * Exports design foundations (colors, typography, icons, logos)
2061
+ * Component design tokens (buttons, alerts, modal, tooltips, inputs, radios, checkboxes, radio, switches)
2062
+ * Transformers for sass variables, css variables, previews and custom fonts
2063
+ * Static web application that can be published to any web host
2064
+
2065
+ ```
2066
+ ```
2067
+
2068
+ ```
2069
+ ```