@wildo-ai/framework-knowledge 1.1.9 → 1.1.11

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 (1163) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
  5. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  6. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
  7. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  8. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
  9. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  10. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  11. package/dist/esm/framework-knowledge.definitions.js +543 -80
  12. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  13. package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
  14. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  15. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  16. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  17. package/dist/esm/index.d.ts +2 -0
  18. package/dist/esm/index.d.ts.map +1 -1
  19. package/dist/esm/index.js +2 -0
  20. package/dist/esm/index.js.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  22. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
  25. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +138 -21
  27. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  33. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +17 -9
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
  37. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +89 -9
  41. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +6 -5
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +6 -4
  45. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  47. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  51. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  53. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +28 -6
  55. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  56. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -5
  57. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  58. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  59. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
  61. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  62. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  63. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
  65. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
  67. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
  69. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +14 -6
  71. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
  73. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
  75. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
  77. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
  79. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
  81. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
  83. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  85. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  86. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  87. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
  89. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
  91. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
  94. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +34 -7
  96. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
  98. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  100. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  101. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  102. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +14 -6
  104. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
  107. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  109. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  111. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
  113. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  114. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
  115. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  116. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  117. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +15 -3
  118. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  119. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  120. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  121. package/dist/esm/source-anchor-grammar.js +114 -0
  122. package/dist/esm/source-anchor-grammar.js.map +1 -0
  123. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  124. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  125. package/dist/knowledge/manifest.json +8 -8
  126. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  127. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  128. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  129. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  130. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +497 -32
  131. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
  132. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
  133. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  134. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  135. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
  136. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  137. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
  138. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  139. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  140. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
  141. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
  142. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
  143. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
  144. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
  145. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
  146. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
  147. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
  148. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
  149. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  150. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
  151. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
  152. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
  153. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
  154. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
  155. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  156. package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
  157. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
  158. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  159. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
  160. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  161. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  162. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  163. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  164. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
  165. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
  166. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
  167. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
  168. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  169. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  170. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
  171. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
  172. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
  173. package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
  174. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
  175. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  176. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
  177. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
  178. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
  179. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
  180. package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
  181. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  182. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
  183. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  184. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
  185. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  186. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  187. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  188. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
  189. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  190. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  191. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
  192. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  193. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  194. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  195. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  196. package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
  197. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
  198. package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
  199. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
  200. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
  201. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
  202. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  203. package/dist/knowledge/references/application-maturity.config.md +1 -1
  204. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
  205. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
  206. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  207. package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
  208. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  209. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  210. package/dist/knowledge/references/brand.name-choice.config.md +20 -3
  211. package/dist/knowledge/references/brand.name-screening.config.md +58 -3
  212. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  213. package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
  214. package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
  215. package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
  216. package/dist/knowledge/references/capability-composition.config.md +4 -3
  217. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  218. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  219. package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
  220. package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
  221. package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
  222. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  223. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  224. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  225. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  226. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  227. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
  228. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  229. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
  230. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
  231. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  232. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  233. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  234. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  235. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  236. package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
  237. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  238. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  239. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  240. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
  241. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  242. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  243. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  244. package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
  245. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  246. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  247. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  248. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  249. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  250. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  251. package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
  252. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  253. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  254. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  255. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
  256. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  257. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  258. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  259. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  260. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  261. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  262. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
  263. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
  264. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
  265. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  266. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  267. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  268. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  269. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  270. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  271. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  272. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  273. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  274. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  275. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  276. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  277. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  278. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  279. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  280. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  281. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  282. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  283. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  284. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  285. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  286. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  287. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  288. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  289. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  290. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  291. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  292. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  293. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  294. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  295. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  296. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  297. package/dist/knowledge/references/experience-plan.config.md +76 -7
  298. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
  299. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  300. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  301. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
  302. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  303. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
  304. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  305. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
  306. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
  307. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
  308. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  309. package/dist/knowledge/references/integration-plan.config.md +21 -1
  310. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  311. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  312. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  313. package/dist/knowledge/references/placement-plan.config.md +107 -2
  314. package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
  315. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
  316. package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
  317. package/dist/knowledge/references/platform.config.saas.md +106 -14
  318. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  319. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  320. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  321. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  322. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  323. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  324. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  325. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  326. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  327. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  328. package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
  329. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  330. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  331. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  332. package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
  333. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  334. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  335. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  336. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  337. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  338. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  339. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
  340. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
  341. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
  342. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  343. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  344. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  345. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  346. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  347. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  348. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  349. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  350. package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
  351. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  352. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  353. package/dist/knowledge/references/saas.backend.email.send.md +84 -0
  354. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
  355. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  356. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  357. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  358. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  359. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  360. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
  361. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
  363. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
  364. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  365. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  366. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  367. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  368. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  369. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
  370. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  371. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  372. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  373. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  374. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  375. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  376. package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
  377. package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
  378. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
  380. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  381. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  382. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  383. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  384. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  385. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  386. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  387. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  388. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  389. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  390. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  391. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  392. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  393. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  394. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
  395. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  396. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  397. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  398. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
  399. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  400. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  401. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  402. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
  403. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
  404. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
  405. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  406. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  407. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
  408. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  409. package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
  410. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
  411. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
  412. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
  413. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  414. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
  415. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
  416. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  417. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  418. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  419. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  420. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  421. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  422. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  423. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  424. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  425. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  426. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  427. package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
  428. package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
  429. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  430. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  431. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  432. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  433. package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
  434. package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
  435. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
  436. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  437. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
  438. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
  439. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
  440. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
  441. package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
  442. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  443. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  444. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  445. package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
  446. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  447. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
  448. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  449. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  450. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
  451. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  452. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  453. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  454. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  455. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
  456. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
  457. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  458. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
  459. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  460. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
  461. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  462. package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
  463. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  464. package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
  465. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  466. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  467. package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
  468. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  469. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  470. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  471. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  472. package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
  473. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
  474. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  475. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  476. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
  477. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
  478. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  479. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  480. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
  481. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  482. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  483. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  484. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  485. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
  486. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
  487. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
  488. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
  489. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
  490. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  491. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
  492. package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
  493. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  494. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  495. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
  496. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
  497. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  498. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  499. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  500. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  501. package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
  502. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
  503. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  504. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
  505. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  506. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  507. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  508. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  509. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  510. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
  511. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  512. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  513. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  514. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  515. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  516. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  517. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
  518. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  519. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
  520. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  521. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  522. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  523. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  524. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  525. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  526. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  527. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
  528. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  529. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
  530. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
  531. package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
  532. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  533. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  534. package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
  535. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  536. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  537. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
  538. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  539. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
  540. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
  541. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  542. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  543. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  544. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  545. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
  546. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  547. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
  548. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  549. package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
  550. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  551. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  552. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  553. package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
  554. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  555. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  556. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
  557. package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
  558. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  559. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  560. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  561. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  562. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  563. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  564. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  565. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  566. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  567. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  568. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  569. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  570. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  571. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  572. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  573. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  574. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  575. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  576. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  577. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  578. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  579. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  580. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  581. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  582. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  583. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  584. package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
  585. package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
  586. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  587. package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
  588. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  589. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  590. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  591. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  592. package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
  593. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
  594. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  595. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  596. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
  597. package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
  598. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  599. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  600. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  601. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  602. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  603. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  604. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  605. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  606. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  607. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  608. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  609. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  610. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  611. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  612. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  613. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  614. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  615. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  616. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  617. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  618. package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
  619. package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
  620. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  621. package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
  622. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  623. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  624. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  625. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  626. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  627. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  628. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  629. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  630. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  631. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  632. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  633. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  634. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  635. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  636. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  637. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  638. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  639. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  640. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  641. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  642. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  643. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  644. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  645. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  646. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  647. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  648. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  649. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  650. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  651. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  652. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  653. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  654. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  655. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  656. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  657. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  658. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  659. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  660. package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
  661. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  662. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  663. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  664. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  665. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  666. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  667. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  668. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  669. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  670. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  671. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  672. package/dist/knowledge/references/service-method.config.md +270 -0
  673. package/dist/knowledge/references/website-plan.config.md +561 -23
  674. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  675. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  676. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  677. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  678. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
  679. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  680. package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
  681. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
  682. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
  683. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  684. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  685. package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
  686. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  687. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  688. package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
  689. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
  690. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
  691. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
  692. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
  693. package/dist/knowledge/references/zod.factories.code.md +18 -8
  694. package/dist/knowledge/references/zod.factories.duration.md +23 -13
  695. package/dist/knowledge/references/zod.factories.money.md +24 -14
  696. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  697. package/dist/knowledge/references/zod.factories.range.md +5 -1
  698. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  699. package/dist/knowledge/registries/framework-topics.json +2854 -246
  700. package/dist/knowledge/registries/playbooks.json +57 -36
  701. package/dist/knowledge/registries/source-tags.json +8863 -4569
  702. package/dist/knowledge/rules/database-migration-obligation.md +11 -5
  703. package/dist/knowledge/rules/live-context-door.md +1 -1
  704. package/dist/knowledge/skills/INDEX.md +63 -34
  705. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  706. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
  707. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  708. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  709. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  710. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  711. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  712. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
  713. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  714. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  715. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  716. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
  717. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  718. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  719. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  720. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  721. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  722. package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
  723. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  724. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  725. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  726. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  727. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
  728. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
  729. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
  730. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  731. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
  732. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
  733. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  734. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  735. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
  736. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  737. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  738. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  739. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
  740. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  741. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  742. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
  743. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  744. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  745. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  746. package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
  747. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
  748. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
  749. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
  750. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
  751. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  752. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  753. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
  754. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  755. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  756. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
  757. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  758. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
  759. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
  760. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  761. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
  762. package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
  763. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  764. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  765. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  766. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  767. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
  768. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
  769. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  770. package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
  771. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  772. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  773. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  774. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  775. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
  776. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
  777. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  778. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  779. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  780. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  781. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
  782. package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
  783. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
  784. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
  785. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
  786. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  787. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
  788. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
  789. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
  790. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
  791. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
  792. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  793. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
  794. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
  795. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  796. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  797. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
  798. package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
  799. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
  800. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  801. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  802. package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
  803. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  804. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
  805. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  806. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  807. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  808. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  809. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  810. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
  811. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
  812. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
  813. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  814. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
  815. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  816. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  817. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  818. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
  819. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
  820. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
  821. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
  822. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
  823. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
  824. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  825. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
  826. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
  827. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
  828. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
  829. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
  830. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  831. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  832. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
  833. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  834. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
  835. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
  836. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  837. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
  838. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
  839. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
  840. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  841. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
  842. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
  843. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
  844. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  845. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  846. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  847. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  848. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
  849. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
  850. package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
  851. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
  852. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
  853. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  854. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
  855. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  856. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
  857. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
  858. package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
  859. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
  860. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
  861. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
  862. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  863. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  864. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  865. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  866. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  867. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  868. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  869. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  870. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  871. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  872. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
  873. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
  874. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  875. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  876. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  877. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  878. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  879. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  880. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
  881. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
  882. package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
  883. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
  884. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  885. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  886. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  887. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  888. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  889. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  890. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  891. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
  892. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  893. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  894. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  895. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
  896. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
  897. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  898. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  899. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
  900. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  901. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
  902. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
  903. package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
  904. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  905. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  906. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
  907. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  908. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  909. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
  910. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
  911. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
  912. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  913. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  914. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  915. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  916. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
  917. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  918. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  919. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
  920. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  921. package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
  922. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
  923. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  924. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
  925. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
  926. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
  927. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
  928. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  929. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
  930. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
  931. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
  932. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  933. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  934. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
  935. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  936. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  937. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  938. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  939. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  940. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
  941. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
  942. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  943. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  944. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  945. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
  946. package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
  947. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
  948. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
  949. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  950. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
  951. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  952. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  953. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
  954. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
  955. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
  956. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
  957. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
  958. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  959. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  960. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  961. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
  962. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
  963. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
  964. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
  965. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
  966. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  967. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  968. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
  969. package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
  970. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  971. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  972. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
  973. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  974. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
  975. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
  976. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  977. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
  978. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  979. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  980. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
  981. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  982. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  983. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
  984. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  985. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  986. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
  987. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
  988. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  989. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  990. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
  991. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
  992. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
  993. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
  994. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
  995. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
  996. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  997. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
  998. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  999. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  1000. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
  1001. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  1002. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
  1003. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
  1004. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
  1005. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
  1006. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
  1007. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  1008. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
  1009. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
  1010. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  1011. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  1012. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  1013. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
  1014. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
  1015. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
  1016. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  1017. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  1018. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
  1019. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  1020. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  1021. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
  1022. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
  1023. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
  1024. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
  1025. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
  1026. package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
  1027. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  1028. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  1029. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
  1030. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  1031. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  1032. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  1033. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
  1034. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
  1035. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
  1036. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  1037. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  1038. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  1039. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
  1040. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  1041. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
  1042. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  1043. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  1044. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  1045. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
  1046. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  1047. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  1048. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
  1049. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
  1050. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
  1051. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  1052. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  1053. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  1054. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
  1055. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  1056. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
  1057. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
  1058. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
  1059. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
  1060. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
  1061. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
  1062. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  1063. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  1064. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  1065. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  1066. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  1067. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
  1068. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  1069. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
  1070. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
  1071. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
  1072. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
  1073. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  1074. package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
  1075. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
  1076. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
  1077. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  1078. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  1079. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  1080. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
  1081. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  1082. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
  1083. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  1084. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
  1085. package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
  1086. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  1087. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
  1088. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  1089. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  1090. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  1091. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
  1092. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  1093. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  1094. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  1095. package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
  1096. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  1097. package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
  1098. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  1099. package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
  1100. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1101. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1102. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
  1103. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1104. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
  1105. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1106. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
  1107. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1108. package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
  1109. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1110. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1111. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1112. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1113. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1114. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1115. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1116. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1117. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1118. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1119. package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
  1120. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
  1121. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1122. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
  1123. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1124. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1125. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1126. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1127. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1128. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1129. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1130. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1131. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1132. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1133. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1134. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
  1135. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1136. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1137. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1138. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1139. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1140. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1141. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1142. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1143. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
  1144. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
  1145. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
  1146. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
  1147. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1148. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1149. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1150. package/dist/knowledge/topic-index.json +17305 -8263
  1151. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1152. package/package.json +4 -4
  1153. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1154. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1155. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1156. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1157. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1158. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1159. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1160. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1161. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1162. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1163. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
