@pixel-point/toolcraft 0.0.14 → 0.0.15

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 (577) hide show
  1. package/README.md +13 -2
  2. package/package.json +1 -1
  3. package/scripts/prepare-pack.mjs +2 -28
  4. package/src/cli-io.mjs +174 -0
  5. package/src/cli-package-manager-flow.test.mjs +206 -0
  6. package/src/cli.mjs +7 -495
  7. package/src/cli.test.mjs +34 -177
  8. package/src/create-command.mjs +152 -0
  9. package/src/create-options.mjs +194 -0
  10. package/src/generate-test-assertions.mjs +27 -0
  11. package/src/generate-test-doc-assertions.mjs +162 -0
  12. package/src/generate-test-file-assertions.mjs +251 -0
  13. package/src/generate-test-fs-utils.mjs +59 -0
  14. package/src/generate-test-integrity-assertions.mjs +30 -0
  15. package/src/generate-test-integrity-framework-assertions.mjs +222 -0
  16. package/src/generate-test-integrity-manifest-assertions.mjs +150 -0
  17. package/src/generate-test-integrity-ownership-assertions.mjs +127 -0
  18. package/src/generate-test-integrity-test-utils.mjs +102 -0
  19. package/src/generate-test-package-assertions.mjs +75 -0
  20. package/src/generate-test-product-fixture.mjs +84 -0
  21. package/src/generate-test-product-fixture.test.mjs +73 -0
  22. package/src/generate-test-standalone-assertions.mjs +209 -0
  23. package/src/generate-transactional.test.mjs +151 -0
  24. package/src/generate.mjs +182 -102
  25. package/src/generate.test.mjs +242 -338
  26. package/src/generated-integrity-manifest.mjs +127 -0
  27. package/src/generated-integrity-manifest.test.mjs +151 -0
  28. package/src/generated-source-policy.mjs +22 -0
  29. package/src/generated-source-policy.test.mjs +35 -0
  30. package/src/generated-target-policy.mjs +55 -0
  31. package/src/generation-transaction.mjs +135 -0
  32. package/src/generation-transaction.test.mjs +74 -0
  33. package/src/package-json.mjs +18 -1
  34. package/src/package-json.test.mjs +38 -5
  35. package/src/package-manager.mjs +2 -0
  36. package/src/package-manager.test.mjs +5 -1
  37. package/src/packaged-template-fallback.test.mjs +126 -0
  38. package/src/prepare-pack-templates.mjs +34 -0
  39. package/templates/runtime/contracts/component-contract-builders.ts +95 -0
  40. package/templates/runtime/contracts/component-contracts.choices.test.ts +293 -0
  41. package/templates/runtime/contracts/component-contracts.choices.ts +322 -0
  42. package/templates/runtime/contracts/component-contracts.inputs.test.ts +210 -0
  43. package/templates/runtime/contracts/component-contracts.inputs.ts +252 -0
  44. package/templates/runtime/contracts/component-contracts.media-custom.test.ts +116 -0
  45. package/templates/runtime/contracts/component-contracts.media-custom.ts +144 -0
  46. package/templates/runtime/contracts/component-contracts.runtime-acceptance.test.ts +229 -0
  47. package/templates/runtime/contracts/component-contracts.runtime-labels.test.ts +76 -0
  48. package/templates/runtime/contracts/component-contracts.runtime-panels.test.ts +135 -0
  49. package/templates/runtime/contracts/component-contracts.runtime-shell.test.ts +148 -0
  50. package/templates/runtime/contracts/component-contracts.runtime.ts +361 -0
  51. package/templates/runtime/contracts/component-contracts.test.ts +39 -1458
  52. package/templates/runtime/contracts/component-contracts.ts +44 -1505
  53. package/templates/runtime/contracts/component-contracts.visual.test.ts +316 -0
  54. package/templates/runtime/contracts/component-contracts.visual.ts +385 -0
  55. package/templates/runtime/contracts/contract-manifest.test.ts +64 -0
  56. package/templates/runtime/contracts/decision-contracts.test.ts +29 -4
  57. package/templates/runtime/contracts/decision-contracts.ts +38 -1
  58. package/templates/runtime/index.ts +1 -0
  59. package/templates/runtime/react/{runtime-public-api.test.tsx → app-shell/runtime-public-api.test.tsx} +29 -7
  60. package/templates/runtime/react/{settings-transfer.test.ts → app-shell/settings-transfer.test.ts} +4 -4
  61. package/templates/runtime/react/{settings-transfer.ts → app-shell/settings-transfer.ts} +3 -3
  62. package/templates/runtime/react/{toolbar-panel.test.tsx → app-shell/toolbar-panel.test.tsx} +2 -2
  63. package/templates/runtime/react/{toolbar-panel.tsx → app-shell/toolbar-panel.tsx} +3 -3
  64. package/templates/runtime/react/{toolcraft-app.integration.test.tsx → app-shell/toolcraft-app.integration.test.tsx} +6 -6
  65. package/templates/runtime/react/{toolcraft-app.test.tsx → app-shell/toolcraft-app.test.tsx} +3 -3
  66. package/templates/runtime/react/{toolcraft-app.tsx → app-shell/toolcraft-app.tsx} +11 -8
  67. package/templates/runtime/react/{toolcraft-root.test.tsx → app-shell/toolcraft-root.test.tsx} +1 -1
  68. package/templates/runtime/react/{toolcraft-root.tsx → app-shell/toolcraft-root.tsx} +5 -5
  69. package/templates/runtime/react/{use-toolcraft.ts → app-shell/use-toolcraft.ts} +1 -1
  70. package/templates/runtime/react/canvas/canvas-default-media-layer.tsx +81 -0
  71. package/templates/runtime/react/canvas/canvas-media-transform.ts +33 -0
  72. package/templates/runtime/react/canvas/canvas-shell-interactions.test.tsx +156 -0
  73. package/templates/runtime/react/canvas/canvas-shell-media-rendering.test.tsx +87 -0
  74. package/templates/runtime/react/canvas/canvas-shell-rendering.test.tsx +102 -0
  75. package/templates/runtime/react/canvas/canvas-shell-test-utils.tsx +108 -0
  76. package/templates/runtime/react/canvas/canvas-shell-upload.test.tsx +106 -0
  77. package/templates/runtime/react/canvas/canvas-shell.tsx +146 -0
  78. package/templates/runtime/react/canvas/canvas-upload-routing.ts +84 -0
  79. package/templates/runtime/react/{media-file.ts → canvas/media-file.ts} +1 -1
  80. package/templates/runtime/react/canvas/use-canvas-drop-import.ts +145 -0
  81. package/templates/runtime/react/canvas/use-canvas-viewport-interactions.ts +227 -0
  82. package/templates/runtime/react/controls-panel/__tests__/control-conditions.test.ts +89 -0
  83. package/templates/runtime/react/{controls-panel-filedrop-reorder.test.tsx → controls-panel/__tests__/controls-panel-filedrop-reorder.test.tsx} +4 -4
  84. package/templates/runtime/react/controls-panel/__tests__/controls-panel.actions-layout.test.tsx +91 -0
  85. package/templates/runtime/react/controls-panel/__tests__/controls-panel.collection-actions.test.tsx +213 -0
  86. package/templates/runtime/react/controls-panel/__tests__/controls-panel.color-layout.test.tsx +366 -0
  87. package/templates/runtime/react/controls-panel/__tests__/controls-panel.color-picker-models.test.tsx +169 -0
  88. package/templates/runtime/react/controls-panel/__tests__/controls-panel.compound-layout.test.tsx +160 -0
  89. package/templates/runtime/react/controls-panel/__tests__/controls-panel.control-visibility.test.tsx +352 -0
  90. package/templates/runtime/react/controls-panel/__tests__/controls-panel.curves.test.tsx +226 -0
  91. package/templates/runtime/react/controls-panel/__tests__/controls-panel.floating-shell.test.tsx +13 -0
  92. package/templates/runtime/react/controls-panel/__tests__/controls-panel.font-picker.test.tsx +302 -0
  93. package/templates/runtime/react/controls-panel/__tests__/controls-panel.footer-actions.test.tsx +401 -0
  94. package/templates/runtime/react/controls-panel/__tests__/controls-panel.gradient-control.test.tsx +139 -0
  95. package/templates/runtime/react/controls-panel/__tests__/controls-panel.help-policy.test.tsx +103 -0
  96. package/templates/runtime/react/controls-panel/__tests__/controls-panel.image-picker.test.tsx +16 -0
  97. package/templates/runtime/react/controls-panel/__tests__/controls-panel.inline-layout.test.tsx +290 -0
  98. package/templates/runtime/react/controls-panel/__tests__/controls-panel.keyframes.test.tsx +175 -0
  99. package/templates/runtime/react/controls-panel/__tests__/controls-panel.media-upload-files.test.tsx +121 -0
  100. package/templates/runtime/react/controls-panel/__tests__/controls-panel.media-upload-image.test.tsx +363 -0
  101. package/templates/runtime/react/controls-panel/__tests__/controls-panel.media-upload-multi-image.test.tsx +105 -0
  102. package/templates/runtime/react/controls-panel/__tests__/controls-panel.range-slider-editing.test.tsx +149 -0
  103. package/templates/runtime/react/controls-panel/__tests__/controls-panel.section-shell.test.tsx +138 -0
  104. package/templates/runtime/react/controls-panel/__tests__/controls-panel.select-layout.test.tsx +148 -0
  105. package/templates/runtime/react/controls-panel/__tests__/controls-panel.setup-controls.test.tsx +189 -0
  106. package/templates/runtime/react/controls-panel/__tests__/controls-panel.slider-rendering.test.tsx +317 -0
  107. package/templates/runtime/react/controls-panel/__tests__/controls-panel.state-reset.test.tsx +137 -0
  108. package/templates/runtime/react/controls-panel/__tests__/controls-panel.structure.test.tsx +66 -0
  109. package/templates/runtime/react/controls-panel/__tests__/controls-panel.text-input.test.tsx +205 -0
  110. package/templates/runtime/react/controls-panel/__tests__/controls-panel.vector-interaction.test.tsx +388 -0
  111. package/templates/runtime/react/controls-panel/__tests__/controls-panel.vector-layout.test.tsx +155 -0
  112. package/templates/runtime/react/controls-panel/actions/controls-panel-actions.ts +172 -0
  113. package/templates/runtime/react/{control-conditions.ts → controls-panel/conditions/control-conditions.ts} +26 -3
  114. package/templates/runtime/react/{control-renderers.ts → controls-panel/control-renderers.ts} +2 -2
  115. package/templates/runtime/react/controls-panel/controls-panel.tsx +250 -0
  116. package/templates/runtime/react/controls-panel/keyframes/controls-panel-keyframes.tsx +265 -0
  117. package/templates/runtime/react/controls-panel/layout/controls-panel-collapse-storage.ts +131 -0
  118. package/templates/runtime/react/controls-panel/layout/controls-panel-help.tsx +132 -0
  119. package/templates/runtime/react/controls-panel/layout/controls-panel-inline-layout.tsx +311 -0
  120. package/templates/runtime/react/controls-panel/layout/controls-panel-layout.tsx +216 -0
  121. package/templates/runtime/react/controls-panel/layout/controls-panel-section.tsx +401 -0
  122. package/templates/runtime/react/controls-panel/renderers/controls-panel-action-renderer.tsx +137 -0
  123. package/templates/runtime/react/controls-panel/renderers/controls-panel-basic-renderers.tsx +421 -0
  124. package/templates/runtime/react/controls-panel/renderers/controls-panel-collection-renderer.tsx +286 -0
  125. package/templates/runtime/react/controls-panel/renderers/controls-panel-compound-renderers.tsx +366 -0
  126. package/templates/runtime/react/controls-panel/renderers/controls-panel-media-renderer.tsx +173 -0
  127. package/templates/runtime/react/controls-panel/renderers/controls-panel-renderer-registry.test.ts +23 -0
  128. package/templates/runtime/react/controls-panel/renderers/controls-panel-renderer-registry.ts +55 -0
  129. package/templates/runtime/react/controls-panel/renderers/controls-panel-settings-transfer-renderer.tsx +45 -0
  130. package/templates/runtime/react/controls-panel/testing/controls-panel-test-utils.tsx +300 -0
  131. package/templates/runtime/react/controls-panel/values/controls-panel-aspect-ratio-values.ts +94 -0
  132. package/templates/runtime/react/controls-panel/values/controls-panel-collection-values.ts +87 -0
  133. package/templates/runtime/react/controls-panel/values/controls-panel-color-values.ts +82 -0
  134. package/templates/runtime/react/controls-panel/values/controls-panel-font-values.ts +69 -0
  135. package/templates/runtime/react/controls-panel/values/controls-panel-spatial-values.ts +64 -0
  136. package/templates/runtime/react/controls-panel/values/controls-panel-value-labels.ts +93 -0
  137. package/templates/runtime/react/controls-panel/values/controls-panel-value-primitives.ts +30 -0
  138. package/templates/runtime/react/controls-panel/values/controls-panel-values.ts +7 -0
  139. package/templates/runtime/react/index.ts +13 -13
  140. package/templates/runtime/react/{layer-tree.ts → layers/layer-tree.ts} +1 -1
  141. package/templates/runtime/react/layers/layers-panel-drag-drop.test.tsx +190 -0
  142. package/templates/runtime/react/layers/layers-panel-editing.test.tsx +41 -0
  143. package/templates/runtime/react/layers/layers-panel-insert-targets.test.ts +87 -0
  144. package/templates/runtime/react/layers/layers-panel-insert-targets.ts +254 -0
  145. package/templates/runtime/react/layers/layers-panel-model.ts +15 -0
  146. package/templates/runtime/react/layers/layers-panel-rendering.test.tsx +43 -0
  147. package/templates/runtime/react/layers/layers-panel-reorder.ts +148 -0
  148. package/templates/runtime/react/layers/layers-panel-row.tsx +475 -0
  149. package/templates/runtime/react/layers/layers-panel-test-utils.tsx +135 -0
  150. package/templates/runtime/react/layers/layers-panel-visibility.test.tsx +126 -0
  151. package/templates/runtime/react/layers/layers-panel.tsx +349 -0
  152. package/templates/runtime/react/layers/use-layers-panel-drag-controller.ts +327 -0
  153. package/templates/runtime/react/{panel-host-types.ts → panel-host/panel-host-types.ts} +2 -2
  154. package/templates/runtime/react/{panel-host.test.tsx → panel-host/panel-host.test.tsx} +3 -3
  155. package/templates/runtime/react/{panel-host.tsx → panel-host/panel-host.tsx} +1 -1
  156. package/templates/runtime/react/timeline/timeline-easing-editor.tsx +409 -0
  157. package/templates/runtime/react/timeline/timeline-easing-geometry.ts +42 -0
  158. package/templates/runtime/react/timeline/timeline-easing-icons.tsx +135 -0
  159. package/templates/runtime/react/timeline/timeline-easing-model.test.ts +87 -0
  160. package/templates/runtime/react/timeline/timeline-easing-model.ts +271 -0
  161. package/templates/runtime/react/timeline/timeline-easing-popover-content.tsx +227 -0
  162. package/templates/runtime/react/timeline/timeline-easing-popover-layout.ts +69 -0
  163. package/templates/runtime/react/timeline/timeline-easing-popover.tsx +60 -0
  164. package/templates/runtime/react/timeline/timeline-event-targets.ts +19 -0
  165. package/templates/runtime/react/timeline/timeline-expanded-content.tsx +299 -0
  166. package/templates/runtime/react/timeline/timeline-icon-button.tsx +51 -0
  167. package/templates/runtime/react/timeline/timeline-keyframe-row.tsx +360 -0
  168. package/templates/runtime/react/timeline/timeline-keyframes.ts +23 -0
  169. package/templates/runtime/react/timeline/timeline-panel-floating-layout.test.tsx +328 -0
  170. package/templates/runtime/react/timeline/timeline-panel-header.tsx +404 -0
  171. package/templates/runtime/react/timeline/timeline-panel-keyframes.test.tsx +90 -0
  172. package/templates/runtime/react/timeline/timeline-panel-layout.ts +30 -0
  173. package/templates/runtime/react/timeline/timeline-panel-responsive-layout.ts +182 -0
  174. package/templates/runtime/react/timeline/timeline-panel-test-utils.tsx +88 -0
  175. package/templates/runtime/react/timeline/timeline-panel-transport.test.tsx +202 -0
  176. package/templates/runtime/react/timeline/timeline-panel-upload.test.tsx +53 -0
  177. package/templates/runtime/react/timeline/timeline-panel.tsx +449 -0
  178. package/templates/runtime/react/timeline/timeline-playback-hooks.ts +254 -0
  179. package/templates/runtime/schema/assembly-contract.ts +271 -0
  180. package/templates/runtime/schema/control-schema-normalization.ts +55 -0
  181. package/templates/runtime/schema/controls-panel-actions.ts +141 -0
  182. package/templates/runtime/schema/controls-panel-layout-groups.ts +144 -0
  183. package/templates/runtime/schema/controls-panel-normalization.ts +19 -0
  184. package/templates/runtime/schema/controls-panel-section-layout.ts +140 -0
  185. package/templates/runtime/schema/controls-panel-section-titles.ts +161 -0
  186. package/templates/runtime/schema/define-toolcraft-test-utils.ts +18 -0
  187. package/templates/runtime/schema/define-toolcraft.actions.test.ts +182 -0
  188. package/templates/runtime/schema/define-toolcraft.assembly.test.ts +246 -0
  189. package/templates/runtime/schema/define-toolcraft.canvas.test.ts +150 -0
  190. package/templates/runtime/schema/define-toolcraft.control-layout.test.ts +345 -0
  191. package/templates/runtime/schema/define-toolcraft.control-sections.test.ts +304 -0
  192. package/templates/runtime/schema/define-toolcraft.setup-canvas.test.ts +69 -0
  193. package/templates/runtime/schema/define-toolcraft.setup-persistence.test.ts +66 -0
  194. package/templates/runtime/schema/define-toolcraft.setup-render-scale-timeline.test.ts +116 -0
  195. package/templates/runtime/schema/define-toolcraft.setup-settings-transfer.test.ts +291 -0
  196. package/templates/runtime/schema/define-toolcraft.ts +24 -1449
  197. package/templates/runtime/schema/panels-schema-normalization.ts +49 -0
  198. package/templates/runtime/schema/runtime-section-titles.ts +1 -0
  199. package/templates/runtime/schema/runtime-setup-section.ts +282 -0
  200. package/templates/runtime/schema/schema-resolvers.ts +168 -0
  201. package/templates/runtime/schema/types.ts +17 -0
  202. package/templates/runtime/state/canvas-reducer.ts +106 -0
  203. package/templates/runtime/state/canvas-state.ts +209 -0
  204. package/templates/runtime/state/controls-reducer.ts +277 -0
  205. package/templates/runtime/state/history-patches.ts +174 -0
  206. package/templates/runtime/state/layer-state.ts +12 -0
  207. package/templates/runtime/state/layers-reducer.ts +318 -0
  208. package/templates/runtime/state/media-reducer.ts +283 -0
  209. package/templates/runtime/state/media-state.ts +105 -0
  210. package/templates/runtime/state/panels-reducer.ts +58 -0
  211. package/templates/runtime/state/persistence-merge.ts +53 -0
  212. package/templates/runtime/state/persistence-reader-canvas.ts +27 -0
  213. package/templates/runtime/state/persistence-reader-layers.ts +73 -0
  214. package/templates/runtime/state/persistence-reader-media.ts +82 -0
  215. package/templates/runtime/state/persistence-reader-panels.ts +56 -0
  216. package/templates/runtime/state/persistence-reader-primitives.ts +27 -0
  217. package/templates/runtime/state/persistence-reader-timeline.ts +145 -0
  218. package/templates/runtime/state/persistence-reader-values.ts +40 -0
  219. package/templates/runtime/state/persistence-readers.ts +72 -0
  220. package/templates/runtime/state/persistence-shared.ts +23 -0
  221. package/templates/runtime/state/persistence-snapshot.ts +57 -0
  222. package/templates/runtime/state/persistence.ts +16 -581
  223. package/templates/runtime/state/reducer-canvas-panels.test.ts +324 -0
  224. package/templates/runtime/state/reducer-controls.test.ts +158 -0
  225. package/templates/runtime/state/reducer-layers.test.ts +306 -0
  226. package/templates/runtime/state/reducer-media-import-sizing.test.ts +197 -0
  227. package/templates/runtime/state/reducer-media-reorder-history.test.ts +116 -0
  228. package/templates/runtime/state/reducer-media-reset.test.ts +249 -0
  229. package/templates/runtime/state/reducer-media-test-utils.ts +40 -0
  230. package/templates/runtime/state/reducer-media-transform.test.ts +52 -0
  231. package/templates/runtime/state/reducer-test-utils.ts +30 -0
  232. package/templates/runtime/state/reducer-timeline.test.ts +242 -0
  233. package/templates/runtime/state/reducer.ts +57 -1785
  234. package/templates/runtime/state/timeline-reducer.ts +412 -0
  235. package/templates/runtime/state/timeline-values.test.ts +45 -0
  236. package/templates/runtime/state/timeline-values.ts +45 -0
  237. package/templates/runtime/testing/performance-browser-policy.test.ts +81 -0
  238. package/templates/runtime/testing/performance-browser-policy.ts +102 -0
  239. package/templates/runtime/testing/performance-budget-validation.ts +84 -0
  240. package/templates/runtime/testing/performance-control-classification.test.ts +106 -0
  241. package/templates/runtime/testing/performance-control-classification.ts +101 -0
  242. package/templates/runtime/testing/performance-coverage-context.ts +44 -0
  243. package/templates/runtime/testing/performance-coverage-renderer-policy.ts +221 -0
  244. package/templates/runtime/testing/performance-coverage-scenario-policy.ts +147 -0
  245. package/templates/runtime/testing/performance-coverage-target-policy.ts +121 -0
  246. package/templates/runtime/testing/performance-coverage-validator.ts +34 -0
  247. package/templates/runtime/testing/performance-export-coverage.test.ts +234 -0
  248. package/templates/runtime/testing/performance-fixture-load-profile.test.ts +360 -0
  249. package/templates/runtime/testing/performance-fixture-media.test.ts +80 -0
  250. package/templates/runtime/testing/performance-fixture-stress.test.ts +314 -0
  251. package/templates/runtime/testing/performance-fixture-validation.ts +255 -0
  252. package/templates/runtime/testing/performance-fixture-values.ts +275 -0
  253. package/templates/runtime/testing/performance-fixture-workload.test.ts +140 -0
  254. package/templates/runtime/testing/performance-load-profile-validation.ts +467 -0
  255. package/templates/runtime/testing/performance-renderer-coverage.test.ts +325 -0
  256. package/templates/runtime/testing/performance-renderer-pipeline-coverage.test.ts +115 -0
  257. package/templates/runtime/testing/performance-renderer-pipeline-interactions.test.ts +201 -0
  258. package/templates/runtime/testing/performance-renderer-pipeline-passes.test.ts +247 -0
  259. package/templates/runtime/testing/performance-renderer-pipeline-validation.ts +360 -0
  260. package/templates/runtime/testing/performance-renderer-technique-validation.ts +329 -0
  261. package/templates/runtime/testing/performance-renderer-technique.test.ts +275 -0
  262. package/templates/runtime/testing/performance-renderer-validation.ts +2 -0
  263. package/templates/runtime/testing/performance-scenario-coverage.test.ts +303 -0
  264. package/templates/runtime/testing/performance-scenario-validation.ts +49 -0
  265. package/templates/runtime/testing/performance-schema-derived-workloads.test.ts +231 -0
  266. package/templates/runtime/testing/performance-schema-queries.ts +181 -0
  267. package/templates/runtime/testing/performance-test-fixtures/index.ts +4 -0
  268. package/templates/runtime/testing/performance-test-fixtures/renderer-pipelines.ts +322 -0
  269. package/templates/runtime/testing/performance-test-fixtures/scenarios.ts +172 -0
  270. package/templates/runtime/testing/performance-test-fixtures/schemas.ts +151 -0
  271. package/templates/runtime/testing/performance-test-fixtures/stress-fixtures.ts +133 -0
  272. package/templates/runtime/testing/performance-test-fixtures.ts +1 -0
  273. package/templates/runtime/testing/performance-types.ts +338 -0
  274. package/templates/runtime/testing/performance.ts +15 -2485
  275. package/templates/starter/AGENTS.md +41 -26
  276. package/templates/starter/LICENSE.md +18 -95
  277. package/templates/starter/NOTICE.md +3 -3
  278. package/templates/starter/docs/toolcraft/README.md +5 -5
  279. package/templates/starter/docs/toolcraft/acceptance-testing.md +36 -8
  280. package/templates/starter/docs/toolcraft/assembly-workflow.md +12 -15
  281. package/templates/starter/docs/toolcraft/component-rules.md +6 -2
  282. package/templates/starter/docs/toolcraft/core/layout.md +1 -0
  283. package/templates/starter/docs/toolcraft/core/performance.md +7 -4
  284. package/templates/starter/docs/toolcraft/core/runtime-boundary.md +11 -4
  285. package/templates/starter/docs/toolcraft/core/timeline-animation.md +1 -0
  286. package/templates/starter/docs/toolcraft/custom-controls.md +8 -1
  287. package/templates/starter/docs/toolcraft/decision-contract.md +26 -22
  288. package/templates/starter/docs/toolcraft/performance.md +42 -16
  289. package/templates/starter/docs/toolcraft/schema-reference.md +34 -23
  290. package/templates/starter/docs/toolcraft/workflow.md +25 -17
  291. package/templates/starter/e2e/app-browser-acceptance-evidence.spec.ts +111 -0
  292. package/templates/starter/e2e/app-browser-control-coverage.spec.ts +118 -0
  293. package/templates/starter/e2e/app-browser-performance-evidence.spec.ts +217 -0
  294. package/templates/starter/e2e/app-browser-performance-probe.spec.ts +322 -0
  295. package/templates/starter/e2e/app-browser-proof-session.spec.ts +196 -0
  296. package/templates/starter/e2e/app-browser-runtime-evidence.spec.ts +9 -0
  297. package/templates/starter/e2e/app-browser-runtime-provenance.spec.ts +240 -0
  298. package/templates/starter/e2e/app-browser-runtime-reporter.spec.ts +180 -0
  299. package/templates/starter/e2e/app-browser-runtime-requirements.spec.ts +310 -0
  300. package/templates/starter/e2e/app-browser-semantic-evidence.spec.ts +432 -0
  301. package/templates/starter/e2e/app-browser-shell.spec.ts +171 -0
  302. package/templates/starter/e2e/app-browser-timeline-layers-reference.spec.ts +70 -0
  303. package/templates/starter/e2e/app-performance.spec.ts +0 -491
  304. package/templates/starter/e2e/browser-acceptance-outcome-helpers.ts +97 -0
  305. package/templates/starter/e2e/browser-acceptance-transition-helpers.ts +74 -0
  306. package/templates/starter/e2e/browser-conditional-output-evidence-helpers.ts +230 -0
  307. package/templates/starter/e2e/browser-control-target-helpers.ts +109 -0
  308. package/templates/starter/e2e/browser-layer-evidence-helpers.ts +229 -0
  309. package/templates/starter/e2e/browser-proof-session.ts +392 -0
  310. package/templates/starter/e2e/browser-runtime-evidence-reporter.ts +136 -0
  311. package/templates/starter/e2e/browser-runtime-evidence-requirements.ts +290 -0
  312. package/templates/starter/e2e/browser-runtime-evidence.ts +27 -0
  313. package/templates/starter/e2e/browser-state-evidence-helpers.ts +205 -0
  314. package/templates/starter/e2e/browser-timeline-evidence-helpers.ts +319 -0
  315. package/templates/starter/e2e/canvas-handle-helpers.ts +86 -4
  316. package/templates/starter/e2e/export-artifact-helpers.ts +132 -0
  317. package/templates/starter/e2e/performance-budget-helpers.ts +159 -0
  318. package/templates/starter/e2e/performance-canvas-helpers.ts +123 -0
  319. package/templates/starter/e2e/performance-control-helpers.ts +3 -0
  320. package/templates/starter/e2e/performance-control-layout-helpers.ts +161 -0
  321. package/templates/starter/e2e/performance-fixture-helpers.ts +217 -0
  322. package/templates/starter/e2e/performance-frame-probe.ts +247 -0
  323. package/templates/starter/e2e/performance-helpers.ts +6 -854
  324. package/templates/starter/e2e/performance-interaction-measurement.ts +251 -0
  325. package/templates/starter/e2e/performance-measurement-evidence.ts +72 -0
  326. package/templates/starter/e2e/performance-output-action-helpers.spec.ts +43 -0
  327. package/templates/starter/e2e/performance-output-action-helpers.ts +109 -0
  328. package/templates/starter/e2e/performance-probe-helpers.ts +12 -0
  329. package/templates/starter/e2e/performance-render-scale-helpers.ts +55 -0
  330. package/templates/starter/e2e/performance-slider-helpers.ts +271 -0
  331. package/templates/starter/e2e/product-observable-helpers.ts +72 -17
  332. package/templates/starter/e2e/stable-outcome-helpers.ts +208 -0
  333. package/templates/starter/package.json +10 -5
  334. package/templates/starter/playwright.config.ts +5 -2
  335. package/templates/starter/scripts/check-ai-skills.mjs +14 -8
  336. package/templates/starter/scripts/check-ai-skills.test.mjs +64 -0
  337. package/templates/starter/scripts/check-toolcraft-code-health.mjs +108 -0
  338. package/templates/starter/scripts/check-toolcraft-code-health.test.mjs +213 -0
  339. package/templates/starter/scripts/check-toolcraft-docs.mjs +47 -34
  340. package/templates/starter/scripts/check-toolcraft-integrity.mjs +141 -144
  341. package/templates/starter/scripts/run-browser-performance.mjs +118 -0
  342. package/templates/starter/scripts/run-browser-performance.test.mjs +53 -0
  343. package/templates/starter/scripts/toolcraft-code-health-core.mjs +297 -0
  344. package/templates/starter/scripts/toolcraft-contract-doc-integrity.mjs +77 -0
  345. package/templates/starter/scripts/toolcraft-contract-doc-integrity.test.mjs +81 -0
  346. package/templates/starter/scripts/toolcraft-contract-manifest.json +113 -0
  347. package/templates/starter/scripts/toolcraft-contract-manifest.mjs +128 -0
  348. package/templates/starter/scripts/toolcraft-contract-manifest.test.mjs +72 -0
  349. package/templates/starter/scripts/toolcraft-integrity-manifest.mjs +172 -0
  350. package/templates/starter/scripts/toolcraft-integrity-policy.mjs +60 -0
  351. package/templates/starter/scripts/toolcraft-product-boundary-ast-utils.mjs +23 -0
  352. package/templates/starter/scripts/toolcraft-product-boundary-ast.mjs +264 -0
  353. package/templates/starter/scripts/toolcraft-product-boundary-test-fixtures.mjs +16 -0
  354. package/templates/starter/scripts/toolcraft-product-boundary.mjs +243 -0
  355. package/templates/starter/scripts/toolcraft-product-boundary.test.mjs +289 -0
  356. package/templates/starter/scripts/toolcraft-product-dependency-graph.mjs +176 -0
  357. package/templates/starter/scripts/toolcraft-product-dependency-graph.test.mjs +196 -0
  358. package/templates/starter/scripts/toolcraft-product-dependency-resolution.mjs +279 -0
  359. package/templates/starter/scripts/toolcraft-product-evidence-boundary-ast.mjs +91 -0
  360. package/templates/starter/scripts/toolcraft-product-evidence-boundary.test.mjs +138 -0
  361. package/templates/starter/scripts/toolcraft-product-style-boundary.mjs +219 -0
  362. package/templates/starter/scripts/toolcraft-source-inventory.d.mts +46 -0
  363. package/templates/starter/scripts/toolcraft-source-inventory.mjs +187 -0
  364. package/templates/starter/scripts/toolcraft-source-inventory.test.mjs +132 -0
  365. package/templates/starter/scripts/toolcraft-source-ownership.mjs +167 -0
  366. package/templates/starter/scripts/toolcraft-source-ownership.test.mjs +113 -0
  367. package/templates/starter/scripts/toolcraft-static-string.mjs +104 -0
  368. package/templates/starter/scripts/toolcraft-verification-inventory.mjs +123 -0
  369. package/templates/starter/scripts/toolcraft-verification-receipt.d.mts +19 -0
  370. package/templates/starter/scripts/toolcraft-verification-receipt.mjs +284 -0
  371. package/templates/starter/scripts/toolcraft-verification-receipt.test.mjs +282 -0
  372. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.d.mts +32 -0
  373. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.mjs +88 -0
  374. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.test.mjs +87 -0
  375. package/templates/starter/scripts/toolcraft-vitest-runtime-evidence-reporter.mjs +109 -0
  376. package/templates/starter/scripts/toolcraft-vitest-runtime-evidence-reporter.test.mjs +111 -0
  377. package/templates/starter/scripts/toolcraft-workflow-routes.mjs +314 -0
  378. package/templates/starter/scripts/toolcraft-workflow-routes.test.mjs +204 -0
  379. package/templates/starter/src/app/acceptance/actions.ts +30 -0
  380. package/templates/starter/src/app/acceptance/animation-intent.ts +184 -0
  381. package/templates/starter/src/app/acceptance/canvas-handle-acceptance.ts +70 -0
  382. package/templates/starter/src/app/acceptance/color-bank-labels.ts +164 -0
  383. package/templates/starter/src/app/acceptance/conditions.ts +80 -0
  384. package/templates/starter/src/app/acceptance/control-acceptance-context.ts +70 -0
  385. package/templates/starter/src/app/acceptance/control-acceptance-coverage.ts +271 -0
  386. package/templates/starter/src/app/acceptance/control-acceptance-kind-rules.ts +149 -0
  387. package/templates/starter/src/app/acceptance/control-acceptance-policy.ts +189 -0
  388. package/templates/starter/src/app/acceptance/control-acceptance.ts +70 -0
  389. package/templates/starter/src/app/acceptance/control-component-rules.ts +277 -0
  390. package/templates/starter/src/app/acceptance/control-labels.ts +223 -0
  391. package/templates/starter/src/app/acceptance/control-layout-dependency-rules.ts +107 -0
  392. package/templates/starter/src/app/acceptance/control-layout-entity-rules.ts +104 -0
  393. package/templates/starter/src/app/acceptance/control-layout-model.ts +159 -0
  394. package/templates/starter/src/app/acceptance/control-layout-section-rules.ts +164 -0
  395. package/templates/starter/src/app/acceptance/control-layout.ts +45 -0
  396. package/templates/starter/src/app/acceptance/control-order.ts +123 -0
  397. package/templates/starter/src/app/acceptance/control-parts.ts +47 -0
  398. package/templates/starter/src/app/acceptance/control-section-inventory.ts +183 -0
  399. package/templates/starter/src/app/acceptance/controls.ts +27 -0
  400. package/templates/starter/src/app/acceptance/coverage.ts +81 -0
  401. package/templates/starter/src/app/acceptance/custom-controls.ts +140 -0
  402. package/templates/starter/src/app/acceptance/inline-layout.ts +192 -0
  403. package/templates/starter/src/app/acceptance/media-upload.ts +55 -0
  404. package/templates/starter/src/app/acceptance/output-background-rules.ts +135 -0
  405. package/templates/starter/src/app/acceptance/output-export-actions.test.ts +76 -0
  406. package/templates/starter/src/app/acceptance/output-export-actions.ts +34 -0
  407. package/templates/starter/src/app/acceptance/output-export-layout-rules.ts +46 -0
  408. package/templates/starter/src/app/acceptance/output-export-model.ts +146 -0
  409. package/templates/starter/src/app/acceptance/output-export.ts +45 -0
  410. package/templates/starter/src/app/acceptance/output-image-export-rules.ts +87 -0
  411. package/templates/starter/src/app/acceptance/reference-runtime-coverage.ts +96 -0
  412. package/templates/starter/src/app/acceptance/reference-runtime-feature-inventory.ts +171 -0
  413. package/templates/starter/src/app/acceptance/reference-runtime-study.ts +73 -0
  414. package/templates/starter/src/app/acceptance/reference-runtime-timeline.ts +291 -0
  415. package/templates/starter/src/app/acceptance/reference-runtime.ts +99 -0
  416. package/templates/starter/src/app/acceptance/runtime-coverage.ts +290 -0
  417. package/templates/starter/src/app/acceptance/runtime-setup.ts +117 -0
  418. package/templates/starter/src/app/acceptance/section-title-rules.ts +8 -0
  419. package/templates/starter/src/app/acceptance/sections.ts +6 -0
  420. package/templates/starter/src/app/acceptance/semantic.ts +63 -0
  421. package/templates/starter/src/app/acceptance/timeline-loop.ts +21 -0
  422. package/templates/starter/src/app/acceptance/types.ts +363 -0
  423. package/templates/starter/src/app/acceptance/validate-coverage.ts +217 -0
  424. package/templates/starter/src/app/acceptance/validation-pipeline.test.ts +56 -0
  425. package/templates/starter/src/app/acceptance/validation-pipeline.ts +60 -0
  426. package/templates/starter/src/app/acceptance/video-reference-study.ts +217 -0
  427. package/templates/starter/src/app/starter-acceptance-data.ts +21 -0
  428. package/templates/starter/src/app/starter-acceptance.animation-intent.test.ts +383 -0
  429. package/templates/starter/src/app/starter-acceptance.background-export.test.ts +349 -0
  430. package/templates/starter/src/app/starter-acceptance.base-coverage.test.ts +47 -0
  431. package/templates/starter/src/app/starter-acceptance.canvas-handles.test.ts +71 -0
  432. package/templates/starter/src/app/starter-acceptance.canvas-sizing.test.ts +199 -0
  433. package/templates/starter/src/app/starter-acceptance.compound-part-coverage.test.ts +244 -0
  434. package/templates/starter/src/app/starter-acceptance.contract-fixtures.ts +63 -0
  435. package/templates/starter/src/app/starter-acceptance.control-label-context.test.ts +172 -0
  436. package/templates/starter/src/app/starter-acceptance.control-labels.test.ts +387 -0
  437. package/templates/starter/src/app/starter-acceptance.control-naming-rules.test.ts +215 -0
  438. package/templates/starter/src/app/starter-acceptance.control-order.test.ts +274 -0
  439. package/templates/starter/src/app/starter-acceptance.control-state.test.ts +275 -0
  440. package/templates/starter/src/app/starter-acceptance.curves-rules.test.ts +184 -0
  441. package/templates/starter/src/app/starter-acceptance.custom-control-collections.test.ts +200 -0
  442. package/templates/starter/src/app/starter-acceptance.custom-control-coverage.test.ts +111 -0
  443. package/templates/starter/src/app/starter-acceptance.custom-control-fit-check.test.ts +135 -0
  444. package/templates/starter/src/app/starter-acceptance.custom-control-valid.test.ts +74 -0
  445. package/templates/starter/src/app/starter-acceptance.export-test-utils.ts +107 -0
  446. package/templates/starter/src/app/starter-acceptance.framework-boundary.test.ts +327 -0
  447. package/templates/starter/src/app/starter-acceptance.image-video-export-settings.test.ts +328 -0
  448. package/templates/starter/src/app/starter-acceptance.keyframes.test.ts +242 -0
  449. package/templates/starter/src/app/starter-acceptance.layers.test.ts +203 -0
  450. package/templates/starter/src/app/starter-acceptance.media-upload.fixtures.ts +110 -0
  451. package/templates/starter/src/app/starter-acceptance.media-upload.test.ts +153 -0
  452. package/templates/starter/src/app/starter-acceptance.output-export-rules.test.ts +97 -0
  453. package/templates/starter/src/app/starter-acceptance.persistence-coverage.test.ts +134 -0
  454. package/templates/starter/src/app/starter-acceptance.product-output-export.test.ts +202 -0
  455. package/templates/starter/src/app/starter-acceptance.product-readiness-rules.test.ts +14 -0
  456. package/templates/starter/src/app/starter-acceptance.product-readiness-test-utils.ts +25 -0
  457. package/templates/starter/src/app/starter-acceptance.product-readiness.test.ts +50 -0
  458. package/templates/starter/src/app/starter-acceptance.product-worklog.test.ts +27 -0
  459. package/templates/starter/src/app/starter-acceptance.range-slider-rules.test.ts +147 -0
  460. package/templates/starter/src/app/starter-acceptance.reference-custom-timeline.test.ts +197 -0
  461. package/templates/starter/src/app/starter-acceptance.reference-foundation.test.ts +304 -0
  462. package/templates/starter/src/app/starter-acceptance.reference-test-utils.ts +102 -0
  463. package/templates/starter/src/app/starter-acceptance.reference-timeline.test.ts +267 -0
  464. package/templates/starter/src/app/starter-acceptance.schema-test-utils.ts +116 -0
  465. package/templates/starter/src/app/starter-acceptance.section-cohesion.test.ts +373 -0
  466. package/templates/starter/src/app/starter-acceptance.section-dependencies.test.ts +260 -0
  467. package/templates/starter/src/app/starter-acceptance.section-titles.test.ts +180 -0
  468. package/templates/starter/src/app/starter-acceptance.setup-readiness.test.ts +205 -0
  469. package/templates/starter/src/app/starter-acceptance.slider-rules.test.ts +470 -0
  470. package/templates/starter/src/app/starter-acceptance.slider-unit-rules.test.ts +61 -0
  471. package/templates/starter/src/app/starter-acceptance.source-test-utils.ts +43 -0
  472. package/templates/starter/src/app/starter-acceptance.test-utils.ts +21 -0
  473. package/templates/starter/src/app/starter-acceptance.text-control-kind.test.ts +89 -0
  474. package/templates/starter/src/app/starter-acceptance.timeline-playback.test.ts +264 -0
  475. package/templates/starter/src/app/starter-acceptance.timeline-test-utils.ts +56 -0
  476. package/templates/starter/src/app/starter-acceptance.toggle-pair-layout.test.ts +200 -0
  477. package/templates/starter/src/app/starter-acceptance.toggle-parameter-layout.test.ts +277 -0
  478. package/templates/starter/src/app/starter-acceptance.ts +151 -4576
  479. package/templates/starter/src/app/starter-acceptance.video-export-test-utils.ts +37 -0
  480. package/templates/starter/src/app/starter-acceptance.video-reference-study.test.ts +262 -0
  481. package/templates/starter/src/app/starter-acceptance.worklog-test-utils.ts +428 -0
  482. package/templates/starter/src/app/starter-acceptance.worklog.test.ts +283 -0
  483. package/templates/starter/src/app/starter-automated-runtime-evidence.test.ts +34 -0
  484. package/templates/starter/src/app/starter-composition.tsx +7 -0
  485. package/templates/starter/src/app/starter-performance-test-utils.ts +275 -0
  486. package/templates/starter/src/app/starter-performance.budgets.test.ts +374 -0
  487. package/templates/starter/src/app/starter-performance.gates.test.ts +128 -0
  488. package/templates/starter/src/app/starter-performance.renderer-source.test.ts +136 -0
  489. package/templates/starter/src/app/starter-performance.renderer-technique.test.ts +291 -0
  490. package/templates/starter/src/app/starter-performance.scenarios.test.ts +355 -0
  491. package/templates/starter/src/app/test-evidence/browser-runtime-contract.test.ts +253 -0
  492. package/templates/starter/src/app/test-evidence/browser-runtime-contract.ts +243 -0
  493. package/templates/starter/src/routes/index.tsx +11 -2
  494. package/templates/starter/vite.config.ts +8 -0
  495. package/templates/ui/components/controls/color/color-control-types.ts +38 -0
  496. package/templates/ui/components/controls/color/color-control.tsx +19 -437
  497. package/templates/ui/components/controls/color/color-footer.tsx +272 -0
  498. package/templates/ui/components/controls/color/color-model-slider.tsx +271 -0
  499. package/templates/ui/components/controls/color/color-opacity-input.tsx +94 -0
  500. package/templates/ui/components/controls/color/color-surface.tsx +194 -0
  501. package/templates/ui/components/controls/color/color-value-control.tsx +159 -0
  502. package/templates/ui/components/controls/color/color-value-utils.ts +170 -0
  503. package/templates/ui/components/controls/color/index.ts +10 -3
  504. package/templates/ui/components/controls/color/palette-control-controller.ts +407 -0
  505. package/templates/ui/components/controls/color/palette-control-layout.ts +14 -0
  506. package/templates/ui/components/controls/color/palette-control-types.ts +50 -0
  507. package/templates/ui/components/controls/color/palette-control-view.tsx +174 -0
  508. package/templates/ui/components/controls/color/palette-control.tsx +6 -544
  509. package/templates/ui/components/controls/color/style-guide-color-picker-color-utils.ts +39 -0
  510. package/templates/ui/components/controls/color/style-guide-color-picker-controller.ts +370 -0
  511. package/templates/ui/components/controls/color/style-guide-color-picker-hue-handlers.ts +66 -0
  512. package/templates/ui/components/controls/color/style-guide-color-picker-interaction-state.ts +49 -0
  513. package/templates/ui/components/controls/color/style-guide-color-picker-interactions.ts +2 -2
  514. package/templates/ui/components/controls/color/style-guide-color-picker-model.ts +125 -0
  515. package/templates/ui/components/controls/color/style-guide-color-picker-parts.tsx +10 -707
  516. package/templates/ui/components/controls/color/style-guide-color-picker-surface-drag.ts +93 -0
  517. package/templates/ui/components/controls/color/style-guide-color-picker-surface-geometry.ts +114 -0
  518. package/templates/ui/components/controls/color/style-guide-color-picker-surface-preview.ts +45 -0
  519. package/templates/ui/components/controls/color/style-guide-color-picker-types.ts +84 -0
  520. package/templates/ui/components/controls/color/style-guide-color-picker-view.tsx +69 -0
  521. package/templates/ui/components/controls/color/style-guide-color-picker.tsx +6 -495
  522. package/templates/ui/components/controls/curves/curves-control.tsx +4 -3
  523. package/templates/ui/components/controls/file-drop/file-drop-control.tsx +39 -515
  524. package/templates/ui/components/controls/file-drop/file-drop-empty-state.tsx +35 -0
  525. package/templates/ui/components/controls/file-drop/file-drop-file-list.tsx +160 -0
  526. package/templates/ui/components/controls/file-drop/file-drop-image-grid.tsx +175 -0
  527. package/templates/ui/components/controls/file-drop/file-drop-model.tsx +170 -0
  528. package/templates/ui/components/controls/file-drop/file-drop-single-preview.tsx +63 -0
  529. package/templates/ui/components/controls/file-drop/file-drop-types.ts +48 -0
  530. package/templates/ui/components/controls/file-drop/index.ts +2 -2
  531. package/templates/ui/components/controls/font-picker/font-picker-control.tsx +133 -906
  532. package/templates/ui/components/controls/font-picker/font-picker-footer.tsx +116 -0
  533. package/templates/ui/components/controls/font-picker/font-picker-list.tsx +194 -0
  534. package/templates/ui/components/controls/font-picker/font-picker-popover-content.tsx +191 -0
  535. package/templates/ui/components/controls/font-picker/font-picker-value.ts +222 -0
  536. package/templates/ui/components/controls/font-picker/index.ts +4 -1
  537. package/templates/ui/components/controls/font-picker/use-font-picker-preview-pipeline.ts +163 -0
  538. package/templates/ui/components/controls/font-picker/use-font-picker-virtual-list.ts +293 -0
  539. package/templates/ui/components/controls/gradient/gradient-control-utils.ts +2 -25
  540. package/templates/ui/components/controls/gradient/gradient-control.tsx +4 -464
  541. package/templates/ui/components/controls/gradient/gradient-stops-controller.ts +332 -0
  542. package/templates/ui/components/controls/gradient/gradient-stops-track.tsx +159 -0
  543. package/templates/ui/components/controls/vector/vector-control-types.ts +26 -0
  544. package/templates/ui/components/controls/vector/vector-control.tsx +10 -486
  545. package/templates/ui/components/controls/vector/vector-pad-field.tsx +211 -0
  546. package/templates/ui/components/controls/vector/vector-pad-geometry.ts +61 -0
  547. package/templates/ui/components/controls/vector/vector-pad-parts.tsx +72 -0
  548. package/templates/ui/components/controls/vector/vector-pad-variants.ts +20 -0
  549. package/templates/ui/components/controls/vector/vector-size-field.tsx +104 -0
  550. package/templates/ui/components/controls/vector/vector-value.ts +46 -0
  551. package/templates/ui/components/primitives/slider/slider-discrete-state.ts +181 -0
  552. package/templates/ui/components/primitives/slider/slider-marker-policy.ts +52 -0
  553. package/templates/ui/components/primitives/slider/slider-pointer-dragging.ts +87 -0
  554. package/templates/ui/components/primitives/slider/slider-runtime.ts +109 -0
  555. package/templates/ui/components/primitives/slider/slider-types.ts +21 -0
  556. package/templates/ui/components/primitives/slider/slider.tsx +2 -403
  557. package/templates/runtime/react/canvas-shell.test.tsx +0 -554
  558. package/templates/runtime/react/canvas-shell.tsx +0 -585
  559. package/templates/runtime/react/controls-panel.test.tsx +0 -5446
  560. package/templates/runtime/react/controls-panel.tsx +0 -3220
  561. package/templates/runtime/react/layers-panel.test.tsx +0 -487
  562. package/templates/runtime/react/layers-panel.tsx +0 -1348
  563. package/templates/runtime/react/timeline-panel.test.tsx +0 -751
  564. package/templates/runtime/react/timeline-panel.tsx +0 -3078
  565. package/templates/runtime/schema/define-toolcraft.test.ts +0 -1742
  566. package/templates/runtime/state/reducer.test.ts +0 -1703
  567. package/templates/runtime/testing/performance.test.ts +0 -3081
  568. package/templates/starter/e2e/app-browser-acceptance.spec.ts +0 -785
  569. package/templates/starter/src/app/starter-acceptance.test.ts +0 -10068
  570. package/templates/starter/src/app/starter-performance.test.ts +0 -1583
  571. package/templates/ui/components/controls/color/style-guide-color-picker-logic.ts +0 -490
  572. /package/templates/runtime/react/{storage-key-migration.ts → app-shell/storage-key-migration.ts} +0 -0
  573. /package/templates/runtime/react/{theme-runtime.tsx → app-shell/theme-runtime.tsx} +0 -0
  574. /package/templates/runtime/react/{curve-geometry.test.ts → controls-panel/__tests__/curve-geometry.test.ts} +0 -0
  575. /package/templates/runtime/react/{panel-host-config.ts → panel-host/panel-host-config.ts} +0 -0
  576. /package/templates/runtime/react/{panel-host-geometry.test.ts → panel-host/panel-host-geometry.test.ts} +0 -0
  577. /package/templates/runtime/react/{panel-host-geometry.ts → panel-host/panel-host-geometry.ts} +0 -0
