@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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: website-section-feature-detail
3
- description: Author a Feature Detail section (split-content with image/copy, alternating image-left/right) using `defineWebsiteSection({ category: WebsiteSectionCategory.FEATURE_DETAIL, … })`. Use when the user says "add a deep-dive feature section", "compose alternating image+copy bands", "build a feature spotlight", or "deep-dive a single feature with screenshot".
3
+ description: Author a Feature Detail section — one capability argued beside its screenshot or drawn demo, rows alternating visual-left / visual-right — by configuring the engine's `websiteFeatureRowBlock` (`websiteFeatureRowBlock.section({ category: WebsiteSectionCategory.FEATURE_DETAIL, band, config })`), its words derived from the config; a capability's facts in rows configure `websiteFactTableBlock`. Use when the user says "add a deep-dive feature section", "compose alternating image+copy bands", "build a feature spotlight", or "deep-dive a single feature with screenshot".
4
4
  user-invocable: false
5
5
  ---
6
6
 
@@ -20,15 +20,16 @@ Read and apply these patterns from the application-developer point of view:
20
20
 
21
21
  # Website Section — Authoring API (source-backed)
22
22
 
23
- Shared API excerpts for every `website_section_<category>` skill. The
23
+ Shared API excerpts for every `website-section-<category>` skill. The
24
24
  contract is identical across categories; the per-category guidance lives
25
25
  in each skill's own `SKILL.md`.
26
26
 
27
27
  ## Category vocabulary (closed enum)
28
28
 
29
- The `category` field on `defineWebsiteSection` is a closed enum, not a
30
- free string. Adding a new value requires seeding a matching
31
- `website_section_<value>` skill folder (1:1 invariant).
29
+ The `category` of a section (`category` in `block.section(...)`) is a closed enum, not a
30
+ free string. Adding a new value requires a matching
31
+ `website-section-<value>` skill (`RAW` is covered by
32
+ `website-factory-advanced`).
32
33
 
33
34
  ## Import Origins
34
35
 
@@ -68,8 +69,9 @@ free string. Adding a new value requires seeding a matching
68
69
  * (`website-factory-advanced` skill) which bypasses the category
69
70
  * vocabulary entirely.
70
71
  *
71
- * **Adding a value**: requires (a) a new entry here and (b) a matching
72
- * `website_section_<value>` skill stub. Removing a value
72
+ * **Adding a value**: requires (a) a new entry here, (b) the matching member of
73
+ * the website plan's `WebsiteSectionKind`, and (c) its `website-section-<value>`
74
+ * skill, which `WEBSITE_SECTION_SKILL_REF` must name or the plan does not compile. Removing a value
73
75
  * is a labelled rename — every consumer's
74
76
  * `defineWebsiteSection({ category: … })` declaration breaks at compile
75
77
  * time, which is the desired loud failure.
@@ -84,6 +86,24 @@ export enum WebsiteSectionCategory {
84
86
  SOCIAL_PROOF = 'social-proof',
85
87
  FAQ = 'faq',
86
88
  FOOTER_CTA = 'footer-cta',
89
+ /** The problem the audience lives with, before any product appears (a solution page's opening argument). */
90
+ PROBLEM = 'problem',
91
+ /** How it works, in three or four steps. */
92
+ HOW_IT_WORKS = 'how-it-works',
93
+ /** The product itself, shown: its real interface framed, a bento of key screens, or tabs across its views. */
94
+ PRODUCT_SHOWCASE = 'product-showcase',
95
+ /** One card per audience, each linking to the solution page written for it. */
96
+ SOLUTION_PATHS = 'solution-paths',
97
+ /** The product against the alternatives, honestly. */
98
+ COMPARISON = 'comparison',
99
+ /** Facts about the product as figures, each one a value the application declares. */
100
+ STATS = 'stats',
101
+ /** The systems the product connects to, by name, each one a provider or protocol the application declares. */
102
+ INTEGRATIONS = 'integrations',
103
+ /** The newest posts of the site's blog, read from the posts' own frontmatter. */
104
+ LATEST_POSTS = 'latest-posts',
105
+ /** What has shipped and what is next, as the application's roadmap declares it. */
106
+ ROADMAP = 'roadmap',
87
107
  /**
88
108
  * Escape hatch for sections that don't fit any standard category
89
109
  * (third-party widgets, custom one-off marketing pieces). Authors should
@@ -105,8 +125,9 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
105
125
  The schema declares the **observable contract** the page-manifest
106
126
  registration, the label-pack validator, `renderPageStructuredData` and
107
127
  the structured-data audit depend on. The
108
- factory layer adds type-preserving generics on top so JSX usage keeps
109
- compile-time prop checking.
128
+ factory adds what the schema cannot express: `Component` takes no props
129
+ (the page mounts it as `<Component />`), so a component that requires
130
+ one is refused at compile time.
110
131
 
111
132
  ## Import Origins
112
133
 
@@ -119,28 +140,29 @@ compile-time prop checking.
119
140
  ```typescript
120
141
  *
121
142
  * `WebsiteSectionDefinition` — the runtime contract returned by the
122
- * `defineWebsiteSection({ … })` factory (authored as a separate
123
- * `core/define-website-section.tsx` module in Phase 2 because it carries
124
- * React types in its inputs). The shape is declared in `schemas/`
125
- * because it is the **observable contract** the page-manifest
143
+ * `defineWebsiteSection({ … })` factory (which lives apart from this
144
+ * schema because its input carries React types). The shape is declared
145
+ * with the schemas because it is the **observable contract** the page-manifest
126
146
  * registration, the label-pack validator, `renderPageStructuredData` and the
127
147
  * structured-data audit depend on.
128
148
  *
129
- * **Shape rationale** (each field carries semantic weight — see
130
- * `design-philosophy.mdc`):
149
+ * **Shape rationale** (each field carries semantic weight):
131
150
  *
132
- * - `sectionRef` — the section's identity inside its hosting page.
133
- * Uniqueness is enforced **per page** at manifest registration time
134
- * (a section can be reused with the same `sectionRef` across pages
135
- * when its label-key root is intentionally shared).
151
+ * - `sectionRef` — the section's identity across the SITE. The build
152
+ * collects every section by its ref (`collectExpectedLabelKeysFromSections`)
153
+ * and refuses two sections that share one with different label keys,
154
+ * which two pages' sections always have (each key is rooted at its own
155
+ * page). So a ref names its page when two pages would share one
156
+ * (`landing-hero`, `pricing-hero`); the manifest registry additionally
157
+ * refuses a ref listed twice on one page.
136
158
  * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
137
159
  * for skill-mapping and analytics labelling. It does NOT select the
138
160
  * section's structured data.
139
161
  * - `expectedLabelKeys` — the **fully-composed** label keys the section
140
- * commits to consuming. The plan originally proposed leaf-relative
141
- * keys (`'headline'`) resolved at runtime against the
142
- * page+section context, but storing the fully-composed key on the
143
- * definition has three concrete benefits:
162
+ * commits to consuming. Leaf-relative keys (`'headline'`) resolved at
163
+ * runtime against the page+section context would also work, but
164
+ * storing the fully-composed key on the definition has three concrete
165
+ * benefits:
144
166
  * 1. The label-pack validator (`validateLabelPackAgainstManifest`)
145
167
  * runs as a pure function with no need to walk the JSX tree at
146
168
  * build time to discover the leaf-to-key resolution.
@@ -163,15 +185,15 @@ compile-time prop checking.
163
185
  * valid HTML id that is also URL-fragment-safe: a letter, then
164
186
  * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
187
  * to keep, like the id attribute it becomes.
166
- * - `Component` — the React component that renders the section. Typed
167
- * as `ComponentType<unknown>` here because schema-layer cannot lock
168
- * the component's prop shape (props vary per section). The factory
169
- * function (`defineWebsiteSection<TProps>(…)`) preserves the precise
170
- * prop type at the consumer call site via generics; this schema only
171
- * guards the runtime shape of "is callable as a React component".
188
+ * - `Component` — the React component that renders the section. The
189
+ * page mounts it with NO props (`<WebsitePageSections>`), which the
190
+ * factory (`defineWebsiteSection`, `WebsiteSectionComponentProps`) enforces at
191
+ * compile time; this schema only guards the runtime shape of "is
192
+ * callable as a React component".
172
193
  * - `getStructuredData?` — optional pure function the SEO/AEO/GEO
173
- * builder library invokes at static-build time to materialize JSON-LD
174
- * for the section. The return type is intentionally `unknown` here;
194
+ * builder library invokes on the server to materialize JSON-LD for the
195
+ * section, handing it the page it renders on (`WebsiteStructuredDataContext`).
196
+ * The return type is intentionally `unknown` here;
175
197
  * nothing narrows it by `category` — the section returns whatever
176
198
  * vocabulary it emits, and `wildo website audit` reconciles that
177
199
  * against the application's Schema.org catalog.
@@ -202,25 +224,23 @@ export const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSch
202
224
  /**
203
225
  * Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and
204
226
  * `getStructuredData` are typed precisely on the factory return type
205
- * (`defineWebsiteSection<TProps>` in Phase 2); the schema-inferred
227
+ * (`defineWebsiteSection`); the schema-inferred
206
228
  * type is the lowest common denominator used at the persistence /
207
229
  * validation boundary only.
208
230
  *
209
231
  * **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:
210
232
  * React component props are CONTRAVARIANT in `ComponentType<T>` —
211
- * a narrower `ComponentType<{ foo: string }>` is NOT assignable to
212
- * `ComponentType<unknown>` (because a caller could pass an `unknown`
213
- * the narrower component cannot accept). This made every consumer
214
- * who built sections via `defineWebsiteSection<TProps>(…)` unable
215
- * to feed the resulting `TypedWebsiteSectionDefinition<TProps>` to
216
- * helpers typed against the bare `WebsiteSectionDefinition` —
217
- * collectors, validators, and registries. Using `any` here is the
218
- * exact escape hatch the React typings themselves use for
219
- * heterogeneous component containers (`React.forwardRef`,
220
- * `React.lazy`'s internal component slot, etc.) and matches the
221
- * runtime contract: the framework NEVER instantiates these
222
- * components directly with arbitrary props — the consumer's JSX
223
- * supplies the right props at the call site.
233
+ * the factory's `ComponentType<WebsiteSectionComponentProps>` is NOT
234
+ * assignable to `ComponentType<unknown>` (because a caller could pass
235
+ * an `unknown` the narrower component cannot accept). That would stop
236
+ * every `TypedWebsiteSectionDefinition` from reaching the helpers typed
237
+ * against the bare `WebsiteSectionDefinition` — collectors, validators,
238
+ * and registries. `any` is the escape hatch the React typings
239
+ * themselves use for heterogeneous component containers
240
+ * (`React.forwardRef`, `React.lazy`'s internal component slot, etc.).
241
+ * It widens nothing at runtime: the page mounts every section
242
+ * component as `<Component />`, with no props, and
243
+ * `defineWebsiteSection` refuses a component that requires one.
224
244
  */
225
245
  export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {
226
246
  Component: ComponentType<any>;
@@ -235,23 +255,76 @@ export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSection
235
255
  * optional fields per entity; locking them in TS would be both
236
256
  * impractical and brittle as Schema.org evolves). The companion
237
257
  * catalog reconciliation surface catches missing-required and
238
- * deprecated-field-used at the SEMANTIC layer (warning-only per
239
- * D-AG4), so the runtime type stays loose.
258
+ * deprecated-field-used at the SEMANTIC layer (warnings; failures
259
+ * under `wildo website audit --strict`), so the runtime type stays loose.
240
260
  *
241
261
  * Returns `null`, `undefined`, or `[]` when the section has no
242
262
  * structured-data contribution for the current state — the
243
263
  * renderer short-circuits all three.
264
+ *
265
+ * **The context** (`WebsiteStructuredDataContext`): the page's locale,
266
+ * refs, route and origin, and `label(slot)` — the section's own words
267
+ * in that locale. Structured data restates what the section shows, so a
268
+ * section with words (an FAQ, a product description) reads them here,
269
+ * once per locale and on the server only, rather than hard-coding one
270
+ * language or importing every locale's pack into the browser bundle. A
271
+ * function that declares no parameter is still accepted: a payload with
272
+ * no words (a site-wide `Organization` id) needs no context.
244
273
  */
245
- getStructuredData?: () => WebsiteStructuredDataReturn;
274
+ getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
246
275
  }
