@wildo-ai/framework-knowledge 1.1.10 → 1.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1062) 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/derived-artifacts.md +4 -2
  4. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  5. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  6. package/dist/esm/framework-knowledge.definitions.js +459 -76
  7. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  8. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  9. package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
  10. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  11. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  12. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  13. package/dist/esm/index.d.ts +2 -0
  14. package/dist/esm/index.d.ts.map +1 -1
  15. package/dist/esm/index.js +2 -0
  16. package/dist/esm/index.js.map +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  18. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  20. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +5 -2
  23. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +11 -6
  25. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  27. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +4 -1
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +3 -3
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +3 -2
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  45. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  47. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  49. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +2 -2
  51. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
  53. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
  55. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  56. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  59. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  60. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
  62. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  66. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  68. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
  69. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  70. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  72. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +6 -4
  74. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  83. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  86. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  88. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
  89. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
  91. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  95. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
  97. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
  99. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
  101. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  110. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  117. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
  118. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
  120. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  123. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +4 -3
  124. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  125. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  126. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  127. package/dist/esm/source-anchor-grammar.js +114 -0
  128. package/dist/esm/source-anchor-grammar.js.map +1 -0
  129. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  130. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  131. package/dist/knowledge/manifest.json +8 -8
  132. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  133. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  135. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  136. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +350 -23
  137. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +6 -3
  138. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +248 -9
  139. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  140. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  141. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
  142. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  143. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +3 -3
  144. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +12 -1
  145. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +5 -2
  146. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +13 -4
  147. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +4 -3
  148. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
  149. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
  150. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
  151. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
  152. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +33 -5
  153. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +3 -3
  154. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
  155. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +20 -3
  156. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
  157. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
  158. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +97 -23
  159. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  160. package/dist/knowledge/playbooks/refinement.document-facts/method.md +30 -3
  161. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -2
  162. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  163. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  164. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  165. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  166. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  167. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
  168. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +2 -2
  169. package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
  170. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
  171. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  172. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
  173. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
  174. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
  175. package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
  176. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  177. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +3 -3
  178. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  179. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -1
  180. package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
  181. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
  182. package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
  183. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
  184. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +4 -0
  185. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +5 -4
  186. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  187. package/dist/knowledge/references/application-maturity.config.md +1 -1
  188. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
  189. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
  190. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  191. package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
  192. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  193. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  194. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  195. package/dist/knowledge/references/build-plan.task-graph.config.md +238 -8
  196. package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
  197. package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
  198. package/dist/knowledge/references/capability-composition.config.md +4 -3
  199. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  200. package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
  201. package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
  202. package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
  203. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  204. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  205. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  206. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
  207. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
  208. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
  209. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  210. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  211. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  212. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  213. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  214. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  215. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
  216. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  217. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  218. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  219. package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
  220. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  221. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  222. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  223. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  224. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  225. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  226. package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
  227. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  228. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  229. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  230. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
  231. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  232. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +52 -22
  233. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
  234. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
  235. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  236. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  237. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  238. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  239. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  240. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  241. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  242. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  243. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  244. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  245. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  246. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  247. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  248. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  249. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  250. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  251. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  252. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  253. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  254. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  255. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  256. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  257. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  258. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  259. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  260. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  261. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  262. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  263. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  264. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  265. package/dist/knowledge/references/experience-plan.config.md +16 -0
  266. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
  267. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  268. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  269. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
  270. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  271. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
  272. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  273. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
  274. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
  275. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
  276. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  277. package/dist/knowledge/references/integration-plan.config.md +21 -1
  278. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  279. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  280. package/dist/knowledge/references/placement-plan.config.md +75 -13
  281. package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
  282. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
  283. package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
  284. package/dist/knowledge/references/platform.config.saas.md +106 -14
  285. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  286. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  287. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  288. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  289. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  290. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  291. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  292. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  293. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  294. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  295. package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
  296. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  297. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  298. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  299. package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
  300. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  301. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
  302. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
  303. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
  304. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  305. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  306. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  307. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  308. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  309. package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
  310. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  311. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  312. package/dist/knowledge/references/saas.backend.email.send.md +7 -0
  313. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
  314. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  315. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  316. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  317. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  318. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  319. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
  320. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  321. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
  322. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
  323. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  324. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  325. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  326. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  327. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  328. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
  329. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  330. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  331. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  332. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  333. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  334. package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
  335. package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
  336. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  337. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  338. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  339. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  340. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  341. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  342. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  343. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  344. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  345. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  346. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  347. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  348. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  349. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +18 -16
  350. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  351. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  352. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  353. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
  354. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  355. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  356. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  357. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +10 -2
  358. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
  359. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
  360. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  361. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  362. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
  363. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  364. package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
  365. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
  366. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +89 -51
  367. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +9 -6
  368. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
  369. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +66 -4
  370. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  371. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  372. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  373. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  374. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  375. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  376. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  377. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  378. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  379. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  380. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  381. package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
  382. package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
  383. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  384. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  385. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  386. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  387. package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
  388. package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
  389. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
  390. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  391. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
  392. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
  393. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
  396. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  397. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  398. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
  400. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  406. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  407. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  408. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  409. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
  410. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
  411. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  412. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
  413. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  414. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
  415. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  416. package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
  417. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  418. package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
  419. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  420. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  421. package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
  422. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  423. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  424. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  425. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  426. package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
  427. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +58 -6
  428. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  429. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  430. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
  431. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  434. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
  435. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  436. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  437. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  438. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
  440. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
  441. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
  442. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
  443. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
  444. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  445. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
  446. package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
  447. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  448. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
  451. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  452. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  453. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  454. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  455. package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
  456. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +58 -2
  457. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
  459. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  460. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  461. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  462. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  463. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  464. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
  465. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  466. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  467. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  468. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  469. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  470. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  471. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
  472. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  473. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
  474. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  475. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  476. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  477. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  478. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  479. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -6
  480. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
  481. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  482. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
  483. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
  484. package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
  485. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  486. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  487. package/dist/knowledge/references/saas.public-runtime.contract.md +34 -2
  488. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  489. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  490. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
  491. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  492. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
  493. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
  494. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  495. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  496. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  497. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  498. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
  499. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  500. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
  501. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  502. package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
  503. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  504. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  505. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  506. package/dist/knowledge/references/saas.website.astro.label-loader.md +38 -9
  507. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  508. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
  509. package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
  510. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  511. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  512. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  513. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  514. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  515. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  516. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  517. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  518. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  519. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  520. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  521. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  522. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  523. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  524. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  525. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  526. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  527. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  528. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  529. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  530. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  531. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  532. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  533. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  534. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  535. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  536. package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
  537. package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
  538. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  539. package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
  540. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  541. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  542. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  543. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  544. package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
  545. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
  546. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  547. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  548. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
  549. package/dist/knowledge/references/saas.website.config.site-context-loader.md +21 -1
  550. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  551. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  552. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  553. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  554. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  555. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  556. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  557. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  558. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  559. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  560. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  561. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  562. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  563. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  564. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  565. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  566. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  567. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  568. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  569. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  570. package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
  571. package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
  572. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  573. package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
  574. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  575. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  576. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  577. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  578. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  579. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  580. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  581. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  582. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  583. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  584. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  585. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  586. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  587. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  588. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  589. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  590. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  591. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  592. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  593. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  594. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  595. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  596. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  597. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  598. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  599. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  600. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  601. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  602. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  603. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  604. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  605. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  606. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  607. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  608. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  609. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  610. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  611. package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
  612. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  613. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  614. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  615. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  616. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  617. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  618. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  619. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  620. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  621. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  622. package/dist/knowledge/references/service-method.config.md +270 -0
  623. package/dist/knowledge/references/website-plan.config.md +544 -32
  624. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  625. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  626. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  627. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  628. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +73 -9
  629. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  630. package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
  631. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +75 -6
  632. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
  633. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  634. package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
  635. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  636. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  637. package/dist/knowledge/references/zod.decorators.schema-metadata.md +4 -0
  638. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +32 -4
  639. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
  640. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
  641. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
  642. package/dist/knowledge/references/zod.factories.code.md +18 -9
  643. package/dist/knowledge/references/zod.factories.duration.md +23 -14
  644. package/dist/knowledge/references/zod.factories.money.md +24 -15
  645. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  646. package/dist/knowledge/references/zod.factories.range.md +5 -1
  647. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  648. package/dist/knowledge/registries/framework-topics.json +2411 -139
  649. package/dist/knowledge/registries/playbooks.json +51 -30
  650. package/dist/knowledge/registries/source-tags.json +8500 -4768
  651. package/dist/knowledge/rules/database-migration-obligation.md +11 -5
  652. package/dist/knowledge/skills/INDEX.md +60 -33
  653. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  654. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
  655. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  656. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  657. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  658. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  659. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  660. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
  661. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  662. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  663. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  664. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
  665. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  666. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  667. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  668. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  669. package/dist/knowledge/skills/application-database-migrations/SKILL.md +27 -9
  670. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  671. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +6 -6
  672. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +124 -3
  673. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
  674. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
  675. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  676. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
  677. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +35 -1
  678. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  679. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +3 -0
  680. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  681. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  682. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  683. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
  684. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  685. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  686. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
  687. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  688. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  689. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  690. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
  691. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
  692. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  693. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  694. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +134 -33
  695. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  696. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  697. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
  698. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  699. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
  700. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
  701. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  702. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
  703. package/dist/knowledge/skills/config-app-shell/SKILL.md +57 -28
  704. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  705. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  706. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  707. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  708. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +17 -6
  709. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
  710. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  711. package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
  712. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  713. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  714. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  715. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  716. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
  717. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
  718. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  719. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  720. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  721. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
  722. package/dist/knowledge/skills/config-saas/SKILL.md +2 -0
  723. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +11 -3
  724. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
  725. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
  726. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  727. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
  728. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
  729. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
  730. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
  731. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
  732. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  733. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
  734. package/dist/knowledge/skills/config-saas-backend/SKILL.md +5 -3
  735. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  736. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  737. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
  738. package/dist/knowledge/skills/configure-billing/SKILL.md +14 -0
  739. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
  740. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  741. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  742. package/dist/knowledge/skills/email-add-template/SKILL.md +46 -5
  743. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +7 -0
  744. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  745. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  746. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
  747. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
  748. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
  749. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  750. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
  751. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  752. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  753. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  754. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +281 -20
  755. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
  756. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
  757. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
  758. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
  759. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
  760. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  761. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
  762. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
  763. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
  764. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
  765. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
  766. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  767. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  768. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
  769. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  770. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
  771. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
  772. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  773. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
  774. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
  775. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
  776. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  777. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
  778. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +27 -17
  779. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +136 -14
  780. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  781. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  782. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  783. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  784. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
  785. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +4 -1
  786. package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
  787. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
  788. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
  789. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  790. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
  791. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  792. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
  793. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
  794. package/dist/knowledge/skills/infra-environment-config/SKILL.md +107 -2
  795. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
  796. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
  797. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
  798. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  799. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  800. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  801. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  802. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  803. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  804. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  805. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  806. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  807. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  808. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
  809. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  810. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +9 -0
  811. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +9 -0
  812. package/dist/knowledge/skills/market-generation-cli/SKILL.md +2 -1
  813. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +2 -1
  814. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  815. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  816. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
  817. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
  818. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  819. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  820. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +150 -4
  821. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
  822. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
  823. package/dist/knowledge/skills/module-relationships/SKILL.md +50 -27
  824. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  825. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  826. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
  827. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  828. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  829. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
  830. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
  831. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
  832. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  833. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  834. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  835. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
  836. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  837. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  838. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
  839. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  840. package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
  841. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
  842. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  843. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
  844. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
  845. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
  846. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
  847. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  848. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
  849. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
  850. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
  851. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  852. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  853. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +26 -14
  854. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  855. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  856. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  857. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  858. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  859. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
  860. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
  861. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  862. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  863. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +132 -55
  864. package/dist/knowledge/skills/resource-add-resource/SKILL.md +49 -4
  865. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +58 -2
  866. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
  867. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  868. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +102 -4
  869. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  870. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  871. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +6 -0
  872. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
  873. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +18 -0
  874. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
  875. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +60 -3
  876. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  877. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  878. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +1 -1
  879. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
  880. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +195 -23
  881. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
  882. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
  883. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +176 -10
  884. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  885. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +88 -50
  886. package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
  887. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  888. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  889. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
  890. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  891. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
  892. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
  893. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  894. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
  895. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  896. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  897. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
  898. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  899. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  900. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
  901. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  902. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  903. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
  904. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
  905. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  906. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  907. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
  908. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
  909. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +3 -1
  910. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
  911. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
  912. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +26 -10
  913. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  914. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +9 -7
  915. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  916. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +79 -6
  917. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  918. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
  919. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
  920. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +32 -4
  921. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
  922. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +116 -66
  923. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  924. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +203 -18
  925. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
  926. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +155 -76
  927. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +19 -17
  928. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
  929. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  930. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  931. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +168 -58
  932. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  933. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  934. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
  935. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
  936. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
  937. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
  938. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
  939. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  940. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  941. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  942. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
  943. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +141 -32
  944. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +66 -4
  945. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  946. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  947. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
  948. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
  949. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
  950. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
  951. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
  952. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
  953. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  954. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +5 -0
  955. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  956. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +11 -4
  957. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
  958. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
  959. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
  960. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +251 -78
  961. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1064 -192
  962. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  963. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  964. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  965. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  966. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  967. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +39 -18
  968. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  969. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
  970. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
  971. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
  972. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
  973. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  974. package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
  975. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
  976. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
  977. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  978. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  979. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  980. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
  981. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  982. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
  983. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  984. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
  985. package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
  986. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  987. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +24 -3
  988. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  989. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  990. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  991. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
  992. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  993. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  994. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  995. package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
  996. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  997. package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
  998. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  999. package/dist/knowledge/skills/website-section-faq/SKILL.md +561 -302
  1000. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1001. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1002. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +647 -274
  1003. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1004. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +572 -264
  1005. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1006. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
  1007. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1008. package/dist/knowledge/skills/website-section-hero/SKILL.md +603 -332
  1009. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1010. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1011. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1012. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1013. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1014. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1015. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1016. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1017. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1018. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1019. package/dist/knowledge/skills/website-section-pricing/SKILL.md +549 -378
  1020. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
  1021. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1022. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
  1023. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1024. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1025. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1026. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1027. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1028. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1029. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1030. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1031. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1032. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1033. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1034. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +739 -315
  1035. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1036. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1037. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1038. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1039. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1040. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1041. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1042. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1043. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
  1044. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
  1045. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
  1046. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
  1047. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1048. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1049. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1050. package/dist/knowledge/topic-index.json +16442 -8572
  1051. package/package.json +4 -4
  1052. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1053. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1054. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1055. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1056. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1057. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1058. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1059. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1060. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1061. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1062. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: website-section-pricing
