@ztothez/design-engineering 2.0.0

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 (513) hide show
  1. package/LICENSE +15 -0
  2. package/README.md +448 -0
  3. package/ROADMAP.md +127 -0
  4. package/SKILL.md +698 -0
  5. package/V2-ROADMAP.md +431 -0
  6. package/V3-ROADMAP.md +605 -0
  7. package/V4-ROADMAP.md +283 -0
  8. package/clean-room-ux-design-spec.md +1431 -0
  9. package/dist/cli/aggregate-gates.d.ts +2 -0
  10. package/dist/cli/aggregate-gates.js +86 -0
  11. package/dist/cli/aggregate-gates.js.map +1 -0
  12. package/dist/cli/assess-maintainer-review.d.ts +2 -0
  13. package/dist/cli/assess-maintainer-review.js +72 -0
  14. package/dist/cli/assess-maintainer-review.js.map +1 -0
  15. package/dist/cli/audit.d.ts +2 -0
  16. package/dist/cli/audit.js +71 -0
  17. package/dist/cli/audit.js.map +1 -0
  18. package/dist/cli/compile-comparison-review.d.ts +2 -0
  19. package/dist/cli/compile-comparison-review.js +154 -0
  20. package/dist/cli/compile-comparison-review.js.map +1 -0
  21. package/dist/cli/compile-plan.d.ts +2 -0
  22. package/dist/cli/compile-plan.js +66 -0
  23. package/dist/cli/compile-plan.js.map +1 -0
  24. package/dist/cli/evaluate-corpus.d.ts +2 -0
  25. package/dist/cli/evaluate-corpus.js +65 -0
  26. package/dist/cli/evaluate-corpus.js.map +1 -0
  27. package/dist/cli/generate-react.d.ts +2 -0
  28. package/dist/cli/generate-react.js +83 -0
  29. package/dist/cli/generate-react.js.map +1 -0
  30. package/dist/cli/index.d.ts +2 -0
  31. package/dist/cli/index.js +58 -0
  32. package/dist/cli/index.js.map +1 -0
  33. package/dist/cli/portfolio.d.ts +2 -0
  34. package/dist/cli/portfolio.js +316 -0
  35. package/dist/cli/portfolio.js.map +1 -0
  36. package/dist/cli/quality-gate.d.ts +2 -0
  37. package/dist/cli/quality-gate.js +131 -0
  38. package/dist/cli/quality-gate.js.map +1 -0
  39. package/dist/cli/repair-react.d.ts +2 -0
  40. package/dist/cli/repair-react.js +163 -0
  41. package/dist/cli/repair-react.js.map +1 -0
  42. package/dist/cli/review-heuristics.d.ts +2 -0
  43. package/dist/cli/review-heuristics.js +68 -0
  44. package/dist/cli/review-heuristics.js.map +1 -0
  45. package/dist/cli/validate-brief.d.ts +2 -0
  46. package/dist/cli/validate-brief.js +58 -0
  47. package/dist/cli/validate-brief.js.map +1 -0
  48. package/dist/cli/validate-comparison.d.ts +2 -0
  49. package/dist/cli/validate-comparison.js +68 -0
  50. package/dist/cli/validate-comparison.js.map +1 -0
  51. package/dist/cli/validate-contract.d.ts +2 -0
  52. package/dist/cli/validate-contract.js +54 -0
  53. package/dist/cli/validate-contract.js.map +1 -0
  54. package/dist/cli/validate-design.d.ts +2 -0
  55. package/dist/cli/validate-design.js +53 -0
  56. package/dist/cli/validate-design.js.map +1 -0
  57. package/dist/cli/validate-information.d.ts +2 -0
  58. package/dist/cli/validate-information.js +53 -0
  59. package/dist/cli/validate-information.js.map +1 -0
  60. package/dist/cli/validate-trust.d.ts +2 -0
  61. package/dist/cli/validate-trust.js +53 -0
  62. package/dist/cli/validate-trust.js.map +1 -0
  63. package/dist/cli/verify-ui.d.ts +2 -0
  64. package/dist/cli/verify-ui.js +181 -0
  65. package/dist/cli/verify-ui.js.map +1 -0
  66. package/dist/src/acceptance/evaluator.d.ts +13 -0
  67. package/dist/src/acceptance/evaluator.js +201 -0
  68. package/dist/src/acceptance/evaluator.js.map +1 -0
  69. package/dist/src/acceptance/loader.d.ts +2 -0
  70. package/dist/src/acceptance/loader.js +18 -0
  71. package/dist/src/acceptance/loader.js.map +1 -0
  72. package/dist/src/acceptance/report.d.ts +2 -0
  73. package/dist/src/acceptance/report.js +18 -0
  74. package/dist/src/acceptance/report.js.map +1 -0
  75. package/dist/src/acceptance/schema.d.ts +64 -0
  76. package/dist/src/acceptance/schema.js +57 -0
  77. package/dist/src/acceptance/schema.js.map +1 -0
  78. package/dist/src/acceptance/types.d.ts +47 -0
  79. package/dist/src/acceptance/types.js +2 -0
  80. package/dist/src/acceptance/types.js.map +1 -0
  81. package/dist/src/aggregate/report.d.ts +2 -0
  82. package/dist/src/aggregate/report.js +33 -0
  83. package/dist/src/aggregate/report.js.map +1 -0
  84. package/dist/src/aggregate/runner.d.ts +2 -0
  85. package/dist/src/aggregate/runner.js +165 -0
  86. package/dist/src/aggregate/runner.js.map +1 -0
  87. package/dist/src/aggregate/schema.d.ts +182 -0
  88. package/dist/src/aggregate/schema.js +54 -0
  89. package/dist/src/aggregate/schema.js.map +1 -0
  90. package/dist/src/aggregate/types.d.ts +57 -0
  91. package/dist/src/aggregate/types.js +2 -0
  92. package/dist/src/aggregate/types.js.map +1 -0
  93. package/dist/src/audit/policy.d.ts +3 -0
  94. package/dist/src/audit/policy.js +45 -0
  95. package/dist/src/audit/policy.js.map +1 -0
  96. package/dist/src/audit/report.d.ts +2 -0
  97. package/dist/src/audit/report.js +32 -0
  98. package/dist/src/audit/report.js.map +1 -0
  99. package/dist/src/audit/rules/accessibility-name.d.ts +2 -0
  100. package/dist/src/audit/rules/accessibility-name.js +64 -0
  101. package/dist/src/audit/rules/accessibility-name.js.map +1 -0
  102. package/dist/src/audit/rules/component-size.d.ts +2 -0
  103. package/dist/src/audit/rules/component-size.js +27 -0
  104. package/dist/src/audit/rules/component-size.js.map +1 -0
  105. package/dist/src/audit/rules/credential-placeholder.d.ts +2 -0
  106. package/dist/src/audit/rules/credential-placeholder.js +83 -0
  107. package/dist/src/audit/rules/credential-placeholder.js.map +1 -0
  108. package/dist/src/audit/rules/helpers.d.ts +16 -0
  109. package/dist/src/audit/rules/helpers.js +64 -0
  110. package/dist/src/audit/rules/helpers.js.map +1 -0
  111. package/dist/src/audit/rules/index.d.ts +2 -0
  112. package/dist/src/audit/rules/index.js +23 -0
  113. package/dist/src/audit/rules/index.js.map +1 -0
  114. package/dist/src/audit/rules/interactive-integrity.d.ts +2 -0
  115. package/dist/src/audit/rules/interactive-integrity.js +111 -0
  116. package/dist/src/audit/rules/interactive-integrity.js.map +1 -0
  117. package/dist/src/audit/rules/mixed-responsibilities.d.ts +2 -0
  118. package/dist/src/audit/rules/mixed-responsibilities.js +39 -0
  119. package/dist/src/audit/rules/mixed-responsibilities.js.map +1 -0
  120. package/dist/src/audit/rules/mock-production-path.d.ts +2 -0
  121. package/dist/src/audit/rules/mock-production-path.js +39 -0
  122. package/dist/src/audit/rules/mock-production-path.js.map +1 -0
  123. package/dist/src/audit/rules/network-state.d.ts +2 -0
  124. package/dist/src/audit/rules/network-state.js +39 -0
  125. package/dist/src/audit/rules/network-state.js.map +1 -0
  126. package/dist/src/audit/rules/operational-claim.d.ts +2 -0
  127. package/dist/src/audit/rules/operational-claim.js +94 -0
  128. package/dist/src/audit/rules/operational-claim.js.map +1 -0
  129. package/dist/src/audit/rules/placeholder-interaction.d.ts +2 -0
  130. package/dist/src/audit/rules/placeholder-interaction.js +46 -0
  131. package/dist/src/audit/rules/placeholder-interaction.js.map +1 -0
  132. package/dist/src/audit/rules/raw-design-values.d.ts +2 -0
  133. package/dist/src/audit/rules/raw-design-values.js +97 -0
  134. package/dist/src/audit/rules/raw-design-values.js.map +1 -0
  135. package/dist/src/audit/scanner.d.ts +2 -0
  136. package/dist/src/audit/scanner.js +215 -0
  137. package/dist/src/audit/scanner.js.map +1 -0
  138. package/dist/src/audit/types.d.ts +62 -0
  139. package/dist/src/audit/types.js +2 -0
  140. package/dist/src/audit/types.js.map +1 -0
  141. package/dist/src/comparison/evaluator.d.ts +2 -0
  142. package/dist/src/comparison/evaluator.js +478 -0
  143. package/dist/src/comparison/evaluator.js.map +1 -0
  144. package/dist/src/comparison/loader.d.ts +3 -0
  145. package/dist/src/comparison/loader.js +26 -0
  146. package/dist/src/comparison/loader.js.map +1 -0
  147. package/dist/src/comparison/maintainer.d.ts +47 -0
  148. package/dist/src/comparison/maintainer.js +218 -0
  149. package/dist/src/comparison/maintainer.js.map +1 -0
  150. package/dist/src/comparison/report.d.ts +2 -0
  151. package/dist/src/comparison/report.js +48 -0
  152. package/dist/src/comparison/report.js.map +1 -0
  153. package/dist/src/comparison/schema.d.ts +464 -0
  154. package/dist/src/comparison/schema.js +502 -0
  155. package/dist/src/comparison/schema.js.map +1 -0
  156. package/dist/src/contracts/archetypes.d.ts +21 -0
  157. package/dist/src/contracts/archetypes.js +102 -0
  158. package/dist/src/contracts/archetypes.js.map +1 -0
  159. package/dist/src/contracts/journeys.d.ts +7 -0
  160. package/dist/src/contracts/journeys.js +32 -0
  161. package/dist/src/contracts/journeys.js.map +1 -0
  162. package/dist/src/contracts/report.d.ts +2 -0
  163. package/dist/src/contracts/report.js +33 -0
  164. package/dist/src/contracts/report.js.map +1 -0
  165. package/dist/src/contracts/schema.d.ts +1038 -0
  166. package/dist/src/contracts/schema.js +385 -0
  167. package/dist/src/contracts/schema.js.map +1 -0
  168. package/dist/src/contracts/validator.d.ts +12 -0
  169. package/dist/src/contracts/validator.js +303 -0
  170. package/dist/src/contracts/validator.js.map +1 -0
  171. package/dist/src/corpus/evaluator.d.ts +2 -0
  172. package/dist/src/corpus/evaluator.js +203 -0
  173. package/dist/src/corpus/evaluator.js.map +1 -0
  174. package/dist/src/corpus/loader.d.ts +2 -0
  175. package/dist/src/corpus/loader.js +20 -0
  176. package/dist/src/corpus/loader.js.map +1 -0
  177. package/dist/src/corpus/report.d.ts +2 -0
  178. package/dist/src/corpus/report.js +33 -0
  179. package/dist/src/corpus/report.js.map +1 -0
  180. package/dist/src/corpus/schema.d.ts +316 -0
  181. package/dist/src/corpus/schema.js +269 -0
  182. package/dist/src/corpus/schema.js.map +1 -0
  183. package/dist/src/design-intelligence/loader.d.ts +2 -0
  184. package/dist/src/design-intelligence/loader.js +21 -0
  185. package/dist/src/design-intelligence/loader.js.map +1 -0
  186. package/dist/src/design-intelligence/report.d.ts +2 -0
  187. package/dist/src/design-intelligence/report.js +36 -0
  188. package/dist/src/design-intelligence/report.js.map +1 -0
  189. package/dist/src/design-intelligence/schema.d.ts +838 -0
  190. package/dist/src/design-intelligence/schema.js +854 -0
  191. package/dist/src/design-intelligence/schema.js.map +1 -0
  192. package/dist/src/design-intelligence/validator.d.ts +2 -0
  193. package/dist/src/design-intelligence/validator.js +1371 -0
  194. package/dist/src/design-intelligence/validator.js.map +1 -0
  195. package/dist/src/design-plan/compiler.d.ts +8 -0
  196. package/dist/src/design-plan/compiler.js +288 -0
  197. package/dist/src/design-plan/compiler.js.map +1 -0
  198. package/dist/src/design-plan/report.d.ts +2 -0
  199. package/dist/src/design-plan/report.js +28 -0
  200. package/dist/src/design-plan/report.js.map +1 -0
  201. package/dist/src/design-plan/schema.d.ts +202 -0
  202. package/dist/src/design-plan/schema.js +76 -0
  203. package/dist/src/design-plan/schema.js.map +1 -0
  204. package/dist/src/generation/loader.d.ts +2 -0
  205. package/dist/src/generation/loader.js +21 -0
  206. package/dist/src/generation/loader.js.map +1 -0
  207. package/dist/src/generation/policy.d.ts +12 -0
  208. package/dist/src/generation/policy.js +62 -0
  209. package/dist/src/generation/policy.js.map +1 -0
  210. package/dist/src/generation/react-typescript.d.ts +6 -0
  211. package/dist/src/generation/react-typescript.js +538 -0
  212. package/dist/src/generation/react-typescript.js.map +1 -0
  213. package/dist/src/generation/report.d.ts +2 -0
  214. package/dist/src/generation/report.js +21 -0
  215. package/dist/src/generation/report.js.map +1 -0
  216. package/dist/src/generation/schema.d.ts +44 -0
  217. package/dist/src/generation/schema.js +50 -0
  218. package/dist/src/generation/schema.js.map +1 -0
  219. package/dist/src/generation/templates/tokens.d.ts +1 -0
  220. package/dist/src/generation/templates/tokens.js +59 -0
  221. package/dist/src/generation/templates/tokens.js.map +1 -0
  222. package/dist/src/heuristics/evaluator.d.ts +2 -0
  223. package/dist/src/heuristics/evaluator.js +65 -0
  224. package/dist/src/heuristics/evaluator.js.map +1 -0
  225. package/dist/src/heuristics/loader.d.ts +2 -0
  226. package/dist/src/heuristics/loader.js +21 -0
  227. package/dist/src/heuristics/loader.js.map +1 -0
  228. package/dist/src/heuristics/report.d.ts +3 -0
  229. package/dist/src/heuristics/report.js +31 -0
  230. package/dist/src/heuristics/report.js.map +1 -0
  231. package/dist/src/heuristics/schema.d.ts +198 -0
  232. package/dist/src/heuristics/schema.js +197 -0
  233. package/dist/src/heuristics/schema.js.map +1 -0
  234. package/dist/src/information-design/loader.d.ts +2 -0
  235. package/dist/src/information-design/loader.js +21 -0
  236. package/dist/src/information-design/loader.js.map +1 -0
  237. package/dist/src/information-design/report.d.ts +2 -0
  238. package/dist/src/information-design/report.js +27 -0
  239. package/dist/src/information-design/report.js.map +1 -0
  240. package/dist/src/information-design/schema.d.ts +370 -0
  241. package/dist/src/information-design/schema.js +329 -0
  242. package/dist/src/information-design/schema.js.map +1 -0
  243. package/dist/src/information-design/validator.d.ts +2 -0
  244. package/dist/src/information-design/validator.js +242 -0
  245. package/dist/src/information-design/validator.js.map +1 -0
  246. package/dist/src/interface-trust/loader.d.ts +2 -0
  247. package/dist/src/interface-trust/loader.js +21 -0
  248. package/dist/src/interface-trust/loader.js.map +1 -0
  249. package/dist/src/interface-trust/report.d.ts +2 -0
  250. package/dist/src/interface-trust/report.js +26 -0
  251. package/dist/src/interface-trust/report.js.map +1 -0
  252. package/dist/src/interface-trust/schema.d.ts +299 -0
  253. package/dist/src/interface-trust/schema.js +238 -0
  254. package/dist/src/interface-trust/schema.js.map +1 -0
  255. package/dist/src/interface-trust/validator.d.ts +2 -0
  256. package/dist/src/interface-trust/validator.js +283 -0
  257. package/dist/src/interface-trust/validator.js.map +1 -0
  258. package/dist/src/portfolio/adapter-report.d.ts +3 -0
  259. package/dist/src/portfolio/adapter-report.js +38 -0
  260. package/dist/src/portfolio/adapter-report.js.map +1 -0
  261. package/dist/src/portfolio/adapters.d.ts +37 -0
  262. package/dist/src/portfolio/adapters.js +325 -0
  263. package/dist/src/portfolio/adapters.js.map +1 -0
  264. package/dist/src/portfolio/evidence.d.ts +9 -0
  265. package/dist/src/portfolio/evidence.js +233 -0
  266. package/dist/src/portfolio/evidence.js.map +1 -0
  267. package/dist/src/portfolio/files.d.ts +8 -0
  268. package/dist/src/portfolio/files.js +77 -0
  269. package/dist/src/portfolio/files.js.map +1 -0
  270. package/dist/src/portfolio/fixture-server.d.ts +11 -0
  271. package/dist/src/portfolio/fixture-server.js +131 -0
  272. package/dist/src/portfolio/fixture-server.js.map +1 -0
  273. package/dist/src/portfolio/loader.d.ts +2 -0
  274. package/dist/src/portfolio/loader.js +21 -0
  275. package/dist/src/portfolio/loader.js.map +1 -0
  276. package/dist/src/portfolio/mcp.d.ts +186 -0
  277. package/dist/src/portfolio/mcp.js +117 -0
  278. package/dist/src/portfolio/mcp.js.map +1 -0
  279. package/dist/src/portfolio/promotion-schema.d.ts +220 -0
  280. package/dist/src/portfolio/promotion-schema.js +148 -0
  281. package/dist/src/portfolio/promotion-schema.js.map +1 -0
  282. package/dist/src/portfolio/promotion.d.ts +4 -0
  283. package/dist/src/portfolio/promotion.js +160 -0
  284. package/dist/src/portfolio/promotion.js.map +1 -0
  285. package/dist/src/portfolio/qualification-schema.d.ts +268 -0
  286. package/dist/src/portfolio/qualification-schema.js +112 -0
  287. package/dist/src/portfolio/qualification-schema.js.map +1 -0
  288. package/dist/src/portfolio/qualification.d.ts +4 -0
  289. package/dist/src/portfolio/qualification.js +157 -0
  290. package/dist/src/portfolio/qualification.js.map +1 -0
  291. package/dist/src/portfolio/registry.d.ts +34 -0
  292. package/dist/src/portfolio/registry.js +240 -0
  293. package/dist/src/portfolio/registry.js.map +1 -0
  294. package/dist/src/portfolio/report.d.ts +4 -0
  295. package/dist/src/portfolio/report.js +47 -0
  296. package/dist/src/portfolio/report.js.map +1 -0
  297. package/dist/src/portfolio/run-schema.d.ts +135 -0
  298. package/dist/src/portfolio/run-schema.js +81 -0
  299. package/dist/src/portfolio/run-schema.js.map +1 -0
  300. package/dist/src/portfolio/runner.d.ts +118 -0
  301. package/dist/src/portfolio/runner.js +423 -0
  302. package/dist/src/portfolio/runner.js.map +1 -0
  303. package/dist/src/portfolio/schema.d.ts +251 -0
  304. package/dist/src/portfolio/schema.js +317 -0
  305. package/dist/src/portfolio/schema.js.map +1 -0
  306. package/dist/src/portfolio/snapshot.d.ts +89 -0
  307. package/dist/src/portfolio/snapshot.js +548 -0
  308. package/dist/src/portfolio/snapshot.js.map +1 -0
  309. package/dist/src/portfolio/taxonomy-schema.d.ts +215 -0
  310. package/dist/src/portfolio/taxonomy-schema.js +74 -0
  311. package/dist/src/portfolio/taxonomy-schema.js.map +1 -0
  312. package/dist/src/portfolio/taxonomy.d.ts +5 -0
  313. package/dist/src/portfolio/taxonomy.js +236 -0
  314. package/dist/src/portfolio/taxonomy.js.map +1 -0
  315. package/dist/src/portfolio/vault.d.ts +53 -0
  316. package/dist/src/portfolio/vault.js +176 -0
  317. package/dist/src/portfolio/vault.js.map +1 -0
  318. package/dist/src/product-brief/loader.d.ts +2 -0
  319. package/dist/src/product-brief/loader.js +21 -0
  320. package/dist/src/product-brief/loader.js.map +1 -0
  321. package/dist/src/product-brief/report.d.ts +2 -0
  322. package/dist/src/product-brief/report.js +22 -0
  323. package/dist/src/product-brief/report.js.map +1 -0
  324. package/dist/src/product-brief/schema.d.ts +367 -0
  325. package/dist/src/product-brief/schema.js +272 -0
  326. package/dist/src/product-brief/schema.js.map +1 -0
  327. package/dist/src/product-brief/validator.d.ts +2 -0
  328. package/dist/src/product-brief/validator.js +251 -0
  329. package/dist/src/product-brief/validator.js.map +1 -0
  330. package/dist/src/product.d.ts +7 -0
  331. package/dist/src/product.js +28 -0
  332. package/dist/src/product.js.map +1 -0
  333. package/dist/src/quality-gate/report.d.ts +2 -0
  334. package/dist/src/quality-gate/report.js +46 -0
  335. package/dist/src/quality-gate/report.js.map +1 -0
  336. package/dist/src/quality-gate/runner.d.ts +2 -0
  337. package/dist/src/quality-gate/runner.js +175 -0
  338. package/dist/src/quality-gate/runner.js.map +1 -0
  339. package/dist/src/quality-gate/schema.d.ts +75 -0
  340. package/dist/src/quality-gate/schema.js +37 -0
  341. package/dist/src/quality-gate/schema.js.map +1 -0
  342. package/dist/src/quality-gate/types.d.ts +49 -0
  343. package/dist/src/quality-gate/types.js +2 -0
  344. package/dist/src/quality-gate/types.js.map +1 -0
  345. package/dist/src/repair/loader.d.ts +2 -0
  346. package/dist/src/repair/loader.js +11 -0
  347. package/dist/src/repair/loader.js.map +1 -0
  348. package/dist/src/repair/policy.d.ts +16 -0
  349. package/dist/src/repair/policy.js +65 -0
  350. package/dist/src/repair/policy.js.map +1 -0
  351. package/dist/src/repair/report.d.ts +2 -0
  352. package/dist/src/repair/report.js +32 -0
  353. package/dist/src/repair/report.js.map +1 -0
  354. package/dist/src/repair/runner.d.ts +17 -0
  355. package/dist/src/repair/runner.js +511 -0
  356. package/dist/src/repair/runner.js.map +1 -0
  357. package/dist/src/repair/schema.d.ts +264 -0
  358. package/dist/src/repair/schema.js +202 -0
  359. package/dist/src/repair/schema.js.map +1 -0
  360. package/dist/src/retrieval/report.d.ts +2 -0
  361. package/dist/src/retrieval/report.js +21 -0
  362. package/dist/src/retrieval/report.js.map +1 -0
  363. package/dist/src/retrieval/schema.d.ts +123 -0
  364. package/dist/src/retrieval/schema.js +77 -0
  365. package/dist/src/retrieval/schema.js.map +1 -0
  366. package/dist/src/retrieval/search.d.ts +26 -0
  367. package/dist/src/retrieval/search.js +415 -0
  368. package/dist/src/retrieval/search.js.map +1 -0
  369. package/dist/src/runtime/advanced-checks.d.ts +6 -0
  370. package/dist/src/runtime/advanced-checks.js +487 -0
  371. package/dist/src/runtime/advanced-checks.js.map +1 -0
  372. package/dist/src/runtime/composition-checks.d.ts +5 -0
  373. package/dist/src/runtime/composition-checks.js +307 -0
  374. package/dist/src/runtime/composition-checks.js.map +1 -0
  375. package/dist/src/runtime/interface-checks.d.ts +12 -0
  376. package/dist/src/runtime/interface-checks.js +224 -0
  377. package/dist/src/runtime/interface-checks.js.map +1 -0
  378. package/dist/src/runtime/policy.d.ts +13 -0
  379. package/dist/src/runtime/policy.js +97 -0
  380. package/dist/src/runtime/policy.js.map +1 -0
  381. package/dist/src/runtime/report.d.ts +2 -0
  382. package/dist/src/runtime/report.js +48 -0
  383. package/dist/src/runtime/report.js.map +1 -0
  384. package/dist/src/runtime/schema.d.ts +406 -0
  385. package/dist/src/runtime/schema.js +308 -0
  386. package/dist/src/runtime/schema.js.map +1 -0
  387. package/dist/src/runtime/types.d.ts +177 -0
  388. package/dist/src/runtime/types.js +2 -0
  389. package/dist/src/runtime/types.js.map +1 -0
  390. package/dist/src/runtime/verifier.d.ts +2 -0
  391. package/dist/src/runtime/verifier.js +1201 -0
  392. package/dist/src/runtime/verifier.js.map +1 -0
  393. package/dist/src/server.d.ts +2 -0
  394. package/dist/src/server.js +1352 -0
  395. package/dist/src/server.js.map +1 -0
  396. package/docs/installation.md +337 -0
  397. package/knowledge-base/INDEX.md +285 -0
  398. package/knowledge-base/benchmarks/aegisops/CALIBRATION.md +52 -0
  399. package/knowledge-base/benchmarks/aegisops/MANIFEST.md +56 -0
  400. package/knowledge-base/benchmarks/aegisops/SOURCE-EVIDENCE.md +45 -0
  401. package/knowledge-base/benchmarks/aegisops/acceptance-criteria.md +42 -0
  402. package/knowledge-base/benchmarks/aegisops/anti-patterns.md +19 -0
  403. package/knowledge-base/benchmarks/aegisops/attestations.template.yaml +3 -0
  404. package/knowledge-base/benchmarks/aegisops/attestations.yaml +115 -0
  405. package/knowledge-base/benchmarks/aegisops/journeys.json +91 -0
  406. package/knowledge-base/benchmarks/aegisops/product-contract.yaml +328 -0
  407. package/knowledge-base/benchmarks/azure-optimizer/SOURCE-EVIDENCE.md +26 -0
  408. package/knowledge-base/benchmarks/azure-optimizer/V2-IMPLEMENTATION.md +39 -0
  409. package/knowledge-base/benchmarks/azure-optimizer/acceptance-criteria.md +23 -0
  410. package/knowledge-base/benchmarks/azure-optimizer/anti-patterns.md +13 -0
  411. package/knowledge-base/benchmarks/azure-optimizer/journeys.json +88 -0
  412. package/knowledge-base/benchmarks/azure-optimizer/product-contract.yaml +216 -0
  413. package/knowledge-base/benchmarks/azure-optimizer/v2-human-review-methodology.yaml +171 -0
  414. package/knowledge-base/benchmarks/azure-optimizer/v2-journeys.json +139 -0
  415. package/knowledge-base/benchmarks/corpus/PROVENANCE.md +21 -0
  416. package/knowledge-base/benchmarks/corpus/README.md +30 -0
  417. package/knowledge-base/benchmarks/corpus/cases/anti-slop-negative/package.json +9 -0
  418. package/knowledge-base/benchmarks/corpus/cases/anti-slop-negative/src/FakeDashboard.tsx +10 -0
  419. package/knowledge-base/benchmarks/corpus/cases/anti-slop-positive/package.json +9 -0
  420. package/knowledge-base/benchmarks/corpus/cases/anti-slop-positive/src/Progress.tsx +15 -0
  421. package/knowledge-base/benchmarks/corpus/cases/architecture-negative/package.json +9 -0
  422. package/knowledge-base/benchmarks/corpus/cases/architecture-negative/src/OperationsPanel.tsx +40 -0
  423. package/knowledge-base/benchmarks/corpus/cases/architecture-positive/package.json +9 -0
  424. package/knowledge-base/benchmarks/corpus/cases/architecture-positive/src/Dashboard.tsx +17 -0
  425. package/knowledge-base/benchmarks/corpus/cases/architecture-positive/src/theme.css +15 -0
  426. package/knowledge-base/benchmarks/corpus/cases/task-incomplete/SOURCE-EVIDENCE.md +3 -0
  427. package/knowledge-base/benchmarks/corpus/cases/task-incomplete/journeys.json +20 -0
  428. package/knowledge-base/benchmarks/corpus/cases/task-incomplete/product-contract.yaml +78 -0
  429. package/knowledge-base/benchmarks/corpus/corpus.schema.yaml +159 -0
  430. package/knowledge-base/benchmarks/corpus/corpus.yaml +209 -0
  431. package/knowledge-base/benchmarks/interface-quality/README.md +26 -0
  432. package/knowledge-base/benchmarks/interface-quality/SOLO-MAINTAINER-TRACK.md +35 -0
  433. package/knowledge-base/benchmarks/interface-quality/comparison-methodology-v1.1.schema.yaml +288 -0
  434. package/knowledge-base/benchmarks/interface-quality/comparison-methodology.schema.yaml +235 -0
  435. package/knowledge-base/benchmarks/interface-quality/comparison-methodology.template.yaml +181 -0
  436. package/knowledge-base/benchmarks/interface-quality/evidence/example-runtime-report.json +11 -0
  437. package/knowledge-base/benchmarks/interface-quality/review-session.schema.yaml +14 -0
  438. package/knowledge-base/benchmarks/interface-quality/review.schema.yaml +296 -0
  439. package/knowledge-base/benchmarks/interface-quality/review.template.yaml +43 -0
  440. package/knowledge-base/benchmarks/portfolio-corpus/ADAPTERS.md +68 -0
  441. package/knowledge-base/benchmarks/portfolio-corpus/PORTFOLIO-RUNNER.md +131 -0
  442. package/knowledge-base/benchmarks/portfolio-corpus/PRODUCT-TASK-CONTRACTS.md +29 -0
  443. package/knowledge-base/benchmarks/portfolio-corpus/PROMOTED-RULES.md +31 -0
  444. package/knowledge-base/benchmarks/portfolio-corpus/archetype-profiles.yaml +26 -0
  445. package/knowledge-base/benchmarks/portfolio-corpus/product-task-profile.schema.yaml +105 -0
  446. package/knowledge-base/benchmarks/portfolio-corpus/registry.schema.yaml +188 -0
  447. package/knowledge-base/benchmarks/portfolio-corpus/registry.template.yaml +63 -0
  448. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-abstention.json +10 -0
  449. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-negative.json +10 -0
  450. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-positive.json +10 -0
  451. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-abstention.json +10 -0
  452. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-negative.json +10 -0
  453. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-positive.json +10 -0
  454. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-abstention.json +10 -0
  455. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-negative.json +10 -0
  456. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-positive.json +10 -0
  457. package/knowledge-base/benchmarks/portfolio-corpus/rule-holdout-evaluation.template.json +14 -0
  458. package/knowledge-base/benchmarks/portfolio-corpus/rule-promotion-evidence.template.json +24 -0
  459. package/knowledge-base/benchmarks/portfolio-corpus/v3-command-evidence.template.json +17 -0
  460. package/knowledge-base/benchmarks/portfolio-corpus/v3-qualification-evidence.template.json +29 -0
  461. package/knowledge-base/benchmarks/scenestart/CALIBRATION.md +95 -0
  462. package/knowledge-base/benchmarks/scenestart/MANIFEST.md +53 -0
  463. package/knowledge-base/benchmarks/scenestart/SOURCE-EVIDENCE.md +43 -0
  464. package/knowledge-base/benchmarks/scenestart/acceptance-criteria.md +59 -0
  465. package/knowledge-base/benchmarks/scenestart/anti-patterns.md +26 -0
  466. package/knowledge-base/benchmarks/scenestart/attestations.template.yaml +3 -0
  467. package/knowledge-base/benchmarks/scenestart/attestations.yaml +21 -0
  468. package/knowledge-base/benchmarks/scenestart/human-review.md +99 -0
  469. package/knowledge-base/benchmarks/scenestart/human-review.template.md +105 -0
  470. package/knowledge-base/benchmarks/scenestart/journeys.json +141 -0
  471. package/knowledge-base/benchmarks/scenestart/product-contract.yaml +427 -0
  472. package/knowledge-base/dependencies.yaml +69 -0
  473. package/knowledge-base/design-intelligence/MASTER.md +87 -0
  474. package/knowledge-base/design-intelligence/asset-generation.md +66 -0
  475. package/knowledge-base/design-intelligence/brand-systems.md +69 -0
  476. package/knowledge-base/design-intelligence/closed-loop-repair.md +95 -0
  477. package/knowledge-base/design-intelligence/design-deliverable.schema.yaml +1194 -0
  478. package/knowledge-base/design-intelligence/design-deliverable.template.yaml +591 -0
  479. package/knowledge-base/design-intelligence/design-plan.md +78 -0
  480. package/knowledge-base/design-intelligence/design-plan.schema.yaml +621 -0
  481. package/knowledge-base/design-intelligence/figma-production.md +63 -0
  482. package/knowledge-base/design-intelligence/generation-adapter.md +72 -0
  483. package/knowledge-base/design-intelligence/generation-adapter.schema.yaml +47 -0
  484. package/knowledge-base/design-intelligence/iconography.md +46 -0
  485. package/knowledge-base/design-intelligence/information-design.md +104 -0
  486. package/knowledge-base/design-intelligence/information-design.schema.yaml +390 -0
  487. package/knowledge-base/design-intelligence/information-design.template.yaml +281 -0
  488. package/knowledge-base/design-intelligence/interaction-recovery-verification.md +72 -0
  489. package/knowledge-base/design-intelligence/interface-trust.md +103 -0
  490. package/knowledge-base/design-intelligence/interface-trust.schema.yaml +263 -0
  491. package/knowledge-base/design-intelligence/interface-trust.template.yaml +173 -0
  492. package/knowledge-base/design-intelligence/licensing-and-provenance.md +59 -0
  493. package/knowledge-base/design-intelligence/presentation-design.md +56 -0
  494. package/knowledge-base/design-intelligence/product-design-brief.md +67 -0
  495. package/knowledge-base/design-intelligence/product-design-brief.schema.yaml +279 -0
  496. package/knowledge-base/design-intelligence/product-design-brief.template.yaml +225 -0
  497. package/knowledge-base/design-intelligence/repair-request.schema.yaml +95 -0
  498. package/knowledge-base/design-intelligence/repair-request.template.yaml +39 -0
  499. package/knowledge-base/design-intelligence/visual-accessibility.md +56 -0
  500. package/knowledge-base/design-intelligence/visual-polish.md +172 -0
  501. package/knowledge-base/maintained/architecture/MASTER.md +22 -0
  502. package/knowledge-base/maintained/architecture/component-boundaries.md +30 -0
  503. package/knowledge-base/maintained/architecture/product-platforms.md +25 -0
  504. package/knowledge-base/maintained/architecture/quality-attributes-and-evaluation.md +35 -0
  505. package/knowledge-base/maintained/product-patterns/MASTER.md +10 -0
  506. package/knowledge-base/maintained/product-patterns/ai-workspaces.md +26 -0
  507. package/knowledge-base/maintained/product-patterns/operational-dashboards.md +22 -0
  508. package/knowledge-base/provenance.yaml +196 -0
  509. package/knowledge-base/retrieval-scope.yaml +43 -0
  510. package/knowledge-base/usability-evaluation/HEURISTIC_EVALUATION.md +115 -0
  511. package/knowledge-base/usability-evaluation/heuristic-review.schema.yaml +210 -0
  512. package/knowledge-base/usability-evaluation/heuristic-review.template.yaml +37 -0
  513. package/package.json +133 -0
