@pixel-point/toolcraft 0.0.15 → 0.0.16

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 (1212) hide show
  1. package/package.json +1 -1
  2. package/src/cli-package-manager-flow.test.mjs +9 -2
  3. package/src/cli.test.mjs +11 -16
  4. package/src/create-command.mjs +10 -4
  5. package/src/generate-demand-only-lifecycle.test.mjs +102 -0
  6. package/src/generate-performance-iteration-execution.test.mjs +105 -0
  7. package/src/generate-test-assertions.mjs +2 -0
  8. package/src/generate-test-browser-execution-ledger.mjs +138 -0
  9. package/src/generate-test-browser-execution-ledger.test.mjs +87 -0
  10. package/src/generate-test-delivery-architecture-assertions.mjs +137 -0
  11. package/src/generate-test-demand-only-lifecycle.mjs +303 -0
  12. package/src/generate-test-dependency-sandbox.mjs +158 -0
  13. package/src/generate-test-doc-assertions.mjs +286 -10
  14. package/src/generate-test-doc-assertions.test.mjs +43 -0
  15. package/src/generate-test-file-assertions.mjs +244 -6
  16. package/src/generate-test-fs-utils.mjs +4 -1
  17. package/src/generate-test-integrity-assertions.mjs +70 -3
  18. package/src/generate-test-integrity-framework-assertions.mjs +31 -1
  19. package/src/generate-test-integrity-manifest-assertions.mjs +58 -0
  20. package/src/generate-test-integrity-ownership-assertions.mjs +35 -2
  21. package/src/generate-test-managed-process.mjs +287 -0
  22. package/src/generate-test-managed-process.test.mjs +340 -0
  23. package/src/generate-test-package-assertions.mjs +75 -11
  24. package/src/generate-test-product-fixture.mjs +85 -7
  25. package/src/generate-test-product-fixture.test.mjs +227 -0
  26. package/src/generate-test-product-iteration.mjs +278 -0
  27. package/src/generate-test-product-iteration.test.mjs +241 -0
  28. package/src/generate-test-standalone-assertions.mjs +87 -149
  29. package/src/generate-test-standalone-delivery-stages.mjs +186 -0
  30. package/src/generate-test-windows-job-native.cs +496 -0
  31. package/src/generate-test-windows-job-wrapper.mjs +40 -0
  32. package/src/generate-test-windows-job.mjs +47 -0
  33. package/src/generate-test-windows-job.ps1 +17 -0
  34. package/src/generate.mjs +26 -0
  35. package/src/generate.test.mjs +76 -14
  36. package/src/generated-integrity-manifest.test.mjs +51 -2
  37. package/src/generated-source-policy.mjs +1 -1
  38. package/src/generated-source-policy.test.mjs +15 -2
  39. package/src/import-map.mjs +12 -0
  40. package/src/package-json.mjs +7 -6
  41. package/src/package-json.test.mjs +55 -31
  42. package/src/package-manager.mjs +71 -33
  43. package/src/package-manager.test.mjs +101 -18
  44. package/src/packaged-template-fallback.test.mjs +4 -0
  45. package/src/rewrite-imports.mjs +3 -0
  46. package/src/rewrite-imports.test.mjs +16 -1
  47. package/templates/runtime/contracts/component-contracts.choices.test.ts +49 -6
  48. package/templates/runtime/contracts/component-contracts.choices.ts +53 -10
  49. package/templates/runtime/contracts/component-contracts.inputs.test.ts +2 -2
  50. package/templates/runtime/contracts/component-contracts.inputs.ts +2 -2
  51. package/templates/runtime/contracts/component-contracts.media-custom.test.ts +19 -0
  52. package/templates/runtime/contracts/component-contracts.media-custom.ts +18 -2
  53. package/templates/runtime/contracts/component-contracts.runtime-acceptance.test.ts +57 -83
  54. package/templates/runtime/contracts/component-contracts.runtime-labels.test.ts +1 -1
  55. package/templates/runtime/contracts/component-contracts.runtime-panels.test.ts +16 -2
  56. package/templates/runtime/contracts/component-contracts.runtime-shell.test.ts +24 -8
  57. package/templates/runtime/contracts/component-contracts.runtime.ts +80 -39
  58. package/templates/runtime/contracts/component-contracts.test.ts +6 -1
  59. package/templates/runtime/contracts/component-contracts.visual.test.ts +44 -5
  60. package/templates/runtime/contracts/component-contracts.visual.ts +64 -17
  61. package/templates/runtime/contracts/decision-contracts.test.ts +106 -11
  62. package/templates/runtime/contracts/decision-contracts.ts +83 -6
  63. package/templates/runtime/contracts/index.ts +2 -0
  64. package/templates/runtime/contracts/performance-request-classifier-descriptions.ts +39 -0
  65. package/templates/runtime/contracts/performance-request-classifier-rules.ts +181 -0
  66. package/templates/runtime/contracts/performance-request-classifier-types.ts +50 -0
  67. package/templates/runtime/contracts/performance-request-classifier.test.ts +269 -0
  68. package/templates/runtime/contracts/performance-request-classifier.ts +224 -0
  69. package/templates/runtime/contracts/performance-request-evidence-policy.d.mts +21 -0
  70. package/templates/runtime/contracts/performance-request-evidence-policy.mjs +39 -0
  71. package/templates/runtime/contracts/performance-verification-policy.test.ts +129 -0
  72. package/templates/runtime/contracts/performance-verification-policy.ts +49 -0
  73. package/templates/runtime/contracts/segmented-control-fit.test.ts +71 -0
  74. package/templates/runtime/contracts/segmented-control-fit.ts +38 -0
  75. package/templates/runtime/export/export-frame.test.ts +80 -0
  76. package/templates/runtime/export/export-frame.ts +107 -0
  77. package/templates/runtime/export/export-sizing.ts +136 -0
  78. package/templates/runtime/export/export.test.ts +70 -1
  79. package/templates/runtime/export/export.ts +31 -146
  80. package/templates/runtime/export/index.ts +2 -0
  81. package/templates/runtime/index.ts +10 -0
  82. package/templates/runtime/model-import/canonical/index.ts +39 -0
  83. package/templates/runtime/model-import/canonical/model-appearance-data-uri.test.ts +43 -0
  84. package/templates/runtime/model-import/canonical/model-appearance-data-uri.ts +79 -0
  85. package/templates/runtime/model-import/canonical/model-appearance-image.ts +111 -0
  86. package/templates/runtime/model-import/canonical/model-appearance-input-snapshot.ts +189 -0
  87. package/templates/runtime/model-import/canonical/model-appearance-resource.test.ts +116 -0
  88. package/templates/runtime/model-import/canonical/model-appearance-resource.ts +165 -0
  89. package/templates/runtime/model-import/canonical/model-appearance-validation.test.ts +197 -0
  90. package/templates/runtime/model-import/canonical/model-appearance-validation.ts +458 -0
  91. package/templates/runtime/model-import/canonical/model-document-codec-adversarial.test.ts +151 -0
  92. package/templates/runtime/model-import/canonical/model-document-codec-appearance-metadata.ts +336 -0
  93. package/templates/runtime/model-import/canonical/model-document-codec-closure.test.ts +125 -0
  94. package/templates/runtime/model-import/canonical/model-document-codec-envelope.ts +363 -0
  95. package/templates/runtime/model-import/canonical/model-document-codec-error.ts +57 -0
  96. package/templates/runtime/model-import/canonical/model-document-codec-format.ts +83 -0
  97. package/templates/runtime/model-import/canonical/model-document-codec-layout.ts +163 -0
  98. package/templates/runtime/model-import/canonical/model-document-codec-metadata-adversarial.test.ts +169 -0
  99. package/templates/runtime/model-import/canonical/model-document-codec-metadata-preflight.ts +371 -0
  100. package/templates/runtime/model-import/canonical/model-document-codec-metadata-reader.ts +142 -0
  101. package/templates/runtime/model-import/canonical/model-document-codec-metadata.ts +420 -0
  102. package/templates/runtime/model-import/canonical/model-document-codec-payload.ts +311 -0
  103. package/templates/runtime/model-import/canonical/model-document-codec.test.ts +450 -0
  104. package/templates/runtime/model-import/canonical/model-document-codec.ts +161 -0
  105. package/templates/runtime/model-import/canonical/model-document-digest.ts +13 -0
  106. package/templates/runtime/model-import/canonical/model-document-hostile-decode.test.ts +100 -0
  107. package/templates/runtime/model-import/canonical/model-document-hostile-input.test.ts +140 -0
  108. package/templates/runtime/model-import/canonical/model-document-input-reader.ts +153 -0
  109. package/templates/runtime/model-import/canonical/model-document-input-snapshot.ts +413 -0
  110. package/templates/runtime/model-import/canonical/model-document-limit-options.test.ts +155 -0
  111. package/templates/runtime/model-import/canonical/model-document-limits.ts +151 -0
  112. package/templates/runtime/model-import/canonical/model-document-owned-geometry.test.ts +138 -0
  113. package/templates/runtime/model-import/canonical/model-document-safe-typed-array.ts +154 -0
  114. package/templates/runtime/model-import/canonical/model-document-test-support.ts +163 -0
  115. package/templates/runtime/model-import/canonical/model-document-validation-geometry.ts +330 -0
  116. package/templates/runtime/model-import/canonical/model-document-validation-helpers.ts +22 -0
  117. package/templates/runtime/model-import/canonical/model-document-validation-hierarchy.ts +314 -0
  118. package/templates/runtime/model-import/canonical/model-document-validation-provenance.ts +153 -0
  119. package/templates/runtime/model-import/canonical/model-document-validation-result.ts +118 -0
  120. package/templates/runtime/model-import/canonical/model-document-validation.test.ts +497 -0
  121. package/templates/runtime/model-import/canonical/model-document-validation.ts +276 -0
  122. package/templates/runtime/model-import/canonical/model-document-worker-memory.test.ts +95 -0
  123. package/templates/runtime/model-import/canonical/model-document-worker-memory.ts +365 -0
  124. package/templates/runtime/model-import/canonical/model-document.ts +187 -0
  125. package/templates/runtime/model-import/canonical/sha256.ts +144 -0
  126. package/templates/runtime/model-import/default-model-source-assets.test.ts +212 -0
  127. package/templates/runtime/model-import/default-model-source-assets.ts +235 -0
  128. package/templates/runtime/model-import/formats/fbx-appearance-test-fixtures.ts +144 -0
  129. package/templates/runtime/model-import/formats/fbx-ascii-appearance-test-fixtures.ts +123 -0
  130. package/templates/runtime/model-import/formats/fbx-binary-preflight-reader.ts +179 -0
  131. package/templates/runtime/model-import/formats/fbx-binary-preflight.ts +277 -0
  132. package/templates/runtime/model-import/formats/fbx-binary-test-fixture-builder.ts +129 -0
  133. package/templates/runtime/model-import/formats/fbx-model-format-adapter.test-fixtures.ts +119 -0
  134. package/templates/runtime/model-import/formats/fbx-model-format-adapter.test.ts +316 -0
  135. package/templates/runtime/model-import/formats/fbx-model-format-adapter.ts +96 -0
  136. package/templates/runtime/model-import/formats/fbx-model-format-preflight.ts +122 -0
  137. package/templates/runtime/model-import/formats/fbx-static-appearance.test.ts +93 -0
  138. package/templates/runtime/model-import/formats/fbx-static-appearance.ts +403 -0
  139. package/templates/runtime/model-import/formats/gltf-accessor-preflight.ts +321 -0
  140. package/templates/runtime/model-import/formats/gltf-attribute-encoding.ts +65 -0
  141. package/templates/runtime/model-import/formats/gltf-buffer-preflight.ts +320 -0
  142. package/templates/runtime/model-import/formats/gltf-canonical-appearance.ts +422 -0
  143. package/templates/runtime/model-import/formats/gltf-canonical-geometry.ts +276 -0
  144. package/templates/runtime/model-import/formats/gltf-canonical-hierarchy.ts +180 -0
  145. package/templates/runtime/model-import/formats/gltf-canonical-metadata.ts +100 -0
  146. package/templates/runtime/model-import/formats/gltf-decode-safety.ts +84 -0
  147. package/templates/runtime/model-import/formats/gltf-decoded-count-validation.ts +38 -0
  148. package/templates/runtime/model-import/formats/gltf-document-canonicalizer.ts +328 -0
  149. package/templates/runtime/model-import/formats/gltf-document-sanitizer.ts +269 -0
  150. package/templates/runtime/model-import/formats/gltf-extension-policy.ts +59 -0
  151. package/templates/runtime/model-import/formats/gltf-glb-document.ts +93 -0
  152. package/templates/runtime/model-import/formats/gltf-json-inspection.ts +152 -0
  153. package/templates/runtime/model-import/formats/gltf-json-preflight.ts +128 -0
  154. package/templates/runtime/model-import/formats/gltf-missing-appearance.ts +158 -0
  155. package/templates/runtime/model-import/formats/gltf-model-format-adapter-appearance.test.ts +181 -0
  156. package/templates/runtime/model-import/formats/gltf-model-format-adapter-resource-limits.test.ts +236 -0
  157. package/templates/runtime/model-import/formats/gltf-model-format-adapter-validation.test.ts +274 -0
  158. package/templates/runtime/model-import/formats/gltf-model-format-adapter.test.ts +229 -0
  159. package/templates/runtime/model-import/formats/gltf-model-format-adapter.ts +161 -0
  160. package/templates/runtime/model-import/formats/gltf-node-preflight.ts +218 -0
  161. package/templates/runtime/model-import/formats/gltf-primitive-preflight.ts +295 -0
  162. package/templates/runtime/model-import/formats/gltf-source-document.ts +234 -0
  163. package/templates/runtime/model-import/formats/gltf-source-snapshot.ts +187 -0
  164. package/templates/runtime/model-import/formats/gltf-texture-resource.ts +252 -0
  165. package/templates/runtime/model-import/formats/index.ts +28 -0
  166. package/templates/runtime/model-import/formats/model-format-adapter.test.ts +165 -0
  167. package/templates/runtime/model-import/formats/model-format-adapter.ts +165 -0
  168. package/templates/runtime/model-import/formats/obj-material-library.test.ts +124 -0
  169. package/templates/runtime/model-import/formats/obj-material-library.ts +432 -0
  170. package/templates/runtime/model-import/formats/obj-model-format-adapter.test.ts +251 -0
  171. package/templates/runtime/model-import/formats/obj-model-format-adapter.ts +85 -0
  172. package/templates/runtime/model-import/formats/obj-stl-ply-model-format-adapter-support.ts +335 -0
  173. package/templates/runtime/model-import/formats/ply-model-format-adapter.test.ts +151 -0
  174. package/templates/runtime/model-import/formats/ply-model-format-adapter.ts +195 -0
  175. package/templates/runtime/model-import/formats/production-model-format-main-bundle.test.ts +123 -0
  176. package/templates/runtime/model-import/formats/production-model-format-manifest.ts +135 -0
  177. package/templates/runtime/model-import/formats/production-model-format-registry.test.ts +253 -0
  178. package/templates/runtime/model-import/formats/production-model-format-registry.ts +16 -0
  179. package/templates/runtime/model-import/formats/production-model-format-worker-registry.ts +68 -0
  180. package/templates/runtime/model-import/formats/stl-model-format-adapter.test.ts +110 -0
  181. package/templates/runtime/model-import/formats/stl-model-format-adapter.ts +125 -0
  182. package/templates/runtime/model-import/formats/three-static-appearance-canonicalizer.ts +305 -0
  183. package/templates/runtime/model-import/formats/three-static-geometry-canonicalizer.test.ts +245 -0
  184. package/templates/runtime/model-import/formats/three-static-geometry-canonicalizer.ts +434 -0
  185. package/templates/runtime/model-import/formats/three-static-source-bundle.ts +146 -0
  186. package/templates/runtime/model-import/formats/vendor/draco/LICENSE +252 -0
  187. package/templates/runtime/model-import/formats/vendor/draco/README.md +15 -0
  188. package/templates/runtime/model-import/formats/vendor/draco/draco_decoder_gltf.wasm.json +1 -0
  189. package/templates/runtime/model-import/formats/vendor/draco/draco_wasm_wrapper.cjs +117 -0
  190. package/templates/runtime/model-import/formats/vendor/draco/draco_wasm_wrapper.d.cts +9 -0
  191. package/templates/runtime/model-import/index.ts +125 -0
  192. package/templates/runtime/model-import/model-analysis-summary.test.ts +179 -0
  193. package/templates/runtime/model-import/model-analysis-summary.ts +164 -0
  194. package/templates/runtime/model-import/model-asset-metadata.ts +71 -0
  195. package/templates/runtime/model-import/model-import-limit-values.ts +41 -0
  196. package/templates/runtime/model-import/model-import-limits.test.ts +125 -0
  197. package/templates/runtime/model-import/model-import-limits.ts +165 -0
  198. package/templates/runtime/model-import/model-import-types.ts +215 -0
  199. package/templates/runtime/model-import/model-package-path.ts +106 -0
  200. package/templates/runtime/model-import/model-package-types.ts +55 -0
  201. package/templates/runtime/model-import/model-package-zip-preflight.ts +405 -0
  202. package/templates/runtime/model-import/model-package-zip.test.ts +252 -0
  203. package/templates/runtime/model-import/model-package-zip.ts +227 -0
  204. package/templates/runtime/model-import/model-persistence-appearance-resources.test.ts +69 -0
  205. package/templates/runtime/model-import/model-persistence-hydration-appearance.test.ts +146 -0
  206. package/templates/runtime/model-import/model-persistence-hydration-resources.ts +281 -0
  207. package/templates/runtime/model-import/model-persistence-hydration-test-support.ts +97 -0
  208. package/templates/runtime/model-import/model-persistence-hydration.test.ts +370 -0
  209. package/templates/runtime/model-import/model-persistence-hydration.ts +323 -0
  210. package/templates/runtime/model-import/model-source-asset-coordinator.test.ts +414 -0
  211. package/templates/runtime/model-import/model-source-asset-handler-appearance-resources.ts +20 -0
  212. package/templates/runtime/model-import/model-source-asset-handler-appearance.test.ts +169 -0
  213. package/templates/runtime/model-import/model-source-asset-handler-repair-controller.ts +294 -0
  214. package/templates/runtime/model-import/model-source-asset-handler-repair.ts +233 -0
  215. package/templates/runtime/model-import/model-source-asset-handler-resources.ts +54 -0
  216. package/templates/runtime/model-import/model-source-asset-handler.ingestion.test.ts +236 -0
  217. package/templates/runtime/model-import/model-source-asset-handler.lifecycle.test.ts +176 -0
  218. package/templates/runtime/model-import/model-source-asset-handler.test-support.ts +231 -0
  219. package/templates/runtime/model-import/model-source-asset-handler.ts +479 -0
  220. package/templates/runtime/model-import/model-source-asset-repair-coordinator.test.ts +431 -0
  221. package/templates/runtime/model-import/model-source-bundle-codec.test.ts +423 -0
  222. package/templates/runtime/model-import/model-source-bundle-codec.ts +259 -0
  223. package/templates/runtime/model-import/model-source-bundle-descriptor-fields.ts +369 -0
  224. package/templates/runtime/model-import/model-source-bundle-descriptor-validation.ts +402 -0
  225. package/templates/runtime/model-import/model-source-bundle-error.ts +28 -0
  226. package/templates/runtime/model-import/model-source-bundle-limits.ts +108 -0
  227. package/templates/runtime/model-import/model-source-bundle-mime-type.test.ts +21 -0
  228. package/templates/runtime/model-import/model-source-bundle-preflight-test-support.ts +435 -0
  229. package/templates/runtime/model-import/model-source-bundle-security-test-support.ts +417 -0
  230. package/templates/runtime/model-import/model-source-bundle-test-support.ts +83 -0
  231. package/templates/runtime/model-import/model-source-bundle.test.ts +427 -0
  232. package/templates/runtime/model-import/model-source-bundle.ts +377 -0
  233. package/templates/runtime/model-import/model-source-bytes.ts +78 -0
  234. package/templates/runtime/model-import/model-source-data-uri.ts +74 -0
  235. package/templates/runtime/model-import/model-source-digest.test.ts +25 -0
  236. package/templates/runtime/model-import/model-source-digest.ts +288 -0
  237. package/templates/runtime/model-import/model-source-gltf.ts +184 -0
  238. package/templates/runtime/model-import/model-source-json-preflight.ts +382 -0
  239. package/templates/runtime/model-import/model-source-lookup.ts +134 -0
  240. package/templates/runtime/model-import/model-source-package-normalization.test.ts +106 -0
  241. package/templates/runtime/model-import/model-source-path.ts +233 -0
  242. package/templates/runtime/model-import/test-fixtures/gltf-appearance-fixtures.ts +188 -0
  243. package/templates/runtime/model-import/test-fixtures/model-fixtures.ts +612 -0
  244. package/templates/runtime/model-import/test-fixtures/obj-appearance-fixtures.ts +76 -0
  245. package/templates/runtime/model-import/topology/apply-model-repair.test.ts +236 -0
  246. package/templates/runtime/model-import/topology/apply-model-repair.ts +31 -0
  247. package/templates/runtime/model-import/topology/model-repair-execution.ts +364 -0
  248. package/templates/runtime/model-import/topology/model-repair-geometry.ts +60 -0
  249. package/templates/runtime/model-import/topology/model-repair-plan-codec.test.ts +125 -0
  250. package/templates/runtime/model-import/topology/model-repair-plan-codec.ts +96 -0
  251. package/templates/runtime/model-import/topology/model-repair-plan-envelope.ts +13 -0
  252. package/templates/runtime/model-import/topology/model-repair-plan-validation.ts +325 -0
  253. package/templates/runtime/model-import/topology/model-repair-plan.ts +275 -0
  254. package/templates/runtime/model-import/topology/model-topology-analysis.test.ts +448 -0
  255. package/templates/runtime/model-import/topology/model-topology-analysis.ts +426 -0
  256. package/templates/runtime/model-import/topology/model-topology-digest.ts +117 -0
  257. package/templates/runtime/model-import/topology/model-topology-graph.ts +455 -0
  258. package/templates/runtime/model-import/topology/model-topology-math.ts +140 -0
  259. package/templates/runtime/model-import/topology/model-topology-resources.ts +126 -0
  260. package/templates/runtime/model-import/topology/model-topology-test-support.ts +163 -0
  261. package/templates/runtime/model-import/topology/model-topology-types.ts +14 -0
  262. package/templates/runtime/model-import/worker/bounded-worker-cache.test.ts +47 -0
  263. package/templates/runtime/model-import/worker/bounded-worker-cache.ts +147 -0
  264. package/templates/runtime/model-import/worker/cooperative-buffer-snapshot.ts +195 -0
  265. package/templates/runtime/model-import/worker/model-import-worker-appearance-receipt.test.ts +273 -0
  266. package/templates/runtime/model-import/worker/model-import-worker-client-draft-verification.ts +39 -0
  267. package/templates/runtime/model-import/worker/model-import-worker-client-receipt.test.ts +217 -0
  268. package/templates/runtime/model-import/worker/model-import-worker-client-repair-validation.test.ts +357 -0
  269. package/templates/runtime/model-import/worker/model-import-worker-client-repair-verification.ts +44 -0
  270. package/templates/runtime/model-import/worker/model-import-worker-client-result-verification.ts +68 -0
  271. package/templates/runtime/model-import/worker/model-import-worker-client-snapshot.test.ts +368 -0
  272. package/templates/runtime/model-import/worker/model-import-worker-client-snapshot.ts +478 -0
  273. package/templates/runtime/model-import/worker/model-import-worker-client-test-support.ts +198 -0
  274. package/templates/runtime/model-import/worker/model-import-worker-client-validation.test.ts +301 -0
  275. package/templates/runtime/model-import/worker/model-import-worker-client.test.ts +484 -0
  276. package/templates/runtime/model-import/worker/model-import-worker-client.ts +715 -0
  277. package/templates/runtime/model-import/worker/model-import-worker-diagnostics.ts +298 -0
  278. package/templates/runtime/model-import/worker/model-import-worker-protocol-validation.ts +714 -0
  279. package/templates/runtime/model-import/worker/model-import-worker-protocol.ts +192 -0
  280. package/templates/runtime/model-import/worker/model-import-worker-receipt.ts +221 -0
  281. package/templates/runtime/model-import/worker/model-import-worker-result-verification.ts +22 -0
  282. package/templates/runtime/model-import/worker/model-import-worker-runtime-appearance.test.ts +81 -0
  283. package/templates/runtime/model-import/worker/model-import-worker-runtime-envelope.test.ts +126 -0
  284. package/templates/runtime/model-import/worker/model-import-worker-runtime-lifecycle.test.ts +342 -0
  285. package/templates/runtime/model-import/worker/model-import-worker-runtime-package.test.ts +85 -0
  286. package/templates/runtime/model-import/worker/model-import-worker-runtime-production.test.ts +51 -0
  287. package/templates/runtime/model-import/worker/model-import-worker-runtime-repair.test.ts +75 -0
  288. package/templates/runtime/model-import/worker/model-import-worker-runtime-test-support.ts +126 -0
  289. package/templates/runtime/model-import/worker/model-import-worker-runtime.test.ts +472 -0
  290. package/templates/runtime/model-import/worker/model-import-worker-runtime.ts +804 -0
  291. package/templates/runtime/model-import/worker/model-import-worker-trust-boundary.test.ts +243 -0
  292. package/templates/runtime/model-import/worker/model-import-worker-vite-smoke.test.ts +132 -0
  293. package/templates/runtime/model-import/worker/model-import.worker.bundle.js +3691 -0
  294. package/templates/runtime/model-import/worker/model-import.worker.ts +25 -0
  295. package/templates/runtime/performance/index.ts +1 -0
  296. package/templates/runtime/performance/profile-catalog-manifest.d.mts +27 -0
  297. package/templates/runtime/performance/profile-catalog-manifest.mjs +42 -0
  298. package/templates/runtime/performance/profile-catalog.test.ts +49 -0
  299. package/templates/runtime/performance/profile-catalog.ts +56 -0
  300. package/templates/runtime/react/app-shell/runtime-public-api.test.tsx +388 -5
  301. package/templates/runtime/react/app-shell/settings-transfer-canvas.ts +68 -0
  302. package/templates/runtime/react/app-shell/settings-transfer.test.ts +94 -1
  303. package/templates/runtime/react/app-shell/settings-transfer.ts +61 -89
  304. package/templates/runtime/react/app-shell/storage-key-migration.test.ts +40 -0
  305. package/templates/runtime/react/app-shell/storage-key-migration.ts +13 -9
  306. package/templates/runtime/react/app-shell/toolbar-panel.tsx +31 -13
  307. package/templates/runtime/react/app-shell/toolcraft-app-panel-workspace.test.tsx +125 -0
  308. package/templates/runtime/react/app-shell/toolcraft-app-test-utils.tsx +72 -0
  309. package/templates/runtime/react/app-shell/toolcraft-app.integration.test.tsx +21 -1
  310. package/templates/runtime/react/app-shell/toolcraft-app.scene-export.test.tsx +68 -0
  311. package/templates/runtime/react/app-shell/toolcraft-app.test.tsx +10 -55
  312. package/templates/runtime/react/app-shell/toolcraft-app.tsx +73 -15
  313. package/templates/runtime/react/app-shell/toolcraft-media-presentation.test.tsx +135 -0
  314. package/templates/runtime/react/app-shell/toolcraft-media-presentation.tsx +190 -0
  315. package/templates/runtime/react/app-shell/toolcraft-model-presentation-composition.test.tsx +99 -0
  316. package/templates/runtime/react/app-shell/toolcraft-persistence-bootstrap.ts +111 -0
  317. package/templates/runtime/react/app-shell/toolcraft-pipeline-context.test.tsx +252 -0
  318. package/templates/runtime/react/app-shell/toolcraft-pipeline-context.tsx +44 -0
  319. package/templates/runtime/react/app-shell/toolcraft-pipeline-evidence.tsx +41 -0
  320. package/templates/runtime/react/app-shell/toolcraft-pipeline-initialization.test.tsx +301 -0
  321. package/templates/runtime/react/app-shell/toolcraft-playback-persistence.test.tsx +116 -0
  322. package/templates/runtime/react/app-shell/toolcraft-render-isolation.test.tsx +418 -0
  323. package/templates/runtime/react/app-shell/toolcraft-root-persistence-migration.test.tsx +297 -0
  324. package/templates/runtime/react/app-shell/toolcraft-root-persistence-test-utils.tsx +163 -0
  325. package/templates/runtime/react/app-shell/toolcraft-root-persistence.test.tsx +357 -0
  326. package/templates/runtime/react/app-shell/toolcraft-root.test.tsx +57 -6
  327. package/templates/runtime/react/app-shell/toolcraft-root.tsx +106 -94
  328. package/templates/runtime/react/app-shell/toolcraft-selector-lanes.test.tsx +338 -0
  329. package/templates/runtime/react/app-shell/toolcraft-selectors.test.tsx +241 -0
  330. package/templates/runtime/react/app-shell/toolcraft-selectors.ts +133 -0
  331. package/templates/runtime/react/app-shell/toolcraft-source-asset-context.test.tsx +467 -0
  332. package/templates/runtime/react/app-shell/toolcraft-source-asset-context.tsx +646 -0
  333. package/templates/runtime/react/app-shell/toolcraft-store-context.tsx +18 -0
  334. package/templates/runtime/react/app-shell/use-toolcraft-persistence.ts +203 -0
  335. package/templates/runtime/react/app-shell/use-toolcraft-pipeline-pass.test.tsx +220 -0
  336. package/templates/runtime/react/app-shell/use-toolcraft-pipeline-pass.ts +175 -0
  337. package/templates/runtime/react/app-shell/use-toolcraft-pipeline.ts +10 -0
  338. package/templates/runtime/react/app-shell/use-toolcraft-values.test.tsx +288 -0
  339. package/templates/runtime/react/app-shell/use-toolcraft.ts +188 -7
  340. package/templates/runtime/react/canvas/canvas-default-media-layer.tsx +52 -14
  341. package/templates/runtime/react/canvas/canvas-media-transform.ts +2 -1
  342. package/templates/runtime/react/canvas/canvas-scene-surface.test.tsx +51 -0
  343. package/templates/runtime/react/canvas/canvas-scene-surface.tsx +54 -0
  344. package/templates/runtime/react/canvas/canvas-shell-interactions.test.tsx +225 -3
  345. package/templates/runtime/react/canvas/canvas-shell-media-rendering.test.tsx +83 -0
  346. package/templates/runtime/react/canvas/canvas-shell-rendering.test.tsx +88 -0
  347. package/templates/runtime/react/canvas/canvas-shell-test-utils.tsx +42 -2
  348. package/templates/runtime/react/canvas/canvas-shell-upload.test.tsx +231 -16
  349. package/templates/runtime/react/canvas/canvas-shell.tsx +154 -63
  350. package/templates/runtime/react/canvas/canvas-source-asset-feedback.test.tsx +211 -0
  351. package/templates/runtime/react/canvas/canvas-upload-routing.ts +65 -56
  352. package/templates/runtime/react/canvas/canvas-viewport-world.tsx +66 -0
  353. package/templates/runtime/react/canvas/media-file.test.ts +102 -0
  354. package/templates/runtime/react/canvas/media-file.ts +80 -35
  355. package/templates/runtime/react/canvas/runtime-scene-export.test.ts +279 -0
  356. package/templates/runtime/react/canvas/runtime-scene-export.ts +167 -0
  357. package/templates/runtime/react/canvas/scene-element-presentation-rect.ts +35 -0
  358. package/templates/runtime/react/canvas/use-canvas-drop-import.ts +65 -94
  359. package/templates/runtime/react/canvas/use-canvas-viewport-interactions.ts +52 -17
  360. package/templates/runtime/react/canvas/use-toolcraft-canvas-frame.ts +20 -0
  361. package/templates/runtime/react/canvas-handles/canvas-handle-layer-registry.test.ts +33 -0
  362. package/templates/runtime/react/canvas-handles/canvas-handle-layer-registry.tsx +64 -0
  363. package/templates/runtime/react/controls-panel/__tests__/actions-control-loading.test.tsx +59 -0
  364. package/templates/runtime/react/controls-panel/__tests__/controls-panel-filedrop-reorder.test.tsx +29 -11
  365. package/templates/runtime/react/controls-panel/__tests__/controls-panel.control-visibility.test.tsx +52 -0
  366. package/templates/runtime/react/controls-panel/__tests__/controls-panel.dependency-isolation.test.tsx +332 -0
  367. package/templates/runtime/react/controls-panel/__tests__/controls-panel.extensions-live-state.test.tsx +135 -0
  368. package/templates/runtime/react/controls-panel/__tests__/controls-panel.footer-actions.test.tsx +50 -0
  369. package/templates/runtime/react/controls-panel/__tests__/controls-panel.inline-layout.test.tsx +25 -9
  370. package/templates/runtime/react/controls-panel/__tests__/controls-panel.media-upload-files.test.tsx +35 -3
  371. package/templates/runtime/react/controls-panel/__tests__/controls-panel.media-upload-image.test.tsx +11 -5
  372. package/templates/runtime/react/controls-panel/__tests__/controls-panel.media-upload-multi-image.test.tsx +167 -5
  373. package/templates/runtime/react/controls-panel/__tests__/controls-panel.render-isolation.test.tsx +496 -0
  374. package/templates/runtime/react/controls-panel/__tests__/controls-panel.reset-dependency-isolation.test.tsx +226 -0
  375. package/templates/runtime/react/controls-panel/__tests__/controls-panel.scene-export-actions.test.tsx +187 -0
  376. package/templates/runtime/react/controls-panel/__tests__/controls-panel.section-isolation.test.tsx +441 -0
  377. package/templates/runtime/react/controls-panel/__tests__/controls-panel.section-navigation-overflow.test.tsx +247 -0
  378. package/templates/runtime/react/controls-panel/__tests__/controls-panel.section-navigation.test.tsx +486 -0
  379. package/templates/runtime/react/controls-panel/__tests__/controls-panel.section-shell.test.tsx +24 -2
  380. package/templates/runtime/react/controls-panel/__tests__/controls-panel.setup-controls.test.tsx +10 -5
  381. package/templates/runtime/react/controls-panel/__tests__/controls-panel.tabs.test.tsx +93 -0
  382. package/templates/runtime/react/controls-panel/__tests__/file-drop-folder-selection.test.tsx +62 -0
  383. package/templates/runtime/react/controls-panel/__tests__/file-drop-presentation-accessibility.test.tsx +45 -0
  384. package/templates/runtime/react/controls-panel/__tests__/file-drop-presentation.test.tsx +459 -0
  385. package/templates/runtime/react/controls-panel/actions/controls-panel-actions.ts +159 -12
  386. package/templates/runtime/react/controls-panel/actions/panel-action-feedback.tsx +24 -0
  387. package/templates/runtime/react/controls-panel/conditions/control-condition-dependencies.ts +39 -0
  388. package/templates/runtime/react/controls-panel/conditions/control-conditions.ts +40 -0
  389. package/templates/runtime/react/controls-panel/controls-panel.tsx +286 -170
  390. package/templates/runtime/react/controls-panel/keyframes/controls-panel-keyframes.tsx +27 -20
  391. package/templates/runtime/react/controls-panel/layout/controls-panel-control-group.tsx +509 -0
  392. package/templates/runtime/react/controls-panel/layout/controls-panel-inline-layout.tsx +5 -3
  393. package/templates/runtime/react/controls-panel/layout/controls-panel-layout.tsx +33 -5
  394. package/templates/runtime/react/controls-panel/layout/controls-panel-section-navigation-layout.ts +169 -0
  395. package/templates/runtime/react/controls-panel/layout/controls-panel-section-navigation.tsx +458 -0
  396. package/templates/runtime/react/controls-panel/layout/controls-panel-section.tsx +324 -324
  397. package/templates/runtime/react/controls-panel/live-custom-control.tsx +52 -0
  398. package/templates/runtime/react/controls-panel/renderers/controls-panel-basic-renderers.tsx +15 -0
  399. package/templates/runtime/react/controls-panel/renderers/controls-panel-media-renderer.test.tsx +242 -0
  400. package/templates/runtime/react/controls-panel/renderers/controls-panel-media-renderer.tsx +203 -129
  401. package/templates/runtime/react/controls-panel/renderers/controls-panel-renderer-registry.test.ts +26 -0
  402. package/templates/runtime/react/controls-panel/renderers/controls-panel-renderer-registry.ts +29 -0
  403. package/templates/runtime/react/controls-panel/renderers/controls-panel-settings-transfer-renderer.tsx +4 -4
  404. package/templates/runtime/react/controls-panel/testing/controls-panel-test-utils.tsx +8 -2
  405. package/templates/runtime/react/controls-panel/values/controls-panel-value-labels.ts +1 -0
  406. package/templates/runtime/react/index.ts +32 -1
  407. package/templates/runtime/react/layers/layer-tree.ts +5 -32
  408. package/templates/runtime/react/layers/layers-panel-test-utils.tsx +3 -1
  409. package/templates/runtime/react/layers/layers-panel.tsx +44 -30
  410. package/templates/runtime/react/model-rendering/lazy-three-model-render-binding.test.ts +92 -0
  411. package/templates/runtime/react/model-rendering/lazy-three-model-render-binding.ts +49 -0
  412. package/templates/runtime/react/model-rendering/model-canvas-layer.test.tsx +491 -0
  413. package/templates/runtime/react/model-rendering/model-canvas-layer.tsx +459 -0
  414. package/templates/runtime/react/model-rendering/model-display-fit.test.ts +57 -0
  415. package/templates/runtime/react/model-rendering/model-display-fit.ts +110 -0
  416. package/templates/runtime/react/model-rendering/model-export.test.ts +179 -0
  417. package/templates/runtime/react/model-rendering/model-export.ts +90 -0
  418. package/templates/runtime/react/model-rendering/model-presentation-consumer.test.tsx +225 -0
  419. package/templates/runtime/react/model-rendering/model-presentation-consumer.tsx +189 -0
  420. package/templates/runtime/react/model-rendering/model-presentation-feedback.ts +15 -0
  421. package/templates/runtime/react/model-rendering/model-presentation-mode.ts +112 -0
  422. package/templates/runtime/react/model-rendering/model-presentation-resource-manager.test.ts +244 -0
  423. package/templates/runtime/react/model-rendering/model-presentation-resource-manager.ts +426 -0
  424. package/templates/runtime/react/model-rendering/model-render-binding.ts +233 -0
  425. package/templates/runtime/react/model-rendering/model-render-host.ts +339 -0
  426. package/templates/runtime/react/model-rendering/model-render-provider.test.tsx +457 -0
  427. package/templates/runtime/react/model-rendering/model-render-provider.tsx +172 -0
  428. package/templates/runtime/react/model-rendering/model-render-registry.test.ts +86 -0
  429. package/templates/runtime/react/model-rendering/model-render-registry.ts +64 -0
  430. package/templates/runtime/react/model-rendering/model-render-state.ts +79 -0
  431. package/templates/runtime/react/model-rendering/three-canonical-geometry.ts +346 -0
  432. package/templates/runtime/react/model-rendering/three-canonical-model.ts +150 -0
  433. package/templates/runtime/react/model-rendering/three-model-appearance.test.ts +125 -0
  434. package/templates/runtime/react/model-rendering/three-model-appearance.ts +199 -0
  435. package/templates/runtime/react/model-rendering/three-model-prewarm.ts +61 -0
  436. package/templates/runtime/react/model-rendering/three-model-render-adapter-lifecycle.test.ts +293 -0
  437. package/templates/runtime/react/model-rendering/three-model-render-adapter.test-support.ts +70 -0
  438. package/templates/runtime/react/model-rendering/three-model-render-adapter.test.ts +379 -0
  439. package/templates/runtime/react/model-rendering/three-model-render-adapter.ts +484 -0
  440. package/templates/runtime/react/orientation-gizmo/model-orbit-interaction.integration.test.tsx +129 -0
  441. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-layer.tsx +44 -0
  442. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-math.test.ts +217 -0
  443. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-math.ts +299 -0
  444. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-public-api.test.ts +12 -0
  445. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-selection.test.ts +115 -0
  446. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-selection.ts +46 -0
  447. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-snap.integration.test.tsx +179 -0
  448. package/templates/runtime/react/orientation-gizmo/orientation-gizmo-test-harness.tsx +208 -0
  449. package/templates/runtime/react/orientation-gizmo/orientation-gizmo.integration.test.tsx +167 -0
  450. package/templates/runtime/react/orientation-gizmo/orientation-gizmo.tsx +544 -0
  451. package/templates/runtime/react/orientation-gizmo/orientation-interaction-coordinator.ts +112 -0
  452. package/templates/runtime/react/orientation-gizmo/orientation-quaternion.ts +264 -0
  453. package/templates/runtime/react/orientation-gizmo/use-toolcraft-model-orbit-interaction.ts +233 -0
  454. package/templates/runtime/react/orientation-gizmo/use-toolcraft-orientation-control-selection.ts +78 -0
  455. package/templates/runtime/react/panel-host/panel-host-geometry.test.ts +38 -1
  456. package/templates/runtime/react/panel-host/panel-host-geometry.ts +64 -6
  457. package/templates/runtime/react/panel-host/panel-host-runtime-placement.test.tsx +198 -0
  458. package/templates/runtime/react/panel-host/panel-host-types.ts +13 -2
  459. package/templates/runtime/react/panel-host/panel-host.test.tsx +13 -1
  460. package/templates/runtime/react/panel-host/panel-host.tsx +105 -20
  461. package/templates/runtime/react/panel-host/use-toolcraft-panel-binding.test.tsx +161 -0
  462. package/templates/runtime/react/panel-host/use-toolcraft-panel-binding.ts +55 -0
  463. package/templates/runtime/react/timeline/timeline-expanded-content.tsx +3 -0
  464. package/templates/runtime/react/timeline/timeline-panel-header.tsx +6 -0
  465. package/templates/runtime/react/timeline/timeline-panel-test-utils.tsx +1 -0
  466. package/templates/runtime/react/timeline/timeline-panel-transport.test.tsx +176 -2
  467. package/templates/runtime/react/timeline/timeline-panel.tsx +72 -19
  468. package/templates/runtime/react/timeline/timeline-playback-hooks.ts +58 -21
  469. package/templates/runtime/react/timeline/timeline-scrub-lifecycle.test.tsx +154 -0
  470. package/templates/runtime/rendering/index.ts +3 -0
  471. package/templates/runtime/rendering/renderer-pipeline-cache.ts +171 -0
  472. package/templates/runtime/rendering/renderer-pipeline-pass-generation.test.ts +151 -0
  473. package/templates/runtime/rendering/renderer-pipeline-pass-generation.ts +267 -0
  474. package/templates/runtime/rendering/renderer-pipeline-registration.test.ts +356 -0
  475. package/templates/runtime/rendering/renderer-pipeline-registration.ts +760 -0
  476. package/templates/runtime/rendering/renderer-pipeline-resource-lifecycle.test.ts +248 -0
  477. package/templates/runtime/rendering/renderer-pipeline-runtime-owner-inspection.ts +23 -0
  478. package/templates/runtime/rendering/renderer-pipeline-runtime-owner.test.ts +353 -0
  479. package/templates/runtime/rendering/renderer-pipeline-runtime-owner.ts +369 -0
  480. package/templates/runtime/rendering/renderer-pipeline-runtime.lifecycle.test.ts +440 -0
  481. package/templates/runtime/rendering/renderer-pipeline-runtime.test.ts +495 -0
  482. package/templates/runtime/rendering/renderer-pipeline-runtime.ts +611 -0
  483. package/templates/runtime/rendering/renderer-pipeline-runtime.types.test.ts +93 -0
  484. package/templates/runtime/rendering/renderer-pipeline-source-invalidation.test.ts +208 -0
  485. package/templates/runtime/rendering/structured-key-trie.test.ts +31 -0
  486. package/templates/runtime/rendering/structured-key-trie.ts +91 -0
  487. package/templates/runtime/scene/index.ts +1 -0
  488. package/templates/runtime/scene/scene-bounds.test.ts +242 -0
  489. package/templates/runtime/scene/scene-bounds.ts +190 -0
  490. package/templates/runtime/schema/additional-value-targets.ts +15 -0
  491. package/templates/runtime/schema/app-capabilities.test.ts +70 -0
  492. package/templates/runtime/schema/app-capabilities.ts +28 -0
  493. package/templates/runtime/schema/app-identity.test.ts +68 -0
  494. package/templates/runtime/schema/app-identity.ts +30 -0
  495. package/templates/runtime/schema/assembly-contract.ts +18 -2
  496. package/templates/runtime/schema/control-schema-normalization.ts +144 -3
  497. package/templates/runtime/schema/controls-panel-actions.ts +111 -44
  498. package/templates/runtime/schema/controls-panel-layout-groups.ts +17 -6
  499. package/templates/runtime/schema/controls-panel-normalization.ts +42 -7
  500. package/templates/runtime/schema/controls-panel-section-id.test.ts +418 -0
  501. package/templates/runtime/schema/controls-panel-section-id.ts +208 -0
  502. package/templates/runtime/schema/controls-panel-section-layout.ts +62 -23
  503. package/templates/runtime/schema/controls-panel-section-roundtrip.test.ts +157 -0
  504. package/templates/runtime/schema/controls-panel-section-titles.ts +19 -7
  505. package/templates/runtime/schema/define-toolcraft.assembly.test.ts +73 -0
  506. package/templates/runtime/schema/define-toolcraft.control-sections.test-support.ts +46 -0
  507. package/templates/runtime/schema/define-toolcraft.control-sections.test.ts +2 -4
  508. package/templates/runtime/schema/define-toolcraft.file-drop-normalization.test.ts +177 -0
  509. package/templates/runtime/schema/define-toolcraft.model-file-drop-formats.test.ts +181 -0
  510. package/templates/runtime/schema/define-toolcraft.model-file-drop-limits.test.ts +175 -0
  511. package/templates/runtime/schema/define-toolcraft.segmented-control-fit.test.ts +167 -0
  512. package/templates/runtime/schema/define-toolcraft.setup-background.test.ts +142 -0
  513. package/templates/runtime/schema/define-toolcraft.setup-canvas.test.ts +38 -0
  514. package/templates/runtime/schema/define-toolcraft.setup-persistence.test.ts +39 -31
  515. package/templates/runtime/schema/define-toolcraft.setup-render-scale-timeline.test.ts +33 -13
  516. package/templates/runtime/schema/define-toolcraft.setup-settings-transfer.test.ts +61 -1
  517. package/templates/runtime/schema/define-toolcraft.ts +32 -55
  518. package/templates/runtime/schema/keyframe-capability.test.ts +16 -5
  519. package/templates/runtime/schema/panels-schema-normalization.ts +17 -2
  520. package/templates/runtime/schema/persistence-plan.test.ts +201 -0
  521. package/templates/runtime/schema/persistence-plan.ts +70 -0
  522. package/templates/runtime/schema/runtime-setup-background.ts +158 -0
  523. package/templates/runtime/schema/runtime-setup-section.ts +122 -57
  524. package/templates/runtime/schema/runtime-targets.ts +14 -0
  525. package/templates/runtime/schema/schema-resolvers.ts +0 -18
  526. package/templates/runtime/schema/types.ts +167 -17
  527. package/templates/runtime/source-assets/binary-media-hydration.ts +73 -0
  528. package/templates/runtime/source-assets/default-binary-media-hydration.test.ts +92 -0
  529. package/templates/runtime/source-assets/default-model-hydration.test.ts +200 -0
  530. package/templates/runtime/source-assets/file-source-asset-handler.ts +157 -0
  531. package/templates/runtime/source-assets/image-file-source-asset-handler.test.ts +78 -0
  532. package/templates/runtime/source-assets/image-source-asset-handler.test.ts +202 -0
  533. package/templates/runtime/source-assets/image-source-asset-handler.ts +123 -0
  534. package/templates/runtime/source-assets/index.ts +20 -0
  535. package/templates/runtime/source-assets/media-resource-ref.test.ts +33 -0
  536. package/templates/runtime/source-assets/media-resource-ref.ts +49 -0
  537. package/templates/runtime/source-assets/production-source-asset-registry.ts +18 -0
  538. package/templates/runtime/source-assets/repository/binary-asset-dependencies.test.ts +184 -0
  539. package/templates/runtime/source-assets/repository/binary-asset-reachability.ts +26 -0
  540. package/templates/runtime/source-assets/repository/binary-asset-repository.ts +139 -0
  541. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-lifecycle.test.ts +111 -0
  542. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-lifecycle.ts +248 -0
  543. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-liveness.test.ts +68 -0
  544. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-liveness.ts +156 -0
  545. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-metadata.ts +242 -0
  546. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-options.ts +130 -0
  547. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-repository-leases.test.ts +305 -0
  548. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-repository-liveness.test.ts +217 -0
  549. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-repository-migration.test.ts +198 -0
  550. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-repository.test-support.ts +48 -0
  551. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-repository.test.ts +242 -0
  552. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-repository.ts +390 -0
  553. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-storage.ts +238 -0
  554. package/templates/runtime/source-assets/repository/indexeddb-binary-asset-test-support.ts +163 -0
  555. package/templates/runtime/source-assets/repository/memory-binary-asset-repository.test.ts +211 -0
  556. package/templates/runtime/source-assets/repository/memory-binary-asset-repository.ts +149 -0
  557. package/templates/runtime/source-assets/repository/resource-manifest.test.ts +67 -0
  558. package/templates/runtime/source-assets/repository/resource-manifest.ts +122 -0
  559. package/templates/runtime/source-assets/repository/resource-reachability.test.ts +227 -0
  560. package/templates/runtime/source-assets/repository/resource-reachability.ts +153 -0
  561. package/templates/runtime/source-assets/repository/unavailable-binary-asset-repository.ts +24 -0
  562. package/templates/runtime/source-assets/source-asset-admission.ts +63 -0
  563. package/templates/runtime/source-assets/source-asset-batch-preparation.ts +42 -0
  564. package/templates/runtime/source-assets/source-asset-binary-media-hydrator.ts +137 -0
  565. package/templates/runtime/source-assets/source-asset-cleanup-manager.ts +110 -0
  566. package/templates/runtime/source-assets/source-asset-coordinator-admission.test.ts +365 -0
  567. package/templates/runtime/source-assets/source-asset-coordinator-lifecycle.test.ts +230 -0
  568. package/templates/runtime/source-assets/source-asset-coordinator-planning.test.ts +121 -0
  569. package/templates/runtime/source-assets/source-asset-coordinator-presentation-reachability.test.ts +54 -0
  570. package/templates/runtime/source-assets/source-asset-coordinator-test-support.ts +197 -0
  571. package/templates/runtime/source-assets/source-asset-coordinator.test.ts +495 -0
  572. package/templates/runtime/source-assets/source-asset-coordinator.ts +328 -0
  573. package/templates/runtime/source-assets/source-asset-feedback.ts +40 -0
  574. package/templates/runtime/source-assets/source-asset-handler-cancellation.test.ts +157 -0
  575. package/templates/runtime/source-assets/source-asset-import-runner.ts +462 -0
  576. package/templates/runtime/source-assets/source-asset-job-manager.ts +186 -0
  577. package/templates/runtime/source-assets/source-asset-model-hydrator.ts +241 -0
  578. package/templates/runtime/source-assets/source-asset-operation-store.test.ts +53 -0
  579. package/templates/runtime/source-assets/source-asset-operation-store.ts +132 -0
  580. package/templates/runtime/source-assets/source-asset-prepared-result.ts +108 -0
  581. package/templates/runtime/source-assets/source-asset-presentation-feedback.test.ts +34 -0
  582. package/templates/runtime/source-assets/source-asset-presentation-resources.test.ts +43 -0
  583. package/templates/runtime/source-assets/source-asset-presentation-resources.ts +144 -0
  584. package/templates/runtime/source-assets/source-asset-presentation.test.ts +196 -0
  585. package/templates/runtime/source-assets/source-asset-presentation.ts +182 -0
  586. package/templates/runtime/source-assets/source-asset-registry.test.ts +282 -0
  587. package/templates/runtime/source-assets/source-asset-registry.ts +165 -0
  588. package/templates/runtime/source-assets/source-asset-resource-resolver.test.ts +47 -0
  589. package/templates/runtime/source-assets/source-asset-resource-resolver.ts +86 -0
  590. package/templates/runtime/source-assets/source-asset-types.ts +173 -0
  591. package/templates/runtime/state/canvas-background-state.ts +73 -0
  592. package/templates/runtime/state/canvas-control-target-reducer.test.ts +272 -0
  593. package/templates/runtime/state/canvas-control-target-reducer.ts +349 -0
  594. package/templates/runtime/state/canvas-frame.test.ts +68 -0
  595. package/templates/runtime/state/canvas-frame.ts +79 -0
  596. package/templates/runtime/state/canvas-reducer.ts +90 -5
  597. package/templates/runtime/state/control-value-normalization.test.ts +141 -0
  598. package/templates/runtime/state/control-value-normalization.ts +222 -0
  599. package/templates/runtime/state/controls-reducer.ts +45 -145
  600. package/templates/runtime/state/create-template-state.test.ts +43 -2
  601. package/templates/runtime/state/create-template-state.ts +36 -5
  602. package/templates/runtime/state/history-patch-metadata.test.ts +36 -0
  603. package/templates/runtime/state/history-patch-metadata.ts +74 -0
  604. package/templates/runtime/state/history-patches.ts +49 -12
  605. package/templates/runtime/state/layer-visibility.ts +36 -0
  606. package/templates/runtime/state/media-defaults.ts +93 -6
  607. package/templates/runtime/state/media-discriminated-union.test.ts +204 -0
  608. package/templates/runtime/state/media-import-allocation.ts +129 -0
  609. package/templates/runtime/state/media-reducer.ts +395 -99
  610. package/templates/runtime/state/media-resource-state.ts +34 -0
  611. package/templates/runtime/state/media-state.ts +1 -1
  612. package/templates/runtime/state/panels-reducer.ts +80 -27
  613. package/templates/runtime/state/persistence-additional-value-targets.test.ts +67 -0
  614. package/templates/runtime/state/persistence-controller.test.ts +187 -0
  615. package/templates/runtime/state/persistence-controller.ts +195 -0
  616. package/templates/runtime/state/persistence-legacy-section-collapse.test.ts +75 -0
  617. package/templates/runtime/state/persistence-legacy-section-collapse.ts +138 -0
  618. package/templates/runtime/state/persistence-media-migration.test.ts +163 -0
  619. package/templates/runtime/state/persistence-migrations.test.ts +51 -0
  620. package/templates/runtime/state/persistence-migrations.ts +101 -0
  621. package/templates/runtime/state/persistence-reader-canvas.ts +4 -0
  622. package/templates/runtime/state/persistence-reader-media.ts +298 -39
  623. package/templates/runtime/state/persistence-reader-panels.ts +52 -5
  624. package/templates/runtime/state/persistence-reader-values.ts +19 -21
  625. package/templates/runtime/state/persistence-readers.ts +1 -1
  626. package/templates/runtime/state/persistence-snapshot.ts +15 -4
  627. package/templates/runtime/state/persistence.test.ts +228 -3
  628. package/templates/runtime/state/persistence.ts +53 -14
  629. package/templates/runtime/state/reducer-canvas-panels.test.ts +63 -0
  630. package/templates/runtime/state/reducer-controls.test.ts +114 -0
  631. package/templates/runtime/state/reducer-media-import-batch.test.ts +90 -0
  632. package/templates/runtime/state/reducer-media-import-sizing.test.ts +5 -3
  633. package/templates/runtime/state/reducer-media-reset.test.ts +18 -2
  634. package/templates/runtime/state/reducer-media-test-utils.ts +11 -6
  635. package/templates/runtime/state/reducer-media-transform.test.ts +11 -3
  636. package/templates/runtime/state/reducer-model-lifecycle.test.ts +307 -0
  637. package/templates/runtime/state/reducer.ts +9 -0
  638. package/templates/runtime/state/scene-element-frame.test.ts +32 -0
  639. package/templates/runtime/state/scene-element-frame.ts +46 -0
  640. package/templates/runtime/state/toolcraft-external-store-cross-lane.test.ts +475 -0
  641. package/templates/runtime/state/toolcraft-external-store-dependencies.test.ts +226 -0
  642. package/templates/runtime/state/toolcraft-external-store-dependencies.ts +291 -0
  643. package/templates/runtime/state/toolcraft-external-store-field-intent.test.ts +202 -0
  644. package/templates/runtime/state/toolcraft-external-store-history-boundary.test.ts +243 -0
  645. package/templates/runtime/state/toolcraft-external-store-history.ts +254 -0
  646. package/templates/runtime/state/toolcraft-external-store-publication.test.ts +135 -0
  647. package/templates/runtime/state/toolcraft-external-store-transition.ts +143 -0
  648. package/templates/runtime/state/toolcraft-external-store.test.ts +330 -0
  649. package/templates/runtime/state/toolcraft-external-store.ts +401 -0
  650. package/templates/runtime/state/toolcraft-keyframe-equality.ts +78 -0
  651. package/templates/runtime/state/types.ts +215 -13
  652. package/templates/runtime/testing/model-import-performance-workload.test.ts +265 -0
  653. package/templates/runtime/testing/model-import-performance-workload.ts +468 -0
  654. package/templates/runtime/testing/performance-config.ts +7 -0
  655. package/templates/runtime/testing/performance-control-classification.ts +3 -59
  656. package/templates/runtime/testing/performance-coverage-policy.ts +13 -0
  657. package/templates/runtime/testing/performance-coverage-validator.ts +39 -24
  658. package/templates/runtime/testing/performance-envelope-validation-context.ts +33 -0
  659. package/templates/runtime/testing/performance-fixture-adapter-types.ts +74 -0
  660. package/templates/runtime/testing/performance-fixture-adapters.ts +24 -0
  661. package/templates/runtime/testing/performance-fixture-cost-model.ts +216 -0
  662. package/templates/runtime/testing/performance-fixture-dimensions.ts +83 -0
  663. package/templates/runtime/testing/performance-fixture-discrete-adapters.ts +150 -0
  664. package/templates/runtime/testing/performance-fixture-discrete-domain.test.ts +274 -0
  665. package/templates/runtime/testing/performance-fixture-discrete-search.test.ts +119 -0
  666. package/templates/runtime/testing/performance-fixture-discrete-search.ts +96 -0
  667. package/templates/runtime/testing/performance-fixture-execution.test.ts +248 -0
  668. package/templates/runtime/testing/performance-fixture-execution.ts +109 -0
  669. package/templates/runtime/testing/performance-fixture-numeric.test.ts +15 -0
  670. package/templates/runtime/testing/performance-fixture-numeric.ts +24 -0
  671. package/templates/runtime/testing/performance-fixture-plan-analysis.ts +385 -0
  672. package/templates/runtime/testing/performance-fixture-plan.test-fixtures.ts +115 -0
  673. package/templates/runtime/testing/performance-fixture-plan.test.ts +443 -0
  674. package/templates/runtime/testing/performance-fixture-plan.ts +105 -0
  675. package/templates/runtime/testing/performance-fixture-reachable-values.test.ts +406 -0
  676. package/templates/runtime/testing/performance-fixture-record.ts +14 -0
  677. package/templates/runtime/testing/performance-fixture-registry-validation.ts +341 -0
  678. package/templates/runtime/testing/performance-fixture-validation-pure.test.ts +378 -0
  679. package/templates/runtime/testing/performance-interaction-policy.test.ts +35 -0
  680. package/templates/runtime/testing/performance-interaction-policy.ts +9 -0
  681. package/templates/runtime/testing/performance-no-legacy-semantics.test.ts +109 -0
  682. package/templates/runtime/testing/performance-path-codec.d.mts +42 -0
  683. package/templates/runtime/testing/performance-path-codec.mjs +112 -0
  684. package/templates/runtime/testing/performance-path-codec.test.ts +96 -0
  685. package/templates/runtime/testing/performance-path-coverage-policy.ts +111 -0
  686. package/templates/runtime/testing/performance-path-coverage.test.ts +219 -0
  687. package/templates/runtime/testing/performance-path-model.ts +15 -0
  688. package/templates/runtime/testing/performance-paths.test-fixtures.ts +165 -0
  689. package/templates/runtime/testing/performance-paths.test.ts +208 -0
  690. package/templates/runtime/testing/performance-paths.ts +84 -0
  691. package/templates/runtime/testing/performance-profile-validation.test.ts +42 -0
  692. package/templates/runtime/testing/performance-profile-validation.ts +19 -0
  693. package/templates/runtime/testing/performance-render-plan-assessment.test.ts +492 -0
  694. package/templates/runtime/testing/performance-render-plan-assessment.ts +121 -0
  695. package/templates/runtime/testing/performance-render-plan-benchmark-evidence.test.ts +225 -0
  696. package/templates/runtime/testing/performance-render-plan-benchmark-evidence.ts +185 -0
  697. package/templates/runtime/testing/performance-render-plan-integration.test.ts +250 -0
  698. package/templates/runtime/testing/performance-render-plan-model.ts +91 -0
  699. package/templates/runtime/testing/performance-render-plan-pass-assessment.ts +353 -0
  700. package/templates/runtime/testing/performance-render-plan-registration.test.ts +78 -0
  701. package/templates/runtime/testing/performance-render-plan-test-fixtures.ts +123 -0
  702. package/templates/runtime/testing/performance-render-plan-utils.ts +65 -0
  703. package/templates/runtime/testing/performance-renderer-pipeline-parser.ts +202 -0
  704. package/templates/runtime/testing/performance-renderer-pipeline-validation.ts +93 -98
  705. package/templates/runtime/testing/performance-renderer-technique-validation.ts +0 -155
  706. package/templates/runtime/testing/performance-scenario-common-validation.ts +101 -0
  707. package/templates/runtime/testing/performance-scenario-validation.ts +3 -40
  708. package/templates/runtime/testing/performance-schema-queries.ts +3 -1
  709. package/templates/runtime/testing/performance-test-fixtures/index.ts +0 -2
  710. package/templates/runtime/testing/performance-test-fixtures/renderer-pipelines.ts +0 -14
  711. package/templates/runtime/testing/performance-types.ts +128 -182
  712. package/templates/runtime/testing/performance-workload-envelope-derived-validation.test.ts +152 -0
  713. package/templates/runtime/testing/performance-workload-envelope-derived-validation.ts +109 -0
  714. package/templates/runtime/testing/performance-workload-envelope-schema-validation.test.ts +384 -0
  715. package/templates/runtime/testing/performance-workload-envelope-schema-validation.ts +201 -0
  716. package/templates/runtime/testing/performance-workload-envelope-shared.ts +97 -0
  717. package/templates/runtime/testing/performance-workload-envelope-test-fixtures.ts +102 -0
  718. package/templates/runtime/testing/performance-workload-envelope-validation.test.ts +293 -0
  719. package/templates/runtime/testing/performance-workload-envelope-validation.ts +222 -0
  720. package/templates/runtime/testing/performance-workload-types.test.ts +65 -0
  721. package/templates/runtime/testing/performance-workload-types.ts +34 -0
  722. package/templates/runtime/testing/performance.ts +47 -5
  723. package/templates/starter/AGENTS.md +45 -37
  724. package/templates/starter/docs/toolcraft/README.md +14 -16
  725. package/templates/starter/docs/toolcraft/acceptance-testing.md +86 -33
  726. package/templates/starter/docs/toolcraft/agent-worklog.md +121 -22
  727. package/templates/starter/docs/toolcraft/assembly-workflow.md +29 -13
  728. package/templates/starter/docs/toolcraft/component-rules.md +43 -5
  729. package/templates/starter/docs/toolcraft/core/control-selection.md +66 -0
  730. package/templates/starter/docs/toolcraft/core/layout.md +5 -3
  731. package/templates/starter/docs/toolcraft/core/media-upload.md +44 -1
  732. package/templates/starter/docs/toolcraft/core/performance.md +100 -67
  733. package/templates/starter/docs/toolcraft/core/runtime-boundary.md +14 -2
  734. package/templates/starter/docs/toolcraft/core/setup-export.md +40 -16
  735. package/templates/starter/docs/toolcraft/core/timeline-animation.md +2 -1
  736. package/templates/starter/docs/toolcraft/custom-controls.md +7 -1
  737. package/templates/starter/docs/toolcraft/decision-contract.md +8 -4
  738. package/templates/starter/docs/toolcraft/performance.md +115 -143
  739. package/templates/starter/docs/toolcraft/renderer-technique.md +90 -25
  740. package/templates/starter/docs/toolcraft/schema-reference.md +200 -44
  741. package/templates/starter/docs/toolcraft/workflow.md +35 -20
  742. package/templates/starter/e2e/app-browser-control-coverage.spec.ts +0 -54
  743. package/templates/starter/e2e/app-browser-infinity-canvas-evidence.spec.ts +86 -0
  744. package/templates/starter/e2e/app-browser-model-appearance-evidence.spec.ts +214 -0
  745. package/templates/starter/e2e/app-browser-model-import-evidence.spec.ts +422 -0
  746. package/templates/starter/e2e/app-browser-model-performance.spec.ts +140 -0
  747. package/templates/starter/e2e/app-browser-model-runtime-requirements.spec.ts +71 -0
  748. package/templates/starter/e2e/app-browser-orientation-evidence.spec.ts +276 -0
  749. package/templates/starter/e2e/app-browser-performance-evidence.spec.ts +164 -90
  750. package/templates/starter/e2e/app-browser-performance-probe.spec.ts +61 -0
  751. package/templates/starter/e2e/app-browser-proof-session.spec.ts +19 -0
  752. package/templates/starter/e2e/app-browser-render-scale-evidence.spec.ts +193 -0
  753. package/templates/starter/e2e/app-browser-render-scale-requirements.spec.ts +71 -0
  754. package/templates/starter/e2e/app-browser-runtime-provenance.spec.ts +12 -64
  755. package/templates/starter/e2e/app-browser-runtime-reporter.spec.ts +100 -50
  756. package/templates/starter/e2e/app-browser-runtime-requirements.spec.ts +179 -46
  757. package/templates/starter/e2e/app-browser-semantic-evidence.spec.ts +34 -56
  758. package/templates/starter/e2e/app-controls.spec.ts +1 -1
  759. package/templates/starter/e2e/app-kernel-benchmarks.ts +3 -0
  760. package/templates/starter/e2e/app-performance-path-adapters.ts +4 -0
  761. package/templates/starter/e2e/app-performance.spec.ts +49 -0
  762. package/templates/starter/e2e/app-persistence.spec.ts +209 -0
  763. package/templates/starter/e2e/browser-acceptance-outcome-helpers.ts +5 -1
  764. package/templates/starter/e2e/browser-conditional-output-evidence-helpers.ts +5 -0
  765. package/templates/starter/e2e/browser-execution-ledger.spec.ts +79 -0
  766. package/templates/starter/e2e/browser-execution-ledger.ts +115 -0
  767. package/templates/starter/e2e/browser-infinity-canvas-evidence.ts +729 -0
  768. package/templates/starter/e2e/browser-layer-evidence-helpers.ts +66 -9
  769. package/templates/starter/e2e/browser-model-appearance-evidence-helpers.ts +65 -0
  770. package/templates/starter/e2e/browser-model-appearance-evidence.ts +171 -0
  771. package/templates/starter/e2e/browser-model-import-evidence-helpers.ts +426 -0
  772. package/templates/starter/e2e/browser-orientation-gizmo-actions.ts +256 -0
  773. package/templates/starter/e2e/browser-orientation-gizmo-evidence-helpers.ts +433 -0
  774. package/templates/starter/e2e/browser-performance-evidence.ts +22 -0
  775. package/templates/starter/e2e/browser-performance-measurement-evidence.ts +25 -0
  776. package/templates/starter/e2e/browser-performance-measurement-report.spec.ts +73 -0
  777. package/templates/starter/e2e/browser-performance-measurement-report.ts +218 -0
  778. package/templates/starter/e2e/browser-performance-report.ts +246 -0
  779. package/templates/starter/e2e/browser-performance-reporter-evaluation.ts +317 -0
  780. package/templates/starter/e2e/browser-performance-reporter.spec.ts +456 -0
  781. package/templates/starter/e2e/browser-performance-targeted-selection.spec.ts +145 -0
  782. package/templates/starter/e2e/browser-proof-session.ts +31 -1
  783. package/templates/starter/e2e/browser-render-scale-evidence.ts +245 -0
  784. package/templates/starter/e2e/browser-runtime-evidence-reporter-test-fixtures.ts +55 -0
  785. package/templates/starter/e2e/browser-runtime-evidence-reporter.ts +146 -4
  786. package/templates/starter/e2e/browser-runtime-evidence-requirements.ts +133 -52
  787. package/templates/starter/e2e/browser-semantic-evidence-test-helpers.ts +57 -0
  788. package/templates/starter/e2e/browser-state-evidence-helpers.ts +7 -1
  789. package/templates/starter/e2e/browser-timeline-evidence-helpers.ts +4 -0
  790. package/templates/starter/e2e/canvas-handle-helpers.ts +3 -3
  791. package/templates/starter/e2e/kernel-benchmark-contract.ts +19 -0
  792. package/templates/starter/e2e/model-import-evidence-test-support.ts +125 -0
  793. package/templates/starter/e2e/performance-budget-helpers.ts +3 -107
  794. package/templates/starter/e2e/performance-canvas-helpers.ts +8 -8
  795. package/templates/starter/e2e/performance-checkpoint-report.ts +89 -0
  796. package/templates/starter/e2e/performance-compiled-fixture-runtime.ts +120 -0
  797. package/templates/starter/e2e/performance-control-helpers.ts +1 -1
  798. package/templates/starter/e2e/performance-control-layout-helpers.ts +24 -0
  799. package/templates/starter/e2e/performance-environment-evidence.ts +205 -0
  800. package/templates/starter/e2e/performance-fixture-helpers.ts +37 -210
  801. package/templates/starter/e2e/performance-fixture-selection.spec.ts +167 -0
  802. package/templates/starter/e2e/performance-fixture-selection.ts +82 -0
  803. package/templates/starter/e2e/performance-frame-metrics.spec.ts +21 -0
  804. package/templates/starter/e2e/performance-frame-metrics.ts +50 -0
  805. package/templates/starter/e2e/performance-frame-probe.ts +74 -49
  806. package/templates/starter/e2e/performance-helpers.ts +1 -0
  807. package/templates/starter/e2e/performance-interaction-measurement.ts +5 -11
  808. package/templates/starter/e2e/performance-measurement-evidence.ts +52 -8
  809. package/templates/starter/e2e/performance-model-appearance-contract.ts +11 -0
  810. package/templates/starter/e2e/performance-model-import-appearance-fixture-support.ts +32 -0
  811. package/templates/starter/e2e/performance-model-import-appearance-fixtures.spec.ts +56 -0
  812. package/templates/starter/e2e/performance-model-import-appearance-fixtures.ts +434 -0
  813. package/templates/starter/e2e/performance-model-import-binary-appearance-fixtures.ts +39 -0
  814. package/templates/starter/e2e/performance-model-import-fixtures.spec.ts +133 -0
  815. package/templates/starter/e2e/performance-model-import-fixtures.ts +439 -0
  816. package/templates/starter/e2e/performance-model-import-geometry-fixtures.ts +158 -0
  817. package/templates/starter/e2e/performance-model-import-helpers.ts +409 -0
  818. package/templates/starter/e2e/performance-model-import-zip-fixtures.ts +57 -0
  819. package/templates/starter/e2e/performance-model-orientation-helpers.ts +34 -0
  820. package/templates/starter/e2e/performance-model-pixel-helpers.ts +135 -0
  821. package/templates/starter/e2e/performance-output-action-helpers.ts +4 -4
  822. package/templates/starter/e2e/performance-path-adapter-contract.ts +55 -0
  823. package/templates/starter/e2e/performance-path-helpers.spec.ts +171 -0
  824. package/templates/starter/e2e/performance-path-helpers.ts +291 -0
  825. package/templates/starter/e2e/performance-pipeline-browser-helper.spec.ts +175 -0
  826. package/templates/starter/e2e/performance-pipeline-cache-fallback.spec.ts +204 -0
  827. package/templates/starter/e2e/performance-pipeline-evidence-continuity.spec.ts +134 -0
  828. package/templates/starter/e2e/performance-pipeline-evidence-test-fixtures.ts +409 -0
  829. package/templates/starter/e2e/performance-pipeline-evidence.spec.ts +441 -0
  830. package/templates/starter/e2e/performance-pipeline-evidence.ts +175 -0
  831. package/templates/starter/e2e/performance-pipeline-invariants.ts +359 -0
  832. package/templates/starter/e2e/performance-pipeline-resource-evidence.spec.ts +119 -0
  833. package/templates/starter/e2e/performance-profile-helpers.spec.ts +103 -0
  834. package/templates/starter/e2e/performance-profile-helpers.ts +52 -0
  835. package/templates/starter/e2e/performance-render-scale-runner.spec.ts +266 -0
  836. package/templates/starter/e2e/performance-slider-helpers.ts +7 -123
  837. package/templates/starter/e2e/product-observable-helpers.ts +109 -103
  838. package/templates/starter/e2e/toolcraft-delivery-catalog-reporter.ts +31 -0
  839. package/templates/starter/e2e/toolcraft-kernel-benchmark.spec.ts +107 -0
  840. package/templates/starter/e2e/toolcraft-product-test.spec.ts +14 -0
  841. package/templates/starter/e2e/toolcraft-product-test.ts +33 -0
  842. package/templates/starter/index.html +8 -0
  843. package/templates/starter/package.json +14 -11
  844. package/templates/starter/playwright.config.ts +124 -2
  845. package/templates/starter/scripts/check-toolcraft-code-health.mjs +66 -19
  846. package/templates/starter/scripts/check-toolcraft-code-health.test.mjs +151 -0
  847. package/templates/starter/scripts/check-toolcraft-docs.mjs +49 -3
  848. package/templates/starter/scripts/check-toolcraft-integrity.mjs +229 -117
  849. package/templates/starter/scripts/check-toolcraft-integrity.test.mjs +271 -0
  850. package/templates/starter/scripts/playwright-containing-file.mjs +48 -0
  851. package/templates/starter/scripts/playwright-test-shim-fixture.mjs +204 -0
  852. package/templates/starter/scripts/playwright-test-shim-fixture.test.mjs +69 -0
  853. package/templates/starter/scripts/playwright-test-title-selection-performance-path.test.mjs +129 -0
  854. package/templates/starter/scripts/playwright-test-title-selection.mjs +350 -0
  855. package/templates/starter/scripts/playwright-test-title-selection.test.mjs +465 -0
  856. package/templates/starter/scripts/run-browser-performance-test-helpers.mjs +335 -0
  857. package/templates/starter/scripts/run-browser-performance.mjs +71 -98
  858. package/templates/starter/scripts/run-browser-performance.test.mjs +266 -27
  859. package/templates/starter/scripts/run-delivery-verification-test-helpers.mjs +210 -0
  860. package/templates/starter/scripts/run-delivery-verification.mjs +47 -0
  861. package/templates/starter/scripts/run-delivery-verification.test.mjs +101 -0
  862. package/templates/starter/scripts/run-kernel-benchmarks.mjs +104 -0
  863. package/templates/starter/scripts/toolcraft-browser-impact-selection.mjs +26 -0
  864. package/templates/starter/scripts/toolcraft-checkpoint-bundle.mjs +198 -0
  865. package/templates/starter/scripts/toolcraft-checkpoint-bundle.test.mjs +297 -0
  866. package/templates/starter/scripts/toolcraft-checkpoint-capability-invariants.test.mjs +389 -0
  867. package/templates/starter/scripts/toolcraft-checkpoint-delivery-state.mjs +106 -0
  868. package/templates/starter/scripts/toolcraft-checkpoint-delivery-state.test.mjs +279 -0
  869. package/templates/starter/scripts/toolcraft-checkpoint-durability.test.mjs +49 -0
  870. package/templates/starter/scripts/toolcraft-checkpoint-durable-fs.mjs +90 -0
  871. package/templates/starter/scripts/toolcraft-checkpoint-ownership-policy.mjs +217 -0
  872. package/templates/starter/scripts/toolcraft-checkpoint-paths.mjs +35 -0
  873. package/templates/starter/scripts/toolcraft-checkpoint-transaction-test-helpers.mjs +12 -0
  874. package/templates/starter/scripts/toolcraft-checkpoint-transaction.mjs +125 -0
  875. package/templates/starter/scripts/toolcraft-checkpoint-transaction.test.mjs +167 -0
  876. package/templates/starter/scripts/toolcraft-checkpoint-write-capability.mjs +196 -0
  877. package/templates/starter/scripts/toolcraft-code-health-core.d.mts +46 -0
  878. package/templates/starter/scripts/toolcraft-code-health-core.mjs +80 -99
  879. package/templates/starter/scripts/toolcraft-code-health-line-budget.mjs +80 -0
  880. package/templates/starter/scripts/toolcraft-contract-doc-integrity.mjs +7 -3
  881. package/templates/starter/scripts/toolcraft-contract-doc-integrity.test.mjs +16 -0
  882. package/templates/starter/scripts/toolcraft-contract-manifest.json +42 -0
  883. package/templates/starter/scripts/toolcraft-contract-manifest.mjs +8 -0
  884. package/templates/starter/scripts/toolcraft-contract-manifest.test.mjs +40 -0
  885. package/templates/starter/scripts/toolcraft-css-source-evidence.mjs +192 -0
  886. package/templates/starter/scripts/toolcraft-css-source-evidence.test.mjs +336 -0
  887. package/templates/starter/scripts/toolcraft-css-url-graph-evidence.test.mjs +157 -0
  888. package/templates/starter/scripts/toolcraft-css-url-scanner.mjs +333 -0
  889. package/templates/starter/scripts/toolcraft-css-url-scanner.test.mjs +210 -0
  890. package/templates/starter/scripts/toolcraft-delivery-anchor.d.mts +46 -0
  891. package/templates/starter/scripts/toolcraft-delivery-anchor.mjs +84 -0
  892. package/templates/starter/scripts/toolcraft-delivery-anchor.test.mjs +131 -0
  893. package/templates/starter/scripts/toolcraft-delivery-architecture-inventory.mjs +86 -0
  894. package/templates/starter/scripts/toolcraft-delivery-architecture-policy.d.mts +51 -0
  895. package/templates/starter/scripts/toolcraft-delivery-architecture-policy.mjs +248 -0
  896. package/templates/starter/scripts/toolcraft-delivery-architecture-test-helpers.mjs +40 -0
  897. package/templates/starter/scripts/toolcraft-delivery-catalog-collector.mjs +55 -0
  898. package/templates/starter/scripts/toolcraft-delivery-catalog-collector.test.mjs +167 -0
  899. package/templates/starter/scripts/toolcraft-delivery-evidence.mjs +187 -0
  900. package/templates/starter/scripts/toolcraft-delivery-evidence.test.mjs +268 -0
  901. package/templates/starter/scripts/toolcraft-delivery-executor.mjs +294 -0
  902. package/templates/starter/scripts/toolcraft-delivery-executor.test.mjs +463 -0
  903. package/templates/starter/scripts/toolcraft-delivery-framework-refresh.test.mjs +141 -0
  904. package/templates/starter/scripts/toolcraft-delivery-functional-changed.test.mjs +468 -0
  905. package/templates/starter/scripts/toolcraft-delivery-functional-context.d.mts +72 -0
  906. package/templates/starter/scripts/toolcraft-delivery-functional-context.mjs +56 -0
  907. package/templates/starter/scripts/toolcraft-delivery-functional-context.test.mjs +231 -0
  908. package/templates/starter/scripts/toolcraft-delivery-functional-initial.test.mjs +212 -0
  909. package/templates/starter/scripts/toolcraft-delivery-functional-model-lifecycle.test.mjs +254 -0
  910. package/templates/starter/scripts/toolcraft-delivery-functional-semantic-regression.test.mjs +135 -0
  911. package/templates/starter/scripts/toolcraft-delivery-lifecycle-state.mjs +226 -0
  912. package/templates/starter/scripts/toolcraft-delivery-lifecycle-state.test.mjs +83 -0
  913. package/templates/starter/scripts/toolcraft-delivery-lifecycle.mjs +340 -0
  914. package/templates/starter/scripts/toolcraft-delivery-module-graph.test.mjs +393 -0
  915. package/templates/starter/scripts/toolcraft-delivery-performance-iteration-authority.test.mjs +88 -0
  916. package/templates/starter/scripts/toolcraft-delivery-performance-iteration-durability.test.mjs +329 -0
  917. package/templates/starter/scripts/toolcraft-delivery-performance-iteration-evidence.test.mjs +104 -0
  918. package/templates/starter/scripts/toolcraft-delivery-performance-iteration-lifecycle.test.mjs +478 -0
  919. package/templates/starter/scripts/toolcraft-delivery-performance-iteration-test-helpers.mjs +19 -0
  920. package/templates/starter/scripts/toolcraft-delivery-plan-authority.test.mjs +282 -0
  921. package/templates/starter/scripts/toolcraft-delivery-plan-construction.mjs +166 -0
  922. package/templates/starter/scripts/toolcraft-delivery-plan-errors.test.mjs +425 -0
  923. package/templates/starter/scripts/toolcraft-delivery-plan-functional-model.test.mjs +358 -0
  924. package/templates/starter/scripts/toolcraft-delivery-plan.d.mts +155 -0
  925. package/templates/starter/scripts/toolcraft-delivery-plan.mjs +334 -0
  926. package/templates/starter/scripts/toolcraft-delivery-plan.test.mjs +487 -0
  927. package/templates/starter/scripts/toolcraft-delivery-receipt-performance.test.mjs +156 -0
  928. package/templates/starter/scripts/toolcraft-delivery-receipt-strictness.test.mjs +220 -0
  929. package/templates/starter/scripts/toolcraft-delivery-receipt-test-helpers.mjs +226 -0
  930. package/templates/starter/scripts/toolcraft-delivery-receipt.d.mts +83 -0
  931. package/templates/starter/scripts/toolcraft-delivery-receipt.mjs +216 -0
  932. package/templates/starter/scripts/toolcraft-delivery-receipt.test.mjs +195 -0
  933. package/templates/starter/scripts/toolcraft-delivery-receipt.types.test.mts +161 -0
  934. package/templates/starter/scripts/toolcraft-dependency-source-record.mjs +59 -0
  935. package/templates/starter/scripts/toolcraft-fixture-module-closure.mjs +279 -0
  936. package/templates/starter/scripts/toolcraft-fixture-module-closure.test.mjs +184 -0
  937. package/templates/starter/scripts/toolcraft-full-performance-test-helpers.mjs +67 -0
  938. package/templates/starter/scripts/toolcraft-functional-proof-model.d.mts +47 -0
  939. package/templates/starter/scripts/toolcraft-functional-proof-model.mjs +198 -0
  940. package/templates/starter/scripts/toolcraft-functional-proof-model.test.mjs +453 -0
  941. package/templates/starter/scripts/toolcraft-functional-proof-model.types.test.mts +102 -0
  942. package/templates/starter/scripts/toolcraft-functional-proof-primitives.d.mts +6 -0
  943. package/templates/starter/scripts/toolcraft-functional-proof-primitives.mjs +98 -0
  944. package/templates/starter/scripts/toolcraft-functional-proof-primitives.test.mjs +67 -0
  945. package/templates/starter/scripts/toolcraft-functional-proof-regression-fixtures.mjs +298 -0
  946. package/templates/starter/scripts/toolcraft-graph-reachability.mjs +73 -0
  947. package/templates/starter/scripts/toolcraft-integrity-manifest.mjs +5 -2
  948. package/templates/starter/scripts/toolcraft-integrity-policy.d.mts +6 -0
  949. package/templates/starter/scripts/toolcraft-integrity-policy.mjs +14 -6
  950. package/templates/starter/scripts/toolcraft-integrity-test-utils.mjs +84 -0
  951. package/templates/starter/scripts/toolcraft-kernel-benchmark-receipt.d.mts +47 -0
  952. package/templates/starter/scripts/toolcraft-kernel-benchmark-receipt.mjs +306 -0
  953. package/templates/starter/scripts/toolcraft-kernel-benchmark-receipt.test.mjs +169 -0
  954. package/templates/starter/scripts/toolcraft-layer-evidence-facade.test.mjs +256 -0
  955. package/templates/starter/scripts/toolcraft-layer-evidence-reporter.test.mjs +106 -0
  956. package/templates/starter/scripts/toolcraft-local-dependency-evidence.test.mjs +453 -0
  957. package/templates/starter/scripts/toolcraft-local-dependency-graph.mjs +344 -0
  958. package/templates/starter/scripts/toolcraft-local-dependency-graph.test.mjs +372 -0
  959. package/templates/starter/scripts/toolcraft-performance-authority-policy.d.mts +40 -0
  960. package/templates/starter/scripts/toolcraft-performance-authority-policy.mjs +274 -0
  961. package/templates/starter/scripts/toolcraft-performance-checkpoint-runner.mjs +87 -0
  962. package/templates/starter/scripts/toolcraft-performance-checkpoint-runner.test.mjs +50 -0
  963. package/templates/starter/scripts/toolcraft-performance-escalation-policy.mjs +72 -0
  964. package/templates/starter/scripts/toolcraft-performance-escalation-policy.test.mjs +393 -0
  965. package/templates/starter/scripts/toolcraft-performance-iteration-comparison.mjs +127 -0
  966. package/templates/starter/scripts/toolcraft-performance-iteration-comparison.test.mjs +133 -0
  967. package/templates/starter/scripts/toolcraft-performance-receipt-policy.mjs +127 -0
  968. package/templates/starter/scripts/toolcraft-performance-receipt-validation.test.mjs +214 -0
  969. package/templates/starter/scripts/toolcraft-performance-report.d.mts +34 -0
  970. package/templates/starter/scripts/toolcraft-performance-report.mjs +244 -0
  971. package/templates/starter/scripts/toolcraft-performance-report.test.mjs +138 -0
  972. package/templates/starter/scripts/toolcraft-performance-request-authority.mjs +64 -0
  973. package/templates/starter/scripts/toolcraft-performance-request-authority.test.mjs +488 -0
  974. package/templates/starter/scripts/toolcraft-plan-execution-authority.mjs +143 -0
  975. package/templates/starter/scripts/toolcraft-playwright-evidence-authority.mjs +96 -0
  976. package/templates/starter/scripts/toolcraft-playwright-evidence-authority.test.mjs +94 -0
  977. package/templates/starter/scripts/toolcraft-product-boundary-ast.mjs +65 -51
  978. package/templates/starter/scripts/toolcraft-product-boundary-graph-evidence.test.mjs +161 -0
  979. package/templates/starter/scripts/toolcraft-product-boundary.mjs +104 -129
  980. package/templates/starter/scripts/toolcraft-product-boundary.test.mjs +46 -0
  981. package/templates/starter/scripts/toolcraft-product-dependency-resolution.mjs +61 -118
  982. package/templates/starter/scripts/toolcraft-product-evidence-boundary-ast.mjs +97 -31
  983. package/templates/starter/scripts/toolcraft-product-evidence-boundary.test.mjs +204 -1
  984. package/templates/starter/scripts/toolcraft-product-model-presentation-boundary.test.mjs +49 -0
  985. package/templates/starter/scripts/toolcraft-product-observable-facade.test.mjs +223 -0
  986. package/templates/starter/scripts/toolcraft-product-style-boundary.mjs +0 -136
  987. package/templates/starter/scripts/toolcraft-proof-process.mjs +199 -0
  988. package/templates/starter/scripts/toolcraft-proof-process.test.mjs +466 -0
  989. package/templates/starter/scripts/toolcraft-protected-browser-build.mjs +32 -0
  990. package/templates/starter/scripts/toolcraft-readonly-adjacency.mjs +44 -0
  991. package/templates/starter/scripts/toolcraft-receipt-boundary.test.mjs +285 -0
  992. package/templates/starter/scripts/toolcraft-receipt-file-io.mjs +16 -0
  993. package/templates/starter/scripts/toolcraft-source-inventory.mjs +100 -1
  994. package/templates/starter/scripts/toolcraft-source-inventory.test.mjs +106 -0
  995. package/templates/starter/scripts/toolcraft-source-ownership.mjs +15 -0
  996. package/templates/starter/scripts/toolcraft-source-ownership.test.mjs +31 -1
  997. package/templates/starter/scripts/toolcraft-state-evidence-facade.test.mjs +258 -0
  998. package/templates/starter/scripts/toolcraft-state-evidence-reporter.test.mjs +78 -0
  999. package/templates/starter/scripts/toolcraft-static-string.mjs +234 -28
  1000. package/templates/starter/scripts/toolcraft-targeted-performance-execution.mjs +274 -0
  1001. package/templates/starter/scripts/toolcraft-targeted-performance-execution.test.mjs +225 -0
  1002. package/templates/starter/scripts/toolcraft-targeted-performance-report-combination.mjs +83 -0
  1003. package/templates/starter/scripts/toolcraft-targeted-performance-report-combination.test.mjs +131 -0
  1004. package/templates/starter/scripts/toolcraft-targeted-performance-report.d.mts +89 -0
  1005. package/templates/starter/scripts/toolcraft-targeted-performance-report.mjs +321 -0
  1006. package/templates/starter/scripts/toolcraft-targeted-performance-report.test.mjs +225 -0
  1007. package/templates/starter/scripts/toolcraft-targeted-performance-report.types.test.mts +71 -0
  1008. package/templates/starter/scripts/toolcraft-typescript-analysis.mjs +334 -0
  1009. package/templates/starter/scripts/toolcraft-typescript-architecture-invariants.test.mjs +202 -0
  1010. package/templates/starter/scripts/toolcraft-typescript-callables.mjs +83 -0
  1011. package/templates/starter/scripts/toolcraft-typescript-module-shape.mjs +156 -0
  1012. package/templates/starter/scripts/toolcraft-typescript-semantic-evidence.mjs +66 -0
  1013. package/templates/starter/scripts/toolcraft-typescript-source-evidence-structure.test.mjs +44 -0
  1014. package/templates/starter/scripts/toolcraft-typescript-source-evidence.d.mts +86 -0
  1015. package/templates/starter/scripts/toolcraft-typescript-source-evidence.mjs +334 -0
  1016. package/templates/starter/scripts/toolcraft-unavailable-resource-evidence-facade.test.mjs +439 -0
  1017. package/templates/starter/scripts/toolcraft-verification-impact-inventory.d.mts +62 -0
  1018. package/templates/starter/scripts/toolcraft-verification-impact-inventory.mjs +344 -0
  1019. package/templates/starter/scripts/toolcraft-verification-impact-inventory.test.mjs +204 -0
  1020. package/templates/starter/scripts/toolcraft-verification-impact-performance-candidates.test.mjs +210 -0
  1021. package/templates/starter/scripts/toolcraft-verification-impact-resolution.mjs +344 -0
  1022. package/templates/starter/scripts/toolcraft-verification-impact-resolution.test.mjs +270 -0
  1023. package/templates/starter/scripts/toolcraft-verification-impact-semantic-resolution.test.mjs +449 -0
  1024. package/templates/starter/scripts/toolcraft-verification-impact-support-resolution.test.mjs +195 -0
  1025. package/templates/starter/scripts/toolcraft-verification-impact.d.mts +132 -0
  1026. package/templates/starter/scripts/toolcraft-verification-impact.mjs +169 -0
  1027. package/templates/starter/scripts/toolcraft-verification-impact.test.mjs +300 -0
  1028. package/templates/starter/scripts/toolcraft-verification-input-roles.d.mts +60 -0
  1029. package/templates/starter/scripts/toolcraft-verification-input-roles.mjs +197 -0
  1030. package/templates/starter/scripts/toolcraft-verification-input-roles.test.mjs +225 -0
  1031. package/templates/starter/scripts/toolcraft-verification-inventory.mjs +138 -42
  1032. package/templates/starter/scripts/toolcraft-verification-lock.mjs +64 -0
  1033. package/templates/starter/scripts/toolcraft-verification-receipt-test-helpers.mjs +245 -0
  1034. package/templates/starter/scripts/toolcraft-verification-receipt.d.mts +40 -6
  1035. package/templates/starter/scripts/toolcraft-verification-receipt.mjs +95 -229
  1036. package/templates/starter/scripts/toolcraft-verification-receipt.test.mjs +325 -210
  1037. package/templates/starter/scripts/toolcraft-vite-env-activation.test.mjs +131 -0
  1038. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.mjs +18 -0
  1039. package/templates/starter/scripts/toolcraft-vitest-runtime-contract.test.mjs +36 -0
  1040. package/templates/starter/scripts/toolcraft-vitest-runtime-evidence-reporter.test.mjs +7 -0
  1041. package/templates/starter/scripts/toolcraft-worklog-decision-trail.d.mts +14 -0
  1042. package/templates/starter/scripts/toolcraft-worklog-decision-trail.mjs +170 -0
  1043. package/templates/starter/src/app/acceptance/canvas-coverage.ts +18 -0
  1044. package/templates/starter/src/app/acceptance/canvas-handle-acceptance.ts +5 -14
  1045. package/templates/starter/src/app/acceptance/condition-exclusivity.test.ts +60 -0
  1046. package/templates/starter/src/app/acceptance/condition-exclusivity.ts +221 -0
  1047. package/templates/starter/src/app/acceptance/control-acceptance-context.ts +20 -6
  1048. package/templates/starter/src/app/acceptance/control-acceptance-coverage.ts +60 -10
  1049. package/templates/starter/src/app/acceptance/control-acceptance-kind-rules.ts +55 -7
  1050. package/templates/starter/src/app/acceptance/control-acceptance.ts +3 -0
  1051. package/templates/starter/src/app/acceptance/control-component-rules.ts +0 -32
  1052. package/templates/starter/src/app/acceptance/control-layout-entity-rules.ts +7 -4
  1053. package/templates/starter/src/app/acceptance/control-layout-model.ts +12 -4
  1054. package/templates/starter/src/app/acceptance/control-section-inventory.test.ts +136 -0
  1055. package/templates/starter/src/app/acceptance/control-section-inventory.ts +69 -24
  1056. package/templates/starter/src/app/acceptance/controls.ts +4 -0
  1057. package/templates/starter/src/app/acceptance/infinity-canvas.ts +81 -0
  1058. package/templates/starter/src/app/acceptance/inline-layout.ts +14 -3
  1059. package/templates/starter/src/app/acceptance/interaction-ownership-intent.ts +31 -0
  1060. package/templates/starter/src/app/acceptance/interaction-ownership.ts +283 -0
  1061. package/templates/starter/src/app/acceptance/interaction-targets.ts +18 -0
  1062. package/templates/starter/src/app/acceptance/media-upload.ts +115 -10
  1063. package/templates/starter/src/app/acceptance/model-import-coverage.ts +42 -0
  1064. package/templates/starter/src/app/acceptance/orientation-gizmo.ts +176 -0
  1065. package/templates/starter/src/app/acceptance/output-background-rules.ts +58 -18
  1066. package/templates/starter/src/app/acceptance/output-export-layout-rules.ts +4 -8
  1067. package/templates/starter/src/app/acceptance/output-export-model.ts +17 -7
  1068. package/templates/starter/src/app/acceptance/reference-study-types.ts +60 -0
  1069. package/templates/starter/src/app/acceptance/render-scale.ts +107 -0
  1070. package/templates/starter/src/app/acceptance/runtime-coverage.ts +45 -0
  1071. package/templates/starter/src/app/acceptance/runtime-setup.ts +4 -2
  1072. package/templates/starter/src/app/acceptance/types.ts +66 -63
  1073. package/templates/starter/src/app/acceptance/validate-coverage.ts +76 -4
  1074. package/templates/starter/src/app/acceptance/validation-pipeline.test.ts +5 -1
  1075. package/templates/starter/src/app/acceptance/validation-pipeline.ts +2 -0
  1076. package/templates/starter/src/app/acceptance/view-interaction-intent.ts +23 -0
  1077. package/templates/starter/src/app/acceptance/view-interaction.ts +148 -0
  1078. package/templates/starter/src/app/starter-acceptance-data.ts +28 -1
  1079. package/templates/starter/src/app/starter-acceptance.animation-intent.test.ts +7 -4
  1080. package/templates/starter/src/app/starter-acceptance.background-export.test.ts +17 -14
  1081. package/templates/starter/src/app/starter-acceptance.base-coverage.test.ts +3 -0
  1082. package/templates/starter/src/app/starter-acceptance.canvas-sizing.test.ts +133 -4
  1083. package/templates/starter/src/app/starter-acceptance.compound-part-coverage.test.ts +6 -4
  1084. package/templates/starter/src/app/starter-acceptance.contract-fixtures.test.ts +40 -0
  1085. package/templates/starter/src/app/starter-acceptance.contract-fixtures.ts +20 -2
  1086. package/templates/starter/src/app/starter-acceptance.control-label-context.test.ts +7 -5
  1087. package/templates/starter/src/app/starter-acceptance.control-labels.test.ts +10 -8
  1088. package/templates/starter/src/app/starter-acceptance.control-naming-rules.test.ts +6 -7
  1089. package/templates/starter/src/app/starter-acceptance.control-order.test.ts +110 -2
  1090. package/templates/starter/src/app/starter-acceptance.control-state.test.ts +6 -7
  1091. package/templates/starter/src/app/starter-acceptance.curves-rules.test.ts +4 -5
  1092. package/templates/starter/src/app/starter-acceptance.custom-control-collections.test.ts +7 -5
  1093. package/templates/starter/src/app/starter-acceptance.custom-control-coverage.test.ts +3 -4
  1094. package/templates/starter/src/app/starter-acceptance.custom-control-fit-check.test.ts +6 -4
  1095. package/templates/starter/src/app/starter-acceptance.custom-control-valid.test.ts +5 -3
  1096. package/templates/starter/src/app/starter-acceptance.image-video-export-settings.test.ts +5 -6
  1097. package/templates/starter/src/app/starter-acceptance.interaction-ownership.test.ts +408 -0
  1098. package/templates/starter/src/app/starter-acceptance.keyframes.test.ts +3 -2
  1099. package/templates/starter/src/app/starter-acceptance.layers.test.ts +2 -0
  1100. package/templates/starter/src/app/starter-acceptance.media-upload.fixtures.ts +34 -4
  1101. package/templates/starter/src/app/starter-acceptance.media-upload.test.ts +225 -2
  1102. package/templates/starter/src/app/starter-acceptance.orientation-gizmo.test.ts +265 -0
  1103. package/templates/starter/src/app/starter-acceptance.output-export-rules.test.ts +14 -24
  1104. package/templates/starter/src/app/starter-acceptance.persistence-coverage.test.ts +50 -0
  1105. package/templates/starter/src/app/starter-acceptance.product-output-export.test.ts +7 -7
  1106. package/templates/starter/src/app/starter-acceptance.product-readiness.test.ts +2 -0
  1107. package/templates/starter/src/app/starter-acceptance.product-worklog.test.ts +1 -7
  1108. package/templates/starter/src/app/starter-acceptance.range-slider-rules.test.ts +3 -4
  1109. package/templates/starter/src/app/starter-acceptance.reference-foundation.test.ts +2 -2
  1110. package/templates/starter/src/app/starter-acceptance.render-scale.test.ts +305 -0
  1111. package/templates/starter/src/app/starter-acceptance.schema-test-utils.ts +1 -1
  1112. package/templates/starter/src/app/starter-acceptance.section-cohesion.test.ts +5 -5
  1113. package/templates/starter/src/app/starter-acceptance.section-dependencies.test.ts +11 -5
  1114. package/templates/starter/src/app/starter-acceptance.section-titles.test.ts +4 -5
  1115. package/templates/starter/src/app/starter-acceptance.setup-readiness.test.ts +26 -9
  1116. package/templates/starter/src/app/starter-acceptance.slider-rules.test.ts +9 -7
  1117. package/templates/starter/src/app/starter-acceptance.slider-unit-rules.test.ts +2 -3
  1118. package/templates/starter/src/app/starter-acceptance.text-control-kind.test.ts +3 -4
  1119. package/templates/starter/src/app/starter-acceptance.toggle-pair-layout.test.ts +5 -6
  1120. package/templates/starter/src/app/starter-acceptance.toggle-parameter-layout.test.ts +63 -7
  1121. package/templates/starter/src/app/starter-acceptance.ts +29 -0
  1122. package/templates/starter/src/app/starter-acceptance.video-reference-study.test.ts +3 -3
  1123. package/templates/starter/src/app/starter-acceptance.view-interaction.test.ts +282 -0
  1124. package/templates/starter/src/app/starter-acceptance.worklog-command-authority.test.ts +123 -0
  1125. package/templates/starter/src/app/starter-acceptance.worklog-performance-command-cases.ts +34 -0
  1126. package/templates/starter/src/app/starter-acceptance.worklog-performance-intent-test-utils.ts +98 -0
  1127. package/templates/starter/src/app/starter-acceptance.worklog-performance-intent.test.ts +299 -0
  1128. package/templates/starter/src/app/starter-acceptance.worklog-test-utils.ts +76 -173
  1129. package/templates/starter/src/app/starter-acceptance.worklog.test.ts +92 -114
  1130. package/templates/starter/src/app/starter-automated-runtime-evidence.test.ts +0 -8
  1131. package/templates/starter/src/app/starter-composition.tsx +1 -0
  1132. package/templates/starter/src/app/starter-identity.ts +4 -0
  1133. package/templates/starter/src/app/starter-performance-test-utils.ts +0 -87
  1134. package/templates/starter/src/app/starter-performance.fixture-helper.test.ts +191 -0
  1135. package/templates/starter/src/app/starter-performance.gates.test.ts +385 -39
  1136. package/templates/starter/src/app/starter-performance.ts +8 -13
  1137. package/templates/starter/src/app/starter-schema.test.ts +26 -2
  1138. package/templates/starter/src/app/starter-schema.ts +3 -0
  1139. package/templates/starter/src/app/starter-verification-impact.json +15 -0
  1140. package/templates/starter/src/app/test-evidence/browser-performance-contract.ts +387 -0
  1141. package/templates/starter/src/app/test-evidence/browser-performance-measurement-contract.ts +258 -0
  1142. package/templates/starter/src/app/test-evidence/browser-runtime-contract.ts +31 -2
  1143. package/templates/starter/src/router.tsx +3 -0
  1144. package/templates/starter/src/routes/index.tsx +3 -0
  1145. package/templates/starter/tsconfig.json +7 -1
  1146. package/templates/ui/components/composites/tabs.tsx +10 -0
  1147. package/templates/ui/components/controls/actions/actions-control.tsx +17 -1
  1148. package/templates/ui/components/controls/actions/index.ts +1 -0
  1149. package/templates/ui/components/controls/boolean/boolean-controls.tsx +5 -0
  1150. package/templates/ui/components/controls/file-drop/file-drop-control.test.tsx +96 -0
  1151. package/templates/ui/components/controls/file-drop/file-drop-control.tsx +325 -104
  1152. package/templates/ui/components/controls/file-drop/file-drop-empty-state.tsx +51 -17
  1153. package/templates/ui/components/controls/file-drop/file-drop-file-list.tsx +85 -61
  1154. package/templates/ui/components/controls/file-drop/file-drop-folder-input.tsx +39 -0
  1155. package/templates/ui/components/controls/file-drop/file-drop-image-grid.tsx +64 -43
  1156. package/templates/ui/components/controls/file-drop/file-drop-presentation-messages.tsx +57 -0
  1157. package/templates/ui/components/controls/file-drop/file-drop-presentation.test.ts +58 -0
  1158. package/templates/ui/components/controls/file-drop/{file-drop-model.tsx → file-drop-presentation.tsx} +128 -2
  1159. package/templates/ui/components/controls/file-drop/file-drop-single-preview.tsx +32 -25
  1160. package/templates/ui/components/controls/file-drop/file-drop-types.ts +99 -8
  1161. package/templates/ui/components/controls/file-drop/index.ts +5 -1
  1162. package/templates/ui/components/controls/font-picker/font-catalog.node-import.test.ts +24 -0
  1163. package/templates/ui/components/controls/font-picker/font-catalog.ts +1 -1
  1164. package/templates/ui/components/controls/index.ts +7 -0
  1165. package/templates/ui/components/controls/tabs/index.ts +4 -0
  1166. package/templates/ui/components/controls/tabs/tabs-control.tsx +166 -0
  1167. package/templates/ui/components/panel/panel-section.tsx +6 -1
  1168. package/templates/ui/components/panel/panel.tsx +6 -2
  1169. package/templates/ui/components/primitives/index.ts +1 -0
  1170. package/templates/ui/components/primitives/scroll-fade-render.tsx +11 -2
  1171. package/templates/ui/components/primitives/scroll-fade-types.ts +2 -0
  1172. package/templates/ui/components/primitives/scroll-fade.test.tsx +63 -0
  1173. package/templates/ui/components/primitives/scroll-fade.tsx +2 -0
  1174. package/templates/ui/index.ts +1 -0
  1175. package/templates/runtime/react/controls-panel/layout/controls-panel-collapse-storage.ts +0 -131
  1176. package/templates/runtime/testing/performance-browser-policy.test.ts +0 -81
  1177. package/templates/runtime/testing/performance-browser-policy.ts +0 -102
  1178. package/templates/runtime/testing/performance-budget-validation.ts +0 -84
  1179. package/templates/runtime/testing/performance-control-classification.test.ts +0 -106
  1180. package/templates/runtime/testing/performance-coverage-context.ts +0 -44
  1181. package/templates/runtime/testing/performance-coverage-renderer-policy.ts +0 -221
  1182. package/templates/runtime/testing/performance-coverage-scenario-policy.ts +0 -147
  1183. package/templates/runtime/testing/performance-coverage-target-policy.ts +0 -121
  1184. package/templates/runtime/testing/performance-export-coverage.test.ts +0 -234
  1185. package/templates/runtime/testing/performance-fixture-load-profile.test.ts +0 -360
  1186. package/templates/runtime/testing/performance-fixture-media.test.ts +0 -80
  1187. package/templates/runtime/testing/performance-fixture-stress.test.ts +0 -314
  1188. package/templates/runtime/testing/performance-fixture-validation.ts +0 -255
  1189. package/templates/runtime/testing/performance-fixture-values.ts +0 -275
  1190. package/templates/runtime/testing/performance-fixture-workload.test.ts +0 -140
  1191. package/templates/runtime/testing/performance-load-profile-validation.ts +0 -467
  1192. package/templates/runtime/testing/performance-renderer-coverage.test.ts +0 -325
  1193. package/templates/runtime/testing/performance-renderer-pipeline-coverage.test.ts +0 -115
  1194. package/templates/runtime/testing/performance-renderer-pipeline-interactions.test.ts +0 -201
  1195. package/templates/runtime/testing/performance-renderer-pipeline-passes.test.ts +0 -247
  1196. package/templates/runtime/testing/performance-renderer-technique.test.ts +0 -275
  1197. package/templates/runtime/testing/performance-renderer-validation.ts +0 -2
  1198. package/templates/runtime/testing/performance-scenario-coverage.test.ts +0 -303
  1199. package/templates/runtime/testing/performance-schema-derived-workloads.test.ts +0 -231
  1200. package/templates/runtime/testing/performance-test-fixtures/scenarios.ts +0 -172
  1201. package/templates/runtime/testing/performance-test-fixtures/stress-fixtures.ts +0 -133
  1202. package/templates/starter/e2e/performance-render-scale-helpers.ts +0 -55
  1203. package/templates/starter/scripts/check-ai-skills.mjs +0 -136
  1204. package/templates/starter/scripts/check-ai-skills.test.mjs +0 -64
  1205. package/templates/starter/scripts/toolcraft-product-boundary-ast-utils.mjs +0 -23
  1206. package/templates/starter/scripts/toolcraft-product-dependency-graph.mjs +0 -176
  1207. package/templates/starter/scripts/toolcraft-product-dependency-graph.test.mjs +0 -196
  1208. package/templates/starter/src/app/starter-acceptance.video-export-test-utils.ts +0 -37
  1209. package/templates/starter/src/app/starter-performance.budgets.test.ts +0 -374
  1210. package/templates/starter/src/app/starter-performance.renderer-source.test.ts +0 -136
  1211. package/templates/starter/src/app/starter-performance.renderer-technique.test.ts +0 -291
  1212. package/templates/starter/src/app/starter-performance.scenarios.test.ts +0 -355
