@pixel-point/toolcraft 0.0.13 → 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 (582) 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 +241 -294
  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 +45 -29
  276. package/templates/starter/LICENSE.md +18 -95
  277. package/templates/starter/NOTICE.md +3 -3
  278. package/templates/starter/docs/toolcraft/README.md +19 -4
  279. package/templates/starter/docs/toolcraft/acceptance-testing.md +38 -8
  280. package/templates/starter/docs/toolcraft/assembly-workflow.md +46 -185
  281. package/templates/starter/docs/toolcraft/component-rules.md +18 -190
  282. package/templates/starter/docs/toolcraft/core/control-selection.md +93 -0
  283. package/templates/starter/docs/toolcraft/core/layout.md +105 -0
  284. package/templates/starter/docs/toolcraft/core/media-upload.md +85 -0
  285. package/templates/starter/docs/toolcraft/core/performance.md +86 -0
  286. package/templates/starter/docs/toolcraft/core/reference-study.md +115 -0
  287. package/templates/starter/docs/toolcraft/core/runtime-boundary.md +60 -0
  288. package/templates/starter/docs/toolcraft/core/setup-export.md +86 -0
  289. package/templates/starter/docs/toolcraft/core/timeline-animation.md +68 -0
  290. package/templates/starter/docs/toolcraft/custom-controls.md +10 -1
  291. package/templates/starter/docs/toolcraft/decision-contract.md +26 -22
  292. package/templates/starter/docs/toolcraft/performance.md +44 -16
  293. package/templates/starter/docs/toolcraft/renderer-technique.md +2 -0
  294. package/templates/starter/docs/toolcraft/schema-reference.md +127 -366
  295. package/templates/starter/docs/toolcraft/workflow.md +26 -16
  296. package/templates/starter/e2e/app-browser-acceptance-evidence.spec.ts +111 -0
  297. package/templates/starter/e2e/app-browser-control-coverage.spec.ts +118 -0
  298. package/templates/starter/e2e/app-browser-performance-evidence.spec.ts +217 -0
  299. package/templates/starter/e2e/app-browser-performance-probe.spec.ts +322 -0
  300. package/templates/starter/e2e/app-browser-proof-session.spec.ts +196 -0
  301. package/templates/starter/e2e/app-browser-runtime-evidence.spec.ts +9 -0
  302. package/templates/starter/e2e/app-browser-runtime-provenance.spec.ts +240 -0
  303. package/templates/starter/e2e/app-browser-runtime-reporter.spec.ts +180 -0
  304. package/templates/starter/e2e/app-browser-runtime-requirements.spec.ts +310 -0
  305. package/templates/starter/e2e/app-browser-semantic-evidence.spec.ts +432 -0
  306. package/templates/starter/e2e/app-browser-shell.spec.ts +171 -0
  307. package/templates/starter/e2e/app-browser-timeline-layers-reference.spec.ts +70 -0
  308. package/templates/starter/e2e/app-performance.spec.ts +0 -491
  309. package/templates/starter/e2e/browser-acceptance-outcome-helpers.ts +97 -0
  310. package/templates/starter/e2e/browser-acceptance-transition-helpers.ts +74 -0
  311. package/templates/starter/e2e/browser-conditional-output-evidence-helpers.ts +230 -0
  312. package/templates/starter/e2e/browser-control-target-helpers.ts +109 -0
  313. package/templates/starter/e2e/browser-layer-evidence-helpers.ts +229 -0
  314. package/templates/starter/e2e/browser-proof-session.ts +392 -0
  315. package/templates/starter/e2e/browser-runtime-evidence-reporter.ts +136 -0
  316. package/templates/starter/e2e/browser-runtime-evidence-requirements.ts +290 -0
  317. package/templates/starter/e2e/browser-runtime-evidence.ts +27 -0
  318. package/templates/starter/e2e/browser-state-evidence-helpers.ts +205 -0
  319. package/templates/starter/e2e/browser-timeline-evidence-helpers.ts +319 -0
  320. package/templates/starter/e2e/canvas-handle-helpers.ts +86 -4
  321. package/templates/starter/e2e/export-artifact-helpers.ts +132 -0
  322. package/templates/starter/e2e/performance-budget-helpers.ts +159 -0
  323. package/templates/starter/e2e/performance-canvas-helpers.ts +123 -0
  324. package/templates/starter/e2e/performance-control-helpers.ts +3 -0
  325. package/templates/starter/e2e/performance-control-layout-helpers.ts +161 -0
  326. package/templates/starter/e2e/performance-fixture-helpers.ts +217 -0
  327. package/templates/starter/e2e/performance-frame-probe.ts +247 -0
  328. package/templates/starter/e2e/performance-helpers.ts +6 -854
  329. package/templates/starter/e2e/performance-interaction-measurement.ts +251 -0
  330. package/templates/starter/e2e/performance-measurement-evidence.ts +72 -0
  331. package/templates/starter/e2e/performance-output-action-helpers.spec.ts +43 -0
  332. package/templates/starter/e2e/performance-output-action-helpers.ts +109 -0
  333. package/templates/starter/e2e/performance-probe-helpers.ts +12 -0
  334. package/templates/starter/e2e/performance-render-scale-helpers.ts +55 -0
  335. package/templates/starter/e2e/performance-slider-helpers.ts +271 -0
  336. package/templates/starter/e2e/product-observable-helpers.ts +72 -17
  337. package/templates/starter/e2e/stable-outcome-helpers.ts +208 -0
  338. package/templates/starter/package.json +10 -5
  339. package/templates/starter/playwright.config.ts +5 -2
  340. package/templates/starter/scripts/check-ai-skills.mjs +14 -8
  341. package/templates/starter/scripts/check-ai-skills.test.mjs +64 -0
  342. package/templates/starter/scripts/check-toolcraft-code-health.mjs +108 -0
  343. package/templates/starter/scripts/check-toolcraft-code-health.test.mjs +213 -0
  344. package/templates/starter/scripts/check-toolcraft-docs.mjs +70 -35
  345. package/templates/starter/scripts/check-toolcraft-integrity.mjs +141 -144
  346. package/templates/starter/scripts/run-browser-performance.mjs +118 -0
  347. package/templates/starter/scripts/run-browser-performance.test.mjs +53 -0
  348. package/templates/starter/scripts/toolcraft-code-health-core.mjs +297 -0
  349. package/templates/starter/scripts/toolcraft-contract-doc-integrity.mjs +77 -0
  350. package/templates/starter/scripts/toolcraft-contract-doc-integrity.test.mjs +81 -0
  351. package/templates/starter/scripts/toolcraft-contract-manifest.json +113 -0
  352. package/templates/starter/scripts/toolcraft-contract-manifest.mjs +128 -0
  353. package/templates/starter/scripts/toolcraft-contract-manifest.test.mjs +72 -0
  354. package/templates/starter/scripts/toolcraft-integrity-manifest.mjs +172 -0
  355. package/templates/starter/scripts/toolcraft-integrity-policy.mjs +60 -0
  356. package/templates/starter/scripts/toolcraft-product-boundary-ast-utils.mjs +23 -0
  357. package/templates/starter/scripts/toolcraft-product-boundary-ast.mjs +264 -0
  358. package/templates/starter/scripts/toolcraft-product-boundary-test-fixtures.mjs +16 -0
  359. package/templates/starter/scripts/toolcraft-product-boundary.mjs +243 -0
  360. package/templates/starter/scripts/toolcraft-product-boundary.test.mjs +289 -0
  361. package/templates/starter/scripts/toolcraft-product-dependency-graph.mjs +176 -0
  362. package/templates/starter/scripts/toolcraft-product-dependency-graph.test.mjs +196 -0
  363. package/templates/starter/scripts/toolcraft-product-dependency-resolution.mjs +279 -0
  364. package/templates/starter/scripts/toolcraft-product-evidence-boundary-ast.mjs +91 -0
  365. package/templates/starter/scripts/toolcraft-product-evidence-boundary.test.mjs +138 -0
  366. package/templates/starter/scripts/toolcraft-product-style-boundary.mjs +219 -0
  367. package/templates/starter/scripts/toolcraft-source-inventory.d.mts +46 -0
  368. package/templates/starter/scripts/toolcraft-source-inventory.mjs +187 -0
  369. package/templates/starter/scripts/toolcraft-source-inventory.test.mjs +132 -0
  370. package/templates/starter/scripts/toolcraft-source-ownership.mjs +167 -0
  371. package/templates/starter/scripts/toolcraft-source-ownership.test.mjs +113 -0
  372. package/templates/starter/scripts/toolcraft-static-string.mjs +104 -0
  373. package/templates/starter/scripts/toolcraft-verification-inventory.mjs +123 -0
  374. package/templates/starter/scripts/toolcraft-verification-receipt.d.mts +19 -0
  375. package/templates/starter/scripts/toolcraft-verification-receipt.mjs +284 -0
  376. package/templates/starter/scripts/toolcraft-verification-receipt.test.mjs +282 -0
  377. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.d.mts +32 -0
  378. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.mjs +88 -0
  379. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.test.mjs +87 -0
  380. package/templates/starter/scripts/toolcraft-vitest-runtime-evidence-reporter.mjs +109 -0
  381. package/templates/starter/scripts/toolcraft-vitest-runtime-evidence-reporter.test.mjs +111 -0
  382. package/templates/starter/scripts/toolcraft-workflow-routes.mjs +314 -0
  383. package/templates/starter/scripts/toolcraft-workflow-routes.test.mjs +204 -0
  384. package/templates/starter/src/app/acceptance/actions.ts +30 -0
  385. package/templates/starter/src/app/acceptance/animation-intent.ts +184 -0
  386. package/templates/starter/src/app/acceptance/canvas-handle-acceptance.ts +70 -0
  387. package/templates/starter/src/app/acceptance/color-bank-labels.ts +164 -0
  388. package/templates/starter/src/app/acceptance/conditions.ts +80 -0
  389. package/templates/starter/src/app/acceptance/control-acceptance-context.ts +70 -0
  390. package/templates/starter/src/app/acceptance/control-acceptance-coverage.ts +271 -0
  391. package/templates/starter/src/app/acceptance/control-acceptance-kind-rules.ts +149 -0
  392. package/templates/starter/src/app/acceptance/control-acceptance-policy.ts +189 -0
  393. package/templates/starter/src/app/acceptance/control-acceptance.ts +70 -0
  394. package/templates/starter/src/app/acceptance/control-component-rules.ts +277 -0
  395. package/templates/starter/src/app/acceptance/control-labels.ts +223 -0
  396. package/templates/starter/src/app/acceptance/control-layout-dependency-rules.ts +107 -0
  397. package/templates/starter/src/app/acceptance/control-layout-entity-rules.ts +104 -0
  398. package/templates/starter/src/app/acceptance/control-layout-model.ts +159 -0
  399. package/templates/starter/src/app/acceptance/control-layout-section-rules.ts +164 -0
  400. package/templates/starter/src/app/acceptance/control-layout.ts +45 -0
  401. package/templates/starter/src/app/acceptance/control-order.ts +123 -0
  402. package/templates/starter/src/app/acceptance/control-parts.ts +47 -0
  403. package/templates/starter/src/app/acceptance/control-section-inventory.ts +183 -0
  404. package/templates/starter/src/app/acceptance/controls.ts +27 -0
  405. package/templates/starter/src/app/acceptance/coverage.ts +81 -0
  406. package/templates/starter/src/app/acceptance/custom-controls.ts +140 -0
  407. package/templates/starter/src/app/acceptance/inline-layout.ts +192 -0
  408. package/templates/starter/src/app/acceptance/media-upload.ts +55 -0
  409. package/templates/starter/src/app/acceptance/output-background-rules.ts +135 -0
  410. package/templates/starter/src/app/acceptance/output-export-actions.test.ts +76 -0
  411. package/templates/starter/src/app/acceptance/output-export-actions.ts +34 -0
  412. package/templates/starter/src/app/acceptance/output-export-layout-rules.ts +46 -0
  413. package/templates/starter/src/app/acceptance/output-export-model.ts +146 -0
  414. package/templates/starter/src/app/acceptance/output-export.ts +45 -0
  415. package/templates/starter/src/app/acceptance/output-image-export-rules.ts +87 -0
  416. package/templates/starter/src/app/acceptance/reference-runtime-coverage.ts +96 -0
  417. package/templates/starter/src/app/acceptance/reference-runtime-feature-inventory.ts +171 -0
  418. package/templates/starter/src/app/acceptance/reference-runtime-study.ts +73 -0
  419. package/templates/starter/src/app/acceptance/reference-runtime-timeline.ts +291 -0
  420. package/templates/starter/src/app/acceptance/reference-runtime.ts +99 -0
  421. package/templates/starter/src/app/acceptance/runtime-coverage.ts +290 -0
  422. package/templates/starter/src/app/acceptance/runtime-setup.ts +117 -0
  423. package/templates/starter/src/app/acceptance/section-title-rules.ts +8 -0
  424. package/templates/starter/src/app/acceptance/sections.ts +6 -0
  425. package/templates/starter/src/app/acceptance/semantic.ts +63 -0
  426. package/templates/starter/src/app/acceptance/timeline-loop.ts +21 -0
  427. package/templates/starter/src/app/acceptance/types.ts +363 -0
  428. package/templates/starter/src/app/acceptance/validate-coverage.ts +217 -0
  429. package/templates/starter/src/app/acceptance/validation-pipeline.test.ts +56 -0
  430. package/templates/starter/src/app/acceptance/validation-pipeline.ts +60 -0
  431. package/templates/starter/src/app/acceptance/video-reference-study.ts +217 -0
  432. package/templates/starter/src/app/starter-acceptance-data.ts +21 -0
  433. package/templates/starter/src/app/starter-acceptance.animation-intent.test.ts +383 -0
  434. package/templates/starter/src/app/starter-acceptance.background-export.test.ts +349 -0
  435. package/templates/starter/src/app/starter-acceptance.base-coverage.test.ts +47 -0
  436. package/templates/starter/src/app/starter-acceptance.canvas-handles.test.ts +71 -0
  437. package/templates/starter/src/app/starter-acceptance.canvas-sizing.test.ts +199 -0
  438. package/templates/starter/src/app/starter-acceptance.compound-part-coverage.test.ts +244 -0
  439. package/templates/starter/src/app/starter-acceptance.contract-fixtures.ts +63 -0
  440. package/templates/starter/src/app/starter-acceptance.control-label-context.test.ts +172 -0
  441. package/templates/starter/src/app/starter-acceptance.control-labels.test.ts +387 -0
  442. package/templates/starter/src/app/starter-acceptance.control-naming-rules.test.ts +215 -0
  443. package/templates/starter/src/app/starter-acceptance.control-order.test.ts +274 -0
  444. package/templates/starter/src/app/starter-acceptance.control-state.test.ts +275 -0
  445. package/templates/starter/src/app/starter-acceptance.curves-rules.test.ts +184 -0
  446. package/templates/starter/src/app/starter-acceptance.custom-control-collections.test.ts +200 -0
  447. package/templates/starter/src/app/starter-acceptance.custom-control-coverage.test.ts +111 -0
  448. package/templates/starter/src/app/starter-acceptance.custom-control-fit-check.test.ts +135 -0
  449. package/templates/starter/src/app/starter-acceptance.custom-control-valid.test.ts +74 -0
  450. package/templates/starter/src/app/starter-acceptance.export-test-utils.ts +107 -0
  451. package/templates/starter/src/app/starter-acceptance.framework-boundary.test.ts +327 -0
  452. package/templates/starter/src/app/starter-acceptance.image-video-export-settings.test.ts +328 -0
  453. package/templates/starter/src/app/starter-acceptance.keyframes.test.ts +242 -0
  454. package/templates/starter/src/app/starter-acceptance.layers.test.ts +203 -0
  455. package/templates/starter/src/app/starter-acceptance.media-upload.fixtures.ts +110 -0
  456. package/templates/starter/src/app/starter-acceptance.media-upload.test.ts +153 -0
  457. package/templates/starter/src/app/starter-acceptance.output-export-rules.test.ts +97 -0
  458. package/templates/starter/src/app/starter-acceptance.persistence-coverage.test.ts +134 -0
  459. package/templates/starter/src/app/starter-acceptance.product-output-export.test.ts +202 -0
  460. package/templates/starter/src/app/starter-acceptance.product-readiness-rules.test.ts +14 -0
  461. package/templates/starter/src/app/starter-acceptance.product-readiness-test-utils.ts +25 -0
  462. package/templates/starter/src/app/starter-acceptance.product-readiness.test.ts +50 -0
  463. package/templates/starter/src/app/starter-acceptance.product-worklog.test.ts +27 -0
  464. package/templates/starter/src/app/starter-acceptance.range-slider-rules.test.ts +147 -0
  465. package/templates/starter/src/app/starter-acceptance.reference-custom-timeline.test.ts +197 -0
  466. package/templates/starter/src/app/starter-acceptance.reference-foundation.test.ts +304 -0
  467. package/templates/starter/src/app/starter-acceptance.reference-test-utils.ts +102 -0
  468. package/templates/starter/src/app/starter-acceptance.reference-timeline.test.ts +267 -0
  469. package/templates/starter/src/app/starter-acceptance.schema-test-utils.ts +116 -0
  470. package/templates/starter/src/app/starter-acceptance.section-cohesion.test.ts +373 -0
  471. package/templates/starter/src/app/starter-acceptance.section-dependencies.test.ts +260 -0
  472. package/templates/starter/src/app/starter-acceptance.section-titles.test.ts +180 -0
  473. package/templates/starter/src/app/starter-acceptance.setup-readiness.test.ts +205 -0
  474. package/templates/starter/src/app/starter-acceptance.slider-rules.test.ts +470 -0
  475. package/templates/starter/src/app/starter-acceptance.slider-unit-rules.test.ts +61 -0
  476. package/templates/starter/src/app/starter-acceptance.source-test-utils.ts +43 -0
  477. package/templates/starter/src/app/starter-acceptance.test-utils.ts +21 -0
  478. package/templates/starter/src/app/starter-acceptance.text-control-kind.test.ts +89 -0
  479. package/templates/starter/src/app/starter-acceptance.timeline-playback.test.ts +264 -0
  480. package/templates/starter/src/app/starter-acceptance.timeline-test-utils.ts +56 -0
  481. package/templates/starter/src/app/starter-acceptance.toggle-pair-layout.test.ts +200 -0
  482. package/templates/starter/src/app/starter-acceptance.toggle-parameter-layout.test.ts +277 -0
  483. package/templates/starter/src/app/starter-acceptance.ts +151 -4576
  484. package/templates/starter/src/app/starter-acceptance.video-export-test-utils.ts +37 -0
  485. package/templates/starter/src/app/starter-acceptance.video-reference-study.test.ts +262 -0
  486. package/templates/starter/src/app/starter-acceptance.worklog-test-utils.ts +428 -0
  487. package/templates/starter/src/app/starter-acceptance.worklog.test.ts +283 -0
  488. package/templates/starter/src/app/starter-automated-runtime-evidence.test.ts +34 -0
  489. package/templates/starter/src/app/starter-composition.tsx +7 -0
  490. package/templates/starter/src/app/starter-performance-test-utils.ts +275 -0
  491. package/templates/starter/src/app/starter-performance.budgets.test.ts +374 -0
  492. package/templates/starter/src/app/starter-performance.gates.test.ts +128 -0
  493. package/templates/starter/src/app/starter-performance.renderer-source.test.ts +136 -0
  494. package/templates/starter/src/app/starter-performance.renderer-technique.test.ts +291 -0
  495. package/templates/starter/src/app/starter-performance.scenarios.test.ts +355 -0
  496. package/templates/starter/src/app/test-evidence/browser-runtime-contract.test.ts +253 -0
  497. package/templates/starter/src/app/test-evidence/browser-runtime-contract.ts +243 -0
  498. package/templates/starter/src/routes/index.tsx +11 -2
  499. package/templates/starter/vite.config.ts +8 -0
  500. package/templates/ui/components/controls/color/color-control-types.ts +38 -0
  501. package/templates/ui/components/controls/color/color-control.tsx +19 -437
  502. package/templates/ui/components/controls/color/color-footer.tsx +272 -0
  503. package/templates/ui/components/controls/color/color-model-slider.tsx +271 -0
  504. package/templates/ui/components/controls/color/color-opacity-input.tsx +94 -0
  505. package/templates/ui/components/controls/color/color-surface.tsx +194 -0
  506. package/templates/ui/components/controls/color/color-value-control.tsx +159 -0
  507. package/templates/ui/components/controls/color/color-value-utils.ts +170 -0
  508. package/templates/ui/components/controls/color/index.ts +10 -3
  509. package/templates/ui/components/controls/color/palette-control-controller.ts +407 -0
  510. package/templates/ui/components/controls/color/palette-control-layout.ts +14 -0
  511. package/templates/ui/components/controls/color/palette-control-types.ts +50 -0
  512. package/templates/ui/components/controls/color/palette-control-view.tsx +174 -0
  513. package/templates/ui/components/controls/color/palette-control.tsx +6 -544
  514. package/templates/ui/components/controls/color/style-guide-color-picker-color-utils.ts +39 -0
  515. package/templates/ui/components/controls/color/style-guide-color-picker-controller.ts +370 -0
  516. package/templates/ui/components/controls/color/style-guide-color-picker-hue-handlers.ts +66 -0
  517. package/templates/ui/components/controls/color/style-guide-color-picker-interaction-state.ts +49 -0
  518. package/templates/ui/components/controls/color/style-guide-color-picker-interactions.ts +2 -2
  519. package/templates/ui/components/controls/color/style-guide-color-picker-model.ts +125 -0
  520. package/templates/ui/components/controls/color/style-guide-color-picker-parts.tsx +10 -707
  521. package/templates/ui/components/controls/color/style-guide-color-picker-surface-drag.ts +93 -0
  522. package/templates/ui/components/controls/color/style-guide-color-picker-surface-geometry.ts +114 -0
  523. package/templates/ui/components/controls/color/style-guide-color-picker-surface-preview.ts +45 -0
  524. package/templates/ui/components/controls/color/style-guide-color-picker-types.ts +84 -0
  525. package/templates/ui/components/controls/color/style-guide-color-picker-view.tsx +69 -0
  526. package/templates/ui/components/controls/color/style-guide-color-picker.tsx +6 -495
  527. package/templates/ui/components/controls/curves/curves-control.tsx +4 -3
  528. package/templates/ui/components/controls/file-drop/file-drop-control.tsx +39 -515
  529. package/templates/ui/components/controls/file-drop/file-drop-empty-state.tsx +35 -0
  530. package/templates/ui/components/controls/file-drop/file-drop-file-list.tsx +160 -0
  531. package/templates/ui/components/controls/file-drop/file-drop-image-grid.tsx +175 -0
  532. package/templates/ui/components/controls/file-drop/file-drop-model.tsx +170 -0
  533. package/templates/ui/components/controls/file-drop/file-drop-single-preview.tsx +63 -0
  534. package/templates/ui/components/controls/file-drop/file-drop-types.ts +48 -0
  535. package/templates/ui/components/controls/file-drop/index.ts +2 -2
  536. package/templates/ui/components/controls/font-picker/font-picker-control.tsx +133 -906
  537. package/templates/ui/components/controls/font-picker/font-picker-footer.tsx +116 -0
  538. package/templates/ui/components/controls/font-picker/font-picker-list.tsx +194 -0
  539. package/templates/ui/components/controls/font-picker/font-picker-popover-content.tsx +191 -0
  540. package/templates/ui/components/controls/font-picker/font-picker-value.ts +222 -0
  541. package/templates/ui/components/controls/font-picker/index.ts +4 -1
  542. package/templates/ui/components/controls/font-picker/use-font-picker-preview-pipeline.ts +163 -0
  543. package/templates/ui/components/controls/font-picker/use-font-picker-virtual-list.ts +293 -0
  544. package/templates/ui/components/controls/gradient/gradient-control-utils.ts +2 -25
  545. package/templates/ui/components/controls/gradient/gradient-control.tsx +4 -464
  546. package/templates/ui/components/controls/gradient/gradient-stops-controller.ts +332 -0
  547. package/templates/ui/components/controls/gradient/gradient-stops-track.tsx +159 -0
  548. package/templates/ui/components/controls/vector/vector-control-types.ts +26 -0
  549. package/templates/ui/components/controls/vector/vector-control.tsx +10 -486
  550. package/templates/ui/components/controls/vector/vector-pad-field.tsx +211 -0
  551. package/templates/ui/components/controls/vector/vector-pad-geometry.ts +61 -0
  552. package/templates/ui/components/controls/vector/vector-pad-parts.tsx +72 -0
  553. package/templates/ui/components/controls/vector/vector-pad-variants.ts +20 -0
  554. package/templates/ui/components/controls/vector/vector-size-field.tsx +104 -0
  555. package/templates/ui/components/controls/vector/vector-value.ts +46 -0
  556. package/templates/ui/components/primitives/slider/slider-discrete-state.ts +181 -0
  557. package/templates/ui/components/primitives/slider/slider-marker-policy.ts +52 -0
  558. package/templates/ui/components/primitives/slider/slider-pointer-dragging.ts +87 -0
  559. package/templates/ui/components/primitives/slider/slider-runtime.ts +109 -0
  560. package/templates/ui/components/primitives/slider/slider-types.ts +21 -0
  561. package/templates/ui/components/primitives/slider/slider.tsx +2 -403
  562. package/templates/runtime/react/canvas-shell.test.tsx +0 -554
  563. package/templates/runtime/react/canvas-shell.tsx +0 -585
  564. package/templates/runtime/react/controls-panel.test.tsx +0 -5446
  565. package/templates/runtime/react/controls-panel.tsx +0 -3220
  566. package/templates/runtime/react/layers-panel.test.tsx +0 -487
  567. package/templates/runtime/react/layers-panel.tsx +0 -1348
  568. package/templates/runtime/react/timeline-panel.test.tsx +0 -751
  569. package/templates/runtime/react/timeline-panel.tsx +0 -3078
  570. package/templates/runtime/schema/define-toolcraft.test.ts +0 -1742
  571. package/templates/runtime/state/reducer.test.ts +0 -1703
  572. package/templates/runtime/testing/performance.test.ts +0 -3081
  573. package/templates/starter/e2e/app-browser-acceptance.spec.ts +0 -785
  574. package/templates/starter/src/app/starter-acceptance.test.ts +0 -10067
  575. package/templates/starter/src/app/starter-performance.test.ts +0 -1583
  576. package/templates/ui/components/controls/color/style-guide-color-picker-logic.ts +0 -490
  577. /package/templates/runtime/react/{storage-key-migration.ts → app-shell/storage-key-migration.ts} +0 -0
  578. /package/templates/runtime/react/{theme-runtime.tsx → app-shell/theme-runtime.tsx} +0 -0
  579. /package/templates/runtime/react/{curve-geometry.test.ts → controls-panel/__tests__/curve-geometry.test.ts} +0 -0
  580. /package/templates/runtime/react/{panel-host-config.ts → panel-host/panel-host-config.ts} +0 -0
  581. /package/templates/runtime/react/{panel-host-geometry.test.ts → panel-host/panel-host-geometry.test.ts} +0 -0
  582. /package/templates/runtime/react/{panel-host-geometry.ts → panel-host/panel-host-geometry.ts} +0 -0