3
- description: Author a Pricing section that renders the application's billing catalogue — never a copy of its prices — with `defineWebsiteSection({ category: WebsiteSectionCategory.PRICING, … })`, `useWebsitePricingCatalog()`, and `Offer` / `AggregateOffer` JSON-LD derived from the same catalogue. Use when the user says "add a pricing section", "compose pricing tiers", "wire pricing JSON-LD for SEO", or "customize the pricing comparison layout".
3
+ description: Author a Pricing section that renders the application's billing catalogue — never a copy of its prices — by composing the engine's `WebsitePricing` block (TEASER on a page that summarises the plans, PLANS on the pricing page) under a `WebsiteSectionIntro` on a `WebsiteBand` in a `defineWebsiteBlockSection({ category: WebsiteSectionCategory.PRICING, … })` definition — the one section declared by hand rather than configured as a block — with `Offer` / `AggregateOffer` JSON-LD derived from the same catalogue. Use when the user says "add a pricing section", "compose pricing tiers", "show the plans on the home page", "add a monthly / yearly switch", "wire pricing JSON-LD for SEO", or "customize the pricing layout".
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,202 +697,285 @@ WebsiteSection.displayName = 'WebsiteSection';
619
697
  ```
620
698
 
621
699
 
622
- > **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no concrete
623
- > Pricing component**. This skill documents the
624
- > `defineWebsiteSection<TProps>` authoring pattern with first-class
625
- > `SoftwareApplication` (or `Product`) + `Offer` JSON-LD emission via `getStructuredData()`.
700
+ > **Framework rule**: the installed `@wildo-ai/saas-website` package ships the section's
701
+ > STRUCTURE as a building block, `WebsitePricing`: the plans the billing catalogue lists, in
702
+ > its order, each with its name, its price stated as the catalogue decides (amount, currency,
703
+ > period, basis, disclosure), its summary, its trial, its feature lines and its call to action;
704
+ > the recommended plan marked; a monthly / yearly switch when the catalogue prices both
705
+ > cadences. Every number on it comes from the catalogue; only the WORDS are the site's, and
706
+ > the block refuses a price it has no word for. This skill covers what a pricing
707
+ > section must SAY and CARRY — the catalogue's truth, its offers' JSON-LD and its `llms.txt`
708
+ > contribution — and composes the block on a `WebsiteBand`. How blocks are configured in general
709
+ > is `website-building-blocks`.
710
+
711
+ ## Pricing is the one section not configured as a block
712
+
713
+ Every other engine block is a whole section configured as `website<Name>Block.section({ …, config })`, its words
714
+ DERIVED from its config. Pricing has no such block: its words depend on the plans the catalogue publishes, which reach
715
+ the block only when the page renders (the route's `pricingCatalog`, read through `useWebsitePricingCatalog()`), while
716
+ a section declares its words when its module loads. So it is `defineWebsiteBlockSection({ pageRef, sectionRef,
717
+ category: WebsiteSectionCategory.PRICING, slots, Component, getStructuredData? })`, declared by hand: its `slots` are
718
+ `websiteSectionIntroSlots(...)` then `websitePricingSlots(PRICING)`, each with the SAME options its component renders
719
+ (Step 5), and its `Component` composes the `WebsiteBand` (`tone`, `spacing` as props), the `WebsiteSectionIntro` and
720
+ `WebsitePricing` by hand. The block checks the declared statements and periods against the catalogue at render.
626
721
 
627
722
  ## Overview
628
723
 
629
- A Pricing section displays N comparable tiers (typically 2–4). Each
630
- tier carries a name, a price expression, a pitch line, a bullet list
631
- of included capabilities, and a CTA (sign up, contact sales, etc.).
632
-
633
- The pricing section is one of the few categories where **structured
634
- data emission is mandatory in practice**: emitting `SoftwareApplication` + `Offer`
635
- (or `AggregateOffer` when the tier is a price range) materially
636
- improves SERP rendering AND lets answer-engine LLMs cite pricing
637
- without hallucinating.
724
+ A Pricing section displays the application's plans (typically 2–4). Each plan carries a name, a price, a summary,
725
+ a short list of what it includes, and a call to action.
638
726
 
639
- What the category does — and, for structured data, does not — decide:
727
+ The pricing section is one of the few categories where **structured data emission is mandatory in practice**:
728
+ emitting `SoftwareApplication` + `Offer` (or `AggregateOffer` when the plans form a price range) materially
729
+ improves SERP rendering AND lets answer-engine LLMs cite pricing without hallucinating.
640
730
 
641
- 1. **SEO/AEO/GEO** — a pricing section emits the product and its
642
- plans: `SoftwareApplication` (the application itself — the usual
643
- case) or `Product` (a discrete good), with `Offer` per plan or one
644
- `AggregateOffer`. Nothing enforces this pairing — the structured-data audit checks each payload against the Schema.org catalog, never against the section's category.
645
- 2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.PRICING`.
646
- 3. **Analytics labelling** — `data-section-category="pricing"` is the
647
- funnel-step grouping for tier-impression tracking.
731
+ The category maps 1:1 to this skill and labels the funnel step (`data-section-category="pricing"`). It does not
732
+ decide the structured data: nothing enforces the product + offers pairing, because the audit checks each payload
733
+ against the Schema.org catalog, never against the section's category.
648
734
 