@@ -0,0 +1,285 @@
1
+ import assert from "node:assert/strict";
2
+ import fs from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+ import path from "node:path";
5
+ import test from "node:test";
6
+
7
+ import {
8
+ getToolcraftDeliveryReceiptShapeError,
9
+ validateToolcraftDeliveryReceipt,
10
+ } from "./toolcraft-delivery-receipt.mjs";
11
+ import * as deliveryAnchor from "./toolcraft-delivery-anchor.mjs";
12
+ import {
13
+ createToolcraftLocalDependencyGraph,
14
+ getToolcraftProductionCycleViolations,
15
+ } from "./toolcraft-local-dependency-graph.mjs";
16
+ import { getToolcraftPerformanceReceiptShapeError } from "./toolcraft-performance-receipt-policy.mjs";
17
+ import * as performanceReceiptPolicy from "./toolcraft-performance-receipt-policy.mjs";
18
+ import {
19
+ validateToolcraftPerformanceReceipt,
20
+ validateToolcraftVerificationReceipt,
21
+ } from "./toolcraft-verification-receipt.mjs";
22
+ import * as verificationReceiptFacade from "./toolcraft-verification-receipt.mjs";
23
+ import * as receiptFileIo from "./toolcraft-receipt-file-io.mjs";
24
+ import * as deliveryEvidence from "./toolcraft-delivery-evidence.mjs";
25
+ import * as deliveryExecutor from "./toolcraft-delivery-executor.mjs";
26
+ import * as planExecutionAuthority from "./toolcraft-plan-execution-authority.mjs";
27
+ import * as targetedPerformanceExecution from "./toolcraft-targeted-performance-execution.mjs";
28
+ import * as proofProcess from "./toolcraft-proof-process.mjs";
29
+ import { collectToolcraftSourceInventory } from "./toolcraft-source-inventory.mjs";
30
+ import { isToolcraftPackageRootOrSubpath } from "./toolcraft-typescript-source-evidence.mjs";
31
+ import { createReceiptFixture } from "./toolcraft-verification-receipt-test-helpers.mjs";
32
+
33
+ const expectedVerificationReceiptExports = [
34
+ "TOOLCRAFT_PERFORMANCE_RECEIPT_VERSION",
35
+ "assertToolcraftVerificationInputsUnchanged",
36
+ "collectToolcraftVerificationInputs",
37
+ "readToolcraftDurablePerformanceBaseline",
38
+ "validateToolcraftCurrentPerformanceImpactInventory",
39
+ "validateToolcraftPerformanceReceipt",
40
+ "validateToolcraftVerificationReceipt",
41
+ ];
42
+
43
+ const expectedDeliveryExecutorExports = [
44
+ "executeToolcraftDeliveryPlan",
45
+ "executeToolcraftDeliveryPlanCore",
46
+ "finalizeToolcraftPlanExecutionAuthority",
47
+ "releaseToolcraftPlanExecutionAuthority",
48
+ "reserveToolcraftPlanExecutionAuthority",
49
+ ];
50
+
51
+ const expectedPerformanceReceiptPolicyExports = [
52
+ "TOOLCRAFT_PERFORMANCE_RECEIPT_VERSION",
53
+ "createToolcraftPerformanceCheckpointReceipt",
54
+ "getToolcraftPerformanceReceiptShapeError",
55
+ ];
56
+
57
+ async function collectCrossSpawnImportFacts(rootDir) {
58
+ const inventory = await collectToolcraftSourceInventory({
59
+ rootDir,
60
+ sourceRoots: ["scripts"],
61
+ testSupportPatterns: [
62
+ /(?:^|\/)[^/]+-fixture\.[cm]?js$/u,
63
+ /(?:^|\/)[^/]+-test-(?:helpers|fixtures)\.[cm]?js$/u,
64
+ ],
65
+ });
66
+ assert.deepEqual(inventory.filesystemViolations, []);
67
+ const graph = await createToolcraftLocalDependencyGraph({
68
+ entries: inventory.entries.filter(({ role }) => role === "production"),
69
+ rootDir,
70
+ });
71
+ return graph.moduleImports.filter(({ specifier }) =>
72
+ isToolcraftPackageRootOrSubpath(specifier, "cross-spawn")
73
+ );
74
+ }
75
+
76
+ test("receipt production dependency graph is acyclic", async () => {
77
+ const rootDir = path.resolve(import.meta.dirname, "../..");
78
+ const scriptNames = await fs.readdir(import.meta.dirname);
79
+ const entries = scriptNames
80
+ .filter(
81
+ (name) =>
82
+ name.endsWith(".mjs") &&
83
+ !name.endsWith(".test.mjs") &&
84
+ !name.endsWith("-test-helpers.mjs"),
85
+ )
86
+ .map((name) => ({
87
+ absolutePath: path.join(import.meta.dirname, name),
88
+ owner: "product",
89
+ repoPath: `starter/scripts/${name}`,
90
+ role: "production",
91
+ }));
92
+ const graph = await createToolcraftLocalDependencyGraph({
93
+ entries,
94
+ rootDir,
95
+ });
96
+ const violations = getToolcraftProductionCycleViolations(graph).filter(({ cycle }) =>
97
+ cycle.some((repoPath) => /toolcraft-(?:delivery|verification)-receipt/iu.test(repoPath)),
98
+ );
99
+
100
+ assert.deepEqual(violations, []);
101
+ });
102
+
103
+ test("verification receipt facade preserves its public API", () => {
104
+ assert.deepEqual(
105
+ Object.keys(verificationReceiptFacade).sort(),
106
+ expectedVerificationReceiptExports,
107
+ );
108
+ assert.equal(
109
+ "writeToolcraftPerformanceIteration" in verificationReceiptFacade,
110
+ false,
111
+ );
112
+ });
113
+
114
+ test("delivery anchor exposes only the current receipt boundary", async () => {
115
+ assert.deepEqual(Object.keys(deliveryAnchor).sort(), [
116
+ "getToolcraftDeliveryAnchorShapeError",
117
+ "normalizeToolcraftDeliveryAnchor",
118
+ "readToolcraftDeliveryAnchor",
119
+ "validateToolcraftDeliveryAnchor",
120
+ ]);
121
+ for (const obsolete of [
122
+ "toolcraft-delivery-baseline-policy.mjs",
123
+ "toolcraft-delivery-anchor-utils.mjs",
124
+ "toolcraft-delivery-anchor-verification.mjs",
125
+ "toolcraft-delivery-receipt-builder.mjs",
126
+ "toolcraft-linked-performance-authority.mjs",
127
+ "toolcraft-legacy-targeted-evidence.mjs",
128
+ "toolcraft-verification-receipt-core.mjs",
129
+ ]) {
130
+ await assert.rejects(
131
+ fs.access(path.join(import.meta.dirname, obsolete)),
132
+ /ENOENT/iu,
133
+ );
134
+ }
135
+ });
136
+
137
+ test("receipt file I/O exposes no generic protected receipt writer", () => {
138
+ assert.deepEqual(Object.keys(receiptFileIo), ["readToolcraftReceiptFile"]);
139
+ });
140
+
141
+ test("plan execution owns one exact evidence and authority boundary", async () => {
142
+ assert.deepEqual(
143
+ Object.keys(deliveryExecutor).sort(),
144
+ expectedDeliveryExecutorExports,
145
+ );
146
+ assert.deepEqual(
147
+ Object.keys(deliveryEvidence).sort(),
148
+ [
149
+ "getToolcraftExecutionEvidenceError",
150
+ "getToolcraftProofStepEvidenceError",
151
+ ],
152
+ );
153
+ assert.deepEqual(Object.keys(planExecutionAuthority), [
154
+ "createToolcraftPlanExecutionAuthorityRegistry",
155
+ ]);
156
+ assert.deepEqual(Object.keys(targetedPerformanceExecution).sort(), [
157
+ "executeToolcraftTargetedPerformanceVerification",
158
+ "executeToolcraftTargetedPerformanceVerificationCore",
159
+ ]);
160
+ assert.deepEqual(Object.keys(proofProcess).sort(), [
161
+ "captureToolcraftProofProcess",
162
+ "detectToolcraftPackageManager",
163
+ "ensureToolcraftChromium",
164
+ "getToolcraftBinaryPath",
165
+ "getToolcraftFrozenInstallCommand",
166
+ "runToolcraftProofPackageScript",
167
+ "runToolcraftProofProcess",
168
+ ]);
169
+ for (const obsolete of [
170
+ "toolcraft-targeted-evidence-policy.mjs",
171
+ "toolcraft-targeted-execution-authority.mjs",
172
+ "toolcraft-targeted-verification-execution.mjs",
173
+ "toolcraft-targeted-verification-runner.mjs",
174
+ "toolcraft-targeted-verification-selection.mjs",
175
+ ]) {
176
+ await assert.rejects(
177
+ fs.access(path.join(import.meta.dirname, obsolete)),
178
+ /ENOENT/iu,
179
+ );
180
+ }
181
+ });
182
+
183
+ test("short-lived proof execution imports cross-spawn only through the canonical adapter", async () => {
184
+ const rootDir = path.resolve(import.meta.dirname, "..");
185
+ const crossSpawnImporters = [
186
+ ...new Set(
187
+ (await collectCrossSpawnImportFacts(rootDir)).map(
188
+ ({ importerRepoPath }) => importerRepoPath,
189
+ ),
190
+ ),
191
+ ].sort();
192
+ assert.deepEqual(crossSpawnImporters, [
193
+ "scripts/run-kernel-benchmarks.mjs",
194
+ "scripts/run-vite-on-free-port.mjs",
195
+ "scripts/toolcraft-proof-process.mjs",
196
+ ]);
197
+ for (const obsolete of [
198
+ "toolcraft-delivery-command-runner.mjs",
199
+ "toolcraft-targeted-process-adapter.mjs",
200
+ ]) {
201
+ await assert.rejects(
202
+ fs.access(path.join(import.meta.dirname, obsolete)),
203
+ /ENOENT/iu,
204
+ );
205
+ }
206
+ });
207
+
208
+ test("cross-spawn import guard catches recursive structural bypass variants", async (t) => {
209
+ const rootDir = await fs.mkdtemp(
210
+ path.join(tmpdir(), "cross-spawn-import-fixture-"),
211
+ );
212
+ t.after(() => fs.rm(rootDir, { force: true, recursive: true }));
213
+ const sources = {
214
+ "scripts/nested/dynamic.mjs": "await import('cross-spawn');\n",
215
+ "scripts/nested/export.mjs":
216
+ 'export { default } from "cross-spawn/lib/parse.js";\n',
217
+ "scripts/nested/require.cjs":
218
+ 'require("cross-spawn/lib/util/escape.js");\n',
219
+ "scripts/nested/static.mjs": "import spawn from 'cross-spawn';\n",
220
+ };
221
+ for (const [repoPath, source] of Object.entries(sources)) {
222
+ const absolutePath = path.join(rootDir, repoPath);
223
+ await fs.mkdir(path.dirname(absolutePath), { recursive: true });
224
+ await fs.writeFile(absolutePath, source);
225
+ }
226
+
227
+ assert.deepEqual(
228
+ (await collectCrossSpawnImportFacts(rootDir)).map(
229
+ ({ category, importerRepoPath, specifier }) => ({
230
+ category,
231
+ importerRepoPath,
232
+ specifier,
233
+ }),
234
+ ),
235
+ [
236
+ {
237
+ category: "dynamic-import",
238
+ importerRepoPath: "scripts/nested/dynamic.mjs",
239
+ specifier: "cross-spawn",
240
+ },
241
+ {
242
+ category: "static-export",
243
+ importerRepoPath: "scripts/nested/export.mjs",
244
+ specifier: "cross-spawn/lib/parse.js",
245
+ },
246
+ {
247
+ category: "require",
248
+ importerRepoPath: "scripts/nested/require.cjs",
249
+ specifier: "cross-spawn/lib/util/escape.js",
250
+ },
251
+ {
252
+ category: "static-import",
253
+ importerRepoPath: "scripts/nested/static.mjs",
254
+ specifier: "cross-spawn",
255
+ },
256
+ ],
257
+ );
258
+ });
259
+
260
+ test("current performance evidence remains a dedicated receipt boundary", () => {
261
+ assert.deepEqual(
262
+ Object.keys(performanceReceiptPolicy).sort(),
263
+ expectedPerformanceReceiptPolicyExports,
264
+ );
265
+ });
266
+
267
+ test("receipt validators remain fail-closed without protected authority", async (t) => {
268
+ assert.match(getToolcraftDeliveryReceiptShapeError({}), /malformed/iu);
269
+ assert.match(getToolcraftPerformanceReceiptShapeError({}), /malformed/iu);
270
+
271
+ const rootDir = await createReceiptFixture();
272
+ t.after(() => fs.rm(rootDir, { force: true, recursive: true }));
273
+ assert.match(
274
+ (await validateToolcraftDeliveryReceipt({ rootDir }))[0],
275
+ /delivery receipt is missing/iu,
276
+ );
277
+ assert.match(
278
+ (await validateToolcraftPerformanceReceipt({ rootDir }))[0],
279
+ /performance receipt is missing/iu,
280
+ );
281
+ assert.match(
282
+ (await validateToolcraftVerificationReceipt({ rootDir }))[0],
283
+ /delivery receipt is missing/iu,
284
+ );
285
+ });
@@ -0,0 +1,16 @@
1
+ import fs from "node:fs/promises";
2
+
3
+ export async function readToolcraftReceiptFile(receiptPath) {
4
+ let source;
5
+ try {
6
+ source = await fs.readFile(receiptPath, "utf8");
7
+ } catch (error) {
8
+ if (error?.code === "ENOENT") return { missing: true };
9
+ throw error;
10
+ }
11
+ try {
12
+ return { receipt: JSON.parse(source) };
13
+ } catch {
14
+ return { malformed: true };
15
+ }
16
+ }
@@ -83,6 +83,7 @@ export function collectToolcraftSourceInventorySync({
83
83
  frameworkPathPrefixes = ["src/toolcraft/"],
84
84
  generatedFilePatterns = defaultGeneratedFilePatterns,
85
85
  ignoredFilePatterns = [],
86
+ includeResourceFiles = false,
86
87
  protectedFilePaths = [],
87
88
  rootDir,
88
89
  sourceExtensions = toolcraftSourceExtensions,
@@ -131,7 +132,11 @@ export function collectToolcraftSourceInventorySync({
131
132
  continue;
132
133
  }
133
134
 
134
- if (!entry.isFile() || !sourceExtensions.has(path.extname(entry.name))) {
135
+ if (
136
+ !entry.isFile() ||
137
+ (!includeResourceFiles &&
138
+ !sourceExtensions.has(path.extname(entry.name)))
139
+ ) {
135
140
  continue;
136
141
  }
137
142
 
@@ -185,3 +190,97 @@ export function collectToolcraftSourceInventorySync({
185
190
  export async function collectToolcraftSourceInventory(options) {
186
191
  return collectToolcraftSourceInventorySync(options);
187
192
  }
193
+
194
+ function createResourceRootEscapeError(resourcePath, rootDir, reason) {
195
+ const error = new Error(
196
+ `Explicit resource path "${resourcePath}" ${reason} "${rootDir}".`,
197
+ );
198
+ error.code = "TOOLCRAFT_RESOURCE_ROOT_ESCAPE";
199
+ return error;
200
+ }
201
+
202
+ function pathEscapesRoot(rootPath, targetPath) {
203
+ const relativePath = path.relative(rootPath, targetPath);
204
+ return (
205
+ relativePath === ".." ||
206
+ relativePath.startsWith(`..${path.sep}`) ||
207
+ path.isAbsolute(relativePath)
208
+ );
209
+ }
210
+
211
+ function resolveExplicitResourcePath(resourcePath, rootDir) {
212
+ if (
213
+ typeof resourcePath !== "string" ||
214
+ path.isAbsolute(resourcePath) ||
215
+ path.posix.isAbsolute(resourcePath) ||
216
+ path.win32.isAbsolute(resourcePath)
217
+ ) {
218
+ throw createResourceRootEscapeError(
219
+ resourcePath,
220
+ rootDir,
221
+ "must be root-relative and stay within the configured root boundary",
222
+ );
223
+ }
224
+ const normalizedPath = path.posix.normalize(resourcePath.replaceAll("\\", "/"));
225
+ const absolutePath = path.resolve(rootDir, ...normalizedPath.split("/"));
226
+ if (
227
+ normalizedPath === ".." ||
228
+ normalizedPath.startsWith("../") ||
229
+ pathEscapesRoot(path.resolve(rootDir), absolutePath)
230
+ ) {
231
+ throw createResourceRootEscapeError(
232
+ resourcePath,
233
+ rootDir,
234
+ "is outside the configured root boundary",
235
+ );
236
+ }
237
+ return absolutePath;
238
+ }
239
+
240
+ export function createCanonicalGraphEntries({
241
+ entries,
242
+ explicitResourcePaths = [],
243
+ rootDir,
244
+ }) {
245
+ const entriesByRepoPath = new Map(
246
+ entries.map((entry) => [
247
+ toPosixPath(entry.repoPath).replace(/^\.\//u, ""),
248
+ entry,
249
+ ]),
250
+ );
251
+ const rootRealPath =
252
+ explicitResourcePaths.length > 0 ? fs.realpathSync(rootDir) : undefined;
253
+
254
+ for (const resourcePath of explicitResourcePaths) {
255
+ const absolutePath = resolveExplicitResourcePath(resourcePath, rootDir);
256
+ const repoPath = toPosixPath(path.relative(rootDir, absolutePath));
257
+ if (entriesByRepoPath.has(repoPath)) continue;
258
+
259
+ let resourceStat;
260
+ try {
261
+ resourceStat = fs.lstatSync(absolutePath);
262
+ } catch (error) {
263
+ if (error?.code === "ENOENT") continue;
264
+ throw error;
265
+ }
266
+ if (!resourceStat.isFile() || resourceStat.isSymbolicLink()) continue;
267
+ const resourceRealPath = fs.realpathSync(absolutePath);
268
+ if (pathEscapesRoot(rootRealPath, resourceRealPath)) {
269
+ throw createResourceRootEscapeError(
270
+ resourcePath,
271
+ rootDir,
272
+ "resolves outside the root boundary for configured root",
273
+ );
274
+ }
275
+
276
+ entriesByRepoPath.set(repoPath, {
277
+ absolutePath,
278
+ repoPath,
279
+ ...classifyToolcraftSourcePath(repoPath),
280
+ });
281
+ }
282
+
283
+ return [...entriesByRepoPath.values()].sort((left, right) =>
284
+ compareCodeUnits(left.repoPath, right.repoPath),
285
+ );
286
+ }
@@ -8,6 +8,7 @@ import {
8
8
  classifyToolcraftSourcePath,
9
9
  collectToolcraftSourceInventory,
10
10
  collectToolcraftSourceInventorySync,
11
+ createCanonicalGraphEntries,
11
12
  } from "./toolcraft-source-inventory.mjs";
12
13
 
13
14
  test("classifies platform, framework, product, test, and generated source", () => {
@@ -130,3 +131,108 @@ test("rejects a symbolic link used as a configured source root", async (context)
130
131
  },
131
132
  ]);
132
133
  });
134
+
135
+ test("rejects a parent-relative explicit resource outside the root", async (context) => {
136
+ const fixtureDir = await fs.mkdtemp(
137
+ path.join(os.tmpdir(), "toolcraft-explicit-resource-relative-"),
138
+ );
139
+ context.after(() => fs.rm(fixtureDir, { force: true, recursive: true }));
140
+ const rootDir = path.join(fixtureDir, "app");
141
+ await fs.mkdir(rootDir);
142
+ await fs.writeFile(path.join(fixtureDir, "outside.ts"), "outside\n");
143
+
144
+ assert.throws(
145
+ () =>
146
+ createCanonicalGraphEntries({
147
+ entries: [],
148
+ explicitResourcePaths: ["../outside.ts"],
149
+ rootDir,
150
+ }),
151
+ (error) => {
152
+ assert.equal(error.code, "TOOLCRAFT_RESOURCE_ROOT_ESCAPE");
153
+ assert.match(error.message, /\.\.\/outside\.ts/u);
154
+ assert.match(error.message, /outside the configured root boundary/u);
155
+ return true;
156
+ },
157
+ );
158
+ });
159
+
160
+ test("rejects an absolute explicit resource path", async (context) => {
161
+ const fixtureDir = await fs.mkdtemp(
162
+ path.join(os.tmpdir(), "toolcraft-explicit-resource-absolute-"),
163
+ );
164
+ context.after(() => fs.rm(fixtureDir, { force: true, recursive: true }));
165
+ const rootDir = path.join(fixtureDir, "app");
166
+ const resourcePath = path.join(fixtureDir, "outside.ts");
167
+ await fs.mkdir(rootDir);
168
+ await fs.writeFile(resourcePath, "outside\n");
169
+
170
+ assert.throws(
171
+ () =>
172
+ createCanonicalGraphEntries({
173
+ entries: [],
174
+ explicitResourcePaths: [resourcePath],
175
+ rootDir,
176
+ }),
177
+ (error) => {
178
+ assert.equal(error.code, "TOOLCRAFT_RESOURCE_ROOT_ESCAPE");
179
+ assert.equal(error.message.includes(resourcePath), true);
180
+ assert.match(error.message, /must be root-relative/u);
181
+ return true;
182
+ },
183
+ );
184
+ });
185
+
186
+ test("rejects an explicit resource through a symlinked parent", async (context) => {
187
+ const fixtureDir = await fs.mkdtemp(
188
+ path.join(os.tmpdir(), "toolcraft-explicit-resource-symlink-"),
189
+ );
190
+ context.after(() => fs.rm(fixtureDir, { force: true, recursive: true }));
191
+ const rootDir = path.join(fixtureDir, "app");
192
+ const outsideDir = path.join(fixtureDir, "outside");
193
+ await fs.mkdir(rootDir);
194
+ await fs.mkdir(outsideDir);
195
+ await fs.writeFile(path.join(outsideDir, "resource.ts"), "outside\n");
196
+ try {
197
+ await fs.symlink(outsideDir, path.join(rootDir, "linked-parent"));
198
+ } catch (error) {
199
+ if (["EACCES", "ENOSYS", "EPERM"].includes(error?.code)) {
200
+ context.skip(`symbolic links are unavailable: ${error.code}`);
201
+ return;
202
+ }
203
+ throw error;
204
+ }
205
+
206
+ assert.throws(
207
+ () =>
208
+ createCanonicalGraphEntries({
209
+ entries: [],
210
+ explicitResourcePaths: ["linked-parent/resource.ts"],
211
+ rootDir,
212
+ }),
213
+ (error) => {
214
+ assert.equal(error.code, "TOOLCRAFT_RESOURCE_ROOT_ESCAPE");
215
+ assert.match(error.message, /linked-parent\/resource\.ts/u);
216
+ assert.match(error.message, /resolves outside the root boundary/u);
217
+ return true;
218
+ },
219
+ );
220
+ });
221
+
222
+ test("accepts an in-root explicit public resource", async (context) => {
223
+ const rootDir = await fs.mkdtemp(
224
+ path.join(os.tmpdir(), "toolcraft-explicit-resource-valid-"),
225
+ );
226
+ context.after(() => fs.rm(rootDir, { force: true, recursive: true }));
227
+ await fs.mkdir(path.join(rootDir, "public"));
228
+ await fs.writeFile(path.join(rootDir, "public/preset.bin"), "preset\n");
229
+
230
+ assert.deepEqual(
231
+ createCanonicalGraphEntries({
232
+ entries: [],
233
+ explicitResourcePaths: ["public/preset.bin"],
234
+ rootDir,
235
+ }).map(({ repoPath }) => repoPath),
236
+ ["public/preset.bin"],
237
+ );
238
+ });
@@ -2,6 +2,10 @@ import fs from "node:fs/promises";
2
2
  import path from "node:path";
3
3
  import { fileURLToPath } from "node:url";
4
4
 
5
+ import {
6
+ hasValidToolcraftIntegrityManifestSignature,
7
+ } from "./toolcraft-integrity-manifest.mjs";
8
+
5
9
  export const toolcraftFrameworkOwnedSourceRoots = Object.freeze([
6
10
  "docs/toolcraft",
7
11
  "scripts",
@@ -26,10 +30,14 @@ export const toolcraftFrameworkOwnedRootFiles = Object.freeze([
26
30
 
27
31
  export const toolcraftProductOwnedGeneratedPaths = Object.freeze([
28
32
  "docs/toolcraft/agent-worklog.md",
33
+ "docs/toolcraft/workflow-observation.md",
34
+ "e2e/app-kernel-benchmarks.ts",
29
35
  "e2e/app-controls.spec.ts",
36
+ "e2e/app-performance-path-adapters.ts",
30
37
  "src/app/app-acceptance-data.ts",
31
38
  "src/app/app-composition.tsx",
32
39
  "src/app/app-performance.ts",
40
+ "src/app/app-verification-impact.json",
33
41
  "src/app/app-schema.test.ts",
34
42
  "src/app/app-schema.ts",
35
43
  ]);
@@ -130,8 +138,15 @@ export async function collectToolcraftFrameworkOwnedLocalPaths(rootDir) {
130
138
 
131
139
  try {
132
140
  const manifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
141
+ if (
142
+ manifest.version !== 3 ||
143
+ !hasValidToolcraftIntegrityManifestSignature(manifest)
144
+ ) {
145
+ return [];
146
+ }
133
147
  return Object.keys(manifest.protectedFiles ?? {}).sort(compareCodeUnits);
134
148
  } catch (error) {
149
+ if (error instanceof SyntaxError) return [];
135
150
  if (error?.code !== "ENOENT") throw error;
136
151
  }
137
152
 
@@ -80,7 +80,7 @@ test("keeps the signed-manifest trust root small and inside canonical ownership"
80
80
 
81
81
  assert.ok(requiredProtectedTrustRootFilePaths.length > 0);
82
82
  assert.ok(
83
- requiredProtectedTrustRootFilePaths.length <= 24,
83
+ requiredProtectedTrustRootFilePaths.length <= 28,
84
84
  `The trust root must stay small; received ${requiredProtectedTrustRootFilePaths.length} paths.`,
85
85
  );
86
86
  assert.equal(
@@ -96,8 +96,13 @@ test("keeps the signed-manifest trust root small and inside canonical ownership"
96
96
 
97
97
  const subsystemSentinels = [
98
98
  "AGENTS.md",
99
+ "e2e/app-performance.spec.ts",
100
+ "e2e/browser-performance-report.ts",
99
101
  "e2e/browser-runtime-evidence-reporter.ts",
102
+ "e2e/performance-pipeline-evidence.ts",
103
+ "e2e/toolcraft-product-test.ts",
100
104
  "scripts/check-toolcraft-integrity.mjs",
105
+ "scripts/run-delivery-verification.mjs",
101
106
  "scripts/toolcraft-integrity-policy.mjs",
102
107
  "scripts/toolcraft-source-ownership.mjs",
103
108
  "scripts/toolcraft-vitest-runtime-evidence-reporter.mjs",
@@ -110,4 +115,29 @@ test("keeps the signed-manifest trust root small and inside canonical ownership"
110
115
  `Trust root must retain the ${relativePath} sentinel.`,
111
116
  );
112
117
  }
118
+
119
+ // The required root names subsystem authorities. Their transitive modules stay
120
+ // protected by the complete signed framework inventory without becoming sentinels.
121
+ for (const relativePath of [
122
+ "e2e/browser-performance-evidence.ts",
123
+ "e2e/browser-model-import-evidence-helpers.ts",
124
+ "e2e/browser-orientation-gizmo-evidence-helpers.ts",
125
+ "e2e/browser-performance-measurement-evidence.ts",
126
+ "e2e/browser-performance-measurement-report.ts",
127
+ "e2e/performance-checkpoint-report.ts",
128
+ "e2e/performance-environment-evidence.ts",
129
+ "e2e/performance-helpers.ts",
130
+ "e2e/performance-measurement-evidence.ts",
131
+ "e2e/performance-path-adapter-contract.ts",
132
+ "e2e/performance-path-helpers.ts",
133
+ "e2e/performance-pipeline-invariants.ts",
134
+ "src/app/test-evidence/browser-performance-contract.ts",
135
+ "src/app/test-evidence/browser-performance-measurement-contract.ts",
136
+ "scripts/toolcraft-performance-report.mjs",
137
+ ]) {
138
+ assert.ok(
139
+ generatedPathSet.has(relativePath),
140
+ `Rich performance dependency must remain in the signed inventory: ${relativePath}`,
141
+ );
142
+ }
113
143
  });