@@ -0,0 +1,211 @@
1
+ "use client";
2
+
3
+ import * as React from "react";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+ import { ControlFieldLabel } from "../../control-layout";
7
+ import { EditableSliderValueLabel, Field } from "../../primitives";
8
+ import {
9
+ createControlHistoryGroupId,
10
+ type ControlChangeMeta,
11
+ } from "../control-types";
12
+ import type {
13
+ VectorControlProps,
14
+ VectorControlValue,
15
+ } from "./vector-control-types";
16
+ import {
17
+ getDefaultPadCoordinateMode,
18
+ getVectorPoint,
19
+ pointFromEvent,
20
+ } from "./vector-pad-geometry";
21
+ import { VectorPadGuides, VectorPadHandle } from "./vector-pad-parts";
22
+ import { vectorPadBackgroundImages } from "./vector-pad-variants";
23
+ import {
24
+ formatVectorPadCoordinate,
25
+ getVectorValueLabel,
26
+ parseVectorValueDraft,
27
+ } from "./vector-value";
28
+
29
+ type VectorPadAxisLock = "x" | "y";
30
+
31
+ type VectorPadDragStart = {
32
+ clientX: number;
33
+ clientY: number;
34
+ value: VectorControlValue;
35
+ };
36
+
37
+ const vectorPadAxisLockThresholdPx = 2;
38
+
39
+ export function VectorPadField({
40
+ defaultValue,
41
+ name,
42
+ onValueChange,
43
+ padCoordinateMode,
44
+ padShape = "compact",
45
+ padVariant = "default",
46
+ x,
47
+ y,
48
+ }: VectorControlProps): React.JSX.Element {
49
+ const [isPointerDragging, setIsPointerDragging] = React.useState(false);
50
+ const normalizedX = formatVectorPadCoordinate(x);
51
+ const normalizedY = formatVectorPadCoordinate(y);
52
+ const coordinateMode =
53
+ padCoordinateMode ?? getDefaultPadCoordinateMode(padVariant);
54
+ const point = getVectorPoint(normalizedX, normalizedY, coordinateMode);
55
+ const valueLabel = getVectorValueLabel(normalizedX, normalizedY);
56
+ const vectorPadBackgroundImage = vectorPadBackgroundImages[padVariant];
57
+ const axisLockRef = React.useRef<VectorPadAxisLock | null>(null);
58
+ const dragStartRef = React.useRef<VectorPadDragStart | null>(null);
59
+ const liveHistoryGroupRef = React.useRef<string | null>(null);
60
+ const resetX = formatVectorPadCoordinate(defaultValue?.x);
61
+ const resetY = formatVectorPadCoordinate(defaultValue?.y);
62
+ const accessibleName = name || "Vector";
63
+ const updateVector = (
64
+ nextX: string,
65
+ nextY: string,
66
+ meta?: ControlChangeMeta,
67
+ ) => {
68
+ if (meta) {
69
+ onValueChange?.({ x: nextX, y: nextY }, meta);
70
+ return;
71
+ }
72
+
73
+ onValueChange?.({ x: nextX, y: nextY });
74
+ };
75
+ const commitVectorValue = (nextValue: string) => {
76
+ const nextVector = parseVectorValueDraft(nextValue);
77
+
78
+ if (nextVector) {
79
+ updateVector(nextVector.x, nextVector.y);
80
+ }
81
+ };
82
+
83
+ function getLiveHistoryMeta(): ControlChangeMeta {
84
+ liveHistoryGroupRef.current ??= createControlHistoryGroupId(`vector:${accessibleName}`);
85
+
86
+ return {
87
+ history: "merge",
88
+ historyGroup: liveHistoryGroupRef.current,
89
+ };
90
+ }
91
+
92
+ function updateFromPointer(event: React.PointerEvent<HTMLButtonElement>): void {
93
+ const nextPoint = pointFromEvent(event, coordinateMode);
94
+ const nextValue: VectorControlValue = {
95
+ x: (nextPoint.x * 2 - 1).toFixed(2),
96
+ y: (nextPoint.y * 2 - 1).toFixed(2),
97
+ };
98
+ const dragStart = dragStartRef.current;
99
+
100
+ if (event.shiftKey && dragStart) {
101
+ if (!axisLockRef.current) {
102
+ const deltaX = event.clientX - dragStart.clientX;
103
+ const deltaY = event.clientY - dragStart.clientY;
104
+
105
+ if (Math.hypot(deltaX, deltaY) < vectorPadAxisLockThresholdPx) {
106
+ updateVector(
107
+ dragStart.value.x,
108
+ dragStart.value.y,
109
+ getLiveHistoryMeta(),
110
+ );
111
+ return;
112
+ }
113
+
114
+ axisLockRef.current = Math.abs(deltaX) >= Math.abs(deltaY) ? "x" : "y";
115
+ }
116
+
117
+ updateVector(
118
+ axisLockRef.current === "x" ? nextValue.x : dragStart.value.x,
119
+ axisLockRef.current === "y" ? nextValue.y : dragStart.value.y,
120
+ getLiveHistoryMeta(),
121
+ );
122
+ return;
123
+ }
124
+
125
+ axisLockRef.current = null;
126
+
127
+ updateVector(
128
+ nextValue.x,
129
+ nextValue.y,
130
+ getLiveHistoryMeta(),
131
+ );
132
+ }
133
+
134
+ function stopPointerDrag(): void {
135
+ setIsPointerDragging(false);
136
+ axisLockRef.current = null;
137
+ dragStartRef.current = null;
138
+ liveHistoryGroupRef.current = null;
139
+ }
140
+
141
+ return (
142
+ <Field className="min-w-0 gap-2">
143
+ {name ? (
144
+ <div className="grid min-w-0 grid-cols-[minmax(0,1fr)_auto] items-center gap-3">
145
+ <ControlFieldLabel className="min-w-0">{name}</ControlFieldLabel>
146
+ <EditableSliderValueLabel
147
+ ariaLabel={`${name} value`}
148
+ maxValueLabel="-1.00, -1.00"
149
+ onCommit={commitVectorValue}
150
+ valueLabel={valueLabel}
151
+ />
152
+ </div>
153
+ ) : null}
154
+ <button
155
+ aria-label={`${accessibleName} X/Y pad`}
156
+ className={cn(
157
+ "relative w-full cursor-default! touch-none overflow-hidden rounded-[calc(var(--radius)+2px)] bg-[linear-gradient(180deg,color-mix(in_oklab,var(--foreground)_4%,transparent),color-mix(in_oklab,var(--foreground)_1%,transparent))] select-none focus-visible:shadow-[0_0_0_3px_color-mix(in_oklab,var(--foreground)_12%,transparent)] focus-visible:outline-none",
158
+ padShape === "square" ? "aspect-square" : "h-[142px]",
159
+ )}
160
+ data-vector-pad-coordinate-mode={coordinateMode}
161
+ data-vector-pad-shape={padShape}
162
+ data-vector-pad-variant={padVariant}
163
+ onDoubleClick={(event) => {
164
+ event.preventDefault();
165
+ stopPointerDrag();
166
+ updateVector(resetX, resetY);
167
+ }}
168
+ onLostPointerCapture={stopPointerDrag}
169
+ onPointerCancel={stopPointerDrag}
170
+ onPointerDown={(event) => {
171
+ event.preventDefault();
172
+ setIsPointerDragging(true);
173
+ axisLockRef.current = null;
174
+ dragStartRef.current = {
175
+ clientX: event.clientX,
176
+ clientY: event.clientY,
177
+ value: { x: normalizedX, y: normalizedY },
178
+ };
179
+ event.currentTarget.setPointerCapture(event.pointerId);
180
+ updateFromPointer(event);
181
+ }}
182
+ onPointerMove={(event) => {
183
+ if (event.buttons === 1) {
184
+ updateFromPointer(event);
185
+ }
186
+ }}
187
+ onPointerUp={stopPointerDrag}
188
+ style={point}
189
+ type="button"
190
+ >
191
+ {vectorPadBackgroundImage ? (
192
+ <span
193
+ aria-hidden="true"
194
+ className="pointer-events-none absolute inset-0 rounded-[inherit] opacity-40"
195
+ style={{ backgroundImage: vectorPadBackgroundImage }}
196
+ />
197
+ ) : null}
198
+ <span
199
+ aria-hidden="true"
200
+ className="pointer-events-none absolute inset-0 rounded-[inherit] bg-[radial-gradient(circle,color-mix(in_oklab,var(--foreground)_8%,transparent)_1px,transparent_1px)] bg-[length:14px_14px]"
201
+ />
202
+ <VectorPadGuides isDragging={isPointerDragging} />
203
+ <VectorPadHandle isDragging={isPointerDragging} />
204
+ <span
205
+ aria-hidden="true"
206
+ className="pointer-events-none absolute inset-0 z-30 rounded-[inherit] border border-[color:color-mix(in_oklab,var(--border)_10%,transparent)]"
207
+ />
208
+ </button>
209
+ </Field>
210
+ );
211
+ }
@@ -0,0 +1,61 @@
1
+ import type * as React from "react";
2
+
3
+ import type {
4
+ VectorPadCoordinateMode,
5
+ VectorPadVariant,
6
+ } from "./vector-control-types";
7
+ import { clamp } from "./vector-value";
8
+
9
+ type VectorPadPoint = { x: number; y: number };
10
+
11
+ export type VectorPadStyle = React.CSSProperties & {
12
+ "--xy-pad-display-x": string;
13
+ "--xy-pad-display-y": string;
14
+ "--xy-pad-handle-margin": string;
15
+ "--xy-pad-x": string;
16
+ "--xy-pad-y": string;
17
+ };
18
+
19
+ export function getDefaultPadCoordinateMode(
20
+ padVariant: VectorPadVariant,
21
+ ): VectorPadCoordinateMode {
22
+ return padVariant === "default" ? "screen" : "cartesian";
23
+ }
24
+
25
+ export function pointFromEvent(
26
+ event: React.PointerEvent<HTMLElement>,
27
+ coordinateMode: VectorPadCoordinateMode,
28
+ ): VectorPadPoint {
29
+ const rect = event.currentTarget.getBoundingClientRect();
30
+ const x = clamp((event.clientX - rect.left) / rect.width);
31
+ const yRatio = clamp((event.clientY - rect.top) / rect.height);
32
+ const y = coordinateMode === "screen" ? yRatio : 1 - yRatio;
33
+
34
+ return { x, y };
35
+ }
36
+
37
+ export function getVectorPoint(
38
+ x: string,
39
+ y: string,
40
+ coordinateMode: VectorPadCoordinateMode,
41
+ ): VectorPadStyle {
42
+ const parsedX = Number.parseFloat(x);
43
+ const parsedY = Number.parseFloat(y);
44
+ const clampedX = Number.isFinite(parsedX) ? clamp(parsedX, -1, 1) : 0;
45
+ const clampedY = Number.isFinite(parsedY) ? clamp(parsedY, -1, 1) : 0;
46
+ const xPosition = `${(clampedX + 1) * 50}%`;
47
+ const yPosition =
48
+ coordinateMode === "screen"
49
+ ? `${((clampedY + 1) / 2) * 100}%`
50
+ : `${(1 - (clampedY + 1) / 2) * 100}%`;
51
+
52
+ return {
53
+ "--xy-pad-display-x":
54
+ "clamp(var(--xy-pad-handle-margin), var(--xy-pad-x), calc(100% - var(--xy-pad-handle-margin)))",
55
+ "--xy-pad-display-y":
56
+ "clamp(var(--xy-pad-handle-margin), var(--xy-pad-y), calc(100% - var(--xy-pad-handle-margin)))",
57
+ "--xy-pad-handle-margin": "12px",
58
+ "--xy-pad-x": xPosition,
59
+ "--xy-pad-y": yPosition,
60
+ };
61
+ }
@@ -0,0 +1,72 @@
1
+ "use client";
2
+
3
+ import * as React from "react";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+
7
+ export function VectorPadGuides({
8
+ isDragging,
9
+ }: {
10
+ isDragging: boolean;
11
+ }): React.JSX.Element {
12
+ const motionClass = isDragging
13
+ ? "transition-none"
14
+ : "transition-[top] duration-[260ms] ease-[cubic-bezier(0.34,1.56,0.64,1)]";
15
+ const verticalMotionClass = isDragging
16
+ ? "transition-none"
17
+ : "transition-[left] duration-[260ms] ease-[cubic-bezier(0.34,1.56,0.64,1)]";
18
+
19
+ return (
20
+ <>
21
+ <span
22
+ aria-hidden="true"
23
+ className={cn(
24
+ "pointer-events-none absolute inset-x-0 z-10 h-px bg-[linear-gradient(90deg,transparent,color-mix(in_oklab,var(--foreground)_20%,transparent),transparent)]",
25
+ motionClass,
26
+ )}
27
+ style={{ top: "var(--xy-pad-display-y)" }}
28
+ />
29
+ <span
30
+ aria-hidden="true"
31
+ className={cn(
32
+ "pointer-events-none absolute top-0 bottom-0 z-10 w-px bg-[linear-gradient(180deg,transparent,color-mix(in_oklab,var(--foreground)_20%,transparent),transparent)]",
33
+ verticalMotionClass,
34
+ )}
35
+ style={{ left: "var(--xy-pad-display-x)" }}
36
+ />
37
+ </>
38
+ );
39
+ }
40
+
41
+ export function VectorPadHandle({
42
+ isDragging,
43
+ }: {
44
+ isDragging: boolean;
45
+ }): React.JSX.Element {
46
+ return (
47
+ <div
48
+ aria-hidden="true"
49
+ className={cn(
50
+ "xy-handle group/xy-handle pointer-events-auto absolute z-20 size-3 -translate-x-1/2 -translate-y-1/2 cursor-default will-change-[left,top,transform]",
51
+ isDragging
52
+ ? "cursor-pointer transition-transform duration-[120ms] ease-[cubic-bezier(0.22,1,0.36,1)]"
53
+ : "transition-[left,top,transform] duration-[260ms,260ms,120ms] ease-[cubic-bezier(0.34,1.56,0.64,1),cubic-bezier(0.34,1.56,0.64,1),cubic-bezier(0.22,1,0.36,1)] hover:cursor-pointer",
54
+ )}
55
+ style={{ left: "var(--xy-pad-display-x)", top: "var(--xy-pad-display-y)" }}
56
+ >
57
+ <span
58
+ aria-hidden="true"
59
+ className={cn(
60
+ "pointer-events-none absolute inset-[-5px] rounded-full bg-[color:color-mix(in_oklab,var(--foreground)_12%,transparent)] opacity-0 blur-[8px] transition-[opacity,scale] duration-200 ease-out",
61
+ isDragging ? "scale-[1.45] opacity-100" : "scale-95",
62
+ )}
63
+ />
64
+ <span
65
+ className={cn(
66
+ "relative block size-full rounded-full bg-[radial-gradient(circle_at_30%_30%,color-mix(in_oklab,var(--foreground)_95%,transparent),color-mix(in_oklab,var(--foreground)_76%,transparent)),linear-gradient(180deg,color-mix(in_oklab,var(--foreground)_20%,transparent),color-mix(in_oklab,var(--foreground)_6%,transparent))] shadow-[0_4px_10px_color-mix(in_oklab,var(--background)_20%,transparent)] transition-[scale,background-color,box-shadow] duration-200 ease-out will-change-transform motion-reduce:transition-none",
67
+ isDragging ? "scale-[1.3333]" : "group-hover/xy-handle:scale-[1.3333]",
68
+ )}
69
+ />
70
+ </div>
71
+ );
72
+ }
@@ -0,0 +1,20 @@
1
+ import type { VectorPadVariant } from "./vector-control-types";
2
+
3
+ const whiteBalancePadBackgroundImage =
4
+ "linear-gradient(90deg,color-mix(in oklab, #2f7cff 72%, transparent),color-mix(in oklab, var(--foreground) 8%, transparent) 50%,color-mix(in oklab, #ff9a22 78%, transparent)),linear-gradient(180deg,color-mix(in oklab, #d84f9a 68%, transparent),transparent 49%,color-mix(in oklab, #42ba62 72%, transparent)),radial-gradient(circle at 50% 50%,color-mix(in oklab, var(--foreground) 7%, transparent),color-mix(in oklab, var(--background) 14%, transparent) 62%)";
5
+
6
+ const colorBalancePadBackgroundImage =
7
+ "linear-gradient(90deg,color-mix(in oklab, #1dbdd3 70%, transparent),color-mix(in oklab, var(--foreground) 7%, transparent) 50%,color-mix(in oklab, #ff4a45 74%, transparent)),linear-gradient(180deg,color-mix(in oklab, #f2d94c 66%, transparent),transparent 50%,color-mix(in oklab, #315cff 70%, transparent)),radial-gradient(circle at 50% 50%,color-mix(in oklab, var(--foreground) 7%, transparent),color-mix(in oklab, var(--background) 14%, transparent) 62%)";
8
+
9
+ const chromaOffsetPadBackgroundImage =
10
+ "linear-gradient(90deg,color-mix(in oklab, #ff2f55 68%, transparent),transparent 38%,transparent 62%,color-mix(in oklab, #25c7ff 70%, transparent)),linear-gradient(180deg,color-mix(in oklab, #56ff72 54%, transparent),transparent 42%,transparent 58%,color-mix(in oklab, #7b5cff 62%, transparent)),radial-gradient(circle at 50% 50%,color-mix(in oklab, var(--foreground) 8%, transparent),color-mix(in oklab, var(--background) 14%, transparent) 62%)";
11
+
12
+ const toneBiasPadBackgroundImage =
13
+ "linear-gradient(90deg,color-mix(in oklab, #3f56ff 60%, transparent),color-mix(in oklab, var(--foreground) 7%, transparent) 50%,color-mix(in oklab, #ffb23f 68%, transparent)),linear-gradient(180deg,color-mix(in oklab, #f05bb5 55%, transparent),transparent 50%,color-mix(in oklab, #1fbf9a 60%, transparent)),radial-gradient(circle at 50% 50%,color-mix(in oklab, var(--foreground) 7%, transparent),color-mix(in oklab, var(--background) 14%, transparent) 62%)";
14
+
15
+ export const vectorPadBackgroundImages: Partial<Record<VectorPadVariant, string>> = {
16
+ chromaOffset: chromaOffsetPadBackgroundImage,
17
+ colorBalance: colorBalancePadBackgroundImage,
18
+ toneBias: toneBiasPadBackgroundImage,
19
+ whiteBalance: whiteBalancePadBackgroundImage,
20
+ };
@@ -0,0 +1,104 @@
1
+ "use client";
2
+
3
+ import * as React from "react";
4
+
5
+ import { ControlFieldLabel } from "../../control-layout";
6
+ import { Field, Input } from "../../primitives";
7
+ import type { VectorControlProps } from "./vector-control-types";
8
+ import { normalizeVectorCoordinate } from "./vector-value";
9
+
10
+ export function VectorSizeField({
11
+ defaultValue,
12
+ name,
13
+ onValueChange,
14
+ x,
15
+ xLabel = "X",
16
+ y,
17
+ yLabel = "Y",
18
+ }: VectorControlProps): React.JSX.Element {
19
+ const [draftValue, setDraftValue] = React.useState({ x, y });
20
+ const committedValueRef = React.useRef({ x, y });
21
+ const defaultValueRef = React.useRef({
22
+ x: normalizeVectorCoordinate(defaultValue?.x),
23
+ y: normalizeVectorCoordinate(defaultValue?.y),
24
+ });
25
+
26
+ React.useEffect(() => {
27
+ committedValueRef.current = { x, y };
28
+ setDraftValue({ x, y });
29
+ }, [x, y]);
30
+
31
+ React.useEffect(() => {
32
+ defaultValueRef.current = {
33
+ x: normalizeVectorCoordinate(defaultValue?.x),
34
+ y: normalizeVectorCoordinate(defaultValue?.y),
35
+ };
36
+ }, [defaultValue?.x, defaultValue?.y]);
37
+
38
+ function commitVector(): void {
39
+ const nextValue = {
40
+ x: draftValue.x.trim() === "" ? defaultValueRef.current.x : draftValue.x,
41
+ y: draftValue.y.trim() === "" ? defaultValueRef.current.y : draftValue.y,
42
+ };
43
+
44
+ setDraftValue(nextValue);
45
+
46
+ if (
47
+ nextValue.x !== committedValueRef.current.x ||
48
+ nextValue.y !== committedValueRef.current.y
49
+ ) {
50
+ onValueChange?.(nextValue);
51
+ }
52
+ }
53
+
54
+ function cancelDraft(): void {
55
+ setDraftValue(committedValueRef.current);
56
+ }
57
+
58
+ function handleKeyDown(event: React.KeyboardEvent<HTMLInputElement>): void {
59
+ if (event.key === "Enter") {
60
+ event.preventDefault();
61
+ commitVector();
62
+ event.currentTarget.blur();
63
+ return;
64
+ }
65
+
66
+ if (event.key === "Escape") {
67
+ event.preventDefault();
68
+ cancelDraft();
69
+ event.currentTarget.blur();
70
+ }
71
+ }
72
+
73
+ return (
74
+ <Field className="min-w-0 gap-2">
75
+ <div className="flex items-center justify-between gap-3">
76
+ <ControlFieldLabel>{name}</ControlFieldLabel>
77
+ </div>
78
+ <div className="grid grid-cols-[minmax(0,1fr)_minmax(0,1fr)] gap-1.5">
79
+ <Input
80
+ aria-label={`${name} ${xLabel}`}
81
+ className="font-mono"
82
+ onBlur={commitVector}
83
+ onChange={(event) =>
84
+ setDraftValue((current) => ({ ...current, x: event.target.value }))
85
+ }
86
+ onKeyDown={handleKeyDown}
87
+ size="default"
88
+ value={draftValue.x}
89
+ />
90
+ <Input
91
+ aria-label={`${name} ${yLabel}`}
92
+ className="font-mono"
93
+ onBlur={commitVector}
94
+ onChange={(event) =>
95
+ setDraftValue((current) => ({ ...current, y: event.target.value }))
96
+ }
97
+ onKeyDown={handleKeyDown}
98
+ size="default"
99
+ value={draftValue.y}
100
+ />
101
+ </div>
102
+ </Field>
103
+ );
104
+ }
@@ -0,0 +1,46 @@
1
+ import type { VectorControlValue } from "./vector-control-types";
2
+
3
+ export function clamp(value: number, min = 0, max = 1): number {
4
+ return Math.min(max, Math.max(min, value));
5
+ }
6
+
7
+ export function getVectorValueLabel(x: string, y: string): string {
8
+ return `${formatVectorPadCoordinate(x)}, ${formatVectorPadCoordinate(y)}`;
9
+ }
10
+
11
+ export function normalizeVectorCoordinate(value: string | undefined): string {
12
+ return typeof value === "string" && value.trim() ? value : "0.00";
13
+ }
14
+
15
+ export function formatVectorPadCoordinate(value: string | undefined): string {
16
+ const parsedValue = Number.parseFloat(normalizeVectorCoordinate(value));
17
+
18
+ if (!Number.isFinite(parsedValue)) {
19
+ return "0.00";
20
+ }
21
+
22
+ const roundedValue = Math.abs(parsedValue) < 0.005 ? 0 : clamp(parsedValue, -1, 1);
23
+
24
+ return roundedValue.toFixed(2);
25
+ }
26
+
27
+ export function parseVectorValueDraft(value: string): VectorControlValue | null {
28
+ const matches = value.match(/[+-]?(?:\d+(?:[.,]\d+)?|[.,]\d+)/g);
29
+
30
+ if (!matches || matches.length < 2) {
31
+ return null;
32
+ }
33
+
34
+ const [rawX, rawY] = matches;
35
+ const nextX = Number.parseFloat(rawX.replace(",", "."));
36
+ const nextY = Number.parseFloat(rawY.replace(",", "."));
37
+
38
+ if (!Number.isFinite(nextX) || !Number.isFinite(nextY)) {
39
+ return null;
40
+ }
41
+
42
+ return {
43
+ x: clamp(nextX, -1, 1).toFixed(2),
44
+ y: clamp(nextY, -1, 1).toFixed(2),
45
+ };
46
+ }
@@ -0,0 +1,181 @@
1
+ "use client";
2
+
3
+ import * as React from "react";
4
+ import type { Slider as SliderPrimitive } from "@base-ui/react/slider";
5
+
6
+ import type { SliderProps, SliderVariant } from "./slider-types";
7
+ import {
8
+ getSliderValues,
9
+ normalizeSliderValueShape,
10
+ snapSliderValue,
11
+ valuesMatch,
12
+ type SliderRuntimeValue,
13
+ type SliderValue,
14
+ } from "./slider-value";
15
+
16
+ type SliderValueStateOptions<Value extends number | readonly number[]> = {
17
+ defaultValue?: Value;
18
+ largeStep?: number;
19
+ max: number;
20
+ min: number;
21
+ onValueChange?: SliderProps<Value>["onValueChange"];
22
+ onValueCommitted?: SliderProps<Value>["onValueCommitted"];
23
+ snapValues?: readonly number[];
24
+ step: number;
25
+ value?: Value;
26
+ variant: SliderVariant;
27
+ };
28
+
29
+ type ControlledDiscreteValueResetOptions<Value extends number | readonly number[]> = {
30
+ discreteValue: Value | undefined;
31
+ isDiscrete: boolean;
32
+ lastInternalDiscreteValueRef: React.RefObject<Value | undefined>;
33
+ max: number;
34
+ min: number;
35
+ setDiscreteValue: React.Dispatch<React.SetStateAction<Value | undefined>>;
36
+ snapValues?: readonly number[];
37
+ step: number;
38
+ value: Value | undefined;
39
+ };
40
+
41
+ function useControlledDiscreteValueReset<Value extends number | readonly number[]>({
42
+ discreteValue,
43
+ isDiscrete,
44
+ lastInternalDiscreteValueRef,
45
+ max,
46
+ min,
47
+ setDiscreteValue,
48
+ snapValues,
49
+ step,
50
+ value,
51
+ }: ControlledDiscreteValueResetOptions<Value>) {
52
+ React.useEffect(() => {
53
+ if (!isDiscrete || value === undefined || discreteValue === undefined) {
54
+ return;
55
+ }
56
+
57
+ const lastInternalValue = lastInternalDiscreteValueRef.current;
58
+ if (lastInternalValue !== undefined) {
59
+ if (valuesMatch(value, lastInternalValue)) {
60
+ return;
61
+ }
62
+
63
+ const snappedInternalValue = snapSliderValue(lastInternalValue, min, max, step, snapValues);
64
+ if (valuesMatch(value, snappedInternalValue)) {
65
+ return;
66
+ }
67
+ }
68
+
69
+ setDiscreteValue(undefined);
70
+ }, [
71
+ discreteValue,
72
+ isDiscrete,
73
+ lastInternalDiscreteValueRef,
74
+ max,
75
+ min,
76
+ setDiscreteValue,
77
+ snapValues,
78
+ step,
79
+ value,
80
+ ]);
81
+ }
82
+
83
+ export function useSliderValueState<Value extends number | readonly number[]>({
84
+ defaultValue,
85
+ largeStep,
86
+ max,
87
+ min,
88
+ onValueChange,
89
+ onValueCommitted,
90
+ snapValues,
91
+ step,
92
+ value,
93
+ variant,
94
+ }: SliderValueStateOptions<Value>) {
95
+ const [discreteValue, setDiscreteValue] = React.useState<Value | undefined>(() =>
96
+ value === undefined ? defaultValue : undefined,
97
+ );
98
+ const lastInternalDiscreteValueRef = React.useRef<Value | undefined>(
99
+ value === undefined ? defaultValue : undefined,
100
+ );
101
+ const lastChangeDetailsRef = React.useRef<SliderPrimitive.Root.ChangeEventDetails | null>(null);
102
+ const isDiscrete = variant === "discrete";
103
+ const resolvedValue = isDiscrete ? (discreteValue ?? value ?? defaultValue) : value;
104
+ const rootStep = isDiscrete ? Math.max((max - min) / 1000, 0.000001) : step;
105
+ const rootLargeStep = isDiscrete ? (largeStep ?? step) : largeStep;
106
+ const values = React.useMemo(
107
+ () => getSliderValues(resolvedValue, defaultValue, min, max),
108
+ [resolvedValue, defaultValue, min, max],
109
+ );
110
+
111
+ useControlledDiscreteValueReset({
112
+ discreteValue,
113
+ isDiscrete,
114
+ lastInternalDiscreteValueRef,
115
+ max,
116
+ min,
117
+ setDiscreteValue,
118
+ snapValues,
119
+ step,
120
+ value,
121
+ });
122
+
123
+ const handleValueChange = React.useCallback(
124
+ (nextValue: SliderValue<Value>, eventDetails: SliderPrimitive.Root.ChangeEventDetails) => {
125
+ lastChangeDetailsRef.current = eventDetails;
126
+ if (isDiscrete) {
127
+ const normalizedNextValue = normalizeSliderValueShape(
128
+ nextValue as SliderRuntimeValue,
129
+ value,
130
+ defaultValue,
131
+ min,
132
+ );
133
+ lastInternalDiscreteValueRef.current = normalizedNextValue;
134
+ setDiscreteValue(normalizedNextValue);
135
+ onValueChange?.(
136
+ snapSliderValue(normalizedNextValue, min, max, step, snapValues) as SliderValue<Value>,
137
+ eventDetails,
138
+ );
139
+ return;
140
+ }
141
+
142
+ onValueChange?.(nextValue, eventDetails);
143
+ },
144
+ [defaultValue, isDiscrete, max, min, onValueChange, snapValues, step, value],
145
+ );
146
+ const handleValueCommitted = React.useCallback(
147
+ (nextValue: SliderValue<Value>, eventDetails: SliderPrimitive.Root.CommitEventDetails) => {
148
+ if (!isDiscrete) {
149
+ onValueCommitted?.(nextValue, eventDetails);
150
+ return;
151
+ }
152
+
153
+ const normalizedNextValue = normalizeSliderValueShape(
154
+ nextValue as SliderRuntimeValue,
155
+ value,
156
+ defaultValue,
157
+ min,
158
+ );
159
+ const snappedValue = snapSliderValue(normalizedNextValue, min, max, step, snapValues);
160
+ lastInternalDiscreteValueRef.current = snappedValue;
161
+ setDiscreteValue(snappedValue);
162
+
163
+ if (!valuesMatch(snappedValue, normalizedNextValue) && lastChangeDetailsRef.current) {
164
+ onValueChange?.(snappedValue as SliderValue<Value>, lastChangeDetailsRef.current);
165
+ }
166
+
167
+ onValueCommitted?.(snappedValue as SliderValue<Value>, eventDetails);
168
+ },
169
+ [defaultValue, isDiscrete, max, min, onValueChange, onValueCommitted, snapValues, step, value],
170
+ );
171
+
172
+ return {
173
+ handleValueChange,
174
+ handleValueCommitted,
175
+ isDiscrete,
176
+ resolvedValue,
177
+ rootLargeStep,
178
+ rootStep,
179
+ values,
180
+ };
181
+ }