@@ -0,0 +1,1562 @@
1
+ # Motion vocabulary — API (source-backed)
2
+
3
+ The closed vocabulary, the site-wide tokens, what each tempo stands for, the per-element helper, and the
4
+ stylesheet the page layout renders from them. Read it when you need the exact members or values.
5
+
6
+ ## The vocabulary
7
+
8
+ ## Import Origins
9
+
10
+ - `@wildo-ai/saas-website`
11
+
12
+ ## Source Excerpts
13
+
14
+ ### Origin Package: `@wildo-ai/saas-website`
15
+
16
+ ```typescript
17
+ /**
18
+ * The site's motion character — the SAME enum object as the application theme's `ThemeMotion` (an alias, never a
19
+ * copy), named here so a website declares its tempo without importing the theme models:
20
+ * the personality's `motion` axis in `composeWebsiteDesignTokens({ personality: { …, motion: WebsiteMotionTempo.FLUID } })`,
21
+ * or `motion: { tempo }` beside it. One brand, one motion axis, two surfaces.
22
+ */
23
+ export const WebsiteMotionTempo: typeof ThemeMotion = ThemeMotion;
24
+ export type WebsiteMotionTempo = ThemeMotion;
25
+
26
+ /**
27
+ * How an element arrives. Applied on scroll (`IN_VIEW`, the default) or at page load (`LOAD`, the hero's
28
+ * signature entrance). Every value animates FROM the hidden state TO the element's own styles, so the element's
29
+ * authored layout is the end state and nothing has to be re-declared.
30
+ */
31
+ export enum WebsiteMotionReveal {
32
+ /** No entrance. The default for anything not named: most content should simply be there. */
33
+ NONE = 'none',
34
+ /** Opacity only. The quietest reveal; the right one for large text blocks and anything a reader must not chase. */
35
+ FADE = 'fade',
36
+ /** Fade while travelling up by the tempo's distance. The workhorse for headings, cards and list items. */
37
+ RISE = 'rise',
38
+ /** Fade while growing from 94%. For product shots, device frames and bento tiles — objects, not text. */
39
+ SCALE = 'scale',
40
+ /** Fade from a soft blur while rising half the distance. For a hero headline or a single statement line. */
41
+ BLUR = 'blur',
42
+ /** A top-to-bottom clip that uncovers the element while it settles from 106%. Media only: images, video, art. */
43
+ UNVEIL = 'unveil',
44
+ }
45
+
46
+ /** When a reveal plays. */
47
+ export enum WebsiteMotionTrigger {
48
+ /** As the element scrolls into view (CSS view timeline). Scrubbed by scrolling, so it is never "missed". */
49
+ IN_VIEW = 'in-view',
50
+ /**
51
+ * Once, as the page loads, ordered by `order` (1–8). This is the page's SIGNATURE moment: use it on the hero's
52
+ * elements and nowhere else — a single orchestrated entrance lands; one on every section reads as generated.
53
+ */
54
+ LOAD = 'load',
55
+ }
56
+
57
+ /** A scroll-linked effect, scrubbed by the visitor's own scrolling. Never pins or hijacks the scroll. */
58
+ export enum WebsiteMotionScrollEffect {
59
+ NONE = 'none',
60
+ /**
61
+ * The element drifts against the scroll (±4% of its height, slightly enlarged so its edges never show). Put it on
62
+ * media INSIDE a frame that clips with `overflow: clip`, never on text — moving text is hard to read. Not
63
+ * `overflow: hidden`: that makes the frame a scroll container, the element's view timeline then tracks the frame
64
+ * (which never scrolls) instead of the page, and the media never moves.
65
+ */
66
+ PARALLAX = 'parallax',
67
+ /** The element settles from 92% to full size and opacity as it enters — Apple's product-shot arrival. */
68
+ ZOOM = 'zoom',
69
+ }
70
+
71
+ /** Feedback to a pointer resting on (or keyboard focus reaching) an interactive card. Pointer devices only. */
72
+ export enum WebsiteMotionHover {
73
+ NONE = 'none',
74
+ /** Rises 3px and casts a soft shadow. For cards that are links. Under reduced motion it keeps the shadow only. */
75
+ LIFT = 'lift',
76
+ /** A primary-coloured ring and halo. For feature tiles and plan cards on dark or vivid surfaces. */
77
+ GLOW = 'glow',
78
+ }
79
+
80
+ /** How one page hands over to the next when the visitor follows an internal link. */
81
+ export enum WebsitePageTransition {
82
+ /** An ordinary navigation. */
83
+ NONE = 'none',
84
+ /**
85
+ * A cross-document View Transition: the old page cross-fades into the new one while the site header stays put.
86
+ * Browsers without cross-document view transitions simply navigate.
87
+ */
88
+ CROSS_FADE = 'cross-fade',
89
+ }
90
+ ```
91
+
92
+ ## Site-wide tokens (`designTokens.motion`)
93
+
94
+ ## Import Origins
95
+
96
+ - `@wildo-ai/saas-website`
97
+
98
+ ## Source Excerpts
99
+
100
+ ### Origin Package: `@wildo-ai/saas-website`
101
+
102
+ ```typescript
103
+ *
104
+ * `WebsiteMotionTokens` — the site's motion character, on `WebsiteRootConfig.designTokens.motion`.
105
+ *
106
+ * Two site-wide choices; everything per element is `websiteMotion(...)`.
107
+ * - `tempo` — the brand's `ThemeMotion`, the SAME axis the application theme uses. Prefer the value the brand
108
+ * derives (`deriveThemePersonality(brand.visualTone).motion`) so the application and its site move alike.
109
+ * Omitted, the default theme's `BRISK`.
110
+ * - `pageTransition` — omitted, `CROSS_FADE`.
111
+ *
112
+ * Optional on the token bundle, so a site authored before motion existed keeps rendering; read it through
113
+ * `resolveWebsiteMotionTokens`, which applies the defaults in one place.
114
+ */
115
+ const _WebsiteMotionTokensSchema = z.strictObject({
116
+ tempo: z.enum(ThemeMotion).optional(),
117
+ pageTransition: z.enum(WebsitePageTransition).optional(),
118
+ });
119
+
120
+ export const WebsiteMotionTokensSchema: typeof _WebsiteMotionTokensSchema = _WebsiteMotionTokensSchema;
121
+
122
+ export type WebsiteMotionTokens = z.infer<typeof _WebsiteMotionTokensSchema>;
123
+
124
+ /** The motion tokens with every default applied. */
125
+ export interface ResolvedWebsiteMotionTokens {
126
+ readonly tempo: ThemeMotion;
127
+ readonly pageTransition: WebsitePageTransition;
128
+ }
129
+
130
+ /** The defaults, in one place: the default theme's tempo, and a cross-fade between pages. */
131
+ export function resolveWebsiteMotionTokens(tokens: WebsiteMotionTokens | undefined): ResolvedWebsiteMotionTokens {
132
+ return {
133
+ tempo: tokens?.tempo ?? ThemeMotion.BRISK,
134
+ pageTransition: tokens?.pageTransition ?? WebsitePageTransition.CROSS_FADE,
135
+ };
136
+ }
137
+ ```
138
+
139
+ ## What each tempo stands for
140
+
141
+ ## Import Origins
142
+
143
+ - `@wildo-ai/saas-website`
144
+
145
+ ## Source Excerpts
146
+
147
+ ### Origin Package: `@wildo-ai/saas-website`
148
+
149
+ ```typescript
150
+ *
151
+ * What each tempo means in numbers. Total over `ThemeMotion`, so a tempo added to the axis does not compile until
152
+ * it is given values here.
153
+ *
154
+ * Sources for the curves (cubic-bezier control points):
155
+ * - CRISP uses IBM Carbon's PRODUCTIVE entrance / exit / standard curves — "efficiency and responsiveness".
156
+ * - BRISK uses Material 3's STANDARD decelerate / accelerate / standard curves.
157
+ * - FLUID uses Material 3's EMPHASIZED decelerate / accelerate curves — Carbon's "expressive" register.
158
+ * - SPRINGY keeps FLUID's clock and moves on `WEBSITE_MOTION_SPRING_EASING` — but a spring only ever moves things in
159
+ * space: Material 3 Expressive never springs opacity or colour, and neither do we. Its effect easings (opacity,
160
+ * blur, clip, colour) are FLUID's curves, and its exit stays a curve.
161
+ * Durations sit inside the ranges Atlassian and Primer publish for interface motion (micro ≈ 100ms, short ≈ 200ms,
162
+ * medium ≈ 300–500ms); `durationLong` is spent on one-off movements only: the signature entrance, and a stat's count-up
163
+ * (`WebsiteCountUp`, 1.7 × it), once per figure as it comes into view.
164
+ */
165
+ export const WEBSITE_MOTION_TEMPO: Readonly<Record<ThemeMotion, WebsiteMotionTempoValues>> = {
166
+ [ThemeMotion.STILL]: {
167
+ durationMicro: '0ms',
168
+ durationShort: '0ms',
169
+ durationMedium: '0ms',
170
+ durationLong: '0ms',
171
+ easeEnter: 'linear',
172
+ easeExit: 'linear',
173
+ easeMove: 'linear',
174
+ easeEnterEffect: 'linear',
175
+ easeMoveEffect: 'linear',
176
+ distance: '0px',
177
+ step: '0ms',
178
+ playsChoreography: false,
179
+ },
180
+ [ThemeMotion.CRISP]: {
181
+ durationMicro: '90ms',
182
+ durationShort: '160ms',
183
+ durationMedium: '260ms',
184
+ durationLong: '420ms',
185
+ easeEnter: 'cubic-bezier(0, 0, 0.38, 0.9)',
186
+ easeExit: 'cubic-bezier(0.2, 0, 1, 0.9)',
187
+ easeMove: 'cubic-bezier(0.2, 0, 0.38, 0.9)',
188
+ easeEnterEffect: 'cubic-bezier(0, 0, 0.38, 0.9)',
189
+ easeMoveEffect: 'cubic-bezier(0.2, 0, 0.38, 0.9)',
190
+ distance: '0.75rem',
191
+ step: '40ms',
192
+ playsChoreography: true,
193
+ },
194
+ [ThemeMotion.BRISK]: {
195
+ durationMicro: '120ms',
196
+ durationShort: '200ms',
197
+ durationMedium: '360ms',
198
+ durationLong: '620ms',
199
+ easeEnter: 'cubic-bezier(0, 0, 0, 1)',
200
+ easeExit: 'cubic-bezier(0.3, 0, 1, 1)',
201
+ easeMove: 'cubic-bezier(0.2, 0, 0, 1)',
202
+ easeEnterEffect: 'cubic-bezier(0, 0, 0, 1)',
203
+ easeMoveEffect: 'cubic-bezier(0.2, 0, 0, 1)',
204
+ distance: '1rem',
205
+ step: '60ms',
206
+ playsChoreography: true,
207
+ },
208
+ [ThemeMotion.FLUID]: {
209
+ durationMicro: '160ms',
210
+ durationShort: '280ms',
211
+ durationMedium: '480ms',
212
+ durationLong: '820ms',
213
+ easeEnter: 'cubic-bezier(0.05, 0.7, 0.1, 1)',
214
+ easeExit: 'cubic-bezier(0.3, 0, 0.8, 0.15)',
215
+ easeMove: 'cubic-bezier(0.2, 0, 0, 1)',
216
+ easeEnterEffect: 'cubic-bezier(0.05, 0.7, 0.1, 1)',
217
+ easeMoveEffect: 'cubic-bezier(0.2, 0, 0, 1)',
218
+ distance: '1.25rem',
219
+ step: '80ms',
220
+ playsChoreography: true,
221
+ },
222
+ [ThemeMotion.SPRINGY]: {
223
+ durationMicro: '160ms',
224
+ durationShort: '280ms',
225
+ durationMedium: '480ms',
226
+ durationLong: '820ms',
227
+ easeEnter: WEBSITE_MOTION_SPRING_EASING,
228
+ easeExit: 'cubic-bezier(0.3, 0, 0.8, 0.15)',
229
+ easeMove: WEBSITE_MOTION_SPRING_EASING,
230
+ easeEnterEffect: 'cubic-bezier(0.05, 0.7, 0.1, 1)',
231
+ easeMoveEffect: 'cubic-bezier(0.2, 0, 0, 1)',
232
+ distance: '1.25rem',
233
+ step: '70ms',
234
+ playsChoreography: true,
235
+ },
236
+ };
237
+ ```
238
+
239
+ ## How each tempo renders a reveal
240
+
241
+ ## Import Origins
242
+
243
+ - `@wildo-ai/saas-website`
244
+
245
+ ## Source Excerpts
246
+
247
+ ### Origin Package: `@wildo-ai/saas-website`
248
+
249
+ ```typescript
250
+ *
251
+ * How each tempo renders each reveal a block or a site asks for (#2742 step 4): the motion stylesheet plays the
252
+ * rendition, so one block definition reads right on every brand. Total over the tempos and the reveals, so neither can
253
+ * grow without a decision.
254
+ *
255
+ * This is Wildo's own decision, one reason per tempo. A reveal says something about what arrives: a fade that it is
256
+ * here, a rise where it comes from, a scale its size, an unveil its extent. A blur says nothing about it, and draws
257
+ * the eye to the effect itself.
258
+ * - FLUID and SPRINGY play every reveal as asked: they are the expressive tempos, with the longest clock and travel
259
+ * (`WEBSITE_MOTION_TEMPO`), and an effect is part of what they express.
260
+ * - CRISP plays only a fade and a rise, and renders a scale, a blur and an unveil as a FADE. It is the tempo of
261
+ * efficiency (the shortest clock and travel), and a change of size, focus or clip is attention it does not spend.
262
+ * - BRISK keeps the reveals that describe the element (a scale, an unveil) and renders a BLUR as a RISE, the nearest
263
+ * reveal that still moves.
264
+ * - STILL plays nothing, so its renditions are never read; they are the identity.
265
+ * Rejected: a rendition per section kind (the same card grid serves several section kinds), and leaving the choice to
266
+ * each block (it would have to know the brand's tempo, which a block never reads).
267
+ */
268
+ export const WEBSITE_MOTION_REVEAL_RENDITIONS: Readonly<Record<ThemeMotion, Readonly<Record<WebsiteAnimatedReveal, WebsiteAnimatedReveal>>>> = {
269
+ [ThemeMotion.STILL]: {
270
+ [WebsiteMotionReveal.FADE]: WebsiteMotionReveal.FADE,
271
+ [WebsiteMotionReveal.RISE]: WebsiteMotionReveal.RISE,
272
+ [WebsiteMotionReveal.SCALE]: WebsiteMotionReveal.SCALE,
273
+ [WebsiteMotionReveal.BLUR]: WebsiteMotionReveal.BLUR,
274
+ [WebsiteMotionReveal.UNVEIL]: WebsiteMotionReveal.UNVEIL,
275
+ },
276
+ [ThemeMotion.CRISP]: {
277
+ [WebsiteMotionReveal.FADE]: WebsiteMotionReveal.FADE,
278
+ [WebsiteMotionReveal.RISE]: WebsiteMotionReveal.RISE,
279
+ [WebsiteMotionReveal.SCALE]: WebsiteMotionReveal.FADE,
280
+ [WebsiteMotionReveal.BLUR]: WebsiteMotionReveal.FADE,
281
+ [WebsiteMotionReveal.UNVEIL]: WebsiteMotionReveal.FADE,
282
+ },
283
+ [ThemeMotion.BRISK]: {
284
+ [WebsiteMotionReveal.FADE]: WebsiteMotionReveal.FADE,
285
+ [WebsiteMotionReveal.RISE]: WebsiteMotionReveal.RISE,
286
+ [WebsiteMotionReveal.SCALE]: WebsiteMotionReveal.SCALE,
287
+ [WebsiteMotionReveal.BLUR]: WebsiteMotionReveal.RISE,
288
+ [WebsiteMotionReveal.UNVEIL]: WebsiteMotionReveal.UNVEIL,
289
+ },
290
+ [ThemeMotion.FLUID]: {
291
+ [WebsiteMotionReveal.FADE]: WebsiteMotionReveal.FADE,
292
+ [WebsiteMotionReveal.RISE]: WebsiteMotionReveal.RISE,
293
+ [WebsiteMotionReveal.SCALE]: WebsiteMotionReveal.SCALE,
294
+ [WebsiteMotionReveal.BLUR]: WebsiteMotionReveal.BLUR,
295
+ [WebsiteMotionReveal.UNVEIL]: WebsiteMotionReveal.UNVEIL,
296
+ },
297
+ [ThemeMotion.SPRINGY]: {
298
+ [WebsiteMotionReveal.FADE]: WebsiteMotionReveal.FADE,
299
+ [WebsiteMotionReveal.RISE]: WebsiteMotionReveal.RISE,
300
+ [WebsiteMotionReveal.SCALE]: WebsiteMotionReveal.SCALE,
301
+ [WebsiteMotionReveal.BLUR]: WebsiteMotionReveal.BLUR,
302
+ [WebsiteMotionReveal.UNVEIL]: WebsiteMotionReveal.UNVEIL,
303
+ },
304
+ };
305
+ ```
306
+
307
+ ## Per element: `websiteMotion(...)`
308
+
309
+ ## Import Origins
310
+
311
+ - `@wildo-ai/saas-website`
312
+
313
+ ## Source Excerpts
314
+
315
+ ### Origin Package: `@wildo-ai/saas-website`
316
+
317
+ ```typescript
318
+ *
319
+ * What one element asks of the motion vocabulary. Every field is optional; an element that names nothing does not
320
+ * move. `reveal` and `stagger` are exclusive by type: an element either arrives itself or sequences its children.
321
+ * `reveal` and `scroll` are exclusive too: a scroll effect is an animation of the element itself, so on a revealed
322
+ * element it would replace a scroll reveal, or turn a page-load entrance into a scrubbed one. Reveal the frame and
323
+ * put the scroll effect on the media inside it.
324
+ */
325
+ export type WebsiteMotionSpec =
326
+ | {
327
+ /** How this element arrives. */
328
+ readonly reveal: WebsiteMotionReveal;
329
+ /** When. Defaults to `IN_VIEW`. */
330
+ readonly trigger?: WebsiteMotionTrigger;
331
+ /**
332
+ * Position in the page-load sequence, 1–8. Only meaningful with `trigger: LOAD`; ignored otherwise. Order the
333
+ * hero the way it is read: eyebrow 1, headline 2, lead 3, actions 4, visual 5.
334
+ */
335
+ readonly order?: number;
336
+ readonly stagger?: never;
337
+ readonly scroll?: never;
338
+ readonly hover?: WebsiteMotionHover;
339
+ }
340
+ | {
341
+ readonly reveal?: never;
342
+ readonly trigger?: never;
343
+ readonly order?: never;
344
+ /**
345
+ * Reveal the element's CHILDREN one after another, in DOM order, as they scroll into view. Put it on the
346
+ * list or grid, not on each card. Children beyond the eighth share the eighth's offset.
347
+ */
348
+ readonly stagger?: WebsiteMotionReveal;
349
+ readonly scroll?: WebsiteMotionScrollEffect;
350
+ readonly hover?: WebsiteMotionHover;
351
+ };
352
+
353
+ /** The data attributes `websiteMotion` returns, typed so a spread onto any JSX element type-checks. */
354
+ export type WebsiteMotionAttributes = Readonly<Partial<Record<`data-website-${string}`, string>>>;
355
+
356
+ /** The highest load order and stagger index the stylesheet distinguishes. */
357
+ export const WEBSITE_MOTION_MAX_SEQUENCE = 8;
358
+
359
+ /**
360
+ * The data attributes that ask the engine's motion stylesheet for an effect. Spread them onto the element; never
361
+ * spell the attributes by hand, so a renamed attribute cannot strand a site.
362
+ *
363
+ * Throws on an `order` outside 1–8: a ninth step in a page-load sequence is a choreography problem, not a value
364
+ * to clamp.
365
+ *
366
+ * @example
367
+ * <h1 {...websiteMotion({ reveal: WebsiteMotionReveal.BLUR, trigger: WebsiteMotionTrigger.LOAD, order: 2 })}>…</h1>
368
+ * <ul {...websiteMotion({ stagger: WebsiteMotionReveal.RISE })}>…</ul>
369
+ * <a className="card" {...websiteMotion({ hover: WebsiteMotionHover.LIFT })}>…</a>
370
+ */
371
+ export function websiteMotion(spec: WebsiteMotionSpec): WebsiteMotionAttributes {
372
+ /*
373
+ * Read through one widened view: the exclusive union is the CALLER's contract, and this package compiles without
374
+ * strictNullChecks, where narrowing the union member by member collapses it to `never`.
375
+ */
376
+ const { reveal, trigger, order, stagger, scroll, hover } = spec as {
377
+ readonly reveal?: WebsiteMotionReveal;
378
+ readonly trigger?: WebsiteMotionTrigger;
379
+ readonly order?: number;
380
+ readonly stagger?: WebsiteMotionReveal;
381
+ readonly scroll?: WebsiteMotionScrollEffect;
382
+ readonly hover?: WebsiteMotionHover;
383
+ };
384
+ const attributes: Record<string, string> = {};
385
+ const reveals = reveal !== undefined && reveal !== WebsiteMotionReveal.NONE;
386
+ const resolvedTrigger = trigger ?? WebsiteMotionTrigger.IN_VIEW;
387
+ const scrolls = scroll !== undefined && scroll !== WebsiteMotionScrollEffect.NONE;
388
+ if (scrolls && reveals) {
389
+ // A scroll effect animates the element itself: it would replace a scroll reveal, and hijack a page-load entrance
390
+ // into a scrubbed animation whose own keyframes never play (measured in Chromium).
391
+ throw new Error(
392
+ 'websiteMotion: an element cannot both reveal and carry a scroll effect — the two animations would compete for ' +
393
+ 'the same element. Reveal the frame and put the scroll effect on the media inside it.',
394
+ );
395
+ }
396
+ if (reveals) {
397
+ attributes['data-website-reveal'] = reveal;
398
+ attributes['data-website-reveal-trigger'] = resolvedTrigger;
399
+ if (resolvedTrigger === WebsiteMotionTrigger.LOAD) {
400
+ const position = order ?? 1;
401
+ if (!Number.isInteger(position) || position < 1 || position > WEBSITE_MOTION_MAX_SEQUENCE) {
402
+ throw new Error(
403
+ `websiteMotion: a load entrance order must be an integer from 1 to ${WEBSITE_MOTION_MAX_SEQUENCE}, got ${String(position)}. ` +
404
+ 'A page has one signature entrance; sequence its hero in at most eight steps.',
405
+ );
406
+ }
407
+ attributes['data-website-reveal-order'] = String(position);
408
+ }
409
+ }
410
+ if (stagger !== undefined && stagger !== WebsiteMotionReveal.NONE) {
411
+ attributes['data-website-stagger'] = stagger;
412
+ }
413
+ if (scrolls) {
414
+ attributes['data-website-scroll'] = scroll;
415
+ }
416
+ if (hover !== undefined && hover !== WebsiteMotionHover.NONE) {
417
+ attributes['data-website-hover'] = hover;
418
+ }
419
+ return attributes;
420
+ }
421
+ ```
422
+
423
+ ## The stylesheet it renders to
424
+
425
+ ## Import Origins
426
+
427
+ - `@wildo-ai/saas-website`
428
+
429
+ ## Source Excerpts
430
+
431
+ ### Origin Package: `@wildo-ai/saas-website`
432
+
433
+ ```typescript
434
+ *
435
+ * The one stylesheet the motion vocabulary renders to. `WebsitePageLayout` emits it at the top of every page, so
436
+ * a site needs no import, no script and no per-route edit to move.
437
+ *
438
+ * Its structure is the contract:
439
+ * 1. `:root` custom properties — the tempo's durations, curves, distance and step. Always emitted, even for
440
+ * `STILL`, so an application's own CSS can time its transitions on `var(--website-motion-duration-short)`.
441
+ * 2. Everything that MOVES sits inside `@media (prefers-reduced-motion: no-preference)` — the no-motion-first
442
+ * pattern. A visitor who asked for less motion gets the final layout, with nothing hidden.
443
+ * 3. In-view reveals and scroll effects additionally sit inside `@supports (animation-timeline: view())`. Their
444
+ * hidden FROM state only ever applies where a scroll timeline will play it back; a browser without one shows the
445
+ * content as authored.
446
+ * 4. The page-load entrance is time-based and needs no support check.
447
+ * 5. Hover feedback applies to fine pointers only (`(hover: hover) and (pointer: fine)`), and keyboard focus
448
+ * reaching the card earns the same feedback.
449
+ *
450
+ * In-view ranges are PERCENTAGES of the element's entry, never lengths: an element can always fully enter the
451
+ * viewport (the document's last element enters as the page bottoms out), so a percentage range always completes,
452
+ * where a length range could leave a short element at the foot of the page half-transparent forever.
453
+ */
454
+ export function renderWebsiteMotionStylesheet(tokens: WebsiteMotionTokens | undefined): string {
455
+ const resolved = resolveWebsiteMotionTokens(tokens);
456
+ const tempo = WEBSITE_MOTION_TEMPO[resolved.tempo];
457
+ // Each requested reveal is played as the tempo renders it (`WEBSITE_MOTION_REVEAL_RENDITIONS`).
458
+ const renditions = WEBSITE_MOTION_REVEAL_RENDITIONS[resolved.tempo];
459
+ const blocks: string[] = [];
460
+
461
+ const customProperties = (Object.values(WebsiteMotionCssToken) as WebsiteMotionCssToken[]).map(
462
+ (token) => ` ${websiteMotionCssProperty(token)}: ${tempo[WEBSITE_MOTION_CSS_TOKEN_SOURCE[token]]};`,
463
+ );
464
+ blocks.push([':root {', ...customProperties, '}'].join('\n'));
465
+
466
+ blocks.push(renderHoverRules());
467
+
468
+ blocks.push(renderMotionDemoRules(tempo.playsChoreography));
469
+
470
+ if (tempo.playsChoreography) {
471
+ blocks.push(
472
+ [
473
+ '@media (prefers-reduced-motion: no-preference) {',
474
+ ...revealKeyframesRules(),
475
+ renderLoadEntranceRules(renditions),
476
+ '@supports (animation-timeline: view()) {',
477
+ renderInViewRevealRules(renditions),
478
+ renderScrollEffectRules(),
479
+ '}',
480
+ '}',
481
+ ].join('\n'),
482
+ );
483
+ }
484
+
485
+ if (resolved.pageTransition === WebsitePageTransition.CROSS_FADE) {
486
+ blocks.push(
487
+ [
488
+ '@media (prefers-reduced-motion: no-preference) {',
489
+ '@view-transition { navigation: auto; }',
490
+ // Every named view transition, not only the page's: the site header names its own (so it stays put), and an
491
+ // application may name more. The group moves AND resizes and the snapshots fade, so all play on the effect
492
+ // easing, on the tempo's clock (a zero duration under STILL).
493
+ '::view-transition-group(*), ::view-transition-old(*), ::view-transition-new(*) {',
494
+ ` animation-duration: ${websiteMotionCssVar(WebsiteMotionCssToken.DURATION_MEDIUM)};`,
495
+ ` animation-timing-function: ${websiteMotionCssVar(WebsiteMotionCssToken.EASE_MOVE_EFFECT)};`,
496
+ '}',
497
+ '}',
498
+ ].join('\n'),
499
+ );
500
+ }
501
+
502
+ return blocks.join('\n');
503
+ }
504
+ ```
505
+
506
+ ## Drawn demos: the frame, its pause control and the scenario clock
507
+
508
+ `WebsiteMotionDemo`, `WebsiteMotionDemoGroup`, `WebsiteMotionDemoStage`, `useWebsiteMotionDemoPlaying` and
509
+ `useWebsiteMotionDemoTimeline`:
510
+
511
+ ## Import Origins
512
+
513
+ - `@wildo-ai/saas-website`
514
+
515
+ ## Source Excerpts
516
+
517
+ ### Origin Package: `@wildo-ai/saas-website`
518
+
519
+ ```tsx
520
+ *
521
+ * `WebsiteMotionDemo` — the frame around an ANIMATED PRODUCT DEMO: a drawn interface that plays on its own (a task
522
+ * list completing itself, an invoice assembling, an agent answering). Modern product sites show the product moving;
523
+ * this primitive owns the obligations that come with it, so a section only draws the interface and its keyframes.
524
+ *
525
+ * What it guarantees:
526
+ * - **A pause control** (WCAG 2.2.2 "Pause, Stop, Hide": content that moves on its own for more than five seconds,
527
+ * beside other content, must be pausable). A real `<button>` whose text says what it will do — `pauseLabel` while
528
+ * playing, `playLabel` while paused — so its name is the action, never a pressed state that contradicts it.
529
+ * - **Paused while off screen.** An IntersectionObserver marks the frame `data-website-demo-offscreen`, and the
530
+ * engine's motion stylesheet pauses every keyframe animation inside it. A page with six demos animates only what is
531
+ * seen. Paused — by the visitor or off screen — a demo HOLDS what it shows, as a paused video does, and resumes
532
+ * from there.
533
+ * - **A still frame under reduced motion, or a STILL tempo.** The stylesheet removes the stage's animations
534
+ * (`prefers-reduced-motion: reduce`, or a site whose tempo plays no choreography) and hides the control, since
535
+ * there is nothing to pause. So AUTHOR THE STAGE'S BASE STYLES AS THE FINAL STILL FRAME and let the keyframes only
536
+ * add movement: the no-motion-first pattern every other motion rule here follows. A scenario driven by
537
+ * `useWebsiteMotionDemoTimeline` shows its last step, also when the preference changes while the page is open.
538
+ * - **One accessible description instead of fake UI read aloud.** The drawn interface is decorative to a screen
539
+ * reader (`aria-hidden`), and `label` names what it shows (`<figure aria-label>`), the way an image's `alt` would.
540
+ *
541
+ * Demos driven by JavaScript (a tab rotation, a typed message) read `useWebsiteMotionDemoPlaying()` and advance only
542
+ * while it is `true`: the same three conditions (not paused, on screen, motion allowed) gate them.
543
+ *
544
+ * Every word comes from the section's label pack: the engine owns no copy here.
545
+ *
546
+ * @example
547
+ * <WebsiteMotionDemo
548
+ * label={useWebsiteLabel('demo.label')}
549
+ * pauseLabel={useWebsiteLabel('demo.pause')}
550
+ * playLabel={useWebsiteLabel('demo.play')}
551
+ * className="board-demo"
552
+ * >
553
+ * <TaskBoardScreen />
554
+ * </WebsiteMotionDemo>
555
+ */
556
+ export interface WebsiteMotionDemoProps {
557
+ /** What the demo shows, for assistive technology — the demo's `alt`. From the label pack. */
558
+ label: string;
559
+ /** The control's text while the demo plays. From the label pack (e.g. "Pause the animation"). */
560
+ pauseLabel: string;
561
+ /** The control's text while the demo is paused. From the label pack (e.g. "Play the animation"). */
562
+ playLabel: string;
563
+ /** The drawn interface. Its base styles are the still frame; its keyframes add the movement. */
564
+ children: ReactNode;
565
+ /** The frame the drawing sits in (`WebsiteDemoFrameVariant`); none by default, for a site that frames it itself. */
566
+ frame?: WebsiteDemoFrameVariant;
567
+ className?: string;
568
+ style?: CSSProperties;
569
+ }
570
+
571
+ interface WebsiteMotionDemoPlaybackValue {
572
+ readonly playing: boolean;
573
+ /**
574
+ * Motion is not allowed at all (a reduced-motion preference, or a tempo that plays no choreography), as opposed to
575
+ * merely paused. A still demo shows its finished picture; a paused one holds what it shows.
576
+ */
577
+ readonly still: boolean;
578
+ }
579
+
580
+ const WebsiteMotionDemoPlaybackContext = createContext<WebsiteMotionDemoPlaybackValue | null>(null);
581
+
582
+ const REDUCED_MOTION_QUERY = '(prefers-reduced-motion: reduce)';
583
+
584
+ function subscribeToReducedMotion(onChange: () => void): () => void {
585
+ if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return () => undefined;
586
+ const query = window.matchMedia(REDUCED_MOTION_QUERY);
587
+ query.addEventListener('change', onChange);
588
+ return () => query.removeEventListener('change', onChange);
589
+ }
590
+
591
+ function readReducedMotion(): boolean {
592
+ if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return false;
593
+ return window.matchMedia(REDUCED_MOTION_QUERY).matches;
594
+ }
595
+
596
+ /**
597
+ * Whether the enclosing demo is playing right now: not paused by the visitor, on screen, and allowed to move (no
598
+ * reduced-motion preference, a tempo that plays choreography). `false` on the server and before the frame has been
599
+ * observed, so a JavaScript-driven demo renders its first frame and starts only once it is known to be seen.
600
+ *
601
+ * Throws outside a `WebsiteMotionDemo` or `WebsiteMotionDemoGroup`: a timer that ignored the pause control would be the WCAG 2.2.2 failure this
602
+ * primitive exists to prevent, so there is no silent default.
603
+ */
604
+ export function useWebsiteMotionDemoPlaying(): boolean {
605
+ const value = useContext(WebsiteMotionDemoPlaybackContext);
606
+ if (value === null) {
607
+ throw new Error('useWebsiteMotionDemoPlaying() must be called inside a <WebsiteMotionDemo> or a <WebsiteMotionDemoGroup>.');
608
+ }
609
+ return value.playing;
610
+ }
611
+
612
+ const VISUALLY_HIDDEN: CSSProperties = {
613
+ position: 'absolute',
614
+ width: 1,
615
+ height: 1,
616
+ padding: 0,
617
+ margin: -1,
618
+ overflow: 'hidden',
619
+ clip: 'rect(0, 0, 0, 0)',
620
+ whiteSpace: 'nowrap',
621
+ border: 0,
622
+ };
623
+
624
+ /** The control's glyph: two bars while playing (the action is "pause"), a triangle while paused. */
625
+ function DemoToggleGlyph({ paused }: { paused: boolean }): ReactNode {
626
+ return (
627
+ <svg width="12" height="12" viewBox="0 0 12 12" aria-hidden="true" focusable="false">
628
+ {paused ? (
629
+ <path d="M3 1.5v9l7.5-4.5z" fill="currentColor" />
630
+ ) : (
631
+ <path d="M2.5 1.5h2.5v9H2.5zM7 1.5h2.5v9H7z" fill="currentColor" />
632
+ )}
633
+ </svg>
634
+ );
635
+ }
636
+
637
+ /** What both frames share: the observed frame, the visitor's pause, and the playback flag their timers read. */
638
+ function useMotionDemoPlayback(): {
639
+ readonly attachFrame: (element: HTMLElement | null) => void;
640
+ readonly paused: boolean;
641
+ readonly toggle: () => void;
642
+ readonly playing: boolean;
643
+ readonly still: boolean;
644
+ readonly frameAttributes: Record<string, string>;
645
+ } {
646
+ const frameRef = useRef<HTMLElement | null>(null);
647
+ const [paused, setPaused] = useState(false);
648
+ /** `null` until the observer has answered: neither "on screen" nor "off screen" is known yet. */
649
+ const [onScreen, setOnScreen] = useState<boolean | null>(null);
650
+ const reducedMotion = useSyncExternalStore(subscribeToReducedMotion, readReducedMotion, () => false);
651
+ const tempo = resolveWebsiteMotionTokens(useWebsiteDesignTokens().motion).tempo;
652
+ const tempoMoves = WEBSITE_MOTION_TEMPO[tempo].playsChoreography;
653
+
654
+ useEffect(() => {
655
+ const frame = frameRef.current;
656
+ if (frame === null) return undefined;
657
+ if (typeof IntersectionObserver === 'undefined') {
658
+ // No observer (an old engine, a test environment): treat the demo as seen rather than freezing it forever.
659
+ setOnScreen(true);
660
+ return undefined;
661
+ }
662
+ const observer = new IntersectionObserver((entries) => {
663
+ const entry = entries[entries.length - 1];
664
+ if (entry !== undefined) setOnScreen(entry.isIntersecting);
665
+ });
666
+ observer.observe(frame);
667
+ return () => observer.disconnect();
668
+ }, []);
669
+
670
+ const toggle = useCallback(() => setPaused((current) => !current), []);
671
+ const attachFrame = useCallback((element: HTMLElement | null) => {
672
+ frameRef.current = element;
673
+ }, []);
674
+ const frameAttributes: Record<string, string> = { [WebsiteMotionDemoAttribute.FRAME]: '' };
675
+ if (paused) frameAttributes[WebsiteMotionDemoAttribute.PAUSED] = '';
676
+ if (onScreen === false) frameAttributes[WebsiteMotionDemoAttribute.OFFSCREEN] = '';
677
+ const still = reducedMotion || !tempoMoves;
678
+ return { attachFrame, paused, toggle, playing: !paused && onScreen === true && !still, still, frameAttributes };
679
+ }
680
+
681
+ /** The pause / play control both frames render: a real button whose text is the action it will take. */
682
+ function DemoToggle({ paused, toggle, pauseLabel, playLabel }: { paused: boolean; toggle: () => void; pauseLabel: string; playLabel: string }): ReactNode {
683
+ return (
684
+ <button type="button" onClick={toggle} title={paused ? playLabel : pauseLabel} {...{ [WebsiteMotionDemoAttribute.TOGGLE]: '' }}>
685
+ <DemoToggleGlyph paused={paused} />
686
+ <span style={VISUALLY_HIDDEN}>{paused ? playLabel : pauseLabel}</span>
687
+ </button>
688
+ );
689
+ }
690
+
691
+ export function WebsiteMotionDemo({ label, pauseLabel, playLabel, children, frame, className, style }: WebsiteMotionDemoProps): ReactNode {
692
+ const { attachFrame, paused, toggle, playing, still, frameAttributes } = useMotionDemoPlayback();
693
+ return (
694
+ <WebsiteMotionDemoPlaybackContext.Provider value={{ playing, still }}>
695
+ <figure ref={attachFrame} className={className} style={style} aria-label={label} {...frameAttributes} {...websiteDemoFrameAttributes(frame)}>
696
+ <div {...{ [WebsiteMotionDemoAttribute.STAGE]: '' }} aria-hidden="true" inert>
697
+ {children}
698
+ </div>
699
+ <DemoToggle paused={paused} toggle={toggle} pauseLabel={pauseLabel} playLabel={playLabel} />
700
+ </figure>
701
+ </WebsiteMotionDemoPlaybackContext.Provider>
702
+ );
703
+ }
704
+ WebsiteMotionDemo.displayName = 'WebsiteMotionDemo';
705
+
706
+ /**
707
+ * `WebsiteMotionDemoGroup` — ONE pause control for several small animated visuals that sit among readable content:
708
+ * a bento grid whose tiles each carry a tiny loop, an integrations marquee beside its accessible list. Unlike
709
+ * `WebsiteMotionDemo`, the group's own content stays readable; each drawn visual inside it goes in a
710
+ * `WebsiteMotionDemoStage`, which is what the stylesheet pauses and assistive technology skips. Same guarantees:
711
+ * paused off screen, still under reduced motion, `useWebsiteMotionDemoPlaying()` for JavaScript timers.
712
+ */
713
+ export interface WebsiteMotionDemoGroupProps {
714
+ /** The control's text while the visuals play. From the label pack. */
715
+ pauseLabel: string;
716
+ /** The control's text while they are paused. From the label pack. */
717
+ playLabel: string;
718
+ children: ReactNode;
719
+ className?: string;
720
+ style?: CSSProperties;
721
+ }
722
+
723
+ export function WebsiteMotionDemoGroup({ pauseLabel, playLabel, children, className, style }: WebsiteMotionDemoGroupProps): ReactNode {
724
+ const { attachFrame, paused, toggle, playing, still, frameAttributes } = useMotionDemoPlayback();
725
+ return (
726
+ <WebsiteMotionDemoPlaybackContext.Provider value={{ playing, still }}>
727
+ <div ref={attachFrame} className={className} style={style} {...frameAttributes}>
728
+ {/* First in reading order, before what it controls (the APG carousel pattern); drawn where the stylesheet places it. */}
729
+ <DemoToggle paused={paused} toggle={toggle} pauseLabel={pauseLabel} playLabel={playLabel} />
730
+ {children}
731
+ </div>
732
+ </WebsiteMotionDemoPlaybackContext.Provider>
733
+ );
734
+ }
735
+ WebsiteMotionDemoGroup.displayName = 'WebsiteMotionDemoGroup';
736
+
737
+ /**
738
+ * One drawn, animated visual inside a `WebsiteMotionDemoGroup`: decorative to assistive technology (the readable
739
+ * content beside it carries the meaning), and governed by the group's pause control. Refuses outside a group or a
740
+ * demo, so a loop can never escape the control.
741
+ */
742
+ export function WebsiteMotionDemoStage({ children, className }: { children: ReactNode; className?: string }): ReactNode {
743
+ if (useContext(WebsiteMotionDemoPlaybackContext) === null) {
744
+ throw new Error('<WebsiteMotionDemoStage> must be placed inside a <WebsiteMotionDemoGroup> or a <WebsiteMotionDemo>.');
745
+ }
746
+ return (
747
+ <div className={className} aria-hidden="true" inert {...{ [WebsiteMotionDemoAttribute.STAGE]: '' }}>
748
+ {children}
749
+ </div>
750
+ );
751
+ }
752
+ WebsiteMotionDemoStage.displayName = 'WebsiteMotionDemoStage';
753
+
754
+ /**
755
+ * A drawn demo's scenario as STEPS, each held for its duration (ms) before the next; returns the step to draw.
756
+ *
757
+ * The LAST step is the still frame: what the server renders, and what a visitor who asked for reduced motion (or a
758
+ * site whose tempo is STILL) sees, also when that preference changes while the page is open. Author the scenario so
759
+ * its last step is the finished picture (the item completed, the change approved): the loop opens by holding it,
760
+ * then replays from step 0.
761
+ *
762
+ * PAUSED is different from still. When the visitor presses the control, or the demo leaves the screen, the timeline
763
+ * HOLDS the step it is on, as a paused video does, and resumes from it.
764
+ *
765
+ * Steps advance only while the enclosing demo plays (`useWebsiteMotionDemoPlaying`), which gives the visitor's pause
766
+ * control (WCAG 2.2.2) authority over the JavaScript half of a demo. The CSS half is the stage's keyframe animations,
767
+ * which the engine's stylesheet pauses; a transition runs only when a step changes, so a held step starts none.
768
+ * Throws outside a demo, for the same reason the playback flag does, and for an empty scenario.
769
+ *
770
+ * The durations are read by value, so an inline array is fine: a re-render with the same numbers keeps the timer.
771
+ *
772
+ * @example
773
+ * ```tsx
774
+ * const step = useWebsiteMotionDemoTimeline([700, 900, 3200]); // typed → added → completed (the still frame)
775
+ * return <li className={step >= 2 ? 'task task--done' : 'task'}>…</li>;
776
+ * ```
777
+ */
778
+ export function useWebsiteMotionDemoTimeline(stepDurations: readonly number[]): number {
779
+ return useWebsiteMotionDemoTimelinePosition(stepDurations).step;
780
+ }
781
+
782
+ /**
783
+ * `useWebsiteMotionDemoTimeline`, with how many times the timeline has advanced. A step reached again on the next loop
784
+ * is a new VISIT of it, and `advances` tells the two apart where the step number cannot: the scenario player starts
785
+ * each visit's typing afresh by it, and a bespoke scene restarts anything it runs within a step the same way.
786
+ */
787
+ export function useWebsiteMotionDemoTimelinePosition(stepDurations: readonly number[]): { readonly step: number; readonly advances: number } {
788
+ const playback = useContext(WebsiteMotionDemoPlaybackContext);
789
+ if (playback === null) {
790
+ throw new Error('A demo timeline (useWebsiteMotionDemoTimeline, useWebsiteDemoScenario) must run inside a <WebsiteMotionDemo> or a <WebsiteMotionDemoGroup>.');
791
+ }
792
+ if (stepDurations.length === 0) throw new Error('A demo timeline needs at least one step.');
793
+ const { playing, still } = playback;
794
+ const last = stepDurations.length - 1;
795
+ const durationsKey = stepDurations.join(',');
796
+ const durations = useRef(stepDurations);
797
+ durations.current = stepDurations;
798
+ const [position, setPosition] = useState({ step: last, advances: 0 });
799
+ useEffect(() => {
800
+ if (!playing) return undefined;
801
+ const timer = setTimeout(
802
+ () => setPosition((current) => ({ step: (current.step + 1) % durations.current.length, advances: current.advances + 1 })),
803
+ durations.current[position.step] ?? 1000,
804
+ );
805
+ return () => clearTimeout(timer);
806
+ }, [playing, position, durationsKey]);
807
+ return still ? { step: last, advances: position.advances } : { step: Math.min(position.step, last), advances: position.advances };
808
+ }
809
+
810
+ /**
811
+ * The frame a drawn product sits in on the page (#2742): `STAGE`, `PLAIN` or `BACKDROP` (`WebsiteDemoFrameVariant`).
812
+ * A frame is also the SIZE CONTAINER a drawing measures itself against, so the drawing inside scales with the frame as
813
+ * one picture, and it takes its container's full width, so it never collapses to its padding inside a parent that
814
+ * centres its children. On an INVERSE band a stage and a backdrop take the product's night colours; a site sets
815
+ * `--website-kit-frame-background` on a frame to give it its own background.
816
+ *
817
+ * Give `WebsiteMotionDemo` a `frame`, or wrap a drawing that sits inside another block's demo group (a product tour's
818
+ * screen, a bento tile) in `WebsiteDemoFrame`. Like a stage, a standalone frame refuses outside a group or a demo: a
819
+ * drawing's loops must always answer a pause control.
820
+ */
821
+ export function websiteDemoFrameAttributes(variant: WebsiteDemoFrameVariant | undefined): Record<string, string> {
822
+ return variant === undefined ? {} : { [WebsiteMotionDemoAttribute.FRAME_VARIANT]: variant };
823
+ }
824
+
825
+ export function WebsiteDemoFrame({ variant, children }: { readonly variant: WebsiteDemoFrameVariant; readonly children: ReactNode }): ReactNode {
826
+ if (useContext(WebsiteMotionDemoPlaybackContext) === null) {
827
+ throw new Error('<WebsiteDemoFrame> must be placed inside a <WebsiteMotionDemoGroup> or a <WebsiteMotionDemo>.');
828
+ }
829
+ return <div {...websiteDemoFrameAttributes(variant)}>{children}</div>;
830
+ }
831
+ WebsiteDemoFrame.displayName = 'WebsiteDemoFrame';
832
+ ```
833
+
834
+ ## A demo's scenario, as data, and its player
835
+
836
+ What a demo shows happening (`defineWebsiteDemoScenario`), timed in beats of the tempo, and the hook that plays it
837
+ (`useWebsiteDemoScenario`):
838
+
839
+ ## Import Origins
840
+
841
+ - `@wildo-ai/saas-website`
842
+
843
+ ## Source Excerpts
844
+
845
+ ### Origin Package: `@wildo-ai/saas-website`
846
+
847
+ ```typescript
848
+ *
849
+ * A drawn product demo as DATA (#2742): the items it shows, what each starts as, and the steps that change them. The
850
+ * site draws the items with the drawn-product kit and reads each one's state from the moment the player computes, so a
851
+ * demo has no hand-written step arithmetic, the still frame is a computed value, and the words it reads are derived.
852
+ *
853
+ * - **Items.** Each item is a ref (`item1`, `capture`, `card`) the drawing names. It starts with the kit states it is
854
+ * in (`WebsiteProductState`: done, shown, …), the field values it carries, and the words it reads (label slots).
855
+ * - **Steps.** The scenario is a list of steps. Each holds for a number of BEATS (resolved through the site's tempo)
856
+ * and applies its actions as it starts. The moment at a step is the items after every action up to it, so step 0 is
857
+ * the loop's reset and the LAST step is the still frame: what the server renders, and what a visitor who asked for
858
+ * reduced motion sees. Author the last step as the finished picture.
859
+ * - **Actions** are a closed set (`WebsiteDemoActionKind`): a state set or cleared from a step on, a state pulsed on
860
+ * one step only (a press, a typing indicator), the focus moved, a field given a value, or words typed. Typing
861
+ * lasts as long as the words take to type in the visitor's language, whatever the hold says.
862
+ *
863
+ * `defineWebsiteDemoScenario` refuses a scenario that names an item it does not declare, or whose still frame shows a
864
+ * gesture in progress. `validateWebsiteDemoScenario` refuses one whose values are untrue of the application's
865
+ * resource: a status that is not a member of its enum, a field that the operation making the change does not write.
866
+ */
867
+
868
+ /**
869
+ * What a demo shows happening, one of the nine shapes product demos take. Descriptive: the creation lane's website plan
870
+ * names a section's demo by it (step 5), and a reader of the scenario learns its intent from it.
871
+ */
872
+ export enum WebsiteDemoArchetype {
873
+ /** Items arrive one by one: an activity stream, a log, an inbox. */
874
+ APPEND = 'append',
875
+ /** A proposed change waits for a person, who approves it. */
876
+ APPROVAL = 'approval',
877
+ /** A question is asked and answered from the product's own records. */
878
+ QUERY_ANSWER = 'query-answer',
879
+ /** Something arriving (an email, a file) becomes a record. */
880
+ TRANSFORM = 'transform',
881
+ /** Two parties or systems are linked, and something flows between them. */
882
+ CONNECT = 'connect',
883
+ /** Items on a list are completed. */
884
+ COMPLETE_ITEMS = 'complete-items',
885
+ /** One record moves through its statuses. */
886
+ STATUS_LIFECYCLE = 'status-lifecycle',
887
+ /** Figures and charts fill in. */
888
+ DASHBOARD = 'dashboard',
889
+ /** A goal is reached and marked. */
890
+ CELEBRATE = 'celebrate',
891
+ }
892
+
893
+ /**
894
+ * What an action does to its item. Every gesture a demo shows is one of these on a kit state: a row appended is SET
895
+ * SHOWN, removed is CLEAR SHOWN, checked is SET DONE, a button pressed is PULSE PRESSED, a typing indicator is PULSE
896
+ * TYPING, a toast is SET SHOWN on it, a chart drawn is SET DRAWN, a connection is SET LINKED, a status changed is VALUE.
897
+ */
898
+ export enum WebsiteDemoActionKind {
899
+ /** The item takes a state from this step on. */
900
+ SET = 'set',
901
+ /** The item drops a state from this step on. */
902
+ CLEAR = 'clear',
903
+ /** The item holds a state on this step only: a button pressed, a typing indicator. */
904
+ PULSE = 'pulse',
905
+ /** The item becomes the one in focus (`WebsiteProductState.FOCUS`), which leaves every other item; `null` clears it. */
906
+ FOCUS = 'focus',
907
+ /** A field of the item takes a value from this step on: a status, a count. The field is the bound resource's. */
908
+ VALUE = 'value',
909
+ /** Words are typed into the item on this step (`TYPING`), and stay as its typed words afterwards. */
910
+ TYPE = 'type',
911
+ }
912
+
913
+ /** A value a record carries: an enum member or a text, a number, a flag. */
914
+ export type WebsiteDemoValue = string | number | boolean;
915
+
916
+ export type WebsiteDemoAction =
917
+ | { readonly kind: WebsiteDemoActionKind.SET | WebsiteDemoActionKind.CLEAR | WebsiteDemoActionKind.PULSE; readonly target: string; readonly state: WebsiteProductState }
918
+ | { readonly kind: WebsiteDemoActionKind.FOCUS; readonly target: string | null }
919
+ | {
920
+ readonly kind: WebsiteDemoActionKind.VALUE;
921
+ readonly target: string;
922
+ readonly field: string;
923
+ readonly value: WebsiteDemoValue;
924
+ /** The resource's custom operation that makes this change (a relationship's `accept`); absent: an update. */
925
+ readonly operation?: string;
926
+ }
927
+ | { readonly kind: WebsiteDemoActionKind.TYPE; readonly target: string; readonly words: string };
928
+
929
+ /** One step: how long it holds, in beats of the site's tempo, and what changes as it starts. */
930
+ export interface WebsiteDemoStep {
931
+ readonly beats: number;
932
+ readonly actions: readonly WebsiteDemoAction[];
933
+ }
934
+
935
+ /** One item a demo shows, as it is before the first step. */
936
+ export interface WebsiteDemoItem {
937
+ /** The kit states it starts in. Never a gesture (pressed, typing): those are pulsed by a step. */
938
+ readonly states?: readonly WebsiteProductState[];
939
+ /** The bound resource's field values it carries (a record's status). */
940
+ readonly values?: Readonly<Record<string, WebsiteDemoValue>>;
941
+ /** Its words, by part (`title` → `item1.title`): label slots of the section, relative to the demo's prefix. */
942
+ readonly words?: Readonly<Record<string, string>>;
943
+ /**
944
+ * The word a field's value reads as, by field: `status` → `status` reads value `done` as the slot `status.done`. The
945
+ * section's words include one per value the field takes in the scenario, derived.
946
+ */
947
+ readonly valueWords?: Readonly<Record<string, string>>;
948
+ }
949
+
950
+ export interface WebsiteDemoScenario {
951
+ readonly archetype: WebsiteDemoArchetype;
952
+ /**
953
+ * The application resource whose records the drawing shows (`todos`). Every value an item carries or a step sets is
954
+ * one of this resource's fields, checked by `validateWebsiteDemoScenario`. Absent: the drawing shows no record, and
955
+ * a scenario that sets a value is refused.
956
+ */
957
+ readonly resource?: string;
958
+ readonly items: Readonly<Record<string, WebsiteDemoItem>>;
959
+ readonly steps: readonly WebsiteDemoStep[];
960
+ }
961
+
962
+ /**
963
+ * Marks a scenario `defineWebsiteDemoScenario` checked. Keyed by `Symbol.for`, so it is one symbol in every copy of
964
+ * this package a process loads (a site may map the engine to its source while a tool imports its `dist`).
965
+ */
966
+ export const WEBSITE_DEMO_SCENARIO_DEFINED: unique symbol = Symbol.for('wildo.website.demo-scenario.defined');
967
+
968
+ /**
969
+ * A scenario that went through `defineWebsiteDemoScenario`. The player (`useWebsiteDemoScenario`) takes only these, so
970
+ * every scenario a site plays was checked, and is seen by `collectDefinedWebsiteDemoScenarios`.
971
+ */
972
+ export interface DefinedWebsiteDemoScenario extends WebsiteDemoScenario {
973
+ readonly [WEBSITE_DEMO_SCENARIO_DEFINED]: true;
974
+ }
975
+
976
+ /** One scenario a site defined, and where: `<file>:<line>` of the `defineWebsiteDemoScenario` call, when known. */
977
+ export interface DefinedWebsiteDemoScenarioRecord {
978
+ readonly scenario: WebsiteDemoScenario;
979
+ readonly definedAt: string | null;
980
+ }
981
+
982
+ /** The open collection, process-wide for the same reason as the marker. Absent unless a check is collecting. */
983
+ const WEBSITE_DEMO_SCENARIO_COLLECTION: unique symbol = Symbol.for('wildo.website.demo-scenario.collection');
984
+ type CollectingGlobal = typeof globalThis & { [WEBSITE_DEMO_SCENARIO_COLLECTION]?: DefinedWebsiteDemoScenarioRecord[] };
985
+
986
+ /** This module's own frames are skipped when naming where a scenario was defined. */
987
+ const THIS_MODULE = /website-demo-scenario\.shared\.[cm]?[jt]s/u;
988
+
989
+ /**
990
+ * Where a stack frame points, as `[file, line]`: `at fn (<file>:<line>:<col>)` or `at <file>:<line>:<col>`. The file
991
+ * may hold spaces and parentheses (a project folder named `My Projects (2026)`), so it is everything up to the LAST
992
+ * `:<line>:<col>`, never a run of non-space characters. Null for a frame naming no file (`at async Promise.all (index 0)`).
993
+ */
994
+ export function websiteDemoStackFrameLocation(frame: string): readonly [string, string] | null {
995
+ const trimmed = frame.trim();
996
+ const located = /^at .*?\((.+):(\d+):\d+\)$/u.exec(trimmed) ?? /^at (.+):(\d+):\d+$/u.exec(trimmed);
997
+ if (located === null) return null;
998
+ // A loader may tag the module URL with a query (tsx's `?tsx-namespace=…`): the same file is the same place.
999
+ return [located[1]!.replace(/^file:\/\//u, '').replace(/\?.*$/u, ''), located[2]!];
1000
+ }
1001
+
1002
+ /**
1003
+ * The first stack frame outside this module that names a file of the application, as `<file>:<line>`; null when the
1004
+ * runtime gives no readable stack. Node's own frames (`node:internal/…`) are skipped: a scenario is never defined
1005
+ * there, and naming one would make two scenarios defined in two places read as one.
1006
+ */
1007
+ function definitionSite(): string | null {
1008
+ for (const frame of (new Error().stack ?? '').split('\n').slice(1)) {
1009
+ if (THIS_MODULE.test(frame)) continue;
1010
+ const location = websiteDemoStackFrameLocation(frame);
1011
+ if (location === null || location[0].startsWith('node:')) continue;
1012
+ return `${location[0]}:${location[1]}`;
1013
+ }
1014
+ return null;
1015
+ }
1016
+
1017
+ /**
1018
+ * Records every scenario `defineWebsiteDemoScenario` checks while `load` runs, and returns them with `load`'s result.
1019
+ * How a check finds a site's scenarios without the site exporting them: it collects, then imports the site's section
1020
+ * modules, whose scenarios are defined at module scope. Nothing is recorded outside a collection, so a visitor's
1021
+ * browser keeps nothing. A module the process had already imported before the collection opened defines nothing
1022
+ * again, so a check imports the site FRESH. Collections do not nest: a second one while one is open is refused.
1023
+ */
1024
+ export async function collectDefinedWebsiteDemoScenarios<Loaded>(load: () => Promise<Loaded>): Promise<{ loaded: Loaded; scenarios: DefinedWebsiteDemoScenarioRecord[] }> {
1025
+ const host = globalThis as CollectingGlobal;
1026
+ if (host[WEBSITE_DEMO_SCENARIO_COLLECTION] !== undefined) throw new Error('[website demo scenario] a collection is already open in this process.');
1027
+ const scenarios: DefinedWebsiteDemoScenarioRecord[] = [];
1028
+ host[WEBSITE_DEMO_SCENARIO_COLLECTION] = scenarios;
1029
+ try {
1030
+ return { loaded: await load(), scenarios };
1031
+ } finally {
1032
+ delete host[WEBSITE_DEMO_SCENARIO_COLLECTION];
1033
+ }
1034
+ }
1035
+
1036
+ /** The states that describe a gesture IN PROGRESS: only ever pulsed, and never on the still frame. */
1037
+ const GESTURE_STATES: ReadonlySet<WebsiteProductState> = new Set([WebsiteProductState.PRESSED, WebsiteProductState.TYPING]);
1038
+
1039
+ /**
1040
+ * Checks a scenario's own coherence and returns it. Throws when:
1041
+ * - an action names an item the scenario does not declare, or there is no step;
1042
+ * - a hold is not a positive, finite number of beats;
1043
+ * - a value is carried or set with no bound resource;
1044
+ * - a gesture (pressed, typing) is set, cleared or started in rather than pulsed, or the focus is set, cleared or
1045
+ * pulsed rather than moved (FOCUS keeps it on one item), or more than one item starts in focus;
1046
+ * - the still frame (the moment at the last step) shows a gesture in progress.
1047
+ */
1048
+ export function defineWebsiteDemoScenario<const Scenario extends WebsiteDemoScenario>(scenario: Scenario): Scenario & DefinedWebsiteDemoScenario {
1049
+ const problems: string[] = [];
1050
+ if (scenario.steps.length === 0) problems.push('it has no step');
1051
+ const known = (target: string | null) => target === null || Object.hasOwn(scenario.items, target);
1052
+ scenario.steps.forEach((step, index) => {
1053
+ if (!(Number.isFinite(step.beats) && step.beats > 0)) problems.push(`step ${index} holds ${step.beats} beats; a hold is a positive, finite number of beats`);
1054
+ for (const action of step.actions) {
1055
+ if (!known(action.target)) problems.push(`step ${index} acts on "${action.target}", which is not one of its items`);
1056
+ if (action.kind === WebsiteDemoActionKind.VALUE && scenario.resource === undefined) {
1057
+ problems.push(`step ${index} sets "${action.field}" but the scenario binds no resource`);
1058
+ }
1059
+ if (action.kind === WebsiteDemoActionKind.VALUE && action.operation !== undefined && action.operation.trim() === '') {
1060
+ problems.push(`step ${index} names an empty operation; name the custom operation, or none for an update`);
1061
+ }
1062
+ const stated = action.kind === WebsiteDemoActionKind.SET || action.kind === WebsiteDemoActionKind.CLEAR || action.kind === WebsiteDemoActionKind.PULSE;
1063
+ if (stated && action.kind !== WebsiteDemoActionKind.PULSE && GESTURE_STATES.has(action.state)) {
1064
+ problems.push(`step ${index} ${action.kind}s "${action.state}" on "${action.target}"; a gesture is pulsed, so it lasts its own step`);
1065
+ }
1066
+ if (stated && action.state === WebsiteProductState.FOCUS) {
1067
+ problems.push(`step ${index} ${action.kind}s the focus on "${action.target}"; move it with a FOCUS action, which keeps it on one item`);
1068
+ }
1069
+ }
1070
+ });
1071
+ let startsFocused = 0;
1072
+ for (const [ref, item] of Object.entries(scenario.items)) {
1073
+ if (item.values !== undefined && Object.keys(item.values).length > 0 && scenario.resource === undefined) {
1074
+ problems.push(`item "${ref}" carries values but the scenario binds no resource`);
1075
+ }
1076
+ for (const state of item.states ?? []) {
1077
+ if (GESTURE_STATES.has(state)) problems.push(`item "${ref}" starts "${state}"; a gesture is pulsed by a step`);
1078
+ if (state === WebsiteProductState.FOCUS) startsFocused += 1;
1079
+ }
1080
+ }
1081
+ if (startsFocused > 1) problems.push(`${startsFocused} items start in focus; at most one is`);
1082
+ if (scenario.steps.length > 0 && problems.length === 0) {
1083
+ for (const [ref, item] of reduceWebsiteDemoScenario(scenario, scenario.steps.length - 1)) {
1084
+ for (const state of item.states) {
1085
+ if (GESTURE_STATES.has(state)) {
1086
+ problems.push(`the still frame (the last step) shows "${ref}" ${state}, a gesture in progress; end on the finished picture`);
1087
+ }
1088
+ }
1089
+ }
1090
+ }
1091
+ if (problems.length > 0) throw new Error(`[website demo scenario] ${problems.join('; ')}.`);
1092
+ Object.defineProperty(scenario, WEBSITE_DEMO_SCENARIO_DEFINED, { value: true, enumerable: false });
1093
+ (globalThis as CollectingGlobal)[WEBSITE_DEMO_SCENARIO_COLLECTION]?.push({ scenario, definedAt: definitionSite() });
1094
+ return scenario as Scenario & DefinedWebsiteDemoScenario;
1095
+ }
1096
+
1097
+ /** One item at one step. */
1098
+ export interface WebsiteDemoItemMoment {
1099
+ readonly states: ReadonlySet<WebsiteProductState>;
1100
+ readonly values: Readonly<Record<string, WebsiteDemoValue>>;
1101
+ /** The slot of the words typed into it most recently, if any. */
1102
+ readonly typed: string | undefined;
1103
+ }
1104
+
1105
+ /** Every item at one step, keyed by ref. */
1106
+ export type WebsiteDemoMomentItems = ReadonlyMap<string, WebsiteDemoItemMoment>;
1107
+
1108
+ /**
1109
+ * The items at `step` (clamped to the scenario): the starting items after every action of steps 0 to `step`, with the
1110
+ * pulses of `step` itself. Pure: the player calls it on every step, and a test reads any moment without a timer.
1111
+ */
1112
+ export function reduceWebsiteDemoScenario(scenario: WebsiteDemoScenario, step: number): WebsiteDemoMomentItems {
1113
+ const at = Math.max(0, Math.min(step, scenario.steps.length - 1));
1114
+ const items = new Map<string, { states: Set<WebsiteProductState>; values: Record<string, WebsiteDemoValue>; typed: string | undefined }>();
1115
+ for (const [ref, item] of Object.entries(scenario.items)) {
1116
+ items.set(ref, { states: new Set(item.states ?? []), values: { ...item.values }, typed: undefined });
1117
+ }
1118
+ for (let index = 0; index <= at; index += 1) {
1119
+ for (const action of scenario.steps[index]?.actions ?? []) {
1120
+ if (action.kind === WebsiteDemoActionKind.FOCUS) {
1121
+ for (const item of items.values()) item.states.delete(WebsiteProductState.FOCUS);
1122
+ if (action.target !== null) items.get(action.target)?.states.add(WebsiteProductState.FOCUS);
1123
+ continue;
1124
+ }
1125
+ const item = items.get(action.target);
1126
+ if (item === undefined) continue;
1127
+ if (action.kind === WebsiteDemoActionKind.SET) item.states.add(action.state);
1128
+ else if (action.kind === WebsiteDemoActionKind.CLEAR) item.states.delete(action.state);
1129
+ else if (action.kind === WebsiteDemoActionKind.VALUE) item.values[action.field] = action.value;
1130
+ else if (action.kind === WebsiteDemoActionKind.TYPE) item.typed = action.words;
1131
+ else if (action.kind === WebsiteDemoActionKind.PULSE && index === at) item.states.add(action.state);
1132
+ }
1133
+ }
1134
+ // Typing is a pulse of the step that types.
1135
+ for (const action of scenario.steps[at]?.actions ?? []) {
1136
+ if (action.kind === WebsiteDemoActionKind.TYPE) items.get(action.target)?.states.add(WebsiteProductState.TYPING);
1137
+ }
1138
+ return items;
1139
+ }
1140
+
1141
+ /** The refs of the items a step types into: the player types their words out on that step. */
1142
+ export function websiteDemoTypingTargets(scenario: WebsiteDemoScenario, step: number): ReadonlySet<string> {
1143
+ const targets = new Set<string>();
1144
+ for (const action of scenario.steps[step]?.actions ?? []) if (action.kind === WebsiteDemoActionKind.TYPE) targets.add(action.target);
1145
+ return targets;
1146
+ }
1147
+
1148
+ /**
1149
+ * How long one beat is in each tempo, in milliseconds. A beat is a READING unit, not an animation length: it is long
1150
+ * enough for a visitor to notice what changed, and grows a little with the tempo's own clock so a calm brand also
1151
+ * reads calmly. STILL never plays (its still frame is all a visitor sees). Total over `ThemeMotion`.
1152
+ */
1153
+ export const WEBSITE_DEMO_BEAT_MS: Readonly<Record<ThemeMotion, number>> = {
1154
+ [ThemeMotion.STILL]: 0,
1155
+ [ThemeMotion.CRISP]: 450,
1156
+ [ThemeMotion.BRISK]: 500,
1157
+ [ThemeMotion.FLUID]: 550,
1158
+ [ThemeMotion.SPRINGY]: 550,
1159
+ };
1160
+
1161
+ /** The shortest a step may hold, whatever its beats: below it a change is gone before it is seen. */
1162
+ export const WEBSITE_DEMO_MIN_STEP_MS = 600;
1163
+ /** The shortest the last step (the finished picture) may hold before the loop starts again. */
1164
+ export const WEBSITE_DEMO_MIN_STILL_HOLD_MS = 3600;
1165
+ /** How long one character takes to type: an unhurried typist's pace, the same in every tempo. */
1166
+ export const WEBSITE_DEMO_TYPING_MS_PER_CHARACTER = 55;
1167
+ /** What a step that types holds after the last character, so the finished words are read. */
1168
+ export const WEBSITE_DEMO_TYPING_SETTLE_MS = 500;
1169
+
1170
+ /** The characters of typed words, as a typist presses them: an accent or an emoji is one, not two UTF-16 units. */
1171
+ export function websiteDemoTypedCharacters(text: string): string[] {
1172
+ return [...text];
1173
+ }
1174
+
1175
+ /** How long typing these words takes. */
1176
+ export function websiteDemoTypingDurationMs(text: string): number {
1177
+ return Math.max(1, websiteDemoTypedCharacters(text).length) * WEBSITE_DEMO_TYPING_MS_PER_CHARACTER;
1178
+ }
1179
+
1180
+ /**
1181
+ * Each step's hold in milliseconds: its beats in the tempo, never under the floor, the last step never under the still
1182
+ * hold, and a typing step at least as long as its words take to type and settle. `wordsOf(slot)` gives the words a TYPE
1183
+ * action types, in the visitor's language.
1184
+ */
1185
+ export function websiteDemoStepDurations(scenario: WebsiteDemoScenario, tempo: ThemeMotion, wordsOf: (slot: string) => string): number[] {
1186
+ const beat = WEBSITE_DEMO_BEAT_MS[tempo];
1187
+ return scenario.steps.map((step, index) => {
1188
+ const floor = index === scenario.steps.length - 1 ? WEBSITE_DEMO_MIN_STILL_HOLD_MS : WEBSITE_DEMO_MIN_STEP_MS;
1189
+ let hold = Math.max(step.beats * beat, floor);
1190
+ for (const action of step.actions) {
1191
+ if (action.kind === WebsiteDemoActionKind.TYPE) hold = Math.max(hold, websiteDemoTypingDurationMs(wordsOf(action.words)) + WEBSITE_DEMO_TYPING_SETTLE_MS);
1192
+ }
1193
+ return hold;
1194
+ });
1195
+ }
1196
+
1197
+ /** The slot a field's value reads as, when the item declares a word for that field's values. */
1198
+ export function websiteDemoValueWordSlot(item: WebsiteDemoItem, field: string, value: WebsiteDemoValue): string | undefined {
1199
+ const prefix = item.valueWords !== undefined && Object.hasOwn(item.valueWords, field) ? item.valueWords[field] : undefined;
1200
+ return prefix === undefined ? undefined : `${prefix}.${String(value)}`;
1201
+ }
1202
+
1203
+ /**
1204
+ * Every label slot a scenario reads, sorted: its items' words, the words its steps type, and one word per value a field
1205
+ * with value words takes (where it starts, and every value a step gives it). Prefix them for a section.
1206
+ */
1207
+ export function websiteDemoScenarioSlots(scenario: WebsiteDemoScenario): string[] {
1208
+ const slots = new Set<string>();
1209
+ const addValueWord = (ref: string, field: string, value: WebsiteDemoValue) => {
1210
+ const item = scenario.items[ref];
1211
+ const slot = item === undefined ? undefined : websiteDemoValueWordSlot(item, field, value);
1212
+ if (slot !== undefined) slots.add(slot);
1213
+ };
1214
+ for (const [ref, item] of Object.entries(scenario.items)) {
1215
+ for (const slot of Object.values(item.words ?? {})) slots.add(slot);
1216
+ for (const [field, value] of Object.entries(item.values ?? {})) addValueWord(ref, field, value);
1217
+ }
1218
+ for (const step of scenario.steps) {
1219
+ for (const action of step.actions) {
1220
+ if (action.kind === WebsiteDemoActionKind.TYPE) slots.add(action.words);
1221
+ if (action.kind === WebsiteDemoActionKind.VALUE) addValueWord(action.target, action.field, action.value);
1222
+ }
1223
+ }
1224
+ return [...slots].sort();
1225
+ }
1226
+
1227
+ /** What a field of the bound resource is, for checking the values a scenario gives it. */
1228
+ export enum WebsiteDemoFieldKind {
1229
+ /** A closed vocabulary: a value must be one of `members`. */
1230
+ ENUM = 'enum',
1231
+ NUMBER = 'number',
1232
+ TEXT = 'text',
1233
+ BOOLEAN = 'boolean',
1234
+ /** Anything else (a date, a reference): the scenario may name it, and its value is not checked. */
1235
+ OTHER = 'other',
1236
+ }
1237
+
1238
+ /** What the application says about the resource a scenario binds, as the creation lane derives it from its schema. */
1239
+ export interface WebsiteDemoResourceFacts {
1240
+ readonly resource: string;
1241
+ readonly fields: Readonly<Record<string, { readonly kind: WebsiteDemoFieldKind; readonly members?: readonly string[] }>>;
1242
+ /** The fields an update of the resource writes. */
1243
+ readonly updatable: readonly string[];
1244
+ /** The fields each of its custom operations writes, by operation identifier (a relationship's `accept`). */
1245
+ readonly operations?: Readonly<Record<string, readonly string[]>>;
1246
+ }
1247
+
1248
+ /**
1249
+ * The ways a scenario is untrue of the application, as sentences; empty when it is true. A value must name a field the
1250
+ * resource has, of the right kind (an enum member, a number, a text, a flag). A value a STEP sets is a change the
1251
+ * product makes, so the operation it names (an update when it names none) must write that field. Run where the
1252
+ * application's resources are known (the creation lane); the drawing never needs it.
1253
+ *
1254
+ * A value an item STARTS with is the record as it already is, so only its kind is checked. An item that appears on a
1255
+ * step (SET SHOWN) is drawn as a record arriving, and the scenario does not say whether it was created then or revealed,
1256
+ * so its values are not held to what a create accepts.
1257
+ */
1258
+ export function validateWebsiteDemoScenario(scenario: WebsiteDemoScenario, facts: WebsiteDemoResourceFacts): string[] {
1259
+ const problems: string[] = [];
1260
+ if (scenario.resource === undefined) return problems;
1261
+ if (scenario.resource !== facts.resource) {
1262
+ return [`the scenario shows "${scenario.resource}" but the facts are about "${facts.resource}"`];
1263
+ }
1264
+ /** `operation`: `undefined` for an item's starting value (no change), `null` for an update, else a custom operation. */
1265
+ const check = (where: string, field: string, value: WebsiteDemoValue, operation: string | null | undefined) => {
1266
+ if (!Object.hasOwn(facts.fields, field)) {
1267
+ problems.push(`${where} sets "${field}", which "${facts.resource}" does not have`);
1268
+ return;
1269
+ }
1270
+ const fact = facts.fields[field]!;
1271
+ if (operation !== undefined) {
1272
+ const writes = operation === null ? facts.updatable : Object.hasOwn(facts.operations ?? {}, operation) ? facts.operations![operation]! : undefined;
1273
+ if (writes === undefined) problems.push(`${where} changes "${field}" through "${operation}", which is not an operation of "${facts.resource}"`);
1274
+ else if (!writes.includes(field)) {
1275
+ problems.push(`${where} changes "${field}", which ${operation === null ? `an update of "${facts.resource}"` : `"${operation}"`} does not write`);
1276
+ }
1277
+ }
1278
+ if (fact.kind === WebsiteDemoFieldKind.ENUM && !(fact.members ?? []).includes(String(value))) {
1279
+ problems.push(`${where} sets "${field}" to "${String(value)}", which is not one of its values (${(fact.members ?? []).join(', ')})`);
1280
+ }
1281
+ const expected = { [WebsiteDemoFieldKind.NUMBER]: 'number', [WebsiteDemoFieldKind.TEXT]: 'string', [WebsiteDemoFieldKind.BOOLEAN]: 'boolean' }[
1282
+ fact.kind as WebsiteDemoFieldKind.NUMBER | WebsiteDemoFieldKind.TEXT | WebsiteDemoFieldKind.BOOLEAN
1283
+ ];
1284
+ if (expected !== undefined && typeof value !== expected) problems.push(`${where} sets "${field}" to "${String(value)}", which is not a ${fact.kind}`);
1285
+ };
1286
+ for (const [ref, item] of Object.entries(scenario.items)) {
1287
+ for (const [field, value] of Object.entries(item.values ?? {})) check(`item "${ref}"`, field, value, undefined);
1288
+ }
1289
+ scenario.steps.forEach((step, index) => {
1290
+ for (const action of step.actions) {
1291
+ if (action.kind === WebsiteDemoActionKind.VALUE) check(`step ${index}`, action.field, action.value, action.operation ?? null);
1292
+ }
1293
+ });
1294
+ return problems;
1295
+ }
1296
+ ```
1297
+
1298
+ ## Import Origins
1299
+
1300
+ - `@wildo-ai/saas-website`
1301
+
1302
+ ## Source Excerpts
1303
+
1304
+ ### Origin Package: `@wildo-ai/saas-website`
1305
+
1306
+ ```tsx
1307
+ *
1308
+ * The moment a playing scenario is at, as the drawing reads it. Every accessor names an item by its ref.
1309
+ */
1310
+ export interface WebsiteDemoMoment {
1311
+ /** The step on screen: the still frame (the last step) on the server and under reduced motion. */
1312
+ readonly step: number;
1313
+ /** Whether the item is in a kit state at this step: pass it to the atom's prop of the same name. */
1314
+ is(ref: string, state: WebsiteProductState): boolean;
1315
+ /** A field value the item carries at this step (a status), for the drawing to choose its look by. */
1316
+ value(ref: string, field: string): WebsiteDemoValue | undefined;
1317
+ /** The word for that value (`status.done`), when the item declares `valueWords` for the field. */
1318
+ valueWord(ref: string, field: string): string;
1319
+ /** One of the item's words (`word('item1', 'title')`), in the visitor's language. */
1320
+ word(ref: string, part: string): string;
1321
+ /**
1322
+ * The words typed into the item, as far as they are typed: on the step that types them they appear one character at
1323
+ * a time while the demo plays (and hold where they are when it is paused); after it they are whole. `undefined`
1324
+ * before any.
1325
+ */
1326
+ typed(ref: string): string | undefined;
1327
+ }
1328
+
1329
+ /**
1330
+ * Plays a scenario (`defineWebsiteDemoScenario`) inside a demo: it times the steps in the site's tempo, the typing steps
1331
+ * by the length of their words, types those words out, and returns the current moment. Call it inside a
1332
+ * `WebsiteMotionDemo` or a group, where the timeline obeys the pause control, reduced motion and the still tempo.
1333
+ * `prefix` is the demo's place in its section's words (a tour's `assistant.screen`), the same prefix as
1334
+ * `websiteDemoScenarioSlots` takes.
1335
+ *
1336
+ * @example
1337
+ * ```tsx
1338
+ * const moment = useWebsiteDemoScenario(WEEKLY_PLAN, { prefix });
1339
+ * <WebsiteProductRow done={moment.is('item1', WebsiteProductState.DONE)}>
1340
+ * <WebsiteProductRowTitle>{moment.word('item1', 'title')}</WebsiteProductRowTitle>
1341
+ * </WebsiteProductRow>
1342
+ * const typing = moment.is('field', WebsiteProductState.TYPING);
1343
+ * const typed = moment.typed('field');
1344
+ * <WebsiteProductField typing={typing} filled={typed !== undefined && !typing} text={typed ?? ''} hint={…} />
1345
+ * ```
1346
+ */
1347
+ export function useWebsiteDemoScenario(scenario: DefinedWebsiteDemoScenario, { prefix }: { readonly prefix?: string } = {}): WebsiteDemoMoment {
1348
+ const label = useWebsiteSectionLabels();
1349
+ const words = useMemo(() => (slot: string) => label(prefix === undefined || prefix === '' ? slot : `${prefix}.${slot}`), [label, prefix]);
1350
+ const tempo = resolveWebsiteMotionTokens(useWebsiteDesignTokens().motion).tempo;
1351
+ const durations = useMemo(() => websiteDemoStepDurations(scenario, tempo, words), [scenario, tempo, words]);
1352
+ const { step, advances } = useWebsiteMotionDemoTimelinePosition(durations);
1353
+ const playing = useWebsiteMotionDemoPlaying();
1354
+ const items = useMemo(() => reduceWebsiteDemoScenario(scenario, step), [scenario, step]);
1355
+
1356
+ // The characters typed so far, kept with the VISIT of the step they belong to (the timeline's count of advances), so a
1357
+ // typing step never shows, even for one render, what an earlier step or the same step on the last loop had reached.
1358
+ const typing = useMemo(
1359
+ () => (scenario.steps[step]?.actions ?? []).flatMap((action) => (action.kind === WebsiteDemoActionKind.TYPE ? [action.words] : [])),
1360
+ [scenario, step],
1361
+ );
1362
+ const typingTargets = useMemo(() => websiteDemoTypingTargets(scenario, step), [scenario, step]);
1363
+ const longest = useMemo(() => Math.max(0, ...typing.map((slot) => websiteDemoTypedCharacters(words(slot)).length)), [typing, words]);
1364
+ const [progress, setProgress] = useState({ visit: advances, characters: 0 });
1365
+ const typedSoFar = progress.visit === advances ? progress.characters : 0;
1366
+ useEffect(() => {
1367
+ if (!playing || typedSoFar >= longest) return undefined;
1368
+ const timer = setTimeout(() => setProgress({ visit: advances, characters: typedSoFar + 1 }), WEBSITE_DEMO_TYPING_MS_PER_CHARACTER);
1369
+ return () => clearTimeout(timer);
1370
+ }, [playing, advances, typedSoFar, longest]);
1371
+
1372
+ return useMemo<WebsiteDemoMoment>(
1373
+ () => ({
1374
+ step,
1375
+ is: (ref, state) => items.get(ref)?.states.has(state) ?? false,
1376
+ value: (ref, field) => items.get(ref)?.values[field],
1377
+ valueWord: (ref, field) => {
1378
+ const item = scenario.items[ref];
1379
+ const value = items.get(ref)?.values[field];
1380
+ const slot = item === undefined || value === undefined ? undefined : websiteDemoValueWordSlot(item, field, value);
1381
+ if (slot === undefined) throw new Error(`[website demo scenario] Item "${ref}" has no word for its "${field}" (declare valueWords and a value).`);
1382
+ return words(slot);
1383
+ },
1384
+ word: (ref, part) => {
1385
+ const slot = scenario.items[ref]?.words?.[part];
1386
+ if (slot === undefined) throw new Error(`[website demo scenario] Item "${ref}" declares no word "${part}".`);
1387
+ return words(slot);
1388
+ },
1389
+ typed: (ref) => {
1390
+ const item = items.get(ref);
1391
+ if (item?.typed === undefined) return undefined;
1392
+ const text = words(item.typed);
1393
+ // Typed out only by the step whose TYPE action targets it; a typing indicator pulsed on it shows its words whole.
1394
+ return typingTargets.has(ref) ? websiteDemoTypedCharacters(text).slice(0, typedSoFar).join('') : text;
1395
+ },
1396
+ }),
1397
+ [items, scenario, step, typedSoFar, typingTargets, words],
1398
+ );
1399
+ }
1400
+ ```
1401
+
1402
+ ## The brand's motion character
1403
+
1404
+ The tempo is the application theme's own axis, derived from the brand's keywords:
1405
+
1406
+ ## Import Origins
1407
+
1408
+ - `@wildo-ai/presets-components-models`
1409
+
1410
+ ## Source Excerpts
1411
+
1412
+ ### Origin Package: `@wildo-ai/presets-components-models`
1413
+
1414
+ ```typescript
1415
+ /** How roomy controls and spacing are. */
1416
+ export enum ThemeDensity {
1417
+ /** Dense's ladder: 32px controls, tight spacing. Data-heavy and power-user surfaces. */
1418
+ COMPACT = 'compact',
1419
+ /** The default's ladder: 36px controls. */
1420
+ BALANCED = 'balanced',
1421
+ /** Cozy's ladder: 44px controls, generous spacing. Consumer and onboarding surfaces. */
1422
+ COMFORTABLE = 'comfortable',
1423
+ }
1424
+
1425
+ /** How round corners are, per role (control, field, popover, panel, badge, list item). */
1426
+ export enum ThemeShape {
1427
+ /** Editorial's radii: the smallest radius everywhere, square badges. */
1428
+ SHARP = 'sharp',
1429
+ /** The default's radii: controls `rounded-lg`, panels `rounded-xl`, pill badges. */
1430
+ SOFT = 'soft',
1431
+ /** Cozy's radii: controls `rounded-2xl`, panels `rounded-3xl`. */
1432
+ ROUND = 'round',
1433
+ }
1434
+
1435
+ /** How far surfaces float. Always ordered card ≤ popover ≤ dialog. */
1436
+ export enum ThemeElevation {
1437
+ /** Dense's: cards cast nothing; popovers, dialogs and buttons keep the default's shadows. */
1438
+ FLAT = 'flat',
1439
+ /** The default's: `shadow-sm` cards, `shadow-md` popovers, `shadow-lg` dialogs. */
1440
+ SOFT = 'soft',
1441
+ /** Cozy's: long, low-opacity blurs, with dark-mode twins. */
1442
+ LAYERED = 'layered',
1443
+ /** Neo-brutalist's: a hard 4px offset in the foreground colour, on cards, floating layers and buttons. */
1444
+ HARD_OFFSET = 'hard-offset',
1445
+ }
1446
+
1447
+ /**
1448
+ * How motion feels: the TEMPO, meaning which motion token each kind of movement uses (a control's state change, an
1449
+ * overlay entering, an overlay leaving) and on which curve. The token values stay the application's; a theme chooses
1450
+ * which ones it reaches for, which is how every shipped theme expresses its motion. A recipe that paints with a
1451
+ * material keeps that material's own motion: glass's controls spring at any tempo, because the spring is part of the
1452
+ * material, not of the pace.
1453
+ */
1454
+ export enum ThemeMotion {
1455
+ /** Trading's and neo-brutalist's: controls change instantly and linearly, overlays snap in. Nothing on a data desk should glide. */
1456
+ STILL = 'still',
1457
+ /** Terminal's: the default's quick durations on a linear curve, no easing flourish. */
1458
+ CRISP = 'crisp',
1459
+ /** The default's: quick control changes on the standard curve, overlays eased in and out. */
1460
+ BRISK = 'brisk',
1461
+ /** Editorial's: slower control changes, overlays that take their time. */
1462
+ FLUID = 'fluid',
1463
+ /** Cozy's and glass's: FLUID's durations with a spring curve on control changes. */
1464
+ SPRINGY = 'springy',
1465
+ }
1466
+
1467
+ /** Whether chrome is solid or glass. */
1468
+ export enum ThemeMaterial {
1469
+ SOLID = 'solid',
1470
+ /** Glass's material profiles on the functional layers (controls, navigation, popovers, dialogs, toasts). */
1471
+ GLASS = 'glass',
1472
+ }
1473
+
1474
+ /** Which typefaces speak. */
1475
+ export enum ThemeTypeVoice {
1476
+ /** The application's own fonts. */
1477
+ NEUTRAL = 'neutral',
1478
+ /** Editorial's serif headings over a humanist sans body. */
1479
+ EDITORIAL = 'editorial',
1480
+ /** Terminal's geometric sans with its monospace, and monospace badges. */
1481
+ TECHNICAL = 'technical',
1482
+ }
1483
+
1484
+ /** How a destructive action is drawn. */
1485
+ export enum ThemeDangerStyle {
1486
+ /** The default's: a red edge and a red glyph on a neutral button, filled only on hover. */
1487
+ EDGE = 'edge',
1488
+ /** Dense's (and every named theme's): a solid red button with its own label colour. */
1489
+ FILL = 'fill',
1490
+ }
1491
+
1492
+ /** What marks the selected item of a list, a sidebar or a tab strip. */
1493
+ export enum ThemeSelectionEmphasis {
1494
+ /** The default's: a quiet neutral wash, with weight saying "you are here". */
1495
+ NEUTRAL = 'neutral',
1496
+ /** Cozy's: a tint of the brand colour and brand-coloured text, with the same weight. */
1497
+ BRAND = 'brand',
1498
+ }
1499
+
1500
+ /** Where text is set in capitals. */
1501
+ export enum ThemeLetterCase {
1502
+ /** The default's: sentence case everywhere. */
1503
+ SENTENCE = 'sentence',
1504
+ /** Editorial's and terminal's: status badges in spaced capitals. */
1505
+ LABELS = 'labels',
1506
+ /** Trading's: controls, tabs, list items, badges and headings in capitals. */
1507
+ CONTROLS = 'controls',
1508
+ }
1509
+
1510
+ /** How heavy edges are. */
1511
+ export enum ThemeEdgeWeight {
1512
+ /** The default's: 1px edges in the border token. */
1513
+ HAIRLINE = 'hairline',
1514
+ /** Editorial's, terminal's, cozy's and trading's: 1px edges in a tint of the ink, which follows the palette's foreground. */
1515
+ INK = 'ink',
1516
+ /** Neo-brutalist's: 2px edges in the full ink, on panels, floating layers, controls, fields and badges. */
1517
+ BOLD = 'bold',
1518
+ }
1519
+
1520
+ /** A point on the ten axes. */
1521
+ export interface ThemePersonality {
1522
+ readonly density: ThemeDensity;
1523
+ readonly shape: ThemeShape;
1524
+ readonly elevation: ThemeElevation;
1525
+ readonly motion: ThemeMotion;
1526
+ readonly material: ThemeMaterial;
1527
+ readonly typeVoice: ThemeTypeVoice;
1528
+ readonly dangerStyle: ThemeDangerStyle;
1529
+ readonly selectionEmphasis: ThemeSelectionEmphasis;
1530
+ readonly letterCase: ThemeLetterCase;
1531
+ readonly edgeWeight: ThemeEdgeWeight;
1532
+ }
1533
+
1534
+ /** The default theme's point. */
1535
+ export const DEFAULT_THEME_PERSONALITY: ThemePersonality = {
1536
+ density: ThemeDensity.BALANCED,
1537
+ shape: ThemeShape.SOFT,
1538
+ elevation: ThemeElevation.SOFT,
1539
+ motion: ThemeMotion.BRISK,
1540
+ material: ThemeMaterial.SOLID,
1541
+ typeVoice: ThemeTypeVoice.NEUTRAL,
1542
+ dangerStyle: ThemeDangerStyle.EDGE,
1543
+ selectionEmphasis: ThemeSelectionEmphasis.NEUTRAL,
1544
+ letterCase: ThemeLetterCase.SENTENCE,
1545
+ edgeWeight: ThemeEdgeWeight.HAIRLINE,
1546
+ };
1547
+ ```
1548
+
1549
+ ### Origin Package: `@wildo-ai/presets-components-models`
1550
+
1551
+ ```typescript
1552
+ /**
1553
+ * The point a brand's visual tone names, read from its `styleKeywords` and `mood` against a small word list per
1554
+ * axis value. Deterministic: the same brand always gets the same point, and an axis no word reaches keeps the
1555
+ * default's value, so a brand that says nothing about density gets the default's density.
1556
+ *
1557
+ * @example
1558
+ * deriveThemePersonality({ styleKeywords: ['warm', 'rounded', 'playful'], mood: 'calm and friendly' });
1559
+ * // → comfortable · round · layered · springy · solid · neutral · edge · brand · sentence · hairline
1560
+ */
1561
+ export function deriveThemePersonality(visualTone: { readonly styleKeywords: readonly string[]; readonly mood?: string }): ThemePersonality
1562
+ ```