@@ -0,0 +1,307 @@
1
+ function appendIssues(findings, checkId, viewport, issues) {
2
+ findings.push(...issues.map((issue) => ({
3
+ checkId,
4
+ severity: "error",
5
+ viewport: viewport.name,
6
+ message: issue.message,
7
+ evidence: issue.evidence,
8
+ ...(issue.selector ? { selector: issue.selector } : {}),
9
+ })));
10
+ }
11
+ export async function checkVisualComposition(page, viewport, findings) {
12
+ const issues = await page.evaluate(() => {
13
+ const root = document.querySelector('[data-ztothez-design-composition="1.0"]');
14
+ if (!root)
15
+ return [];
16
+ function selectorFor(element) {
17
+ if (element.id)
18
+ return `#${CSS.escape(element.id)}`;
19
+ const marker = [...element.attributes].find((entry) => entry.name.startsWith("data-ztothez-design-"));
20
+ return `${element.tagName.toLowerCase()}${marker ? `[${marker.name}]` : ""}`;
21
+ }
22
+ function visible(element) {
23
+ const rect = element.getBoundingClientRect();
24
+ const style = getComputedStyle(element);
25
+ return (rect.width > 1 &&
26
+ rect.height > 1 &&
27
+ style.display !== "none" &&
28
+ style.visibility !== "hidden" &&
29
+ Number.parseFloat(style.opacity || "1") > 0.01 &&
30
+ !element.closest('[aria-hidden="true"], [inert]'));
31
+ }
32
+ function integerAttribute(name, fallback) {
33
+ const value = Number.parseInt(root.getAttribute(name) ?? "", 10);
34
+ return Number.isInteger(value) && value > 0 ? value : fallback;
35
+ }
36
+ const result = [];
37
+ const requiredRoles = ["context", "primary-outcome", "next-action"];
38
+ const priorities = [...root.querySelectorAll("[data-ztothez-design-priority]")];
39
+ const seen = new Map();
40
+ for (const element of priorities) {
41
+ const role = element.getAttribute("data-ztothez-design-priority") ?? "";
42
+ seen.set(role, [...(seen.get(role) ?? []), element]);
43
+ }
44
+ for (const role of requiredRoles) {
45
+ const elements = seen.get(role) ?? [];
46
+ if (elements.length !== 1 || !visible(elements[0])) {
47
+ result.push({
48
+ selector: selectorFor(root),
49
+ message: `Decision hierarchy requires one visible ${role} region.`,
50
+ evidence: [`Found ${elements.length}; visible=${elements.length === 1 && visible(elements[0])}.`],
51
+ });
52
+ }
53
+ }
54
+ const ordered = requiredRoles
55
+ .map((role) => seen.get(role)?.[0])
56
+ .filter((entry) => Boolean(entry));
57
+ for (let index = 1; index < ordered.length; index += 1) {
58
+ const previous = ordered[index - 1];
59
+ const current = ordered[index];
60
+ if (!(previous.compareDocumentPosition(current) & Node.DOCUMENT_POSITION_FOLLOWING)) {
61
+ result.push({
62
+ selector: selectorFor(current),
63
+ message: "Decision-critical regions do not preserve context, outcome, then next-action order.",
64
+ evidence: requiredRoles.map((role) => `${role}: ${selectorFor(seen.get(role)?.[0] ?? root)}`),
65
+ });
66
+ break;
67
+ }
68
+ }
69
+ const nextAction = seen.get("next-action")?.[0];
70
+ if (nextAction) {
71
+ const actionable = nextAction.matches('button:not([disabled]), a[href], [role="button"]')
72
+ ? nextAction
73
+ : nextAction.querySelector('button:not([disabled]), a[href], [role="button"]');
74
+ if (!actionable || !visible(actionable)) {
75
+ result.push({
76
+ selector: selectorFor(nextAction),
77
+ message: "The visible next-action region has no reachable enabled action.",
78
+ evidence: ["Render the primary command directly in the decision path instead of hiding it behind unrelated navigation."],
79
+ });
80
+ }
81
+ }
82
+ const context = seen.get("context")?.[0];
83
+ const outcome = seen.get("primary-outcome")?.[0];
84
+ if (context && outcome && nextAction) {
85
+ for (const region of [...root.querySelectorAll("[data-ztothez-design-region]")].filter(visible)) {
86
+ if (region.contains(outcome) || region.contains(nextAction))
87
+ continue;
88
+ const afterContext = Boolean(context.compareDocumentPosition(region) & Node.DOCUMENT_POSITION_FOLLOWING);
89
+ const beforeOutcome = Boolean(region.compareDocumentPosition(outcome) & Node.DOCUMENT_POSITION_FOLLOWING);
90
+ const afterOutcome = Boolean(outcome.compareDocumentPosition(region) & Node.DOCUMENT_POSITION_FOLLOWING);
91
+ const beforeAction = Boolean(region.compareDocumentPosition(nextAction) & Node.DOCUMENT_POSITION_FOLLOWING);
92
+ if ((afterContext && beforeOutcome) || (afterOutcome && beforeAction)) {
93
+ result.push({
94
+ selector: selectorFor(region),
95
+ message: "A supporting region interrupts the decision-critical context, outcome, and next-action sequence.",
96
+ evidence: ["Move detailed telemetry, provenance, history, or secondary controls after the primary next action."],
97
+ });
98
+ }
99
+ }
100
+ }
101
+ const primaryActions = [...root.querySelectorAll("[data-ztothez-design-primary-action]")].filter(visible);
102
+ const maximumPrimaryActions = integerAttribute("data-ztothez-design-max-primary-actions", 3);
103
+ if (primaryActions.length > maximumPrimaryActions) {
104
+ result.push({
105
+ selector: selectorFor(root),
106
+ message: "Composition exposes too many simultaneous primary actions.",
107
+ evidence: [`Visible primary actions: ${primaryActions.length}; declared maximum: ${maximumPrimaryActions}.`],
108
+ });
109
+ }
110
+ const regions = [...root.querySelectorAll("[data-ztothez-design-region]")].filter(visible);
111
+ const maximumRegions = integerAttribute("data-ztothez-design-max-visible-regions", 8);
112
+ if (regions.length > maximumRegions) {
113
+ result.push({
114
+ selector: selectorFor(root),
115
+ message: "Composition exceeds its declared visible-region density limit.",
116
+ evidence: [`Visible regions: ${regions.length}; declared maximum: ${maximumRegions}.`],
117
+ });
118
+ }
119
+ for (const status of [...root.querySelectorAll("[data-ztothez-design-status]")].filter(visible)) {
120
+ const purpose = status.getAttribute("data-ztothez-design-status-purpose")?.trim();
121
+ const text = status.textContent?.trim();
122
+ if (!purpose || !text) {
123
+ result.push({
124
+ selector: selectorFor(status),
125
+ message: "Visible status treatment is ornamental or lacks explicit meaning.",
126
+ evidence: [`Purpose present=${Boolean(purpose)}; readable text present=${Boolean(text)}.`],
127
+ });
128
+ }
129
+ }
130
+ const allowedClaimBases = new Set(["synthetic", "source", "runtime", "user-provided"]);
131
+ for (const claim of [...root.querySelectorAll("[data-ztothez-design-visual-claim]")].filter(visible)) {
132
+ const basis = claim.getAttribute("data-ztothez-design-claim-basis") ?? "";
133
+ const evidenceRef = claim.getAttribute("data-ztothez-design-evidence-ref")?.trim();
134
+ if (!allowedClaimBases.has(basis) || !evidenceRef) {
135
+ result.push({
136
+ selector: selectorFor(claim),
137
+ message: "Visual claim lacks a supported basis or evidence reference.",
138
+ evidence: [`Basis=${JSON.stringify(basis)}; evidence reference present=${Boolean(evidenceRef)}.`],
139
+ });
140
+ }
141
+ }
142
+ return result.slice(0, 40);
143
+ });
144
+ appendIssues(findings, "ZTDE-RUNTIME-020", viewport, issues);
145
+ }
146
+ export async function checkRenderedVisualContrast(page, viewport, findings) {
147
+ const issues = await page.evaluate(() => {
148
+ const root = document.querySelector('[data-ztothez-design-composition="1.0"]');
149
+ if (!root)
150
+ return [];
151
+ const canvas = document.createElement("canvas");
152
+ canvas.width = 1;
153
+ canvas.height = 1;
154
+ const context = canvas.getContext("2d", { willReadFrequently: true });
155
+ function selectorFor(element) {
156
+ if (element.id)
157
+ return `#${CSS.escape(element.id)}`;
158
+ const marker = [...element.attributes].find((entry) => entry.name.startsWith("data-ztothez-design-"));
159
+ return `${element.tagName.toLowerCase()}${marker ? `[${marker.name}]` : ""}`;
160
+ }
161
+ function parseColor(value) {
162
+ if (!context)
163
+ return null;
164
+ context.clearRect(0, 0, 1, 1);
165
+ context.fillStyle = value;
166
+ context.fillRect(0, 0, 1, 1);
167
+ const pixel = context.getImageData(0, 0, 1, 1).data;
168
+ return { red: pixel[0], green: pixel[1], blue: pixel[2], alpha: pixel[3] / 255 };
169
+ }
170
+ function composite(foreground, background) {
171
+ const alpha = foreground.alpha + background.alpha * (1 - foreground.alpha);
172
+ if (alpha <= 0)
173
+ return { red: 0, green: 0, blue: 0, alpha: 0 };
174
+ return {
175
+ red: (foreground.red * foreground.alpha + background.red * background.alpha * (1 - foreground.alpha)) / alpha,
176
+ green: (foreground.green * foreground.alpha + background.green * background.alpha * (1 - foreground.alpha)) / alpha,
177
+ blue: (foreground.blue * foreground.alpha + background.blue * background.alpha * (1 - foreground.alpha)) / alpha,
178
+ alpha,
179
+ };
180
+ }
181
+ function backgroundFor(element) {
182
+ let current = element;
183
+ let result = { red: 0, green: 0, blue: 0, alpha: 0 };
184
+ while (current) {
185
+ const style = getComputedStyle(current);
186
+ if (style.backgroundImage !== "none")
187
+ return null;
188
+ const layer = parseColor(style.backgroundColor);
189
+ if (!layer)
190
+ return null;
191
+ result = composite(result, layer);
192
+ if (result.alpha >= 0.999)
193
+ return result;
194
+ current = current.parentElement;
195
+ }
196
+ return composite(result, { red: 255, green: 255, blue: 255, alpha: 1 });
197
+ }
198
+ function luminance(color) {
199
+ const channels = [color.red, color.green, color.blue].map((channel) => {
200
+ const value = channel / 255;
201
+ return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
202
+ });
203
+ return channels[0] * 0.2126 + channels[1] * 0.7152 + channels[2] * 0.0722;
204
+ }
205
+ function ratio(first, second) {
206
+ const left = luminance(first);
207
+ const right = luminance(second);
208
+ return (Math.max(left, right) + 0.05) / (Math.min(left, right) + 0.05);
209
+ }
210
+ function visible(element) {
211
+ const rect = element.getBoundingClientRect();
212
+ const style = getComputedStyle(element);
213
+ return rect.width > 1 && rect.height > 1 && style.display !== "none" && style.visibility !== "hidden";
214
+ }
215
+ function issueForColor(element, colorValue, surface, label) {
216
+ const color = parseColor(colorValue);
217
+ const background = backgroundFor(surface);
218
+ if (!color || !background || color.alpha < 0.99)
219
+ return undefined;
220
+ const measured = ratio(color, background);
221
+ if (measured + 0.01 >= 3)
222
+ return undefined;
223
+ return {
224
+ selector: selectorFor(element),
225
+ message: `${label} does not meet rendered 3:1 non-text contrast.`,
226
+ evidence: [`Measured ${measured.toFixed(2)}:1 against the adjacent rendered surface.`],
227
+ };
228
+ }
229
+ const result = [];
230
+ const focusable = [...root.querySelectorAll('a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])')].filter(visible);
231
+ for (const element of focusable) {
232
+ element.focus({ preventScroll: true });
233
+ const style = getComputedStyle(element);
234
+ const outlineWidth = Number.parseFloat(style.outlineWidth);
235
+ const borderWidth = Math.max(...[style.borderTopWidth, style.borderRightWidth, style.borderBottomWidth, style.borderLeftWidth].map(Number.parseFloat));
236
+ const color = outlineWidth >= 2 && style.outlineStyle !== "none" ? style.outlineColor : borderWidth >= 2 ? style.borderColor : "";
237
+ if (!color) {
238
+ result.push({ selector: selectorFor(element), message: "Focusable control has no measurable focus indicator.", evidence: ["Use a visible outline or border at least 2 CSS pixels wide."] });
239
+ continue;
240
+ }
241
+ const issue = issueForColor(element, color, element.parentElement, "Focus indicator");
242
+ if (issue)
243
+ result.push(issue);
244
+ }
245
+ for (const state of [...root.querySelectorAll("[data-ztothez-design-state-visual]")].filter(visible)) {
246
+ const style = getComputedStyle(state);
247
+ const issue = issueForColor(state, style.color, state, "State indicator");
248
+ if (issue)
249
+ result.push(issue);
250
+ if (!state.getAttribute("data-ztothez-design-non-color-cue")) {
251
+ result.push({ selector: selectorFor(state), message: "State indicator relies on color without a declared non-color cue.", evidence: ["Add visible text, icon, shape, pattern, value, or position semantics."] });
252
+ }
253
+ }
254
+ for (const chartVisual of [...root.querySelectorAll("[data-ztothez-design-chart-series-visual]")].filter(visible)) {
255
+ const style = getComputedStyle(chartVisual);
256
+ const color = chartVisual.getAttribute("data-ztothez-design-chart-color") ?? style.color;
257
+ const chart = chartVisual.closest("[data-ztothez-design-chart]") ?? chartVisual.parentElement;
258
+ const issue = issueForColor(chartVisual, color, chart, "Chart series");
259
+ if (issue)
260
+ result.push(issue);
261
+ }
262
+ return result.slice(0, 50);
263
+ });
264
+ appendIssues(findings, "ZTDE-RUNTIME-021", viewport, issues);
265
+ }
266
+ export async function checkRenderedAssets(page, viewport, findings) {
267
+ const issues = await page.evaluate(() => {
268
+ const root = document.querySelector('[data-ztothez-design-composition="1.0"]');
269
+ if (!root)
270
+ return [];
271
+ function selectorFor(element) {
272
+ if (element.id)
273
+ return `#${CSS.escape(element.id)}`;
274
+ return `${element.tagName.toLowerCase()}[data-ztothez-design-asset]`;
275
+ }
276
+ function visible(element) {
277
+ const rect = element.getBoundingClientRect();
278
+ const style = getComputedStyle(element);
279
+ return rect.width > 1 && rect.height > 1 && style.display !== "none" && style.visibility !== "hidden";
280
+ }
281
+ const allowedSources = new Set(["original", "user-provided", "generated", "commissioned", "licensed", "open-source", "public-domain"]);
282
+ const allowedFailures = new Set(["hide-decorative", "text-alternative", "placeholder", "retry", "block"]);
283
+ return [...root.querySelectorAll("[data-ztothez-design-asset]")]
284
+ .filter(visible)
285
+ .flatMap((asset) => {
286
+ const purpose = asset.getAttribute("data-ztothez-design-asset-purpose")?.trim();
287
+ const source = asset.getAttribute("data-ztothez-design-asset-source") ?? "";
288
+ const rights = asset.getAttribute("data-ztothez-design-asset-rights") ?? "";
289
+ const alternative = asset.getAttribute("data-ztothez-design-asset-alternative") ?? "";
290
+ const failure = asset.getAttribute("data-ztothez-design-asset-failure") ?? "";
291
+ const informativeImageWithoutAlt = asset instanceof HTMLImageElement && alternative !== "decorative" && !asset.alt.trim();
292
+ if (purpose && allowedSources.has(source) && rights === "approved" && alternative && allowedFailures.has(failure) && !informativeImageWithoutAlt)
293
+ return [];
294
+ return [{
295
+ selector: selectorFor(asset),
296
+ message: "Rendered asset lacks production provenance, alternative, or failure metadata.",
297
+ evidence: [
298
+ `Purpose=${Boolean(purpose)}; source=${JSON.stringify(source)}; rights=${JSON.stringify(rights)}.`,
299
+ `Alternative=${JSON.stringify(alternative)}; failure=${JSON.stringify(failure)}; informative image alt valid=${!informativeImageWithoutAlt}.`,
300
+ ],
301
+ }];
302
+ })
303
+ .slice(0, 30);
304
+ });
305
+ appendIssues(findings, "ZTDE-RUNTIME-022", viewport, issues);
306
+ }
307
+ //# sourceMappingURL=composition-checks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"composition-checks.js","sourceRoot":"","sources":["../../../src/runtime/composition-checks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { Page } from "playwright-core";
2
+ import type { RuntimeFinding, RuntimeViewport } from "./types.js";
3
+ export type InterfaceCoverage = {
4
+ requiredStages: Set<string>;
5
+ observedStages: Set<string>;
6
+ requiredStates: Set<string>;
7
+ observedStates: Set<string>;
8
+ };
9
+ export declare function createInterfaceCoverage(): InterfaceCoverage;
10
+ export declare function checkInterfaceTrust(page: Page, viewport: RuntimeViewport, findings: RuntimeFinding[], coverage: InterfaceCoverage): Promise<void>;
11
+ export declare function addInterfaceCoverageFindings(findings: RuntimeFinding[], coverage: InterfaceCoverage): void;
12
+ export declare function checkChartContracts(page: Page, viewport: RuntimeViewport, findings: RuntimeFinding[]): Promise<void>;
@@ -0,0 +1,224 @@
1
+ export function createInterfaceCoverage() {
2
+ return {
3
+ requiredStages: new Set(),
4
+ observedStages: new Set(),
5
+ requiredStates: new Set(),
6
+ observedStates: new Set(),
7
+ };
8
+ }
9
+ function appendIssues(findings, checkId, viewport, issues) {
10
+ findings.push(...issues.map((issue) => ({
11
+ checkId,
12
+ severity: "error",
13
+ viewport: viewport.name,
14
+ message: issue.message,
15
+ evidence: issue.evidence,
16
+ ...(issue.selector ? { selector: issue.selector } : {}),
17
+ })));
18
+ }
19
+ export async function checkInterfaceTrust(page, viewport, findings, coverage) {
20
+ const result = await page.evaluate(() => {
21
+ const root = document.querySelector("[data-ztothez-design-interface-trust]");
22
+ if (!root)
23
+ return null;
24
+ const trustRoot = root;
25
+ function selectorFor(element) {
26
+ if (element.id)
27
+ return `#${CSS.escape(element.id)}`;
28
+ const attribute = [...element.attributes].find((entry) => entry.name.startsWith("data-ztothez-design-"));
29
+ return `${element.tagName.toLowerCase()}${attribute ? `[${attribute.name}]` : ""}`;
30
+ }
31
+ function visible(element) {
32
+ const rect = element.getBoundingClientRect();
33
+ const style = getComputedStyle(element);
34
+ return (rect.width > 1 &&
35
+ rect.height > 1 &&
36
+ style.display !== "none" &&
37
+ style.visibility !== "hidden" &&
38
+ Number.parseFloat(style.opacity || "1") > 0.01 &&
39
+ !element.closest('[aria-hidden="true"], [inert]'));
40
+ }
41
+ function list(name) {
42
+ return (trustRoot.getAttribute(name) ?? "")
43
+ .split(/[\s,]+/)
44
+ .map((entry) => entry.trim())
45
+ .filter(Boolean);
46
+ }
47
+ const issues = [];
48
+ const modes = [...document.querySelectorAll("[data-ztothez-design-data-mode]")].filter(visible);
49
+ if (modes.length === 0) {
50
+ issues.push({
51
+ selector: selectorFor(root),
52
+ message: "V2 interface has no visible persistent data-mode disclosure.",
53
+ evidence: ["The interface-trust marker is present, but no visible data-mode element was rendered."],
54
+ });
55
+ }
56
+ for (const modeElement of modes) {
57
+ const mode = modeElement.getAttribute("data-ztothez-design-data-mode") ?? "";
58
+ const text = modeElement.textContent?.trim().toLowerCase() ?? "";
59
+ if (!new Set(["demo", "live", "hybrid", "imported", "cached"]).has(mode) || !text.includes(mode)) {
60
+ issues.push({
61
+ selector: selectorFor(modeElement),
62
+ message: "Data-mode disclosure is invalid or not readable in visible text.",
63
+ evidence: [`Declared mode ${JSON.stringify(mode)}; visible text ${JSON.stringify(text.slice(0, 120))}.`],
64
+ });
65
+ }
66
+ }
67
+ const stage = root.getAttribute("data-ztothez-design-stage") ?? "";
68
+ const state = root.getAttribute("data-ztothez-design-state") ?? "";
69
+ const allowedStages = new Set(["initial", "loading", "result", "error", "history", "export"]);
70
+ if (stage && !allowedStages.has(stage)) {
71
+ issues.push({
72
+ selector: selectorFor(root),
73
+ message: "Interface-trust stage is not recognized.",
74
+ evidence: [`Received ${JSON.stringify(stage)}; expected initial, loading, result, error, history, or export.`],
75
+ });
76
+ }
77
+ const simulated = [...document.querySelectorAll('[data-ztothez-design-result-origin="simulated"]')].filter(visible);
78
+ for (const element of simulated) {
79
+ const text = element.textContent?.trim().toLowerCase() ?? "";
80
+ if (!/(?:demo|fallback|simulat)/.test(text)) {
81
+ issues.push({
82
+ selector: selectorFor(element),
83
+ message: "Simulated result origin is not disclosed in visible text.",
84
+ evidence: [`Visible text was ${JSON.stringify(text.slice(0, 120))}.`],
85
+ });
86
+ }
87
+ }
88
+ const stale = [...document.querySelectorAll('[data-ztothez-design-freshness="stale"]')].filter(visible);
89
+ for (const element of stale) {
90
+ const timestamp = element.getAttribute("data-ztothez-design-timestamp");
91
+ const timezone = element.getAttribute("data-ztothez-design-timezone");
92
+ if (!timestamp || Number.isNaN(Date.parse(timestamp)) || !timezone || !(element.textContent ?? "").toLowerCase().includes("stale")) {
93
+ issues.push({
94
+ selector: selectorFor(element),
95
+ message: "Stale data lacks a visible stale label, parseable timestamp, or timezone.",
96
+ evidence: [`Timestamp present=${Boolean(timestamp)}; timezone present=${Boolean(timezone)}.`],
97
+ });
98
+ }
99
+ }
100
+ const disconnected = [...document.querySelectorAll('[data-ztothez-design-connection="disconnected"]')].filter(visible);
101
+ if (disconnected.length > 0 && ![...document.querySelectorAll("[data-ztothez-design-recovery-action]")].some(visible)) {
102
+ issues.push({
103
+ selector: selectorFor(disconnected[0]),
104
+ message: "Disconnected state has no visible recovery action.",
105
+ evidence: ["Declare a retry, reconnect, configuration, or offline continuation action."],
106
+ });
107
+ }
108
+ return {
109
+ issues,
110
+ stage,
111
+ state,
112
+ requiredStages: list("data-ztothez-design-required-stages"),
113
+ requiredStates: list("data-ztothez-design-required-states"),
114
+ };
115
+ });
116
+ if (!result)
117
+ return;
118
+ if (result.stage)
119
+ coverage.observedStages.add(result.stage);
120
+ if (result.state)
121
+ coverage.observedStates.add(result.state);
122
+ for (const stage of result.requiredStages)
123
+ coverage.requiredStages.add(stage);
124
+ for (const state of result.requiredStates)
125
+ coverage.requiredStates.add(state);
126
+ appendIssues(findings, "ZTDE-RUNTIME-017", viewport, result.issues);
127
+ }
128
+ export function addInterfaceCoverageFindings(findings, coverage) {
129
+ const missingStages = [...coverage.requiredStages].filter((stage) => !coverage.observedStages.has(stage));
130
+ const missingStates = [...coverage.requiredStates].filter((state) => !coverage.observedStates.has(state));
131
+ if (missingStages.length > 0) {
132
+ findings.push({
133
+ checkId: "ZTDE-RUNTIME-017",
134
+ severity: "error",
135
+ message: "Required interface-trust stages were not observed.",
136
+ evidence: [
137
+ `Missing: ${missingStages.join(", ")}.`,
138
+ `Observed: ${[...coverage.observedStages].join(", ") || "none"}.`,
139
+ ],
140
+ });
141
+ }
142
+ if (missingStates.length > 0) {
143
+ findings.push({
144
+ checkId: "ZTDE-RUNTIME-017",
145
+ severity: "error",
146
+ message: "Required V2 fixture states were not observed.",
147
+ evidence: [
148
+ `Missing: ${missingStates.join(", ")}.`,
149
+ `Observed: ${[...coverage.observedStates].join(", ") || "none"}.`,
150
+ ],
151
+ });
152
+ }
153
+ }
154
+ export async function checkChartContracts(page, viewport, findings) {
155
+ const issues = await page.evaluate(() => {
156
+ function selectorFor(element) {
157
+ if (element.id)
158
+ return `#${CSS.escape(element.id)}`;
159
+ return `${element.tagName.toLowerCase()}[data-ztothez-design-chart]`;
160
+ }
161
+ function visible(element) {
162
+ const rect = element.getBoundingClientRect();
163
+ const style = getComputedStyle(element);
164
+ return rect.width > 1 && rect.height > 1 && style.display !== "none" && style.visibility !== "hidden";
165
+ }
166
+ function labelledBy(element) {
167
+ return (element.getAttribute("aria-labelledby") ?? "")
168
+ .split(/\s+/)
169
+ .filter(Boolean)
170
+ .map((id) => document.getElementById(id)?.textContent ?? "")
171
+ .join(" ")
172
+ .trim();
173
+ }
174
+ return [...document.querySelectorAll("[data-ztothez-design-chart]")]
175
+ .filter(visible)
176
+ .flatMap((chart) => {
177
+ const chartIssues = [];
178
+ const name = chart.getAttribute("aria-label")?.trim() || labelledBy(chart) || chart.querySelector("figcaption")?.textContent?.trim();
179
+ if (!name) {
180
+ chartIssues.push({
181
+ selector: selectorFor(chart),
182
+ message: "Chart has no visible or programmatic name.",
183
+ evidence: ["Provide aria-label, aria-labelledby, or a figcaption."],
184
+ });
185
+ }
186
+ const valuesDeclared = chart.getAttribute("data-ztothez-design-chart-values") === "visible";
187
+ const valuesRendered = [...chart.querySelectorAll("[data-ztothez-design-chart-value]")].some(visible);
188
+ if (!valuesDeclared && !valuesRendered) {
189
+ chartIssues.push({
190
+ selector: selectorFor(chart),
191
+ message: "Chart does not expose readable values.",
192
+ evidence: ["Declare visible values or render elements marked with data-ztothez-design-chart-value."],
193
+ });
194
+ }
195
+ const alternativeSelector = chart.getAttribute("data-ztothez-design-chart-alternative");
196
+ let alternative = null;
197
+ try {
198
+ alternative = alternativeSelector ? document.querySelector(alternativeSelector) : null;
199
+ }
200
+ catch {
201
+ alternative = null;
202
+ }
203
+ if (!alternativeSelector || !alternative || !visible(alternative)) {
204
+ chartIssues.push({
205
+ selector: selectorFor(chart),
206
+ message: "Chart has no visible textual or tabular alternative.",
207
+ evidence: [`Alternative selector: ${JSON.stringify(alternativeSelector)}.`],
208
+ });
209
+ }
210
+ const series = Number.parseInt(chart.getAttribute("data-ztothez-design-chart-series") ?? "1", 10);
211
+ if (series > 1 && ![...chart.querySelectorAll("[data-ztothez-design-chart-legend]")].some(visible)) {
212
+ chartIssues.push({
213
+ selector: selectorFor(chart),
214
+ message: "Multi-series chart has no visible legend.",
215
+ evidence: [`Declared series count: ${series}.`],
216
+ });
217
+ }
218
+ return chartIssues;
219
+ })
220
+ .slice(0, 30);
221
+ });
222
+ appendIssues(findings, "ZTDE-RUNTIME-018", viewport, issues);
223
+ }
224
+ //# sourceMappingURL=interface-checks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interface-checks.js","sourceRoot":"","sources":["../../../src/runtime/interface-checks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { RuntimeColorScheme, RuntimeViewport } from "./types.js";
2
+ export declare const DEFAULT_RUNTIME_VIEWPORTS: readonly RuntimeViewport[];
3
+ export declare const DEFAULT_RUNTIME_COLOR_SCHEMES: readonly RuntimeColorScheme[];
4
+ export declare const DEFAULT_NAVIGATION_TIMEOUT_MS = 30000;
5
+ export declare const DEFAULT_SETTLE_MS = 500;
6
+ export declare const MAX_RUNTIME_VIEWPORTS = 8;
7
+ export declare const MAX_RUNTIME_JOURNEYS = 10;
8
+ export declare const MAX_JOURNEY_STEPS = 50;
9
+ export declare function resolveChromiumPath(configuredPath?: string): string | undefined;
10
+ export declare function resolveChromiumCdpUrl(configuredUrl?: string): string | undefined;
11
+ export declare function validateRuntimeUrl(value: string): URL;
12
+ export declare function validateViewports(viewports: RuntimeViewport[]): void;
13
+ export declare function validateColorSchemes(colorSchemes: RuntimeColorScheme[]): void;