247
276
  ```
248
277
 
249
- ## `defineWebsiteSection<TProps>` factory
250
-
251
- Always use the factory — never build a `WebsiteSectionDefinition`
252
- literal by hand. The factory parses inputs through the schema (single
253
- audited validation chokepoint) AND preserves the caller's `TProps` so
254
- JSX composition stays strongly typed.
278
+ ## Structured data reads the section's words through its context
279
+
280
+ `getStructuredData` receives the page the section is published on, a
281
+ `WebsiteStructuredDataContext` (from `@wildo-ai/saas-website`), and runs
282
+ on the server only:
283
+
284
+ - `label(slot)` — the section's word for `slot` in the page's locale,
285
+ the key `useWebsiteLabel(slot)` reads in the component. It throws when
286
+ the locale's pack has no word, so a raw key is never published.
287
+ - `pageUrl` — the page's URL in this locale, for `url` and `@id`;
288
+ `siteOrigin` — the site's public origin, for site-wide `@id`s;
289
+ `locale` — for `inLanguage`.
290
+
291
+ A word the section shows reaches its JSON-LD only through `label(slot)`:
292
+ never typed into the payload (one language on every locale's page) and
293
+ never read from a label pack imported into the sections file (every
294
+ visitor downloads the pack). A payload with no words may keep
295
+ `() => …`. The route passes the context
296
+ (`renderPageStructuredData({ sections, context: runtime.structuredData })`),
297
+ and `wildo website audit` checks every route a page is published at, in
298
+ that route's locale, as the page renders it. The full contract is in the `website-seo-aeo-geo` skill.
299
+
300
+ ## How a section is defined: a configured block
301
+
302
+ When the section comes from the website plan, its `design` already names the block, its layout, its surface and what
303
+ its demo shows, and says whether it is the page's signature section. Build what it names; the guidance below is for
304
+ the fields the plan left open. When the section is built, look at it: `wildo website look <route> --all-locales`
305
+ photographs the page in every locale the site serves, at a desktop and a phone width, and runs an accessibility pass; judge the pictures against the
306
+ `website-building-blocks` skill's `references/website-visual-quality-rubric.md` and fix every violation it lists.
307
+
308
+ A section is almost always one of the engine's blocks, CONFIGURED:
309
+ `websiteHeroBlock.section({ pageRef, sectionRef, category, config })`,
310
+ `websiteCardGridBlock.section({ …, band, intro, config })`. The block
311
+ renders `config` (its props), and the section's words are derived from
312
+ the same `config`, so a section cannot declare a word it does not render.
313
+ `band` and `intro` are accepted only by the blocks that take them, and
314
+ `nodeSlots` declares the words a node inside the config reads (a drawing,
315
+ a form). A section no engine block covers is a block of the site's own,
316
+ `defineWebsiteBlock({ surface, heading, slots, Component })`, with the
317
+ same `.section(...)`. Pricing is the one exception: its words follow the
318
+ plans the catalogue publishes, so it is declared with
319
+ `defineWebsiteBlockSection` and `websitePricingSlots`. The
320
+ `website-building-blocks` skill lists every block and what each takes.
321
+
322
+ Underneath, every one of these calls the `defineWebsiteSection` factory
323
+ below. Never build a `WebsiteSectionDefinition` literal by hand: the
324
+ factory parses inputs through the schema (single audited validation
325
+ chokepoint) and types `Component` as taking NO props
326
+ (`WebsiteSectionComponentProps`), since the page mounts each section as
327
+ `<Component />`. A configured block binds its config for you.
255
328
 
256
329
  ## Import Origins
257
330
 
@@ -263,11 +336,18 @@ JSX composition stays strongly typed.
263
336
 
264
337
  ```typescript
265
338
  *
266
- * Input shape consumed by `defineWebsiteSection<TProps>`. Mirrors
267
- * `WebsiteSectionDefinition` but keeps `Component` typed against the
268
- * caller-supplied generic so the precise prop shape survives end-to-end
269
- * (the consumer's `<HeroSection />` JSX can keep its strongly-typed
270
- * props after going through the factory).
339
+ * The props a section component receives: NONE. A page renders its sections through
340
+ * `<WebsitePageSections>`, which mounts each one as `<Component />` — nothing composes a section with props. A
341
+ * component that requires one is therefore refused by `defineWebsiteSection` at compile time; before this type, it
342
+ * compiled and then read `undefined` on the live page. A section reads what it
343
+ * shows from its labels (`useWebsiteLabel`), the page runtime (`useWebsiteRuntime`) and module constants; a variant of
344
+ * a shared body or block is BOUND in the definition (`Component: () => <WebsiteHero layout={WebsiteHeroLayout.STAGE} visual={<ProductShot />} />`).
345
+ */
346
+ export type WebsiteSectionComponentProps = Record<string, never>;
347
+
348
+ /**
349
+ * Input shape consumed by `defineWebsiteSection`. Mirrors `WebsiteSectionDefinition`, with `Component` a component
350
+ * that takes no props (`WebsiteSectionComponentProps`): one that requires a prop is refused at compile time.
271
351
  *
272
352
  * **String inputs vs. branded inputs**: `sectionRef` and
273
353
  * `expectedLabelKeys` accept raw strings as well as already-branded
@@ -276,7 +356,7 @@ JSX composition stays strongly typed.
276
356
  * ergonomic drag of forcing every section author to remember to call
277
357
  * `WebsiteSectionRefSchema.parse(...)` in their definition.
278
358
  */
