@pixel-point/toolcraft 0.0.17 → 0.0.19

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 (503) hide show
  1. package/package.json +1 -1
  2. package/src/generate-demand-only-lifecycle.test.mjs +9 -1
  3. package/src/generate-performance-iteration-execution.test.mjs +3 -3
  4. package/src/generate-test-delivery-architecture-assertions.mjs +11 -73
  5. package/src/generate-test-demand-only-lifecycle.mjs +34 -36
  6. package/src/generate-test-dependency-sandbox.mjs +4 -1
  7. package/src/generate-test-doc-assertions.mjs +81 -89
  8. package/src/generate-test-doc-assertions.test.mjs +44 -1
  9. package/src/generate-test-doc-policy-assertions.mjs +92 -0
  10. package/src/generate-test-export-doc-assertions.mjs +53 -0
  11. package/src/generate-test-file-assertions.mjs +77 -83
  12. package/src/generate-test-integrity-assertions.mjs +5 -2
  13. package/src/generate-test-integrity-manifest-assertions.mjs +16 -5
  14. package/src/generate-test-integrity-ownership-assertions.mjs +36 -4
  15. package/src/generate-test-package-assertions.mjs +4 -0
  16. package/src/generate-test-product-fixture.mjs +1 -1
  17. package/src/generate-test-product-fixture.test.mjs +35 -38
  18. package/src/generate-test-product-iteration.mjs +0 -1
  19. package/src/generate-test-product-iteration.test.mjs +17 -1
  20. package/src/generate-test-runtime-boundary-assertions.mjs +178 -0
  21. package/src/generate-test-standalone-assertions.mjs +7 -13
  22. package/src/generate-test-standalone-delivery-stages.mjs +2 -86
  23. package/src/generate.test.mjs +4 -0
  24. package/src/generated-integrity-manifest.test.mjs +5 -2
  25. package/src/generated-source-policy.test.mjs +0 -4
  26. package/src/package-json.mjs +5 -0
  27. package/src/package-json.test.mjs +21 -0
  28. package/src/package-manager.mjs +2 -0
  29. package/src/package-manager.test.mjs +8 -0
  30. package/src/packaged-template-fallback-helpers.mjs +254 -0
  31. package/src/packaged-template-fallback.test.mjs +121 -46
  32. package/src/packaged-template-runtime-assertions.mjs +150 -0
  33. package/templates/runtime/contracts/component-contracts.choices.test.ts +64 -5
  34. package/templates/runtime/contracts/component-contracts.choices.ts +55 -5
  35. package/templates/runtime/contracts/component-contracts.inputs.test.ts +6 -6
  36. package/templates/runtime/contracts/component-contracts.inputs.ts +8 -7
  37. package/templates/runtime/contracts/component-contracts.media-custom.test.ts +8 -2
  38. package/templates/runtime/contracts/component-contracts.media-custom.ts +8 -2
  39. package/templates/runtime/contracts/component-contracts.runtime-acceptance.test.ts +22 -8
  40. package/templates/runtime/contracts/component-contracts.runtime-labels.test.ts +7 -1
  41. package/templates/runtime/contracts/component-contracts.runtime-panels.test.ts +3 -0
  42. package/templates/runtime/contracts/component-contracts.runtime-shell.test.ts +4 -1
  43. package/templates/runtime/contracts/component-contracts.runtime.ts +19 -12
  44. package/templates/runtime/contracts/component-contracts.test.ts +2 -0
  45. package/templates/runtime/contracts/component-contracts.visual.test.ts +20 -0
  46. package/templates/runtime/contracts/component-contracts.visual.ts +4 -0
  47. package/templates/runtime/contracts/decision-contracts.test.ts +35 -11
  48. package/templates/runtime/contracts/decision-contracts.ts +12 -12
  49. package/templates/runtime/contracts/performance-verification-policy.test.ts +12 -12
  50. package/templates/runtime/contracts/performance-verification-policy.ts +8 -8
  51. package/templates/runtime/export/artifact-download.ts +1 -0
  52. package/templates/runtime/export/artifact-frame-renderer.ts +2 -15
  53. package/templates/runtime/export/artifact-frame-state.ts +16 -0
  54. package/templates/runtime/export/artifact-scene-frame.test.ts +3 -3
  55. package/templates/runtime/export/artifact-scene-frame.ts +3 -3
  56. package/templates/runtime/export/export-background.ts +0 -19
  57. package/templates/runtime/export/export-error.ts +5 -0
  58. package/templates/runtime/export/export-renderer-coverage.ts +54 -0
  59. package/templates/runtime/export/export.test.ts +45 -42
  60. package/templates/runtime/export/image-artifact-export.ts +2 -2
  61. package/templates/runtime/export/index.ts +57 -16
  62. package/templates/runtime/export/product-export-renderer.test.ts +38 -4
  63. package/templates/runtime/export/product-export-renderer.ts +0 -41
  64. package/templates/runtime/export/product-svg-export-renderer.ts +21 -0
  65. package/templates/runtime/export/svg-artifact-export.test.ts +98 -0
  66. package/templates/runtime/export/svg-artifact-export.ts +120 -0
  67. package/templates/runtime/export/svg-document.test.ts +221 -0
  68. package/templates/runtime/export/svg-document.ts +400 -0
  69. package/templates/runtime/export/svg-policy.ts +47 -0
  70. package/templates/runtime/index.ts +3 -0
  71. package/templates/runtime/model-import/model-import-limits.ts +15 -4
  72. package/templates/runtime/react/app-shell/runtime-public-api.test.tsx +21 -1
  73. package/templates/runtime/react/app-shell/settings-transfer.test.ts +21 -0
  74. package/templates/runtime/react/app-shell/toolcraft-app.scene-export.test.tsx +75 -1
  75. package/templates/runtime/react/app-shell/toolcraft-app.tsx +24 -9
  76. package/templates/runtime/react/canvas/canvas-shell-interactions.test.tsx +30 -0
  77. package/templates/runtime/react/canvas/canvas-shell-pinch-interactions.test.tsx +155 -0
  78. package/templates/runtime/react/canvas/canvas-shell-rendering.test.tsx +77 -1
  79. package/templates/runtime/react/canvas/canvas-shell-test-utils.tsx +13 -1
  80. package/templates/runtime/react/canvas/canvas-shell.tsx +32 -6
  81. package/templates/runtime/react/canvas/canvas-viewport-geometry.ts +133 -0
  82. package/templates/runtime/react/canvas/product-scene-surface.test.tsx +195 -0
  83. package/templates/runtime/react/canvas/product-scene-surface.tsx +155 -0
  84. package/templates/runtime/react/canvas/runtime-scene-export.ts +1 -1
  85. package/templates/runtime/react/canvas/use-canvas-viewport-interactions.ts +285 -36
  86. package/templates/runtime/react/controls-panel/__tests__/control-conditions.test.ts +61 -0
  87. package/templates/runtime/react/controls-panel/__tests__/controls-panel.collection-actions.test.tsx +89 -0
  88. package/templates/runtime/react/controls-panel/__tests__/controls-panel.color-applicability-layout.test.tsx +134 -0
  89. package/templates/runtime/react/controls-panel/__tests__/controls-panel.color-layout.test.tsx +16 -1
  90. package/templates/runtime/react/controls-panel/__tests__/controls-panel.control-visibility.test.tsx +40 -19
  91. package/templates/runtime/react/controls-panel/__tests__/controls-panel.render-isolation.test.tsx +2 -0
  92. package/templates/runtime/react/controls-panel/__tests__/controls-panel.scene-export-actions.test.tsx +40 -1
  93. package/templates/runtime/react/controls-panel/__tests__/controls-panel.setup-controls.test.tsx +3 -3
  94. package/templates/runtime/react/controls-panel/__tests__/controls-panel.source-collection.test.tsx +59 -0
  95. package/templates/runtime/react/controls-panel/__tests__/controls-panel.source-color-bank.test.tsx +67 -0
  96. package/templates/runtime/react/controls-panel/__tests__/controls-panel.vector-interaction.test.tsx +6 -6
  97. package/templates/runtime/react/controls-panel/actions/controls-panel-actions.ts +4 -6
  98. package/templates/runtime/react/controls-panel/actions/export-action-runner.ts +41 -6
  99. package/templates/runtime/react/controls-panel/conditions/control-conditions.ts +32 -119
  100. package/templates/runtime/react/controls-panel/layout/controls-panel-control-group.tsx +5 -2
  101. package/templates/runtime/react/controls-panel/layout/controls-panel-layout.tsx +41 -10
  102. package/templates/runtime/react/controls-panel/layout/controls-panel-section.tsx +7 -4
  103. package/templates/runtime/react/controls-panel/renderers/controls-panel-action-renderer.tsx +2 -1
  104. package/templates/runtime/react/controls-panel/renderers/controls-panel-basic-renderers.tsx +2 -52
  105. package/templates/runtime/react/controls-panel/renderers/controls-panel-collection-item-fields.test.tsx +63 -0
  106. package/templates/runtime/react/controls-panel/renderers/controls-panel-collection-item-fields.tsx +138 -0
  107. package/templates/runtime/react/controls-panel/renderers/controls-panel-collection-items.tsx +104 -0
  108. package/templates/runtime/react/controls-panel/renderers/controls-panel-collection-renderer.tsx +115 -236
  109. package/templates/runtime/react/controls-panel/renderers/controls-panel-file-drop-item-controls.test.tsx +95 -0
  110. package/templates/runtime/react/controls-panel/renderers/controls-panel-file-drop-item-controls.tsx +82 -0
  111. package/templates/runtime/react/controls-panel/renderers/controls-panel-media-renderer.test.tsx +73 -1
  112. package/templates/runtime/react/controls-panel/renderers/controls-panel-media-renderer.tsx +50 -1
  113. package/templates/runtime/react/controls-panel/renderers/controls-panel-renderer-registry.test.ts +1 -1
  114. package/templates/runtime/react/controls-panel/renderers/controls-panel-renderer-registry.ts +2 -1
  115. package/templates/runtime/react/controls-panel/values/controls-panel-collection-values.ts +38 -6
  116. package/templates/runtime/react/controls-panel/values/controls-panel-color-values.ts +1 -9
  117. package/templates/runtime/react/controls-panel/values/controls-panel-spatial-values.ts +7 -2
  118. package/templates/runtime/react/controls-panel/values/controls-panel-value-labels.ts +1 -0
  119. package/templates/runtime/react/index.ts +4 -0
  120. package/templates/runtime/react/model-rendering/model-export.ts +1 -1
  121. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-math.ts +9 -69
  122. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-selection.ts +5 -5
  123. package/templates/runtime/react/orientation-gizmo/use-toolcraft-orientation-control-selection.ts +2 -2
  124. package/templates/runtime/scene/scene-bounds.test.ts +23 -0
  125. package/templates/runtime/scene/scene-bounds.ts +31 -17
  126. package/templates/runtime/schema/app-capabilities.test.ts +4 -0
  127. package/templates/runtime/schema/artifact-export-actions.test.ts +47 -0
  128. package/templates/runtime/schema/artifact-export-actions.ts +49 -0
  129. package/templates/runtime/schema/collection-item-controls.ts +29 -0
  130. package/templates/runtime/schema/control-applicability.test.ts +127 -0
  131. package/templates/runtime/schema/control-applicability.ts +433 -0
  132. package/templates/runtime/schema/control-schema-normalization.ts +177 -11
  133. package/templates/runtime/schema/controls-panel-actions.ts +2 -2
  134. package/templates/runtime/schema/controls-panel-section-layout.ts +14 -9
  135. package/templates/runtime/schema/controls-panel-section-roundtrip.test.ts +59 -0
  136. package/templates/runtime/schema/define-toolcraft.collection-actions-item-controls.test.ts +127 -0
  137. package/templates/runtime/schema/define-toolcraft.control-sections.test.ts +10 -4
  138. package/templates/runtime/schema/define-toolcraft.file-drop-item-controls.test.ts +98 -0
  139. package/templates/runtime/schema/define-toolcraft.file-drop-normalization.test.ts +27 -0
  140. package/templates/runtime/schema/define-toolcraft.segmented-control-fit.test.ts +20 -2
  141. package/templates/runtime/schema/define-toolcraft.setup-canvas.test.ts +16 -3
  142. package/templates/runtime/schema/define-toolcraft.source-collection.test.ts +79 -0
  143. package/templates/runtime/schema/runtime-setup-section.ts +24 -5
  144. package/templates/runtime/schema/types.ts +69 -13
  145. package/templates/runtime/state/canvas-background-state.ts +1 -16
  146. package/templates/runtime/state/canvas-state.ts +32 -20
  147. package/templates/runtime/state/control-value-codecs.test.ts +98 -0
  148. package/templates/runtime/state/control-value-codecs.ts +700 -0
  149. package/templates/runtime/state/control-value-normalization.test.ts +1 -1
  150. package/templates/runtime/state/control-value-normalization.ts +127 -135
  151. package/templates/runtime/state/controls-reducer.ts +26 -3
  152. package/templates/runtime/state/create-template-state.test.ts +30 -0
  153. package/templates/runtime/state/create-template-state.ts +52 -31
  154. package/templates/runtime/state/orientation-pose.ts +80 -0
  155. package/templates/runtime/state/persistence-control-values.test.ts +59 -0
  156. package/templates/runtime/state/reducer-controls.test.ts +45 -0
  157. package/templates/runtime/state/reducer-media-reset.test.ts +1 -1
  158. package/templates/runtime/state/reducer-timeline.test.ts +70 -0
  159. package/templates/runtime/state/timeline-reducer.ts +40 -2
  160. package/templates/runtime/testing/performance-schema-queries.ts +2 -2
  161. package/templates/starter/AGENTS.md +29 -28
  162. package/templates/starter/docs/toolcraft/README.md +6 -6
  163. package/templates/starter/docs/toolcraft/acceptance-testing.md +34 -48
  164. package/templates/starter/docs/toolcraft/agent-worklog.md +103 -1
  165. package/templates/starter/docs/toolcraft/assembly-workflow.md +16 -8
  166. package/templates/starter/docs/toolcraft/component-rules.md +9 -7
  167. package/templates/starter/docs/toolcraft/core/control-selection.md +9 -3
  168. package/templates/starter/docs/toolcraft/core/layout.md +13 -8
  169. package/templates/starter/docs/toolcraft/core/media-upload.md +3 -1
  170. package/templates/starter/docs/toolcraft/core/performance.md +8 -10
  171. package/templates/starter/docs/toolcraft/core/reference-study.md +80 -19
  172. package/templates/starter/docs/toolcraft/core/runtime-boundary.md +15 -3
  173. package/templates/starter/docs/toolcraft/core/setup-export.md +67 -11
  174. package/templates/starter/docs/toolcraft/custom-controls.md +6 -4
  175. package/templates/starter/docs/toolcraft/decision-contract.md +4 -2
  176. package/templates/starter/docs/toolcraft/performance.md +8 -10
  177. package/templates/starter/docs/toolcraft/renderer-technique.md +6 -2
  178. package/templates/starter/docs/toolcraft/schema-reference.md +24 -22
  179. package/templates/starter/docs/toolcraft/workflow.md +14 -14
  180. package/templates/starter/e2e/app-browser-control-applicability-requirements.spec.ts +163 -0
  181. package/templates/starter/e2e/app-browser-infinity-canvas-evidence.spec.ts +45 -2
  182. package/templates/starter/e2e/app-browser-motion-reference-requirements.spec.ts +411 -0
  183. package/templates/starter/e2e/app-browser-orientation-evidence.spec.ts +174 -21
  184. package/templates/starter/e2e/app-browser-proof-session.spec.ts +85 -0
  185. package/templates/starter/e2e/app-browser-runtime-requirements.spec.ts +63 -33
  186. package/templates/starter/e2e/app-browser-selection-scope-evidence.spec.ts +137 -0
  187. package/templates/starter/e2e/app-browser-semantic-evidence.spec.ts +61 -15
  188. package/templates/starter/e2e/{browser-conditional-output-evidence-helpers.ts → browser-background-output-evidence.ts} +0 -68
  189. package/templates/starter/e2e/browser-control-applicability-evidence.ts +114 -0
  190. package/templates/starter/e2e/browser-infinity-canvas-evidence.ts +20 -11
  191. package/templates/starter/e2e/browser-infinity-canvas-svg-evidence.ts +42 -0
  192. package/templates/starter/e2e/browser-layer-evidence-helpers.ts +15 -36
  193. package/templates/starter/e2e/browser-orientation-gizmo-evidence-helpers.ts +4 -0
  194. package/templates/starter/e2e/browser-orientation-gizmo-live-preconditions.ts +86 -0
  195. package/templates/starter/e2e/browser-product-raster-snapshot.ts +213 -0
  196. package/templates/starter/e2e/browser-proof-session.ts +43 -15
  197. package/templates/starter/e2e/browser-proof-surface-action.ts +79 -0
  198. package/templates/starter/e2e/browser-proof-types.ts +15 -0
  199. package/templates/starter/e2e/browser-runtime-applicability-requirements.ts +84 -0
  200. package/templates/starter/e2e/browser-runtime-evidence-reporter.ts +9 -2
  201. package/templates/starter/e2e/browser-runtime-evidence-requirements.ts +51 -32
  202. package/templates/starter/e2e/browser-selection-scope-evidence.ts +269 -0
  203. package/templates/starter/e2e/browser-semantic-evidence-test-helpers.ts +122 -0
  204. package/templates/starter/e2e/browser-svg-export-evidence.spec.ts +79 -0
  205. package/templates/starter/e2e/browser-svg-export-evidence.ts +152 -0
  206. package/templates/starter/e2e/export-artifact-helpers.ts +70 -0
  207. package/templates/starter/e2e/product-observable-helpers.ts +8 -129
  208. package/templates/starter/e2e/svg-artifact-inspection.spec.ts +136 -0
  209. package/templates/starter/e2e/svg-artifact-inspection.ts +331 -0
  210. package/templates/starter/e2e/svg-download-test-fixtures.ts +34 -0
  211. package/templates/starter/e2e/toolcraft-delivery-catalog-reporter.ts +198 -15
  212. package/templates/starter/e2e/toolcraft-feature-verification-reporter.spec.ts +149 -0
  213. package/templates/starter/e2e/toolcraft-feature-verification-reporter.ts +223 -0
  214. package/templates/starter/package.json +2 -0
  215. package/templates/starter/scripts/check-toolcraft-docs.mjs +1 -0
  216. package/templates/starter/scripts/create-toolcraft-motion-reference-study.mjs +233 -0
  217. package/templates/starter/scripts/create-toolcraft-motion-reference-study.test.mjs +459 -0
  218. package/templates/starter/scripts/playwright-test-title-selection.d.mts +45 -0
  219. package/templates/starter/scripts/run-browser-performance-test-helpers.mjs +0 -27
  220. package/templates/starter/scripts/run-browser-performance.mjs +0 -6
  221. package/templates/starter/scripts/run-browser-performance.test.mjs +5 -13
  222. package/templates/starter/scripts/run-delivery-verification-test-helpers.mjs +0 -34
  223. package/templates/starter/scripts/run-delivery-verification.test.mjs +135 -31
  224. package/templates/starter/scripts/run-feature-verification.mjs +212 -0
  225. package/templates/starter/scripts/run-feature-verification.test.mjs +226 -0
  226. package/templates/starter/scripts/toolcraft-checkpoint-delivery-state.mjs +21 -8
  227. package/templates/starter/scripts/toolcraft-checkpoint-delivery-state.test.mjs +32 -92
  228. package/templates/starter/scripts/toolcraft-checkpoint-transaction.mjs +28 -6
  229. package/templates/starter/scripts/toolcraft-checkpoint-transaction.test.mjs +8 -63
  230. package/templates/starter/scripts/toolcraft-contract-manifest.json +1 -0
  231. package/templates/starter/scripts/toolcraft-delivery-anchor.mjs +28 -8
  232. package/templates/starter/scripts/toolcraft-delivery-anchor.test.mjs +50 -61
  233. package/templates/starter/scripts/toolcraft-delivery-architecture-inventory.mjs +0 -4
  234. package/templates/starter/scripts/toolcraft-delivery-architecture-policy.mjs +0 -1
  235. package/templates/starter/scripts/toolcraft-delivery-evidence.test.mjs +2 -3
  236. package/templates/starter/scripts/toolcraft-delivery-executor.mjs +5 -1
  237. package/templates/starter/scripts/toolcraft-delivery-executor.test.mjs +5 -12
  238. package/templates/starter/scripts/toolcraft-delivery-functional-context.d.mts +1 -48
  239. package/templates/starter/scripts/toolcraft-delivery-functional-context.mjs +2 -30
  240. package/templates/starter/scripts/toolcraft-delivery-functional-context.test.mjs +4 -166
  241. package/templates/starter/scripts/toolcraft-delivery-functional-initial.test.mjs +4 -20
  242. package/templates/starter/scripts/toolcraft-delivery-lifecycle.mjs +43 -192
  243. package/templates/starter/scripts/toolcraft-delivery-performance-iteration-lifecycle.test.mjs +79 -440
  244. package/templates/starter/scripts/toolcraft-delivery-plan-authority.test.mjs +102 -297
  245. package/templates/starter/scripts/toolcraft-delivery-plan-construction.mjs +46 -97
  246. package/templates/starter/scripts/toolcraft-delivery-plan-test-helpers.mjs +125 -0
  247. package/templates/starter/scripts/toolcraft-delivery-plan-validation.test.mjs +58 -0
  248. package/templates/starter/scripts/toolcraft-delivery-plan.d.mts +19 -31
  249. package/templates/starter/scripts/toolcraft-delivery-plan.mjs +254 -252
  250. package/templates/starter/scripts/toolcraft-delivery-plan.test.mjs +29 -457
  251. package/templates/starter/scripts/toolcraft-delivery-receipt-performance.test.mjs +1 -1
  252. package/templates/starter/scripts/toolcraft-delivery-receipt-strictness.test.mjs +3 -72
  253. package/templates/starter/scripts/toolcraft-delivery-receipt-test-helpers.mjs +7 -36
  254. package/templates/starter/scripts/toolcraft-delivery-receipt.d.mts +3 -5
  255. package/templates/starter/scripts/toolcraft-delivery-receipt.mjs +15 -31
  256. package/templates/starter/scripts/toolcraft-delivery-receipt.test.mjs +28 -20
  257. package/templates/starter/scripts/toolcraft-delivery-receipt.types.test.mts +22 -30
  258. package/templates/starter/scripts/toolcraft-feature-verification-plan.d.mts +20 -0
  259. package/templates/starter/scripts/toolcraft-feature-verification-plan.mjs +146 -0
  260. package/templates/starter/scripts/toolcraft-feature-verification-plan.test.mjs +96 -0
  261. package/templates/starter/scripts/toolcraft-functional-proof-model.d.mts +3 -18
  262. package/templates/starter/scripts/toolcraft-functional-proof-model.mjs +39 -127
  263. package/templates/starter/scripts/toolcraft-functional-proof-model.test.mjs +25 -362
  264. package/templates/starter/scripts/toolcraft-functional-proof-model.types.test.mts +6 -83
  265. package/templates/starter/scripts/toolcraft-functional-proof-primitives.d.mts +11 -0
  266. package/templates/starter/scripts/toolcraft-functional-proof-primitives.mjs +61 -0
  267. package/templates/starter/scripts/toolcraft-functional-proof-primitives.test.mjs +43 -0
  268. package/templates/starter/scripts/toolcraft-integrity-policy.mjs +13 -0
  269. package/templates/starter/scripts/toolcraft-integrity-test-utils.mjs +1 -1
  270. package/templates/starter/scripts/toolcraft-layer-evidence-facade.test.mjs +58 -22
  271. package/templates/starter/scripts/toolcraft-motion-reference-analysis-protocol.mjs +111 -0
  272. package/templates/starter/scripts/toolcraft-motion-reference-analysis-protocol.test.mjs +116 -0
  273. package/templates/starter/scripts/toolcraft-motion-reference-artifacts.d.mts +37 -0
  274. package/templates/starter/scripts/toolcraft-motion-reference-artifacts.mjs +308 -0
  275. package/templates/starter/scripts/toolcraft-motion-reference-artifacts.test.mjs +420 -0
  276. package/templates/starter/scripts/toolcraft-motion-reference-artifacts.types.test.mts +50 -0
  277. package/templates/starter/scripts/toolcraft-motion-reference-command-options.mjs +195 -0
  278. package/templates/starter/scripts/toolcraft-motion-reference-command-options.test.mjs +224 -0
  279. package/templates/starter/scripts/toolcraft-motion-reference-contact-sheet.mjs +122 -0
  280. package/templates/starter/scripts/toolcraft-motion-reference-contact-sheet.test.mjs +153 -0
  281. package/templates/starter/scripts/toolcraft-motion-reference-evidence-assembly.mjs +270 -0
  282. package/templates/starter/scripts/toolcraft-motion-reference-evidence.test.mjs +432 -0
  283. package/templates/starter/scripts/toolcraft-motion-reference-ffmpeg-output.mjs +275 -0
  284. package/templates/starter/scripts/toolcraft-motion-reference-ffmpeg-output.test.mjs +294 -0
  285. package/templates/starter/scripts/toolcraft-motion-reference-group-inventory.mjs +148 -0
  286. package/templates/starter/scripts/toolcraft-motion-reference-image-filter-graph.mjs +101 -0
  287. package/templates/starter/scripts/toolcraft-motion-reference-image-filter-graph.test.mjs +124 -0
  288. package/templates/starter/scripts/toolcraft-motion-reference-image-source.mjs +259 -0
  289. package/templates/starter/scripts/toolcraft-motion-reference-image-source.test.mjs +338 -0
  290. package/templates/starter/scripts/toolcraft-motion-reference-image-timing.mjs +96 -0
  291. package/templates/starter/scripts/toolcraft-motion-reference-image-timing.test.mjs +81 -0
  292. package/templates/starter/scripts/toolcraft-motion-reference-lock-recovery.test.mjs +144 -0
  293. package/templates/starter/scripts/toolcraft-motion-reference-media-source.mjs +165 -0
  294. package/templates/starter/scripts/toolcraft-motion-reference-media-source.test.mjs +299 -0
  295. package/templates/starter/scripts/toolcraft-motion-reference-publication-discovery.test.mjs +142 -0
  296. package/templates/starter/scripts/toolcraft-motion-reference-publication-isolation.test.mjs +234 -0
  297. package/templates/starter/scripts/toolcraft-motion-reference-publication-journal-schema.mjs +122 -0
  298. package/templates/starter/scripts/toolcraft-motion-reference-publication-journal-store.mjs +89 -0
  299. package/templates/starter/scripts/toolcraft-motion-reference-publication-journal-store.test.mjs +74 -0
  300. package/templates/starter/scripts/toolcraft-motion-reference-publication-journal.mjs +264 -0
  301. package/templates/starter/scripts/toolcraft-motion-reference-publication-journal.test.mjs +377 -0
  302. package/templates/starter/scripts/toolcraft-motion-reference-publication-lease.mjs +254 -0
  303. package/templates/starter/scripts/toolcraft-motion-reference-publication-lease.test.mjs +130 -0
  304. package/templates/starter/scripts/toolcraft-motion-reference-publication-staging.mjs +128 -0
  305. package/templates/starter/scripts/toolcraft-motion-reference-publication-staging.test.mjs +209 -0
  306. package/templates/starter/scripts/toolcraft-motion-reference-publication.fixtures.mjs +88 -0
  307. package/templates/starter/scripts/toolcraft-motion-reference-publication.mjs +249 -0
  308. package/templates/starter/scripts/toolcraft-motion-reference-publication.test.mjs +433 -0
  309. package/templates/starter/scripts/toolcraft-motion-reference-review-output.mjs +38 -0
  310. package/templates/starter/scripts/toolcraft-motion-reference-review-output.test.mjs +29 -0
  311. package/templates/starter/scripts/toolcraft-motion-reference-root-safety.test.mjs +84 -0
  312. package/templates/starter/scripts/toolcraft-motion-reference-roots.mjs +83 -0
  313. package/templates/starter/scripts/toolcraft-motion-reference-sampling.mjs +283 -0
  314. package/templates/starter/scripts/toolcraft-motion-reference-sampling.test.mjs +480 -0
  315. package/templates/starter/scripts/toolcraft-motion-reference-stage-registry.mjs +39 -0
  316. package/templates/starter/scripts/toolcraft-motion-reference-stage-registry.test.mjs +59 -0
  317. package/templates/starter/scripts/toolcraft-motion-reference-stage.mjs +71 -0
  318. package/templates/starter/scripts/toolcraft-motion-reference-stage.test.mjs +61 -0
  319. package/templates/starter/scripts/toolcraft-motion-review-numeric.mjs +74 -0
  320. package/templates/starter/scripts/toolcraft-motion-review-numeric.test.mjs +65 -0
  321. package/templates/starter/scripts/toolcraft-motion-review-partitioning.mjs +268 -0
  322. package/templates/starter/scripts/toolcraft-motion-review-partitioning.test.mjs +329 -0
  323. package/templates/starter/scripts/toolcraft-motion-review-protected-units.mjs +120 -0
  324. package/templates/starter/scripts/toolcraft-motion-review-protected-units.test.mjs +111 -0
  325. package/templates/starter/scripts/toolcraft-performance-escalation-policy.test.mjs +77 -345
  326. package/templates/starter/scripts/toolcraft-performance-receipt-validation.test.mjs +19 -21
  327. package/templates/starter/scripts/toolcraft-product-boundary-ast.mjs +85 -115
  328. package/templates/starter/scripts/toolcraft-product-boundary-module-policy.mjs +101 -0
  329. package/templates/starter/scripts/toolcraft-product-boundary.test.mjs +0 -72
  330. package/templates/starter/scripts/toolcraft-product-control-bindings.mjs +182 -0
  331. package/templates/starter/scripts/toolcraft-product-control-boundary.mjs +146 -0
  332. package/templates/starter/scripts/toolcraft-product-control-boundary.test.mjs +186 -0
  333. package/templates/starter/scripts/toolcraft-product-export-boundary.mjs +16 -18
  334. package/templates/starter/scripts/toolcraft-product-export-boundary.test.mjs +200 -0
  335. package/templates/starter/scripts/toolcraft-product-observable-facade.test.mjs +46 -1
  336. package/templates/starter/scripts/toolcraft-receipt-boundary.test.mjs +0 -1
  337. package/templates/starter/scripts/toolcraft-source-inventory.d.mts +5 -0
  338. package/templates/starter/scripts/toolcraft-source-inventory.mjs +25 -14
  339. package/templates/starter/scripts/toolcraft-source-inventory.test.mjs +48 -0
  340. package/templates/starter/scripts/toolcraft-source-ownership.mjs +0 -1
  341. package/templates/starter/scripts/toolcraft-source-ownership.test.mjs +30 -5
  342. package/templates/starter/scripts/toolcraft-typescript-source-evidence-structure.test.mjs +20 -0
  343. package/templates/starter/scripts/toolcraft-typescript-source-evidence.mjs +1 -0
  344. package/templates/starter/scripts/toolcraft-unavailable-resource-evidence-facade.test.mjs +2 -0
  345. package/templates/starter/scripts/toolcraft-verification-receipt-test-helpers.mjs +5 -26
  346. package/templates/starter/scripts/toolcraft-verification-receipt.d.mts +0 -7
  347. package/templates/starter/scripts/toolcraft-verification-receipt.mjs +3 -47
  348. package/templates/starter/scripts/toolcraft-verification-receipt.test.mjs +6 -87
  349. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.d.mts +19 -0
  350. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.mjs +107 -0
  351. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.test.mjs +114 -0
  352. package/templates/starter/scripts/toolcraft-vitest-runtime-evidence-reporter.mjs +13 -2
  353. package/templates/starter/scripts/toolcraft-vitest-runtime-evidence-reporter.test.mjs +110 -0
  354. package/templates/starter/src/app/acceptance/artifact-export-intent.ts +161 -0
  355. package/templates/starter/src/app/acceptance/canvas-coverage.ts +1 -0
  356. package/templates/starter/src/app/acceptance/color-bank-labels.ts +11 -15
  357. package/templates/starter/src/app/acceptance/color-row-grouping.ts +33 -0
  358. package/templates/starter/src/app/acceptance/conditions.ts +1 -1
  359. package/templates/starter/src/app/acceptance/control-acceptance-context.ts +2 -2
  360. package/templates/starter/src/app/acceptance/control-acceptance-coverage.ts +6 -31
  361. package/templates/starter/src/app/acceptance/control-acceptance-kind-rules.ts +24 -5
  362. package/templates/starter/src/app/acceptance/control-acceptance-policy.ts +4 -16
  363. package/templates/starter/src/app/acceptance/control-applicability-cases.test.ts +321 -0
  364. package/templates/starter/src/app/acceptance/control-applicability-cases.ts +290 -0
  365. package/templates/starter/src/app/acceptance/control-applicability.ts +332 -0
  366. package/templates/starter/src/app/acceptance/control-component-rules.ts +0 -10
  367. package/templates/starter/src/app/acceptance/control-labels.ts +30 -1
  368. package/templates/starter/src/app/acceptance/control-layout-dependency-rules.ts +20 -9
  369. package/templates/starter/src/app/acceptance/control-layout-entity-rules.ts +4 -6
  370. package/templates/starter/src/app/acceptance/control-layout-model.ts +4 -4
  371. package/templates/starter/src/app/acceptance/control-layout-section-rules.ts +21 -10
  372. package/templates/starter/src/app/acceptance/control-parts.ts +8 -0
  373. package/templates/starter/src/app/acceptance/control-section-entity-cohesion.test.ts +215 -0
  374. package/templates/starter/src/app/acceptance/control-section-entity-cohesion.ts +132 -0
  375. package/templates/starter/src/app/acceptance/control-section-inventory.test.ts +87 -0
  376. package/templates/starter/src/app/acceptance/control-section-inventory.ts +74 -44
  377. package/templates/starter/src/app/acceptance/custom-controls.ts +11 -3
  378. package/templates/starter/src/app/acceptance/export-artifact-coverage.ts +25 -17
  379. package/templates/starter/src/app/acceptance/feature-verification-selection.test.ts +295 -0
  380. package/templates/starter/src/app/acceptance/feature-verification-selection.ts +161 -0
  381. package/templates/starter/src/app/acceptance/infinity-canvas.ts +10 -0
  382. package/templates/starter/src/app/acceptance/inline-layout.ts +64 -9
  383. package/templates/starter/src/app/acceptance/interaction-ownership-intent.ts +19 -1
  384. package/templates/starter/src/app/acceptance/interaction-ownership.ts +18 -2
  385. package/templates/starter/src/app/acceptance/media-upload.ts +5 -1
  386. package/templates/starter/src/app/acceptance/motion-reference-evidence-validation.mjs +65 -0
  387. package/templates/starter/src/app/acceptance/motion-reference-evidence-windows.mjs +301 -0
  388. package/templates/starter/src/app/acceptance/motion-reference-evidence.d.mts +11 -0
  389. package/templates/starter/src/app/acceptance/motion-reference-evidence.mjs +145 -0
  390. package/templates/starter/src/app/acceptance/motion-reference-study-behaviors.ts +162 -0
  391. package/templates/starter/src/app/acceptance/motion-reference-study-coverage.ts +206 -0
  392. package/templates/starter/src/app/acceptance/motion-reference-study-identity.ts +129 -0
  393. package/templates/starter/src/app/acceptance/motion-reference-study-partitions.ts +186 -0
  394. package/templates/starter/src/app/acceptance/motion-reference-study.ts +90 -0
  395. package/templates/starter/src/app/acceptance/orientation-gizmo.ts +18 -11
  396. package/templates/starter/src/app/acceptance/output-background-rules.ts +2 -2
  397. package/templates/starter/src/app/acceptance/output-export-actions.test.ts +9 -1
  398. package/templates/starter/src/app/acceptance/output-export-actions.ts +14 -22
  399. package/templates/starter/src/app/acceptance/output-export-layout-rules.ts +22 -10
  400. package/templates/starter/src/app/acceptance/output-export-model.ts +58 -11
  401. package/templates/starter/src/app/acceptance/output-export.ts +25 -10
  402. package/templates/starter/src/app/acceptance/output-video-export-rules.ts +99 -0
  403. package/templates/starter/src/app/acceptance/reference-study-types.ts +167 -17
  404. package/templates/starter/src/app/acceptance/runtime-coverage.ts +6 -1
  405. package/templates/starter/src/app/acceptance/selection-scope.test.ts +200 -0
  406. package/templates/starter/src/app/acceptance/selection-scope.ts +151 -0
  407. package/templates/starter/src/app/acceptance/transfer-mode-types.ts +114 -0
  408. package/templates/starter/src/app/acceptance/types.ts +65 -125
  409. package/templates/starter/src/app/acceptance/validate-coverage.ts +33 -5
  410. package/templates/starter/src/app/starter-acceptance-data.ts +1 -0
  411. package/templates/starter/src/app/starter-acceptance.animation-intent.test.ts +3 -0
  412. package/templates/starter/src/app/starter-acceptance.artifact-export-intent.test.ts +312 -0
  413. package/templates/starter/src/app/starter-acceptance.background-export.test.ts +35 -0
  414. package/templates/starter/src/app/starter-acceptance.canvas-sizing.test.ts +18 -1
  415. package/templates/starter/src/app/starter-acceptance.color-row-grouping.test.ts +118 -0
  416. package/templates/starter/src/app/starter-acceptance.compound-part-coverage.test.ts +66 -1
  417. package/templates/starter/src/app/starter-acceptance.contract-fixtures.test.ts +41 -0
  418. package/templates/starter/src/app/starter-acceptance.contract-fixtures.ts +113 -16
  419. package/templates/starter/src/app/starter-acceptance.control-applicability.test.ts +225 -0
  420. package/templates/starter/src/app/starter-acceptance.control-label-context.test.ts +1 -0
  421. package/templates/starter/src/app/starter-acceptance.control-labels.test.ts +78 -3
  422. package/templates/starter/src/app/starter-acceptance.control-naming-rules.test.ts +77 -1
  423. package/templates/starter/src/app/starter-acceptance.control-order.test.ts +58 -3
  424. package/templates/starter/src/app/starter-acceptance.control-state.test.ts +0 -111
  425. package/templates/starter/src/app/starter-acceptance.custom-control-collections.test.ts +3 -1
  426. package/templates/starter/src/app/starter-acceptance.custom-control-fit-check.test.ts +1 -1
  427. package/templates/starter/src/app/starter-acceptance.custom-control-valid.test.ts +1 -1
  428. package/templates/starter/src/app/starter-acceptance.export-artifact.test.ts +74 -3
  429. package/templates/starter/src/app/starter-acceptance.export-test-utils.ts +26 -0
  430. package/templates/starter/src/app/{starter-acceptance.image-video-export-settings.test.ts → starter-acceptance.image-export-settings.test.ts} +39 -9
  431. package/templates/starter/src/app/starter-acceptance.interaction-ownership.test.ts +31 -3
  432. package/templates/starter/src/app/starter-acceptance.layers.test.ts +2 -1
  433. package/templates/starter/src/app/starter-acceptance.media-upload.fixtures.ts +11 -1
  434. package/templates/starter/src/app/starter-acceptance.media-upload.test.ts +56 -0
  435. package/templates/starter/src/app/starter-acceptance.motion-reference-evidence.test.ts +17 -0
  436. package/templates/starter/src/app/starter-acceptance.motion-reference-identity.test.ts +163 -0
  437. package/templates/starter/src/app/starter-acceptance.motion-reference-mapping.test.ts +133 -0
  438. package/templates/starter/src/app/starter-acceptance.motion-reference-ownership.test.ts +121 -0
  439. package/templates/starter/src/app/starter-acceptance.motion-reference-partitions.test.ts +210 -0
  440. package/templates/starter/src/app/starter-acceptance.motion-reference-test-utils.ts +313 -0
  441. package/templates/starter/src/app/starter-acceptance.output-export-intent.test.ts +458 -0
  442. package/templates/starter/src/app/starter-acceptance.output-export-rules.test.ts +4 -0
  443. package/templates/starter/src/app/starter-acceptance.product-output-export.test.ts +116 -104
  444. package/templates/starter/src/app/starter-acceptance.product-readiness.test.ts +29 -0
  445. package/templates/starter/src/app/starter-acceptance.product-worklog.test.ts +123 -2
  446. package/templates/starter/src/app/starter-acceptance.reference-custom-timeline.test.ts +2 -0
  447. package/templates/starter/src/app/starter-acceptance.reference-foundation.test.ts +8 -0
  448. package/templates/starter/src/app/starter-acceptance.reference-timeline.test.ts +7 -0
  449. package/templates/starter/src/app/starter-acceptance.section-cohesion.test.ts +3 -1
  450. package/templates/starter/src/app/starter-acceptance.section-dependencies.test.ts +35 -24
  451. package/templates/starter/src/app/starter-acceptance.section-size.test.ts +72 -0
  452. package/templates/starter/src/app/starter-acceptance.timeline-playback.test.ts +5 -0
  453. package/templates/starter/src/app/starter-acceptance.ts +45 -10
  454. package/templates/starter/src/app/starter-acceptance.video-export-settings.test.ts +338 -0
  455. package/templates/starter/src/app/starter-acceptance.video-reference-study.test.ts +34 -236
  456. package/templates/starter/src/app/starter-acceptance.view-interaction.test.ts +12 -0
  457. package/templates/starter/src/app/starter-acceptance.worklog-test-utils.ts +122 -6
  458. package/templates/starter/src/app/starter-acceptance.worklog.test.ts +152 -16
  459. package/templates/starter/src/app/starter-performance.gates.test.ts +20 -18
  460. package/templates/starter/src/app/starter-performance.lifecycle.test.ts +22 -6
  461. package/templates/starter/src/app/test-evidence/browser-runtime-contract.ts +5 -2
  462. package/templates/starter/src/routes/index.tsx +1 -0
  463. package/templates/starter/tsconfig.json +1 -0
  464. package/templates/ui/components/composites/tabs.tsx +2 -2
  465. package/templates/ui/components/controls/collection-actions/collection-item-groups.test.tsx +38 -0
  466. package/templates/ui/components/controls/collection-actions/collection-item-groups.tsx +36 -0
  467. package/templates/ui/components/controls/collection-actions/index.ts +2 -0
  468. package/templates/ui/components/controls/file-drop/file-drop-collection-control.tsx +137 -0
  469. package/templates/ui/components/controls/file-drop/file-drop-control.test.tsx +189 -0
  470. package/templates/ui/components/controls/file-drop/file-drop-control.tsx +81 -88
  471. package/templates/ui/components/controls/file-drop/file-drop-presentation.tsx +131 -9
  472. package/templates/ui/components/controls/file-drop/file-drop-types.ts +36 -22
  473. package/templates/ui/components/controls/file-drop/index.ts +1 -0
  474. package/templates/ui/components/controls/index.ts +3 -0
  475. package/templates/ui/components/controls/range-slider/range-slider-control.tsx +1 -1
  476. package/templates/ui/components/controls/range-slider/range-slider-value.test.ts +14 -0
  477. package/templates/ui/components/controls/range-slider/range-slider-value.ts +3 -2
  478. package/templates/starter/scripts/toolcraft-browser-impact-selection.mjs +0 -26
  479. package/templates/starter/scripts/toolcraft-delivery-framework-refresh.test.mjs +0 -141
  480. package/templates/starter/scripts/toolcraft-delivery-functional-changed.test.mjs +0 -468
  481. package/templates/starter/scripts/toolcraft-delivery-functional-model-lifecycle.test.mjs +0 -254
  482. package/templates/starter/scripts/toolcraft-delivery-functional-semantic-regression.test.mjs +0 -135
  483. package/templates/starter/scripts/toolcraft-delivery-performance-iteration-durability.test.mjs +0 -329
  484. package/templates/starter/scripts/toolcraft-delivery-plan-errors.test.mjs +0 -430
  485. package/templates/starter/scripts/toolcraft-delivery-plan-functional-model.test.mjs +0 -358
  486. package/templates/starter/scripts/toolcraft-functional-proof-regression-fixtures.mjs +0 -298
  487. package/templates/starter/scripts/toolcraft-verification-impact-inventory.d.mts +0 -62
  488. package/templates/starter/scripts/toolcraft-verification-impact-inventory.mjs +0 -344
  489. package/templates/starter/scripts/toolcraft-verification-impact-inventory.test.mjs +0 -204
  490. package/templates/starter/scripts/toolcraft-verification-impact-performance-candidates.test.mjs +0 -210
  491. package/templates/starter/scripts/toolcraft-verification-impact-resolution.mjs +0 -344
  492. package/templates/starter/scripts/toolcraft-verification-impact-resolution.test.mjs +0 -270
  493. package/templates/starter/scripts/toolcraft-verification-impact-semantic-resolution.test.mjs +0 -449
  494. package/templates/starter/scripts/toolcraft-verification-impact-support-resolution.test.mjs +0 -195
  495. package/templates/starter/scripts/toolcraft-verification-impact.d.mts +0 -132
  496. package/templates/starter/scripts/toolcraft-verification-impact.mjs +0 -169
  497. package/templates/starter/scripts/toolcraft-verification-impact.test.mjs +0 -300
  498. package/templates/starter/scripts/toolcraft-verification-input-roles.mjs +0 -197
  499. package/templates/starter/scripts/toolcraft-verification-input-roles.test.mjs +0 -225
  500. package/templates/starter/src/app/acceptance/condition-exclusivity.test.ts +0 -60
  501. package/templates/starter/src/app/acceptance/condition-exclusivity.ts +0 -221
  502. package/templates/starter/src/app/acceptance/video-reference-study.ts +0 -217
  503. package/templates/starter/src/app/starter-verification-impact.json +0 -15