649
735
  ## Where the prices come from
650
736
 
651
- **The website never types a price.** The plans, their prices, which one is recommended, how much of
652
- each price may be stated, and which are announced but not yet on sale all come from the application's
653
- **billing catalogue** — the `ProductDefinition[]` its shared modules declare, the same array the backend
654
- syncs to the billing provider (see `configure-billing`). The page reads it at build time and the
655
- section renders from it. A price written a second time in the website is a price that will disagree
656
- with the one the application charges.
737
+ **The website never types a price.** The plans, their prices, which one is recommended, how much of each price may
738
+ be stated, and which are announced but not yet on sale all come from the application's **billing catalogue** — the
739
+ `ProductDefinition[]` its shared modules declare, the same array the backend syncs to the billing provider (see
740
+ `configure-billing`). The route reads it at build time and the block renders from it. A price written a second time
741
+ in the website is a price that will disagree with the one the application charges.
657
742
 
658
- If the catalogue is empty or does not yet state what the page must say (a plan to recommend, a price
659
- that is only a starting price, a plan quoted on request, a plan not on sale yet), **fix the catalogue
660
- first** — those are `isRecommended`, `priceDisclosure` and `availability` on the product definition —
661
- and never compensate in the website.
743
+ If the catalogue is empty or does not yet state what the page must say (a plan to recommend, a price that is only a
744
+ starting price, a plan quoted on request, a plan not on sale yet), **fix the catalogue first** — those are
745
+ `isRecommended`, `priceDisclosure` and `availability` on the product definition — and never compensate in the
746
+ website.
662
747
 
663
748
  ## App Paths
664
749
 
665
750
  | Surface | Glob (relative to app root) |
666
751
  |---|---|
