@wildo-ai/framework-knowledge 1.1.10 → 1.1.12

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 (1349) 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 +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +7 -5
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +628 -107
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  15. package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  17. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts +2 -0
  22. package/dist/esm/index.d.ts.map +1 -1
  23. package/dist/esm/index.js +2 -0
  24. package/dist/esm/index.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +10 -4
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +82 -15
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -5
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +4 -16
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  43. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
  47. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  51. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +38 -14
  56. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  58. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +20 -8
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  62. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  66. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  70. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  73. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +6 -2
  74. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +4 -3
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
  78. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  82. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  86. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  90. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  91. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +7 -3
  93. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  95. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  96. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  97. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  98. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +9 -7
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  100. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  101. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +9 -2
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  104. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +5 -2
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +15 -5
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  110. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  113. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  115. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  117. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  118. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  119. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  120. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  121. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  122. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  123. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  124. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  125. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  127. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  129. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  130. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +7 -3
  131. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  132. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +6 -4
  133. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  134. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  135. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  137. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  138. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  139. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  140. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  142. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +24 -9
  144. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
  146. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
  148. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  150. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  153. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  154. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  156. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  158. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  159. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  162. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  163. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  166. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  167. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  170. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  171. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +98 -0
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  174. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
  175. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  178. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  179. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  182. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +39 -20
  183. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  184. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  185. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  186. package/dist/esm/source-anchor-grammar.js +114 -0
  187. package/dist/esm/source-anchor-grammar.js.map +1 -0
  188. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  189. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  190. package/dist/knowledge/manifest.json +8 -8
  191. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -0
  192. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  193. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  194. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  195. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  196. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  197. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +788 -49
  198. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
  199. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
  200. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
  201. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  202. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  203. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
  204. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  205. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
  206. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  207. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  208. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  209. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  210. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +115 -2
  211. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
  212. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
  213. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
  214. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
  215. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  216. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
  217. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
  218. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  219. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  220. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +67 -5
  221. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
  222. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
  223. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
  224. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  225. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  226. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  227. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  228. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  229. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -5
  230. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
  231. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  232. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  233. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +153 -28
  234. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  235. package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
  236. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
  237. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
  238. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  239. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
  240. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  241. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  242. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
  243. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
  244. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  245. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  246. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  247. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  248. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  249. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  250. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  251. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.business-model/method.md +49 -11
  254. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  255. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  256. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  257. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  258. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +15 -5
  259. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  260. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  261. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  262. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  263. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  264. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  265. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  266. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  267. package/dist/knowledge/playbooks/top_down.definition/method.md +10 -3
  268. package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
  269. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  270. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
  271. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
  272. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  273. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  274. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  275. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  276. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  277. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  278. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  279. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  281. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  282. package/dist/knowledge/playbooks/top_down.risk-register/method.md +8 -1
  283. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  284. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  285. package/dist/knowledge/playbooks/top_down.service-method/method.md +216 -0
  286. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
  287. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  288. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  289. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  290. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  291. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +21 -2
  292. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
  293. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  294. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  295. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  296. package/dist/knowledge/references/application-maturity.config.md +28 -2
  297. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
  298. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
  299. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  300. package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
  301. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  302. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  303. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  304. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  305. package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
  306. package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
  307. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  308. package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
  309. package/dist/knowledge/references/capability-composition.config.md +4 -3
  310. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  311. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  312. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  313. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  314. package/dist/knowledge/references/companion.technical-doc.service.md +342 -76
  315. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  316. package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
  317. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  318. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  319. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  320. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  321. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  322. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  323. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
  324. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
  325. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  326. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  327. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +47 -0
  328. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  329. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  330. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  331. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  332. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  333. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  334. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
  335. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  336. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  337. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  338. package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
  339. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  340. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  341. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  342. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  343. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  344. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  345. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  346. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  347. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  348. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  349. package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
  350. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  351. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  352. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  353. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
  354. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  355. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  356. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  357. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
  358. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
  359. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
  360. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  361. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  362. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  363. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  364. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  365. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  366. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  367. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  368. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  369. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  370. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  371. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  372. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  373. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  374. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  375. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  376. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  377. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  378. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  379. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  380. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  381. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  382. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  383. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  384. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  385. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  386. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  387. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  388. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  389. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  390. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  391. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  392. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  393. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  394. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  395. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  396. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  397. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  398. package/dist/knowledge/references/experience-plan.config.md +127 -1
  399. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
  400. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  401. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  402. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
  403. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  404. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
  405. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  406. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
  407. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
  408. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
  409. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  410. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  411. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  412. package/dist/knowledge/references/integration-plan.config.md +28 -8
  413. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  414. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  415. package/dist/knowledge/references/placement-plan.config.md +94 -13
  416. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  417. package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
  418. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  419. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
  420. package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
  421. package/dist/knowledge/references/platform.config.saas.md +126 -32
  422. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  423. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  424. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  425. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  426. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  427. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  428. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  429. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  430. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  431. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  432. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  433. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  434. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  435. package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
  436. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  437. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  438. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  439. package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
  440. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  441. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  442. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  443. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
  444. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
  445. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
  446. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  447. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  448. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  449. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  450. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  451. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  452. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  453. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  454. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  455. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  456. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  457. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  458. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  459. package/dist/knowledge/references/saas.backend.domain-module.md +105 -1
  460. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  461. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  462. package/dist/knowledge/references/saas.backend.email.send.md +7 -0
  463. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
  464. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  465. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  466. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  467. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  468. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  469. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
  470. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  471. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
  472. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
  473. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  479. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
  480. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  481. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  482. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  483. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  484. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  485. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  486. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  487. package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
  488. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
  489. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  490. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  491. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  492. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  493. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  494. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  495. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  496. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  497. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  498. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  499. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  500. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  501. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  502. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  503. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  504. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  505. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  506. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  507. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  508. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  509. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  510. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
  511. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  513. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  514. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  515. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  516. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
  517. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  518. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  519. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  520. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
  521. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
  522. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
  523. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  524. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  525. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  526. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  527. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
  528. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  529. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  530. package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
  531. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
  532. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
  533. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
  534. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  535. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
  536. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
  537. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  538. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  539. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  540. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  541. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  542. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  543. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  544. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  545. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  546. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  547. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  548. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  549. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  550. package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
  551. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
  552. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  553. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  554. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  555. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  556. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  557. package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
  558. package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
  559. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
  560. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  561. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
  562. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
  563. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
  564. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
  565. package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
  566. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  567. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  568. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  569. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  570. package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
  571. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  572. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
  573. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  574. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  575. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  576. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
  577. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  578. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  579. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  580. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  581. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
  582. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
  583. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  584. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
  585. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  586. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
  587. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  588. package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
  589. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  590. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  591. package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
  592. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  593. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  594. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  595. package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
  596. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  597. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  598. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  599. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  600. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  601. package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
  602. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
  603. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  604. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  605. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
  606. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
  607. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  608. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  609. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  610. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
  611. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  612. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  613. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  614. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  615. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
  616. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
  617. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
  618. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  619. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
  620. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
  621. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  622. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  623. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  624. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  625. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +280 -40
  626. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  627. package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
  628. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  629. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  630. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
  631. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
  632. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  633. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  634. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  635. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  636. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  637. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  638. package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
  639. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
  640. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  641. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
  642. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  643. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  644. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  645. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  646. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  647. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  648. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  649. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  650. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
  651. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  652. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  653. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  654. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  655. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  656. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  657. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
  658. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  659. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
  660. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  661. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  662. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  663. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  664. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  665. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  666. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  667. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  668. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
  669. package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
  670. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  671. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  672. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +123 -0
  673. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
  674. package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
  675. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  676. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  677. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
  678. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  679. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  680. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  681. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
  682. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  683. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -2
  684. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  685. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +22 -4
  686. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  687. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  688. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  689. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  690. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
  691. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  692. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
  693. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  694. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  695. package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
  696. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  697. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  698. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  699. package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
  700. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  701. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
  702. package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
  703. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  704. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  705. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  706. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  707. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  708. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  709. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  710. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  711. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  712. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  713. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  714. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  715. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  716. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  717. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  718. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  719. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  720. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  721. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  722. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  723. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  724. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  725. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  726. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  727. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  728. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  729. package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
  730. package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
  731. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  732. package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
  733. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  734. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  735. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  736. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  737. package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
  738. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
  739. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  740. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  741. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
  742. package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
  743. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  744. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  745. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  746. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  747. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  748. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  749. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  750. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  751. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  752. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  753. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  754. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  755. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  756. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  757. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  758. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  759. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  760. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  761. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  762. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  763. package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
  764. package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
  765. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  766. package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
  767. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  768. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  769. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  770. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  771. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  772. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  773. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  774. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  775. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  776. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  777. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  778. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  779. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  780. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  781. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  782. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  783. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  784. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  785. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  786. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  787. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  788. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  789. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  790. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  791. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  792. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  793. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  794. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  795. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  796. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  797. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  798. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  799. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  800. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  801. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  802. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  803. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  804. package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
  805. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  806. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  807. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  808. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  809. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  810. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  811. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  812. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  813. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  814. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  815. package/dist/knowledge/references/service-method.config.md +303 -0
  816. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  817. package/dist/knowledge/references/website-plan.config.md +544 -32
  818. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  819. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  820. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  821. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  822. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
  823. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  824. package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
  825. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
  826. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
  827. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  828. package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
  829. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  830. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  831. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  832. package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
  833. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
  834. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
  835. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
  836. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
  837. package/dist/knowledge/references/zod.factories.code.md +18 -9
  838. package/dist/knowledge/references/zod.factories.duration.md +23 -14
  839. package/dist/knowledge/references/zod.factories.money.md +24 -15
  840. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  841. package/dist/knowledge/references/zod.factories.range.md +5 -1
  842. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  843. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  844. package/dist/knowledge/registries/framework-topics.json +5250 -2565
  845. package/dist/knowledge/registries/playbooks.json +88 -55
  846. package/dist/knowledge/registries/source-tags.json +9347 -4807
  847. package/dist/knowledge/rules/database-migration-obligation.md +10 -5
  848. package/dist/knowledge/rules/live-context-door.md +1 -1
  849. package/dist/knowledge/skills/INDEX.md +62 -33
  850. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  851. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
  852. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  853. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  854. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  855. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  856. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  857. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
  858. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  859. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  860. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  861. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
  862. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  863. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  864. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  865. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  866. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  867. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  868. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  869. package/dist/knowledge/skills/application-database-migrations/SKILL.md +26 -9
  870. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  871. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +37 -1
  872. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  873. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
  874. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  875. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +168 -3
  876. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
  877. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  878. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +66 -0
  879. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  880. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  881. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
  882. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
  883. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  884. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  885. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  886. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -2
  887. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  888. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  889. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  890. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  891. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  892. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  893. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  894. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
  895. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  896. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  897. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
  898. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  899. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  900. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  901. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  902. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  903. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +166 -0
  904. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
  905. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  906. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  907. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
  908. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  909. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  910. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
  911. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  912. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
  913. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
  914. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  915. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
  916. package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
  917. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  918. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  919. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  920. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  921. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  922. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +21 -6
  923. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
  924. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  925. package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
  926. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  927. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  928. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  929. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  930. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
  931. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
  932. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  933. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  934. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  935. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  936. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
  937. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  938. package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
  939. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
  940. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
  941. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
  942. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  943. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -11
  944. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  945. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -10
  946. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
  947. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
  948. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
  949. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  950. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
  951. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  952. package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
  953. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  954. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  955. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  956. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  957. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
  958. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  959. package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
  960. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
  961. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  962. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  963. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  964. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  965. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  966. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  967. package/dist/knowledge/skills/email-add-template/SKILL.md +47 -6
  968. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  969. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +10 -2
  970. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  971. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  972. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
  973. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
  974. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
  975. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  976. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
  977. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  978. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  979. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  980. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
  981. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
  982. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
  983. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
  984. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
  985. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
  986. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  987. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  988. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +10 -3
  989. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
  990. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
  991. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
  992. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
  993. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  994. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  995. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
  996. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  997. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
  998. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
  999. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  1000. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
  1001. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
  1002. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
  1003. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  1004. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
  1005. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
  1006. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
  1007. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  1008. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  1009. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  1010. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  1011. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  1012. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  1013. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
  1014. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  1015. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
  1016. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  1017. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  1018. package/dist/knowledge/skills/inbound-channels/SKILL.md +93 -13
  1019. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
  1020. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
  1021. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  1022. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
  1023. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  1024. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
  1025. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
  1026. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  1027. package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
  1028. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  1029. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +140 -7
  1030. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
  1031. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
  1032. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  1033. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  1034. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  1035. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  1036. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  1037. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  1038. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  1039. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  1040. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  1041. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  1042. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  1043. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  1044. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  1045. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  1046. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +7 -5
  1047. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  1048. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  1049. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  1050. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  1051. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
  1052. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
  1053. package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
  1054. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
  1055. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  1056. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  1057. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
  1058. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
  1059. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  1060. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  1061. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
  1062. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  1063. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
  1064. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
  1065. package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
  1066. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  1067. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  1068. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
  1069. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  1070. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  1071. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
  1072. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
  1073. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
  1074. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  1075. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  1076. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  1077. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
  1078. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  1079. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  1080. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
  1081. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  1082. package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
  1083. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
  1084. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  1085. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  1086. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  1087. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +13 -0
  1088. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
  1089. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -0
  1090. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  1091. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  1092. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +72 -8
  1093. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  1094. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
  1095. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
  1096. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
  1097. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  1098. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  1099. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
  1100. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  1101. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  1102. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  1103. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  1104. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  1105. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
  1106. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
  1107. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  1108. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  1109. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  1110. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
  1111. package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
  1112. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  1113. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +165 -44
  1114. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
  1115. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  1116. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
  1117. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  1118. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  1119. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
  1120. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
  1121. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
  1122. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
  1123. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  1124. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +200 -61
  1125. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  1126. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  1127. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
  1128. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  1129. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +8 -6
  1130. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
  1131. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
  1132. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
  1133. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
  1134. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  1135. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  1136. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
  1137. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  1138. package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
  1139. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  1140. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  1141. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
  1142. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  1143. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
  1144. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
  1145. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  1146. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
  1147. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  1148. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  1149. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  1150. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
  1151. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  1152. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  1153. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  1154. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  1155. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
  1156. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  1157. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  1158. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
  1159. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
  1160. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  1161. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  1162. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
  1163. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
  1164. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  1165. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  1166. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +21 -3
  1167. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
  1168. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  1169. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  1170. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  1171. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +46 -0
  1172. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  1173. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
  1174. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  1175. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
  1176. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  1177. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +4 -0
  1178. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
  1179. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  1180. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
  1181. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
  1182. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
  1183. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
  1184. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
  1185. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  1186. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
  1187. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -0
  1188. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  1189. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  1190. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  1191. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  1192. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +219 -77
  1193. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
  1194. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
  1195. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  1196. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  1197. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
  1198. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  1199. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  1200. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  1201. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +223 -6
  1202. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
  1203. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  1204. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +138 -0
  1205. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
  1206. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
  1207. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  1208. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  1209. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  1210. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  1211. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  1212. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  1213. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  1214. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
  1215. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
  1216. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
  1217. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  1218. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  1219. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  1220. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +30 -2
  1221. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
  1222. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  1223. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +186 -83
  1224. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  1225. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +113 -70
  1226. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  1227. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  1228. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  1229. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  1230. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
  1231. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
  1232. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  1233. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1234. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  1235. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +41 -5
  1236. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  1237. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  1238. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +15 -4
  1239. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  1240. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
  1241. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
  1242. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
  1243. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
  1244. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
  1245. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  1246. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  1247. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  1248. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  1249. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  1250. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
  1251. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  1252. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
  1253. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
  1254. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
  1255. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
  1256. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  1257. package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
  1258. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
  1259. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
  1260. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  1261. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  1262. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  1263. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
  1264. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  1265. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
  1266. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  1267. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
  1268. package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
  1269. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  1270. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
  1271. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  1272. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  1273. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  1274. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
  1275. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  1276. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  1277. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  1278. package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
  1279. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  1280. package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
  1281. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  1282. package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
  1283. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1284. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1285. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
  1286. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1287. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
  1288. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1289. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
  1290. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1291. package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
  1292. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1293. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1294. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1295. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1296. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1297. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1298. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1299. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1300. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1301. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1302. package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
  1303. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
  1304. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1305. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
  1306. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1307. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1308. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1309. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1310. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1311. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1312. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1313. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1314. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1315. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1316. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1317. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
  1318. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1319. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1320. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1321. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1322. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1323. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1324. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1325. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1326. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
  1327. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
  1328. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
  1329. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
  1330. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1331. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1332. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  1333. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1334. package/dist/knowledge/topic-index.json +17998 -8568
  1335. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1336. package/package.json +6 -6
  1337. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1338. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
  1339. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1340. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1341. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1342. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1343. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1344. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1345. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1346. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1347. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1348. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
  1349. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -0,0 +1,3050 @@