@@ -2,6 +2,7 @@ import { expect, test } from "@playwright/test";
2
2
 
3
3
  import {
4
4
  createToolcraftBrowserProofSession,
5
+ getToolcraftBrowserActionSurface,
5
6
  getToolcraftBrowserActionTarget,
6
7
  runToolcraftBrowserAction,
7
8
  runToolcraftBrowserValueAction,
@@ -133,6 +134,7 @@ test("target-scoped actions resolve the exact field inside a grouped control", a
133
134
  });
134
135
 
135
136
  expect(getToolcraftBrowserActionTarget(action)).toBe("appearance.stroke");
137
+ expect(getToolcraftBrowserActionSurface(action)).toBe("panel");
136
138
  await runToolcraftBrowserAction(action);
137
139
  await expect(
138
140
  page.locator('button[data-target="appearance.stroke"]'),
@@ -170,6 +172,89 @@ test("target-scoped actions resolve the exact field inside a grouped control", a
170
172
  );
171
173
  });
172
174
 
175
+ test("surface actions verify Canvas and Panel locator provenance", async ({
176
+ page,
177
+ }) => {
178
+ await page.goto("/");
179
+ const session = await createToolcraftBrowserProofSession(page);
180
+ await page.locator(TOOLCRAFT_APP_ROOT_SELECTOR).evaluate((root) => {
181
+ const canvas = root.querySelector('[data-slot="toolcraft-runtime-canvas"]');
182
+ const panel = root.querySelector("[data-toolcraft-controls-panel-shell]");
183
+ if (!canvas || !panel) {
184
+ throw new Error("Missing runtime surfaces for proof-session fixture.");
185
+ }
186
+ for (const [owner, id] of [
187
+ [canvas, "surface-canvas"],
188
+ [panel, "surface-panel"],
189
+ ] as const) {
190
+ const button = document.createElement("button");
191
+ button.id = id;
192
+ button.type = "button";
193
+ button.textContent = id;
194
+ if (id === "surface-canvas") {
195
+ Object.assign(button.style, {
196
+ left: "16px",
197
+ position: "absolute",
198
+ top: "16px",
199
+ zIndex: "50",
200
+ });
201
+ }
202
+ button.addEventListener("click", () => {
203
+ button.dataset.clicked = "true";
204
+ });
205
+ button.addEventListener("pointerdown", (event) => {
206
+ event.stopPropagation();
207
+ });
208
+ owner.append(button);
209
+ }
210
+ });
211
+
212
+ const canvasAction = session.surfaceAction("selection.active", {
213
+ selector: "#surface-canvas",
214
+ surface: "canvas",
215
+ });
216
+ const panelAction = session.surfaceAction("selection.active", {
217
+ selector: "#surface-panel",
218
+ surface: "panel",
219
+ });
220
+ expect(getToolcraftBrowserActionSurface(canvasAction)).toBe("canvas");
221
+ expect(getToolcraftBrowserActionSurface(panelAction)).toBe("panel");
222
+ await runToolcraftBrowserAction(canvasAction);
223
+ await runToolcraftBrowserAction(panelAction);
224
+ await expect(page.locator("#surface-canvas")).toHaveAttribute(
225
+ "data-clicked",
226
+ "true",
227
+ );
228
+ await expect(page.locator("#surface-panel")).toHaveAttribute(
229
+ "data-clicked",
230
+ "true",
231
+ );
232
+
233
+ await expect(
234
+ runToolcraftBrowserAction(
235
+ session.surfaceAction("selection.active", {
236
+ selector: "#surface-panel",
237
+ surface: "canvas",
238
+ }),
239
+ ),
240
+ ).rejects.toThrow(/declared canvas runtime surface/u);
241
+ await expect(
242
+ runToolcraftBrowserAction(
243
+ session.surfaceAction("selection.active", {
244
+ selector: "#missing-surface",
245
+ surface: "canvas",
246
+ }),
247
+ ),
248
+ ).rejects.toThrow(/resolve exactly once/u);
249
+ expect(() =>
250
+ session.surfaceAction("selection.active", {
251
+ position: { x: -1, y: 0 },
252
+ selector: "#surface-canvas",
253
+ surface: "canvas",
254
+ }),
255
+ ).toThrow(/finite nonnegative coordinates/u);
256
+ });
257
+
173
258
  test("proof sessions reject pages without the Toolcraft app identity", async ({ page }) => {
174
259
  await page.setContent('<main data-slot="toolcraft-runtime-app"></main>');
175
260
 
@@ -133,7 +133,7 @@ test("control schema derives segmented and discrete runtime evidence", () => {
133
133
  );
134
134
  });
135
135
 
136
- test("typed visibility and background coverage derive dedicated semantic evidence", () => {
136
+ test("typed background coverage derives dedicated semantic evidence", () => {
137
137
  const schema = defineToolcraft({
138
138
  canvas: { enabled: true },
139
139
  panels: {
@@ -141,19 +141,6 @@ test("typed visibility and background coverage derive dedicated semantic evidenc
141
141
  sections: [
142
142
  {
143
143
  controls: {
144
- conditional: {
145
- defaultValue: 1,
146
- label: "Conditional",
147
- target: "feature.conditional",
148
- type: "slider",
149
- visibleWhen: { equals: true, target: "feature.enabled" },
150
- },
151
- enabled: {
152
- defaultValue: false,
153
- label: "Enabled",
154
- target: "feature.enabled",
155
- type: "switch",
156
- },
157
144
  includeBackground: {
158
145
  defaultValue: true,
159
146
  label: "Include",
@@ -181,14 +168,6 @@ test("typed visibility and background coverage derive dedicated semantic evidenc
181
168
  });
182
169
  const requirements = deriveToolcraftBrowserRuntimeRequirements(
183
170
  [
184
- {
185
- browser: true,
186
- browserTestName: "browser: conditional visibility",
187
- evidence: "product-output",
188
- id: "feature.conditional",
189
- target: "feature.conditional",
190
- visibilityCoverage: ["hidden", "visible"],
191
- },
192
171
  {
193
172
  backgroundOutputCoverage: [
194
173
  "preview-hidden-when-excluded",
@@ -205,17 +184,6 @@ test("typed visibility and background coverage derive dedicated semantic evidenc
205
184
  ],
206
185
  schema,
207
186
  );
208
-
209
- expect(
210
- requirements
211
- .filter((requirement) => requirement.requirementId === "feature.conditional")
212
- .map((requirement) => requirement.evidenceType),
213
- ).toEqual(
214
- expect.arrayContaining([
215
- "conditional-control-hidden",
216
- "conditional-control-visible",
217
- ]),
218
- );
219
187
  expect(
220
188
  requirements
221
189
  .filter((requirement) => requirement.requirementId === "export.includeBackground")
@@ -230,6 +198,56 @@ test("typed visibility and background coverage derive dedicated semantic evidenc
230
198
  );
231
199
  });
232
200
 
201
+ test("typed SVG coverage derives only protected SVG artifact evidence", () => {
202
+ const requirements = deriveToolcraftBrowserRuntimeRequirements([
203
+ {
204
+ browser: true,
205
+ browserTestName: "browser: SVG export",
206
+ evidence: "exported-bytes",
207
+ exportArtifactCoverage: "all-required-svg-export-behavior",
208
+ id: "actions.svg",
209
+ target: "actions.output",
210
+ },
211
+ ]);
212
+
213
+ expect(requirements).toEqual([
214
+ {
215
+ evidenceType: "svg-export-artifact",
216
+ requirementId: "actions.svg",
217
+ target: "actions.output",
218
+ testName: "browser: SVG export",
219
+ },
220
+ ]);
221
+ });
222
+
223
+ test("selected-entity coverage adds protected selection isolation evidence", () => {
224
+ const requirements = deriveToolcraftBrowserRuntimeRequirements([
225
+ {
226
+ browser: true,
227
+ browserTestName: "browser: selected shape fill",
228
+ evidence: "product-output",
229
+ id: "shape.selected-fill",
230
+ selectionScopeCoverage: "two-entity-isolation",
231
+ target: "selectedShape.fill",
232
+ },
233
+ ]);
234
+
235
+ expect(requirements).toEqual([
236
+ {
237
+ evidenceType: "product-observable-change",
238
+ requirementId: "shape.selected-fill",
239
+ target: "selectedShape.fill",
240
+ testName: "browser: selected shape fill",
241
+ },
242
+ {
243
+ evidenceType: "selection-scoped-control",
244
+ requirementId: "shape.selected-fill",
245
+ target: "selectedShape.fill",
246
+ testName: "browser: selected shape fill",
247
+ },
248
+ ]);
249
+ });
250
+
233
251
  test("typed Infinity canvas coverage derives dedicated semantic evidence", () => {
234
252
  const requirements = deriveToolcraftBrowserRuntimeRequirements([
235
253
  {
@@ -248,6 +266,14 @@ test("typed Infinity canvas coverage derives dedicated semantic evidence", () =>
248
266
  infinityCanvasCoverage: "scene-bounds-image-export",
249
267
  target: "actions.output",
250
268
  },
269
+ {
270
+ browser: true,
271
+ browserTestName: "browser: Infinity canvas SVG export",
272
+ evidence: "exported-bytes",
273
+ id: "canvas.infinity.svgExport",
274
+ infinityCanvasCoverage: "scene-bounds-svg-export",
275
+ target: "actions.output",
276
+ },
251
277
  ]);
252
278
 
253
279
  expect(
@@ -265,6 +291,10 @@ test("typed Infinity canvas coverage derives dedicated semantic evidence", () =>
265
291
  evidenceType: "infinity-scene-bounds-image-export",
266
292
  requirementId: "canvas.infinity.imageExport",
267
293
  },
294
+ {
295
+ evidenceType: "infinity-scene-bounds-svg-export",
296
+ requirementId: "canvas.infinity.svgExport",
297
+ },
268
298
  ]),
269
299
  );
270
300
  });
@@ -0,0 +1,137 @@
1
+ import { expect, test } from "@playwright/test";
2
+
3
+ import { createToolcraftBrowserProofSession } from "./browser-proof-session";
4
+ import { expectToolcraftSelectionScopedControl } from "./browser-selection-scope-evidence";
5
+ import {
6
+ attachedEvidenceTypes,
7
+ editSyntheticSelectedEntity,
8
+ mountSyntheticSelectionScene,
9
+ } from "./browser-semantic-evidence-test-helpers";
10
+
11
+ const propertyTarget = "selectedShape.fill";
12
+ const selectionTarget = "selection.activeShape";
13
+ const entityA = {
14
+ entityId: "shape-a",
15
+ selector: '[data-proof-entity="shape-a"]',
16
+ } as const;
17
+ const entityB = {
18
+ entityId: "shape-b",
19
+ selector: '[data-proof-entity="shape-b"]',
20
+ } as const;
21
+
22
+ async function createSelectionProofFixture(
23
+ page: Parameters<typeof createToolcraftBrowserProofSession>[0],
24
+ ) {
25
+ await page.goto("/");
26
+ const session = await createToolcraftBrowserProofSession(page);
27
+ await mountSyntheticSelectionScene(page, {
28
+ controlValue: "#371C4D",
29
+ fills: { "shape-a": "#A65F15", "shape-b": "#371C4D" },
30
+ selectedEntityId: "shape-b",
31
+ });
32
+
33
+ return {
34
+ observePropertyValue: session.observe((root) =>
35
+ JSON.parse(root.getAttribute("data-proof-selection-scope") ?? "null")
36
+ .controlValue,
37
+ ),
38
+ observeSelectedEntityId: session.observe((root) =>
39
+ String(
40
+ JSON.parse(root.getAttribute("data-proof-selection-scope") ?? "null")
41
+ .selectedEntityId,
42
+ ),
43
+ ),
44
+ proofSession: session,
45
+ };
46
+ }
47
+
48
+ function createSelectionActions(
49
+ session: Awaited<
50
+ ReturnType<typeof createSelectionProofFixture>
51
+ >["proofSession"],
52
+ ) {
53
+ return {
54
+ selectEntityA: session.surfaceAction(selectionTarget, {
55
+ selector: entityA.selector,
56
+ surface: "canvas",
57
+ }),
58
+ selectEntityB: session.surfaceAction(selectionTarget, {
59
+ selector: entityB.selector,
60
+ surface: "canvas",
61
+ }),
62
+ };
63
+ }
64
+
65
+ test("selection-scoped control proves two-direction entity isolation", async ({
66
+ page,
67
+ }, testInfo) => {
68
+ const fixture = await createSelectionProofFixture(page);
69
+ const attachmentCount = testInfo.attachments.length;
70
+
71
+ await expectToolcraftSelectionScopedControl({
72
+ ...fixture,
73
+ ...createSelectionActions(fixture.proofSession),
74
+ editEntityA: fixture.proofSession.controlAction(
75
+ propertyTarget,
76
+ (_control, currentPage) =>
77
+ editSyntheticSelectedEntity(currentPage, "#00AAFF"),
78
+ ),
79
+ editEntityB: fixture.proofSession.controlAction(
80
+ propertyTarget,
81
+ (_control, currentPage) =>
82
+ editSyntheticSelectedEntity(currentPage, "#FF44AA"),
83
+ ),
84
+ entityA,
85
+ entityB,
86
+ propertySurface: "panel",
87
+ propertyTarget,
88
+ requirementId: "shape.selected-fill",
89
+ selectionSurface: "canvas",
90
+ selectionTarget,
91
+ stabilityIntervalMs: 0,
92
+ });
93
+
94
+ expect(attachedEvidenceTypes(testInfo, attachmentCount)).toEqual([
95
+ "product-observable-change",
96
+ "selection-scoped-control",
97
+ ]);
98
+ });
99
+
100
+ test("selection-scoped control rejects cross-entity mutation without evidence", async ({
101
+ page,
102
+ }, testInfo) => {
103
+ const fixture = await createSelectionProofFixture(page);
104
+ const attachmentCount = testInfo.attachments.length;
105
+
106
+ await expect(
107
+ expectToolcraftSelectionScopedControl({
108
+ ...fixture,
109
+ ...createSelectionActions(fixture.proofSession),
110
+ editEntityA: fixture.proofSession.controlAction(
111
+ propertyTarget,
112
+ async (_control, currentPage) => {
113
+ await editSyntheticSelectedEntity(currentPage, "#00AAFF");
114
+ await currentPage
115
+ .locator(entityB.selector)
116
+ .evaluate((entity) => {
117
+ (entity as HTMLElement).style.background = "#FFFFFF";
118
+ });
119
+ },
120
+ ),
121
+ editEntityB: fixture.proofSession.controlAction(
122
+ propertyTarget,
123
+ (_control, currentPage) =>
124
+ editSyntheticSelectedEntity(currentPage, "#FF44AA"),
125
+ ),
126
+ entityA,
127
+ entityB,
128
+ propertySurface: "panel",
129
+ propertyTarget,
130
+ requirementId: "shape.cross-entity-fill",
131
+ selectionSurface: "canvas",
132
+ selectionTarget,
133
+ stabilityIntervalMs: 0,
134
+ }),
135
+ ).rejects.toThrow();
136
+ expect(testInfo.attachments).toHaveLength(attachmentCount);
137
+ });
@@ -1,8 +1,6 @@
1
1
  import { expect, test } from "@playwright/test";
2
- import {
3
- expectToolcraftBackgroundOutputSemantics,
4
- expectToolcraftConditionalControlVisibility,
5
- } from "./browser-conditional-output-evidence-helpers";
2
+ import { expectToolcraftBackgroundOutputSemantics } from "./browser-background-output-evidence";
3
+ import { expectToolcraftControlApplicabilityState } from "./browser-control-applicability-evidence";
6
4
  import {
7
5
  expectToolcraftLayerReorder,
8
6
  expectToolcraftLayerSelection,
@@ -12,6 +10,7 @@ import {
12
10
  attachedEvidenceTypes,
13
11
  setProofState,
14
12
  setSyntheticControlOwner,
13
+ setSyntheticSwitchControlOwner,
15
14
  } from "./browser-semantic-evidence-test-helpers";
16
15
  import {
17
16
  expectToolcraftMediaLifecycle,
@@ -315,34 +314,81 @@ test("timeline recipes bind duration to renderer, keyframes to output, and loops
315
314
  ]);
316
315
  });
317
316
 
318
- test("conditional visibility recipe proves target absence and restoration through the gating control", async ({
317
+ test("control applicability recipe proves exact target absence and presence", async ({
319
318
  page,
320
319
  }, testInfo) => {
321
320
  await page.goto("/");
322
321
  const session = await createToolcraftBrowserProofSession(page);
323
322
  const attachmentCount = testInfo.attachments.length;
324
- await setSyntheticControlOwner(page, "feature.enabled", true);
323
+ await setSyntheticSwitchControlOwner(page, "feature.enabled", false);
325
324
  await setSyntheticControlOwner(page, "feature.conditional", true);
326
325
 
327
- await expectToolcraftConditionalControlVisibility(
326
+ const hiddenCase = {
327
+ expectation: "hidden" as const,
328
+ selectorControlType: "switch" as const,
329
+ selectorLabel: "feature.enabled",
330
+ selectorTarget: "feature.enabled",
331
+ selectorValue: false,
332
+ target: "feature.conditional",
333
+ };
334
+ const visibleCase = {
335
+ ...hiddenCase,
336
+ expectation: "visible" as const,
337
+ selectorValue: true,
338
+ };
339
+ const mismatchedAction = session.controlAction(
340
+ "feature.other",
341
+ () => undefined,
342
+ );
343
+
344
+ await expect(
345
+ expectToolcraftControlApplicabilityState(
346
+ session,
347
+ mismatchedAction,
348
+ hiddenCase,
349
+ { baseRequirementId: "feature.conditional", timeoutMs: 50 },
350
+ ),
351
+ ).rejects.toThrow(/target-scoped selector action/);
352
+ expect(testInfo.attachments).toHaveLength(attachmentCount);
353
+
354
+ await expect(
355
+ expectToolcraftControlApplicabilityState(
356
+ session,
357
+ session.controlAction("feature.enabled", () => undefined),
358
+ hiddenCase,
359
+ { baseRequirementId: "feature.conditional", timeoutMs: 50 },
360
+ ),
361
+ ).rejects.toThrow(/should be hidden/);
362
+ expect(testInfo.attachments).toHaveLength(attachmentCount);
363
+
364
+ await expectToolcraftControlApplicabilityState(
328
365
  session,
329
366
  session.controlAction("feature.enabled", (control, currentPage) => {
330
367
  expect(control).toBeTruthy();
331
- return setSyntheticControlOwner(currentPage, "feature.conditional", false);
368
+ return Promise.all([
369
+ setSyntheticSwitchControlOwner(currentPage, "feature.enabled", false),
370
+ setSyntheticControlOwner(currentPage, "feature.conditional", false),
371
+ ]).then(() => undefined);
332
372
  }),
373
+ hiddenCase,
374
+ { baseRequirementId: "feature.conditional" },
375
+ );
376
+ await expectToolcraftControlApplicabilityState(
377
+ session,
333
378
  session.controlAction("feature.enabled", (control, currentPage) => {
334
379
  expect(control).toBeTruthy();
335
- return setSyntheticControlOwner(currentPage, "feature.conditional", true);
380
+ return Promise.all([
381
+ setSyntheticSwitchControlOwner(currentPage, "feature.enabled", true),
382
+ setSyntheticControlOwner(currentPage, "feature.conditional", true),
383
+ ]).then(() => undefined);
336
384
  }),
337
- {
338
- requirementId: "feature.conditional",
339
- target: "feature.conditional",
340
- },
385
+ visibleCase,
386
+ { baseRequirementId: "feature.conditional" },
341
387
  );
342
388
 
343
389
  expect(attachedEvidenceTypes(testInfo, attachmentCount)).toEqual([
344
- "conditional-control-hidden",
345
- "conditional-control-visible",
390
+ "control-applicability-hidden",
391
+ "control-applicability-visible",
346
392
  ]);
347
393
  });
348
394
 
@@ -2,20 +2,12 @@ import { expect } from "@playwright/test";
2
2
 
3
3
  import { attachToolcraftBrowserRuntimeEvidence } from "./browser-runtime-evidence";
4
4
  import {
5
- countToolcraftControlOwnersByTarget,
6
- getToolcraftControlFieldByTarget,
7
- } from "./browser-control-target-helpers";
8
- import {
9
- assertToolcraftBrowserActionForSession,
10
5
  assertToolcraftBrowserProofSession,
11
6
  getToolcraftBrowserActionTarget,
12
- getToolcraftBrowserProofPage,
13
7
  readToolcraftBrowserObservation,
14
- runToolcraftBrowserAction,
15
8
  runToolcraftBrowserValueAction,
16
9
  type ToolcraftBrowserAction,
17
10
  type ToolcraftBrowserObservation,
18
- type ToolcraftBrowserProofSession,
19
11
  } from "./browser-proof-session";
20
12
  import {
21
13
  assertToolcraftProducedArtifact,
@@ -77,66 +69,6 @@ function validateBackgroundPreviewObservation(
77
69
  ).not.toBe("");
78
70
  }
79
71
 
80
- export async function expectToolcraftConditionalControlVisibility(
81
- session: ToolcraftBrowserProofSession,
82
- hideControl: ToolcraftBrowserAction,
83
- showControl: ToolcraftBrowserAction,
84
- {
85
- requirementId,
86
- target,
87
- timeoutMs = 5_000,
88
- }: {
89
- requirementId: string;
90
- target: string;
91
- timeoutMs?: number;
92
- },
93
- ): Promise<void> {
94
- const normalizedTarget = target.trim();
95
- expect(
96
- normalizedTarget,
97
- "Conditional-visibility evidence requires the dependent schema target.",
98
- ).not.toBe("");
99
- assertToolcraftBrowserActionForSession(session, hideControl);
100
- assertToolcraftBrowserActionForSession(session, showControl);
101
- const hideGateTarget = requireTargetScopedAction(
102
- hideControl,
103
- "Conditional-visibility hide evidence requires a target-scoped gating control action.",
104
- );
105
- expect(
106
- requireTargetScopedAction(
107
- showControl,
108
- "Conditional-visibility show evidence requires a target-scoped gating control action.",
109
- ),
110
- "Conditional-visibility hide and show actions must exercise the same gating control.",
111
- ).toBe(hideGateTarget);
112
-
113
- const page = await getToolcraftBrowserProofPage(session);
114
- await getToolcraftControlFieldByTarget(page, normalizedTarget);
115
- await runToolcraftBrowserAction(hideControl);
116
- await expect
117
- .poll(
118
- () => countToolcraftControlOwnersByTarget(page, normalizedTarget),
119
- {
120
- message: `Conditional control "${normalizedTarget}" should be absent while its gating state is unavailable.`,
121
- timeout: timeoutMs,
122
- },
123
- )
124
- .toBe(0);
125
- await attachToolcraftBrowserRuntimeEvidence({
126
- evidenceType: "conditional-control-hidden",
127
- requirementId,
128
- target: normalizedTarget,
129
- });
130
-
131
- await runToolcraftBrowserAction(showControl);
132
- await getToolcraftControlFieldByTarget(page, normalizedTarget);
133
- await attachToolcraftBrowserRuntimeEvidence({
134
- evidenceType: "conditional-control-visible",
135
- requirementId,
136
- target: normalizedTarget,
137
- });
138
- }
139
-
140
72
  export async function expectToolcraftBackgroundOutputSemantics<
141
73
  TImageArtifact,
142
74
  TVideoArtifact = never,
@@ -0,0 +1,114 @@
1
+ import { expect, type Page } from "@playwright/test";
2
+
3
+ import {
4
+ getToolcraftApplicabilityRequirementId,
5
+ type ToolcraftControlApplicabilityCase,
6
+ } from "../src/app/starter-acceptance";
7
+ import {
8
+ countToolcraftControlOwnersByTarget,
9
+ getToolcraftControlFieldByTarget,
10
+ } from "./browser-control-target-helpers";
11
+ import {
12
+ assertToolcraftBrowserActionForSession,
13
+ getToolcraftBrowserActionTarget,
14
+ getToolcraftBrowserProofPage,
15
+ runToolcraftBrowserAction,
16
+ type ToolcraftBrowserAction,
17
+ type ToolcraftBrowserProofSession,
18
+ } from "./browser-proof-session";
19
+ import { attachToolcraftBrowserRuntimeEvidence } from "./browser-runtime-evidence";
20
+
21
+ function requireSelectorOptionLabel(
22
+ applicabilityCase: ToolcraftControlApplicabilityCase,
23
+ ): string {
24
+ if (!applicabilityCase.selectorOptionLabel) {
25
+ throw new Error(
26
+ `Applicability case for ${applicabilityCase.selectorTarget} requires a selector option label.`,
27
+ );
28
+ }
29
+
30
+ return applicabilityCase.selectorOptionLabel;
31
+ }
32
+
33
+ async function expectToolcraftApplicabilitySelectorState(
34
+ page: Page,
35
+ applicabilityCase: ToolcraftControlApplicabilityCase,
36
+ ): Promise<void> {
37
+ const control = await getToolcraftControlFieldByTarget(
38
+ page,
39
+ applicabilityCase.selectorTarget,
40
+ );
41
+
42
+ switch (applicabilityCase.selectorControlType) {
43
+ case "checkbox":
44
+ case "switch":
45
+ await expect(
46
+ control.getByRole(applicabilityCase.selectorControlType),
47
+ ).toHaveAttribute("aria-checked", String(applicabilityCase.selectorValue));
48
+ return;
49
+ case "imagePicker":
50
+ case "segmented":
51
+ await expect(
52
+ control.getByRole("button", {
53
+ name: requireSelectorOptionLabel(applicabilityCase),
54
+ }),
55
+ ).toHaveAttribute("aria-pressed", "true");
56
+ return;
57
+ case "select":
58
+ await expect(control.getByRole("combobox")).toContainText(
59
+ requireSelectorOptionLabel(applicabilityCase),
60
+ );
61
+ return;
62
+ case "slider":
63
+ await expect(control.getByRole("slider")).toHaveAttribute(
64
+ "aria-valuenow",
65
+ String(applicabilityCase.selectorValue),
66
+ );
67
+ return;
68
+ case "tabs":
69
+ await expect(
70
+ control.getByRole("tab", {
71
+ name: requireSelectorOptionLabel(applicabilityCase),
72
+ }),
73
+ ).toHaveAttribute("aria-selected", "true");
74
+ }
75
+ }
76
+
77
+ export async function expectToolcraftControlApplicabilityState(
78
+ session: ToolcraftBrowserProofSession,
79
+ selectBranch: ToolcraftBrowserAction,
80
+ applicabilityCase: ToolcraftControlApplicabilityCase,
81
+ options: { baseRequirementId: string; timeoutMs?: number },
82
+ ): Promise<void> {
83
+ const selectorTarget = getToolcraftBrowserActionTarget(selectBranch)?.trim();
84
+ expect(
85
+ selectorTarget,
86
+ "Control-applicability evidence requires a target-scoped selector action.",
87
+ ).toBe(applicabilityCase.selectorTarget);
88
+ assertToolcraftBrowserActionForSession(session, selectBranch);
89
+
90
+ const page = await getToolcraftBrowserProofPage(session);
91
+ await runToolcraftBrowserAction(selectBranch);
92
+ await expectToolcraftApplicabilitySelectorState(page, applicabilityCase);
93
+ await expect
94
+ .poll(
95
+ () => countToolcraftControlOwnersByTarget(page, applicabilityCase.target),
96
+ {
97
+ message: `Control "${applicabilityCase.target}" should be ${applicabilityCase.expectation} for ${applicabilityCase.selectorTarget}=${JSON.stringify(applicabilityCase.selectorValue)}.`,
98
+ timeout: options.timeoutMs ?? 5_000,
99
+ },
100
+ )
101
+ .toBe(applicabilityCase.expectation === "hidden" ? 0 : 1);
102
+
103
+ await attachToolcraftBrowserRuntimeEvidence({
104
+ evidenceType:
105
+ applicabilityCase.expectation === "hidden"
106
+ ? "control-applicability-hidden"
107
+ : "control-applicability-visible",
108
+ requirementId: getToolcraftApplicabilityRequirementId(
109
+ options.baseRequirementId,
110
+ applicabilityCase,
111
+ ),
112
+ target: applicabilityCase.target,
113
+ });
114
+ }