667
- | The billing catalogue (the prices) | `shared-lib/src/engine/product.ts` — or wherever the shared modules declare `productDefinitions` |
668
- | 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) |
669
- | Page composition | `website/src/pages-impl/pricing.page.tsx` |
670
- | The route: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` |
671
- | Structured data the audit reads | `website/src/structured-data/page-payloads.ts` |
752
+ | The billing catalogue (the prices, the grants) | `shared-lib/src/engine/product.ts` — or wherever the shared modules declare `productDefinitions` |
753
+ | The site's words per catalogue plan, shared by every page that shows the plans | `website/src/sections/kit/**` |
754
+ | Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` |
755
+ | The route: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` (and every route whose page shows plans) |
756
+ | The offers of one page (called by the route), and the per-locale offers the audit reads | `website/src/structured-data/page-payloads.ts` |
672
757
  | Label pack (per locale) | `website/src/i18n/<locale>.json` |
758
+ | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
673
759
 
674
760
  ## When to Use
675
761
 
676
- - Surfacing the application's plans with a primary "start" / "buy" action per plan.
762
+ - The pricing page: the plans with a call to action each (`PLANS`).
763
+ - A home or product page: the plans in brief, linking to the pricing page (`TEASER`).
677
764
  - Search engines should index the price points (yes — almost always the right answer for SaaS).
678
765
 
679
766
  ## When NOT to Use
680
767
 
681
- - The application has no billing catalogue and sells through a sales conversation only → a CTA
682
- section pointing at the contact page. (A catalogue whose plans are all `ON_REQUEST` still belongs
683
- here: the section lists them without prices, and the page publishes no price at all.)
768
+ - The application has no billing catalogue and sells through a sales conversation only → a CTA section pointing at
769
+ the contact page. (A catalogue whose plans are all `ON_REQUEST` still belongs here: the block lists them without
770
+ prices, and the page publishes no price at all.)
771
+ - The plans' colours, corners or spacing → `website-theme-authoring`; the block reads them from the theme.
684
772
 
685
773
  ## Workflow
686
774
 
687
775
  ### Step 1: Confirm the catalogue says what the page will say
688
776
 
689
- Read the application's product definitions. Each public PLAN becomes one tier, in `sortOrder`. Check
690
- the three pricing-surface facts against what the page must state, and edit the catalogue if they are
691
- wrong. Never keep a list of exceptions in the website.
777
+ Read the application's product definitions. Each public PLAN becomes one card, in `sortOrder`. Check the
778
+ pricing-surface facts against what the page must state, and edit the catalogue if they are wrong. Never keep a list
779
+ of exceptions in the website.
780
+
781
+ | Catalogue fact | What the block shows | The section must declare |
782
+ |---|---|---|
783
+ | `isRecommended` | the card marked, with the word `recommended` — word it as a recommendation, never "most popular", which nothing measured | (always declared) |
784
+ | a price's recurrence | the amount, then the period's word (`period.month`, `period.year`, `period.once` for a one-time price, `period.month.3` for every three months) | that period in `periods` |
785
+ | `priceDisclosure: STARTING_AT` | `price.from` before the amount | `WebsitePricingStatement.STARTING_AT` |
786
+ | `amountBasis: PER_UNIT` | `price.per-unit` after the period ("per member") | `WebsitePricingStatement.PER_UNIT` |
787
+ | `amountBasis: VARIABLE` | `price.variable` IN PLACE of the amount, which the catalogue forbids presenting as the price | `WebsitePricingStatement.VARIABLE` |
788
+ | `priceDisclosure: ON_REQUEST` | `price.on-request` in place of the amount and the period | `WebsitePricingStatement.ON_REQUEST` |
789
+ | `trialDays` (PLANS) | `trial.before` N `trial.after` | `WebsitePricingStatement.TRIAL` |
790
+ | `availability: UPCOMING` | `upcoming` where the call to action would be: sign-up refuses a plan not on sale | `WebsitePricingStatement.UPCOMING` |
791
+ | prices at both monthly and yearly cadence (PLANS) | the monthly / yearly switch | a month AND a year in `periods` (which declares the switch's `billing.*` words) |
692
792
 
693
793
  ### Step 2: Load the catalogue in the route
694
794
 
695
- In `website/src/pages/pricing.astro` frontmatter, `await loadWebsitePricingCatalog()` (from
696
- `@wildo-ai/saas-website/config-loader`; pass `targetScope` when the catalogue sells to more than one
697
- audience) and pass the result to the bridge island as `pricingCatalog={pricingCatalog}`. The loader
698
- reads the catalogue from source, so it is current on every build.
699
-
700
- ### Step 3: Author the component
701
-
702
- Read the plans with `useWebsitePricingCatalog()`. Name each plan and its copy through labels keyed by
703
- the plan's catalogue `key` (`plan-<key>.name`, `.pitch`, `.cta`); format each amount with
704
- `publicPricingAmountDecimal(price)` and the page locale. Per plan:
705
-
706
- | Catalogue fact | What the tile does |
707
- |---|---|
708
- | `isRecommended` | Emphasis, and a label that says RECOMMENDED — never "most popular", which nothing measured |
709
- | `priceDisclosure: STARTING_AT` | The price reads as a starting price ("From …") |
710
- | `priceDisclosure: ON_REQUEST` | No price; the action leads to the contact page |
711
- | `availability: UPCOMING` | Listed, with a "coming soon" state instead of a sign-up action |
712
- | `amountBasis: PER_UNIT` | "per member" (or the application's unit noun) after the amount |
713
- | `recurrence` | "per month" / "per year" / nothing for a one-time price |
714
-
715
- ### Step 4: Publish the offers
716
-
717
- Build the page's `AggregateOffer` with `buildWebsitePricingOfferStructuredData({ catalog, … })`: it
718
- publishes a plan's price only when that price is TRUE — on sale, listed, and a flat or per-unit
719
- amount — so a starting price, an on-request plan or an upcoming plan never appears in search results
720
- as the offer. A per-unit price carries its unit (`perUnitName`, e.g. `member`, required when one is
721
- published), and a range never mixes flat and per-unit prices or monthly and yearly ones. The unit is ONE
722
- per page: the catalogue does not record what a per-unit price is per, so a page whose per-unit plans
723
- charge for different things (seats and gigabytes) cannot be published truthfully by this builder. Return it from `resolveStructuredDataPagePayloadsForManifest` in
724
- `website/src/structured-data/page-payloads.ts` (the audit reads it there) and render the same result
725
- in the route through `renderPageStructuredData({ sections, pagePayloads })`. The section's own
726
- `getStructuredData()` emits the `SoftwareApplication` the offers name as `itemOffered`, and no price.
727
-
728
- **Stop** after the tiers render from the catalogue, `wildo website audit --strict` reports no
729
- finding for the pricing page, and the built page's JSON-LD prices match the catalogue.
730
-
731
- ## Structured data (AEO)
732
-
733
- Pricing sections own the commercial entity graph: the product
734
- (`SoftwareApplication`, or `Product` for a discrete good) plus either
735
- child `Offer` entries or one `AggregateOffer`.
736
-
737
- - **What earns its place**: a real purchasable plan surface, visible
738
- pricing, stable plan keys, and truthful currency semantics — all of it
739
- derived from the billing catalogue.
740
- - **What is NOT in this block**: hidden sales-only tiers, promo-only
741
- pricing not visible on the page, or made-up ranges.
742
- - **Verification grep**:
743
- `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts`
744
- (must return `>= 1`), and `rg -n "priceCurrency|price:" website/src/sections/<page>.sections.tsx`
745
- (must return `0` — the section never types a price).
795
+ In the route's frontmatter, `await loadWebsitePricingCatalog()` (from `@wildo-ai/saas-website/config-loader`; pass
796
+ `targetScope` when the catalogue sells to more than one audience) and pass the result to the bridge island as
797
+ `pricingCatalog={pricingCatalog}`. The loader reads the catalogue from source, so it is current on every build.
798
+ Every route whose page shows a pricing block does this, the home page's included; the block throws on a page that
799
+ passed none, rather than stating that the application sells nothing.
800
+
801
+ ### Step 3: Choose the layout
802
+
803
+ | Layout | Where | Shows |
804
+ |---|---|---|
805
+ | `WebsitePricingLayout.PLANS` | the pricing page | the full cards, the cadence switch, each plan's feature lines, trial and call to action, an optional `note` under the plans |
806
+ | `WebsitePricingLayout.TEASER` | a page that is not the pricing page | each plan's name, its price with the period word of the price's own recurrence, its summary, and a link to the pricing page (`pricingPage`, a `WebsiteLinkTo`) |
807
+
808
+ ### Step 4: Write the site's words per catalogue plan
809
+
810
+ The words are one constant of `WebsitePricingPlanWords` (`{ key, features?, link? }`), keyed by the catalogue's plan key,
811
+ kept in the site's kit so every page that shows the plans uses the same words. A plan reads `plans.<key>.name` and
812
+ `plans.<key>.summary`, and on PLANS `plans.<key>.cta` and one `plans.<key>.<ref>` per feature line.
813
+
814
+ - **Every plan the catalogue lists needs words**: the block throws on a catalogue plan the constant does not name,
815
+ rather than render raw keys. A plan added to the catalogue stops the build until it has words.
816
+ - **A feature line names the GRANT it describes** (`{ ref, grant }`, a feature or limit id of the plan's product),
817
+ and the block throws on a line its plan does not grant: a pricing page must not promise what checkout does not
818
+ sell. A grant the product gates nothing with yet gets no line.
819
+ - **A plan's `link` overrides the block's `signUp`** for that plan's call to action (Step 6).
820
+
821
+ ### Step 5: Declare the statements and periods the catalogue makes necessary
822
+
823
+ A price is a sentence the catalogue decides, and every part of it is a declared word. Read the catalogue's plans
824
+ (Step 1's table) and declare exactly what they need:
825
+
826
+ - **`periods`** — the recurrences the section has words for, as `{ unit, count }` (`PublicPricingRecurrenceUnit`
827
+ from `@wildo-ai/saas-models/public-runtime`); `websitePricingPeriodSlot(period)` names each word. Defaults: a
828
+ month for TEASER; a month and a year for PLANS, which also declares the switch's words (`billing.label`,
829
+ `billing.monthly`, `billing.yearly`). Those three are declared ONLY when PLANS declares both a month and a year.
830
+ - **`statements`** — the `WebsitePricingStatement`s the catalogue's plans need, from the table above.
831
+ - **`note: true`** (PLANS) — a line under the plans, when one is owed: what an add-on costs, what the plans exclude.
832
+ - **`pricingPage`** (TEASER) — always on a teaser; its word is `link`.
833
+
834
+ Hold the options in one constant and pass the SAME constant to `WebsitePricing` and to `websitePricingSlots(...)`,
835
+ so the words the section declares are the words the block reads, and nothing is declared that no price needs.
836
+
837
+ **The block checks you.** A plan whose price needs a word the section did not declare stops the page, and the error
838
+ names the statement or the period to declare; the cadence switch, when the catalogue prices both a month and a year,
839
+ stops it too until both periods are declared. So a catalogue change — a per-seat price, a yearly-only plan, a trial
840
+ — can never render as a wrong sentence: read the error, declare what it names, write the word in every pack.
841
+
842
+ ### Step 6: Point the calls to action
843
+
844
+ Every plan's call to action goes to `signUp`, the application's sign-up by default (`{ kind:
845
+ WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP }`), unless the plan's words carry their
846
+ own `link`: an `ON_REQUEST` plan's contact page, say (`{ kind: WebsiteMenuLinkKind.PAGE, routePath: '/contact' }`),
847
+ with a `cta` word that says so. Both resolve per environment and locale like the header's; never type an
848
+ application URL. An UPCOMING plan has no call to action at all.
849
+
850
+ Each plan card carries the id `plan-<key>`, the fragment the offer JSON-LD gives each offer's URL (Step 7), so an
851
+ offer found in search results lands on its own card.
852
+
853
+ ### Step 7: Publish the offers
854
+
855
+ Build the page's `AggregateOffer` with `buildWebsitePricingOfferStructuredData({ catalog, … })`: it publishes a
856
+ plan's price only when that price is TRUE — on sale, listed, and a flat or per-unit amount — so a starting price, an
857
+ on-request plan, a variable price or an upcoming plan never appears in search results as the offer. Name each plan
858
+ with the same word the block shows (`plans.<key>.name`). A per-unit price carries its unit (`perUnitName`, the
859
+ page's NOUN for it, e.g. `member`, declared as the section's `offer.unit` word beside the block's `price.per-unit`
860
+ phrase, and required when one is published), and a range never mixes flat and per-unit prices or monthly and
861
+ yearly ones. The unit is ONE per page: the catalogue does not record what a per-unit price is per, so a page whose
862
+ per-unit plans charge for different things (seats and gigabytes) cannot be published truthfully by this builder.
863
+
864
+ The offers belong to ONE page in ONE locale: its URL and its words. Build them in a single function of that page —
865
+ its `pageUrl`, the `siteOrigin` and its `labelPack`, the fields of the route's `runtime.structuredData` — in
866
+ `website/src/structured-data/page-payloads.ts`, and call it from both readers: the route renders it through
867
+ `renderPageStructuredData({ sections, context: runtime.structuredData, pagePayloads })`, and
868
+ `resolveStructuredDataPagePayloadsForManifest` returns it once per locale, each at that locale's route, for the
869
+ audit. Never type an origin into it: with one URL written for every locale, the French page publishes the
870
+ default-locale page's URL.
871
+
872
+ The section's own `getStructuredData()` emits the `SoftwareApplication` the offers name as `itemOffered`, at
873
+ `${siteOrigin}/#software-application`, and no price. It reads `siteOrigin` from the page context it receives; a
874
+ payload that also carries a word (a `description`) reads it through `label('<slot>')`, in the page's locale. A
875
+ teaser emits nothing: the pricing page publishes the offers.
876
+
877
+ ### Step 8: Make it this site's own without forking the block
878
+
879
+ In this order: the theme, the props above, the block's `motion` prop (keyed by `WebsitePricingMotionPoint.PLANS`,
880
+ or `null` to keep the plans from staggering in), and last an ordinary CSS rule on a hook
881
+ (`[data-website-block='pricing'] [data-website-recommended]`). The block's CSS is in the `wildo-website` cascade
882
+ layer, so an unlayered site rule wins without `!important`; read colours from the current tone, never a hex.
883
+
884
+ **Stop** after the plans render from the catalogue, `wildo website audit --strict` reports no finding for the
885
+ pricing page, and the built page's JSON-LD prices match the catalogue.
746
886
 
747
887
  ## Contribution to `llms.txt`
748
888
 
749
- Pricing authoring contributes the monetization summary for the pricing
750
- page entry in `website/src/content/llms.txt`.
751
-
752
- - Include the canonical pricing page link and a concise summary of the
753
- plan structure or purchase model.
754
- - Mention only stable pricing facts worth citation; if prices or tier
755
- names change, update `llms.txt` in the same edit.
756
- - Do not include temporary promotions, coupon copy, or locale-specific
757
- price tables in the file.
889
+ Pricing contributes the monetization summary for the pricing page entry in `website/src/content/llms.txt`: the
890
+ canonical pricing page link and a concise summary of the plan structure or purchase model. Mention only stable
891
+ pricing facts worth citation, and update `llms.txt` in the same edit when prices or plan names change; never
892
+ temporary promotions, coupon copy, or locale-specific price tables.
758
893
 
759
894
  ## Worked Example
760
895
 
761
- <!-- TIER C WAIVER: the framework's reference application, where Tier A anchors live, does not yet render its site's pricing from the billing catalogue (#1880); the journey-built scratch application that does is not an anchorable source, so there is no stable Tier A usage yet. This block IS the catalogue-driven contract the workflow above states: the route loads the catalogue and passes it to the island, the section reads it with `useWebsitePricingCatalog()` and never types a price, and `page-payloads.ts` publishes the offers through `buildWebsitePricingOfferStructuredData`. Replace with a Tier A anchor once a dogfood site carries it. -->
762
- ```tsx
763
- // website/src/pages/pricing.astro — frontmatter (the island receives the catalogue as a prop)
764
- const pricingCatalog = await loadWebsitePricingCatalog();
765
- const pagePayloads = (await resolveStructuredDataPagePayloadsForManifest(PRICING_PAGE_MANIFEST))
766
- .flatMap((entry) => entry.payloads);
767
- const structuredDataHtml = renderPageStructuredData({ sections: PRICING_SECTIONS, pagePayloads });
768
- // …and in the body: <PricingBridgeIsland client:idle pricingCatalog={pricingCatalog} … />
769
-
770
- // website/src/structured-data/page-payloads.ts — what `wildo website audit` reads
771
- export async function resolveStructuredDataPagePayloadsForManifest(manifest: { ref: string }) {
772
- if (manifest.ref !== 'pricing') return [];
773
- const catalog = await loadWebsitePricingCatalog();
774
- return [{
775
- pageRef: 'pricing',
776
- payloads: buildWebsitePricingOfferStructuredData({
777
- catalog,
778
- itemOfferedId: SCHEMA_ORG_IDS.softwareApplication,
779
- aggregateOfferIdPrefix: `${MARKETING_SITE_URL}/pricing#plans`, // each group appends what it aggregates
780
- url: `${MARKETING_SITE_URL}/pricing`,
781
- perUnitName: 'member', // required when a published plan is priced per unit
782
- }),
783
- }];
784
- }
896
+ <!-- TIER C WAIVER: no anchored application usage composes `WebsitePricing`; the framework's reference application wraps it in site-local helpers that are not anchored. These blocks show the contract the workflow states: the site's words per catalogue plan in one kit constant, each feature line naming its grant and an on-request plan carrying its own `link`; the pricing page's PLANS section declaring the statements its catalogue needs in one options constant passed to the block and to `websitePricingSlots(...)`, with its band and intro composed by hand because pricing is the one section not configured as a block; the `offer.unit` word the offers read; and (in `examples/pricing-offers.example.md`) `page-payloads.ts` building the offers from the catalogue in one function of the page they are published on. Replace with a Tier A anchor once an application's pricing sections and offers are anchored. -->
897
+ ```ts
898
+ // website/src/sections/kit/pricing-words.ts
899
+ import { WebsiteMenuLinkKind, type WebsitePricingPlanWords } from '@wildo-ai/saas-website';
785
900
 
786
- // website/src/sections/pricing.sections.tsx — the section renders the catalogue, never a copy
787
- function PricingPlans() {
788
- const { plans } = useWebsitePricingCatalog();
789
- return (
790
- <ul className="pricing__plans">
791
- {plans.map((plan) => <PricingPlanTile key={plan.key} plan={plan} />)}
792
- </ul>
793
- );
794
- }
901
+ /**
902
+ * The site's words per catalogue plan, by the plan's catalogue key: never a price, and never which plans are sold.
903
+ * Each feature line names the GRANT it describes (a feature or limit id of the plan's product), and the block refuses
904
+ * a line its plan does not grant. A plan's `link` replaces sign-up as its call to action. Shared by every page that
905
+ * shows the plans, so their words cannot disagree.
906
+ */
907
+ export const PRICING_PLAN_WORDS: readonly WebsitePricingPlanWords[] = [
908
+ { key: 'starter', features: [{ ref: 'projects', grant: 'MAX_PROJECTS' }] },
909
+ {
910
+ key: 'team',
911
+ features: [
912
+ { ref: 'projects', grant: 'MAX_PROJECTS' },
913
+ { ref: 'sso', grant: 'SINGLE_SIGN_ON' },
914
+ ],
915
+ },
916
+ // Priced on request: its call to action goes to the contact page, not to sign-up.
917
+ { key: 'enterprise', features: [{ ref: 'audit-export', grant: 'AUDIT_EXPORT' }], link: { kind: WebsiteMenuLinkKind.PAGE, routePath: '/contact' } },
918
+ ];
919
+
920
+ export const PRICING_PAGE = { kind: WebsiteMenuLinkKind.PAGE, routePath: '/pricing' } as const;
921
+ ```
795
922
 
796
- function PricingPlanTile({ plan }: { plan: PublicPricingPlan }) {
797
- const name = useWebsiteLabel(`plan-${plan.key}.name`);
798
- const price = plan.prices.find((candidate) => candidate.isDefault) ?? plan.prices[0];
799
- const onRequest = plan.priceDisclosure === ProductPriceDisclosure.ON_REQUEST;
800
- const upcoming = plan.availability === ProductAvailability.UPCOMING;
923
+ ```tsx
924
+ // website/src/sections/pricing.sections.tsx
925
+ import type { ReactNode } from 'react';
926
+ import {
927
+ defineWebsiteBlockSection,
928
+ WebsiteBand,
929
+ WebsitePricing,
930
+ WebsitePricingLayout,
931
+ websitePricingSlots,
932
+ WebsitePricingStatement,
933
+ WebsiteSectionCategory,
934
+ WebsiteSectionIntro,
935
+ websiteSectionIntroSlots,
936
+ } from '@wildo-ai/saas-website';
937
+
938
+ import { PRICING_PLAN_WORDS } from './kit/pricing-words';
939
+
940
+ /**
941
+ * What this catalogue's prices need words for, read from its plans: a floor, a per-member price, a plan on request, a
942
+ * trial, an announced plan. `periods` keeps the PLANS default (a month and a year), which also declares the switch.
943
+ * If the catalogue changes, the block names the statement or period it now needs.
944
+ */
945
+ const PRICING = {
946
+ layout: WebsitePricingLayout.PLANS,
947
+ plans: PRICING_PLAN_WORDS,
948
+ statements: [
949
+ WebsitePricingStatement.STARTING_AT,
950
+ WebsitePricingStatement.PER_UNIT,
951
+ WebsitePricingStatement.ON_REQUEST,
952
+ WebsitePricingStatement.TRIAL,
953
+ WebsitePricingStatement.UPCOMING,
954
+ ],
955
+ note: true,
956
+ } as const;
957
+
958
+ function PricingPlans(): ReactNode {
801
959
  return (
802
- <li className={plan.isRecommended ? 'pricing__plan pricing__plan--recommended' : 'pricing__plan'}>
803
- <WebsiteHeading level={3} variant="card-title">{name}</WebsiteHeading>
804
- {!onRequest && price !== undefined && <PlanPrice plan={plan} price={price} />}
805
- {upcoming ? <ComingSoon /> : onRequest ? <ContactSales /> : <StartCta planKey={plan.key} />}
806
- </li>
960
+ <WebsiteBand>
961
+ <WebsiteSectionIntro />
962
+ <WebsitePricing {...PRICING} />
963
+ </WebsiteBand>
807
964
  );
808
965
  }
