@wildo-ai/framework-knowledge 1.1.10 → 1.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +7 -5
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +628 -107
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +10 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +82 -15
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -5
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +4 -16
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +38 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +20 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +6 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +7 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +9 -7
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +9 -2
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +15 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +24 -9
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +98 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +39 -20
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +788 -49
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +115 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +67 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -5
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +153 -28
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +49 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +15 -5
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +8 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +216 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +21 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +28 -2
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
- package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +342 -76
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +47 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +127 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +28 -8
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +94 -13
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
- package/dist/knowledge/references/platform.config.saas.md +126 -32
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +105 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +7 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
- package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
- package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +280 -40
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
- package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +123 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +22 -4
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
- package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +303 -0
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/website-plan.config.md +544 -32
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +5250 -2565
- package/dist/knowledge/registries/playbooks.json +88 -55
- package/dist/knowledge/registries/source-tags.json +9347 -4807
- package/dist/knowledge/rules/database-migration-obligation.md +10 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +62 -33
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +26 -9
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +37 -1
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +168 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +66 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +166 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +21 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -10
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +47 -6
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +10 -2
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +93 -13
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +140 -7
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +7 -5
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +13 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +72 -8
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +165 -44
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +200 -61
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +8 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +21 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +46 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +4 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +219 -77
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +223 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +138 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +30 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +186 -83
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +113 -70
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +41 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +15 -4
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17998 -8568
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -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 —
|
|
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 `
|
|
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`
|
|
30
|
-
free string. Adding a new value requires
|
|
31
|
-
`
|
|
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
|
|
72
|
-
* `
|
|
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
|
|
109
|
-
|
|
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 (
|
|
123
|
-
*
|
|
124
|
-
*
|
|
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
|
|
130
|
-
* `design-philosophy.mdc`):
|
|
149
|
+
* **Shape rationale** (each field carries semantic weight):
|
|
131
150
|
*
|
|
132
|
-
* - `sectionRef` — the section's identity
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
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.
|
|
141
|
-
*
|
|
142
|
-
*
|
|
143
|
-
*
|
|
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.
|
|
167
|
-
*
|
|
168
|
-
*
|
|
169
|
-
*
|
|
170
|
-
*
|
|
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
|
|
174
|
-
*
|
|
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
|
|
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
|
-
*
|
|
212
|
-
* `ComponentType<unknown>` (because a caller could pass
|
|
213
|
-
* the narrower component cannot accept).
|
|
214
|
-
*
|
|
215
|
-
*
|
|
216
|
-
*
|
|
217
|
-
*
|
|
218
|
-
*
|
|
219
|
-
*
|
|
220
|
-
*
|
|
221
|
-
*
|
|
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 (
|
|
239
|
-
*
|
|
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
|
-
##
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
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
|
-
*
|
|
267
|
-
*
|
|
268
|
-
*
|
|
269
|
-
*
|
|
270
|
-
*
|
|
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;
|
|
290
|
-
*
|
|
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
|
|
297
|
-
*
|
|
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
|
|
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.
|
|
323
|
-
*
|
|
324
|
-
*
|
|
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
|
|
333
|
-
* `
|
|
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
|
|
340
|
-
* preserved at the precise prop type.
|
|
413
|
+
* @returns a `TypedWebsiteSectionDefinition` whose `Component` takes no props.
|
|
341
414
|
*
|
|
342
415
|
* @example
|
|
343
|
-
*
|
|
344
|
-
*
|
|
345
|
-
*
|
|
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
|
|
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
|
|
374
|
-
*
|
|
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
|
|
392
|
-
|
|
393
|
-
`expectedLabelKeys
|
|
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
|
|
416
|
-
*
|
|
417
|
-
*
|
|
418
|
-
*
|
|
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 (`
|
|
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** —
|
|
509
|
-
*
|
|
510
|
-
*
|
|
511
|
-
*
|
|
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
|
|
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
|
|
523
|
-
*
|
|
524
|
-
*
|
|
525
|
-
*
|
|
526
|
-
*
|
|
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
|
|
554
|
-
*
|
|
555
|
-
*
|
|
556
|
-
*
|
|
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
|
|
561
|
-
* (`<HeroSection
|
|
562
|
-
* sections that don't justify a
|
|
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
|
|
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,318 +697,448 @@ WebsiteSection.displayName = 'WebsiteSection';
|
|
|
619
697
|
```
|
|
620
698
|
|
|
621
699
|
|
|
622
|
-
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships
|
|
623
|
-
>
|
|
624
|
-
>
|
|
625
|
-
>
|
|
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
|
|
630
|
-
|
|
631
|
-
of included capabilities, and a CTA (sign up, contact sales, etc.).
|
|
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.
|
|
632
726
|
|
|
633
|
-
The pricing section is one of the few categories where **structured
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
improves SERP rendering AND lets answer-engine LLMs cite pricing
|
|
637
|
-
without hallucinating.
|
|
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.
|
|
638
730
|
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
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
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
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
|
-
|
|
660
|
-
|
|
661
|
-
|
|
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
|
-
|
|
|
669
|
-
|
|
|
670
|
-
| The route: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` |
|
|
671
|
-
|
|
|
672
|
-
|
|
|
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, or the page helper every route calls: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` (and every route whose page shows plans), or the helper it calls (`website/src/*.ts`) |
|
|
756
|
+
| The offers of one page (called by the route), and the per-locale payloads the audit reads | `website/src/structured-data/**` (e.g. `page-payloads.ts`) |
|
|
757
|
+
| This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
|
|
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
|
-
-
|
|
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
|
-
|
|
683
|
-
|
|
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
|
|
690
|
-
|
|
691
|
-
|
|
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
|
|
696
|
-
`@wildo-ai/saas-website/config-loader`; pass `targetScope` when the catalogue sells to more than one
|
|
697
|
-
|
|
698
|
-
|
|
795
|
+
In the route's frontmatter, or in the page helper every route calls, `await loadWebsitePricingCatalog()` (from
|
|
796
|
+
`@wildo-ai/saas-website/config-loader`; pass `targetScope` when the catalogue sells to more than one audience) and pass
|
|
797
|
+
the result to the bridge island as `pricingCatalog`. Load it once per build and share it: it costs seconds. 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 under
|
|
865
|
+
`website/src/structured-data/`, from that page's locale, its `labelPack` and the site's origin, and call it from both
|
|
866
|
+
readers: the route (or its page helper) renders it through `renderPageStructuredData({ sections, context:
|
|
867
|
+
runtime.structuredData, pagePayloads })`, and `resolveStructuredDataPagePayloadsForManifest` returns it once per
|
|
868
|
+
locale, each at that locale's route, for the audit. The origin is the site's ONE declared origin, the page context's
|
|
869
|
+
`siteOrigin` or the constant the website config declares as `publicOrigin`, never a literal in the offers function;
|
|
870
|
+
and every URL goes through the localized route (`buildLocalizedRoutePath`). With one URL written for every locale, the
|
|
871
|
+
French page publishes the default-locale page's URL.
|
|
872
|
+
|
|
873
|
+
The `SoftwareApplication` the offers name as `itemOffered`, at `${siteOrigin}/#software-application`, carries no
|
|
874
|
+
price, and where it is emitted is the site's choice: from the PLANS section's own `getStructuredData()` (which reads
|
|
875
|
+
`siteOrigin` from the page context it receives, and a word such as a `description` through `label('<slot>')`, in the
|
|
876
|
+
page's locale), or page-wide beside the offers. A teaser section emits nothing of its own.
|
|
877
|
+
|
|
878
|
+
### Step 8: Make it this site's own without forking the block
|
|
879
|
+
|
|
880
|
+
In this order: the theme, the props above, the block's `motion` prop (keyed by `WebsitePricingMotionPoint.PLANS`,
|
|
881
|
+
or `null` to keep the plans from staggering in), and last an ordinary CSS rule on a hook
|
|
882
|
+
(`[data-website-block='pricing'] [data-website-recommended]`). The block's CSS is in the `wildo-website` cascade
|
|
883
|
+
layer, so an unlayered site rule wins without `!important`; read colours from the current tone, never a hex.
|
|
884
|
+
|
|
885
|
+
**Stop** after the plans render from the catalogue, `wildo website audit --strict` reports no finding for the
|
|
886
|
+
pricing page, and the built page's JSON-LD prices match the catalogue.
|
|
699
887
|
|
|
700
|
-
|
|
888
|
+
## Contribution to `llms.txt`
|
|
701
889
|
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
`
|
|
890
|
+
Pricing contributes the monetization summary for the pricing page entry in `website/src/content/llms.txt`: the
|
|
891
|
+
canonical pricing page link and a concise summary of the plan structure or purchase model. Mention only stable
|
|
892
|
+
pricing facts worth citation, and update `llms.txt` in the same edit when prices or plan names change; never
|
|
893
|
+
temporary promotions, coupon copy, or locale-specific price tables.
|
|
705
894
|
|
|
706
|
-
|
|
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).
|
|
895
|
+
## Worked Example
|
|
746
896
|
|
|
747
|
-
|
|
897
|
+
The worked example is a site that renders its pricing from its billing catalogue. Its kit holds
|
|
898
|
+
the site's words per catalogue plan (`PLANS`, by each plan's catalogue key), and each feature line names the GRANT it
|
|
899
|
+
describes, so the block refuses a line its plan does not grant. It also holds the statements its prices need words for
|
|
900
|
+
(here a trial) and the two blocks built from the same constants, the home page's teaser and the pricing page's plans.
|
|
901
|
+
Each options set goes to the block AND to `websitePricingSlots(...)`, so the label pack asks for exactly the words the
|
|
902
|
+
block reads:
|
|
748
903
|
|
|
749
|
-
Pricing authoring contributes the monetization summary for the pricing
|
|
750
|
-
page entry in `website/src/content/llms.txt`.
|
|
751
904
|
|
|
752
|
-
|
|
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.
|
|
905
|
+
## Usage Example
|
|
758
906
|
|
|
759
|
-
## Worked Example
|
|
760
|
-
|
|
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
907
|
```tsx
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
908
|
+
import type { ReactNode } from 'react';
|
|
909
|
+
|
|
910
|
+
import {
|
|
911
|
+
WebsiteMenuLinkKind,
|
|
912
|
+
WebsitePricing,
|
|
913
|
+
WebsitePricingLayout,
|
|
914
|
+
WebsitePricingStatement,
|
|
915
|
+
WebsiteSectionIntro,
|
|
916
|
+
websitePricingSlots,
|
|
917
|
+
websiteSectionIntroSlots,
|
|
918
|
+
type WebsitePricingPlanWords,
|
|
919
|
+
} from '@wildo-ai/saas-website';
|
|
920
|
+
|
|
921
|
+
/**
|
|
922
|
+
* Pricing, from the billing catalogue the backend sells from (`shared-lib/src/engine/product.ts`, delivered by the
|
|
923
|
+
* route as `pricingCatalog`), on the engine's `WebsitePricing` block. A price is never a label: amounts, currency,
|
|
924
|
+
* cadence, trial length and the recommended plan all come from the catalogue.
|
|
925
|
+
*
|
|
926
|
+
* `PLANS` is the site's words per catalogue plan: which plans it has words for, and what each feature line describes.
|
|
927
|
+
* A line names the GRANT it describes, and the block refuses a line its plan does not grant, so the page cannot promise
|
|
928
|
+
* what checkout does not sell. The grant ids are `ApplicationFeature` members of `shared-lib/src/engine/features.ts`,
|
|
929
|
+
* written as their wire values because the website does not depend on the shared library.
|
|
930
|
+
*
|
|
931
|
+
* The catalogue's `BULK_EXPORT`, `ADVANCED_REPORTS` and `CUSTOM_WORKFLOWS` grants gate no product behaviour yet, so no
|
|
932
|
+
* line names them; the add-ons are stated in the plans note.
|
|
933
|
+
*/
|
|
934
|
+
const PLANS: readonly WebsitePricingPlanWords[] = [
|
|
935
|
+
{ key: 'org-free', features: [{ ref: 'feature1', grant: 'MAX_TODO_LISTS' }] },
|
|
936
|
+
{ key: 'org-professional', features: [{ ref: 'feature1', grant: 'MAX_TODO_LISTS' }] },
|
|
937
|
+
{
|
|
938
|
+
key: 'org-enterprise',
|
|
939
|
+
features: [
|
|
940
|
+
{ ref: 'feature1', grant: 'MAX_TODO_LISTS' },
|
|
941
|
+
{ ref: 'feature2', grant: 'AI_ASSISTANT' },
|
|
942
|
+
],
|
|
943
|
+
},
|
|
944
|
+
];
|
|
945
|
+
|
|
946
|
+
/** Every plan is a flat price, monthly or yearly; the Professional plan offers a trial, which the cards state. */
|
|
947
|
+
const PLANS_STATEMENTS = [WebsitePricingStatement.TRIAL];
|
|
948
|
+
|
|
949
|
+
const PRICING_PAGE = { kind: WebsiteMenuLinkKind.PAGE, routePath: '/pricing' } as const;
|
|
950
|
+
|
|
951
|
+
/*
|
|
952
|
+
* One options constant per layout, passed whole to the block AND to `websitePricingSlots(...)`, so the words a section
|
|
953
|
+
* declares are exactly the words its block reads.
|
|
954
|
+
*/
|
|
955
|
+
const TEASER = { layout: WebsitePricingLayout.TEASER, plans: PLANS, pricingPage: PRICING_PAGE } as const;
|
|
956
|
+
const PLANS_PAGE = { layout: WebsitePricingLayout.PLANS, plans: PLANS, note: true, statements: PLANS_STATEMENTS } as const;
|
|
957
|
+
|
|
958
|
+
// ── TEASER (home page) ───────────────────────────────────────────────────────────────────────────────────────────────
|
|
959
|
+
|
|
960
|
+
export function pricingTeaserSlots(): string[] {
|
|
961
|
+
return [...websiteSectionIntroSlots(), ...websitePricingSlots(TEASER)];
|
|
784
962
|
}
|
|
785
963
|
|
|
786
|
-
|
|
787
|
-
function PricingPlans() {
|
|
788
|
-
const { plans } = useWebsitePricingCatalog();
|
|
964
|
+
export function PricingTeaserBlock(): ReactNode {
|
|
789
965
|
return (
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
966
|
+
<>
|
|
967
|
+
<WebsiteSectionIntro />
|
|
968
|
+
<WebsitePricing {...TEASER} />
|
|
969
|
+
</>
|
|
793
970
|
);
|
|
794
971
|
}
|
|
972
|
+
PricingTeaserBlock.displayName = 'WonderTodosPricingTeaserBlock';
|
|
973
|
+
|
|
974
|
+
// ── PLANS (pricing page) ─────────────────────────────────────────────────────────────────────────────────────────────
|
|
975
|
+
|
|
976
|
+
export function pricingPlansSlots(): string[] {
|
|
977
|
+
return [...websiteSectionIntroSlots(), ...websitePricingSlots(PLANS_PAGE)];
|
|
978
|
+
}
|
|
795
979
|
|
|
796
|
-
function
|
|
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;
|
|
980
|
+
export function PricingPlansBlock(): ReactNode {
|
|
801
981
|
return (
|
|
802
|
-
|
|
803
|
-
<
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
</li>
|
|
982
|
+
<>
|
|
983
|
+
<WebsiteSectionIntro />
|
|
984
|
+
<WebsitePricing {...PLANS_PAGE} />
|
|
985
|
+
</>
|
|
807
986
|
);
|
|
808
987
|
}
|
|
988
|
+
PricingPlansBlock.displayName = 'WonderTodosPricingPlansBlock';
|
|
989
|
+
```
|
|
990
|
+
|
|
991
|
+
The pricing page's PLANS section is the block in a band, with its intro composed by hand, because pricing is the one
|
|
992
|
+
section not configured as a block:
|
|
993
|
+
|
|
809
994
|
|
|
810
|
-
|
|
995
|
+
## Usage Example
|
|
996
|
+
|
|
997
|
+
```tsx
|
|
998
|
+
// The pricing page's PLANS section: the block, in a tinted band. Its JSON-LD (the application and its offers) is
|
|
999
|
+
// page-wide, built in `structured-data/page-structured-data.ts`, so the section itself publishes none.
|
|
1000
|
+
export const PRICING_PLANS_SECTION = defineWebsiteBlockSection({
|
|
1001
|
+
pageRef: PAGE_REF,
|
|
811
1002
|
sectionRef: 'pricing-plans',
|
|
812
1003
|
category: WebsiteSectionCategory.PRICING,
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
applicationCategory: 'BusinessApplication',
|
|
820
|
-
operatingSystem: 'Web',
|
|
821
|
-
}),
|
|
1004
|
+
slots: pricingPlansSlots(),
|
|
1005
|
+
Component: () => (
|
|
1006
|
+
<WebsiteBand tone={WebsiteSurfaceTone.TINTED}>
|
|
1007
|
+
<PricingPlansBlock />
|
|
1008
|
+
</WebsiteBand>
|
|
1009
|
+
),
|
|
822
1010
|
});
|
|
823
1011
|
```
|
|
824
1012
|
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
1013
|
+
Two shapes the worked example does not need, and how to write them:
|
|
1014
|
+
|
|
1015
|
+
- **A plan sold on request.** Give its `PLANS` entry a `link` (`{ kind: WebsiteMenuLinkKind.PAGE, routePath:
|
|
1016
|
+
'/contact' }`); the link replaces sign-up as its call to action, and the catalogue's on-request plan then needs
|
|
1017
|
+
`WebsitePricingStatement.ON_REQUEST` in the statements.
|
|
1018
|
+
- **A price per member, a floor, an announced plan.** Add `PER_UNIT`, `STARTING_AT` or `UPCOMING` to the statements.
|
|
1019
|
+
For a per-unit price, add the `offer.unit` slot to the section (the noun the offers publish as the unit, "member")
|
|
1020
|
+
and pass `perUnitName` to the offers builder. If the catalogue changes, the block names the statement or period it
|
|
1021
|
+
now needs.
|
|
1022
|
+
|
|
1023
|
+
Where the JSON-LD lives is the site's choice. The worked example publishes the application and its offers page-wide (next
|
|
1024
|
+
step), so its section returns no `getStructuredData`. A site that keeps the application on the section returns it from
|
|
1025
|
+
the PLANS section's `getStructuredData({ siteOrigin })`, at `${siteOrigin}/#software-application`, with no price.
|
|
1026
|
+
|
|
1027
|
+
The offers come from one function of the page they are published on, called by the route and, once per locale,
|
|
1028
|
+
by the audit: follow `examples/pricing-offers.example.md`.
|
|
1029
|
+
|
|
1030
|
+
A home page's teaser is the same shape with its own options (`layout: WebsitePricingLayout.TEASER`, the same plan
|
|
1031
|
+
words and a `pricingPage` link), the same statements minus `TRIAL`, which a teaser does not show, and no
|
|
1032
|
+
`getStructuredData`. None of these files holds a price, a plan list, a currency or a sign-up URL: the block reads them
|
|
1033
|
+
from the catalogue.
|
|
829
1034
|
|
|
830
1035
|
## Structured-data contract
|
|
831
1036
|
|
|
832
1037
|
What a pricing page emits:
|
|
833
1038
|
|
|
834
|
-
- `SoftwareApplication` — the application itself, the usual case for a
|
|
835
|
-
|
|
836
|
-
- `Product` instead, only when the plans sell a discrete good rather
|
|
837
|
-
|
|
838
|
-
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
each payload against the Schema.org catalog, never against the
|
|
847
|
-
section's category — so the split is yours to keep.
|
|
1039
|
+
- `SoftwareApplication` — the application itself, the usual case for a Wildo site — from the PLANS section's
|
|
1040
|
+
`getStructuredData()`, or page-wide beside the offers (as the worked example does).
|
|
1041
|
+
- `Product` instead, only when the plans sell a discrete good rather than the application.
|
|
1042
|
+
- One `AggregateOffer` per currency, amount basis and recurrence (plans that differ in any of them are separate
|
|
1043
|
+
groups), with an `Offer` per plan whose price may be published, from `buildWebsitePricingOfferStructuredData` as a
|
|
1044
|
+
page-level payload — top-level, so the audit checks it, linked to the application by `itemOffered.@id`.
|
|
1045
|
+
|
|
1046
|
+
Keep `FAQPage` in a sibling FAQ section (`website-section-faq`). `Organization` / `WebSite` belong to the landing
|
|
1047
|
+
page's hero (`website-section-hero`) or to page-wide payloads; a pricing page that publishes the application beside its
|
|
1048
|
+
offers also publishes the `Organization` the application names as publisher, so every `@id` it references is defined
|
|
1049
|
+
on the page. Nothing rejects them here — the audit checks each payload against the Schema.org
|
|
1050
|
+
catalog, never against the section's category — so the split is yours to keep.
|
|
848
1051
|
|
|
849
1052
|
## Catalog integration (AEO)
|
|
850
1053
|
|
|
851
|
-
Every type above is in the installed Schema.org catalog
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
-
|
|
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) |
|
|
1054
|
+
Every type above is in the installed Schema.org catalog, and `wildo website audit` checks the required fields of
|
|
1055
|
+
each TOP-LEVEL payload a section or `page-payloads.ts` returns — and only those. The builder's `AggregateOffer` is
|
|
1056
|
+
top-level, so the audit checks it; an `Offer` nested in its `offers` is not, which is one reason the builder, not
|
|
1057
|
+
hand-written JSON-LD, writes them. Required fields: `SOFTWARE_APPLICATION_CATALOG_ENTRY` (`name`,
|
|
1058
|
+
`applicationCategory`, `operatingSystem`); `PRODUCT_CATALOG_ENTRY` (`name`, `description`);
|
|
1059
|
+
`AGGREGATE_OFFER_CATALOG_ENTRY` (`lowPrice`, `priceCurrency`, `offerCount`; a missing `highPrice` is listed as a
|
|
1060
|
+
recommendation, never a finding); `OFFER_CATALOG_ENTRY` for single-tier pricing (`price`, `priceCurrency`). The
|
|
1061
|
+
renderer emits one `<script type="application/ld+json">` block per payload (not a single `@graph`), and
|
|
1062
|
+
`wildo website audit --strict` fails on drift. Overrides of a catalog entry live in the app's
|
|
1063
|
+
`_catalogs/schema-org/<type>.catalog-spec.ts`, never in the section's emission.
|
|
901
1064
|
|
|
902
1065
|
## References
|
|
903
1066
|
|
|
1067
|
+
- `references/framework-website-pricing-api.md` — source-backed `WebsitePricing`, `websitePricingSlots`, the
|
|
1068
|
+
catalogue's disclosure and availability vocabularies, intro and section-slot contracts.
|
|
1069
|
+
- `references/framework-pricing-catalog-api.md` — source-backed catalogue loader, `useWebsitePricingCatalog()` and
|
|
1070
|
+
offer builder.
|
|
904
1071
|
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
|
|
905
|
-
- `
|
|
1072
|
+
- `examples/pricing-offers.example.md` — the worked example's page offers built from the catalogue, the route's catalogue
|
|
1073
|
+
load, and the per-locale payloads the audit reads from the same function.
|
|
1074
|
+
- `../website-building-blocks/references/framework-website-blocks-api.md` — every block and the stylesheet's hooks.
|
|
906
1075
|
|
|
907
1076
|
## Verification
|
|
908
1077
|
|
|
909
1078
|
- [ ] `category: WebsiteSectionCategory.PRICING` (typed enum).
|
|
910
|
-
- [ ] The
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
- [ ]
|
|
1079
|
+
- [ ] The section composes `WebsitePricing` on a `WebsiteBand` — no hand-built plan cards.
|
|
1080
|
+
- [ ] It is declared with `defineWebsiteBlockSection`, its band and intro composed by hand, its slots adding
|
|
1081
|
+
`websiteSectionIntroSlots(...)` with the options the intro renders.
|
|
1082
|
+
- [ ] The website holds no price: every amount, currency and cadence comes from the catalogue, through the block
|
|
1083
|
+
(render) and `buildWebsitePricingOfferStructuredData` (JSON-LD).
|
|
1084
|
+
- [ ] Every route whose page shows plans (itself or through its page helper) loads the catalogue and passes it to the
|
|
1085
|
+
island as `pricingCatalog`.
|
|
1086
|
+
- [ ] The site's words per plan are one kit constant keyed by catalogue plan key, and every feature line names a
|
|
1087
|
+
grant its plan grants.
|
|
1088
|
+
- [ ] The block's options are one constant passed to `WebsitePricing` and `websitePricingSlots(...)`, declaring the
|
|
1089
|
+
`statements` and `periods` the catalogue's prices need, and no others; the page renders without the block
|
|
1090
|
+
refusing a price.
|
|
914
1091
|
- [ ] A recommended plan is worded as a recommendation, never as popularity.
|
|
915
|
-
- [ ]
|
|
916
|
-
|
|
917
|
-
- [ ]
|
|
918
|
-
|
|
1092
|
+
- [ ] No sign-up URL is typed: the call to action is `signUp` (the application's sign-up by default) or a plan's own
|
|
1093
|
+
`link`, and a plan priced on request carries a `link` to where a quote is asked for.
|
|
1094
|
+
- [ ] The offers are built by one function from the page's locale, its pack and the site's one declared origin: the
|
|
1095
|
+
route (or its page helper) calls it, the audit once per locale, every URL is localized, and no origin literal
|
|
1096
|
+
is typed in `website/src/structured-data/`.
|
|
919
1097
|
|
|
920
1098
|
### Grep invariants
|
|
921
1099
|
|
|
922
|
-
|
|
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) |
|
|
1100
|
+
`npx astro check` in `website/` must pass. Then, from the app root:
|
|
930
1101
|
|
|
931
1102
|
```bash
|
|
932
|
-
#
|
|
933
|
-
rg -n "
|
|
1103
|
+
# The section composes the engine's block (must return >= 1)
|
|
1104
|
+
rg -n "<WebsitePricing\b" website/src/sections
|
|
1105
|
+
|
|
1106
|
+
# Its slots come from the block's slot helper (must return >= 1)
|
|
1107
|
+
rg -n "websitePricingSlots\(" website/src/sections
|
|
1108
|
+
|
|
1109
|
+
# Declared by hand with the PRICING category (must return >= 1; every other section on the page is a configured block)
|
|
1110
|
+
rg -U -n "defineWebsiteBlockSection\(\{[^}]*PRICING" website/src/sections
|
|
1111
|
+
|
|
1112
|
+
# Every feature line names its grant (each hit must be a feature or limit id of that plan's product)
|
|
1113
|
+
rg -n "grant: '" website/src/sections
|
|
1114
|
+
|
|
1115
|
+
# What the catalogue's prices need, to check the declared statements and periods against (read each plan)
|
|
1116
|
+
rg -n "priceDisclosure|availability|amountBasis|trialDays|recurrence" shared-lib/src
|
|
1117
|
+
|
|
1118
|
+
# The statements and periods the sections declare (compare with the line above)
|
|
1119
|
+
rg -n "WebsitePricingStatement\.|periods:" website/src/sections
|
|
1120
|
+
|
|
1121
|
+
# No typed price in the website (must return 0)
|
|
1122
|
+
rg -n 'priceCurrency|amountMonthly|monthlyPrice|[$€£][0-9]' website/src/sections website/src/pages-impl
|
|
1123
|
+
|
|
1124
|
+
# No typed application URL (must return empty: the call to action is a WebsiteLinkTo)
|
|
1125
|
+
rg -n "https?://[^'\"]*(sign-?up|register)" website/src/sections
|
|
1126
|
+
|
|
1127
|
+
# No popularity claim in the packs (must return empty)
|
|
1128
|
+
rg -n -i "most popular|best seller" website/src/i18n/
|
|
1129
|
+
|
|
1130
|
+
# Catalogue passed to the island (must return >= 1, in the routes or in the page helper they call)
|
|
1131
|
+
rg -n "pricingCatalog" website/src --glob '!**/sections/**' --glob '!**/structured-data/**'
|
|
1132
|
+
|
|
1133
|
+
# Route passes the page context (must print nothing; a call wrapped over several lines prints its first line too, so open it and check)
|
|
1134
|
+
rg -n "renderPageStructuredData\(\{" website/src --glob '*.{astro,ts}' | rg -v "context:"
|
|
1135
|
+
|
|
1136
|
+
# Offers derived, never typed, and no origin typed into them (the first >= 1, the second empty)
|
|
1137
|
+
rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/
|
|
1138
|
+
rg -n "['\"]https?://" website/src/structured-data/
|
|
1139
|
+
|
|
1140
|
+
# Audit passes (no finding for the pricing page)
|
|
1141
|
+
wildo website audit --strict
|
|
934
1142
|
```
|
|
935
1143
|
|
|
936
1144
|
## Common Rationalizations
|
|
@@ -939,32 +1147,39 @@ rg -n "priceCurrency|amountMonthly|monthlyPrice" website/src/sections website/sr
|
|
|
939
1147
|
|---|---|
|
|
940
1148
|
| "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
1149
|
| "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. |
|
|
1150
|
+
| "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. |
|
|
1151
|
+
| "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. |
|
|
1152
|
+
| "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. |
|
|
1153
|
+
| "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
1154
|
| "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
|
|
944
|
-
| "
|
|
945
|
-
| "Each plan should be its own
|
|
1155
|
+
| "Mark the middle plan 'most popular'" | Nothing measured it. `isRecommended` states a recommendation, and the word must say so. |
|
|
1156
|
+
| "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. |
|
|
1157
|
+
| "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
1158
|
|
|
947
1159
|
## Red Flags
|
|
948
1160
|
|
|
949
|
-
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
1161
|
+
- Hand-built plan cards instead of `WebsitePricing` — catch with the "composes the engine's block" grep above.
|
|
1162
|
+
- A price in JSX or a sections file (`$12/mo`, `monthlyPrice: 12`) — a second copy of the catalogue; catch with the
|
|
1163
|
+
"No typed price" grep above.
|
|
1164
|
+
- A feature line naming a grant its plan does not have — the block throws at render; catch it first with the grant
|
|
1165
|
+
grep above, read against the catalogue.
|
|
1166
|
+
- A price the section has no word for (a floor, a per-unit basis, a trial, a yearly-only plan) — the block refuses it
|
|
1167
|
+
and names what to declare; catch it first with the two catalogue-against-statements greps above.
|
|
1168
|
+
- An on-request plan whose call to action goes to sign-up — catch by reading each `ON_REQUEST` plan's words for a
|
|
1169
|
+
`link`, with the statements grep above.
|
|
1170
|
+
- A typed sign-up URL — catch with the "No typed application URL" grep above.
|
|
1171
|
+
- "Most popular" in a pack — catch with the popularity grep above.
|
|
1172
|
+
- Hand-written `Offer` JSON-LD, or one offer URL for every locale — catch with the "Offers derived" greps above.
|
|
1173
|
+
- A route that shows plans without passing `pricingCatalog`, or calls `renderPageStructuredData` without `context` —
|
|
1174
|
+
catch with the two route greps above.
|
|
959
1175
|
|
|
960
1176
|
## Related Skills
|
|
961
1177
|
|
|
962
|
-
- `website-
|
|
963
|
-
|
|
1178
|
+
- `website-building-blocks` — how every other block is configured as a section, the band and intro this section
|
|
1179
|
+
composes by hand, and how a block is adjusted without forking.
|
|
1180
|
+
- `website-page-authoring` — composing this section into the pricing page manifest.
|
|
964
1181
|
- `website-label-pack` — authoring plan copy across locales.
|
|
965
|
-
- `configure-billing` — the billing catalogue the plans and
|
|
966
|
-
- `website-section-faq` — the standard FAQ companion section
|
|
967
|
-
|
|
968
|
-
- `website-
|
|
969
|
-
- `website-seo-aeo-geo` — broader SEO / AEO / GEO posture, including
|
|
970
|
-
page-level meta + canonical.
|
|
1182
|
+
- `configure-billing` — the billing catalogue the plans, prices and grants come from.
|
|
1183
|
+
- `website-section-faq` — the standard FAQ companion section (questions about pricing, billing, plan changes).
|
|
1184
|
+
- `website-anonymous-session` — the cookie that carries the visitor's anonymous session into the application.
|
|
1185
|
+
- `website-seo-aeo-geo` — broader SEO / AEO / GEO posture, including page-level meta + canonical.
|