@@ -1,1703 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
-
3
- import { defineToolcraft } from "../schema/define-toolcraft";
4
- import type { ToolcraftInitialState } from "./types";
5
- import { createToolcraftState } from "./create-template-state";
6
- import { toolcraftReducer } from "./reducer";
7
-
8
- function createState(initialState?: ToolcraftInitialState) {
9
- const app = defineToolcraft({
10
- canvas: {
11
- enabled: true,
12
- size: { width: 1024, height: 768, unit: "px" },
13
- },
14
- panels: {
15
- controls: {
16
- sections: [
17
- {
18
- controls: {
19
- opacity: {
20
- defaultValue: 75,
21
- target: "selectedLayer.opacity",
22
- type: "slider",
23
- },
24
- },
25
- },
26
- ],
27
- title: "Controls",
28
- },
29
- },
30
- });
31
-
32
- return createToolcraftState(app, initialState);
33
- }
34
-
35
- describe("toolcraftReducer", () => {
36
- it("resets controls to defaults and records history", () => {
37
- const changed = toolcraftReducer(createState(), {
38
- target: "selectedLayer.opacity",
39
- type: "controls.setValue",
40
- value: 12,
41
- });
42
-
43
- const state = toolcraftReducer(changed, { type: "controls.reset" });
44
-
45
- expect(state.values["selectedLayer.opacity"]).toBe(75);
46
- expect(state.history.undo.at(-1)?.label).toBe("Reset controls");
47
- });
48
-
49
- it("resets selected control targets to defaults and records one history patch", () => {
50
- const app = defineToolcraft({
51
- canvas: { enabled: false },
52
- panels: {
53
- controls: {
54
- sections: [
55
- {
56
- controls: {
57
- contrast: {
58
- defaultValue: 22,
59
- target: "style.contrast",
60
- type: "slider",
61
- },
62
- opacity: {
63
- defaultValue: 75,
64
- target: "selectedLayer.opacity",
65
- type: "slider",
66
- },
67
- },
68
- title: "Tone",
69
- },
70
- ],
71
- title: "Controls",
72
- },
73
- },
74
- });
75
- const changedOpacity = toolcraftReducer(createToolcraftState(app), {
76
- target: "selectedLayer.opacity",
77
- type: "controls.setValue",
78
- value: 12,
79
- });
80
- const changedBoth = toolcraftReducer(changedOpacity, {
81
- target: "style.contrast",
82
- type: "controls.setValue",
83
- value: 9,
84
- });
85
-
86
- const state = toolcraftReducer(changedBoth, {
87
- label: "Reset Tone section",
88
- targets: ["selectedLayer.opacity"],
89
- type: "controls.resetTargets",
90
- });
91
-
92
- expect(state.values["selectedLayer.opacity"]).toBe(75);
93
- expect(state.values["style.contrast"]).toBe(9);
94
- expect(state.history.undo).toHaveLength(3);
95
- expect(state.history.undo.at(-1)).toMatchObject({
96
- after: { "selectedLayer.opacity": 75 },
97
- before: { "selectedLayer.opacity": 12 },
98
- label: "Reset Tone section",
99
- });
100
- });
101
-
102
- it("clears single-layer fileDrop media on global reset", () => {
103
- const app = defineToolcraft({
104
- canvas: { enabled: true, upload: true },
105
- panels: {
106
- controls: {
107
- sections: [
108
- {
109
- controls: {
110
- source: {
111
- defaultValue: null,
112
- target: "media.source",
113
- type: "fileDrop",
114
- },
115
- },
116
- title: "Source",
117
- },
118
- ],
119
- title: "Controls",
120
- },
121
- },
122
- });
123
- const imported = toolcraftReducer(createToolcraftState(app), {
124
- asset: {
125
- dataUrl: "data:image/png;base64,test",
126
- fileName: "source.png",
127
- mimeType: "image/png",
128
- position: { x: 0, y: 0 },
129
- size: { height: 768, unit: "px", width: 1024 },
130
- sourceTarget: "media.source",
131
- },
132
- type: "media.import",
133
- });
134
-
135
- const state = toolcraftReducer(imported, { type: "controls.reset" });
136
- const undone = toolcraftReducer(state, { type: "history.undo" });
137
- const redone = toolcraftReducer(undone, { type: "history.redo" });
138
-
139
- expect(imported.mediaAssets).toHaveLength(1);
140
- expect(state.mediaAssets).toEqual([]);
141
- expect(state.values["media.source"]).toBeNull();
142
- expect(undone.mediaAssets).toEqual(imported.mediaAssets);
143
- expect(redone.mediaAssets).toEqual([]);
144
- expect(state.history.undo.at(-1)).toMatchObject({
145
- after: { mediaAssets: [] },
146
- before: { mediaAssets: imported.mediaAssets },
147
- label: "Reset controls",
148
- });
149
- });
150
-
151
- it("restores predefined fileDrop media on global and section reset", () => {
152
- const app = defineToolcraft({
153
- canvas: { enabled: true, upload: true },
154
- media: {
155
- defaultAssets: [
156
- {
157
- dataUrl: "data:image/png;base64,AAAA",
158
- fileName: "default-background.png",
159
- id: "default-background",
160
- layerId: "default-background-layer",
161
- mimeType: "image/png",
162
- size: { height: 1080, unit: "px", width: 1920 },
163
- sourceTarget: "media.background",
164
- },
165
- ],
166
- },
167
- panels: {
168
- controls: {
169
- sections: [
170
- {
171
- controls: {
172
- background: {
173
- defaultValue: null,
174
- target: "media.background",
175
- type: "fileDrop",
176
- },
177
- },
178
- title: "Background",
179
- },
180
- ],
181
- title: "Controls",
182
- },
183
- },
184
- });
185
- const initial = createToolcraftState(app);
186
- const deleted = toolcraftReducer(initial, {
187
- mediaId: "default-background",
188
- type: "media.delete",
189
- });
190
- const sectionReset = toolcraftReducer(deleted, {
191
- label: "Reset Background section",
192
- targets: ["media.background"],
193
- type: "controls.resetTargets",
194
- });
195
- const deletedAgain = toolcraftReducer(sectionReset, {
196
- mediaId: "default-background",
197
- type: "media.delete",
198
- });
199
- const globalReset = toolcraftReducer(deletedAgain, { type: "controls.reset" });
200
-
201
- expect(initial.mediaAssets.map((asset) => asset.id)).toEqual(["default-background"]);
202
- expect(deleted.mediaAssets).toEqual([]);
203
- expect(sectionReset.mediaAssets.map((asset) => asset.id)).toEqual([
204
- "default-background",
205
- ]);
206
- expect(sectionReset.layers.map((layer) => layer.id)).toEqual([
207
- "default-background-layer",
208
- ]);
209
- expect(sectionReset.selectedLayerId).toBe("default-background-layer");
210
- expect(globalReset.mediaAssets.map((asset) => asset.id)).toEqual([
211
- "default-background",
212
- ]);
213
- });
214
-
215
- it("stores arbitrary fileDrop media without image dimensions and clears it on reset", () => {
216
- const app = defineToolcraft({
217
- canvas: { enabled: true, upload: true },
218
- panels: {
219
- controls: {
220
- sections: [
221
- {
222
- controls: {
223
- source: {
224
- assetKind: "file",
225
- defaultValue: null,
226
- target: "files.source",
227
- type: "fileDrop",
228
- },
229
- },
230
- title: "Files",
231
- },
232
- ],
233
- title: "Controls",
234
- },
235
- },
236
- });
237
- const imported = toolcraftReducer(createToolcraftState(app), {
238
- asset: {
239
- assetKind: "file",
240
- dataUrl: "data:text/plain;base64,aGVsbG8=",
241
- fileName: "notes.txt",
242
- mimeType: "text/plain",
243
- position: { x: 0, y: 0 },
244
- sourceTarget: "files.source",
245
- },
246
- type: "media.import",
247
- });
248
-
249
- const state = toolcraftReducer(imported, { type: "controls.reset" });
250
-
251
- expect(imported.mediaAssets).toHaveLength(1);
252
- expect(imported.mediaAssets[0]).toMatchObject({
253
- assetKind: "file",
254
- fileName: "notes.txt",
255
- sourceTarget: "files.source",
256
- });
257
- expect(imported.mediaAssets[0]?.size).toBeUndefined();
258
- expect(imported.canvas.size).toEqual(createToolcraftState(app).canvas.size);
259
- expect(state.mediaAssets).toEqual([]);
260
- });
261
-
262
- it("records image media rotate and flip transforms in runtime history", () => {
263
- const imported = toolcraftReducer(createState(), {
264
- asset: {
265
- assetKind: "image",
266
- dataUrl: "data:image/png;base64,test",
267
- fileName: "source.png",
268
- mimeType: "image/png",
269
- position: { x: 0, y: 0 },
270
- size: { height: 768, unit: "px", width: 1024 },
271
- },
272
- type: "media.import",
273
- });
274
-
275
- const rotated = toolcraftReducer(imported, {
276
- mediaId: imported.mediaAssets[0]?.id ?? "",
277
- operation: "rotate-right",
278
- type: "media.transform",
279
- });
280
- const flipped = toolcraftReducer(rotated, {
281
- mediaId: imported.mediaAssets[0]?.id ?? "",
282
- operation: "flip-horizontal",
283
- type: "media.transform",
284
- });
285
- const undone = toolcraftReducer(flipped, { type: "history.undo" });
286
-
287
- expect(rotated.mediaAssets[0]?.transform).toEqual({ rotationDeg: 90 });
288
- expect(flipped.mediaAssets[0]?.transform).toEqual({
289
- flipHorizontal: true,
290
- rotationDeg: 90,
291
- });
292
- expect(flipped.history.undo.at(-1)).toMatchObject({
293
- before: { mediaAssets: rotated.mediaAssets },
294
- label: "Transform media",
295
- });
296
- expect(undone.mediaAssets[0]?.transform).toEqual({ rotationDeg: 90 });
297
- });
298
-
299
- it("ignores image transforms for arbitrary file media", () => {
300
- const imported = toolcraftReducer(createState(), {
301
- asset: {
302
- assetKind: "file",
303
- dataUrl: "data:text/plain;base64,aGVsbG8=",
304
- fileName: "notes.txt",
305
- mimeType: "text/plain",
306
- position: { x: 0, y: 0 },
307
- },
308
- type: "media.import",
309
- });
310
-
311
- const transformed = toolcraftReducer(imported, {
312
- mediaId: imported.mediaAssets[0]?.id ?? "",
313
- operation: "rotate-right",
314
- type: "media.transform",
315
- });
316
-
317
- expect(transformed).toBe(imported);
318
- });
319
-
320
- it("clears only selected fileDrop media on section reset", () => {
321
- const app = defineToolcraft({
322
- canvas: { enabled: true, upload: true },
323
- panels: {
324
- controls: {
325
- sections: [
326
- {
327
- controls: {
328
- primary: {
329
- defaultValue: null,
330
- target: "media.primary",
331
- type: "fileDrop",
332
- },
333
- secondary: {
334
- defaultValue: null,
335
- target: "media.secondary",
336
- type: "fileDrop",
337
- },
338
- },
339
- title: "Sources",
340
- },
341
- ],
342
- title: "Controls",
343
- },
344
- },
345
- });
346
- const first = toolcraftReducer(createToolcraftState(app), {
347
- asset: {
348
- dataUrl: "data:image/png;base64,primary",
349
- fileName: "primary.png",
350
- mimeType: "image/png",
351
- position: { x: 0, y: 0 },
352
- size: { height: 768, unit: "px", width: 1024 },
353
- sourceTarget: "media.primary",
354
- },
355
- replaceExisting: false,
356
- type: "media.import",
357
- });
358
- const second = toolcraftReducer(first, {
359
- asset: {
360
- dataUrl: "data:image/png;base64,secondary",
361
- fileName: "secondary.png",
362
- mimeType: "image/png",
363
- position: { x: 0, y: 0 },
364
- size: { height: 768, unit: "px", width: 1024 },
365
- sourceTarget: "media.secondary",
366
- },
367
- replaceExisting: false,
368
- type: "media.import",
369
- });
370
-
371
- const state = toolcraftReducer(second, {
372
- label: "Reset Primary section",
373
- targets: ["media.primary"],
374
- type: "controls.resetTargets",
375
- });
376
-
377
- expect(state.mediaAssets).toHaveLength(1);
378
- expect(state.mediaAssets[0]?.fileName).toBe("secondary.png");
379
- expect(state.history.undo.at(-1)).toMatchObject({
380
- after: { mediaAssets: state.mediaAssets },
381
- before: { mediaAssets: second.mediaAssets },
382
- label: "Reset Primary section",
383
- });
384
- });
385
-
386
- it("keeps layer-owned media on global reset", () => {
387
- const app = defineToolcraft({
388
- canvas: { enabled: true, upload: true },
389
- panels: {
390
- controls: {
391
- sections: [
392
- {
393
- controls: {
394
- source: {
395
- defaultValue: null,
396
- target: "media.source",
397
- type: "fileDrop",
398
- },
399
- },
400
- title: "Source",
401
- },
402
- ],
403
- title: "Controls",
404
- },
405
- layers: true,
406
- },
407
- });
408
- const imported = toolcraftReducer(createToolcraftState(app), {
409
- asset: {
410
- dataUrl: "data:image/png;base64,test",
411
- fileName: "source.png",
412
- mimeType: "image/png",
413
- position: { x: 0, y: 0 },
414
- size: { height: 768, unit: "px", width: 1024 },
415
- sourceTarget: "media.source",
416
- },
417
- type: "media.import",
418
- });
419
-
420
- const state = toolcraftReducer(imported, { type: "controls.reset" });
421
-
422
- expect(state.mediaAssets).toEqual(imported.mediaAssets);
423
- });
424
-
425
- it("updates canvas size and records history", () => {
426
- const size = { width: 1200, height: 900, unit: "px" } as const;
427
-
428
- const state = toolcraftReducer(createState(), {
429
- size,
430
- type: "canvas.setSize",
431
- });
432
-
433
- expect(state.canvas.size).toEqual(size);
434
- expect(state.history.undo.at(-1)?.label).toBe("Resize canvas");
435
- });
436
-
437
- it("preserves app-chosen canvas size changes below the app shell minimum", () => {
438
- const state = toolcraftReducer(createState(), {
439
- size: { width: 640, height: 900, unit: "px" },
440
- type: "canvas.setSize",
441
- });
442
-
443
- expect(state.canvas.size).toEqual({ width: 640, height: 900, unit: "px" });
444
- expect(state.history.undo.at(-1)?.after).toEqual({
445
- "canvas.size": { width: 640, height: 900, unit: "px" },
446
- });
447
- });
448
-
449
- it("routes canvas size control targets through canvas runtime state", () => {
450
- const app = defineToolcraft({
451
- canvas: {
452
- enabled: true,
453
- size: { width: 1200, height: 768, unit: "px" },
454
- },
455
- panels: {
456
- controls: {
457
- sections: [
458
- {
459
- controls: {
460
- width: {
461
- defaultValue: 1200,
462
- target: "canvas.size.width",
463
- type: "text",
464
- },
465
- },
466
- },
467
- ],
468
- title: "Controls",
469
- },
470
- },
471
- });
472
-
473
- const changed = toolcraftReducer(createToolcraftState(app), {
474
- target: "canvas.size.width",
475
- type: "controls.setValue",
476
- value: "640",
477
- });
478
- const reset = toolcraftReducer(changed, { type: "controls.reset" });
479
- const undone = toolcraftReducer(changed, { type: "history.undo" });
480
- const redone = toolcraftReducer(undone, { type: "history.redo" });
481
-
482
- expect(changed.canvas.size.width).toBe(640);
483
- expect(changed.canvas.size.height).toBe(768);
484
- expect(changed.values["canvas.aspectRatio"]).toEqual({
485
- height: 6,
486
- mode: "custom",
487
- value: "5:6",
488
- width: 5,
489
- });
490
- expect(changed.values["canvas.size.width"]).toBe(640);
491
- expect(changed.values["canvas.size.height"]).toBe(768);
492
- expect(changed.history.undo.at(-1)?.label).toBe("canvas.size.width");
493
- expect(reset.canvas.size.width).toBe(1200);
494
- expect(reset.canvas.size.height).toBe(768);
495
- expect(reset.values["canvas.size.width"]).toBe(1200);
496
- expect(reset.values["canvas.size.height"]).toBe(768);
497
- expect(reset.history.undo.at(-1)?.label).toBe("Reset controls");
498
- expect(undone.canvas.size.width).toBe(1200);
499
- expect(undone.canvas.size.height).toBe(768);
500
- expect(redone.canvas.size.width).toBe(640);
501
- expect(redone.canvas.size.height).toBe(768);
502
- });
503
-
504
- it("routes canvas aspect ratio presets through canvas runtime state", () => {
505
- const state = createState();
506
-
507
- const changed = toolcraftReducer(state, {
508
- target: "canvas.aspectRatio",
509
- type: "controls.setValue",
510
- value: {
511
- height: 9,
512
- mode: "preset",
513
- value: "16:9",
514
- width: 16,
515
- },
516
- });
517
-
518
- expect(changed.canvas.size).toEqual({ height: 1080, unit: "px", width: 1920 });
519
- expect(changed.values["canvas.aspectRatio"]).toEqual({
520
- height: 9,
521
- mode: "preset",
522
- value: "16:9",
523
- width: 16,
524
- });
525
- expect(changed.values["canvas.size.width"]).toBe(1920);
526
- expect(changed.values["canvas.size.height"]).toBe(1080);
527
- expect(changed.history.undo.at(-1)?.label).toBe("canvas.aspectRatio");
528
- });
529
-
530
- it("turns manual canvas size edits into a custom aspect ratio", () => {
531
- const state = toolcraftReducer(createState(), {
532
- target: "canvas.aspectRatio",
533
- type: "controls.setValue",
534
- value: {
535
- height: 9,
536
- mode: "preset",
537
- value: "16:9",
538
- width: 16,
539
- },
540
- });
541
-
542
- const changed = toolcraftReducer(state, {
543
- target: "canvas.size.height",
544
- type: "controls.setValue",
545
- value: "720",
546
- });
547
-
548
- expect(changed.canvas.size).toEqual({ height: 720, unit: "px", width: 1920 });
549
- expect(changed.values["canvas.aspectRatio"]).toEqual({
550
- height: 3,
551
- mode: "custom",
552
- value: "8:3",
553
- width: 8,
554
- });
555
- expect(changed.values["canvas.size.height"]).toBe(720);
556
- expect(changed.values["canvas.size.width"]).toBe(1920);
557
- });
558
-
559
- it("keeps repeated canvas size values as no-op without changing aspect ratio mode", () => {
560
- const app = defineToolcraft({
561
- canvas: {
562
- enabled: true,
563
- size: { height: 1080, unit: "px", width: 1920 },
564
- sizing: { mode: "editable-output" },
565
- },
566
- panels: {
567
- controls: {
568
- sections: [],
569
- title: "Controls",
570
- },
571
- },
572
- });
573
- const state = createToolcraftState(app);
574
-
575
- const unchanged = toolcraftReducer(state, {
576
- target: "canvas.size.width",
577
- type: "controls.setValue",
578
- value: "1920",
579
- });
580
-
581
- expect(unchanged).toBe(state);
582
- expect(unchanged.values["canvas.aspectRatio"]).toEqual({
583
- height: 9,
584
- mode: "preset",
585
- value: "16:9",
586
- width: 16,
587
- });
588
- expect(unchanged.history.undo).toEqual([]);
589
- });
590
-
591
- it("updates canvas offset without recording history", () => {
592
- const state = createState();
593
-
594
- const next = toolcraftReducer(state, {
595
- offset: { x: 12, y: -8 },
596
- type: "canvas.setOffset",
597
- });
598
-
599
- expect(next.canvas.offset).toEqual({ x: 12, y: -8 });
600
- expect(next.history.undo).toHaveLength(0);
601
- });
602
-
603
- it("pans canvas by a delta", () => {
604
- const moved = toolcraftReducer(createState(), {
605
- offset: { x: 12, y: -8 },
606
- type: "canvas.setOffset",
607
- });
608
-
609
- const next = toolcraftReducer(moved, {
610
- delta: { x: 3, y: 10 },
611
- type: "canvas.panBy",
612
- });
613
-
614
- expect(next.canvas.offset).toEqual({ x: 15, y: 2 });
615
- });
616
-
617
- it("undoes canvas size changes", () => {
618
- const changed = toolcraftReducer(createState(), {
619
- size: { width: 1200, height: 900, unit: "px" },
620
- type: "canvas.setSize",
621
- });
622
-
623
- const state = toolcraftReducer(changed, { type: "history.undo" });
624
-
625
- expect(state.canvas.size).toEqual({ width: 1024, height: 768, unit: "px" });
626
- expect(state.values).not.toHaveProperty("canvas.size");
627
- });
628
-
629
- it("redoes canvas size changes", () => {
630
- const changed = toolcraftReducer(createState(), {
631
- size: { width: 1200, height: 900, unit: "px" },
632
- type: "canvas.setSize",
633
- });
634
-
635
- const undone = toolcraftReducer(changed, { type: "history.undo" });
636
- const state = toolcraftReducer(undone, { type: "history.redo" });
637
-
638
- expect(state.canvas.size).toEqual({ width: 1200, height: 900, unit: "px" });
639
- expect(state.values).not.toHaveProperty("canvas.size");
640
- });
641
-
642
- it("zooms in, out, and resets", () => {
643
- let state = createState();
644
-
645
- state = toolcraftReducer(state, { type: "canvas.zoomOut" });
646
- state = toolcraftReducer(state, { type: "canvas.zoomOut" });
647
- state = toolcraftReducer(state, { type: "canvas.zoomIn" });
648
-
649
- expect(state.canvas.zoom).toBe(90);
650
-
651
- state = toolcraftReducer(state, { type: "canvas.zoomReset" });
652
-
653
- expect(state.canvas.zoom).toBe(100);
654
- });
655
-
656
- it("sets viewport zoom and offset for gesture zoom", () => {
657
- const state = toolcraftReducer(createState(), {
658
- offset: { x: -100, y: 24 },
659
- type: "canvas.setViewport",
660
- zoom: 999,
661
- });
662
-
663
- expect(state.canvas.offset).toEqual({ x: -100, y: 24 });
664
- expect(state.canvas.zoom).toBe(400);
665
- });
666
-
667
- it("updates panel offsets without changing control values", () => {
668
- const state = createState();
669
-
670
- const next = toolcraftReducer(state, {
671
- offset: { x: 24, y: -12 },
672
- panelId: "controls",
673
- type: "panels.setOffset",
674
- });
675
-
676
- expect(next.panels.controls.offset).toEqual({ x: 24, y: -12 });
677
- expect(next.values).toBe(state.values);
678
- });
679
-
680
- it("stores timeline extended presentation outside control values", () => {
681
- const state = createState();
682
-
683
- const extended = toolcraftReducer(state, {
684
- target: "panels.timeline.extended",
685
- type: "controls.setValue",
686
- value: true,
687
- });
688
-
689
- expect(extended.panels.timeline.extended).toBe(true);
690
- expect(extended.values).toBe(state.values);
691
- expect(extended.history).toBe(state.history);
692
-
693
- const compact = toolcraftReducer(extended, {
694
- target: "panels.timeline.extended",
695
- type: "controls.setValue",
696
- value: false,
697
- });
698
-
699
- expect(compact.panels.timeline.extended).toBe(false);
700
- expect(compact.values).toBe(state.values);
701
- });
702
-
703
- it("keeps legacy timeline panel visibility outside control values", () => {
704
- const state = createState();
705
-
706
- const hidden = toolcraftReducer(state, {
707
- target: "panels.timeline.visible",
708
- type: "controls.setValue",
709
- value: false,
710
- });
711
-
712
- expect(hidden.panels.timeline.hidden).toBe(true);
713
- expect(hidden.values).toBe(state.values);
714
- expect(hidden.history).toBe(state.history);
715
-
716
- const shown = toolcraftReducer(hidden, {
717
- hidden: false,
718
- panelId: "timeline",
719
- type: "panels.setHidden",
720
- });
721
-
722
- expect(shown.panels.timeline.hidden).toBe(false);
723
- expect(shown.values).toBe(state.values);
724
- });
725
-
726
- it("resets a panel offset to its default position", () => {
727
- const moved = toolcraftReducer(createState(), {
728
- offset: { x: 40, y: 80 },
729
- panelId: "controls",
730
- type: "panels.setOffset",
731
- });
732
-
733
- const next = toolcraftReducer(moved, {
734
- panelId: "controls",
735
- type: "panels.resetOffset",
736
- });
737
-
738
- expect(next.panels.controls.offset).toEqual({ x: 0, y: 0 });
739
- });
740
-
741
- it("imports media as an editable-canvas-sized layer and records history", () => {
742
- const state = createState();
743
-
744
- const next = toolcraftReducer(state, {
745
- asset: {
746
- dataUrl: "data:image/png;base64,test",
747
- fileName: "material.png",
748
- mimeType: "image/png",
749
- position: { x: 10, y: 20 },
750
- size: state.canvas.size,
751
- },
752
- type: "media.import",
753
- });
754
-
755
- expect(next.layers).toEqual([
756
- {
757
- displayName: "material",
758
- id: "layer-1",
759
- kind: "layer",
760
- name: "material",
761
- visible: true,
762
- },
763
- ]);
764
- expect(next.mediaAssets).toEqual([
765
- {
766
- dataUrl: "data:image/png;base64,test",
767
- fileName: "material.png",
768
- id: "media-1",
769
- layerId: "layer-1",
770
- mimeType: "image/png",
771
- position: { x: 10, y: 20 },
772
- size: state.canvas.size,
773
- },
774
- ]);
775
- expect(next.selectedLayerId).toBe("layer-1");
776
- expect(next.history.undo.at(-1)?.label).toBe("Import media");
777
- });
778
-
779
- it("deletes imported media without deleting the owning layer", () => {
780
- const state = toolcraftReducer(createState(), {
781
- asset: {
782
- dataUrl: "data:image/png;base64,test",
783
- fileName: "material.png",
784
- mimeType: "image/png",
785
- position: { x: 10, y: 20 },
786
- size: { height: 512, unit: "px", width: 512 },
787
- },
788
- type: "media.import",
789
- });
790
-
791
- const next = toolcraftReducer(state, {
792
- mediaId: "media-1",
793
- type: "media.delete",
794
- });
795
-
796
- expect(next.layers).toEqual(state.layers);
797
- expect(next.selectedLayerId).toBe("layer-1");
798
- expect(next.mediaAssets).toEqual([]);
799
- expect(next.history.undo.at(-1)?.label).toBe("Delete media");
800
- });
801
-
802
- it("keeps the current editable-output canvas size when importing background/source images", () => {
803
- const app = defineToolcraft({
804
- canvas: {
805
- enabled: true,
806
- size: { height: 720, unit: "px", width: 1280 },
807
- upload: true,
808
- },
809
- panels: {},
810
- });
811
- const state = createToolcraftState(app);
812
- const imported = toolcraftReducer(state, {
813
- asset: {
814
- dataUrl: "data:image/png;base64,wide",
815
- fileName: "wide-source.png",
816
- mimeType: "image/png",
817
- position: { x: 42, y: 24 },
818
- size: { height: 1000, unit: "px", width: 4000 },
819
- },
820
- type: "media.import",
821
- });
822
-
823
- expect(imported.schema.canvas.sizing).toEqual({ mode: "editable-output" });
824
- expect(imported.canvas.size).toEqual({ height: 720, unit: "px", width: 1280 });
825
- expect(imported.mediaAssets[0]).toMatchObject({
826
- fileName: "wide-source.png",
827
- position: { x: 42, y: 24 },
828
- size: { height: 1000, unit: "px", width: 4000 },
829
- });
830
- expect(imported.history.undo.at(-1)?.after).not.toHaveProperty("canvas.size");
831
- });
832
-
833
- it("keeps manually edited editable-output canvas size when importing source images", () => {
834
- const app = defineToolcraft({
835
- canvas: {
836
- enabled: true,
837
- upload: true,
838
- },
839
- panels: {
840
- controls: {
841
- sections: [],
842
- title: "Controls",
843
- },
844
- },
845
- });
846
- const widthChanged = toolcraftReducer(createToolcraftState(app), {
847
- target: "canvas.size.width",
848
- type: "controls.setValue",
849
- value: "1440",
850
- });
851
- const heightChanged = toolcraftReducer(widthChanged, {
852
- target: "canvas.size.height",
853
- type: "controls.setValue",
854
- value: "900",
855
- });
856
- const imported = toolcraftReducer(heightChanged, {
857
- asset: {
858
- dataUrl: "data:image/png;base64,tall",
859
- fileName: "tall-source.png",
860
- mimeType: "image/png",
861
- position: { x: 0, y: 0 },
862
- size: { height: 4000, unit: "px", width: 1000 },
863
- },
864
- type: "media.import",
865
- });
866
-
867
- expect(imported.schema.canvas.sizing).toEqual({ mode: "editable-output" });
868
- expect(imported.canvas.size).toEqual({ height: 900, unit: "px", width: 1440 });
869
- expect(imported.values["canvas.size.width"]).toBe(1440);
870
- expect(imported.values["canvas.size.height"]).toBe(900);
871
- expect(imported.mediaAssets[0]).toMatchObject({
872
- fileName: "tall-source.png",
873
- size: { height: 4000, unit: "px", width: 1000 },
874
- });
875
- expect(imported.history.undo.at(-1)?.after).not.toHaveProperty("canvas.size");
876
- });
877
-
878
- it("sizes explicit intrinsic media apps from the imported image and replaces single-layer media", () => {
879
- const app = defineToolcraft({
880
- canvas: { enabled: true, sizing: { mode: "intrinsic-media" }, upload: true },
881
- panels: {},
882
- });
883
- const state = createToolcraftState(app);
884
- const first = toolcraftReducer(state, {
885
- asset: {
886
- dataUrl: "data:image/png;base64,first",
887
- fileName: "first.png",
888
- mimeType: "image/png",
889
- position: { x: 42, y: 24 },
890
- size: { height: 600, unit: "px", width: 800 },
891
- },
892
- type: "media.import",
893
- });
894
- const second = toolcraftReducer(first, {
895
- asset: {
896
- dataUrl: "data:image/png;base64,second",
897
- fileName: "second.png",
898
- mimeType: "image/png",
899
- position: { x: -20, y: 10 },
900
- size: { height: 720, unit: "px", width: 1280 },
901
- },
902
- type: "media.import",
903
- });
904
-
905
- expect(first.canvas.size).toEqual({ height: 600, unit: "px", width: 800 });
906
- expect(first.mediaAssets[0]).toMatchObject({
907
- fileName: "first.png",
908
- position: { x: 0, y: 0 },
909
- size: { height: 600, unit: "px", width: 800 },
910
- });
911
- expect(first.history.undo.at(-1)?.after).toMatchObject({
912
- "canvas.size": { height: 600, unit: "px", width: 800 },
913
- });
914
- expect(second.canvas.size).toEqual({ height: 720, unit: "px", width: 1280 });
915
- expect(second.layers).toHaveLength(1);
916
- expect(second.mediaAssets).toHaveLength(1);
917
- expect(second.mediaAssets[0]).toMatchObject({
918
- fileName: "second.png",
919
- id: "media-1",
920
- layerId: "layer-1",
921
- position: { x: 0, y: 0 },
922
- size: { height: 720, unit: "px", width: 1280 },
923
- });
924
- });
925
-
926
- it("appends single-layer media when import is explicitly non-replacing", () => {
927
- const state = createState();
928
- const first = toolcraftReducer(state, {
929
- asset: {
930
- dataUrl: "data:image/png;base64,first",
931
- fileName: "first.png",
932
- mimeType: "image/png",
933
- position: { x: 0, y: 0 },
934
- size: state.canvas.size,
935
- },
936
- replaceExisting: false,
937
- type: "media.import",
938
- });
939
- const second = toolcraftReducer(first, {
940
- asset: {
941
- dataUrl: "data:image/png;base64,second",
942
- fileName: "second.png",
943
- mimeType: "image/png",
944
- position: { x: 0, y: 0 },
945
- size: state.canvas.size,
946
- },
947
- replaceExisting: false,
948
- type: "media.import",
949
- });
950
-
951
- expect(second.layers.map((layer) => layer.id)).toEqual(["layer-1", "layer-2"]);
952
- expect(second.mediaAssets.map((asset) => asset.id)).toEqual(["media-1", "media-2"]);
953
- expect(second.mediaAssets.map((asset) => asset.fileName)).toEqual([
954
- "first.png",
955
- "second.png",
956
- ]);
957
- expect(second.selectedLayerId).toBe("layer-2");
958
- });
959
-
960
- it("reorders imported media assets and records undo history", () => {
961
- const state = createState();
962
- const first = toolcraftReducer(state, {
963
- asset: {
964
- dataUrl: "data:image/png;base64,first",
965
- fileName: "first.png",
966
- mimeType: "image/png",
967
- position: { x: 0, y: 0 },
968
- size: state.canvas.size,
969
- },
970
- replaceExisting: false,
971
- type: "media.import",
972
- });
973
- const second = toolcraftReducer(first, {
974
- asset: {
975
- dataUrl: "data:image/png;base64,second",
976
- fileName: "second.png",
977
- mimeType: "image/png",
978
- position: { x: 0, y: 0 },
979
- size: state.canvas.size,
980
- },
981
- replaceExisting: false,
982
- type: "media.import",
983
- });
984
- const third = toolcraftReducer(second, {
985
- asset: {
986
- dataUrl: "data:image/png;base64,third",
987
- fileName: "third.png",
988
- mimeType: "image/png",
989
- position: { x: 0, y: 0 },
990
- size: state.canvas.size,
991
- },
992
- replaceExisting: false,
993
- type: "media.import",
994
- });
995
-
996
- const reordered = toolcraftReducer(third, {
997
- mediaIds: ["media-3", "media-1", "media-2"],
998
- type: "media.reorder",
999
- });
1000
- const undone = toolcraftReducer(reordered, { type: "history.undo" });
1001
-
1002
- expect(reordered.mediaAssets.map((asset) => asset.id)).toEqual([
1003
- "media-3",
1004
- "media-1",
1005
- "media-2",
1006
- ]);
1007
- expect(reordered.history.undo.at(-1)?.label).toBe("Reorder media");
1008
- expect(undone.mediaAssets.map((asset) => asset.id)).toEqual([
1009
- "media-1",
1010
- "media-2",
1011
- "media-3",
1012
- ]);
1013
- });
1014
-
1015
- it("keeps omitted media assets after explicitly reordered media", () => {
1016
- const state = createState();
1017
- const first = toolcraftReducer(state, {
1018
- asset: {
1019
- dataUrl: "data:image/png;base64,first",
1020
- fileName: "first.png",
1021
- mimeType: "image/png",
1022
- position: { x: 0, y: 0 },
1023
- size: state.canvas.size,
1024
- },
1025
- replaceExisting: false,
1026
- type: "media.import",
1027
- });
1028
- const second = toolcraftReducer(first, {
1029
- asset: {
1030
- dataUrl: "data:image/png;base64,second",
1031
- fileName: "second.png",
1032
- mimeType: "image/png",
1033
- position: { x: 0, y: 0 },
1034
- size: state.canvas.size,
1035
- },
1036
- replaceExisting: false,
1037
- type: "media.import",
1038
- });
1039
- const third = toolcraftReducer(second, {
1040
- asset: {
1041
- dataUrl: "data:image/png;base64,third",
1042
- fileName: "third.png",
1043
- mimeType: "image/png",
1044
- position: { x: 0, y: 0 },
1045
- size: state.canvas.size,
1046
- },
1047
- replaceExisting: false,
1048
- type: "media.import",
1049
- });
1050
-
1051
- const reordered = toolcraftReducer(third, {
1052
- mediaIds: ["media-2"],
1053
- type: "media.reorder",
1054
- });
1055
-
1056
- expect(reordered.mediaAssets.map((asset) => asset.id)).toEqual([
1057
- "media-2",
1058
- "media-1",
1059
- "media-3",
1060
- ]);
1061
- });
1062
-
1063
- it("adds and selects runtime layers and groups", () => {
1064
- const withGroup = toolcraftReducer(createState(), {
1065
- layer: {
1066
- displayName: "Scene Group",
1067
- id: "group-1",
1068
- kind: "group",
1069
- name: "scene-group",
1070
- },
1071
- type: "layers.add",
1072
- });
1073
- const state = toolcraftReducer(withGroup, {
1074
- insertIndex: 1,
1075
- layer: {
1076
- displayName: "Layer 1",
1077
- id: "layer-1",
1078
- name: "layer-1",
1079
- parentGroupId: "group-1",
1080
- },
1081
- type: "layers.add",
1082
- });
1083
-
1084
- expect(state.layers).toEqual([
1085
- {
1086
- collapsed: false,
1087
- displayName: "Scene Group",
1088
- id: "group-1",
1089
- kind: "group",
1090
- name: "scene-group",
1091
- parentGroupId: undefined,
1092
- visible: true,
1093
- },
1094
- {
1095
- collapsed: undefined,
1096
- displayName: "Layer 1",
1097
- id: "layer-1",
1098
- kind: "layer",
1099
- name: "layer-1",
1100
- parentGroupId: "group-1",
1101
- visible: true,
1102
- },
1103
- ]);
1104
- expect(state.selectedLayerId).toBe("layer-1");
1105
- });
1106
-
1107
- it("renames layers and toggles visibility and collapsed groups", () => {
1108
- const withGroup = toolcraftReducer(createState(), {
1109
- layer: { id: "group-1", kind: "group", name: "Scene Group" },
1110
- type: "layers.add",
1111
- });
1112
- const hidden = toolcraftReducer(withGroup, {
1113
- layerId: "group-1",
1114
- type: "layers.toggleVisibility",
1115
- });
1116
- const collapsed = toolcraftReducer(hidden, {
1117
- layerId: "group-1",
1118
- type: "layers.toggleCollapsed",
1119
- });
1120
- const renamed = toolcraftReducer(collapsed, {
1121
- layerId: "group-1",
1122
- name: "Main Scene",
1123
- type: "layers.rename",
1124
- });
1125
-
1126
- expect(renamed.layers[0]).toMatchObject({
1127
- collapsed: true,
1128
- displayName: "Main Scene",
1129
- visible: false,
1130
- });
1131
- expect(renamed.history.undo.at(-1)?.label).toBe("Rename layer");
1132
- });
1133
-
1134
- it("deletes groups with their children", () => {
1135
- const withGroup = toolcraftReducer(createState(), {
1136
- layer: { id: "group-1", kind: "group", name: "Group 1" },
1137
- type: "layers.add",
1138
- });
1139
- const withChild = toolcraftReducer(withGroup, {
1140
- layer: { id: "layer-1", name: "Layer 1", parentGroupId: "group-1" },
1141
- type: "layers.add",
1142
- });
1143
- const withSibling = toolcraftReducer(withChild, {
1144
- layer: { id: "layer-2", name: "Layer 2" },
1145
- type: "layers.add",
1146
- });
1147
-
1148
- const state = toolcraftReducer(withSibling, {
1149
- layerId: "group-1",
1150
- type: "layers.delete",
1151
- });
1152
-
1153
- expect(state.layers.map((layer) => layer.id)).toEqual(["layer-2"]);
1154
- expect(state.selectedLayerId).toBe("layer-2");
1155
- });
1156
-
1157
- it("deletes nested groups with every descendant layer", () => {
1158
- let state = createState();
1159
-
1160
- state = toolcraftReducer(state, {
1161
- layer: { id: "group-1", kind: "group", name: "Group 1" },
1162
- type: "layers.add",
1163
- });
1164
- state = toolcraftReducer(state, {
1165
- layer: { id: "group-2", kind: "group", name: "Group 2", parentGroupId: "group-1" },
1166
- type: "layers.add",
1167
- });
1168
- state = toolcraftReducer(state, {
1169
- layer: { id: "layer-1", name: "Layer 1", parentGroupId: "group-2" },
1170
- type: "layers.add",
1171
- });
1172
- state = toolcraftReducer(state, {
1173
- layer: { id: "layer-2", name: "Layer 2" },
1174
- type: "layers.add",
1175
- });
1176
-
1177
- const deleted = toolcraftReducer(state, {
1178
- layerId: "group-1",
1179
- type: "layers.delete",
1180
- });
1181
-
1182
- expect(deleted.layers.map((layer) => layer.id)).toEqual(["layer-2"]);
1183
- expect(deleted.selectedLayerId).toBe("layer-2");
1184
- });
1185
-
1186
- it("deletes media assets attached to a layer", () => {
1187
- const imported = toolcraftReducer(createState(), {
1188
- asset: {
1189
- dataUrl: "data:image/png;base64,test",
1190
- fileName: "material.png",
1191
- mimeType: "image/png",
1192
- position: { x: 0, y: 0 },
1193
- size: { width: 1024, height: 768, unit: "px" },
1194
- },
1195
- type: "media.import",
1196
- });
1197
-
1198
- const state = toolcraftReducer(imported, {
1199
- layerId: "layer-1",
1200
- type: "layers.delete",
1201
- });
1202
-
1203
- expect(state.layers).toEqual([]);
1204
- expect(state.mediaAssets).toEqual([]);
1205
- expect(state.selectedLayerId).toBeNull();
1206
- });
1207
-
1208
- it("moves layers into groups and back to root", () => {
1209
- const withGroup = toolcraftReducer(createState(), {
1210
- layer: { id: "group-1", kind: "group", name: "Group 1" },
1211
- type: "layers.add",
1212
- });
1213
- const withLayer = toolcraftReducer(withGroup, {
1214
- layer: { id: "layer-1", name: "Layer 1" },
1215
- type: "layers.add",
1216
- });
1217
-
1218
- const grouped = toolcraftReducer(withLayer, {
1219
- layerIds: ["layer-1"],
1220
- parentGroupId: "group-1",
1221
- type: "layers.moveToGroup",
1222
- });
1223
- const rooted = toolcraftReducer(grouped, {
1224
- layerIds: ["layer-1"],
1225
- parentGroupId: null,
1226
- type: "layers.moveToGroup",
1227
- });
1228
-
1229
- expect(grouped.layers.find((layer) => layer.id === "layer-1")?.parentGroupId).toBe("group-1");
1230
- expect(grouped.history.undo.at(-1)?.label).toBe("Move layers to group");
1231
- expect(rooted.layers.find((layer) => layer.id === "layer-1")?.parentGroupId).toBeUndefined();
1232
- expect(rooted.history.undo.at(-1)?.label).toBe("Move layers to root");
1233
- });
1234
-
1235
- it("opens collapsed groups when moving layers into them", () => {
1236
- const withGroup = toolcraftReducer(createState(), {
1237
- layer: { id: "group-1", kind: "group", name: "Group 1" },
1238
- type: "layers.add",
1239
- });
1240
- const withCollapsedGroup = toolcraftReducer(withGroup, {
1241
- layerId: "group-1",
1242
- type: "layers.toggleCollapsed",
1243
- });
1244
- const withLayer = toolcraftReducer(withCollapsedGroup, {
1245
- layer: { id: "layer-1", name: "Layer 1" },
1246
- type: "layers.add",
1247
- });
1248
-
1249
- const grouped = toolcraftReducer(withLayer, {
1250
- layerIds: ["layer-1"],
1251
- parentGroupId: "group-1",
1252
- type: "layers.moveToGroup",
1253
- });
1254
-
1255
- expect(grouped.layers.find((layer) => layer.id === "group-1")?.collapsed).toBe(false);
1256
- expect(grouped.layers.find((layer) => layer.id === "layer-1")?.parentGroupId).toBe("group-1");
1257
- });
1258
-
1259
- it("places moved layers directly under the target group", () => {
1260
- const withFirst = toolcraftReducer(createState(), {
1261
- layer: { id: "layer-1", name: "Layer 1" },
1262
- type: "layers.add",
1263
- });
1264
- const withGroup = toolcraftReducer(withFirst, {
1265
- layer: { id: "group-1", kind: "group", name: "Group 1" },
1266
- type: "layers.add",
1267
- });
1268
- const withExistingChild = toolcraftReducer(withGroup, {
1269
- layer: { id: "layer-2", name: "Layer 2", parentGroupId: "group-1" },
1270
- type: "layers.add",
1271
- });
1272
- const withDraggedLayer = toolcraftReducer(withExistingChild, {
1273
- layer: { id: "layer-3", name: "Layer 3" },
1274
- type: "layers.add",
1275
- });
1276
-
1277
- const state = toolcraftReducer(withDraggedLayer, {
1278
- layerIds: ["layer-3"],
1279
- parentGroupId: "group-1",
1280
- type: "layers.moveToGroup",
1281
- });
1282
-
1283
- expect(state.layers.map((layer) => layer.id)).toEqual([
1284
- "layer-1",
1285
- "group-1",
1286
- "layer-3",
1287
- "layer-2",
1288
- ]);
1289
- expect(state.layers.find((layer) => layer.id === "layer-3")?.parentGroupId).toBe("group-1");
1290
- });
1291
-
1292
- it("does not move groups into their own descendants", () => {
1293
- const withParent = toolcraftReducer(createState(), {
1294
- layer: { id: "group-1", kind: "group", name: "Group 1" },
1295
- type: "layers.add",
1296
- });
1297
- const withChild = toolcraftReducer(withParent, {
1298
- layer: { id: "group-2", kind: "group", name: "Group 2", parentGroupId: "group-1" },
1299
- type: "layers.add",
1300
- });
1301
-
1302
- const state = toolcraftReducer(withChild, {
1303
- layerIds: ["group-1"],
1304
- parentGroupId: "group-2",
1305
- type: "layers.moveToGroup",
1306
- });
1307
-
1308
- expect(state).toBe(withChild);
1309
- });
1310
-
1311
- it("reorders layers and supports undo and redo", () => {
1312
- const withFirst = toolcraftReducer(createState(), {
1313
- layer: { id: "layer-1", name: "Layer 1" },
1314
- type: "layers.add",
1315
- });
1316
- const withSecond = toolcraftReducer(withFirst, {
1317
- layer: { id: "layer-2", name: "Layer 2" },
1318
- type: "layers.add",
1319
- });
1320
- const reordered = toolcraftReducer(withSecond, {
1321
- layers: [withSecond.layers[1]!, withSecond.layers[0]!],
1322
- selectedLayerId: "layer-1",
1323
- type: "layers.reorder",
1324
- });
1325
- const undone = toolcraftReducer(reordered, { type: "history.undo" });
1326
- const redone = toolcraftReducer(undone, { type: "history.redo" });
1327
-
1328
- expect(reordered.layers.map((layer) => layer.id)).toEqual(["layer-2", "layer-1"]);
1329
- expect(reordered.selectedLayerId).toBe("layer-1");
1330
- expect(undone.layers.map((layer) => layer.id)).toEqual(["layer-1", "layer-2"]);
1331
- expect(redone.layers.map((layer) => layer.id)).toEqual(["layer-2", "layer-1"]);
1332
- });
1333
-
1334
- it("preserves nested move undo and redo", () => {
1335
- let state = createState();
1336
-
1337
- state = toolcraftReducer(state, {
1338
- layer: { id: "group-1", kind: "group", name: "Group 1" },
1339
- type: "layers.add",
1340
- });
1341
- state = toolcraftReducer(state, {
1342
- layer: { id: "group-2", kind: "group", name: "Group 2" },
1343
- type: "layers.add",
1344
- });
1345
- state = toolcraftReducer(state, {
1346
- layer: { id: "layer-1", name: "Layer 1", parentGroupId: "group-1" },
1347
- type: "layers.add",
1348
- });
1349
-
1350
- const moved = toolcraftReducer(state, {
1351
- layerIds: ["layer-1"],
1352
- parentGroupId: "group-2",
1353
- type: "layers.moveToGroup",
1354
- });
1355
- const undone = toolcraftReducer(moved, { type: "history.undo" });
1356
- const redone = toolcraftReducer(undone, { type: "history.redo" });
1357
-
1358
- expect(moved.layers.find((layer) => layer.id === "layer-1")?.parentGroupId).toBe("group-2");
1359
- expect(undone.layers.find((layer) => layer.id === "layer-1")?.parentGroupId).toBe("group-1");
1360
- expect(redone.layers.find((layer) => layer.id === "layer-1")?.parentGroupId).toBe("group-2");
1361
- });
1362
-
1363
- it("undoes and redoes media imports", () => {
1364
- const imported = toolcraftReducer(createState(), {
1365
- asset: {
1366
- dataUrl: "data:image/png;base64,test",
1367
- fileName: "material.png",
1368
- mimeType: "image/png",
1369
- position: { x: 10, y: 20 },
1370
- size: { width: 1024, height: 768, unit: "px" },
1371
- },
1372
- type: "media.import",
1373
- });
1374
-
1375
- const undone = toolcraftReducer(imported, { type: "history.undo" });
1376
- const redone = toolcraftReducer(undone, { type: "history.redo" });
1377
-
1378
- expect(undone.layers).toEqual([]);
1379
- expect(undone.mediaAssets).toEqual([]);
1380
- expect(undone.selectedLayerId).toBeNull();
1381
- expect(redone.layers).toHaveLength(1);
1382
- expect(redone.mediaAssets).toHaveLength(1);
1383
- expect(redone.selectedLayerId).toBe("layer-1");
1384
- });
1385
-
1386
- it("undoes and redoes value changes", () => {
1387
- const changed = toolcraftReducer(createState(), {
1388
- target: "selectedLayer.opacity",
1389
- type: "controls.setValue",
1390
- value: 12,
1391
- });
1392
-
1393
- const undone = toolcraftReducer(changed, { type: "history.undo" });
1394
- const redone = toolcraftReducer(undone, { type: "history.redo" });
1395
-
1396
- expect(undone.values["selectedLayer.opacity"]).toBe(75);
1397
- expect(redone.values["selectedLayer.opacity"]).toBe(12);
1398
- });
1399
-
1400
- it("merges live control changes from one editor gesture into one undo step", () => {
1401
- const base = createState();
1402
- const first = toolcraftReducer(base, {
1403
- history: "merge",
1404
- historyGroup: "opacity-drag-1",
1405
- target: "selectedLayer.opacity",
1406
- type: "controls.setValue",
1407
- value: 76,
1408
- });
1409
- const second = toolcraftReducer(first, {
1410
- history: "merge",
1411
- historyGroup: "opacity-drag-1",
1412
- target: "selectedLayer.opacity",
1413
- type: "controls.setValue",
1414
- value: 82,
1415
- });
1416
- const third = toolcraftReducer(second, {
1417
- history: "merge",
1418
- historyGroup: "opacity-drag-1",
1419
- target: "selectedLayer.opacity",
1420
- type: "controls.setValue",
1421
- value: 91,
1422
- });
1423
-
1424
- expect(third.values["selectedLayer.opacity"]).toBe(91);
1425
- expect(third.history.undo).toHaveLength(1);
1426
- expect(third.history.undo[0]).toMatchObject({
1427
- after: { "selectedLayer.opacity": 91 },
1428
- before: { "selectedLayer.opacity": 75 },
1429
- group: "opacity-drag-1",
1430
- });
1431
-
1432
- const undone = toolcraftReducer(third, { type: "history.undo" });
1433
- const redone = toolcraftReducer(undone, { type: "history.redo" });
1434
-
1435
- expect(undone.values["selectedLayer.opacity"]).toBe(75);
1436
- expect(redone.values["selectedLayer.opacity"]).toBe(91);
1437
- });
1438
-
1439
- it("starts a new undo step for a new live gesture on the same control", () => {
1440
- const firstGesture = toolcraftReducer(createState(), {
1441
- history: "merge",
1442
- historyGroup: "opacity-drag-1",
1443
- target: "selectedLayer.opacity",
1444
- type: "controls.setValue",
1445
- value: 82,
1446
- });
1447
- const secondGesture = toolcraftReducer(firstGesture, {
1448
- history: "merge",
1449
- historyGroup: "opacity-drag-2",
1450
- target: "selectedLayer.opacity",
1451
- type: "controls.setValue",
1452
- value: 64,
1453
- });
1454
-
1455
- expect(secondGesture.history.undo).toHaveLength(2);
1456
- expect(secondGesture.history.undo[0]?.before).toEqual({
1457
- "selectedLayer.opacity": 75,
1458
- });
1459
- expect(secondGesture.history.undo[0]?.after).toEqual({
1460
- "selectedLayer.opacity": 82,
1461
- });
1462
- expect(secondGesture.history.undo[1]?.before).toEqual({
1463
- "selectedLayer.opacity": 82,
1464
- });
1465
- expect(secondGesture.history.undo[1]?.after).toEqual({
1466
- "selectedLayer.opacity": 64,
1467
- });
1468
- });
1469
-
1470
- it("updates timeline playback state without recording history", () => {
1471
- const paused = toolcraftReducer(createState(), { type: "timeline.togglePlayback" });
1472
- const loopDisabled = toolcraftReducer(paused, { type: "timeline.toggleLoop" });
1473
- const scrubbed = toolcraftReducer(loopDisabled, {
1474
- currentTimeSeconds: 4.25,
1475
- type: "timeline.setCurrentTime",
1476
- });
1477
-
1478
- expect(scrubbed.timeline.isPlaying).toBe(false);
1479
- expect(scrubbed.timeline.isLooping).toBe(false);
1480
- expect(scrubbed.timeline.currentTimeSeconds).toBe(4.25);
1481
- expect(scrubbed.history.undo).toHaveLength(0);
1482
- });
1483
-
1484
- it("keeps loop state when timeline duration changes", () => {
1485
- const state = toolcraftReducer(
1486
- createState({
1487
- timeline: {
1488
- currentTimeSeconds: 9,
1489
- durationSeconds: 10,
1490
- isLooping: true,
1491
- isPlaying: true,
1492
- },
1493
- }),
1494
- {
1495
- target: "selectedLayer.opacity",
1496
- type: "controls.setValue",
1497
- value: 42,
1498
- },
1499
- );
1500
-
1501
- const resized = toolcraftReducer(state, {
1502
- durationSeconds: 6,
1503
- type: "timeline.setDuration",
1504
- });
1505
-
1506
- expect(resized.timeline.durationSeconds).toBe(6);
1507
- expect(resized.timeline.currentTimeSeconds).toBe(6);
1508
- expect(resized.timeline.isPlaying).toBe(true);
1509
- expect(resized.timeline.isLooping).toBe(true);
1510
- expect(resized.values).toEqual(state.values);
1511
- expect(resized.values["selectedLayer.opacity"]).toBe(42);
1512
- expect(resized.defaults).toEqual(state.defaults);
1513
- });
1514
-
1515
- it("restarts playback from the beginning when play is pressed at the non-looping end", () => {
1516
- const paused = toolcraftReducer(createState(), { type: "timeline.togglePlayback" });
1517
- const loopDisabled = toolcraftReducer(paused, { type: "timeline.toggleLoop" });
1518
- const ended = toolcraftReducer(loopDisabled, {
1519
- currentTimeSeconds: loopDisabled.timeline.durationSeconds,
1520
- type: "timeline.setCurrentTime",
1521
- });
1522
- const replaying = toolcraftReducer(ended, { type: "timeline.togglePlayback" });
1523
-
1524
- expect(replaying.timeline.currentTimeSeconds).toBe(0);
1525
- expect(replaying.timeline.isPlaying).toBe(true);
1526
- expect(replaying.history.undo).toHaveLength(0);
1527
- });
1528
-
1529
- it("pauses and resets upload-dependent timeline playback when deleting the last media asset", () => {
1530
- const app = defineToolcraft({
1531
- canvas: {
1532
- enabled: true,
1533
- sizing: { mode: "intrinsic-media" },
1534
- upload: true,
1535
- },
1536
- panels: {
1537
- timeline: { mode: "playback" },
1538
- },
1539
- });
1540
- const state = createToolcraftState(app, {
1541
- mediaAssets: [
1542
- {
1543
- dataUrl: "data:image/png;base64,AAAA",
1544
- fileName: "source.png",
1545
- id: "media-1",
1546
- layerId: "layer-1",
1547
- mimeType: "image/png",
1548
- position: { x: 0, y: 0 },
1549
- size: { height: 320, unit: "px", width: 512 },
1550
- },
1551
- ],
1552
- timeline: {
1553
- currentTimeSeconds: 3.5,
1554
- isPlaying: true,
1555
- },
1556
- });
1557
-
1558
- const deleted = toolcraftReducer(state, {
1559
- mediaId: "media-1",
1560
- type: "media.delete",
1561
- });
1562
-
1563
- expect(deleted.mediaAssets).toEqual([]);
1564
- expect(deleted.timeline.currentTimeSeconds).toBe(0);
1565
- expect(deleted.timeline.isPlaying).toBe(false);
1566
- expect(deleted.history.undo.at(-1)?.after).toMatchObject({
1567
- mediaAssets: [],
1568
- timeline: expect.objectContaining({
1569
- currentTimeSeconds: 0,
1570
- isPlaying: false,
1571
- }),
1572
- });
1573
- });
1574
-
1575
- it("stores timeline expanded state without recording history", () => {
1576
- const expanded = toolcraftReducer(createState(), {
1577
- expanded: true,
1578
- type: "timeline.setExpanded",
1579
- });
1580
- const collapsed = toolcraftReducer(expanded, { type: "timeline.toggleExpanded" });
1581
-
1582
- expect(expanded.timeline.expanded).toBe(true);
1583
- expect(expanded.history.undo).toHaveLength(0);
1584
- expect(collapsed.timeline.expanded).toBe(false);
1585
- expect(collapsed.history.undo).toHaveLength(0);
1586
- });
1587
-
1588
- it("adds, updates, and removes control-owned timeline keyframes", () => {
1589
- const baseState = createState();
1590
- const emptyTimelineState = {
1591
- ...baseState,
1592
- timeline: {
1593
- ...baseState.timeline,
1594
- currentTimeSeconds: 2,
1595
- expanded: false,
1596
- keyframeGroups: [],
1597
- selectedKeyframeId: null,
1598
- },
1599
- };
1600
- const keyed = toolcraftReducer(emptyTimelineState, {
1601
- controlId: "selectedLayer.opacity",
1602
- controlLabel: "Opacity",
1603
- type: "timeline.toggleControlKeyframes",
1604
- value: 75,
1605
- valueLabel: "75%",
1606
- });
1607
-
1608
- expect(keyed.timeline.expanded).toBe(true);
1609
- expect(keyed.timeline.selectedKeyframeId).toBe("selectedLayer.opacity::2");
1610
- expect(keyed.timeline.keyframeGroups).toEqual([
1611
- {
1612
- controlId: "selectedLayer.opacity",
1613
- keyframes: [
1614
- {
1615
- controlId: "selectedLayer.opacity",
1616
- controlLabel: "Opacity",
1617
- id: "selectedLayer.opacity::2",
1618
- timeSeconds: 2,
1619
- value: 75,
1620
- valueLabel: "75%",
1621
- },
1622
- ],
1623
- label: "Opacity",
1624
- },
1625
- ]);
1626
- expect(keyed.history.undo.at(-1)?.label).toBe("Add control keyframe");
1627
-
1628
- const updated = toolcraftReducer(keyed, {
1629
- controlId: "selectedLayer.opacity",
1630
- controlLabel: "Opacity",
1631
- type: "timeline.upsertControlKeyframe",
1632
- value: 55,
1633
- valueLabel: "55%",
1634
- });
1635
-
1636
- expect(updated.timeline.keyframeGroups[0]?.keyframes).toHaveLength(1);
1637
- expect(updated.timeline.keyframeGroups[0]?.keyframes[0]?.valueLabel).toBe("55%");
1638
- expect(updated.timeline.keyframeGroups[0]?.keyframes[0]?.value).toBe(55);
1639
- expect(updated.history.undo.at(-1)?.label).toBe("Set control keyframe");
1640
-
1641
- const removed = toolcraftReducer(updated, {
1642
- controlId: "selectedLayer.opacity",
1643
- controlLabel: "Opacity",
1644
- type: "timeline.toggleControlKeyframes",
1645
- value: 55,
1646
- valueLabel: "55%",
1647
- });
1648
-
1649
- expect(removed.timeline.keyframeGroups).toEqual([]);
1650
- expect(removed.timeline.selectedKeyframeId).toBeNull();
1651
- expect(removed.history.undo.at(-1)?.label).toBe("Delete control keyframes");
1652
- });
1653
-
1654
- it("records timeline keyframe edits in history", () => {
1655
- const baseState = createState();
1656
- const stateWithKeyframe = {
1657
- ...baseState,
1658
- timeline: {
1659
- ...baseState.timeline,
1660
- keyframeGroups: [
1661
- {
1662
- controlId: "opacity",
1663
- keyframes: [
1664
- {
1665
- controlId: "opacity",
1666
- controlLabel: "Opacity",
1667
- id: "opacity-0.75",
1668
- timeSeconds: 0.75,
1669
- valueLabel: "Opacity 20%",
1670
- },
1671
- ],
1672
- label: "Opacity",
1673
- },
1674
- ],
1675
- },
1676
- };
1677
- const moved = toolcraftReducer(stateWithKeyframe, {
1678
- keyframeId: "opacity-0.75",
1679
- timeSeconds: 2,
1680
- type: "timeline.moveKeyframe",
1681
- });
1682
- const undone = toolcraftReducer(moved, { type: "history.undo" });
1683
- const redone = toolcraftReducer(undone, { type: "history.redo" });
1684
-
1685
- expect(moved.timeline.selectedKeyframeId).toBe("opacity::2");
1686
- expect(
1687
- moved.timeline.keyframeGroups
1688
- .flatMap((group) => group.keyframes)
1689
- .find((keyframe) => keyframe.id === "opacity::2")?.timeSeconds,
1690
- ).toBe(2);
1691
- expect(moved.history.undo.at(-1)?.label).toBe("Move keyframe");
1692
- expect(
1693
- undone.timeline.keyframeGroups
1694
- .flatMap((group) => group.keyframes)
1695
- .some((keyframe) => keyframe.id === "opacity-0.75"),
1696
- ).toBe(true);
1697
- expect(
1698
- redone.timeline.keyframeGroups
1699
- .flatMap((group) => group.keyframes)
1700
- .some((keyframe) => keyframe.id === "opacity::2"),
1701
- ).toBe(true);
1702
- });
1703
- });