809
966
 
810
- export const PRICING_PLANS_SECTION = defineWebsiteSection({
967
+ export const PRICING_PLANS_SECTION = defineWebsiteBlockSection({
968
+ pageRef: 'pricing',
811
969
  sectionRef: 'pricing-plans',
812
970
  category: WebsiteSectionCategory.PRICING,
971
+ // The block's words, plus `offer.unit`: the NOUN the page's offers publish as a per-unit price's unit ("member").
972
+ slots: [...websiteSectionIntroSlots(), ...websitePricingSlots(PRICING), 'offer.unit'],
813
973
  Component: PricingPlans,
814
- // The application the plans sell; its OFFERS are published by page-payloads.ts from the catalogue.
815
- getStructuredData: () => ({
974
+ // The application the plans sell, at the site-wide `@id` the offers name as `itemOffered`; its OFFERS are
975
+ // published by page-payloads.ts. A proper name and Schema.org values, so no word is read.
976
+ getStructuredData: ({ siteOrigin }) => ({
816
977
  '@type': 'SoftwareApplication',
817
- '@id': SCHEMA_ORG_IDS.softwareApplication,
978
+ '@id': `${siteOrigin}/#software-application`,
818
979
  name: 'Example Application',
819
980
  applicationCategory: 'BusinessApplication',
820
981
  operatingSystem: 'Web',
@@ -822,115 +983,118 @@ export const PRICING_PLANS_SECTION = defineWebsiteSection({
822
983
  });
823
984
  ```
824
985
 
825
- The label keys a catalogue-driven section needs are known only once the catalogue is: list them from
826
- the same plans in the page's `expectedLabelKeys` (`plan-<key>.name` / `.pitch` / `.cta` for each
827
- public plan), so a plan added to the catalogue without copy fails the label-pack audit instead of
828
- rendering a raw key.
986
+ The offers come from one function of the page they are published on, called by the route and, once per locale,
987
+ by the audit: follow `examples/pricing-offers.example.md` for `website/src/structured-data/page-payloads.ts` and the
988
+ pricing route's frontmatter.
989
+
990
+ A home page's teaser is the same shape with its own options constant — `{ layout: WebsitePricingLayout.TEASER, plans:
991
+ PRICING_PLAN_WORDS, pricingPage: PRICING_PAGE, statements: [...] }`, the same statements minus `TRIAL`, which a
992
+ teaser does not show — passed to the block and to `websitePricingSlots(...)`, and no `getStructuredData`. None of
993
+ these files holds a price, a plan list, a currency or a sign-up URL: the block reads them from the catalogue.
829
994
 
830
995
  ## Structured-data contract
831
996
 
832
997
  What a pricing page emits:
833
998
 
834
- - `SoftwareApplication` — the application itself, the usual case for a
835
- Wildo site — from the section's `getStructuredData()`.
836
- - `Product` instead, only when the plans sell a discrete good rather
837
- than the application.
838
- - One `AggregateOffer` per currency, with an `Offer` per plan whose price
839
- may be published, from `buildWebsitePricingOfferStructuredData` as a
840
- page-level payload — top-level, so the audit checks it, linked to the
841
- application by `itemOffered.@id`.
842
-
843
- Keep `FAQPage` in a sibling FAQ section (`website-section-faq`) and
844
- `Organization` / `WebSite` in the landing page's hero
845
- (`website-section-hero`). Nothing rejects them here — the audit checks
846
- each payload against the Schema.org catalog, never against the
847
- section's category — so the split is yours to keep.
999
+ - `SoftwareApplication` — the application itself, the usual case for a Wildo site — from the PLANS section's
1000
+ `getStructuredData()`.
1001
+ - `Product` instead, only when the plans sell a discrete good rather than the application.
1002
+ - One `AggregateOffer` per currency, amount basis and recurrence (plans that differ in any of them are separate
1003
+ groups), with an `Offer` per plan whose price may be published, from `buildWebsitePricingOfferStructuredData` as a
1004
+ page-level payload — top-level, so the audit checks it, linked to the application by `itemOffered.@id`.
1005
+
1006
+ Keep `FAQPage` in a sibling FAQ section (`website-section-faq`) and `Organization` / `WebSite` in the landing page's
1007
+ hero (`website-section-hero`). Nothing rejects them here — the audit checks each payload against the Schema.org
1008
+ catalog, never against the section's category — so the split is yours to keep.
848
1009
 
849
1010
  ## Catalog integration (AEO)
850
1011
 
851
- Every type above is in the installed Schema.org catalog. The
852
- structured-data audit (`wildo website audit`) checks the required
853
- fields of each TOP-LEVEL payload a section or `page-payloads.ts` returns —
854
- and only those. The `AggregateOffer` the offer builder returns is top-level,
855
- so the audit checks it; an `Offer` nested in its `offers` is not checked,
856
- which is one reason the builder, not hand-written JSON-LD, writes them:
857
-
858
- - `SOFTWARE_APPLICATION_CATALOG_ENTRY` (required: `name`,
859
- `applicationCategory`, `operatingSystem`).
860
- - `PRODUCT_CATALOG_ENTRY` (required: `name`, `description`).
861
- - `AGGREGATE_OFFER_CATALOG_ENTRY` (required: `lowPrice`,
862
- `priceCurrency`, `offerCount`; `recommendOptionals: true`, so a
863
- top-level one missing `highPrice` is listed as a recommendation —
864
- information, never a finding).
865
- - For single-tier pricing, swap `AggregateOffer` for a single
866
- `Offer` (`OFFER_CATALOG_ENTRY`; required: `price` +
867
- `priceCurrency`).
868
-
869
- The page shell wires emission through the installed structured-data contract —
870
- the section returns its payload (or a tuple of payloads) and the renderer
871
- emits one `<script type="application/ld+json">` block per payload
872
- (NOT a single `@graph`, see the renderer's preamble). The companion's
873
- reconciliation surface validates each payload against the catalog and
874
- warns on drift (warning-only per D-AG4).
875
-
876
- **What earns its place in this section's emission**:
877
-
878
- - A `SoftwareApplication` payload with `name`, `applicationCategory`
879
- and `operatingSystem` (required) — or a `Product` with `name` +
880
- `description` when the plans sell a discrete good.
881
- - The `AggregateOffer` the offer builder returns, referencing the
882
- application by `itemOffered.@id` — `lowPrice` / `highPrice` /
883
- `priceCurrency` / `offerCount` and one `Offer` per publishable plan,
884
- all computed from the catalogue.
885
-
886
- **What is NOT in this emission**:
887
-
888
- - Page-level entities (`WebSite`, `Organization`) — emitted once by
889
- the hero / page-shell.
890
- - App overrides of a catalog entry (e.g. requiring `gtin` on
891
- `Product`) — those live in the app's
892
- `_catalogs/schema-org/<type>.catalog-spec.ts`, NOT in the section's
893
- emission.
894
-
895
- **Verification grep** (run from the app root):
896
-
897
- | Invariant | Command |
898
- |---|---|
899
- | Section emits the application | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
900
- | Offers are derived, never typed | `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts` (must return ≥1) |
1012
+ Every type above is in the installed Schema.org catalog, and `wildo website audit` checks the required fields of
1013
+ each TOP-LEVEL payload a section or `page-payloads.ts` returns — and only those. The builder's `AggregateOffer` is
1014
+ top-level, so the audit checks it; an `Offer` nested in its `offers` is not, which is one reason the builder, not
1015
+ hand-written JSON-LD, writes them. Required fields: `SOFTWARE_APPLICATION_CATALOG_ENTRY` (`name`,
1016
+ `applicationCategory`, `operatingSystem`); `PRODUCT_CATALOG_ENTRY` (`name`, `description`);
1017
+ `AGGREGATE_OFFER_CATALOG_ENTRY` (`lowPrice`, `priceCurrency`, `offerCount`; a missing `highPrice` is listed as a
1018
+ recommendation, never a finding); `OFFER_CATALOG_ENTRY` for single-tier pricing (`price`, `priceCurrency`). The
1019
+ renderer emits one `<script type="application/ld+json">` block per payload (not a single `@graph`), and
1020
+ `wildo website audit --strict` fails on drift. Overrides of a catalog entry live in the app's
1021
+ `_catalogs/schema-org/<type>.catalog-spec.ts`, never in the section's emission.
901
1022
 
902
1023
  ## References
903
1024
 
1025
+ - `references/framework-website-pricing-api.md` — source-backed `WebsitePricing`, `websitePricingSlots`, the
1026
+ catalogue's disclosure and availability vocabularies, intro and section-slot contracts.
1027
+ - `references/framework-pricing-catalog-api.md` — source-backed catalogue loader, `useWebsitePricingCatalog()` and
1028
+ offer builder.
904
1029
  - `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
905
- - `references/framework-pricing-catalog-api.md` — source-backed catalogue loader, `useWebsitePricingCatalog()` and offer builder.
1030
+ - `examples/pricing-offers.example.md` — the page's offers built from the catalogue in `page-payloads.ts`, and the
1031
+ route that renders them with the page's context.
1032
+ - `../website-building-blocks/references/framework-website-blocks-api.md` — every block and the stylesheet's hooks.
906
1033
 
907
1034
  ## Verification
908
1035
 
909
1036
  - [ ] `category: WebsiteSectionCategory.PRICING` (typed enum).
910
- - [ ] The website holds no price: every amount, currency and recurrence comes from
911
- `useWebsitePricingCatalog()` (render) and `buildWebsitePricingOfferStructuredData` (JSON-LD).
912
- - [ ] The route loads the catalogue and passes it to the island as `pricingCatalog`.
913
- - [ ] All copy comes from `useWebsiteLabel`, keyed by the plan's catalogue `key`.
1037
+ - [ ] The section composes `WebsitePricing` on a `WebsiteBand` — no hand-built plan cards.
1038
+ - [ ] It is declared with `defineWebsiteBlockSection`, its band and intro composed by hand, its slots adding
1039
+ `websiteSectionIntroSlots(...)` with the options the intro renders.
1040
+ - [ ] The website holds no price: every amount, currency and cadence comes from the catalogue, through the block
1041
+ (render) and `buildWebsitePricingOfferStructuredData` (JSON-LD).
1042
+ - [ ] Every route whose page shows plans loads the catalogue and passes it to the island as `pricingCatalog`.
1043
+ - [ ] The site's words per plan are one kit constant keyed by catalogue plan key, and every feature line names a
1044
+ grant its plan grants.
1045
+ - [ ] The block's options are one constant passed to `WebsitePricing` and `websitePricingSlots(...)`, declaring the
1046
+ `statements` and `periods` the catalogue's prices need, and no others; the page renders without the block
1047
+ refusing a price.
914
1048
  - [ ] A recommended plan is worded as a recommendation, never as popularity.
915
- - [ ] A starting price reads as one, an on-request plan shows no price, an upcoming plan has no
916
- sign-up action.
917
- - [ ] Every plan's CTA `href` flows through the cross-frontend handoff carrier (see
918
- `website-anonymous-session`).
1049
+ - [ ] No sign-up URL is typed: the call to action is `signUp` (the application's sign-up by default) or a plan's own
1050
+ `link`, and a plan priced on request carries a `link` to where a quote is asked for.
1051
+ - [ ] The offers are built by one function of the page they are published on (`pageUrl`, `siteOrigin`, its pack):
1052
+ the route calls it with `runtime.structuredData`, the audit once per locale, and no origin is typed.
919
1053
 
920
1054
  ### Grep invariants
921
1055
 
922
- | Invariant | Command |
923
- |---|---|
924
- | Factory used | `rg -n "defineWebsiteSection" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
925
- | Plans read from the catalogue | `rg -n "useWebsitePricingCatalog" website/src/sections/<page>.sections.tsx` (must return ≥1) |
926
- | No typed price in the website | see the commands below the table (must return 0) |
927
- | Catalogue passed to the island | `rg -n "pricingCatalog=" website/src/pages/pricing.astro` (must return ≥1) |
928
- | Offers derived | `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts` (must return ≥1) |
929
- | Audit passes | `wildo website audit --strict` (no finding for the pricing page) |
1056
+ `npx astro check` in `website/` must pass. Then, from the app root:
930
1057
 
931
1058
  ```bash
932
- # No typed price in the website — (must return 0)
933
- rg -n "priceCurrency|amountMonthly|monthlyPrice" website/src/sections website/src/pages-impl
1059
+ # The section composes the engine's block (must return >= 1)
1060
+ rg -n "<WebsitePricing\b" website/src/sections
1061
+
1062
+ # Its slots come from the block's slot helper (must return >= 1)
1063
+ rg -n "websitePricingSlots\(" website/src/sections
1064
+
1065
+ # Declared by hand with the PRICING category (must return >= 1; every other section on the page is a configured block)
1066
+ rg -U -n "defineWebsiteBlockSection\(\{[^}]*PRICING" website/src/sections
1067
+
1068
+ # Every feature line names its grant (each hit must be a feature or limit id of that plan's product)
1069
+ rg -n "grant: '" website/src/sections
1070
+
1071
+ # What the catalogue's prices need, to check the declared statements and periods against (read each plan)
1072
+ rg -n "priceDisclosure|availability|amountBasis|trialDays|recurrence" shared-lib/src
1073
+
1074
+ # The statements and periods the sections declare (compare with the line above)
1075
+ rg -n "WebsitePricingStatement\.|periods:" website/src/sections
1076
+
1077
+ # No typed price in the website (must return 0)
1078
+ rg -n 'priceCurrency|amountMonthly|monthlyPrice|[$€£][0-9]' website/src/sections website/src/pages-impl
1079
+
1080
+ # No typed application URL (must return empty: the call to action is a WebsiteLinkTo)
1081
+ rg -n "https?://[^'\"]*(sign-?up|register)" website/src/sections
1082
+
1083
+ # No popularity claim in the packs (must return empty)
1084
+ rg -n -i "most popular|best seller" website/src/i18n/
1085
+
1086
+ # Catalogue passed to the island (must return >= 1 per route whose page shows plans)
1087
+ rg -n "pricingCatalog" website/src/pages
1088
+
1089
+ # Route passes the page context (must print nothing; a call wrapped over several lines prints its first line too, so open it and check)
1090
+ rg -n "renderPageStructuredData\(\{" website/src/pages --glob '*.astro' | rg -v "context:"
1091
+
1092
+ # Offers derived, never typed, and no origin typed into them (the first >= 1, the second empty)
1093
+ rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/
1094
+ rg -n "['\"]https?://" website/src/structured-data/
1095
+
1096
+ # Audit passes (no finding for the pricing page)
1097
+ wildo website audit --strict
934
1098
  ```
935
1099
 
936
1100
  ## Common Rationalizations
@@ -939,32 +1103,39 @@ rg -n "priceCurrency|amountMonthly|monthlyPrice" website/src/sections website/sr
939
1103
  |---|---|
940
1104
  | "I'll skip JSON-LD; we don't care about SEO yet" | Pricing JSON-LD is a 10-minute investment with disproportionate SERP / AEO upside. Ship it from day one — the offer builder makes it one call. |
941
1105
  | "It is quicker to type the three prices here" | It is quicker once. Every later price change then lands in the backend and not on the site, and nothing reports the divergence — a site built that way went on advertising a tier its own catalogue did not sell. |
1106
+ | "I'll build the plan cards myself to add a contact-sales button" | The copy stops following the catalogue, the cadence switch and every fix. Give the plan's words a `link` to the contact page. |
1107
+ | "I'll declare every statement, just in case" | Each one is a word the label audit then demands in every locale, for a price nobody shows. Declare what the catalogue needs; the block names anything missing. |
1108
+ | "I'll write 'per member' in the summary" | The catalogue says the price is per unit, and the block says it after the period from `price.per-unit`. A copy in the summary goes stale the day the basis changes. |
1109
+ | "This feature is coming, I'll list it on the Team plan" | The block refuses a line whose grant the plan does not have. Add the grant to the catalogue, or leave the line out. |
942
1110
  | "This plan's price is not settled, I'll hide it in the website" | That is a fact about the offer, so it belongs in the catalogue: `priceDisclosure: STARTING_AT` or `ON_REQUEST`. The in-app pricing table needs the same answer. |
943
- | "Mark the middle plan 'most popular'" | Nothing measured it. `isRecommended` states a recommendation, and the label must say so. |
944
- | "Currency is implicit (USD)" | The catalogue carries the currency on every price, and the offer builder publishes it; never restate it. |
945
- | "Each plan should be its own `defineWebsiteSection` instance" | A pricing band is ONE section that renders N plans. Per-plan sections fragment the analytics funnel-step grouping (`data-section-category="pricing"` would appear N times) and force the page manifest to enumerate what the catalogue already lists. |
1111
+ | "Mark the middle plan 'most popular'" | Nothing measured it. `isRecommended` states a recommendation, and the word must say so. |
1112
+ | "I'll configure pricing like the other blocks, `websitePricingBlock.section(...)`" | There is no such block: the section's words follow the plans the catalogue publishes, which reach the block only at render. Declare the options once, pass them to the block and to `websitePricingSlots(...)`, and let the block name what the catalogue needs. |
1113
+ | "Each plan should be its own section" | A pricing band is ONE section that renders N plans. Per-plan sections fragment the analytics funnel-step grouping and force the page to enumerate what the catalogue already lists. |
946
1114
 
947
1115
  ## Red Flags
948
1116
 
949
- - A price in JSX or a sections file (`$12/mo`, `monthlyPrice: 12`) — a second copy of the catalogue;
950
- catch with the "No typed price" grep above.
951
- - A tier list keyed by names the catalogue does not declare — the site then sells plans the backend
952
- does not; catch with the "Plans read from the catalogue" grep above.
953
- - Hand-written `Offer` JSON-LD — it publishes starting prices and on-request plans as offers; catch
954
- with the "Offers derived" grep above.
955
- - Plan CTAs pointing directly at `app.example.com/signup?plan=team` with no anonymous-session
956
- handoff — first-touch + plan attribution is lost.
957
- - A `getStructuredData()` that calls a hook — it is a pure function invoked outside the React graph
958
- at build time.
1117
+ - Hand-built plan cards instead of `WebsitePricing` — catch with the "composes the engine's block" grep above.
1118
+ - A price in JSX or a sections file (`$12/mo`, `monthlyPrice: 12`) — a second copy of the catalogue; catch with the
1119
+ "No typed price" grep above.
1120
+ - A feature line naming a grant its plan does not have — the block throws at render; catch it first with the grant
1121
+ grep above, read against the catalogue.
1122
+ - A price the section has no word for (a floor, a per-unit basis, a trial, a yearly-only plan) — the block refuses it
1123
+ and names what to declare; catch it first with the two catalogue-against-statements greps above.
1124
+ - An on-request plan whose call to action goes to sign-up — catch by reading each `ON_REQUEST` plan's words for a
1125
+ `link`, with the statements grep above.
1126
+ - A typed sign-up URL — catch with the "No typed application URL" grep above.
1127
+ - "Most popular" in a pack — catch with the popularity grep above.
1128
+ - Hand-written `Offer` JSON-LD, or one offer URL for every locale — catch with the "Offers derived" greps above.
1129
+ - A route that shows plans without passing `pricingCatalog`, or calls `renderPageStructuredData` without `context` —
1130
+ catch with the two route greps above.
959
1131
 
960
1132
  ## Related Skills
961
1133
 
962
- - `website-page-authoring` — composing this section into the pricing
963
- page manifest.
1134
+ - `website-building-blocks` — how every other block is configured as a section, the band and intro this section
1135
+ composes by hand, and how a block is adjusted without forking.
1136
+ - `website-page-authoring` — composing this section into the pricing page manifest.
964
1137
  - `website-label-pack` — authoring plan copy across locales.
965
- - `configure-billing` — the billing catalogue the plans and prices come from.
966
- - `website-section-faq` — the standard FAQ companion section
967
- (questions about pricing, billing, plan changes).
968
- - `website-anonymous-session` — handoff carrier for tier CTAs.
969
- - `website-seo-aeo-geo` — broader SEO / AEO / GEO posture, including
970
- page-level meta + canonical.
1138
+ - `configure-billing` — the billing catalogue the plans, prices and grants come from.
1139
+ - `website-section-faq` — the standard FAQ companion section (questions about pricing, billing, plan changes).
1140
+ - `website-anonymous-session` — the cookie that carries the visitor's anonymous session into the application.
1141
+ - `website-seo-aeo-geo` — broader SEO / AEO / GEO posture, including page-level meta + canonical.