1
+ # Website building blocks — API (source-backed)
2
+
3
+ The blocks a section composes, their layout vocabulary, how a section declares the words they read, how a link
4
+ resolves, and the stylesheet hooks a site adjusts them through. Read it when you need a block's exact props, a slot
5
+ name, or the hook a CSS rule should target.
6
+
7
+ ## The layout vocabulary
8
+
9
+ ## Import Origins
10
+
11
+ - `@wildo-ai/saas-website`
12
+
13
+ ## Source Excerpts
14
+
15
+ ### Origin Package: `@wildo-ai/saas-website`
16
+
17
+ ```typescript
18
+ *
19
+ * The layout vocabulary of the engine's building blocks (#2742). A block's LAYOUT is chosen per use and is never its
20
+ * section category: one card grid serves a feature summary, an integrations list and a values section.
21
+ */
22
+
23
+ /** How much vertical room a band takes (`rhythm.section`, `rhythm.sectionCompact`, `rhythm.strip`). */
24
+ export enum WebsiteBandSpacing {
25
+ /** A section. */
26
+ DEFAULT = 'default',
27
+ /** A section that should not dominate: a short note between two long sections. */
28
+ COMPACT = 'compact',
29
+ /** A thin row between hairlines: a logo strip, a marquee. */
30
+ STRIP = 'strip',
31
+ }
32
+
33
+ /** How a section's intro sits. */
34
+ export enum WebsiteIntroAlign {
35
+ /** Centred above the content: most sections. */
36
+ CENTER = 'center',
37
+ /** Aligned with the content's start edge: an intro beside a list, an FAQ's side column. */
38
+ START = 'start',
39
+ }
40
+
41
+ /** How an eyebrow (the label above a heading) is drawn. */
42
+ export enum WebsiteEyebrowStyle {
43
+ /** The overline type role in the brand colour. */
44
+ PLAIN = 'plain',
45
+ /** A pill with the accent's dot: the hero's opening line. */
46
+ PILL = 'pill',
47
+ }
48
+
49
+ /** How a hero lays out its copy and its visual. */
50
+ export enum WebsiteHeroLayout {
51
+ /** The copy centred above a full-width visual: the home page's product stage. */
52
+ STAGE = 'stage',
53
+ /** The copy beside the visual, the visual taking the larger column: a product or solution page. */
54
+ SPLIT = 'split',
55
+ /** No visual: the copy centred, a shorter opening. Used automatically when no visual is given. */
56
+ COMPACT = 'compact',
57
+ }
58
+
59
+ /** What a hero draws behind its content. */
60
+ export enum WebsiteHeroSurface {
61
+ /** The band's own background. */
62
+ PLAIN = 'plain',
63
+ /** A soft glow of the brand's colour from the top. */
64
+ GLOW = 'glow',
65
+ /** The glow over a faint grid that fades toward the edges. */
66
+ GLOW_GRID = 'glow-grid',
67
+ }
68
+
69
+ /** Which side of a feature row the visual sits on; alternate them so consecutive rows zig-zag. */
70
+ export enum WebsiteFeatureRowLayout {
71
+ /** The copy first, the visual after it (on the right in a left-to-right page). */
72
+ VISUAL_END = 'visual-end',
73
+ /** The visual first. */
74
+ VISUAL_START = 'visual-start',
75
+ }
76
+
77
+ /** How many columns a card grid has on a wide screen. On smaller screens 4 narrows to 2 then 1; 2 and 3 go to 1. */
78
+ export type WebsiteCardGridColumns = 2 | 3 | 4;
79
+
80
+ /** How a grid of cards lays out its columns: a fixed count, or as many as fit (`layout.cardMin` wide at least). */
81
+ export enum WebsiteGridFit {
82
+ /** The `columns` the block is given, narrowing on smaller screens. */
83
+ FIXED = 'fixed',
84
+ /** As many columns as fit, each at least the theme's card width: right for a list whose length varies. */
85
+ AUTO = 'auto',
86
+ }
87
+
88
+ /** How the steps of a process run. */
89
+ export enum WebsiteStepsLayout {
90
+ /** Side by side, left to right, stacking on a narrow screen: three or four short steps. */
91
+ ROW = 'row',
92
+ /** One under the other: longer steps, or more of them. */
93
+ STACK = 'stack',
94
+ }
95
+
96
+ /** How big an icon tile is: the square of colour behind a glyph. */
97
+ export enum WebsiteIconTileSize {
98
+ /** Beside a line of text: a point of a list. */
99
+ SM = 'sm',
100
+ /** Leading a card. */
101
+ MD = 'md',
102
+ /** Leading a card that is a choice: a path, a plan. */
103
+ LG = 'lg',
104
+ }
105
+
106
+ /** How an icon tile is coloured. */
107
+ export enum WebsiteIconTileStyle {
108
+ /** The glyph in the tone's primary on a wash of it: quiet, the default. */
109
+ WASH = 'wash',
110
+ /** The glyph in the tone's background on its foreground: strong, for a card that is a choice. */
111
+ SOLID = 'solid',
112
+ }
113
+
114
+ /**
115
+ * How long a product tour's tab stays before the tour moves on, while it rotates (ms). One value for the component's
116
+ * clock and the stylesheet's countdown line, so the line always ends as the tab changes.
117
+ */
118
+ export const WEBSITE_PRODUCT_TOUR_DWELL_MS = 7000;
119
+
120
+ /** How long a marquee's strip takes to scroll one copy of its list (s): slow enough to read a pill as it passes. */
121
+ export const WEBSITE_MARQUEE_LOOP_SECONDS = 38;
122
+
123
+ /** How much of a bento's row a tile takes: a third, or a half. */
124
+ export enum WebsiteBentoTileSize {
125
+ /** A third of the row: three tiles side by side. */
126
+ REGULAR = 'regular',
127
+ /** Half the row: the capability that leads, or a drawing that needs the room. */
128
+ WIDE = 'wide',
129
+ }
130
+
131
+ /** How an FAQ lays out its intro and its questions. */
132
+ export enum WebsiteFaqLayout {
133
+ /** The intro in a narrow column beside the questions. */
134
+ SIDE = 'side',
135
+ /** The intro above the questions. */
136
+ STACKED = 'stacked',
137
+ }
138
+
139
+ /**
140
+ * A block's motion, point by point: each named point of the block takes a `WebsiteMotionSpec`, or `null` to keep
141
+ * that point still. Points left out keep the block's defaults. The vocabulary is the engine's (`websiteMotion`), so a
142
+ * block's motion follows the site's tempo and stops under reduced motion like everything else.
143
+ */
144
+ export type WebsiteBlockMotion<TPoint extends string> = Partial<Readonly<Record<TPoint, WebsiteMotionSpec | null>>>;
145
+
146
+ /**
147
+ * What a block's motion point IS, which decides what motion it may take (#2742 step 4). A block declares each of its
148
+ * points with a kind, and says whether the point belongs to the page's OPENING (the load sequence). Its default and
149
+ * every override are checked against both, so a site, a skill or the creation lane can only ask a point for motion that
150
+ * makes sense there. The rules are a table total over the kinds (`WEBSITE_MOTION_POINT_RULES`): a new kind does not
151
+ * compile until its rules are decided.
152
+ */
153
+ export enum WebsiteMotionPointKind {
154
+ /** Copy that arrives as a whole: an intro, a feature row's copy, a closing band, a table, a line of the hero. */
155
+ COPY = 'copy',
156
+ /** A list or grid whose children arrive one after another. */
157
+ GROUP = 'group',
158
+ /** A card that is a link. */
159
+ LINK_CARD = 'link-card',
160
+ /** A drawing or an image: the hero's visual, a feature row's visual. */
161
+ MEDIA = 'media',
162
+ }
163
+
164
+ /** What a kind of point may take. */
165
+ export interface WebsiteMotionPointRules {
166
+ /** It may sequence its children (`stagger`). */
167
+ readonly stagger: boolean;
168
+ /** It may answer the pointer (`hover`). */
169
+ readonly hover: boolean;
170
+ /** It may arrive itself (`reveal`). */
171
+ readonly reveal: boolean;
172
+ /** It may take a scroll effect, or arrive by unveiling. */
173
+ readonly media: boolean;
174
+ }
175
+
176
+ export const WEBSITE_MOTION_POINT_RULES: Readonly<Record<WebsiteMotionPointKind, WebsiteMotionPointRules>> = {
177
+ [WebsiteMotionPointKind.COPY]: { stagger: false, hover: false, reveal: true, media: false },
178
+ [WebsiteMotionPointKind.GROUP]: { stagger: true, hover: false, reveal: true, media: false },
179
+ // A link card never arrives itself: its group sequences it.
180
+ [WebsiteMotionPointKind.LINK_CARD]: { stagger: false, hover: true, reveal: false, media: false },
181
+ [WebsiteMotionPointKind.MEDIA]: { stagger: false, hover: false, reveal: true, media: true },
182
+ };
183
+
184
+ /** One motion point of a block: what it is, whether it belongs to the page's opening, and how it moves by default. */
185
+ export interface WebsiteMotionPointDefault {
186
+ readonly kind: WebsiteMotionPointKind;
187
+ /**
188
+ * The point is part of the page's opening: it plays on load, in its `order`. Only such a point may take
189
+ * `trigger: LOAD`, and such a point takes a load reveal or no motion at all (no in-view reveal, no stagger, no scroll
190
+ * effect, no hover), so the opening is exactly the points the blocks declare as such: the hero's eyebrow, headline,
191
+ * lede, actions, note and visual. Whether a page has more than one opening (two heroes) is the page motion plan's
192
+ * question, not a point's.
193
+ */
194
+ readonly opening?: boolean;
195
+ readonly spec: WebsiteMotionSpec | null;
196
+ }
197
+
198
+ /** Why a spec does not fit a point, or null when it fits. */
199
+ export function websiteMotionPointMisfit(kind: WebsiteMotionPointKind, spec: WebsiteMotionSpec | null, opening = false): string | null {
200
+ if (spec === null) return null;
201
+ // One widened view: the exclusive union is the caller's contract (see `websiteMotion`).
202
+ const { reveal, trigger, stagger, scroll, hover } = spec as {
203
+ readonly reveal?: WebsiteMotionReveal;
204
+ readonly trigger?: WebsiteMotionTrigger;
205
+ readonly stagger?: WebsiteMotionReveal;
206
+ readonly scroll?: WebsiteMotionScrollEffect;
207
+ readonly hover?: WebsiteMotionHover;
208
+ };
209
+ const rules = WEBSITE_MOTION_POINT_RULES[kind];
210
+ const moves = (value: WebsiteMotionReveal | undefined) => value !== undefined && value !== WebsiteMotionReveal.NONE;
211
+ const scrolls = scroll !== undefined && scroll !== WebsiteMotionScrollEffect.NONE;
212
+ // The kinds the table allows a capability, so a message names them from the same table that decided.
213
+ const allowed = (rule: keyof WebsiteMotionPointRules): string[] =>
214
+ (Object.keys(WEBSITE_MOTION_POINT_RULES) as WebsiteMotionPointKind[])
215
+ .filter((candidate) => WEBSITE_MOTION_POINT_RULES[candidate][rule])
216
+ .map((candidate) => candidate.toUpperCase().replace(/-/g, '_'));
217
+ const refused = (what: string, rule: keyof WebsiteMotionPointRules): string => {
218
+ const kinds = allowed(rule);
219
+ return `a ${kind.toUpperCase().replace(/-/g, '_')} point does not ${what}: ${kinds.length === 0 ? 'no kind does' : `only ${kinds.join(' or ')} does`}`;
220
+ };
221
+ if (moves(stagger) && !rules.stagger) return refused('sequence its children (stagger)', 'stagger');
222
+ const hovers = hover !== undefined && hover !== WebsiteMotionHover.NONE;
223
+ if (hovers && !rules.hover) return refused('answer the pointer (hover)', 'hover');
224
+ if (moves(reveal) && !rules.reveal) return refused('reveal itself', 'reveal');
225
+ if (scrolls && !rules.media) return refused('take a scroll effect', 'media');
226
+ if ((reveal === WebsiteMotionReveal.UNVEIL || stagger === WebsiteMotionReveal.UNVEIL) && !rules.media) return refused('unveil', 'media');
227
+ const onLoad = moves(reveal) && trigger === WebsiteMotionTrigger.LOAD;
228
+ if (onLoad && !opening) return 'only a point of the page\'s opening plays on load';
229
+ if (opening && (moves(stagger) || scrolls || hovers)) return 'a point of the page\'s opening takes a load reveal or no motion at all';
230
+ if (opening && moves(reveal) && !onLoad) return 'a point of the page\'s opening plays on load, in its order';
231
+ return null;
232
+ }
233
+ ```
234
+
235
+ ## A section is a configured block
236
+
237
+ Prefer this over composing a section by hand: `<block>.section({ pageRef, sectionRef, category, band, intro, config })`
238
+ renders the block from `config` and derives the section's words from the same `config`.
239
+
240
+ ## Import Origins
241
+
242
+ - `@wildo-ai/saas-website`
243
+
244
+ ## Source Excerpts
245
+
246
+ ### Origin Package: `@wildo-ai/saas-website`
247
+
248
+ ```tsx
249
+ *
250
+ * A block as a CONFIGURABLE section (#2742): the engine binds each block's renderer to the words it reads, so a
251
+ * section is configured, not written. `websiteHeroBlock.section({ pageRef, sectionRef, category, config })` is the
252
+ * whole section: the block renders the config, and the section's words are derived from THE SAME config, so a
253
+ * section cannot declare a word it does not render or render one it does not declare.
254
+ *
255
+ * Two properties of a block decide what the section around it may add, and the section input's TYPE follows them:
256
+ *
257
+ * - where it stands (`WebsiteBlockSurface`): `BAND`, on a band the section draws (`band`: tone, spacing,
258
+ * decoration); `OWN`, on a surface it draws itself (a hero, a call-to-action band), its tone in its config;
259
+ * - whether it has its own heading (`WebsiteBlockHeading`): `SECTION_INTRO`, the section may put its intro (eyebrow,
260
+ * heading, lede) above it (`intro`); `OWN`, it carries its own (a feature row, a FAQ, a hero), and a second heading
261
+ * above it would make one section with two titles.
262
+ *
263
+ * A config may hold nodes that read words of their own (a hero's visual, a tour's screens, a bento's drawings):
264
+ * declare those with `nodeSlots`, under the prefix the node reads them by.
265
+ */
266
+ export enum WebsiteBlockSurface {
267
+ /** The block stands on a band the section draws. */
268
+ BAND = 'band',
269
+ /** The block draws its own surface: the section adds no band. */
270
+ OWN = 'own',
271
+ }
272
+
273
+ export enum WebsiteBlockHeading {
274
+ /** The section may put its intro above the block. */
275
+ SECTION_INTRO = 'section-intro',
276
+ /** The block carries its own heading: the section adds no intro. */
277
+ OWN = 'own',
278
+ }
279
+
280
+ interface WebsiteBlockSectionCommonInput<TConfig> {
281
+ readonly pageRef: string;
282
+ readonly sectionRef: string;
283
+ /** What the section is for: a block serves several categories (a card grid lists benefits or integrations). */
284
+ readonly category: WebsiteSectionCategory;
285
+ /** The block's configuration: everything it renders, the same object its words are derived from. */
286
+ readonly config: TConfig;
287
+ /** Words read by nodes inside the config (a visual's drawing), already under the prefix the node reads them by. */
288
+ readonly nodeSlots?: readonly string[];
289
+ /** The section's DOM id, so a link can target it (`#pricing`). */
290
+ readonly anchorId?: string;
291
+ readonly getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
292
+ }
293
+
294
+ /** The band a block standing on one is drawn on. */
295
+ export interface WebsiteBlockSectionBandInput {
296
+ readonly band?: Omit<WebsiteBandProps, 'children'>;
297
+ }
298
+
299
+ /** The section intro above a block that takes one; absent: none. Its eyebrow and lede flags decide its words. */
300
+ export interface WebsiteBlockSectionIntroInput {
301
+ readonly intro?: Omit<WebsiteSectionIntroProps, 'children'>;
302
+ }
303
+
304
+ /** What `section(...)` takes for a block standing where `TSurface` says, with the heading `THeading` says. */
305
+ export type WebsiteBlockSectionInput<TConfig, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> = WebsiteBlockSectionCommonInput<TConfig> &
306
+ (TSurface extends WebsiteBlockSurface.BAND ? WebsiteBlockSectionBandInput : Record<never, never>) &
307
+ (THeading extends WebsiteBlockHeading.SECTION_INTRO ? WebsiteBlockSectionIntroInput : Record<never, never>);
308
+
309
+ export interface WebsiteBlock<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> {
310
+ readonly surface: TSurface;
311
+ readonly heading: THeading;
312
+ /** The words the block reads for a configuration, as slots of the section. */
313
+ readonly slots: (config: TConfig) => string[];
314
+ /** The block's renderer. */
315
+ readonly Component: ComponentType<TConfig>;
316
+ /** The block as a whole section, its words derived from its config (see the module comment). */
317
+ readonly section: (input: WebsiteBlockSectionInput<TConfig, TSurface, THeading>) => TypedWebsiteSectionDefinition;
318
+ }
319
+
320
+ export interface DefineWebsiteBlockInput<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> {
321
+ readonly surface: TSurface;
322
+ readonly heading: THeading;
323
+ readonly slots: (config: TConfig) => string[];
324
+ readonly Component: ComponentType<TConfig>;
325
+ }
326
+
327
+ export function defineWebsiteBlock<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading>(
328
+ definition: DefineWebsiteBlockInput<TConfig, TSurface, THeading>,
329
+ ): WebsiteBlock<TConfig, TSurface, THeading> {
330
+ const { surface, heading, slots, Component } = definition;
331
+ const section = (input: WebsiteBlockSectionInput<TConfig, TSurface, THeading>): TypedWebsiteSectionDefinition => {
332
+ const common: WebsiteBlockSectionCommonInput<TConfig> & WebsiteBlockSectionBandInput & WebsiteBlockSectionIntroInput = input;
333
+ // The types already refuse a band or an intro where the block does not take one; a value forced past them is ignored.
334
+ const banded = surface === WebsiteBlockSurface.BAND ? common : undefined;
335
+ const intro = heading === WebsiteBlockHeading.SECTION_INTRO ? common.intro : undefined;
336
+ const sectionSlots = [...(intro === undefined ? [] : websiteSectionIntroSlots(intro)), ...slots(common.config), ...(common.nodeSlots ?? [])];
337
+ const block = <Component {...common.config} />;
338
+ const SectionBody = (): ReactNode =>
339
+ banded === undefined ? (
340
+ block
341
+ ) : (
342
+ <WebsiteBand {...(banded.band ?? {})}>
343
+ {intro === undefined ? null : <WebsiteSectionIntro {...intro} />}
344
+ {block}
345
+ </WebsiteBand>
346
+ );
347
+ SectionBody.displayName = `WebsiteBlockSection(${common.sectionRef})`;
348
+ return defineWebsiteBlockSection({
349
+ pageRef: common.pageRef,
350
+ sectionRef: common.sectionRef,
351
+ category: common.category,
352
+ slots: sectionSlots,
353
+ Component: SectionBody,
354
+ ...(common.anchorId === undefined ? {} : { anchorId: common.anchorId }),
355
+ ...(common.getStructuredData === undefined ? {} : { getStructuredData: common.getStructuredData }),
356
+ });
357
+ };
358
+ return { surface, heading, slots, Component, section };
359
+ }
360
+ ```
361
+
362
+ ## Import Origins
363
+
364
+ - `@wildo-ai/saas-website`
365
+
366
+ ## Source Excerpts
367
+
368
+ ### Origin Package: `@wildo-ai/saas-website`
369
+
370
+ ```typescript
371
+ *
372
+ * Every engine block as a configurable section (`defineWebsiteBlock`): configure the block, and the section's words
373
+ * follow from the configuration. `websiteCardGridBlock.section({ pageRef, sectionRef, category, band, intro, config })`
374
+ * is a whole section; `websiteHeroBlock.section({ … config })` too, without band or intro since a hero draws its own
375
+ * surface and heading. The hero, the call-to-action band, the feature row and the FAQ carry their own heading.
376
+ *
377
+ * Pricing is not here: its words depend on the plans the catalogue publishes, which a section reads when it renders,
378
+ * so it is still declared with `defineWebsiteBlockSection` and `websitePricingSlots`.
379
+ */
380
+ export const websiteHeroBlock: WebsiteBlock<WebsiteHeroProps, WebsiteBlockSurface.OWN, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
381
+ surface: WebsiteBlockSurface.OWN,
382
+ heading: WebsiteBlockHeading.OWN,
383
+ slots: (config) => websiteHeroSlots(config),
384
+ Component: WebsiteHero,
385
+ });
386
+
387
+ export const websiteCtaBandBlock: WebsiteBlock<WebsiteCtaBandProps, WebsiteBlockSurface.OWN, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
388
+ surface: WebsiteBlockSurface.OWN,
389
+ heading: WebsiteBlockHeading.OWN,
390
+ slots: (config) => websiteCtaBandSlots(config),
391
+ Component: WebsiteCtaBand,
392
+ });
393
+
394
+ export const websiteFeatureRowBlock: WebsiteBlock<WebsiteFeatureRowProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
395
+ surface: WebsiteBlockSurface.BAND,
396
+ heading: WebsiteBlockHeading.OWN,
397
+ slots: (config) => websiteFeatureRowSlots(config),
398
+ Component: WebsiteFeatureRow,
399
+ });
400
+
401
+ export const websiteCardGridBlock: WebsiteBlock<WebsiteCardGridProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
402
+ surface: WebsiteBlockSurface.BAND,
403
+ heading: WebsiteBlockHeading.SECTION_INTRO,
404
+ slots: (config) => websiteCardGridSlots(config.items),
405
+ Component: WebsiteCardGrid,
406
+ });
407
+
408
+ export const websiteBentoBlock: WebsiteBlock<WebsiteBentoProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
409
+ surface: WebsiteBlockSurface.BAND,
410
+ heading: WebsiteBlockHeading.SECTION_INTRO,
411
+ slots: (config) => websiteBentoSlots(config.tiles),
412
+ Component: WebsiteBento,
413
+ });
414
+
415
+ export const websiteProductTourBlock: WebsiteBlock<WebsiteProductTourProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
416
+ surface: WebsiteBlockSurface.BAND,
417
+ heading: WebsiteBlockHeading.SECTION_INTRO,
418
+ slots: (config) => websiteProductTourSlots(config.tabs),
419
+ Component: WebsiteProductTour,
420
+ });
421
+
422
+ export const websiteMarqueeBlock: WebsiteBlock<WebsiteMarqueeProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
423
+ surface: WebsiteBlockSurface.BAND,
424
+ heading: WebsiteBlockHeading.SECTION_INTRO,
425
+ slots: (config) => websiteMarqueeSlots(config.items, config.label === undefined ? {} : { label: config.label }),
426
+ Component: WebsiteMarquee,
427
+ });
428
+
429
+ export const websiteFaqBlock: WebsiteBlock<WebsiteFaqProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
430
+ surface: WebsiteBlockSurface.BAND,
431
+ heading: WebsiteBlockHeading.OWN,
432
+ slots: (config) => websiteFaqSlots(config.questions, config.intro),
433
+ Component: WebsiteFaq,
434
+ });
435
+
436
+ export const websiteStepsBlock: WebsiteBlock<WebsiteStepsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
437
+ surface: WebsiteBlockSurface.BAND,
438
+ heading: WebsiteBlockHeading.SECTION_INTRO,
439
+ slots: (config) => websiteStepsSlots(config.steps),
440
+ Component: WebsiteSteps,
441
+ });
442
+
443
+ export const websiteStatsBlock: WebsiteBlock<WebsiteStatsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
444
+ surface: WebsiteBlockSurface.BAND,
445
+ heading: WebsiteBlockHeading.SECTION_INTRO,
446
+ slots: (config) => websiteStatsSlots(config.stats),
447
+ Component: WebsiteStats,
448
+ });
449
+
450
+ export const websiteQuoteCardsBlock: WebsiteBlock<WebsiteQuoteCardsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
451
+ surface: WebsiteBlockSurface.BAND,
452
+ heading: WebsiteBlockHeading.SECTION_INTRO,
453
+ slots: (config) => websiteQuoteCardsSlots(config.quotes),
454
+ Component: WebsiteQuoteCards,
455
+ });
456
+
457
+ export const websiteRoadmapBlock: WebsiteBlock<WebsiteRoadmapProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
458
+ surface: WebsiteBlockSurface.BAND,
459
+ heading: WebsiteBlockHeading.SECTION_INTRO,
460
+ slots: (config) => websiteRoadmapSlots(config.phases),
461
+ Component: WebsiteRoadmap,
462
+ });
463
+
464
+ export const websiteSolutionPathsBlock: WebsiteBlock<WebsiteSolutionPathsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
465
+ surface: WebsiteBlockSurface.BAND,
466
+ heading: WebsiteBlockHeading.SECTION_INTRO,
467
+ slots: (config) => websiteSolutionPathsSlots(config.paths),
468
+ Component: WebsiteSolutionPaths,
469
+ });
470
+
471
+ export const websiteLatestPostsBlock: WebsiteBlock<WebsiteLatestPostsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
472
+ surface: WebsiteBlockSurface.BAND,
473
+ heading: WebsiteBlockHeading.SECTION_INTRO,
474
+ slots: (config) => websiteLatestPostsSlots(config),
475
+ Component: WebsiteLatestPosts,
476
+ });
477
+
478
+ export const websiteComparisonTableBlock: WebsiteBlock<WebsiteComparisonTableProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
479
+ surface: WebsiteBlockSurface.BAND,
480
+ heading: WebsiteBlockHeading.SECTION_INTRO,
481
+ slots: (config) => websiteComparisonTableSlots(config.rows, config.columns),
482
+ Component: WebsiteComparisonTable,
483
+ });
484
+
485
+ export const websiteFactTableBlock: WebsiteBlock<WebsiteFactTableProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
486
+ surface: WebsiteBlockSurface.BAND,
487
+ heading: WebsiteBlockHeading.SECTION_INTRO,
488
+ slots: (config) => websiteFactTableSlots(config.rows, config.columns),
489
+ Component: WebsiteFactTable,
490
+ });
491
+ ```
492
+
493
+ ## Declaring a section's words: slots
494
+
495
+ ## Import Origins
496
+
497
+ - `@wildo-ai/saas-website`
498
+
499
+ ## Source Excerpts
500
+
501
+ ### Origin Package: `@wildo-ai/saas-website`
502
+
503
+ ```typescript
504
+ *
505
+ * How a section built from the engine's blocks declares its words (#2742). Every block reads its words by SLOT
506
+ * (`heading`, `cta.primary`, `item3.title`) and exports the slot list it reads for a given configuration
507
+ * (`websiteHeroSlots({ note: true })`). A section declares exactly the union of the blocks it renders, so the label
508
+ * audit demands precisely what is rendered, in every locale, and nothing else.
509
+ *
510
+ * - `websiteSectionLabelKeys(pageRef, sectionRef, slots)`: the full keys (`website.<page>.<section>.<slot>`).
511
+ * - `numberedWebsiteSlots('item', 3, ['title', 'body'])`: `item1.title`, `item1.body`, … `item3.body`.
512
+ * - `prefixedWebsiteSlots('demo', slots)`: `demo.<slot>`, so one block's slots can sit beside another's.
513
+ * - `defineWebsiteBlockSection(...)`: a section from its slots, refusing a slot declared twice (two blocks reading
514
+ * one word would be one word doing two jobs).
515
+ */
516
+ export function websiteSectionLabelKeys(pageRef: string, sectionRef: string, slots: readonly string[]): string[] {
517
+ return slots.map((slot) => `website.${pageRef}.${sectionRef}.${slot}`);
518
+ }
519
+
520
+ export function numberedWebsiteSlots(prefix: string, count: number, suffixes: readonly string[]): string[] {
521
+ return Array.from({ length: count }, (_, index) => suffixes.map((suffix) => `${prefix}${index + 1}.${suffix}`)).flat();
522
+ }
523
+
524
+ export function prefixedWebsiteSlots(prefix: string, slots: readonly string[]): string[] {
525
+ return slots.map((slot) => `${prefix}.${slot}`);
526
+ }
527
+
528
+ export interface DefineWebsiteBlockSectionInput {
529
+ readonly pageRef: string;
530
+ readonly sectionRef: string;
531
+ readonly category: WebsiteSectionCategory;
532
+ /** The union of the slots the section's blocks read. */
533
+ readonly slots: readonly string[];
534
+ /** The section's body, mounted as `<Component />`: one that requires a prop is refused at compile time, as by `defineWebsiteSection`. */
535
+ readonly Component: ComponentType<WebsiteSectionComponentProps>;
536
+ /** The section's DOM id, so a link can target it (`#pricing`). */
537
+ readonly anchorId?: string;
538
+ readonly getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
539
+ }
540
+
541
+ export function defineWebsiteBlockSection(input: DefineWebsiteBlockSectionInput): TypedWebsiteSectionDefinition {
542
+ const seen = new Set<string>();
543
+ for (const slot of input.slots) {
544
+ if (seen.has(slot)) throw new Error(`[website] Section "${input.sectionRef}" declares the slot "${slot}" twice.`);
545
+ seen.add(slot);
546
+ }
547
+ return defineWebsiteSection({
548
+ sectionRef: input.sectionRef,
549
+ category: input.category,
550
+ expectedLabelKeys: websiteSectionLabelKeys(input.pageRef, input.sectionRef, input.slots),
551
+ Component: input.Component,
552
+ ...(input.anchorId === undefined ? {} : { anchorId: input.anchorId }),
553
+ ...(input.getStructuredData === undefined ? {} : { getStructuredData: input.getStructuredData }),
554
+ });
555
+ }
556
+ ```
557
+
558
+ ## Import Origins
559
+
560
+ - `@wildo-ai/saas-website`
561
+
562
+ ## Source Excerpts
563
+
564
+ ### Origin Package: `@wildo-ai/saas-website`
565
+
566
+ ```typescript
567
+ *
568
+ * Every word of the CURRENT section, by slot: returns `label(slot)`, the same lookup as `useWebsiteLabel(slot)`. One
569
+ * hook call, so a component can read the words of a list of any length (`label(`${item}.title`)` inside a `.map`)
570
+ * without calling a hook in a loop. A missing word renders its key, as `useWebsiteLabel` does, so it looks missing.
571
+ */
572
+ export function useWebsiteSectionLabels(): (slotPath: string) => string {
573
+ const { labelPack } = useWebsiteRuntime();
574
+ const { pageRef } = useWebsitePage();
575
+ const { sectionRef } = useWebsiteSection();
576
+ return useMemo(
577
+ () => (slotPath: string) => {
578
+ const fullKey = composeWebsiteLabelKey({ pageRef: pageRef as unknown as string, sectionRef: sectionRef as unknown as string, slotPath }) as unknown as string;
579
+ const resolved = labelPack[fullKey];
580
+ if (resolved === undefined) {
581
+ console.warn(`[useWebsiteSectionLabels] Missing label for key "${fullKey}". Add it to the active locale's pack.`);
582
+ return fullKey;
583
+ }
584
+ return resolved;
585
+ },
586
+ [labelPack, pageRef, sectionRef],
587
+ );
588
+ }
589
+ ```
590
+
591
+ ## The band and the intro
592
+
593
+ ## Import Origins
594
+
595
+ - `@wildo-ai/saas-website`
596
+
597
+ ## Source Excerpts
598
+
599
+ ### Origin Package: `@wildo-ai/saas-website`
600
+
601
+ ```tsx
602
+ *
603
+ * `WebsiteBand`: a section's outer shell (#2742). The surface it sits on (`tone`), its vertical room (`spacing`), and
604
+ * the width-limited column inside. Everything in it paints with the band's tone, so a card, an eyebrow or a button is
605
+ * right on a tinted or inverse band without a rule per band. Two adjacent sections on the same tone read as one band:
606
+ * the second drops its top padding. Choose tones per section to give a long page its rhythm (`personality.surfaceRhythm`
607
+ * says how strongly the brand alternates them).
608
+ *
609
+ * `decoration` is drawn behind the content, `aria-hidden` and click-through: a brand motif, never content.
610
+ */
611
+ export interface WebsiteBandProps {
612
+ readonly tone?: WebsiteSurfaceTone;
613
+ readonly spacing?: WebsiteBandSpacing;
614
+ readonly decoration?: ReactNode;
615
+ readonly children: ReactNode;
616
+ }
617
+
618
+ export function WebsiteBand({ tone = WebsiteSurfaceTone.DEFAULT, spacing = WebsiteBandSpacing.DEFAULT, decoration, children }: WebsiteBandProps): ReactNode {
619
+ return (
620
+ <div data-website-block="band" data-website-tone={tone} data-website-band-spacing={spacing}>
621
+ {decoration !== undefined && (
622
+ <div data-website-part="decoration" aria-hidden="true">
623
+ {decoration}
624
+ </div>
625
+ )}
626
+ <div data-website-shell="">{children}</div>
627
+ </div>
628
+ );
629
+ }
630
+ WebsiteBand.displayName = 'WebsiteBand';
631
+ ```
632
+
633
+ ## Import Origins
634
+
635
+ - `@wildo-ai/saas-website`
636
+
637
+ ## Source Excerpts
638
+
639
+ ### Origin Package: `@wildo-ai/saas-website`
640
+
641
+ ```tsx
642
+ *
643
+ * `WebsiteSectionIntro`: a section's opening lines, by slot: `eyebrow` (optional), `heading` (an H2), `lede`
644
+ * (optional). `websiteSectionIntroSlots(options)` lists the slots it reads, for the section's declaration.
645
+ *
646
+ * `WebsiteEyebrow`: the short label above a heading, in the brand's colour on any band; `PILL` draws it as a pill
647
+ * with the accent's dot (a hero's opening line).
648
+ */
649
+ export interface WebsiteSectionIntroOptions {
650
+ /** Whether the intro has an eyebrow (slot `eyebrow`). Default true. */
651
+ readonly eyebrow?: boolean;
652
+ /** Whether the intro has a lede (slot `lede`). Default true. */
653
+ readonly lede?: boolean;
654
+ }
655
+
656
+ export function websiteSectionIntroSlots({ eyebrow = true, lede = true }: WebsiteSectionIntroOptions = {}): string[] {
657
+ return [...(eyebrow ? ['eyebrow'] : []), 'heading', ...(lede ? ['lede'] : [])];
658
+ }
659
+
660
+ export function WebsiteEyebrow({ style = WebsiteEyebrowStyle.PLAIN, children }: { style?: WebsiteEyebrowStyle; children: ReactNode }): ReactNode {
661
+ return <p data-website-eyebrow={style}>{children}</p>;
662
+ }
663
+ WebsiteEyebrow.displayName = 'WebsiteEyebrow';
664
+
665
+ /** The intro's one motion point: the whole intro rises in as it scrolls into view. */
666
+ export enum WebsiteSectionIntroMotionPoint {
667
+ INTRO = 'intro',
668
+ }
669
+
670
+ const INTRO_MOTION = defineBlockMotionPoints<WebsiteSectionIntroMotionPoint>({
671
+ [WebsiteSectionIntroMotionPoint.INTRO]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
672
+ });
673
+
674
+ export interface WebsiteSectionIntroProps extends WebsiteSectionIntroOptions {
675
+ readonly align?: WebsiteIntroAlign;
676
+ /** The heading's level: 2 for a section of the page, 3 for one nested under another section's heading. */
677
+ readonly headingLevel?: WebsiteHeadingLevel;
678
+ readonly motion?: WebsiteBlockMotion<WebsiteSectionIntroMotionPoint>;
679
+ }
680
+
681
+ export function WebsiteSectionIntro({ eyebrow = true, lede = true, align = WebsiteIntroAlign.CENTER, headingLevel = 2, motion }: WebsiteSectionIntroProps): ReactNode {
682
+ const label = useWebsiteSectionLabels();
683
+ return (
684
+ <div data-website-block="intro" data-website-align={align} {...blockMotionAttributes(WebsiteSectionIntroMotionPoint.INTRO, INTRO_MOTION, motion)}>
685
+ {eyebrow && <WebsiteEyebrow>{label('eyebrow')}</WebsiteEyebrow>}
686
+ <WebsiteHeading level={headingLevel} variant={WebsiteHeadingVariant.HEADLINE} part="heading">
687
+ {label('heading')}
688
+ </WebsiteHeading>
689
+ {lede && (
690
+ <WebsiteText variant={WebsiteTextVariant.LEAD} part="lede">
691
+ {label('lede')}
692
+ </WebsiteText>
693
+ )}
694
+ </div>
695
+ );
696
+ }
697
+ WebsiteSectionIntro.displayName = 'WebsiteSectionIntro';
698
+ ```
699
+
700
+ ## Calls to action and links
701
+
702
+ ## Import Origins
703
+
704
+ - `@wildo-ai/saas-website`
705
+
706
+ ## Source Excerpts
707
+
708
+ ### Origin Package: `@wildo-ai/saas-website`
709
+
710
+ ```tsx
711
+ *
712
+ * A block's calls to action. Each names where it goes as a typed link, the same union the site menu uses:
713
+ * `{ kind: APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP }` (the application's sign-up, on the environment's
714
+ * app origin), `{ kind: PAGE, routePath: '/pricing' }` (a page of the site, locale-prefixed), or
715
+ * `{ kind: EXTERNAL, href }`. Its words are the slots `cta.primary` and `cta.secondary`.
716
+ *
717
+ * `WebsiteBlockLink`: a link any block draws (a card, an arrow link), resolved by the same rule as the actions: a PAGE
718
+ * link is localized, an APPLICATION link goes to the environment's app origin, an EXTERNAL one is marked outbound.
719
+ *
720
+ * `WebsiteArrowLink`: a quiet link with an arrow that nudges forward on hover (slot given by the caller).
721
+ */
722
+ export interface WebsiteCallToActionsProps {
723
+ readonly primary?: WebsiteLinkTo;
724
+ readonly secondary?: WebsiteLinkTo;
725
+ readonly size?: WebsiteButtonSize;
726
+ }
727
+
728
+ export function websiteCallToActionSlots(actions: { readonly primary?: unknown; readonly secondary?: unknown }): string[] {
729
+ return [...(actions.primary !== undefined ? ['cta.primary'] : []), ...(actions.secondary !== undefined ? ['cta.secondary'] : [])];
730
+ }
731
+
732
+ function ActionButton({ link, variant, size, children }: { link: WebsiteLinkTo; variant: WebsiteButtonVariant; size: WebsiteButtonSize; children: ReactNode }): ReactNode {
733
+ // One rule for every kind: the resolver checks the link and writes its address (a page's locale and fragment
734
+ // included), so an action, a card and the menu go to the same place for the same link.
735
+ const target = useWebsiteLinkTarget()(link);
736
+ return (
737
+ <WebsiteButton href={target.href} external={target.external} variant={variant} size={size}>
738
+ {children}
739
+ </WebsiteButton>
740
+ );
741
+ }
742
+
743
+ export function WebsiteCallToActions({ primary, secondary, size = WebsiteButtonSize.LG }: WebsiteCallToActionsProps): ReactNode {
744
+ const label = useWebsiteSectionLabels();
745
+ return (
746
+ <>
747
+ {primary !== undefined && (
748
+ <ActionButton link={primary} variant={WebsiteButtonVariant.PRIMARY} size={size}>
749
+ {label('cta.primary')}
750
+ </ActionButton>
751
+ )}
752
+ {secondary !== undefined && (
753
+ <ActionButton link={secondary} variant={WebsiteButtonVariant.SECONDARY} size={size}>
754
+ {label('cta.secondary')}
755
+ </ActionButton>
756
+ )}
757
+ </>
758
+ );
759
+ }
760
+ WebsiteCallToActions.displayName = 'WebsiteCallToActions';
761
+
762
+ export interface WebsiteBlockLinkProps {
763
+ readonly link: WebsiteLinkTo;
764
+ /** The `data-website-part` the link carries, so a block's stylesheet (or the site's) can target it. */
765
+ readonly part?: string;
766
+ readonly motion?: WebsiteMotionSpec;
767
+ readonly children: ReactNode;
768
+ }
769
+
770
+ export function WebsiteBlockLink({ link, part, motion, children }: WebsiteBlockLinkProps): ReactNode {
771
+ const target = useWebsiteLinkTarget()(link);
772
+ const shared = { ...(part === undefined ? {} : { part }), ...(motion === undefined ? {} : { motion }) };
773
+ return (
774
+ <WebsiteLink href={target.href} external={target.external} {...shared}>
775
+ {children}
776
+ </WebsiteLink>
777
+ );
778
+ }
779
+ WebsiteBlockLink.displayName = 'WebsiteBlockLink';
780
+
781
+ export function WebsiteArrowLink({ link, children }: { link: WebsiteLinkTo; children: ReactNode }): ReactNode {
782
+ return (
783
+ <WebsiteBlockLink link={link} part="arrow-link">
784
+ {children}
785
+ <WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
786
+ </WebsiteBlockLink>
787
+ );
788
+ }
789
+ WebsiteArrowLink.displayName = 'WebsiteArrowLink';
790
+ ```
791
+
792
+ ## Import Origins
793
+
794
+ - `@wildo-ai/saas-website`
795
+
796
+ ## Source Excerpts
797
+
798
+ ### Origin Package: `@wildo-ai/saas-website`
799
+
800
+ ```typescript
801
+ *
802
+ * Where a website link goes, resolved for the page being rendered (#2742): a PAGE link (`{ kind: PAGE, routePath }`)
803
+ * gets the visitor's locale prefix, an APPLICATION link (`{ kind: APPLICATION, entryPoint }`: home, sign in, sign up)
804
+ * the environment's `appOrigin`, an EXTERNAL link stays as written.
805
+ *
806
+ * One rule for every link the engine draws: the header and footer menus, and the calls to action of the section
807
+ * components. The link is checked as the menu checks its own: a PAGE link names a route of the site (`/pricing`, never
808
+ * a `#anchor` or a pre-prefixed `/fr/pricing`), an EXTERNAL link an http(s) URL. An APPLICATION link with no
809
+ * `appOrigin` throws rather than falling back to a host: a "Start free" that sends a visitor to localhost in production
810
+ * is worse than a page that fails to render in development.
811
+ */
812
+ /**
813
+ * Where a link goes, as a component takes it: the menu's link union with a plain route path (the menu itself checks
814
+ * its paths against the page registry at build; a component's are checked when the link renders).
815
+ */
816
+ export type WebsiteLinkTo = z.input<typeof WebsiteMenuLinkSchema>;
817
+
818
+ export interface WebsiteLinkTarget {
819
+ readonly href: string;
820
+ /** True for an EXTERNAL link: rendered with an outbound marker and opened as a plain link. */
821
+ readonly external: boolean;
822
+ }
823
+
824
+ export function resolveWebsiteLinkTarget(
825
+ link: WebsiteLinkTo,
826
+ page: { readonly locale: AvailableLanguage; readonly defaultLocale: AvailableLanguage; readonly appOrigin?: string | undefined },
827
+ ): WebsiteLinkTarget {
828
+ const valid = WebsiteMenuLinkSchema.parse(link);
829
+ switch (valid.kind) {
830
+ case WebsiteMenuLinkKind.PAGE: {
831
+ const prefix = detectAccidentalLocalePrefix(valid.routePath);
832
+ if (prefix !== null) {
833
+ throw new Error(
834
+ `A website link names the route "${valid.routePath}", which starts with the locale "${prefix}". Name the ` +
835
+ 'locale-neutral route ("/pricing"): the page prefixes the visitor\'s locale itself.',
836
+ );
837
+ }
838
+ const href = buildLocalizedRoutePath({ locale: page.locale, defaultLocale: page.defaultLocale, routePath: valid.routePath });
839
+ return { href: valid.fragment === undefined ? href : `${href}#${valid.fragment}`, external: false };
840
+ }
841
+ case WebsiteMenuLinkKind.APPLICATION:
842
+ if (page.appOrigin === undefined) {
843
+ throw new Error(
844
+ 'A website link goes to the application, but the page has no appOrigin. Pass ' +
845
+ '`appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` to the page island in its .astro route.',
846
+ );
847
+ }
848
+ return { href: `${page.appOrigin}${APPLICATION_ENTRY_POINT_PATHS[valid.entryPoint ?? ApplicationEntryPoint.HOME]}`, external: false };
849
+ case WebsiteMenuLinkKind.EXTERNAL:
850
+ return { href: valid.href, external: true };
851
+ }
852
+ }
853
+
854
+ /** `resolveWebsiteLinkTarget` bound to the page being rendered. */
855
+ export function useWebsiteLinkTarget(): (link: WebsiteLinkTo) => WebsiteLinkTarget {
856
+ const runtime = useWebsiteRuntime();
857
+ return (link) => resolveWebsiteLinkTarget(link, runtime);
858
+ }
859
+ ```
860
+
861
+ ## The hero
862
+
863
+ ## Import Origins
864
+
865
+ - `@wildo-ai/saas-website`
866
+
867
+ ## Source Excerpts
868
+
869
+ ### Origin Package: `@wildo-ai/saas-website`
870
+
871
+ ```tsx
872
+ *
873
+ * `WebsiteHero`: a page's opening (category HERO), and its ONE signature entrance. Slots: `eyebrow` (unless
874
+ * `eyebrow` is false), `headline` (the page's only H1), `subheadline` (unless `lede` is false), `cta.primary` /
875
+ * `cta.secondary` (when the actions are given), `note` (when `note` is true). `websiteHeroSlots({ ... })` lists them,
876
+ * given the same options, so a hero that drops a word declares it dropped.
877
+ *
878
+ * - `layout`: STAGE (copy centred above a full-width `visual`), SPLIT (copy beside it), COMPACT (no visual; chosen
879
+ * automatically when `visual` is absent).
880
+ * - `surface`: what is drawn behind it (a glow, a glow over a grid); `decoration` adds the site's own motif in the
881
+ * backdrop, `aria-hidden`.
882
+ * - `motion`: the entrance, point by point (`eyebrow`, `headline`, `lede`, `actions`, `note`, `visual`), played once
883
+ * on load in that order. Override a point, or set it to `null` to keep it still.
884
+ */
885
+ export enum WebsiteHeroMotionPoint {
886
+ EYEBROW = 'eyebrow',
887
+ HEADLINE = 'headline',
888
+ LEDE = 'lede',
889
+ ACTIONS = 'actions',
890
+ NOTE = 'note',
891
+ VISUAL = 'visual',
892
+ }
893
+
894
+ const onLoad = (reveal: WebsiteMotionReveal, order: number): WebsiteMotionSpec => ({ reveal, trigger: WebsiteMotionTrigger.LOAD, order });
895
+
896
+ const HERO_MOTION = defineBlockMotionPoints<WebsiteHeroMotionPoint>({
897
+ [WebsiteHeroMotionPoint.EYEBROW]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.RISE, 1) },
898
+ [WebsiteHeroMotionPoint.HEADLINE]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.BLUR, 2) },
899
+ [WebsiteHeroMotionPoint.LEDE]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.RISE, 3) },
900
+ [WebsiteHeroMotionPoint.ACTIONS]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.RISE, 4) },
901
+ [WebsiteHeroMotionPoint.NOTE]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.FADE, 5) },
902
+ [WebsiteHeroMotionPoint.VISUAL]: { kind: WebsiteMotionPointKind.MEDIA, opening: true, spec: onLoad(WebsiteMotionReveal.SCALE, 6) },
903
+ });
904
+
905
+ export interface WebsiteHeroProps {
906
+ readonly layout?: WebsiteHeroLayout;
907
+ readonly surface?: WebsiteHeroSurface;
908
+ readonly tone?: WebsiteSurfaceTone;
909
+ readonly primaryAction?: WebsiteLinkTo;
910
+ readonly secondaryAction?: WebsiteLinkTo;
911
+ /** The short label above the headline; false for an opening that is the headline alone. */
912
+ readonly eyebrow?: boolean;
913
+ /** The sentence under the headline (slot `subheadline`); false for a headline-only opening. */
914
+ readonly lede?: boolean;
915
+ readonly note?: boolean;
916
+ readonly visual?: ReactNode;
917
+ readonly decoration?: ReactNode;
918
+ readonly motion?: WebsiteBlockMotion<WebsiteHeroMotionPoint>;
919
+ }
920
+
921
+ export function websiteHeroSlots(options: {
922
+ readonly primaryAction?: unknown;
923
+ readonly secondaryAction?: unknown;
924
+ readonly eyebrow?: boolean;
925
+ readonly lede?: boolean;
926
+ readonly note?: boolean;
927
+ }): string[] {
928
+ return [
929
+ ...(options.eyebrow === false ? [] : ['eyebrow']),
930
+ 'headline',
931
+ ...(options.lede === false ? [] : ['subheadline']),
932
+ ...websiteCallToActionSlots({ primary: options.primaryAction, secondary: options.secondaryAction }),
933
+ ...(options.note === true ? ['note'] : []),
934
+ ];
935
+ }
936
+
937
+ export function WebsiteHero({
938
+ layout = WebsiteHeroLayout.SPLIT,
939
+ surface = WebsiteHeroSurface.GLOW,
940
+ tone = WebsiteSurfaceTone.DEFAULT,
941
+ primaryAction,
942
+ secondaryAction,
943
+ eyebrow = true,
944
+ lede = true,
945
+ note = false,
946
+ visual,
947
+ decoration,
948
+ motion,
949
+ }: WebsiteHeroProps): ReactNode {
950
+ const label = useWebsiteSectionLabels();
951
+ const resolvedLayout = visual === undefined ? WebsiteHeroLayout.COMPACT : layout;
952
+ const at = (point: WebsiteHeroMotionPoint) => blockMotionAttributes(point, HERO_MOTION, motion);
953
+ return (
954
+ <div data-website-block="hero" data-website-layout={resolvedLayout} data-website-hero-surface={surface} data-website-tone={tone}>
955
+ <div data-website-part="backdrop" aria-hidden="true">
956
+ {decoration}
957
+ </div>
958
+ <div data-website-shell="" data-website-part="inner">
959
+ <div data-website-part="copy">
960
+ {eyebrow && (
961
+ <div {...at(WebsiteHeroMotionPoint.EYEBROW)}>
962
+ <WebsiteEyebrow style={WebsiteEyebrowStyle.PILL}>{label('eyebrow')}</WebsiteEyebrow>
963
+ </div>
964
+ )}
965
+ <div {...at(WebsiteHeroMotionPoint.HEADLINE)}>
966
+ <WebsiteHeading level={1} variant={WebsiteHeadingVariant.DISPLAY} part="headline">
967
+ {label('headline')}
968
+ </WebsiteHeading>
969
+ </div>
970
+ {lede && (
971
+ <div {...at(WebsiteHeroMotionPoint.LEDE)}>
972
+ <WebsiteText variant={WebsiteTextVariant.LEAD} part="lede">
973
+ {label('subheadline')}
974
+ </WebsiteText>
975
+ </div>
976
+ )}
977
+ {(primaryAction !== undefined || secondaryAction !== undefined) && (
978
+ <div data-website-actions="" {...at(WebsiteHeroMotionPoint.ACTIONS)}>
979
+ <WebsiteCallToActions {...(primaryAction === undefined ? {} : { primary: primaryAction })} {...(secondaryAction === undefined ? {} : { secondary: secondaryAction })} />
980
+ </div>
981
+ )}
982
+ {note && (
983
+ <div {...at(WebsiteHeroMotionPoint.NOTE)}>
984
+ <WebsiteText variant={WebsiteTextVariant.CAPTION} part="note">
985
+ {label('note')}
986
+ </WebsiteText>
987
+ </div>
988
+ )}
989
+ </div>
990
+ {visual !== undefined && (
991
+ <div data-website-part="visual" {...at(WebsiteHeroMotionPoint.VISUAL)}>
992
+ {visual}
993
+ </div>
994
+ )}
995
+ </div>
996
+ </div>
997
+ );
998
+ }
999
+ WebsiteHero.displayName = 'WebsiteHero';
1000
+ ```
1001
+
1002
+ ## The feature row
1003
+
1004
+ ## Import Origins
1005
+
1006
+ - `@wildo-ai/saas-website`
1007
+
1008
+ ## Source Excerpts
1009
+
1010
+ ### Origin Package: `@wildo-ai/saas-website`
1011
+
1012
+ ```tsx
1013
+ *
1014
+ * `WebsiteFeatureRow`: one capability argued beside its visual (FEATURE_DETAIL, CONTACT). Slots: `eyebrow`, `heading`,
1015
+ * `body`, then per point `<ref>.title` and `<ref>.body`, and `link` when a link is given. `websiteFeatureRowSlots`
1016
+ * lists them. Each point has an optional icon node (a check by default). `layout` puts the visual on either side;
1017
+ * alternate it so consecutive rows zig-zag.
1018
+ */
1019
+ export enum WebsiteFeatureRowMotionPoint {
1020
+ COPY = 'copy',
1021
+ VISUAL = 'visual',
1022
+ }
1023
+
1024
+ const ROW_MOTION = defineBlockMotionPoints<WebsiteFeatureRowMotionPoint>({
1025
+ [WebsiteFeatureRowMotionPoint.COPY]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
1026
+ [WebsiteFeatureRowMotionPoint.VISUAL]: { kind: WebsiteMotionPointKind.MEDIA, spec: { reveal: WebsiteMotionReveal.SCALE } },
1027
+ });
1028
+
1029
+ /** One point of a feature row: its slot prefix (`point1`, or a meaningful ref) and its icon. */
1030
+ export interface WebsiteFeaturePoint {
1031
+ readonly ref: string;
1032
+ readonly icon?: ReactNode;
1033
+ }
1034
+
1035
+ export function websiteFeatureRowSlots(options: {
1036
+ readonly points?: readonly WebsiteFeaturePoint[] | readonly string[];
1037
+ readonly link?: unknown;
1038
+ readonly eyebrow?: boolean;
1039
+ readonly body?: boolean;
1040
+ }): string[] {
1041
+ const refs = (options.points ?? []).map((point) => (typeof point === 'string' ? point : point.ref));
1042
+ return [
1043
+ ...(options.eyebrow === false ? [] : ['eyebrow']),
1044
+ 'heading',
1045
+ ...(options.body === false ? [] : ['body']),
1046
+ ...refs.flatMap((ref) => [`${ref}.title`, `${ref}.body`]),
1047
+ ...(options.link !== undefined ? ['link'] : []),
1048
+ ];
1049
+ }
1050
+
1051
+ export interface WebsiteFeatureRowProps {
1052
+ /** The points listed under the copy; none renders no list. */
1053
+ readonly points?: readonly WebsiteFeaturePoint[];
1054
+ readonly visual: ReactNode;
1055
+ /** The short label above the heading; false to open on the heading. */
1056
+ readonly eyebrow?: boolean;
1057
+ /** The paragraph under the heading; false when the points carry the argument alone. */
1058
+ readonly body?: boolean;
1059
+ /** The heading's level: 2 for a section of the page, 3 for one nested under another section's heading. */
1060
+ readonly headingLevel?: WebsiteHeadingLevel;
1061
+ readonly link?: WebsiteLinkTo;
1062
+ readonly layout?: WebsiteFeatureRowLayout;
1063
+ readonly motion?: WebsiteBlockMotion<WebsiteFeatureRowMotionPoint>;
1064
+ }
1065
+
1066
+ export function WebsiteFeatureRow({
1067
+ points = [],
1068
+ visual,
1069
+ link,
1070
+ eyebrow = true,
1071
+ body = true,
1072
+ headingLevel = 2,
1073
+ layout = WebsiteFeatureRowLayout.VISUAL_END,
1074
+ motion,
1075
+ }: WebsiteFeatureRowProps): ReactNode {
1076
+ const label = useWebsiteSectionLabels();
1077
+ return (
1078
+ <div data-website-block="feature-row" data-website-layout={layout}>
1079
+ <div data-website-part="copy" {...blockMotionAttributes(WebsiteFeatureRowMotionPoint.COPY, ROW_MOTION, motion)}>
1080
+ {eyebrow && <WebsiteEyebrow>{label('eyebrow')}</WebsiteEyebrow>}
1081
+ <WebsiteHeading level={headingLevel} variant={WebsiteHeadingVariant.HEADLINE} part="heading">
1082
+ {label('heading')}
1083
+ </WebsiteHeading>
1084
+ {body && (
1085
+ <WebsiteText variant={WebsiteTextVariant.LEAD} part="body">
1086
+ {label('body')}
1087
+ </WebsiteText>
1088
+ )}
1089
+ {points.length > 0 && (
1090
+ <ul data-website-point-list="">
1091
+ {points.map((point) => (
1092
+ <li key={point.ref} data-website-point="">
1093
+ <WebsiteIconTile size={WebsiteIconTileSize.SM}>{point.icon ?? <WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.CHECK} />}</WebsiteIconTile>
1094
+ <span>
1095
+ <strong>{label(`${point.ref}.title`)}</strong> {label(`${point.ref}.body`)}
1096
+ </span>
1097
+ </li>
1098
+ ))}
1099
+ </ul>
1100
+ )}
1101
+ {link !== undefined && <WebsiteArrowLink link={link}>{label('link')}</WebsiteArrowLink>}
1102
+ </div>
1103
+ <div data-website-part="visual" {...blockMotionAttributes(WebsiteFeatureRowMotionPoint.VISUAL, ROW_MOTION, motion)}>
1104
+ {visual}
1105
+ </div>
1106
+ </div>
1107
+ );
1108
+ }
1109
+ WebsiteFeatureRow.displayName = 'WebsiteFeatureRow';
1110
+ ```
1111
+
1112
+ ## The card grid
1113
+
1114
+ ## Import Origins
1115
+
1116
+ - `@wildo-ai/saas-website`
1117
+
1118
+ ## Source Excerpts
1119
+
1120
+ ### Origin Package: `@wildo-ai/saas-website`
1121
+
1122
+ ```tsx
1123
+ *
1124
+ * `WebsiteCardGrid`: a grid of cards, serving whatever category the section binds: FEATURE_BENEFIT_SUMMARY (icon-led
1125
+ * cards), PROBLEM (figure-led cards: what the reader's situation costs), PRODUCT_SHOWCASE (media cards that each link
1126
+ * to the page that shows more), INTEGRATIONS, a values section. Each card has a title and a body by slot
1127
+ * (`<ref>.title`, `<ref>.body`; `websiteCardGridSlots(items)` lists every slot the items read), and may be one link
1128
+ * (`link`: a page of the site, the application, or an external URL). A card's title is a heading (`titleLevel`, `3`
1129
+ * under a section's `h2`), so the page outline lists the cards. Cards lift to the band's raised surface, so they read
1130
+ * on a tinted or inverse band. `fit` AUTO lays out as many columns as fit, for a list whose length varies. Pair it
1131
+ * with `WebsiteSectionIntro` above.
1132
+ */
1133
+ export enum WebsiteCardGridMotionPoint {
1134
+ /** The cards arrive one after another as the grid scrolls into view. */
1135
+ ITEMS = 'items',
1136
+ /** A card that is a link responds to the pointer. */
1137
+ LINK_CARD = 'link-card',
1138
+ }
1139
+
1140
+ const GRID_MOTION = defineBlockMotionPoints<WebsiteCardGridMotionPoint>({
1141
+ [WebsiteCardGridMotionPoint.ITEMS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
1142
+ [WebsiteCardGridMotionPoint.LINK_CARD]: { kind: WebsiteMotionPointKind.LINK_CARD, spec: { hover: WebsiteMotionHover.LIFT } },
1143
+ });
1144
+
1145
+ /**
1146
+ * One card: its slot prefix and what it carries. `figure` leads it with a number (slot `<ref>.figure`: a cost, a
1147
+ * count), `icon` with a glyph in a tile, `media` with a drawing edge to edge. `link` makes the whole card one link,
1148
+ * and `cta` adds the words that say where it goes (slot `<ref>.cta`, drawn with an arrow), so it needs a `link`: an
1149
+ * arrow that goes nowhere is a link that is not one.
1150
+ */
1151
+ interface WebsiteCardItemContent {
1152
+ readonly ref: string;
1153
+ readonly icon?: ReactNode;
1154
+ readonly figure?: boolean;
1155
+ readonly media?: ReactNode;
1156
+ }
1157
+
1158
+ export type WebsiteCardItem = WebsiteCardItemContent &
1159
+ ({ readonly link?: WebsiteLinkTo; readonly cta?: false } | { readonly link: WebsiteLinkTo; readonly cta: true });
1160
+
1161
+ /** What a card's words depend on, for its slot helper. */
1162
+ export type WebsiteCardSlotItem = Pick<WebsiteCardItemContent, 'ref' | 'figure'> & { readonly cta?: boolean };
1163
+
1164
+ export function websiteCardGridSlots(items: readonly WebsiteCardSlotItem[] | readonly string[]): string[] {
1165
+ return items.flatMap((item) => {
1166
+ const card: WebsiteCardSlotItem = typeof item === 'string' ? { ref: item } : item;
1167
+ return [
1168
+ ...(card.figure === true ? [`${card.ref}.figure`] : []),
1169
+ `${card.ref}.title`,
1170
+ `${card.ref}.body`,
1171
+ ...(card.cta === true ? [`${card.ref}.cta`] : []),
1172
+ ];
1173
+ });
1174
+ }
1175
+
1176
+ export interface WebsiteCardGridProps {
1177
+ readonly items: readonly WebsiteCardItem[];
1178
+ /** The column count on a wide screen, when `fit` is FIXED. */
1179
+ readonly columns?: WebsiteCardGridColumns;
1180
+ /** FIXED (`columns`) or AUTO (as many as fit, each at least the theme's `layout.cardMin`). */
1181
+ readonly fit?: WebsiteGridFit;
1182
+ /** The heading level of each card's title: one below the section's heading. */
1183
+ readonly titleLevel?: WebsiteHeadingLevel;
1184
+ readonly motion?: WebsiteBlockMotion<WebsiteCardGridMotionPoint>;
1185
+ }
1186
+
1187
+ export function WebsiteCardGrid({ items, columns = 3, fit = WebsiteGridFit.FIXED, titleLevel = 3, motion }: WebsiteCardGridProps): ReactNode {
1188
+ const label = useWebsiteSectionLabels();
1189
+ const linkMotion = resolveBlockMotion(WebsiteCardGridMotionPoint.LINK_CARD, GRID_MOTION, motion);
1190
+ return (
1191
+ <ul
1192
+ data-website-block="card-grid"
1193
+ data-website-columns={fit === WebsiteGridFit.AUTO ? WebsiteGridFit.AUTO : String(columns)}
1194
+ {...blockMotionAttributes(WebsiteCardGridMotionPoint.ITEMS, GRID_MOTION, motion)}
1195
+ >
1196
+ {items.map((item) => {
1197
+ if (item.cta === true && item.link === undefined) {
1198
+ throw new Error(`[website card grid] Card "${item.ref}" has a call to action and no link: give it a \`link\`, or drop \`cta\`.`);
1199
+ }
1200
+ return (
1201
+ <WebsiteCard
1202
+ key={item.ref}
1203
+ {...(item.link === undefined ? {} : { link: item.link })}
1204
+ {...(item.media === undefined ? {} : { media: item.media })}
1205
+ {...(item.link === undefined || linkMotion === null || linkMotion === undefined ? {} : { hover: linkMotion })}
1206
+ >
1207
+ {item.figure === true && <span data-website-part="figure">{label(`${item.ref}.figure`)}</span>}
1208
+ {item.icon !== undefined && <WebsiteIconTile>{item.icon}</WebsiteIconTile>}
1209
+ <WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
1210
+ {label(`${item.ref}.title`)}
1211
+ </WebsiteHeading>
1212
+ <span data-website-part="body">{label(`${item.ref}.body`)}</span>
1213
+ {item.cta === true && (
1214
+ <span data-website-part="arrow-link">
1215
+ {label(`${item.ref}.cta`)}
1216
+ <WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
1217
+ </span>
1218
+ )}
1219
+ </WebsiteCard>
1220
+ );
1221
+ })}
1222
+ </ul>
1223
+ );
1224
+ }
1225
+ WebsiteCardGrid.displayName = 'WebsiteCardGrid';
1226
+ ```
1227
+
1228
+ ## The closing band
1229
+
1230
+ ## Import Origins
1231
+
1232
+ - `@wildo-ai/saas-website`
1233
+
1234
+ ## Source Excerpts
1235
+
1236
+ ### Origin Package: `@wildo-ai/saas-website`
1237
+
1238
+ ```tsx
1239
+ *
1240
+ * `WebsiteCtaBand`: a call to action as a band of its own (FOOTER_CTA, or a mid-page CTA on another `tone`), INVERSE
1241
+ * by default, with an optional eyebrow, the heading, an optional sentence and the actions centred; `decoration` draws
1242
+ * the site's motif behind it. Slots: `eyebrow` (when `eyebrow` is true), `heading`, `body` (unless `body` is false),
1243
+ * `cta.primary` / `cta.secondary` (`websiteCtaBandSlots`, given the same options).
1244
+ */
1245
+ export enum WebsiteCtaBandMotionPoint {
1246
+ CONTENT = 'content',
1247
+ }
1248
+
1249
+ const CTA_MOTION = defineBlockMotionPoints<WebsiteCtaBandMotionPoint>({
1250
+ [WebsiteCtaBandMotionPoint.CONTENT]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
1251
+ });
1252
+
1253
+ export function websiteCtaBandSlots(options: {
1254
+ readonly primaryAction?: unknown;
1255
+ readonly secondaryAction?: unknown;
1256
+ readonly eyebrow?: boolean;
1257
+ readonly body?: boolean;
1258
+ }): string[] {
1259
+ return [
1260
+ ...(options.eyebrow === true ? ['eyebrow'] : []),
1261
+ 'heading',
1262
+ ...(options.body === false ? [] : ['body']),
1263
+ ...websiteCallToActionSlots({ primary: options.primaryAction, secondary: options.secondaryAction }),
1264
+ ];
1265
+ }
1266
+
1267
+ export interface WebsiteCtaBandProps {
1268
+ readonly tone?: WebsiteSurfaceTone;
1269
+ readonly spacing?: WebsiteBandSpacing;
1270
+ /** A short label above the heading; off by default, as a page's close rarely needs one. */
1271
+ readonly eyebrow?: boolean;
1272
+ /** The sentence under the heading; false for a heading and buttons alone. */
1273
+ readonly body?: boolean;
1274
+ /** The heading's level: 2 for a section of the page, 3 for one nested under another section's heading. */
1275
+ readonly headingLevel?: WebsiteHeadingLevel;
1276
+ readonly primaryAction?: WebsiteLinkTo;
1277
+ readonly secondaryAction?: WebsiteLinkTo;
1278
+ readonly decoration?: ReactNode;
1279
+ readonly motion?: WebsiteBlockMotion<WebsiteCtaBandMotionPoint>;
1280
+ }
1281
+
1282
+ export function WebsiteCtaBand({
1283
+ tone = WebsiteSurfaceTone.INVERSE,
1284
+ spacing = WebsiteBandSpacing.DEFAULT,
1285
+ eyebrow = false,
1286
+ body = true,
1287
+ headingLevel = 2,
1288
+ primaryAction,
1289
+ secondaryAction,
1290
+ decoration,
1291
+ motion,
1292
+ }: WebsiteCtaBandProps): ReactNode {
1293
+ const label = useWebsiteSectionLabels();
1294
+ return (
1295
+ <div data-website-block="band" data-website-band-role="cta" data-website-tone={tone} data-website-band-spacing={spacing}>
1296
+ {decoration !== undefined && (
1297
+ <div data-website-part="decoration" aria-hidden="true">
1298
+ {decoration}
1299
+ </div>
1300
+ )}
1301
+ <div data-website-shell="" data-website-block="cta" {...blockMotionAttributes(WebsiteCtaBandMotionPoint.CONTENT, CTA_MOTION, motion)}>
1302
+ {eyebrow && <WebsiteEyebrow>{label('eyebrow')}</WebsiteEyebrow>}
1303
+ <WebsiteHeading level={headingLevel} variant={WebsiteHeadingVariant.HEADLINE} part="heading">
1304
+ {label('heading')}
1305
+ </WebsiteHeading>
1306
+ {body && (
1307
+ <WebsiteText variant={WebsiteTextVariant.LEAD} part="body">
1308
+ {label('body')}
1309
+ </WebsiteText>
1310
+ )}
1311
+ {(primaryAction !== undefined || secondaryAction !== undefined) && (
1312
+ <div data-website-actions="">
1313
+ <WebsiteCallToActions {...(primaryAction === undefined ? {} : { primary: primaryAction })} {...(secondaryAction === undefined ? {} : { secondary: secondaryAction })} />
1314
+ </div>
1315
+ )}
1316
+ </div>
1317
+ </div>
1318
+ );
1319
+ }
1320
+ WebsiteCtaBand.displayName = 'WebsiteCtaBand';
1321
+ ```
1322
+
1323
+ ## Cards and icon tiles
1324
+
1325
+ ## Import Origins
1326
+
1327
+ - `@wildo-ai/saas-website`
1328
+
1329
+ ## Source Excerpts
1330
+
1331
+ ### Origin Package: `@wildo-ai/saas-website`
1332
+
1333
+ ```tsx
1334
+ *
1335
+ * `WebsiteCard`: one card, the shell every card-shaped block shares (#2742). A raised surface of the band it sits on,
1336
+ * the theme's card corner and padding, a hairline edge. With `link` the whole card is one link (a single tab stop,
1337
+ * named by its content), with `hover` motion when it is. `media` is drawn edge to edge above the copy: a product
1338
+ * drawing, a screenshot. The card is an `<li>` by default, because cards come in lists; `as="div"` for a lone card.
1339
+ * Hook: `data-website-card` (`data-website-card="media"` when it carries media).
1340
+ *
1341
+ * `WebsiteIconTile`: the square of colour behind a glyph, `aria-hidden` (the glyph decorates, the words beside it
1342
+ * say what it is). `size` SM beside a line, MD leading a card, LG leading a card that is a choice; `tileStyle` WASH (the
1343
+ * tone's primary on a wash of it) or SOLID (the tone's background on its foreground).
1344
+ */
1345
+ export interface WebsiteCardProps {
1346
+ readonly link?: WebsiteLinkTo;
1347
+ /** The hover response of a card that is a link; none when omitted. */
1348
+ readonly hover?: WebsiteMotionSpec;
1349
+ readonly media?: ReactNode;
1350
+ /** The card's size in its block's layout (`data-website-size`): a bento tile's. */
1351
+ readonly size?: WebsiteBentoTileSize;
1352
+ readonly as?: 'li' | 'div';
1353
+ readonly children: ReactNode;
1354
+ }
1355
+
1356
+ export function WebsiteCard({ link, hover, media, size, as = 'li', children }: WebsiteCardProps): ReactNode {
1357
+ const Element = as;
1358
+ const content = (
1359
+ <>
1360
+ {media !== undefined && (
1361
+ // Divs, not spans: a drawing (a demo stage) is block content, which a span may not hold.
1362
+ <div data-website-part="media" aria-hidden="true">
1363
+ {media}
1364
+ </div>
1365
+ )}
1366
+ {media !== undefined ? <div data-website-part="copy">{children}</div> : children}
1367
+ </>
1368
+ );
1369
+ return (
1370
+ <Element data-website-card={media !== undefined ? 'media' : ''} {...(size === undefined ? {} : { 'data-website-size': size })}>
1371
+ {link === undefined ? (
1372
+ content
1373
+ ) : (
1374
+ <WebsiteBlockLink link={link} part="link" {...(hover === undefined ? {} : { motion: hover })}>
1375
+ {content}
1376
+ </WebsiteBlockLink>
1377
+ )}
1378
+ </Element>
1379
+ );
1380
+ }
1381
+ WebsiteCard.displayName = 'WebsiteCard';
1382
+
1383
+ export function WebsiteIconTile({
1384
+ size = WebsiteIconTileSize.MD,
1385
+ tileStyle = WebsiteIconTileStyle.WASH,
1386
+ children,
1387
+ }: {
1388
+ size?: WebsiteIconTileSize;
1389
+ tileStyle?: WebsiteIconTileStyle;
1390
+ children: ReactNode;
1391
+ }): ReactNode {
1392
+ return (
1393
+ <span data-website-icon-tile={size} data-website-icon-tile-style={tileStyle} aria-hidden="true">
1394
+ {children}
1395
+ </span>
1396
+ );
1397
+ }
1398
+ WebsiteIconTile.displayName = 'WebsiteIconTile';
1399
+ ```
1400
+
1401
+ ## Steps
1402
+
1403
+ ## Import Origins
1404
+
1405
+ - `@wildo-ai/saas-website`
1406
+
1407
+ ## Source Excerpts
1408
+
1409
+ ### Origin Package: `@wildo-ai/saas-website`
1410
+
1411
+ ```tsx
1412
+ *
1413
+ * `WebsiteSteps`: how it works (HOW_IT_WORKS), as an ordered list of numbered cards (#2742). Each step has a title and
1414
+ * a body by slot (`<ref>.title`, `<ref>.body`; `websiteStepsSlots(steps)`), and may carry a `visual` drawn above it
1415
+ * (a small product drawing, `aria-hidden`: the words say what the step is). `layout` ROW sets them side by side and
1416
+ * stacks them on a narrow screen; STACK puts them one under the other. The number is the list's own order, drawn in a
1417
+ * disc; a step's title is a heading one level under the section's (`titleLevel`).
1418
+ */
1419
+ export enum WebsiteStepsMotionPoint {
1420
+ /** The steps arrive one after another, in their order. */
1421
+ STEPS = 'steps',
1422
+ }
1423
+
1424
+ const STEPS_MOTION = defineBlockMotionPoints<WebsiteStepsMotionPoint>({
1425
+ [WebsiteStepsMotionPoint.STEPS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
1426
+ });
1427
+
1428
+ /** One step: its slot prefix, and a drawing of it if the step is better shown than told. */
1429
+ export interface WebsiteStep {
1430
+ readonly ref: string;
1431
+ readonly visual?: ReactNode;
1432
+ }
1433
+
1434
+ export function websiteStepsSlots(steps: readonly WebsiteStep[] | readonly string[]): string[] {
1435
+ return steps.map((step) => (typeof step === 'string' ? step : step.ref)).flatMap((ref) => [`${ref}.title`, `${ref}.body`]);
1436
+ }
1437
+
1438
+ export interface WebsiteStepsProps {
1439
+ readonly steps: readonly WebsiteStep[];
1440
+ readonly layout?: WebsiteStepsLayout;
1441
+ readonly titleLevel?: WebsiteHeadingLevel;
1442
+ readonly motion?: WebsiteBlockMotion<WebsiteStepsMotionPoint>;
1443
+ }
1444
+
1445
+ export function WebsiteSteps({ steps, layout = WebsiteStepsLayout.ROW, titleLevel = 3, motion }: WebsiteStepsProps): ReactNode {
1446
+ const label = useWebsiteSectionLabels();
1447
+ return (
1448
+ <ol data-website-block="steps" data-website-layout={layout} {...blockMotionAttributes(WebsiteStepsMotionPoint.STEPS, STEPS_MOTION, motion)}>
1449
+ {steps.map((step, position) => (
1450
+ <li key={step.ref} data-website-card="">
1451
+ {step.visual !== undefined && (
1452
+ <div data-website-part="visual" aria-hidden="true">
1453
+ {step.visual}
1454
+ </div>
1455
+ )}
1456
+ <span data-website-part="number" aria-hidden="true">
1457
+ {position + 1}
1458
+ </span>
1459
+ <WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
1460
+ {label(`${step.ref}.title`)}
1461
+ </WebsiteHeading>
1462
+ <span data-website-part="body">{label(`${step.ref}.body`)}</span>
1463
+ </li>
1464
+ ))}
1465
+ </ol>
1466
+ );
1467
+ }
1468
+ WebsiteSteps.displayName = 'WebsiteSteps';
1469
+ ```
1470
+
1471
+ ## Stats and the count-up
1472
+
1473
+ ## Import Origins
1474
+
1475
+ - `@wildo-ai/saas-website`
1476
+
1477
+ ## Source Excerpts
1478
+
1479
+ ### Origin Package: `@wildo-ai/saas-website`
1480
+
1481
+ ```tsx
1482
+ *
1483
+ * `WebsiteStats`: facts as numbers (STATS), a description list of cells joined by hairlines (#2742). Each stat has a
1484
+ * value, a label and a note by slot (`<ref>.value`, `<ref>.label`, `<ref>.note`; `websiteStatsSlots(stats)`). The
1485
+ * value is the figure a person reads first; it counts up once, the first time it is seen (`WebsiteCountUp`).
1486
+ *
1487
+ * `WebsiteCountUp`: a number in a text counting up from zero, once, on the site's tempo (about 1.7 × the tempo's long
1488
+ * duration: 1.4 s on FLUID). The text itself is what the server renders, what a screen reader reads (the moving copy
1489
+ * is `aria-hidden`) and what a visitor who asked for reduced motion, or a STILL site, sees. A one-off movement under
1490
+ * two seconds, so no pause control is owed (WCAG 2.2.2's five seconds). A text with no number is shown as it is.
1491
+ * The figure is read in the PAGE's locale (`parseWebsiteCountUpFigure`): "10,000" is ten thousand on an English page,
1492
+ * "1 234" one thousand two hundred and thirty-four on a French one, and the moving copy keeps the figure's grouping
1493
+ * and decimals. A figure the locale cannot read unambiguously is shown as written, never counted wrongly.
1494
+ */
1495
+ export enum WebsiteStatsMotionPoint {
1496
+ /** The stats arrive one after another. */
1497
+ STATS = 'stats',
1498
+ }
1499
+
1500
+ const STATS_MOTION = defineBlockMotionPoints<WebsiteStatsMotionPoint>({
1501
+ [WebsiteStatsMotionPoint.STATS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
1502
+ });
1503
+
1504
+ export function websiteStatsSlots(stats: readonly string[]): string[] {
1505
+ return stats.flatMap((ref) => [`${ref}.value`, `${ref}.label`, `${ref}.note`]);
1506
+ }
1507
+
1508
+ export interface WebsiteStatsProps {
1509
+ /** The slot prefix of each stat, in order. */
1510
+ readonly stats: readonly string[];
1511
+ readonly columns?: WebsiteCardGridColumns;
1512
+ /** False to show each figure as it is, without counting. */
1513
+ readonly countUp?: boolean;
1514
+ readonly motion?: WebsiteBlockMotion<WebsiteStatsMotionPoint>;
1515
+ }
1516
+
1517
+ export function WebsiteStats({ stats, columns = 4, countUp = true, motion }: WebsiteStatsProps): ReactNode {
1518
+ const label = useWebsiteSectionLabels();
1519
+ return (
1520
+ <dl data-website-block="stats" data-website-columns={String(columns)} {...blockMotionAttributes(WebsiteStatsMotionPoint.STATS, STATS_MOTION, motion)}>
1521
+ {stats.map((ref) => (
1522
+ <div key={ref} data-website-part="stat">
1523
+ <dt data-website-part="label">{label(`${ref}.label`)}</dt>
1524
+ <dd data-website-part="value">{countUp ? <WebsiteCountUp text={label(`${ref}.value`)} /> : label(`${ref}.value`)}</dd>
1525
+ <dd data-website-part="note">{label(`${ref}.note`)}</dd>
1526
+ </div>
1527
+ ))}
1528
+ </dl>
1529
+ );
1530
+ }
1531
+ WebsiteStats.displayName = 'WebsiteStats';
1532
+
1533
+ /** A figure inside a text, read in a locale: what stands before and after it, its value, and how it is written. */
1534
+ export interface WebsiteCountUpFigure {
1535
+ readonly prefix: string;
1536
+ readonly value: number;
1537
+ readonly fractionDigits: number;
1538
+ /** The mark grouping the figure's thousands as the text writes it, or null when it is written ungrouped. */
1539
+ readonly groupMark: string | null;
1540
+ readonly suffix: string;
1541
+ }
1542
+
1543
+ /**
1544
+ * Marks a writer types for the same group mark: any space for a space (a figure may always group with one), and either
1545
+ * apostrophe where the locale groups with an apostrophe (Swiss German: ICU writes ', people often type ’).
1546
+ */
1547
+ const SPACE_MARKS = new Set([' ', '\u00a0', '\u202f']);
1548
+ const APOSTROPHE_MARKS = new Set(["'", '\u2019']);
1549
+
1550
+ const escapeForCharacterClass = (value: string) => value.replace(/[\\\]^-]/g, '\\$&');
1551
+
1552
+ /**
1553
+ * Reads the first figure in `text` the way a reader of `locale` reads it: the locale's decimal mark separates the
1554
+ * fraction, its group mark (or a space) groups thousands. Null when there is no figure, or when the figure is not
1555
+ * one number written the way the locale writes it: the figure is accepted only when writing its value back, with
1556
+ * the same grouping and decimals, gives exactly the figure. So "1,5x" on an English page, "10,00", "Top 3 2024" or
1557
+ * "4 1/2" are shown as written rather than counted to 15, 1000, 32024 or 41.
1558
+ */
1559
+ export function parseWebsiteCountUpFigure(text: string, locale: string): WebsiteCountUpFigure | null {
1560
+ const parts = new Intl.NumberFormat(locale).formatToParts(11111.1);
1561
+ const decimalMark = parts.find((part) => part.type === 'decimal')?.value ?? '.';
1562
+ const localeGroup = parts.find((part) => part.type === 'group')?.value ?? ',';
1563
+ const marks = escapeForCharacterClass(`.,'\u2019\u00a0\u202f ${localeGroup}${decimalMark}`);
1564
+ const match = new RegExp(`^(\\D*?)(\\d(?:[\\d${marks}]*\\d)?)(.*)$`, 'su').exec(text);
1565
+ if (match === null) return null;
1566
+ const [, prefix = '', body = '', suffix = ''] = match;
1567
+ const isGroupMark = (mark: string) => mark === localeGroup || SPACE_MARKS.has(mark) || (APOSTROPHE_MARKS.has(mark) && APOSTROPHE_MARKS.has(localeGroup));
1568
+ const pieces = body.split(decimalMark);
1569
+ if (pieces.length > 2) return null;
1570
+ const [integerPart = '', fractionPart = ''] = pieces;
1571
+ if (!/^\d*$/.test(fractionPart)) return null;
1572
+ const groupMarks = [...integerPart].filter((character) => !/\d/.test(character));
1573
+ if (!groupMarks.every(isGroupMark)) return null;
1574
+ const digits = integerPart.replace(/\D/g, '');
1575
+ const figure: WebsiteCountUpFigure = {
1576
+ prefix,
1577
+ value: Number(`${digits}.${fractionPart || '0'}`),
1578
+ fractionDigits: fractionPart.length,
1579
+ groupMark: groupMarks[0] ?? null,
1580
+ suffix,
1581
+ };
1582
+ return formatCountUpValue(figure.value, figure, locale) === body ? figure : null;
1583
+ }
1584
+
1585
+ /** A value written the way its figure is: the same decimals, grouped with the same mark (or not at all). */
1586
+ function formatCountUpValue(value: number, figure: WebsiteCountUpFigure, locale: string): string {
1587
+ // Latin digits: the figure was written with them (the reader matches nothing else), so the count uses them too.
1588
+ const formatter = new Intl.NumberFormat(locale, {
1589
+ numberingSystem: 'latn',
1590
+ useGrouping: figure.groupMark !== null,
1591
+ minimumFractionDigits: figure.fractionDigits,
1592
+ maximumFractionDigits: figure.fractionDigits,
1593
+ });
1594
+ return formatter
1595
+ .formatToParts(value)
1596
+ .map((part) => (part.type === 'group' && figure.groupMark !== null ? figure.groupMark : part.value))
1597
+ .join('');
1598
+ }
1599
+
1600
+ const REDUCED_MOTION = '(prefers-reduced-motion: reduce)';
1601
+ /** How many of the tempo's long durations a count lasts: long enough to read as counting, short enough to be done. */
1602
+ const COUNT_UP_TEMPO_MULTIPLE = 1.7;
1603
+
1604
+ export function WebsiteCountUp({ text }: { text: string }): ReactNode {
1605
+ const tempo = WEBSITE_MOTION_TEMPO[resolveWebsiteMotionTokens(useWebsiteDesignTokens().motion).tempo];
1606
+ const { locale } = useWebsiteRuntime();
1607
+ const figure = parseWebsiteCountUpFigure(text, locale);
1608
+ const target = figure === null ? null : figure.value;
1609
+ const scale = 10 ** (figure?.fractionDigits ?? 0);
1610
+ const duration = Number.parseFloat(tempo.durationLong) * COUNT_UP_TEMPO_MULTIPLE;
1611
+ const ref = useRef<HTMLSpanElement | null>(null);
1612
+ const [shown, setShown] = useState<number | null>(null);
1613
+ useEffect(() => {
1614
+ const element = ref.current;
1615
+ if (element === null || target === null || target === 0 || !tempo.playsChoreography || !(duration > 0)) return undefined;
1616
+ if (typeof window.matchMedia === 'function' && window.matchMedia(REDUCED_MOTION).matches) return undefined;
1617
+ if (typeof IntersectionObserver === 'undefined') return undefined;
1618
+ let frame = 0;
1619
+ const observer = new IntersectionObserver((entries) => {
1620
+ if (!entries.some((entry) => entry.isIntersecting)) return;
1621
+ observer.disconnect();
1622
+ const start = performance.now();
1623
+ const tick = (now: number): void => {
1624
+ const progress = Math.min(1, (now - start) / duration);
1625
+ const eased = 1 - (1 - progress) ** 3;
1626
+ setShown(progress >= 1 ? null : Math.round(target * eased * scale) / scale);
1627
+ if (progress < 1) frame = requestAnimationFrame(tick);
1628
+ };
1629
+ setShown(0);
1630
+ frame = requestAnimationFrame(tick);
1631
+ });
1632
+ observer.observe(element);
1633
+ return () => {
1634
+ observer.disconnect();
1635
+ cancelAnimationFrame(frame);
1636
+ };
1637
+ }, [target, scale, duration, tempo.playsChoreography]);
1638
+ if (figure === null) return <span>{text}</span>;
1639
+ return (
1640
+ <span ref={ref} data-website-count-up="">
1641
+ <span data-website-part="final">{text}</span>
1642
+ {shown !== null && (
1643
+ <span data-website-part="moving" aria-hidden="true">
1644
+ {figure.prefix}
1645
+ {formatCountUpValue(shown, figure, locale)}
1646
+ {figure.suffix}
1647
+ </span>
1648
+ )}
1649
+ </span>
1650
+ );
1651
+ }
1652
+ WebsiteCountUp.displayName = 'WebsiteCountUp';
1653
+ ```
1654
+
1655
+ ## Comparison and fact tables
1656
+
1657
+ ## Import Origins
1658
+
1659
+ - `@wildo-ai/saas-website`
1660
+
1661
+ ## Source Excerpts
1662
+
1663
+ ### Origin Package: `@wildo-ai/saas-website`
1664
+
1665
+ ```tsx
1666
+ *
1667
+ * Two real tables (#2742), scrollable sideways inside their frame on a narrow screen, never squeezed:
1668
+ *
1669
+ * - `WebsiteComparisonTable` (COMPARISON): the product against the alternatives. A caption naming the table (slot
1670
+ * `caption`, visually hidden unless `showCaption`: the section's heading says it to a sighted reader, the caption
1671
+ * says it to a screen reader moving through tables), a corner header (slot `criterion`),
1672
+ * one column per option (`<column>.name`), one row per criterion (`<row>.criterion`, then `<row>.<column>` per
1673
+ * cell). `highlight` names the column that is the product's, tinted and named in the header's colour, so the
1674
+ * honest table still says which side the page is on. `websiteComparisonTableSlots(rows, columns)`.
1675
+ * - `WebsiteFactTable`: facts in rows (a retention schedule, a limits table). A caption (slot `caption`, visually
1676
+ * hidden unless `showCaption`), one header per column (`<column>.name`), the first cell of each row as its header
1677
+ * (`<row>.<column>`). `websiteFactTableSlots(rows, columns)`.
1678
+ *
1679
+ * Rows and columns are named by REF, so a page's words stay readable (`row1.column2` is fine; `retention.audit`
1680
+ * better). Hook: `data-website-block="table"`, `data-website-layout` COMPARISON or FACTS, `data-website-part
1681
+ * ="highlight"` on the product's cells.
1682
+ */
1683
+ export enum WebsiteTableMotionPoint {
1684
+ /** The table rises into place as it scrolls into view. */
1685
+ TABLE = 'table',
1686
+ }
1687
+
1688
+ const TABLE_MOTION = defineBlockMotionPoints<WebsiteTableMotionPoint>({
1689
+ [WebsiteTableMotionPoint.TABLE]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
1690
+ });
1691
+
1692
+ /** Which table a `WebsiteTable*` block draws: the layout hook its stylesheet reads. */
1693
+ export enum WebsiteTableLayout {
1694
+ COMPARISON = 'comparison',
1695
+ FACTS = 'facts',
1696
+ }
1697
+
1698
+ export function websiteComparisonTableSlots(rows: readonly string[], columns: readonly string[]): string[] {
1699
+ return ['caption', 'criterion', ...columns.map((column) => `${column}.name`), ...rows.flatMap((row) => [`${row}.criterion`, ...columns.map((column) => `${row}.${column}`)])];
1700
+ }
1701
+
1702
+ export function websiteFactTableSlots(rows: readonly string[], columns: readonly string[]): string[] {
1703
+ return ['caption', ...columns.map((column) => `${column}.name`), ...rows.flatMap((row) => columns.map((column) => `${row}.${column}`))];
1704
+ }
1705
+
1706
+ export interface WebsiteComparisonTableProps {
1707
+ readonly rows: readonly string[];
1708
+ readonly columns: readonly string[];
1709
+ /** The product's own column. */
1710
+ readonly highlight?: string;
1711
+ /** Show the caption above the table; by default it is read by assistive technology only (the section's heading names the table). */
1712
+ readonly showCaption?: boolean;
1713
+ readonly motion?: WebsiteBlockMotion<WebsiteTableMotionPoint>;
1714
+ }
1715
+
1716
+ /**
1717
+ * A table is wider than a phone (its `min-width`), so its wrapper scrolls sideways there, and a region that scrolls must
1718
+ * be reachable by keyboard (WCAG 2.1.1; axe's `scrollable-region-focusable`, found by `wildo website look` on two
1719
+ * pages, #2742 step 5f). So the wrapper is a focusable region named by the table's own caption, as the practice for a
1720
+ * scrolling table is: arrow keys scroll it once focused, and a screen reader announces what it holds.
1721
+ */
1722
+ // semantic-literal-boundary: an ARIA role and tab index, the DOM's own vocabulary
1723
+ function scrollRegion(captionId: string): { readonly role: 'region'; readonly tabIndex: 0; readonly 'aria-labelledby': string } {
1724
+ return { role: 'region', tabIndex: 0, 'aria-labelledby': captionId };
1725
+ }
1726
+
1727
+ export function WebsiteComparisonTable({ rows, columns, highlight, showCaption = false, motion }: WebsiteComparisonTableProps): ReactNode {
1728
+ const label = useWebsiteSectionLabels();
1729
+ const captionId = useId();
1730
+ const part = (column: string) => (column === highlight ? { 'data-website-part': 'highlight' } : {});
1731
+ return (
1732
+ <div data-website-block="table" data-website-layout={WebsiteTableLayout.COMPARISON} {...scrollRegion(captionId)} {...blockMotionAttributes(WebsiteTableMotionPoint.TABLE, TABLE_MOTION, motion)}>
1733
+ <table>
1734
+ <caption id={captionId} {...(showCaption ? {} : { 'data-website-visually-hidden': '' })}>{label('caption')}</caption>
1735
+ <thead>
1736
+ <tr>
1737
+ <th scope="col">{label('criterion')}</th>
1738
+ {columns.map((column) => (
1739
+ <th key={column} scope="col" {...part(column)}>
1740
+ {label(`${column}.name`)}
1741
+ </th>
1742
+ ))}
1743
+ </tr>
1744
+ </thead>
1745
+ <tbody>
1746
+ {rows.map((row) => (
1747
+ <tr key={row}>
1748
+ <th scope="row">{label(`${row}.criterion`)}</th>
1749
+ {columns.map((column) => (
1750
+ <td key={column} {...part(column)}>
1751
+ {label(`${row}.${column}`)}
1752
+ </td>
1753
+ ))}
1754
+ </tr>
1755
+ ))}
1756
+ </tbody>
1757
+ </table>
1758
+ </div>
1759
+ );
1760
+ }
1761
+ WebsiteComparisonTable.displayName = 'WebsiteComparisonTable';
1762
+
1763
+ export interface WebsiteFactTableProps {
1764
+ readonly rows: readonly string[];
1765
+ readonly columns: readonly string[];
1766
+ /** Show the caption above the table; by default it is read by assistive technology only (the section's heading names the table). */
1767
+ readonly showCaption?: boolean;
1768
+ readonly motion?: WebsiteBlockMotion<WebsiteTableMotionPoint>;
1769
+ }
1770
+
1771
+ export function WebsiteFactTable({ rows, columns, showCaption = false, motion }: WebsiteFactTableProps): ReactNode {
1772
+ const label = useWebsiteSectionLabels();
1773
+ const captionId = useId();
1774
+ return (
1775
+ <div data-website-block="table" data-website-layout={WebsiteTableLayout.FACTS} {...scrollRegion(captionId)} {...blockMotionAttributes(WebsiteTableMotionPoint.TABLE, TABLE_MOTION, motion)}>
1776
+ <table>
1777
+ <caption id={captionId} {...(showCaption ? {} : { 'data-website-visually-hidden': '' })}>{label('caption')}</caption>
1778
+ <thead>
1779
+ <tr>
1780
+ {columns.map((column) => (
1781
+ <th key={column} scope="col">
1782
+ {label(`${column}.name`)}
1783
+ </th>
1784
+ ))}
1785
+ </tr>
1786
+ </thead>
1787
+ <tbody>
1788
+ {rows.map((row) => (
1789
+ <tr key={row}>
1790
+ {columns.map((column, position) =>
1791
+ position === 0 ? (
1792
+ <th key={column} scope="row">
1793
+ {label(`${row}.${column}`)}
1794
+ </th>
1795
+ ) : (
1796
+ <td key={column}>{label(`${row}.${column}`)}</td>
1797
+ ),
1798
+ )}
1799
+ </tr>
1800
+ ))}
1801
+ </tbody>
1802
+ </table>
1803
+ </div>
1804
+ );
1805
+ }
1806
+ WebsiteFactTable.displayName = 'WebsiteFactTable';
1807
+ ```
1808
+
1809
+ ## FAQ and its structured data
1810
+
1811
+ ## Import Origins
1812
+
1813
+ - `@wildo-ai/saas-website`
1814
+
1815
+ ## Source Excerpts
1816
+
1817
+ ### Origin Package: `@wildo-ai/saas-website`
1818
+
1819
+ ```tsx
1820
+ *
1821
+ * `WebsiteFaq`: questions and answers (FAQ), each a native `<details>`, so it opens without JavaScript and every answer
1822
+ * is in the page for search engines and answer engines alike (#2742). Each question has a `question` and an `answer`
1823
+ * by slot (`<ref>.question`, `<ref>.answer`), under the section's intro (`intro`: which of its words it shows).
1824
+ * `layout` SIDE puts the intro in a narrow column beside the questions, STACKED above them.
1825
+ * `websiteFaqSlots(questions, intro)` lists every slot.
1826
+ *
1827
+ * Each question can be linked to: its entry carries the id `websiteFaqQuestionId(sectionRef, ref)` (`<section>-<ref>`,
1828
+ * unique on the page because section refs are), so a support answer or another page can link `/pricing#pricing-faq-q3`.
1829
+ * The page scrolls to the question, and the block opens it, on load and on every change of the fragment. Without
1830
+ * JavaScript the question is still in view, closed, one click from its answer.
1831
+ *
1832
+ * `websiteFaqStructuredData(questions)`: the section's FAQPage JSON-LD, built from the SAME words the section shows,
1833
+ * in the page's locale, on the server. Pass it as the section's `getStructuredData`. An FAQ is one of the
1834
+ * highest-leverage answer-engine surfaces, and a JSON-LD that says something the page does not is worse than none.
1835
+ * Each Question's `@id` is its link on the page; the FAQPage's is the section's (`#<section>`), so two FAQ sections on
1836
+ * one page publish two FAQPages that do not collide.
1837
+ */
1838
+ export function websiteFaqQuestionId(sectionRef: string, ref: string): string {
1839
+ return `${sectionRef}-${ref}`;
1840
+ }
1841
+
1842
+ export function websiteFaqSlots(questions: readonly string[], intro: WebsiteSectionIntroOptions = { eyebrow: false }): string[] {
1843
+ return [...websiteSectionIntroSlots(intro), ...questions.flatMap((ref) => [`${ref}.question`, `${ref}.answer`])];
1844
+ }
1845
+
1846
+ export function websiteFaqStructuredData(questions: readonly string[]): (context: WebsiteStructuredDataContext) => WebsiteStructuredDataPayload {
1847
+ return ({ label, pageUrl, locale, sectionRef }) => ({
1848
+ '@type': 'FAQPage',
1849
+ '@id': `${pageUrl}#${sectionRef}`,
1850
+ inLanguage: locale,
1851
+ mainEntity: questions.map((ref) => ({
1852
+ '@type': 'Question',
1853
+ '@id': `${pageUrl}#${websiteFaqQuestionId(sectionRef, ref)}`,
1854
+ name: label(`${ref}.question`),
1855
+ acceptedAnswer: { '@type': 'Answer', text: label(`${ref}.answer`) },
1856
+ })),
1857
+ });
1858
+ }
1859
+
1860
+ export interface WebsiteFaqProps {
1861
+ /** The slot prefix of each question, in order. */
1862
+ readonly questions: readonly string[];
1863
+ readonly intro?: WebsiteSectionIntroOptions;
1864
+ readonly layout?: WebsiteFaqLayout;
1865
+ }
1866
+
1867
+ export function WebsiteFaq({ questions, intro = { eyebrow: false }, layout = WebsiteFaqLayout.SIDE }: WebsiteFaqProps): ReactNode {
1868
+ const label = useWebsiteSectionLabels();
1869
+ const { sectionRef } = useWebsiteSection();
1870
+ const root = useRef<HTMLDivElement | null>(null);
1871
+ // A link to a question opens it: the browser scrolls to the entry, which a closed disclosure leaves showing only its question.
1872
+ useEffect(() => {
1873
+ const openLinkedQuestion = (): void => {
1874
+ const id = decodedFragment(window.location.hash);
1875
+ const entry = id === '' ? null : document.getElementById(id);
1876
+ if (entry instanceof HTMLDetailsElement && root.current?.contains(entry)) entry.open = true;
1877
+ };
1878
+ openLinkedQuestion();
1879
+ window.addEventListener('hashchange', openLinkedQuestion);
1880
+ return () => window.removeEventListener('hashchange', openLinkedQuestion);
1881
+ }, []);
1882
+ return (
1883
+ <div ref={root} data-website-block="faq" data-website-layout={layout}>
1884
+ <WebsiteSectionIntro {...intro} align={layout === WebsiteFaqLayout.SIDE ? WebsiteIntroAlign.START : WebsiteIntroAlign.CENTER} />
1885
+ <div data-website-part="list">
1886
+ {questions.map((ref) => (
1887
+ <details key={ref} id={websiteFaqQuestionId(sectionRef, ref)} data-website-part="entry">
1888
+ <summary>{label(`${ref}.question`)}</summary>
1889
+ <WebsiteText part="answer">{label(`${ref}.answer`)}</WebsiteText>
1890
+ </details>
1891
+ ))}
1892
+ </div>
1893
+ </div>
1894
+ );
1895
+ }
1896
+ WebsiteFaq.displayName = 'WebsiteFaq';
1897
+ ```
1898
+
1899
+ ## Solution paths
1900
+
1901
+ ## Import Origins
1902
+
1903
+ - `@wildo-ai/saas-website`
1904
+
1905
+ ## Source Excerpts
1906
+
1907
+ ### Origin Package: `@wildo-ai/saas-website`
1908
+
1909
+ ```tsx
1910
+ *
1911
+ * `WebsiteSolutionPaths` (SOLUTION_PATHS): one card per audience, each the whole-card link to the page written for it
1912
+ * (#2742). A path has a short label naming the audience, a title, a body and the words of its link by slot
1913
+ * (`<ref>.label`, `<ref>.title`, `<ref>.body`, `<ref>.cta`; `websiteSolutionPathsSlots(paths)`), and its glyph in a
1914
+ * solid tile: a path is a choice the reader makes, so it leads with a strong mark. As many columns as fit.
1915
+ */
1916
+ export enum WebsiteSolutionPathsMotionPoint {
1917
+ PATHS = 'paths',
1918
+ /** A path responds to the pointer: it is a link. */
1919
+ PATH = 'path',
1920
+ }
1921
+
1922
+ const PATHS_MOTION = defineBlockMotionPoints<WebsiteSolutionPathsMotionPoint>({
1923
+ [WebsiteSolutionPathsMotionPoint.PATHS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
1924
+ [WebsiteSolutionPathsMotionPoint.PATH]: { kind: WebsiteMotionPointKind.LINK_CARD, spec: { hover: WebsiteMotionHover.LIFT } },
1925
+ });
1926
+
1927
+ /** One audience: its slot prefix, the page written for it, and its glyph. */
1928
+ export interface WebsiteSolutionPath {
1929
+ readonly ref: string;
1930
+ readonly link: WebsiteLinkTo;
1931
+ readonly icon: ReactNode;
1932
+ }
1933
+
1934
+ export function websiteSolutionPathsSlots(paths: readonly WebsiteSolutionPath[] | readonly string[]): string[] {
1935
+ return paths.map((path) => (typeof path === 'string' ? path : path.ref)).flatMap((ref) => [`${ref}.label`, `${ref}.title`, `${ref}.body`, `${ref}.cta`]);
1936
+ }
1937
+
1938
+ export interface WebsiteSolutionPathsProps {
1939
+ readonly paths: readonly WebsiteSolutionPath[];
1940
+ readonly titleLevel?: WebsiteHeadingLevel;
1941
+ readonly motion?: WebsiteBlockMotion<WebsiteSolutionPathsMotionPoint>;
1942
+ }
1943
+
1944
+ export function WebsiteSolutionPaths({ paths, titleLevel = 3, motion }: WebsiteSolutionPathsProps): ReactNode {
1945
+ const label = useWebsiteSectionLabels();
1946
+ const hover = resolveBlockMotion(WebsiteSolutionPathsMotionPoint.PATH, PATHS_MOTION, motion);
1947
+ return (
1948
+ <ul data-website-block="solution-paths" {...blockMotionAttributes(WebsiteSolutionPathsMotionPoint.PATHS, PATHS_MOTION, motion)}>
1949
+ {paths.map((path) => (
1950
+ <WebsiteCard key={path.ref} link={path.link} {...(hover === null || hover === undefined ? {} : { hover })}>
1951
+ <WebsiteIconTile size={WebsiteIconTileSize.LG} tileStyle={WebsiteIconTileStyle.SOLID}>
1952
+ {path.icon}
1953
+ </WebsiteIconTile>
1954
+ <span data-website-part="label">{label(`${path.ref}.label`)}</span>
1955
+ <WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
1956
+ {label(`${path.ref}.title`)}
1957
+ </WebsiteHeading>
1958
+ <span data-website-part="body">{label(`${path.ref}.body`)}</span>
1959
+ <span data-website-part="arrow-link">
1960
+ {label(`${path.ref}.cta`)}
1961
+ <WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
1962
+ </span>
1963
+ </WebsiteCard>
1964
+ ))}
1965
+ </ul>
1966
+ );
1967
+ }
1968
+ WebsiteSolutionPaths.displayName = 'WebsiteSolutionPaths';
1969
+ ```
1970
+
1971
+ ## Quotations
1972
+
1973
+ ## Import Origins
1974
+
1975
+ - `@wildo-ai/saas-website`
1976
+
1977
+ ## Source Excerpts
1978
+
1979
+ ### Origin Package: `@wildo-ai/saas-website`
1980
+
1981
+ ```tsx
1982
+ *
1983
+ * `WebsiteQuoteCards` (SOCIAL_PROOF, or evidence about the problem): quotations, each with whose words they are and,
1984
+ * when published, a link to where (#2742). A quote has its `text` and its `source` by slot (`<ref>.text`,
1985
+ * `<ref>.source`; `websiteQuoteCardsSlots(quotes)`). `source` given a link makes the attribution that link, so a
1986
+ * reader can check the words. A quotation is a `<blockquote>`; the card carries the accent's rule on its leading edge.
1987
+ *
1988
+ * What the block cannot know is whose words they are: a TESTIMONIAL is a customer about the product, EVIDENCE is
1989
+ * anyone about the problem. Never present evidence as a testimonial (the `website-section-social-proof` skill).
1990
+ */
1991
+ export enum WebsiteQuoteCardsMotionPoint {
1992
+ QUOTES = 'quotes',
1993
+ }
1994
+
1995
+ const QUOTES_MOTION = defineBlockMotionPoints<WebsiteQuoteCardsMotionPoint>({
1996
+ [WebsiteQuoteCardsMotionPoint.QUOTES]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
1997
+ });
1998
+
1999
+ /** One quotation: its slot prefix, and where it was published, if it was. */
2000
+ export interface WebsiteQuote {
2001
+ readonly ref: string;
2002
+ readonly source?: WebsiteLinkTo;
2003
+ }
2004
+
2005
+ export function websiteQuoteCardsSlots(quotes: readonly WebsiteQuote[] | readonly string[]): string[] {
2006
+ return quotes.map((quote) => (typeof quote === 'string' ? quote : quote.ref)).flatMap((ref) => [`${ref}.text`, `${ref}.source`]);
2007
+ }
2008
+
2009
+ export interface WebsiteQuoteCardsProps {
2010
+ readonly quotes: readonly WebsiteQuote[];
2011
+ readonly motion?: WebsiteBlockMotion<WebsiteQuoteCardsMotionPoint>;
2012
+ }
2013
+
2014
+ export function WebsiteQuoteCards({ quotes, motion }: WebsiteQuoteCardsProps): ReactNode {
2015
+ const label = useWebsiteSectionLabels();
2016
+ return (
2017
+ <ul data-website-block="quote-cards" {...blockMotionAttributes(WebsiteQuoteCardsMotionPoint.QUOTES, QUOTES_MOTION, motion)}>
2018
+ {quotes.map((quote) => (
2019
+ <li key={quote.ref} data-website-part="quote">
2020
+ <blockquote data-website-part="text">{label(`${quote.ref}.text`)}</blockquote>
2021
+ {quote.source === undefined ? (
2022
+ <span data-website-part="source">{label(`${quote.ref}.source`)}</span>
2023
+ ) : (
2024
+ <WebsiteBlockLink link={quote.source} part="source">
2025
+ {label(`${quote.ref}.source`)}
2026
+ </WebsiteBlockLink>
2027
+ )}
2028
+ </li>
2029
+ ))}
2030
+ </ul>
2031
+ );
2032
+ }
2033
+ WebsiteQuoteCards.displayName = 'WebsiteQuoteCards';
2034
+ ```
2035
+
2036
+ ## Roadmap
2037
+
2038
+ ## Import Origins
2039
+
2040
+ - `@wildo-ai/saas-website`
2041
+
2042
+ ## Source Excerpts
2043
+
2044
+ ### Origin Package: `@wildo-ai/saas-website`
2045
+
2046
+ ```tsx
2047
+ *
2048
+ * `WebsiteRoadmap` (ROADMAP): the plan in the open, one card per roadmap phase in its order (#2742). A phase has its
2049
+ * horizon's word, a title and a body by slot (`<ref>.stage`, `<ref>.title`, `<ref>.body`) and its items
2050
+ * (`<ref>.<item>.text`; `websiteRoadmapSlots(phases)`). `horizon` is the application's own `RoadmapPhaseHorizon`,
2051
+ * the vocabulary its roadmap specification declares.
2052
+ *
2053
+ * An item is listed with a clock, as a promise, unless it is declared `available`: it works in the application
2054
+ * today, and then it gets a check. The horizon does not decide this, because a NOW phase is one in delivery,
2055
+ * not one delivered. Only a NOW phase may hold an available item: an item that works today in a phase the roadmap places
2056
+ * NEXT or LATER is a roadmap that has not caught up, and the page refuses it rather than show a check under a
2057
+ * later horizon. The check and the clock are drawings, so each item also carries its status in words for a screen
2058
+ * reader, visually hidden: `status.available` or `status.planned`, each declared only when an item needs it. Hooks:
2059
+ * `data-website-horizon` on each phase, `data-website-available` on an available item.
2060
+ */
2061
+ export enum WebsiteRoadmapMotionPoint {
2062
+ PHASES = 'phases',
2063
+ }
2064
+
2065
+ const ROADMAP_MOTION = defineBlockMotionPoints<WebsiteRoadmapMotionPoint>({
2066
+ [WebsiteRoadmapMotionPoint.PHASES]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
2067
+ });
2068
+
2069
+ /** One item of a phase: its slot prefix, and whether it works in the application today. */
2070
+ export interface WebsiteRoadmapItem {
2071
+ readonly ref: string;
2072
+ /** It works in the application today: verified there, not planned. Only a NOW phase may hold one. */
2073
+ readonly available?: boolean;
2074
+ }
2075
+
2076
+ /** One phase: its slot prefix, its horizon, and its items. */
2077
+ export interface WebsiteRoadmapPhase {
2078
+ readonly ref: string;
2079
+ readonly horizon: RoadmapPhaseHorizon;
2080
+ readonly items: readonly WebsiteRoadmapItem[];
2081
+ }
2082
+
2083
+ export function websiteRoadmapSlots(phases: readonly WebsiteRoadmapPhase[]): string[] {
2084
+ const items = phases.flatMap((phase) => phase.items);
2085
+ return [
2086
+ ...(items.some((item) => item.available === true) ? ['status.available'] : []),
2087
+ ...(items.some((item) => item.available !== true) ? ['status.planned'] : []),
2088
+ ...phases.flatMap((phase) => [`${phase.ref}.stage`, `${phase.ref}.title`, `${phase.ref}.body`, ...phase.items.map((item) => `${phase.ref}.${item.ref}.text`)]),
2089
+ ];
2090
+ }
2091
+
2092
+ function assertAvailableOnlyNow(phase: WebsiteRoadmapPhase): void {
2093
+ const early = phase.items.find((item) => item.available === true);
2094
+ if (early !== undefined && phase.horizon !== RoadmapPhaseHorizon.NOW) {
2095
+ throw new Error(
2096
+ `[website roadmap] Item "${phase.ref}.${early.ref}" is declared available, but its phase is ${phase.horizon.toUpperCase()}. `
2097
+ + 'Something that works today belongs to a NOW phase: move the item, or update the roadmap specification first.',
2098
+ );
2099
+ }
2100
+ }
2101
+
2102
+ export interface WebsiteRoadmapProps {
2103
+ readonly phases: readonly WebsiteRoadmapPhase[];
2104
+ readonly titleLevel?: WebsiteHeadingLevel;
2105
+ readonly motion?: WebsiteBlockMotion<WebsiteRoadmapMotionPoint>;
2106
+ }
2107
+
2108
+ function RoadmapPhaseCard({ phase, titleLevel }: { phase: WebsiteRoadmapPhase; titleLevel: WebsiteHeadingLevel }): ReactNode {
2109
+ const label = useWebsiteSectionLabels();
2110
+ assertAvailableOnlyNow(phase);
2111
+ return (
2112
+ <li data-website-card="" data-website-horizon={phase.horizon}>
2113
+ <span data-website-part="stage">{label(`${phase.ref}.stage`)}</span>
2114
+ <WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
2115
+ {label(`${phase.ref}.title`)}
2116
+ </WebsiteHeading>
2117
+ <span data-website-part="body">{label(`${phase.ref}.body`)}</span>
2118
+ <ul data-website-part="items">
2119
+ {phase.items.map((item) => (
2120
+ <li key={item.ref} {...(item.available === true ? { 'data-website-available': '' } : {})}>
2121
+ <WebsiteInterfaceGlyph name={item.available === true ? WebsiteInterfaceGlyphName.CHECK : WebsiteInterfaceGlyphName.CLOCK} part="marker" />
2122
+ <span>
2123
+ <span data-website-visually-hidden="">{label(item.available === true ? 'status.available' : 'status.planned')} </span>
2124
+ {label(`${phase.ref}.${item.ref}.text`)}
2125
+ </span>
2126
+ </li>
2127
+ ))}
2128
+ </ul>
2129
+ </li>
2130
+ );
2131
+ }
2132
+
2133
+ export function WebsiteRoadmap({ phases, titleLevel = 3, motion }: WebsiteRoadmapProps): ReactNode {
2134
+ return (
2135
+ <ol data-website-block="roadmap" {...blockMotionAttributes(WebsiteRoadmapMotionPoint.PHASES, ROADMAP_MOTION, motion)}>
2136
+ {phases.map((phase) => (
2137
+ <RoadmapPhaseCard key={phase.ref} phase={phase} titleLevel={titleLevel} />
2138
+ ))}
2139
+ </ol>
2140
+ );
2141
+ }
2142
+ WebsiteRoadmap.displayName = 'WebsiteRoadmap';
2143
+ ```
2144
+
2145
+ ## Import Origins
2146
+
2147
+ - `@wildo-ai/saas-models`
2148
+
2149
+ ## Source Excerpts
2150
+
2151
+ ### Origin Package: `@wildo-ai/saas-models`
2152
+
2153
+ ```typescript
2154
+ *
2155
+ * Coarse delivery-horizon bucket a roadmap phase sits in — the classic NOW / NEXT / LATER lens. Fixed vocabulary
2156
+ * (enum, per project rule — enums over literal unions). Orthogonal to a phase's `sequence` (which gives the precise
2157
+ * order) and to its `kind` (which classifies the phase's lifecycle stage): `horizon` answers "how soon", coarsely, for
2158
+ * at-a-glance roadmap grouping. Optional on a phase.
2159
+ *
2160
+ * It lives here, import-free, rather than beside the roadmap specification schema (`RoadmapPhaseConfig` in
2161
+ * `@wildo-ai/saas-specifications`) because two audiences read it: the specification that declares a phase, and the
2162
+ * website that shows it (`WebsiteRoadmap`, which ships to the browser and reaches it through
2163
+ * `@wildo-ai/saas-models/public-runtime`). One vocabulary, so the site cannot call "now" what the roadmap calls "next".
2164
+ */
2165
+ export enum RoadmapPhaseHorizon {
2166
+ /** In active delivery now / imminently. */
2167
+ NOW = 'now',
2168
+ /** Queued directly after the current horizon. */
2169
+ NEXT = 'next',
2170
+ /** Further-out intent — directionally committed, not yet scheduled. */
2171
+ LATER = 'later',
2172
+ }
2173
+ ```
2174
+
2175
+ ## Pricing
2176
+
2177
+ ## Import Origins
2178
+
2179
+ - `@wildo-ai/saas-website`
2180
+
2181
+ ## Source Excerpts
2182
+
2183
+ ### Origin Package: `@wildo-ai/saas-website`
2184
+
2185
+ ```tsx
2186
+ *
2187
+ * `WebsitePricing` (PRICING): the plans the application sells, from its billing catalogue (#2742). A price is never a
2188
+ * word: amounts, currency, recurrence, basis, trial length, the recommended plan and the price disclosure all come from
2189
+ * the catalogue the route delivers (`useWebsitePricingCatalog`), so the page, its JSON-LD and checkout cannot disagree.
2190
+ *
2191
+ * - `layout` TEASER: each plan's name, price and summary, and a link to the pricing page (`pricingPage`). PLANS: the
2192
+ * full cards, with a monthly / yearly switch when the catalogue prices plans at both cadences, each plan's feature
2193
+ * lines, its trial, and its call to action (`signUp`, the application's sign-up by default; a plan's own `link`
2194
+ * instead, e.g. a contact page for a plan priced on request). Each plan card carries the id `plan-<key>`, the
2195
+ * fragment the pricing page's offer JSON-LD (`buildWebsitePricingOfferStructuredData`) gives each offer's URL.
2196
+ * - The WORDS are per plan, keyed by the catalogue's plan key: `plans` says which plans the site has words for, and
2197
+ * which feature lines each shows. A plan the catalogue lists without words stops the page (rather than render raw
2198
+ * keys); a feature line names the GRANT it describes (a feature or limit id of the plan's product), and a line naming
2199
+ * something the plan does not grant stops the page too — a pricing page must not promise what checkout does not sell.
2200
+ * - A PRICE IS A SENTENCE the catalogue decides, and every part of it is a declared word:
2201
+ * - its recurrence: `periods` lists the ones the section has words for (`websitePricingPeriodSlot`: `period.month`,
2202
+ * `period.year`, `period.once` for a one-time price, `period.month.3` for every three months). Defaults: a
2203
+ * month for TEASER, a month and a year for PLANS (which also declares the switch's words);
2204
+ * - its state, through `statements` (`WebsitePricingStatement`): a floor (STARTING_AT, `price.from` before the
2205
+ * amount), a price per unit (PER_UNIT, `price.per-unit` after the period, e.g. "per member"), a price whose total
2206
+ * depends on quantity (VARIABLE, `price.variable` IN PLACE of the amount: the catalogue forbids presenting that
2207
+ * amount as the price), a plan priced on request (ON_REQUEST, `price.on-request` in place of the amount and the
2208
+ * period), a free trial (TRIAL, `trial.before` N `trial.after`), a plan announced and not yet on sale (UPCOMING,
2209
+ * `upcoming` where the call to action would be: sign-up refuses it, so the card must not offer it).
2210
+ * A plan whose price needs a word the section did not declare stops the page, naming the statement or period to
2211
+ * declare. So a catalogue change (a per-seat price, a yearly-only plan) can never render as a wrong sentence.
2212
+ *
2213
+ * Slots: `websitePricingSlots(options)`. Hooks: `data-website-block="pricing"`, `data-website-layout`, the parts
2214
+ * `plans` (`data-website-columns`: the plan count), `plan` (`data-website-recommended` on the recommended one,
2215
+ * `data-website-availability`), `badge`, `name`, `price`, `from`, `amount`, `period`, `per-unit`, `variable`,
2216
+ * `on-request`, `summary`, `trial`, `features`, `marker`, `upcoming`, `cadence`, `note`, `link`.
2217
+ */
2218
+ export enum WebsitePricingLayout {
2219
+ /** A summary of the plans for a page that is not the pricing page: name, price, one line, and a link. */
2220
+ TEASER = 'teaser',
2221
+ /** The pricing page's plan cards. */
2222
+ PLANS = 'plans',
2223
+ }
2224
+
2225
+ /** A state of a plan or of its price that the section has words for. */
2226
+ export enum WebsitePricingStatement {
2227
+ /** The price is a floor: `price.from` before the amount. */
2228
+ STARTING_AT = 'starting-at',
2229
+ /** The price is per unit (a seat, a member): `price.per-unit` after the period. */
2230
+ PER_UNIT = 'per-unit',
2231
+ /** The total depends on quantity: `price.variable` in place of the amount, which the catalogue forbids as the price. */
2232
+ VARIABLE = 'variable',
2233
+ /** The plan is priced on request: `price.on-request` in place of the amount and the period. */
2234
+ ON_REQUEST = 'on-request',
2235
+ /** The plan offers a free trial: `trial.before` N `trial.after`. */
2236
+ TRIAL = 'trial',
2237
+ /** The plan is announced, not yet on sale: `upcoming` in place of the call to action. */
2238
+ UPCOMING = 'upcoming',
2239
+ }
2240
+
2241
+ const STATEMENT_SLOTS: Readonly<Record<WebsitePricingStatement, readonly string[]>> = {
2242
+ [WebsitePricingStatement.STARTING_AT]: ['price.from'],
2243
+ [WebsitePricingStatement.PER_UNIT]: ['price.per-unit'],
2244
+ [WebsitePricingStatement.VARIABLE]: ['price.variable'],
2245
+ [WebsitePricingStatement.ON_REQUEST]: ['price.on-request'],
2246
+ [WebsitePricingStatement.TRIAL]: ['trial.before', 'trial.after'],
2247
+ [WebsitePricingStatement.UPCOMING]: ['upcoming'],
2248
+ };
2249
+
2250
+ /** A recurrence the section has a word for. */
2251
+ export interface WebsitePricingPeriod {
2252
+ readonly unit: PublicPricingRecurrenceUnit;
2253
+ readonly count: number;
2254
+ }
2255
+
2256
+ /** The slot of a recurrence's word: `period.once`, `period.month`, `period.year`, or `period.<unit>.<count>`. */
2257
+ export function websitePricingPeriodSlot({ unit, count }: WebsitePricingPeriod): string {
2258
+ if (unit === PublicPricingRecurrenceUnit.ONE_TIME) return 'period.once';
2259
+ return count === 1 ? `period.${unit}` : `period.${unit}.${count}`;
2260
+ }
2261
+
2262
+ const MONTHLY: WebsitePricingPeriod = { unit: PublicPricingRecurrenceUnit.MONTH, count: 1 };
2263
+ const YEARLY: WebsitePricingPeriod = { unit: PublicPricingRecurrenceUnit.YEAR, count: 1 };
2264
+
2265
+ export enum WebsitePricingMotionPoint {
2266
+ PLANS = 'plans',
2267
+ }
2268
+
2269
+ const PRICING_MOTION = defineBlockMotionPoints<WebsitePricingMotionPoint>({
2270
+ [WebsitePricingMotionPoint.PLANS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
2271
+ });
2272
+
2273
+ /** One line of a plan card: its slot (`plans.<key>.<ref>`) and the feature or limit id of the plan it describes. */
2274
+ export interface WebsitePricingFeatureLine {
2275
+ readonly ref: string;
2276
+ readonly grant: string;
2277
+ }
2278
+
2279
+ /** The words a site has for one catalogue plan, and where its call to action goes when not to sign-up. */
2280
+ export interface WebsitePricingPlanWords {
2281
+ readonly key: string;
2282
+ readonly features?: readonly WebsitePricingFeatureLine[];
2283
+ /** This plan's call to action, instead of the block's `signUp`: an ON_REQUEST plan's contact page, say. */
2284
+ readonly link?: WebsiteLinkTo;
2285
+ }
2286
+
2287
+ export interface WebsitePricingSlotOptions {
2288
+ readonly layout: WebsitePricingLayout;
2289
+ readonly plans: readonly WebsitePricingPlanWords[];
2290
+ /** TEASER: the link to the pricing page has words (`link`). */
2291
+ readonly pricingPage?: unknown;
2292
+ /** PLANS: a note under the plans (`note`): what an add-on costs, what the plans exclude. */
2293
+ readonly note?: boolean;
2294
+ /** The recurrences the section has words for. Defaults: a month (TEASER); a month and a year (PLANS). */
2295
+ readonly periods?: readonly WebsitePricingPeriod[];
2296
+ /** The price and plan states the section has words for. */
2297
+ readonly statements?: readonly WebsitePricingStatement[];
2298
+ }
2299
+
2300
+ function periodsOf(options: Pick<WebsitePricingSlotOptions, 'layout' | 'periods'>): readonly WebsitePricingPeriod[] {
2301
+ return options.periods ?? (options.layout === WebsitePricingLayout.TEASER ? [MONTHLY] : [MONTHLY, YEARLY]);
2302
+ }
2303
+
2304
+ const isPeriod = (period: WebsitePricingPeriod, other: WebsitePricingPeriod) => period.unit === other.unit && period.count === other.count;
2305
+
2306
+ /** PLANS with words for both a month and a year: the section can offer the cadence switch. */
2307
+ function declaresCadenceSwitch(options: Pick<WebsitePricingSlotOptions, 'layout' | 'periods'>): boolean {
2308
+ const periods = periodsOf(options);
2309
+ return options.layout === WebsitePricingLayout.PLANS && periods.some((period) => isPeriod(period, MONTHLY)) && periods.some((period) => isPeriod(period, YEARLY));
2310
+ }
2311
+
2312
+ export function websitePricingSlots(options: WebsitePricingSlotOptions): string[] {
2313
+ const teaser = options.layout === WebsitePricingLayout.TEASER;
2314
+ return [
2315
+ 'recommended',
2316
+ ...periodsOf(options).map(websitePricingPeriodSlot),
2317
+ ...(options.statements ?? []).flatMap((statement) => STATEMENT_SLOTS[statement]),
2318
+ ...(declaresCadenceSwitch(options) ? ['billing.label', 'billing.monthly', 'billing.yearly'] : []),
2319
+ ...(teaser ? (options.pricingPage !== undefined ? ['link'] : []) : options.note === true ? ['note'] : []),
2320
+ ...options.plans.flatMap((plan) => [
2321
+ `plans.${plan.key}.name`,
2322
+ `plans.${plan.key}.summary`,
2323
+ ...(teaser ? [] : [`plans.${plan.key}.cta`, ...(plan.features ?? []).map((line) => `plans.${plan.key}.${line.ref}`)]),
2324
+ ]),
2325
+ ];
2326
+ }
2327
+
2328
+ export interface WebsitePricingProps extends WebsitePricingSlotOptions {
2329
+ /** Where every plan's call to action goes (PLANS). */
2330
+ readonly signUp?: WebsiteLinkTo;
2331
+ /** The pricing page (TEASER). */
2332
+ readonly pricingPage?: WebsiteLinkTo;
2333
+ readonly motion?: WebsiteBlockMotion<WebsitePricingMotionPoint>;
2334
+ }
2335
+
2336
+ const DEFAULT_SIGN_UP: WebsiteLinkTo = { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP };
2337
+
2338
+ /** The plan's price at a cadence, or its default when it has none at that cadence (a free plan is monthly only). */
2339
+ function priceAt(plan: PublicPricingPlan, cadence: WebsitePricingPeriod): PublicPricingPrice | undefined {
2340
+ return plan.prices.find((price) => isPeriod(price.recurrence, cadence)) ?? plan.prices.find((price) => price.isDefault) ?? plan.prices[0];
2341
+ }
2342
+
2343
+ /** The words a plan's card and price need in a layout, each with the declaration that provides it. */
2344
+ function wordsOfPrice(plan: PublicPricingPlan, price: PublicPricingPrice | undefined, layout: WebsitePricingLayout): ReadonlyArray<readonly [string, string]> {
2345
+ const statement = (value: WebsitePricingStatement) => STATEMENT_SLOTS[value].map((slot) => [slot, `the statement WebsitePricingStatement.${value.toUpperCase().replace(/-/g, '_')}`] as const);
2346
+ const words: Array<readonly [string, string]> = [];
2347
+ if (plan.availability === ProductAvailability.UPCOMING) words.push(...statement(WebsitePricingStatement.UPCOMING));
2348
+ // Only the plan cards state a trial; the teaser is name, price and one line.
2349
+ if (plan.trialDays !== undefined && layout === WebsitePricingLayout.PLANS) words.push(...statement(WebsitePricingStatement.TRIAL));
2350
+ if (plan.priceDisclosure === ProductPriceDisclosure.ON_REQUEST) return [...words, ...statement(WebsitePricingStatement.ON_REQUEST)];
2351
+ if (price === undefined) return words;
2352
+ if (plan.priceDisclosure === ProductPriceDisclosure.STARTING_AT) words.push(...statement(WebsitePricingStatement.STARTING_AT));
2353
+ if (price.amountBasis === PublicPricingAmountBasis.VARIABLE) return [...words, ...statement(WebsitePricingStatement.VARIABLE)];
2354
+ const slot = websitePricingPeriodSlot(price.recurrence);
2355
+ words.push([slot, `the period { unit: ${price.recurrence.unit}, count: ${price.recurrence.count} } in \`periods\``]);
2356
+ if (price.amountBasis === PublicPricingAmountBasis.PER_UNIT) words.push(...statement(WebsitePricingStatement.PER_UNIT));
2357
+ return words;
2358
+ }
2359
+
2360
+ interface ShownPlan {
2361
+ readonly plan: PublicPricingPlan;
2362
+ readonly words: WebsitePricingPlanWords;
2363
+ }
2364
+
2365
+ /**
2366
+ * The plans the site shows, in catalogue order (every plan the catalogue lists publicly), each checked to have its
2367
+ * words, honest feature lines, and a word for every part of every price it can show at the cadences the block offers.
2368
+ */
2369
+ function useShownPlans(options: WebsitePricingSlotOptions, cadences: readonly WebsitePricingPeriod[]): readonly ShownPlan[] {
2370
+ const { plans } = useWebsitePricingCatalog();
2371
+ const declared = new Set(websitePricingSlots(options));
2372
+ return plans.map((plan) => {
2373
+ const planWords = options.plans.find((entry) => entry.key === plan.key);
2374
+ if (planWords === undefined) {
2375
+ throw new Error(
2376
+ `[website pricing] The billing catalogue lists plan "${plan.key}", which the section has no words for. `
2377
+ + 'Add it to the pricing block\'s `plans` and its words to every label pack.',
2378
+ );
2379
+ }
2380
+ for (const cadence of cadences) {
2381
+ for (const [slot, declaration] of wordsOfPrice(plan, priceAt(plan, cadence), options.layout)) {
2382
+ if (!declared.has(slot)) {
2383
+ throw new Error(
2384
+ `[website pricing] Plan "${plan.key}" needs the word "${slot}", which the section did not declare. Declare ${declaration} `
2385
+ + 'on the pricing block and its slot helper, and the word in every label pack.',
2386
+ );
2387
+ }
2388
+ }
2389
+ }
2390
+ const grants = new Set([...plan.grantedFeatures, ...plan.grantedLimits]);
2391
+ for (const line of planWords.features ?? []) {
2392
+ if (!grants.has(line.grant)) {
2393
+ throw new Error(
2394
+ `[website pricing] The line "plans.${plan.key}.${line.ref}" describes "${line.grant}", which plan "${plan.key}" `
2395
+ + `does not grant (it grants: ${[...grants].join(', ') || 'nothing'}). A pricing page must not promise what checkout does not sell.`,
2396
+ );
2397
+ }
2398
+ }
2399
+ return { plan, words: planWords };
2400
+ });
2401
+ }
2402
+
2403
+ /** A catalogue amount in the page's locale and the price's own currency, from the exact decimal, never a float sum. */
2404
+ function useAmount(price: PublicPricingPrice | undefined): string {
2405
+ const { locale } = useWebsiteRuntime();
2406
+ if (price === undefined) return '';
2407
+ const decimal = publicPricingAmountDecimal(price);
2408
+ return new Intl.NumberFormat(locale, {
2409
+ style: 'currency',
2410
+ currency: price.currency,
2411
+ maximumFractionDigits: decimal.includes('.') && !decimal.endsWith('.00') ? price.decimals : 0,
2412
+ }).format(Number(decimal));
2413
+ }
2414
+
2415
+ /** The price as the catalogue states it: a floor, an amount, its recurrence and its unit, or the word in its place. */
2416
+ function PriceStatement({ plan, price, Period }: { plan: PublicPricingPlan; price: PublicPricingPrice | undefined; Period: 'span' | 'small' }): ReactNode {
2417
+ const amount = useAmount(price);
2418
+ const label = useWebsiteSectionLabels();
2419
+ if (plan.priceDisclosure === ProductPriceDisclosure.ON_REQUEST) return <span data-website-part="on-request">{label('price.on-request')}</span>;
2420
+ if (price === undefined) return null;
2421
+ const from = plan.priceDisclosure === ProductPriceDisclosure.STARTING_AT && <span data-website-part="from">{label('price.from')}</span>;
2422
+ if (price.amountBasis === PublicPricingAmountBasis.VARIABLE) {
2423
+ return (
2424
+ <>
2425
+ {from}
2426
+ <span data-website-part="variable">{label('price.variable')}</span>
2427
+ </>
2428
+ );
2429
+ }
2430
+ return (
2431
+ <>
2432
+ {from}
2433
+ <span data-website-part="amount">{amount}</span>
2434
+ <Period data-website-part="period">{label(websitePricingPeriodSlot(price.recurrence))}</Period>
2435
+ {price.amountBasis === PublicPricingAmountBasis.PER_UNIT && <span data-website-part="per-unit">{label('price.per-unit')}</span>}
2436
+ </>
2437
+ );
2438
+ }
2439
+
2440
+ function TeaserPlan({ plan }: { plan: PublicPricingPlan }): ReactNode {
2441
+ const label = useWebsiteSectionLabels();
2442
+ return (
2443
+ <li data-website-part="plan" data-website-availability={plan.availability} {...(plan.isRecommended ? { 'data-website-recommended': '' } : {})}>
2444
+ {plan.isRecommended && <span data-website-part="badge">{label('recommended')}</span>}
2445
+ <strong data-website-part="name">{label(`plans.${plan.key}.name`)}</strong>
2446
+ <span data-website-part="price">
2447
+ <PriceStatement plan={plan} price={priceAt(plan, MONTHLY)} Period="small" />
2448
+ </span>
2449
+ <span data-website-part="summary">{label(`plans.${plan.key}.summary`)}</span>
2450
+ {plan.availability === ProductAvailability.UPCOMING && <span data-website-part="upcoming">{label('upcoming')}</span>}
2451
+ </li>
2452
+ );
2453
+ }
2454
+
2455
+ function PlanCard({ plan, words, cadence, signUp }: { plan: PublicPricingPlan; words: WebsitePricingPlanWords; cadence: WebsitePricingPeriod; signUp: WebsiteLinkTo }): ReactNode {
2456
+ const label = useWebsiteSectionLabels();
2457
+ const target = useWebsiteLinkTarget()(words.link ?? signUp);
2458
+ return (
2459
+ <li
2460
+ id={`plan-${plan.key}`}
2461
+ data-website-part="plan"
2462
+ data-website-availability={plan.availability}
2463
+ {...(plan.isRecommended ? { 'data-website-recommended': '' } : {})}
2464
+ >
2465
+ {plan.isRecommended && <span data-website-part="badge">{label('recommended')}</span>}
2466
+ <strong data-website-part="name">{label(`plans.${plan.key}.name`)}</strong>
2467
+ <p data-website-part="price">
2468
+ <PriceStatement plan={plan} price={priceAt(plan, cadence)} Period="span" />
2469
+ </p>
2470
+ <span data-website-part="summary">
2471
+ {label(`plans.${plan.key}.summary`)}
2472
+ {plan.trialDays !== undefined && (
2473
+ <span data-website-part="trial">
2474
+ {label('trial.before')} {plan.trialDays}
2475
+ {label('trial.after')}
2476
+ </span>
2477
+ )}
2478
+ </span>
2479
+ <ul data-website-part="features">
2480
+ {(words.features ?? []).map((line) => (
2481
+ <li key={line.ref}>
2482
+ <WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.CHECK} part="marker" />
2483
+ {label(`plans.${plan.key}.${line.ref}`)}
2484
+ </li>
2485
+ ))}
2486
+ </ul>
2487
+ {plan.availability === ProductAvailability.UPCOMING ? (
2488
+ // Sign-up refuses a plan not yet on sale, so the card announces it instead of offering a door that would refuse.
2489
+ <span data-website-part="upcoming">{label('upcoming')}</span>
2490
+ ) : (
2491
+ <div data-website-actions="">
2492
+ <WebsiteButton href={target.href} external={target.external} variant={plan.isRecommended ? WebsiteButtonVariant.PRIMARY : WebsiteButtonVariant.SECONDARY}>
2493
+ {label(`plans.${plan.key}.cta`)}
2494
+ </WebsiteButton>
2495
+ </div>
2496
+ )}
2497
+ </li>
2498
+ );
2499
+ }
2500
+
2501
+ /** The monthly / yearly switch: a radio group, so it is one tab stop and the arrow keys move between cadences. */
2502
+ function CadenceSwitch({ cadence, onChange }: { cadence: WebsitePricingPeriod; onChange: (cadence: WebsitePricingPeriod) => void }): ReactNode {
2503
+ const label = useWebsiteSectionLabels();
2504
+ const name = useId();
2505
+ const cadences = [
2506
+ [MONTHLY, label('billing.monthly')],
2507
+ [YEARLY, label('billing.yearly')],
2508
+ ] as const;
2509
+ return (
2510
+ <fieldset data-website-part="cadence">
2511
+ <legend data-website-visually-hidden="">{label('billing.label')}</legend>
2512
+ {cadences.map(([option, text]) => (
2513
+ <label key={option.unit}>
2514
+ <input type="radio" name={name} value={option.unit} checked={isPeriod(option, cadence)} onChange={() => onChange(option)} />
2515
+ {text}
2516
+ </label>
2517
+ ))}
2518
+ </fieldset>
2519
+ );
2520
+ }
2521
+
2522
+ /** Does any plan the catalogue lists have a price at this cadence? */
2523
+ function catalogPricesAt(plans: readonly PublicPricingPlan[], cadence: WebsitePricingPeriod): boolean {
2524
+ return plans.some((plan) => plan.prices.some((price) => isPeriod(price.recurrence, cadence)));
2525
+ }
2526
+
2527
+ export function WebsitePricing(props: WebsitePricingProps): ReactNode {
2528
+ const { layout, pricingPage, note = false, signUp = DEFAULT_SIGN_UP, motion } = props;
2529
+ const label = useWebsiteSectionLabels();
2530
+ const [cadence, setCadence] = useState(MONTHLY);
2531
+ const { plans } = useWebsitePricingCatalog();
2532
+ // The switch is offered when the catalogue prices plans at both cadences; the section must then have its words.
2533
+ const offersSwitch = layout === WebsitePricingLayout.PLANS && catalogPricesAt(plans, MONTHLY) && catalogPricesAt(plans, YEARLY);
2534
+ if (offersSwitch && !declaresCadenceSwitch(props)) {
2535
+ throw new Error(
2536
+ '[website pricing] The billing catalogue prices plans monthly and yearly, so the plans offer a switch between them, and the '
2537
+ + 'section has no words for it. Declare both periods (a month and a year) in `periods` on the block and its slot helper.',
2538
+ );
2539
+ }
2540
+ const shown = useShownPlans(props, layout === WebsitePricingLayout.TEASER ? [MONTHLY] : offersSwitch ? [MONTHLY, YEARLY] : [MONTHLY]);
2541
+ const list = (
2542
+ <ul data-website-part="plans" data-website-columns={String(shown.length)} {...blockMotionAttributes(WebsitePricingMotionPoint.PLANS, PRICING_MOTION, motion)}>
2543
+ {shown.map(({ plan, words }) =>
2544
+ layout === WebsitePricingLayout.TEASER ? <TeaserPlan key={plan.key} plan={plan} /> : <PlanCard key={plan.key} plan={plan} words={words} cadence={cadence} signUp={signUp} />,
2545
+ )}
2546
+ </ul>
2547
+ );
2548
+ if (layout === WebsitePricingLayout.TEASER) {
2549
+ return (
2550
+ <div data-website-block="pricing" data-website-layout={layout}>
2551
+ {list}
2552
+ {pricingPage !== undefined && (
2553
+ <p data-website-part="link">
2554
+ <WebsiteArrowLink link={pricingPage}>{label('link')}</WebsiteArrowLink>
2555
+ </p>
2556
+ )}
2557
+ </div>
2558
+ );
2559
+ }
2560
+ return (
2561
+ <div data-website-block="pricing" data-website-layout={layout}>
2562
+ {offersSwitch && <CadenceSwitch cadence={cadence} onChange={setCadence} />}
2563
+ {list}
2564
+ {note && <p data-website-part="note">{label('note')}</p>}
2565
+ </div>
2566
+ );
2567
+ }
2568
+ WebsitePricing.displayName = 'WebsitePricing';
2569
+ ```
2570
+
2571
+ ## Latest posts
2572
+
2573
+ ## Import Origins
2574
+
2575
+ - `@wildo-ai/saas-website`
2576
+
2577
+ ## Source Excerpts
2578
+
2579
+ ### Origin Package: `@wildo-ai/saas-website`
2580
+
2581
+ ```tsx
2582
+ *
2583
+ * `WebsiteLatestPosts` (LATEST_POSTS): the blog's newest posts as cards (#2742). Each card is read from the post's own
2584
+ * frontmatter through `useWebsiteBlogIndex()` (its cover, date, title, summary and tags), never copied into the label
2585
+ * pack, and links to the post. The date is `formatWebsitePublicationDate`, the formatter a post's byline uses, and each
2586
+ * tag is shown by its word (`website.chrome.blog-tag.<tag>`), never by its ref. A post with no cover gets a drawn
2587
+ * placeholder in the brand's colours. The section owns only its framing words and two link labels: `read` on each
2588
+ * card, `all` on the link to the blog (`allPosts`, omitted on the blog index itself). `websiteLatestPostsSlots(...)`.
2589
+ */
2590
+ export enum WebsiteLatestPostsMotionPoint {
2591
+ POSTS = 'posts',
2592
+ /** A post card responds to the pointer: it is a link. */
2593
+ POST = 'post',
2594
+ }
2595
+
2596
+ const POSTS_MOTION = defineBlockMotionPoints<WebsiteLatestPostsMotionPoint>({
2597
+ [WebsiteLatestPostsMotionPoint.POSTS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
2598
+ [WebsiteLatestPostsMotionPoint.POST]: { kind: WebsiteMotionPointKind.LINK_CARD, spec: { hover: WebsiteMotionHover.LIFT } },
2599
+ });
2600
+
2601
+ export function websiteLatestPostsSlots(options: { readonly allPosts?: unknown } = {}): string[] {
2602
+ return ['read', ...(options.allPosts !== undefined ? ['all'] : [])];
2603
+ }
2604
+
2605
+ export interface WebsiteLatestPostsProps {
2606
+ /** The blog's index page, linked under the cards; omit on the blog index itself. */
2607
+ readonly allPosts?: WebsiteLinkTo;
2608
+ /** How many posts at most, newest first; every post when omitted. */
2609
+ readonly limit?: number;
2610
+ readonly titleLevel?: WebsiteHeadingLevel;
2611
+ readonly motion?: WebsiteBlockMotion<WebsiteLatestPostsMotionPoint>;
2612
+ }
2613
+
2614
+ /** A tag by its word, never its ref. */
2615
+ export function WebsiteBlogTag({ tag }: { tag: string }): ReactNode {
2616
+ return <li data-website-part="tag">{useWebsiteLabelByKey(websiteBlogTagLabelKey(tag))}</li>;
2617
+ }
2618
+ WebsiteBlogTag.displayName = 'WebsiteBlogTag';
2619
+
2620
+ function PostCard({ entry, titleLevel, hover }: { entry: WebsiteBlogIndexEntry; titleLevel: WebsiteHeadingLevel; hover: WebsiteMotionSpec | null | undefined }): ReactNode {
2621
+ const { locale } = useWebsiteRuntime();
2622
+ const label = useWebsiteSectionLabels();
2623
+ return (
2624
+ <WebsiteCard link={{ kind: WebsiteMenuLinkKind.PAGE, routePath: entry.routePath }} {...(hover === null || hover === undefined ? {} : { hover })}>
2625
+ {entry.cover === undefined ? (
2626
+ <span data-website-part="cover" aria-hidden="true" />
2627
+ ) : (
2628
+ // The cover's own size, measured when the site was built; the card frames it at the link-preview ratio.
2629
+ <WebsiteImage part="cover" src={entry.cover.src} alt="" width={entry.cover.width} height={entry.cover.height} />
2630
+ )}
2631
+ <time data-website-part="meta" dateTime={entry.publishedAt}>
2632
+ {formatWebsitePublicationDate(entry.publishedAt, locale)}
2633
+ </time>
2634
+ <WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
2635
+ {entry.title}
2636
+ </WebsiteHeading>
2637
+ <span data-website-part="summary">{entry.summary}</span>
2638
+ {entry.tags.length > 0 && (
2639
+ <ul data-website-part="tags">
2640
+ {entry.tags.map((tag) => (
2641
+ <WebsiteBlogTag key={tag} tag={tag} />
2642
+ ))}
2643
+ </ul>
2644
+ )}
2645
+ <span data-website-part="arrow-link">
2646
+ {label('read')}
2647
+ <WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
2648
+ </span>
2649
+ </WebsiteCard>
2650
+ );
2651
+ }
2652
+
2653
+ export function WebsiteLatestPosts({ allPosts, limit, titleLevel = 3, motion }: WebsiteLatestPostsProps): ReactNode {
2654
+ const { entries } = useWebsiteBlogIndex();
2655
+ const label = useWebsiteSectionLabels();
2656
+ const hover = resolveBlockMotion(WebsiteLatestPostsMotionPoint.POST, POSTS_MOTION, motion);
2657
+ const shown = limit === undefined ? entries : entries.slice(0, limit);
2658
+ return (
2659
+ <div data-website-block="latest-posts">
2660
+ <ul data-website-part="posts" {...blockMotionAttributes(WebsiteLatestPostsMotionPoint.POSTS, POSTS_MOTION, motion)}>
2661
+ {shown.map((entry) => (
2662
+ <PostCard key={entry.slug} entry={entry} titleLevel={titleLevel} hover={hover} />
2663
+ ))}
2664
+ </ul>
2665
+ {allPosts !== undefined && (
2666
+ <p data-website-part="link">
2667
+ <WebsiteArrowLink link={allPosts}>{label('all')}</WebsiteArrowLink>
2668
+ </p>
2669
+ )}
2670
+ </div>
2671
+ );
2672
+ }
2673
+ WebsiteLatestPosts.displayName = 'WebsiteLatestPosts';
2674
+ ```
2675
+
2676
+ ## Product tour
2677
+
2678
+ ## Import Origins
2679
+
2680
+ - `@wildo-ai/saas-website`
2681
+
2682
+ ## Source Excerpts
2683
+
2684
+ ### Origin Package: `@wildo-ai/saas-website`
2685
+
2686
+ ```tsx
2687
+ *
2688
+ * `WebsiteProductTour`: the product in tabs (PRODUCT_SHOWCASE), one drawn screen per tab beside its title and one
2689
+ * paragraph (#2742). Each tab has its label, a title and a body by slot (`<ref>.tab`, `<ref>.title`, `<ref>.body`) and
2690
+ * its `screen`, drawn by the site with its own words (declare its slots beside the tour's); the tab list is named by
2691
+ * `tabs-label`. `websiteProductTourSlots(tabs)`.
2692
+ *
2693
+ * It follows the WAI-ARIA tabs pattern: a `tablist` of real buttons, the arrow keys, Home and End move between them,
2694
+ * one `tabpanel` labelled by its tab. The drawn screen is hidden from assistive technology, which reads the panel's
2695
+ * title and body instead.
2696
+ *
2697
+ * It ROTATES on its own, one tab every `WEBSITE_PRODUCT_TOUR_DWELL_MS` (7 s, with a countdown line under the tab), and
2698
+ * stops as an auto-rotating carousel must: for good once keyboard focus enters the tabs or the visitor picks a tab,
2699
+ * and for as long as the pointer is over it. The tour sits in a `WebsiteMotionDemoGroup`, so its pause control (slots
2700
+ * `pause`, `play`), the off-screen pause, reduced motion and a STILL site hold the rotation and every screen.
2701
+ *
2702
+ * spec-cite: WAI-ARIA APG, Carousel pattern, "About This Pattern" — https://www.w3.org/WAI/ARIA/apg/patterns/carousel/
2703
+ * (fetched 2026-10-06): rotation "Stops rotating when keyboard focus enters the carousel. It does not restart unless
2704
+ * the user explicitly requests it to do so." and "Stops rotating whenever the mouse is hovering over the carousel."
2705
+ *
2706
+ * Hooks: `data-website-block="product-tour"`, the parts `tabs`, `tab`, `progress` (`data-website-running` while it
2707
+ * counts down), `panel`, `copy`, `title`, `body`, `screen-frame`, `screen`.
2708
+ */
2709
+ export interface WebsiteProductTourTab {
2710
+ readonly ref: string;
2711
+ /** The tab's drawn screen. */
2712
+ readonly screen: ReactNode;
2713
+ }
2714
+
2715
+ export function websiteProductTourSlots(tabs: readonly WebsiteProductTourTab[] | readonly string[]): string[] {
2716
+ return [
2717
+ 'tabs-label',
2718
+ 'pause',
2719
+ 'play',
2720
+ ...tabs.map((tab) => (typeof tab === 'string' ? tab : tab.ref)).flatMap((ref) => [`${ref}.tab`, `${ref}.title`, `${ref}.body`]),
2721
+ ];
2722
+ }
2723
+
2724
+ export interface WebsiteProductTourProps {
2725
+ readonly tabs: readonly WebsiteProductTourTab[];
2726
+ readonly titleLevel?: WebsiteHeadingLevel;
2727
+ }
2728
+
2729
+ /**
2730
+ * Advances the tour while the group plays. Rendered INSIDE the group so it reads the playback flag the pause control,
2731
+ * the off-screen pause and reduced motion feed; renders nothing.
2732
+ */
2733
+ function TourClock({ active, rotating, dwell, onAdvance }: { active: number; rotating: boolean; dwell: number; onAdvance: () => void }): null {
2734
+ const playing = useWebsiteMotionDemoPlaying();
2735
+ useEffect(() => {
2736
+ if (!playing || !rotating) return undefined;
2737
+ const timer = setTimeout(onAdvance, dwell);
2738
+ return () => clearTimeout(timer);
2739
+ }, [playing, rotating, active, dwell, onAdvance]);
2740
+ return null;
2741
+ }
2742
+
2743
+ /** The line under the active tab, counting down to the next one. It runs only while the tour rotates and plays. */
2744
+ function TourProgress({ rotating }: { rotating: boolean }): ReactNode {
2745
+ const playing = useWebsiteMotionDemoPlaying();
2746
+ return <span data-website-part="progress" aria-hidden="true" {...(rotating && playing ? { 'data-website-running': '' } : {})} />;
2747
+ }
2748
+
2749
+ export function WebsiteProductTour({ tabs, titleLevel = 3 }: WebsiteProductTourProps): ReactNode {
2750
+ const label = useWebsiteSectionLabels();
2751
+ const [active, setActive] = useState(0);
2752
+ const [rotating, setRotating] = useState(true);
2753
+ const [hovered, setHovered] = useState(false);
2754
+ const tabRefs = useRef<Array<HTMLButtonElement | null>>([]);
2755
+ const baseId = useId();
2756
+ const advance = useCallback(() => setActive((current) => (current + 1) % tabs.length), [tabs.length]);
2757
+ const choose = (index: number): void => {
2758
+ setRotating(false);
2759
+ setActive(index);
2760
+ };
2761
+ const onKeyDown = (event: KeyboardEvent<HTMLDivElement>): void => {
2762
+ const delta = event.key === 'ArrowRight' ? 1 : event.key === 'ArrowLeft' ? -1 : 0;
2763
+ if (delta === 0 && event.key !== 'Home' && event.key !== 'End') return;
2764
+ event.preventDefault();
2765
+ const next = event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : (active + delta + tabs.length) % tabs.length;
2766
+ choose(next);
2767
+ tabRefs.current[next]?.focus();
2768
+ };
2769
+ const current = tabs[active] ?? tabs[0];
2770
+ if (current === undefined) return null;
2771
+ // One tab has nothing to rotate to: no clock, no countdown, no entrance replayed every dwell.
2772
+ const turning = rotating && !hovered && tabs.length > 1;
2773
+ const hover = { onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false) };
2774
+ return (
2775
+ <div data-website-block="product-tour">
2776
+ <WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
2777
+ <TourClock active={active} rotating={turning} dwell={WEBSITE_PRODUCT_TOUR_DWELL_MS} onAdvance={advance} />
2778
+ <div role="tablist" aria-label={label('tabs-label')} data-website-part="tabs" onKeyDown={onKeyDown} onFocus={() => setRotating(false)} {...hover}>
2779
+ {tabs.map((tab, index) => (
2780
+ <button
2781
+ key={tab.ref}
2782
+ ref={(element) => {
2783
+ tabRefs.current[index] = element;
2784
+ }}
2785
+ type="button"
2786
+ role="tab"
2787
+ id={`${baseId}-tab-${index}`}
2788
+ aria-selected={index === active}
2789
+ aria-controls={`${baseId}-panel`}
2790
+ tabIndex={index === active ? 0 : -1}
2791
+ data-website-part="tab"
2792
+ onClick={() => choose(index)}
2793
+ >
2794
+ {label(`${tab.ref}.tab`)}
2795
+ {index === active && <TourProgress rotating={turning} />}
2796
+ </button>
2797
+ ))}
2798
+ </div>
2799
+ {/*
2800
+ The panel stays mounted, so a screen reader reading it keeps its place; its content is re-keyed so the
2801
+ entrance plays for each tab. It announces a new tab only once the visitor has stopped the rotation (APG
2802
+ carousel: live region off while rotating), and it is focusable because it holds nothing focusable (APG tabs).
2803
+ */}
2804
+ <div
2805
+ role="tabpanel"
2806
+ id={`${baseId}-panel`}
2807
+ aria-labelledby={`${baseId}-tab-${active}`}
2808
+ aria-live={turning ? 'off' : 'polite'}
2809
+ tabIndex={0}
2810
+ data-website-part="panel"
2811
+ onFocus={() => setRotating(false)}
2812
+ {...hover}
2813
+ >
2814
+ <div key={`${current.ref}-copy`} data-website-part="copy">
2815
+ <WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
2816
+ {label(`${current.ref}.title`)}
2817
+ </WebsiteHeading>
2818
+ <p data-website-part="body">{label(`${current.ref}.body`)}</p>
2819
+ </div>
2820
+ {/* The entrance plays on this plain frame, never on the stage: the pause control holds every animation in a
2821
+ stage, so a stage re-keyed while paused would hold its entrance at the first frame, invisible. */}
2822
+ <div key={`${current.ref}-screen`} data-website-part="screen-frame">
2823
+ <WebsiteMotionDemoStage>
2824
+ <div data-website-part="screen">{current.screen}</div>
2825
+ </WebsiteMotionDemoStage>
2826
+ </div>
2827
+ </div>
2828
+ </WebsiteMotionDemoGroup>
2829
+ </div>
2830
+ );
2831
+ }
2832
+ WebsiteProductTour.displayName = 'WebsiteProductTour';
2833
+ ```
2834
+
2835
+ ## Bento
2836
+
2837
+ ## Import Origins
2838
+
2839
+ - `@wildo-ai/saas-website`
2840
+
2841
+ ## Source Excerpts
2842
+
2843
+ ### Origin Package: `@wildo-ai/saas-website`
2844
+
2845
+ ```tsx
2846
+ *
2847
+ * `WebsiteBento`: capabilities as a bento grid (FEATURE_BENEFIT_SUMMARY), each tile a small drawing of the capability
2848
+ * above its title and one line (#2742). A tile has a title and a body by slot (`<ref>.title`, `<ref>.body`;
2849
+ * `websiteBentoSlots(tiles)`), and its `visual`: a drawing, usually a short loop, that the site draws with its own
2850
+ * words (declare its slots beside the bento's). A tile is a third of the row (REGULAR) or half of it (WIDE): two WIDE
2851
+ * tiles make a row, three REGULAR ones another. Every visual sits in one `WebsiteMotionDemoGroup`, so the bento has
2852
+ * ONE pause control (slots `pause`, `play`), stops off screen and stays still under reduced motion or a STILL site;
2853
+ * a visual is hidden from assistive technology, because the tile's words say what it shows.
2854
+ *
2855
+ * A tile is a `WebsiteCard` with media, so a site that has styled its media cards has styled its bento. Hooks:
2856
+ * `data-website-block="bento"`, the part `tiles`, `data-website-size` on each tile.
2857
+ */
2858
+ export enum WebsiteBentoMotionPoint {
2859
+ /** The tiles arrive one after another, growing in. */
2860
+ TILES = 'tiles',
2861
+ }
2862
+
2863
+ const BENTO_MOTION = defineBlockMotionPoints<WebsiteBentoMotionPoint>({
2864
+ [WebsiteBentoMotionPoint.TILES]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.SCALE } },
2865
+ });
2866
+
2867
+ /** One tile: its slot prefix, its drawing, and how much of the row it takes. */
2868
+ export interface WebsiteBentoTile {
2869
+ readonly ref: string;
2870
+ readonly visual: ReactNode;
2871
+ readonly size?: WebsiteBentoTileSize;
2872
+ }
2873
+
2874
+ export function websiteBentoSlots(tiles: readonly WebsiteBentoTile[] | readonly string[]): string[] {
2875
+ return ['pause', 'play', ...tiles.map((tile) => (typeof tile === 'string' ? tile : tile.ref)).flatMap((ref) => [`${ref}.title`, `${ref}.body`])];
2876
+ }
2877
+
2878
+ export interface WebsiteBentoProps {
2879
+ readonly tiles: readonly WebsiteBentoTile[];
2880
+ readonly titleLevel?: WebsiteHeadingLevel;
2881
+ readonly motion?: WebsiteBlockMotion<WebsiteBentoMotionPoint>;
2882
+ }
2883
+
2884
+ export function WebsiteBento({ tiles, titleLevel = 3, motion }: WebsiteBentoProps): ReactNode {
2885
+ const label = useWebsiteSectionLabels();
2886
+ return (
2887
+ <div data-website-block="bento">
2888
+ <WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
2889
+ <ul data-website-part="tiles" {...blockMotionAttributes(WebsiteBentoMotionPoint.TILES, BENTO_MOTION, motion)}>
2890
+ {tiles.map((tile) => (
2891
+ <WebsiteCard key={tile.ref} size={tile.size ?? WebsiteBentoTileSize.REGULAR} media={<WebsiteMotionDemoStage>{tile.visual}</WebsiteMotionDemoStage>}>
2892
+ <WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
2893
+ {label(`${tile.ref}.title`)}
2894
+ </WebsiteHeading>
2895
+ <span data-website-part="body">{label(`${tile.ref}.body`)}</span>
2896
+ </WebsiteCard>
2897
+ ))}
2898
+ </ul>
2899
+ </WebsiteMotionDemoGroup>
2900
+ </div>
2901
+ );
2902
+ }
2903
+ WebsiteBento.displayName = 'WebsiteBento';
2904
+ ```
2905
+
2906
+ ## Marquee
2907
+
2908
+ ## Import Origins
2909
+
2910
+ - `@wildo-ai/saas-website`
2911
+
2912
+ ## Source Excerpts
2913
+
2914
+ ### Origin Package: `@wildo-ai/saas-website`
2915
+
2916
+ ```tsx
2917
+ *
2918
+ * `WebsiteMarquee`: a list that scrolls past, slowly and for ever: the integrations, the tools a product works with
2919
+ * (INTEGRATIONS, SOCIAL_PROOF strips) (#2742). Each item has its word by slot (`<ref>.text`) and may carry an `icon`;
2920
+ * an optional line above says what the list is (`label`). `websiteMarqueeSlots(items, { label })`.
2921
+ *
2922
+ * What a reader and a screen reader get is the PLAIN list: a visually hidden `<ul>` of the words, in order. The moving
2923
+ * copy is drawn twice for a seamless loop inside a `WebsiteMotionDemoStage`, hidden from assistive technology, under
2924
+ * one pause control (slots `pause`, `play`) that the visitor, the off-screen pause, reduced motion and a STILL site all
2925
+ * govern: still, the strip shows its first items, unmoving.
2926
+ *
2927
+ * One copy of the list scrolls past in `WEBSITE_MARQUEE_LOOP_SECONDS` (38 s), so a long list moves faster: past a
2928
+ * dozen items, the strip reads better as two. Hooks: `data-website-block="marquee"`, the parts `label`, `track`, `item`, `icon`.
2929
+ */
2930
+ export interface WebsiteMarqueeItem {
2931
+ readonly ref: string;
2932
+ readonly icon?: ReactNode;
2933
+ }
2934
+
2935
+ export interface WebsiteMarqueeSlotOptions {
2936
+ /** A line above the strip saying what the list is (`label`). Default true. */
2937
+ readonly label?: boolean;
2938
+ }
2939
+
2940
+ export function websiteMarqueeSlots(items: readonly WebsiteMarqueeItem[] | readonly string[], { label = true }: WebsiteMarqueeSlotOptions = {}): string[] {
2941
+ return [...(label ? ['label'] : []), 'pause', 'play', ...items.map((item) => `${typeof item === 'string' ? item : item.ref}.text`)];
2942
+ }
2943
+
2944
+ export interface WebsiteMarqueeProps extends WebsiteMarqueeSlotOptions {
2945
+ readonly items: readonly WebsiteMarqueeItem[];
2946
+ }
2947
+
2948
+ function MarqueeItem({ item }: { item: WebsiteMarqueeItem }): ReactNode {
2949
+ const label = useWebsiteSectionLabels();
2950
+ return (
2951
+ <span data-website-part="item">
2952
+ {item.icon !== undefined && <span data-website-part="icon">{item.icon}</span>}
2953
+ {label(`${item.ref}.text`)}
2954
+ </span>
2955
+ );
2956
+ }
2957
+
2958
+ export function WebsiteMarquee({ items, label: showLabel = true }: WebsiteMarqueeProps): ReactNode {
2959
+ const label = useWebsiteSectionLabels();
2960
+ return (
2961
+ <div data-website-block="marquee">
2962
+ <WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
2963
+ {showLabel && <p data-website-part="label">{label('label')}</p>}
2964
+ <ul data-website-visually-hidden="">
2965
+ {items.map((item) => (
2966
+ <li key={item.ref}>{label(`${item.ref}.text`)}</li>
2967
+ ))}
2968
+ </ul>
2969
+ <WebsiteMotionDemoStage>
2970
+ <div data-website-part="track">
2971
+ {[...items, ...items].map((item, index) => (
2972
+ <MarqueeItem key={`${item.ref}-${index < items.length ? 'a' : 'b'}`} item={item} />
2973
+ ))}
2974
+ </div>
2975
+ </WebsiteMotionDemoStage>
2976
+ </WebsiteMotionDemoGroup>
2977
+ </div>
2978
+ );
2979
+ }
2980
+ WebsiteMarquee.displayName = 'WebsiteMarquee';
2981
+ ```
2982
+
2983
+ ## The stylesheet and its hooks
2984
+
2985
+ ## Import Origins
2986
+
2987
+ - `@wildo-ai/saas-website`
2988
+
2989
+ ## Source Excerpts
2990
+
2991
+ ### Origin Package: `@wildo-ai/saas-website`
2992
+
2993
+ ```typescript
2994
+ *
2995
+ * The engine's building blocks, styled from the theme (#2742).
2996
+ *
2997
+ * Every rule reads the site's tokens: the CURRENT tone for colour (`--website-tone-*`, which `data-website-tone`
2998
+ * re-binds on a band), the type roles, the space and rhythm scales, the radius roles, the elevation. So a site's look
2999
+ * is its `designTokens`, and a block is right on every band with no rule per band.
3000
+ *
3001
+ * It sits in the `wildo-website` cascade layer: a site's own stylesheet is unlayered and wins whatever its
3002
+ * specificity, so a site adjusts a block by writing an ordinary rule against its `data-website-*` hooks, never with
3003
+ * `!important` and never by forking the component. The page layout renders it once per page, before the content.
3004
+ *
3005
+ * The hooks a site's rule targets:
3006
+ *
3007
+ * | Hook | On | Values |
3008
+ * |---|---|---|
3009
+ * | `data-website-block` | a block's root | `band`, `intro`, `hero`, `feature-row`, `card-grid`, `cta`, `steps`, `stats`, `table`, `faq`, `solution-paths`, `quote-cards`, `roadmap`, `pricing`, `latest-posts`, `product-tour`, `bento`, `marquee` |
3010
+ * | `data-website-part` | a part inside a block | shared by every block: `inner`, `copy`, `visual`, `backdrop`, `decoration`, `headline`, `lede`, `note`, `heading`, `body`, `title`, `link`, `arrow-link`, `arrow`, `marker`; each block names its own (a plan's `amount`, a stat's `value`) in its own documentation |
3011
+ * | `data-website-tone` | a band | `default`, `tinted`, `inverse`, `brand` |
3012
+ * | `data-website-layout` | a hero, a feature row, steps, an FAQ, a table, pricing | `stage`, `split`, `compact`; `visual-end`, `visual-start`; `row`, `stack`; `side`, `stacked`; `comparison`, `facts`; `teaser`, `plans` |
3013
+ * | `data-website-band-spacing`, `data-website-band-role` | a band | `default`, `compact`, `strip`; `cta` |
3014
+ * | `data-website-hero-surface` | a hero | `plain`, `glow`, `glow-grid` |
3015
+ * | `data-website-align`, `data-website-columns` | an intro; a card grid, stats, the plans | `start`, `center`; `2`, `3`, `4`, `auto` |
3016
+ * | `data-website-horizon`, `data-website-available` | a roadmap phase; an item that works today | `now`, `next`, `later` |
3017
+ * | `data-website-recommended`, `data-website-availability` | a plan | the catalogue's `available`, `upcoming` |
3018
+ * | `data-website-size` | a card in a bento | `regular`, `wide` |
3019
+ * | `data-website-running` | a product tour's countdown line | present while the tour rotates and plays |
3020
+ * | `--website-card-padding` | a card (`data-website-card`) | a length: the card's padding, which a linked card's link and a media card's copy take too; set it on a block or a card to pad its cards differently |
3021
+ * | `data-website-blog-post-slug`, `data-website-blog-post-cover`, `-summary`, `-meta`, `-author`, `-tags` | a blog post's `<article>` and its opening | the post's slug; present |
3022
+ * | `data-website-visually-hidden` | any element | present: read by assistive technology, not drawn (a table's caption, a roadmap item's status) |
3023
+ * | `data-website-shell`, `data-website-eyebrow`, `data-website-actions`, `data-website-card`, `data-website-point-list`, `data-website-point`, `data-website-icon-tile`, `data-website-icon-tile-style`, `data-website-count-up` | the shared parts | the eyebrow: `plain`, `pill`; the card: `media` for a card led by a drawing; the icon tile: `sm`, `md`, `lg`, and `wash` or `solid` |
3024
+ *
3025
+ * A site's media queries use the two widths below, so its own layouts stack where the blocks do.
3026
+ *
3027
+ * The base rules a page gets before any block: box sizing, the page's background, text colour, font and leading, links
3028
+ * drawn without an underline (a block's links are links by their shape; running text inside `data-website-prose`
3029
+ * keeps its underline), the selection and the focus ring in the tone's primary.
3030
+ *
3031
+ * What is NOT a token, and why: the button size ramp (`sm` / `md` / `lg` heights and paddings) and the icon glyph boxes
3032
+ * (1rem in a 1.75rem tile, a 2.5rem tile) are control geometry, fixed so a hit target and a glyph stay legible whatever
3033
+ * the density; the eyebrow pill's padding and dot are optical, set against the overline's size; the primary button's
3034
+ * top highlight and hover darkening are drawn relative to the action colour; the hero's glow and grid sizes are
3035
+ * decoration. The content blocks add: the step number's disc (2rem), the roadmap and plan markers (1rem, 1.05rem) and
3036
+ * the plan badge's lift above its card, control geometry like the glyph boxes; the heights of drawings (a step's
3037
+ * visual, 10rem; a post's drawn cover, 9rem) and the cover's link-preview ratio, decoration; the comparison table's
3038
+ * width before it scrolls sideways (44rem) and the stacked plans' width (30rem), layout limits chosen so a cell or a
3039
+ * card stays readable; the focus ring's 2px, the same on every control so it is always seen. The animated blocks
3040
+ * add: a bento drawing's 13rem floor (a row of tiles lines up whatever each drawing measures), the marquee's fade at
3041
+ * 10% of each end (an item arrives and leaves rather than being cut), the tour's 0.7 / 1.3 split of copy and screen
3042
+ * (the screen is the point), and the countdown line at two edge widths. Where a block varies a
3043
+ * token rather than replacing it (a plan's padding at 7/6 of the card padding, a tag's at 13/15 of `md`), the value
3044
+ * follows the theme's density. Everything a site's personality is meant to change (corners, gaps, colours, type) is
3045
+ * a token.
3046
+ */
3047
+ /** The widths a stacked layout starts at: below `stack` a split stacks, below `single` a grid has one column. */
3048
+ export const WEBSITE_BLOCKS_STACK_MAX_WIDTH = '1024px';
3049
+ export const WEBSITE_BLOCKS_SINGLE_COLUMN_MAX_WIDTH = '760px';
3050
+ ```