279
- export interface DefineWebsiteSectionInput<TProps> {
359
+ export interface DefineWebsiteSectionInput<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps> {
280
360
  sectionRef: WebsiteSectionRef | string;
281
361
  category: WebsiteSectionCategory;
282
362
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
@@ -286,32 +366,24 @@ export interface DefineWebsiteSectionInput<TProps> {
286
366
  /**
287
367
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
288
368
  * full authoring contract. The factory passes the function through
289
- * unchanged; the framework invokes it at static-build time and
290
- * forwards the return value to `renderPageStructuredData()`.
369
+ * unchanged; `renderPageStructuredData()` invokes it on the server with
370
+ * the page's `WebsiteStructuredDataContext`.
291
371
  */
292
- getStructuredData?: () => WebsiteStructuredDataReturn;
372
+ getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
293
373
  }
294
374
 
295
375
  /**
296
- * Return shape of `defineWebsiteSection<TProps>`. Identical to
297
- * `WebsiteSectionDefinition` except `Component` retains the
298
- * caller-supplied generic prop shape rather than the schema's
299
- * lowest-common-denominator `ComponentType<unknown>`.
300
- *
301
- * **Why this matters**: a consumer's `pageComponent` JSX composes
302
- * sections like `<HERO_SECTION.Component {...heroProps} />`. Without
303
- * preserving `TProps`, the spread would be untyped and a renamed prop
304
- * would silently miss the type system. With `TProps` preserved, the
305
- * call site fails to compile the moment the prop contract drifts.
376
+ * Return shape of `defineWebsiteSection`. Identical to `WebsiteSectionDefinition` except `Component` is typed as the
377
+ * prop-less component it is, rather than the schema's lowest-common-denominator `ComponentType<any>`.
306
378
  */
307
- export interface TypedWebsiteSectionDefinition<TProps>
379
+ export interface TypedWebsiteSectionDefinition<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>
308
380
  extends Omit<WebsiteSectionDefinition, 'Component' | 'getStructuredData'> {
309
381
  Component: ComponentType<TProps>;
310
- getStructuredData?: () => WebsiteStructuredDataReturn;
382
+ getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
311
383
  }
312
384
 
313
385
  /**
314
- * `defineWebsiteSection<TProps>` — factory that materializes a
386
+ * `defineWebsiteSection` — factory that materializes a
315
387
  * `WebsiteSectionDefinition` from authored input.
316
388
  *
317
389
  * **Two responsibilities**, one entry point:
@@ -319,9 +391,11 @@ export interface TypedWebsiteSectionDefinition<TProps>
319
391
  * `WebsiteSectionDefinitionSchema` so brand checks, regex
320
392
  * validations, and array refinements run at module load time
321
393
  * (not at render time, not at build-output time).
322
- * 2. Type preservation — returns an object whose `Component` field
323
- * keeps the caller-supplied `TProps`, so JSX usage of the
324
- * returned section retains compile-time prop checking.
394
+ * 2. The props contract — `Component` takes no props, because the
395
+ * page mounts it as `<Component />`. A component that requires a
396
+ * prop fails to compile here rather than reading `undefined` live.
397
+ * The type parameter exists so an explicit type argument equal to
398
+ * `WebsiteSectionComponentProps` stays valid; it cannot be widened.
325
399
  *
326
400
  * **Why a factory instead of constructing the literal directly**:
327
401
  * - Consumers don't have to remember to parse refs / keys
@@ -329,25 +403,22 @@ export interface TypedWebsiteSectionDefinition<TProps>
329
403
  * - The schema parse provides a single audited validation chokepoint,
330
404
  * and the parsed `expectedLabelKeys` are what `wildo website audit`
331
405
  * checks every locale pack against, without re-entering the React graph.
332
- * - The factory is the documented authoring API the
333
- * `website_factory_authoring` skill targets — keeping the
406
+ * - The factory is the documented authoring API every
407
+ * `website-section-*` skill teaches — keeping the
334
408
  * authoring surface narrow lets the framework evolve the
335
409
  * internal schema (add fields, refinements) without churning
336
410
  * every section definition in every consumer app.
337
411
  *
338
412
  * @param input section authoring input (see `DefineWebsiteSectionInput`).
339
- * @returns a `TypedWebsiteSectionDefinition<TProps>` with `Component`
340
- * preserved at the precise prop type.
413
+ * @returns a `TypedWebsiteSectionDefinition` whose `Component` takes no props.
341
414
  *
342
415
  * @example
343
- * interface HeroProps {
344
- * headlineKey: WebsiteLabelKey;
345
- * subheadlineKey: WebsiteLabelKey;
346
- * }
347
- * function HeroSection({ headlineKey, subheadlineKey }: HeroProps) {
416
+ * function HeroSection() {
417
+ * const headline = useWebsiteLabel('headline');
418
+ * const subheadline = useWebsiteLabel('subheadline');
348
419
  * // …
349
420
  * }
350
- * export const HERO_SECTION = defineWebsiteSection<HeroProps>({
421
+ * export const HERO_SECTION = defineWebsiteSection({
351
422
  * sectionRef: 'hero',
352
423
  * category: WebsiteSectionCategory.HERO,
353
424
  * expectedLabelKeys: [
@@ -357,7 +428,7 @@ export interface TypedWebsiteSectionDefinition<TProps>
357
428
  * Component: HeroSection,
358
429
  * });
359
430
  */
360
- export function defineWebsiteSection<TProps>(
431
+ export function defineWebsiteSection<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>(
361
432
  input: DefineWebsiteSectionInput<TProps>,
362
433
  ): TypedWebsiteSectionDefinition<TProps> {
363
434
  const parsed = WebsiteSectionDefinitionSchema.parse({
@@ -370,8 +441,8 @@ export function defineWebsiteSection<TProps>(
370
441
  });
371
442
  /**
372
443
  * Re-attach `Component` and `getStructuredData` from the original
373
- * input so the precise generic types survive — `parsed.Component`
374
- * is `unknown` per the schema's `z.unknown()` contract.
444
+ * input so they keep their declared types — `parsed.Component` is
445
+ * `unknown` per the schema's `z.unknown()` contract.
375
446
  */
376
447
  return {
377
448
  sectionRef: parsed.sectionRef,
@@ -388,9 +459,12 @@ export function defineWebsiteSection<TProps>(
388
459
 
389
460
  Inside the section's React component, always read labels via
390
461
  `useWebsiteLabel('<leaf>')`. The hook composes the leaf with the
391
- ambient page+section context to produce the fully-qualified
392
- `WebsiteLabelKey` and validates it against the section's
393
- `expectedLabelKeys` declaration.
462
+ ambient page+section context into the fully-qualified `WebsiteLabelKey`
463
+ and looks it up in the page's label pack; a missing word logs a warning
464
+ and renders the raw key. It does not consult `expectedLabelKeys`: the
465
+ build checks every locale pack against the keys the section DECLARES
466
+ there, so a key the component reads without declaring it is never
467
+ checked — declare every slot it reads.
394
468
 
395
469
  ## Import Origins
396
470
 
@@ -412,10 +486,12 @@ ambient page+section context to produce the fully-qualified
412
486
  * **Author ergonomics**: section authors call
413
487
  * `useWebsiteLabel('headline')` from inside their section component
414
488
  * without ever typing the page or section ref — the hook reads them
415
- * from context. This keeps section components portable across pages
416
- * (the same `<HeroSection />` can be reused on `landing` and on a
417
- * dedicated `/about` page; only the surrounding `<WebsiteSection
418
- * sectionRef="hero">` differs, and the label keys re-root accordingly).
489
+ * from the context the page layout and the surrounding `<WebsiteSection>`
490
+ * provide. The keys therefore follow the page a section renders on, while
491
+ * the section's declared `expectedLabelKeys` name one page: a section
492
+ * belongs to one page, and the website plan refuses a section ref
493
+ * declared on two. Share the BLOCK (a component reading slots) between
494
+ * pages, and give each page its own section around it.
419
495
  *
420
496
  * **Fail-loud diagnostics** for missing keys: returns the composed key
421
497
  * itself (visible in the rendered DOM as e.g. `website.landing.hero.headline`)
@@ -478,8 +554,8 @@ export function useWebsiteLabel(slotPath: string): string {
478
554
  The framework's `<WebsiteSection>` wrapper is what the page composition
479
555
  mounts to host a section's component. It provides
480
556
  `WebsiteSectionContext`, renders a semantic `<section>` with
481
- `data-section-ref` and `data-section-category`, and forwards a11y
482
- pass-throughs (`aria-labelledby`, `role`, etc.).
557
+ `data-section-ref` and `data-section-category`, and forwards the a11y
558
+ pass-throughs it declares (`ariaLabel`, `ariaLabelledBy`).
483
559
 
484
560
  ## Import Origins
485
561
 
@@ -505,10 +581,11 @@ pass-throughs (`aria-labelledby`, `role`, etc.).
505
581
  * sections without parsing className conventions. Optional
506
582
  * `id` prop wires up anchor-link navigation
507
583
  * (`<a href="#pricing">`).
508
- * 3. **Provides a styling seam** — `className` is forwarded to the
509
- * `<section>` element so designers can apply utility-class
510
- * decorations (background, padding, max-width container) without
511
- * having to compose multiple wrappers.
584
+ * 3. **Provides a styling seam** — the data attributes above are
585
+ * what a site's CSS styles a section by. `className` is forwarded
586
+ * to the `<section>` element only when a site renders
587
+ * `WebsiteSection` itself; `WebsitePageSections`, which wraps every
588
+ * section of a page, passes none.
512
589
  *
513
590
  * **Why NOT render a `<div>` instead of `<section>`**: marketing
514
591
  * pages benefit from semantic landmarks for SEO scoring and
@@ -517,13 +594,13 @@ pass-throughs (`aria-labelledby`, `role`, etc.).
517
594
  * a `<div>` with the same data-attribute carries the same metadata
518
595
  * but loses the landmark benefit.
519
596
  *
520
- * **Why expose `as` is NOT a prop**: switching the rendered tag
597
+ * **Why `as` is NOT a prop**: switching the rendered tag
521
598
  * (`<article>` for blog post bodies, `<aside>` for sidebar widgets)
522
- * is legitimate but rare enough to be worth a separate primitive
523
- * (Phase 4: `<WebsiteAside>`, `<WebsiteArticle>`). Keeping
524
- * `WebsiteSection` rendered as a literal `<section>` removes a
525
- * rarely-used prop from the section-author API and keeps the SEO
526
- * landmark contract guaranteed at the type level.
599
+ * is legitimate but rare; a section that needs one renders that
600
+ * element inside its body. Keeping `WebsiteSection` rendered as a
601
+ * literal `<section>` removes a rarely-used prop from the
602
+ * section-author API and keeps the SEO landmark contract guaranteed
603
+ * at the type level.
527
604
  */
528
605
  export interface WebsiteSectionProps {
529
606
  /**
@@ -550,21 +627,22 @@ export interface WebsiteSectionProps {
550
627
  */
551
628
  id?: string;
552
629
  /**
553
- * Optional className applied to the `<section>` element. Used by
554
- * designers for layout / spacing utilities. Section components
555
- * themselves should NOT pass className through to this wrapper —
556
- * keep the styling responsibility at the page-composition level.
630
+ * Optional className applied to the `<section>` element, for a site
631
+ * that renders `WebsiteSection` itself. `WebsitePageSections` passes
632
+ * none: a page's sections are styled through `[data-section-ref]` /
633
+ * `[data-section-category]`.
557
634
  */
558
635
  className?: string;
559
636
  /**
560
- * The section's body. Typically a single section component
561
- * (`<HeroSection {…heroProps} />`). May be plain JSX for one-off
562
- * sections that don't justify a `defineWebsiteSection` factory call.
637
+ * The section's body: the section's own component, which takes no
638
+ * props (`<HeroSection />`; see `WebsiteSectionComponentProps`). May be
639
+ * plain JSX for one-off sections that don't justify a
640
+ * `defineWebsiteSection` factory call.
563
641
  */
564
642
  children: ReactNode;
565
643
  /**
566
- * Pass-through `aria-*` / `role` attributes for sections that need
567
- * to refine their landmark semantics (eg. `aria-label="Featured
644
+ * Pass-through `aria-label` / `aria-labelledby` (the only two it
645
+ * forwards) for sections that need to refine their landmark semantics (eg. `aria-label="Featured
568
646
  * customer logos"` on a logo wall).
569
647
  */
570
648
  ariaLabel?: string;
@@ -619,22 +697,27 @@ WebsiteSection.displayName = 'WebsiteSection';
619
697
  ```
620
698
 
621
699
 
622
- > **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no concrete
623
- > Feature Detail component**. This skill documents the
624
- > `defineWebsiteSection<TProps>` authoring pattern for a deep-dive
625
- > single-feature spotlight: a split-content band with rich copy on one
626
- > side and a media (screenshot, animation, diagram) on the other, with
627
- > support for alternating image position across stacked instances.
700
+ > **Framework rule**: the installed `@wildo-ai/saas-website` package ships the feature row as a
701
+ > configurable block, `websiteFeatureRowBlock`: its renderer (`WebsiteFeatureRow`) puts the copy
702
+ > on one side (a heading, and optionally an eyebrow, a body, a list of points and a link) and the
703
+ > visual on the other, the side chosen by its `layout`, stacking on a narrow screen, with its
704
+ > reveal and its look read from the site's theme. A feature-detail section is
705
+ > `websiteFeatureRowBlock.section({ pageRef, sectionRef, category, band, config })`: the block
706
+ > stands on the section's band, renders the config, and the section's words are derived from that
707
+ > same config. This skill covers what a feature-detail section must SAY and CARRY — its category,
708
+ > its words, its (absent) structured data and its `llms.txt` contribution — and which
709
+ > configuration says it. How blocks are configured in general is `website-building-blocks`.
628
710
 
629
711
  ## Overview
630
712
 
631
713
  A Feature Detail section is the deep-dive complement to
632
714
  `website-section-feature-benefit-summary`. Each instance covers ONE
633
- feature in depth: title, paragraph-length explanation, optional
634
- checklist of bullet points, and a media asset. Stacking 2–4 of these
635
- on a "Features" page is the standard pattern; alternating
636
- image-left / image-right / image-left / image-right keeps the rhythm
637
- visually engaging.
715
+ feature in depth: a heading, a paragraph-length explanation, usually a
716
+ short list of points, and a visual (a screenshot or a drawn demo of the
717
+ product doing it). Stacking 2–4 of these on a "Features" page is the
718
+ standard pattern; alternating the visual's side from row to row
719
+ (`WebsiteFeatureRowLayout.VISUAL_END`, then `VISUAL_START`, …) keeps the
720
+ rhythm visually engaging.
638
721
 
639
722
  What the category does — and, for structured data, does not — decide:
640
723
 
@@ -650,13 +733,15 @@ What the category does — and, for structured data, does not — decide:
650
733
 
651
734
  | Surface | Glob (relative to app root) |
652
735
  |---|---|
653
- | Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
736
+ | The configured section (`websiteFeatureRowBlock.section(...)`), and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
737
+ | The site's feature-row config builder (its icon set, its link shape) and section factory | `website/src/sections/kit/**` |
654
738
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
655
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
739
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
740
+ | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
656
741
 
657
742
  ## When to Use
658
743
 
659
- - Spotlighting one feature per band with rich copy and a media asset.
744
+ - Spotlighting one feature per band with rich copy and a visual.
660
745
  - Stacking multiple feature-detail instances on a page (each gets
661
746
  its own `sectionRef`).
662
747
  - The feature warrants more than 1-2 sentences of explanation.
@@ -665,35 +750,114 @@ What the category does — and, for structured data, does not — decide:
665
750
 
666
751
  - A grid of 3–6 short benefits → `website-section-feature-benefit-summary`.
667
752
  - Pricing tier comparison → `website-section-pricing`.
668
- - Animated product demos that need scroll-watcher orchestration →
669
- `website-factory-advanced`.
753
+ - The product's interface shown as a framed screen, bento or tabs →
754
+ `website-section-product-showcase`; motion on a detail's screenshot
755
+ (unveil, zoom) is `website-motion-design`, not a reason to leave this skill.
756
+ - The row's colours, type or spacing → `website-theme-authoring`; the block reads them from the theme.
670
757
 
671
758
  ## Workflow
672
759
 
673
760
  ### Step 1: One section instance per feature
674
761
 
675
- Stacking three feature-detail bands means three `defineWebsiteSection`
676
- calls (or one helper that produces three definitions), each with a
677
- distinct `sectionRef` (e.g. `tasks`, `collaboration`, `automation`).
678
-
679
- ### Step 2: Variant-driven image placement
680
-
681
- Image position is a typed prop (`imagePosition: 'left' | 'right'`).
682
- The page composition decides the alternation; the section component
683
- just respects the prop.
684
-
685
- ### Step 3: Author label leaves
686
-
687
- Each instance's leaves: `title`, `description`, `bullet-1`, `bullet-2`,
688
- …, `image-alt`. Bullets are optional; declare only the leaves you
689
- actually consume.
762
+ Stacking three feature-detail rows means three configured sections
763
+ (or one section factory that produces them), each with a distinct `sectionRef`
764
+ named after its page and feature (`features-tasks`,
765
+ `features-collaboration`). One section holding several rows stamped out
766
+ with `.map(…)` is a summary, not a detail.
767
+
768
+ ### Step 2: Configure the row
769
+
770
+ The config is a `WebsiteFeatureRowProps`; the band around it is the section's:
771
+
772
+ | Choice | Where | Values |
773
+ |---|---|---|
774
+ | The surface this row sits on | `band.tone` | `WebsiteSurfaceTone.DEFAULT` · `TINTED` · `INVERSE` · `BRAND` |
775
+ | The side the visual sits on | config `layout` | `WebsiteFeatureRowLayout.VISUAL_END` (default) · `VISUAL_START` |
776
+ | Whether the copy opens with an eyebrow | config `eyebrow` | `true` (default) · `false` |
777
+ | Whether a paragraph follows the heading | config `body` | `true` (default) · `false` when the points carry the argument alone |
778
+ | The points the copy lists | config `points` | `{ ref, icon? }[]`, optional — none (or an empty list) renders no list; a check is drawn when a point has no icon |
779
+ | The page that argues it further | config `link` | a `WebsiteLinkTo`, usually `{ kind: WebsiteMenuLinkKind.PAGE, routePath }` |
780
+ | The visual | config `visual` | a React node: a `WebsiteImage` (Step 4) or a drawn demo (Step 5) |
781
+ | The heading's level | config `headingLevel` | 2 (default), or 3 for a row nested under another section's heading |
782
+
783
+ The row carries its own heading, so the section takes NO `intro` (the type refuses
784
+ one): an intro above it would make one section with two titles. It stands on a band,
785
+ so the section takes `band` (`tone`, `spacing`, `decoration`).
786
+
787
+ The alternation is decided where the instances are configured, in page order:
788
+ each section binds its own `layout`, and the block renders the side it is
789
+ given. The page renders each section with no props, so a page cannot hand a row
790
+ its layout, points or visual — every choice is in the section's `config`.
791
+ Two consecutive rows on the same tone read as one band (the second drops its top
792
+ padding); change the tone between them only when the page's rhythm asks for it.
793
+
794
+ ### Step 3: Let the words follow the config
795
+
796
+ The block derives the section's words from the config it renders (it runs
797
+ `websiteFeatureRowSlots(config)` for you): `eyebrow` (unless `eyebrow` is false),
798
+ `heading`, `body` (unless `body` is false), then `<ref>.title` and `<ref>.body`
799
+ for each point, and `link` when a link is given. Nothing is listed by hand: add a
800
+ point to the config and its words are declared; drop the link and its word goes.
801
+ The section derives the full `website.<page>.<section>.<slot>` keys and refuses a
802
+ slot declared twice.
803
+
804
+ The block does not know what its VISUAL reads. Declare those words as the
805
+ section's `nodeSlots`: the screenshot's `visual-alt`, or a drawn demo's frame
806
+ label, pause and play words and its screen's words, under the prefix the drawing
807
+ reads them by (`prefixedWebsiteSlots('demo', …)`).
808
+
809
+ ### Step 3b: A capability's facts in rows — `websiteFactTableBlock`
810
+
811
+ When the detail is a set of facts rather than an argument (limits, retention
812
+ periods, what each plan keeps), configure `websiteFactTableBlock.section({ …,
813
+ category: WebsiteSectionCategory.FEATURE_DETAIL, band, intro, config: { rows,
814
+ columns } })`. It takes the section `intro` (its heading names the table), and its
815
+ words follow from the config: `caption`, `<column>.name` per column, and
816
+ `<row>.<column>` per cell. The caption is read by assistive technology only unless
817
+ `showCaption` is set. A config builder in the site's kit can number the rows and
818
+ columns once (`row1`…, `column1`…), so a section passes only how many there are.
819
+
820
+ ### Step 4: A screenshot visual is a `WebsiteImage` with its size
821
+
822
+ Put in the config's `visual` a small component that renders `WebsiteImage` with
823
+ explicit `width` and `height` (so the page does not shift as it loads) and its
824
+ `alt` from the section's own `visual-alt` slot (`useWebsiteLabel('visual-alt')`),
825
+ declared as a `nodeSlots` word. The block's visual point carries its `SCALE`
826
+ reveal; nothing more is needed for motion.
827
+
828
+ ### Step 5: When the visual is a drawn demo, play it in the demo frame
829
+
830
+ A website plan often gives a feature row's visual as a DRAWN DEMO — the
831
+ product's own screen drawn with the kit's atoms, moving through one short
832
+ scenario — instead of a screenshot. Then the visual is not a
833
+ `WebsiteImage`: it is a `WebsiteMotionDemo` (its `label`, `pauseLabel`
834
+ and `playLabel` from the label pack, in place of `visual-alt`), whose
835
+ frame gives the visitor the pause control WCAG 2.2.2 requires, pauses it
836
+ off screen, and shows its finished last step under reduced motion. Its
837
+ words, and its screen's, are the section's `nodeSlots`. Draw
838
+ only what the application shows, write the scenario as data and play it with
839
+ `useWebsiteDemoScenario`: `website-section-product-showcase` Step 2a teaches
840
+ the drawing and the scenario, `website-motion-design` Step 6 the frame, and
841
+ `website-building-blocks`' `references/framework-website-demo-examples.md`
842
+ has a worked demo per archetype.
843
+
844
+ ### Step 6: Make it this site's own without forking the block
845
+
846
+ In this order: the theme (`website-theme-authoring`), the config of Step 2,
847
+ a config builder in the site's kit that fixes its icon set and link shape once,
848
+ and last an ordinary CSS rule on a hook (`[data-website-block='feature-row']
849
+ [data-website-part='visual']`). The block's CSS sits in the `wildo-website`
850
+ cascade layer, so an unlayered site rule wins without `!important`; read
851
+ colours from the current tone (`var(--website-tone-foreground)`). The block's
852
+ reveals (`COPY` rises, `VISUAL` scales) are adjusted through the config's `motion`,
853
+ keyed by `WebsiteFeatureRowMotionPoint`, or set to `null` to keep a point still.
690
854
 
691
855
  **Stop** after the feature-detail section renders and the
692
- label-pack audit covers every declared leaf; if a bullet is
693
- missing or the image lacks an alt, **return to Step 2** — the
694
- schema enforces `expectedLabelKeys` ⊇ rendered leaves at compile
695
- time (only declared leaves can be `useWebsiteLabel('<leaf>')`'d),
696
- NOT at runtime.
856
+ label-pack audit covers every declared slot; if a word of the visual shows its
857
+ key as text or the image lacks an alt, **return to Step 3** — the row's own words
858
+ follow its config, but a visual's words are declared only through `nodeSlots`,
859
+ and the build checks every locale's pack against the declared slots, NOT what is
860
+ rendered at runtime.
697
861
 
698
862
  ## Structured data (AEO)
699
863
 
@@ -723,93 +887,192 @@ for a page block in `website/src/content/llms.txt`.
723
887
 
724
888
  ## Worked Example
725
889
 
726
- <!-- TIER C WAIVER: This block IS the canonical Feature Detail contract — it shows BOTH the component shape (`imagePosition`/`imageSrc` typed-props pattern, `WebsiteImage` width+height intrinsic-size contract Verification check #5 protects, leaf-relative `useWebsiteLabel` for `title`/`description`/`bullet-N`/`image-alt`) AND the `defineFeatureDetail(sectionRef, pageRef)` helper that Verification check #1 names ("One `defineWebsiteSection` call per feature-detail instance (or a helper, as in the worked example)"). The three exported `*_FEATURE_DETAIL` definitions are the canonical "stack 3, alternate left/right at the page level" pattern Step 1 + Common Rationalization #3 reference. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
890
+ A site fixes its row choices once, in a config builder for the feature row: its
891
+ icon set for the points (a check unless a glyph is given), its link shape, and
892
+ `reverse` mapped to `WebsiteFeatureRowLayout.VISUAL_START`. It returns the row's
893
+ config, `WebsiteFeatureRowProps`:
894
+
895
+
896
+ ## Usage Example
897
+
898
+ ```tsx
899
+ /** The hero's actions: the application's sign-up, and a page of this site. */
900
+ const heroActions = (secondaryRoutePath: string) => ({
901
+ primaryAction: { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP } as const,
902
+ secondaryAction: { kind: WebsiteMenuLinkKind.PAGE, routePath: secondaryRoutePath } as const,
903
+ });
904
+
905
+ /** The brand's three forward-leaning stripes, the site's motif behind its hero and its closing call to action. */
906
+ function Stripes({ className }: { className: string }): ReactNode {
907
+ return (
908
+ <span className={className}>
909
+ <i />
910
+ <i />
911
+ <i />
912
+ </span>
913
+ );
914
+ }
915
+
916
+ /**
917
+ * A page's opening: the engine's hero with this site's choices, the glow-over-grid surface, the stripes motif, and
918
+ * the application's sign-up as the primary action. `WebsiteHeroLayout.STAGE` is the home page's product stage, `SPLIT`
919
+ * puts the visual beside the copy; without a visual the engine makes it a compact opening.
920
+ */
921
+ export function heroConfig({
922
+ secondaryRoutePath,
923
+ visual,
924
+ note = false,
925
+ layout = WebsiteHeroLayout.SPLIT,
926
+ }: {
927
+ secondaryRoutePath: string;
928
+ visual?: ReactNode;
929
+ note?: boolean;
930
+ layout?: WebsiteHeroLayout;
931
+ }): WebsiteHeroProps {
932
+ return {
933
+ layout,
934
+ surface: WebsiteHeroSurface.GLOW_GRID,
935
+ decoration: <Stripes className="brand-stripes" />,
936
+ note,
937
+ ...(visual === undefined ? {} : { visual }),
938
+ ...heroActions(secondaryRoutePath),
939
+ };
940
+ }
941
+ ```
942
+
943
+ ## Usage Example
944
+
945
+ ```tsx
946
+ /**
947
+ * The copy on one side — what it is, why it matters, its points — and the product doing it on the other. `reverse`
948
+ * swaps the sides, so consecutive rows zig-zag. Each point carries its glyph, a check unless one is given.
949
+ */
950
+ export function featureRowConfig({
951
+ visual,
952
+ bullets = 3,
953
+ icons,
954
+ linkRoutePath,
955
+ reverse = false,
956
+ }: {
957
+ visual: ReactNode;
958
+ bullets?: number;
959
+ icons?: readonly WtIcon[];
960
+ linkRoutePath?: string;
961
+ reverse?: boolean;
962
+ }): WebsiteFeatureRowProps {
963
+ return {
964
+ points: indexes(bullets).map((index) => ({ ref: `point${index}`, icon: <Icon name={icons?.[index - 1] ?? WtIcon.CHECK} /> })),
965
+ visual,
966
+ layout: reverse ? WebsiteFeatureRowLayout.VISUAL_START : WebsiteFeatureRowLayout.VISUAL_END,
967
+ ...(linkRoutePath === undefined ? {} : { link: { kind: WebsiteMenuLinkKind.PAGE, routePath: linkRoutePath } as const }),
968
+ };
969
+ }
970
+ ```
971
+
972
+ The framework's reference application then configures a row as a section: on the
973
+ inverse band, the config from that builder (four points, their glyphs, the page
974
+ that argues it, the visual a drawn demo in the site's demo frame), and the words
975
+ that drawing reads as `nodeSlots`. The row's own words are not listed: the block
976
+ derives them from the config.
977
+
978
+
979
+ ## Usage Example
980
+
981
+ ```tsx
982
+ // A section is an engine block, configured: the block renders the config, and the section's words are derived from
983
+ // the same config. The drawing inside the config reads words of its own, declared as `nodeSlots`.
984
+ const ASSISTANT_POINT_ICONS: readonly WtIcon[] = [WtIcon.APPROVE, WtIcon.SEARCH, WtIcon.CLOCK, WtIcon.PLUG];
985
+ const ASSISTANT_VISUAL: VisualSpec = { draw: (prefix) => <ApprovalLadder prefix={prefix} />, slots: approvalLadderSlots };
986
+
987
+ export const LANDING_ASSISTANT_SECTION = websiteFeatureRowBlock.section({
988
+ pageRef: PAGE_REF,
989
+ sectionRef: 'landing-assistant',
990
+ category: WebsiteSectionCategory.FEATURE_DETAIL,
991
+ band: { tone: WebsiteSurfaceTone.INVERSE },
992
+ config: featureRowConfig({ bullets: 4, icons: ASSISTANT_POINT_ICONS, linkRoutePath: '/product/assistant', visual: visualNode(ASSISTANT_VISUAL) }),
993
+ nodeSlots: visualSlots(ASSISTANT_VISUAL),
994
+ });
995
+ ```
996
+
997
+ Stacked rows that alternate sides, with a screenshot as the visual:
998
+
999
+ <!-- TIER C WAIVER: no anchored application usage shows the defining shape of this section kind — several feature-detail sections stacked in page order, each binding its own `WebsiteFeatureRowLayout` so the rows alternate, with a `WebsiteImage` screenshot whose `visual-alt` word the section declares as `nodeSlots`. The anchored usages above show one row with a drawn demo. Keep this inline until a stacked screenshot sequence is deliberately anchored. -->
727
1000
  ```tsx
728
1001
  // website/src/sections/<page>.sections.tsx
1002
+ import type { ReactNode } from 'react';
729
1003
  import {
730
- defineWebsiteSection,
731
1004
  useWebsiteLabel,
732
- WebsiteHeading,
1005
+ websiteFeatureRowBlock,
1006
+ WebsiteFeatureRowLayout,
733
1007
  WebsiteImage,
1008
+ WebsiteMenuLinkKind,
734
1009
  WebsiteSectionCategory,
735
- WebsiteText,
1010
+ type WebsiteFeaturePoint,
736
1011
  } from '@wildo-ai/saas-website';
737
1012
 
738
- interface FeatureDetailSectionProps {
739
- imagePosition: 'left' | 'right';
740
- imageSrc: string;
741
- imageWidth: number;
742
- imageHeight: number;
743
- }
744
-
745
- function FeatureDetailComponent({
746
- imagePosition,
747
- imageSrc,
748
- imageWidth,
749
- imageHeight,
750
- }: FeatureDetailSectionProps) {
751
- const title = useWebsiteLabel('title');
752
- const description = useWebsiteLabel('description');
753
- const bullet1 = useWebsiteLabel('bullet-1');
754
- const bullet2 = useWebsiteLabel('bullet-2');
755
- const bullet3 = useWebsiteLabel('bullet-3');
756
- const imageAlt = useWebsiteLabel('image-alt');
1013
+ import { BoltIcon, UsersIcon } from './icons';
757
1014
 
758
- return (
759
- <div data-image-position={imagePosition} className="feature-detail">
760
- <div className="feature-detail__copy">
761
- <WebsiteHeading level={2} variant="title">{title}</WebsiteHeading>
762
- <WebsiteText variant="lead">{description}</WebsiteText>
763
- <ul className="feature-detail__bullets">
764
- <li>{bullet1}</li>
765
- <li>{bullet2}</li>
766
- <li>{bullet3}</li>
767
- </ul>
768
- </div>
769
- <WebsiteImage
770
- src={imageSrc}
771
- alt={imageAlt}
772
- width={imageWidth}
773
- height={imageHeight}
774
- />
775
- </div>
776
- );
1015
+ function Screenshot({ src }: { src: string }): ReactNode {
1016
+ return <WebsiteImage src={src} alt={useWebsiteLabel('visual-alt')} width={1200} height={800} />;
777
1017
  }
778
1018
 
779
- /** Helper that produces one definition per feature-detail instance. */
780
- export function defineFeatureDetail(
781
- sectionRef: string,
782
- pageRef: string,
783
- ) {
784
- const root = `website.${pageRef}.${sectionRef}` as const;
785
- return defineWebsiteSection<FeatureDetailSectionProps>({
786
- sectionRef,
1019
+ /** One feature, one section: its points, its screenshot, the side the visual sits on, the page that argues it. */
1020
+ function featureDetail(instance: { sectionRef: string; layout: WebsiteFeatureRowLayout; points: readonly WebsiteFeaturePoint[]; src: string; routePath: string }) {
1021
+ return websiteFeatureRowBlock.section({
1022
+ pageRef: 'features',
1023
+ sectionRef: instance.sectionRef,
787
1024
  category: WebsiteSectionCategory.FEATURE_DETAIL,
788
- expectedLabelKeys: [
789
- `${root}.title`,
790
- `${root}.description`,
791
- `${root}.bullet-1`,
792
- `${root}.bullet-2`,
793
- `${root}.bullet-3`,
794
- `${root}.image-alt`,
795
- ],
796
- Component: FeatureDetailComponent,
1025
+ // The row declares eyebrow, heading, body, <ref>.title and <ref>.body per point, and link, from this config.
1026
+ config: {
1027
+ points: instance.points,
1028
+ layout: instance.layout,
1029
+ link: { kind: WebsiteMenuLinkKind.PAGE, routePath: instance.routePath },
1030
+ visual: <Screenshot src={instance.src} />,
1031
+ },
1032
+ // The screenshot reads its alt itself: the block does not know it.
1033
+ nodeSlots: ['visual-alt'],
797
1034
  });
798
1035
  }
799
1036
 
800
- export const TASKS_FEATURE_DETAIL = defineFeatureDetail('tasks', 'features');
801
- export const COLLABORATION_FEATURE_DETAIL = defineFeatureDetail('collaboration', 'features');
802
- export const AUTOMATION_FEATURE_DETAIL = defineFeatureDetail('automation', 'features');
1037
+ export const FEATURES_TASKS_SECTION = featureDetail({
1038
+ sectionRef: 'features-tasks',
1039
+ layout: WebsiteFeatureRowLayout.VISUAL_END,
1040
+ points: [{ ref: 'point1' }, { ref: 'point2' }, { ref: 'point3', icon: <BoltIcon aria-hidden="true" /> }],
1041
+ src: '/features/tasks.png',
1042
+ routePath: '/product/tasks',
1043
+ });
1044
+ export const FEATURES_COLLABORATION_SECTION = featureDetail({
1045
+ sectionRef: 'features-collaboration',
1046
+ layout: WebsiteFeatureRowLayout.VISUAL_START,
1047
+ points: [{ ref: 'point1', icon: <UsersIcon aria-hidden="true" /> }, { ref: 'point2' }],
1048
+ src: '/features/collaboration.png',
1049
+ routePath: '/product/collaboration',
1050
+ });
1051
+ export const FEATURES_AUTOMATION_SECTION = featureDetail({
1052
+ sectionRef: 'features-automation',
1053
+ layout: WebsiteFeatureRowLayout.VISUAL_END,
1054
+ // No points: the body argues it alone, and the row renders no list (and declares no point words).
1055
+ points: [],
1056
+ src: '/features/automation.png',
1057
+ routePath: '/product/automation',
1058
+ });
803
1059
  ```
804
1060
 
1061
+ The sections hold no layout CSS, no heading markup, no hand-written list and no
1062
+ list of their words: the row, its stacking on a narrow screen, its reveal and its
1063
+ words come from the block. A section given no `band` stands on the default one.
1064
+
805
1065
  ## Structured-data contract
806
1066
 
807
1067
  `FEATURE_DETAIL` does not own a dedicated JSON-LD vocabulary. The
808
- page may aggregate features via `SoftwareApplication.featureList` at
809
- the page-manifest level. Do NOT emit `Product` / `Offer` / `FAQPage`
1068
+ page may aggregate features via the `featureList` of the
1069
+ `SoftwareApplication` payload it publishes (from the section that owns
1070
+ the product claim). Do NOT emit `Product` / `Offer` / `FAQPage`
810
1071
  from this section; they belong to the sections that own them. Nothing
811
1072
  warns if you do — the audit checks each payload against the catalog,
812
- never against the section's category.
1073
+ never against the section's category. Configuring `websiteFeatureRowBlock`
1074
+ changes nothing here: the block renders the row, and the section still
1075
+ decides whether `getStructuredData` exists (`.section(...)` passes it through).
813
1076
 
814
1077
  Leave `getStructuredData` undefined unless the feature group rises
815
1078
  to the level of an `ItemList` (see "Catalog integration" below).
@@ -824,7 +1087,7 @@ discrete, ordered set of feature items the AI assistant should be
824
1087
  able to enumerate (e.g. "list every feature of Plan Pro").
825
1088
 
826
1089
  If your section meets that bar, the emission flows the standard way:
827
- the page-shell wires every section's `getStructuredData()` through
1090
+ the page-shell wires every section's `getStructuredData` through
828
1091
  the installed structured-data contract — but because `ItemList` is not in the
829
1092
  installed catalog yet, the companion
830
1093
  will emit a `catalog-miss` warning. The right resolution is to
@@ -839,90 +1102,135 @@ will emit a `catalog-miss` warning. The right resolution is to
839
1102
  **What earns its place in this section's emission**:
840
1103
 
841
1104
  - For a single feature row (the typical case) — nothing. Leave
842
- `getStructuredData` undefined; the feature is listed at the
843
- page-manifest level via `SoftwareApplication.featureList` (string
844
- array).
1105
+ `getStructuredData` undefined; the feature is listed in the page's
1106
+ `SoftwareApplication.featureList` (string array).
845
1107
  - For a discrete enumerable set (rare) — an `ItemList` payload with
846
- `itemListElement[]` mapping 1:1 to the feature rows the JSX
847
- renders, AFTER adding `ItemList` to the catalog (see above).
1108
+ `itemListElement[]` mapping 1:1 to the feature rows the page
1109
+ renders, each item's name read through `label(slot)` of the context
1110
+ `getStructuredData` receives, AFTER adding `ItemList` to the catalog
1111
+ (see above).
848
1112
 
849
1113
  **What is NOT in this emission**:
850
1114
 
851
1115
  - A standalone `Product` / `Offer` payload — those belong in pricing.
852
1116
  - A `FAQPage` — those belong in the FAQ section.
853
- - App-shaped duplicate of the page-manifest `featureList` — the
854
- page-manifest field is the single source of truth.
855
-
856
- **Verification grep** (run from the app root):
1117
+ - A duplicate of the `SoftwareApplication.featureList` — that field
1118
+ is the single source of truth.
857
1119
 
858
- | Invariant | Command |
859
- |---|---|
860
- | Section emits nothing (or an `ItemList`), and the page's payloads are valid | This section's own `defineWebsiteSection` call declares no `getStructuredData`, or one returning an `ItemList` (a page's sections file also holds its other sections, so a file-wide grep for their types proves nothing); `wildo website audit` reports no finding for the page |
1120
+ **Verification**: this section's own definition declares no
1121
+ `getStructuredData`, or one returning an `ItemList` (a page's sections
1122
+ file also holds its other sections, so a file-wide grep for their types
1123
+ proves nothing); `wildo website audit` reports no finding for the page.
861
1124
 
862
1125
  ## References
863
1126
 
864
1127
  - `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
1128
+ - `../website-building-blocks/references/framework-website-blocks-api.md` — source-backed `defineWebsiteBlock` and the configured blocks (`websiteFeatureRowBlock`, `websiteFactTableBlock`), `WebsiteFeatureRow`, `WebsiteFactTable` and `WebsiteBand` props, their slots, `WebsiteLinkTo` and the stylesheet hooks.
865
1129
 
866
1130
  ## Verification
867
1131
 
868
- - [ ] One `defineWebsiteSection` call per feature-detail instance
869
- (or a helper, as in the worked example).
1132
+ - [ ] One configured section per feature-detail instance
1133
+ (or a section factory, as in the worked example), each `websiteFeatureRowBlock.section(...)`
1134
+ — no hand-built copy/visual split, and no `defineWebsiteBlockSection` with a hand-listed slot array.
870
1135
  - [ ] Each instance has a unique `sectionRef`.
871
- - [ ] `imagePosition` is a typed prop, not a label key.
872
- - [ ] Every bullet leaf the component consumes is declared in
873
- `expectedLabelKeys` (no orphaned bullets, no missing ones).
874
- - [ ] `WebsiteImage` always receives explicit `width`+`height` (CLS
875
- contract — see the Phase 2 D18 primitive contract).
1136
+ - [ ] Each instance binds its own `WebsiteFeatureRowLayout` member in its config, so consecutive rows
1137
+ alternate; the layout is never a label key and never something the page passes.
1138
+ - [ ] No `intro` beside a feature row (it carries its own heading); its surface is the section's `band`.
1139
+ - [ ] Its words follow its config; the only words declared beside it are `nodeSlots` its visual reads
1140
+ itself (`visual-alt`, a demo's frame and screen words).
1141
+ - [ ] A link is a `WebsiteLinkTo`, never a typed `href`.
1142
+ - [ ] `WebsiteImage` always receives explicit `width`+`height`, so the
1143
+ image's space is reserved and the page does not shift as it loads.
1144
+ - [ ] A drawn-demo visual plays inside `WebsiteMotionDemo`: a kit drawing
1145
+ played by a scenario through `useWebsiteDemoScenario` (Step 5).
1146
+ - [ ] A facts table is `websiteFactTableBlock.section(...)` with an `intro`, never a hand-built `<table>`.
1147
+ - [ ] The look is adjusted through the theme, the config, or a rule on a `data-website-*`
1148
+ hook — no copied row markup, no `!important`, no raw colour.
876
1149
 
877
1150
  ### Grep invariants
878
1151
 
879
- | Invariant | Command |
880
- |---|---|
881
- | Factory used for each instance | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` |
882
- | Category enum | `rg -n "FEATURE_DETAIL" website/src/sections/<page>.sections.tsx` (must return ≥1 per instance) |
883
- | Image dimensions present | see the commands below the table (each `WebsiteImage` must have both) |
884
- | Bullet leaves declared = consumed | see the commands below the table (must return empty — no orphan / missing bullet leaves) |
1152
+ `npx astro check` in `website/` must pass: `.section(...)` refuses an `intro` beside a
1153
+ feature row, and a config that is not the block's props. Then, from the app root:
885
1154
 
886
1155
  ```bash
887
- # Image dimensions present
1156
+ # Each instance is the engine's row, configured (>= 1 per instance, or one in the section factory)
1157
+ rg -n "websiteFeatureRowBlock\.section\(" website/src/sections
1158
+
1159
+ # No row whose words are listed by hand (must return empty)
1160
+ rg -n "websiteFeatureRowSlots\(" website/src/sections
1161
+
1162
+ # Category enum (must return >= 1 per instance)
1163
+ rg -n "FEATURE_DETAIL" website/src/sections/<page>.sections.tsx
1164
+
1165
+ # The rows alternate: both layout members (or the site builder's reverse flag) appear when two or more rows are stacked
1166
+ rg -n "WebsiteFeatureRowLayout\.(VISUAL_END|VISUAL_START)|reverse: true" website/src/sections
1167
+
1168
+ # Image dimensions present (each WebsiteImage must have both)
888
1169
  rg -n "WebsiteImage" -A 3 website/src/sections/<page>.sections.tsx | rg -n "width=|height="
889
1170
 
890
- # Bullet leaves declared = consumed
891
- diff <(rg -oN "bullet-\d" website/src/sections/<page>.sections.tsx | sort -u) <(rg -oN '`\$\{root\}\.bullet-\d`' website/src/sections/<page>.sections.tsx | sed 's/.*\.//;s/`//' | sort -u)
1171
+ # A facts table is the engine's block (no hand-built table; must return empty)
1172
+ rg -n "<table" website/src/sections
1173
+
1174
+ # No typed link (must return empty: a link is a WebsiteLinkTo)
1175
+ rg -n "href=" website/src/sections/<page>.sections.tsx
1176
+
1177
+ # A drawn demo plays in the frame (each scenario sits inside a WebsiteMotionDemo; no bare timer, no hand-timed steps)
1178
+ rg -n "useWebsiteDemoScenario|useWebsiteMotionDemoTimeline|setInterval|setTimeout" website/src/sections/
1179
+
1180
+ # !important or a raw colour against the block (must return empty)
1181
+ rg -n '!important|#[0-9a-fA-F]{3,8}\b' website/src/styles
892
1182
  ```
893
1183
 
894
1184
  ## Common Rationalizations
895
1185
 
896
1186
  | Rationalization | Reality |
897
1187
  |---|---|
898
- | "I'll alternate image position based on instance index inside the component" | The component should render whatever the prop tells it; alternation is a page-composition decision. Hardcoding alternation in the component breaks single-feature usage. |
899
- | "I'll skip width/height on the image — Tailwind handles it" | CSS layout doesn't fix CLS; the browser needs intrinsic dimensions to reserve space before the image loads. |
1188
+ | "I'll alternate the visual's side based on instance index inside the component" | Each section binds its own `layout` in its config; the alternation is decided by the sections, in page order. A component that alternates by index breaks a single row and any reordering. |
1189
+ | "I'll copy the row's JSX to change its spacing" | The copy stops following the theme, the motion vocabulary and every fix to the block. Change the theme, the config, or one rule on a `data-website-*` hook. |
1190
+ | "I'll wrap `WebsiteFeatureRow` in my own component and list its words with `defineWebsiteBlockSection`" | Then the words are listed apart from what renders. Return the config from a builder in the site's kit and let `websiteFeatureRowBlock.section` render it. |
1191
+ | "The row needs a section intro above it" | It carries its own eyebrow, heading and body; an intro would give the section two titles, and the type refuses it. |
1192
+ | "The page can pass each instance its image and layout" | The page renders each section with no props. Bind them in the instance's config. |
1193
+ | "I'll skip width/height on the image — CSS handles it" | CSS layout doesn't fix CLS; the browser needs intrinsic dimensions to reserve space before the image loads. |
900
1194
  | "All instances can share one `sectionRef`" | The label-pack validator and the analytics layer both rely on per-section refs. Reuse breaks both. |
901
- | "I'll declare `bullet-1` through `bullet-5` even when an instance only renders three — easier to add later" | `expectedLabelKeys` is a hard contract: every declared key must have copy in every locale. Over-declaring forces translators to author empty strings (or worse, placeholder text that ships) for slots the component never consumes. Add the leaf when you add the `<li>`, not before. |
1195
+ | "The screenshot's alt is part of the row, the block declares it" | The block knows its own words, not its visual's. Declare `visual-alt` (or the demo's words) as `nodeSlots`. |
902
1196
 
903
1197
  ## Red Flags
904
1198
 
905
- - A single `FEATURE_DETAIL_SECTION` instance with three internal
906
- "items" stamped out via a `.map(…)` — that's a feature-summary
907
- shape; use `website-section-feature-benefit-summary` instead.
908
- - Hardcoded image URLs inside the component — pass them as props so
909
- the page composition can pick the right asset per locale / ICP /
910
- variant.
911
- - Bullet leaves declared in `expectedLabelKeys` but never consumed
912
- by the component (e.g. component renders `bullet-1`/`bullet-2`
913
- while the helper declares `bullet-1`/`bullet-2`/`bullet-3`).
914
- Translators ship copy for a slot the page will never render. Catch
915
- with the bullet-leaves diff grep invariant above (must return
916
- empty).
1199
+ - A single `FEATURE_DETAIL` section with three internal "features"
1200
+ stamped out via a `.map(…)` — that's a feature-summary shape; use
1201
+ `website-section-feature-benefit-summary` instead. Catch with the
1202
+ "Category enum" grep above (one hit per instance, not one per page).
1203
+ - A hand-built copy/visual split (`<div className="feature-detail">`, a
1204
+ `WebsiteHeading` beside an image) instead of the configured row —
1205
+ catch with the "engine's row, configured" grep above.
1206
+ - Feature-row words listed by hand (`websiteFeatureRowSlots(...)` spread into a `slots` array, or
1207
+ keys written out) — translators ship copy for a slot nothing renders, or a rendered point shows its
1208
+ key. Catch with the "listed by hand" grep above.
1209
+ - Every stacked row on the same side — catch with the alternation grep above.
1210
+ - A screenshot without intrinsic dimensions — catch with the image-dimensions grep above.
1211
+ - An `intro` passed beside a feature row, or a band drawn around it by hand — the row carries its
1212
+ heading and the section draws its band; catch with `npx astro check`.
1213
+ - A hand-built facts `<table>` — catch with the table grep above.
1214
+ - A typed `href` on the "read more" link — catch with the "No typed link" grep above.
1215
+ - An animated feature visual with no pause control (a GIF, a
1216
+ hand-rolled timer, a CSS loop outside a demo frame) — catch with the
1217
+ drawn-demo grep above, and play it in `WebsiteMotionDemo` (Step 5).
1218
+ - `!important` or a raw colour in a rule against the row — catch with the last grep above.
917
1219
 
918
1220
  ## Related Skills
919
1221
 
1222
+ - `website-building-blocks` — how the engine's blocks are configured, how their words follow, and how they are adjusted without forking.
920
1223
  - `website-page-authoring` — composing the stack of feature-detail
921
1224
  instances into the Features page manifest.
922
1225
  - `website-label-pack` — authoring per-instance EN/FR strings.
1226
+ - `website-theme-authoring` — the theme the row's look is read from.
923
1227
  - `website-section-feature-benefit-summary` — the higher-level
924
1228
  "why us" grid sibling.
925
1229
  - `website-seo-aeo-geo` — page-level
926
1230
  `SoftwareApplication.featureList` declaration.
1231
+ - `website-section-product-showcase` — drawing a demo from the
1232
+ application's resources (Step 2a).
1233
+ - `website-motion-design` — the demo frame, its pause control and the
1234
+ scenario timeline (Step 6), and the vocabulary the row's config `motion` takes.
927
1235
  - `website-primitive-overrides` — overriding the `WebsiteImage` /
928
1236
  `WebsiteHeading` primitives if the deep-dive needs richer media.