@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-social-proof
|
|
3
|
-
description: Author a Social Proof section
|
|
3
|
+
description: Author a Social Proof section — customer testimonials or published evidence about the problem by configuring the engine's `websiteQuoteCardsBlock` (`websiteQuoteCardsBlock.section({ category: WebsiteSectionCategory.SOCIAL_PROOF, band, intro, config })`), a scrolling strip of customer or press names with `websiteMarqueeBlock`, or a static logo band or an aggregate rating as a block of the site's own (`defineWebsiteBlock`), so each section's words follow from what it renders — with `Review` / `AggregateRating` JSON-LD only where the page shows a real review. Use when the user says "add a logos band", "compose a testimonial section", "quote what people say about the problem", "wire customer-quote JSON-LD", or "build a press-mentions strip".
|
|
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,44 +697,60 @@ WebsiteSection.displayName = 'WebsiteSection';
|
|
|
619
697
|
```
|
|
620
698
|
|
|
621
699
|
|
|
622
|
-
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships
|
|
623
|
-
>
|
|
624
|
-
>
|
|
625
|
-
>
|
|
626
|
-
>
|
|
627
|
-
>
|
|
700
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships QUOTATIONS as a
|
|
701
|
+
> configured block, `websiteQuoteCardsBlock`: each quote a `<blockquote>` in a card with the
|
|
702
|
+
> accent's rule on its leading edge, its attribution underneath and, when the words were
|
|
703
|
+
> published, a link to where. `websiteQuoteCardsBlock.section({ pageRef, sectionRef, category,
|
|
704
|
+
> band, intro, config })` is the whole section: the block renders `config` (its
|
|
705
|
+
> `WebsiteQuoteCardsProps`), and the section's words are derived from the same config. A strip
|
|
706
|
+
> of NAMES scrolling past (customers, publications) is `websiteMarqueeBlock`, configured the
|
|
707
|
+
> same way. No engine block draws a static wall of logo IMAGES or an aggregate rating: each is
|
|
708
|
+
> a block of the site's own (`defineWebsiteBlock`), keeping its markup small and getting the
|
|
709
|
+
> same `.section(...)`. This skill covers what proof must SAY and CARRY — whose words they are,
|
|
710
|
+
> the structured data a real review earns, and the `llms.txt` contribution. How blocks are
|
|
711
|
+
> configured in general is `website-building-blocks`.
|
|
628
712
|
|
|
629
713
|
## Overview
|
|
630
714
|
|
|
631
715
|
A Social Proof section reduces buyer uncertainty by surfacing third-
|
|
632
716
|
party signals: customer logos, named testimonial quotes, aggregate
|
|
633
717
|
ratings, press / analyst mentions. Authors should pick **one shape
|
|
634
|
-
per instance** — mixing a logo wall, a testimonial
|
|
718
|
+
per instance** — mixing a logo wall, a testimonial list, and a
|
|
635
719
|
ratings band into a single section creates visual noise and
|
|
636
720
|
fragments the structured-data emission.
|
|
637
721
|
|
|
722
|
+
**Know whose words they are; the block cannot.** A **testimonial** is a customer speaking about the PRODUCT, with
|
|
723
|
+
their permission. **Evidence** is anyone — an analyst, a forum, a survey — speaking about the PROBLEM; those people
|
|
724
|
+
have not used the product. Both are quotations, and both are `websiteQuoteCardsBlock` sections, but they say
|
|
725
|
+
different things and carry different structured data: a testimonial may be a `Review`, evidence never is. Never
|
|
726
|
+
present evidence as a testimonial: the intro says whose words they are, and each evidence quote links to where it
|
|
727
|
+
was published.
|
|
728
|
+
|
|
638
729
|
What the category does — and, for structured data, does not — decide:
|
|
639
730
|
|
|
640
|
-
1. **SEO/AEO/GEO** — a
|
|
641
|
-
`
|
|
642
|
-
|
|
643
|
-
2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.SOCIAL_PROOF
|
|
731
|
+
1. **SEO/AEO/GEO** — a testimonial section may emit `Review`, a rating band `AggregateRating`. Page-level
|
|
732
|
+
`Organization.knowsAbout` may complement them. Nothing enforces this pairing — the structured-data audit checks
|
|
733
|
+
each payload against the Schema.org catalog, never against the section's category.
|
|
734
|
+
2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.SOCIAL_PROOF`, for every shape here, evidence included.
|
|
644
735
|
3. **Analytics labelling** — `data-section-category="social-proof"`.
|
|
645
736
|
|
|
646
737
|
## App Paths
|
|
647
738
|
|
|
648
739
|
| Surface | Glob (relative to app root) |
|
|
649
740
|
|---|---|
|
|
650
|
-
|
|
|
741
|
+
| The configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
|
|
742
|
+
| The site's config builders and section factories (quotes, sources, a site block for logos) | `website/src/sections/kit/**` |
|
|
651
743
|
| Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
|
|
652
|
-
|
|
|
653
|
-
| Logo
|
|
744
|
+
| This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
|
|
745
|
+
| Logo files | `website/public/images/logos/` |
|
|
746
|
+
| The site's own rules for a logo or rating block | `website/src/styles/**` |
|
|
654
747
|
|
|
655
748
|
## When to Use
|
|
656
749
|
|
|
657
|
-
-
|
|
658
|
-
-
|
|
659
|
-
-
|
|
750
|
+
- 1–3 named testimonial quotes, from customers who agreed to be quoted.
|
|
751
|
+
- Published observations about the problem, each with its source (evidence), on a problem-led page.
|
|
752
|
+
- Surfacing 4–10 customer logos as a band ("trusted by"), from customers who agreed to be named.
|
|
753
|
+
- An aggregate rating from a review platform (G2, Capterra), shown with its source and count.
|
|
660
754
|
- Press / analyst mentions strip.
|
|
661
755
|
|
|
662
756
|
## When NOT to Use
|
|
@@ -664,50 +758,111 @@ What the category does — and, for structured data, does not — decide:
|
|
|
664
758
|
- A single hero quote → fold into the hero section instead.
|
|
665
759
|
- A long case-study page → that is a dedicated content surface, not
|
|
666
760
|
a section.
|
|
667
|
-
- "Customer count: 5,000+" —
|
|
668
|
-
|
|
761
|
+
- "Customer count: 5,000+" — a figure, sourced or dropped → `website-section-stats` (`websiteStatsBlock`).
|
|
762
|
+
- The pain itself, in the reader's words → `website-section-problem`.
|
|
669
763
|
|
|
670
764
|
## Workflow
|
|
671
765
|
|
|
672
766
|
### Step 1: Pick one shape per section instance
|
|
673
767
|
|
|
674
|
-
Stack two social-proof sections if you need both (logo band +
|
|
675
|
-
|
|
676
|
-
(e.g. `logo-band`, `testimonials`).
|
|
677
|
-
|
|
678
|
-
### Step 2: Author the locale-neutral registry
|
|
768
|
+
Stack two social-proof sections if you need both (logo band + testimonials) — give them distinct `sectionRef`
|
|
769
|
+
values (e.g. `home-logos`, `home-testimonials`).
|
|
679
770
|
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
`
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
`
|
|
771
|
+
| Shape | Configured as |
|
|
772
|
+
|---|---|
|
|
773
|
+
| Testimonials | `websiteQuoteCardsBlock.section(...)`, a section intro above the quotes |
|
|
774
|
+
| Evidence about the problem | the same, the intro saying whose words they are, every quote with a `source` link |
|
|
775
|
+
| A scrolling strip of customer or press names | `websiteMarqueeBlock.section(...)` on a `STRIP` band (see `website-section-integrations` for the block) |
|
|
776
|
+
| Logo band (the logo images themselves) | a site block (`defineWebsiteBlock`, surface `BAND`, heading `SECTION_INTRO`) rendering a small `<ul>` of `WebsiteImage`s, on a `STRIP` band |
|
|
777
|
+
| Aggregate rating / press strip | a site block rendering its own small markup, under the section intro |
|
|
778
|
+
|
|
779
|
+
### Step 2: Configure the quotes
|
|
780
|
+
|
|
781
|
+
The block's config is `WebsiteQuoteCardsProps`: `quotes` (a `WebsiteQuote` per quotation, `{ ref, source? }`, in
|
|
782
|
+
order) and an optional `motion`. Each quote reads two words, declared for you from the config: `<ref>.text` (the
|
|
783
|
+
words, exactly as given or published) and `<ref>.source` (whose words: the person's name and organisation).
|
|
784
|
+
`source`, a `WebsiteLinkTo`, makes the attribution a link to where the words were published — a case-study page of
|
|
785
|
+
this site (`{ kind: WebsiteMenuLinkKind.PAGE, routePath }`) or an external article
|
|
786
|
+
(`{ kind: WebsiteMenuLinkKind.EXTERNAL, href }`) — so a reader can check them. Evidence always carries one; a
|
|
787
|
+
testimonial given to you directly may not. A source is an address, not a word: it lives in the config, never in the
|
|
788
|
+
label pack.
|
|
789
|
+
|
|
790
|
+
The block has ONE attribution slot, no headshot and no rating per quote. Write the attribution as name then
|
|
791
|
+
organisation; a role, a photo or stars need their own markup, and the section then is no longer a quote-card
|
|
792
|
+
section.
|
|
793
|
+
|
|
794
|
+
Build the config in the site's kit when more than one page quotes: a builder that takes the source URLs by position
|
|
795
|
+
and returns the quotes keeps every evidence section's shape the same (Worked Example).
|
|
796
|
+
|
|
797
|
+
### Step 3: A strip of names, a logo band or a rating band
|
|
798
|
+
|
|
799
|
+
A strip of names scrolling past is `websiteMarqueeBlock`: its config's `items` are the customers or publications,
|
|
800
|
+
each an item whose WORD is its name (`<ref>.text`), with at most a small decorative `icon`; `label` (true by
|
|
801
|
+
default) adds a line above saying what the list is. A screen reader reads the plain list, and the strip has one
|
|
802
|
+
pause control (its words `pause` and `play`, declared with the rest) and stops under reduced motion. It does not fit
|
|
803
|
+
a wall of logo images: it always draws each item's word, so a logo that IS the name would be shown twice. Past about
|
|
804
|
+
a dozen names, make two strips.
|
|
805
|
+
|
|
806
|
+
A static logo band is a block of the site's own: `defineWebsiteBlock({ surface: WebsiteBlockSurface.BAND, heading:
|
|
807
|
+
WebsiteBlockHeading.SECTION_INTRO, slots, Component })`, its `Component` a `<ul>` of `WebsiteImage`s with their
|
|
808
|
+
`width` and `height` (so nothing shifts as they load) and their `alt` from the label pack (`<ref>.name`, the
|
|
809
|
+
company's name), and its `slots` the same `<ref>.name` list read from the same config. Read the words with ONE
|
|
810
|
+
`useWebsiteSectionLabels()` call, never a hook per logo. Configure it with a `STRIP` band and a heading-only intro.
|
|
811
|
+
Style the list with the site's own class, reading tones and tokens, never a hex.
|
|
812
|
+
|
|
813
|
+
A rating band shows the score, the scale, the count and the platform it comes from, every one of them in words or
|
|
814
|
+
figures on the page; the numbers live in a registry with a `// figure-source:` comment naming the platform page,
|
|
815
|
+
never in the label pack alone and never typed into JSX. It is a site block too, not `websiteStatsBlock`: a stat's
|
|
816
|
+
value is a WORD of the label pack, while a rating's numbers must be the registry's, the same ones its
|
|
817
|
+
`AggregateRating` publishes.
|
|
818
|
+
|
|
819
|
+
### Step 4: Structured data, only for what the page shows
|
|
820
|
+
|
|
821
|
+
- **Testimonials**: one `Review` per quote rendered, its `reviewBody` and `author.name` read through `label(slot)`
|
|
822
|
+
— the slots the block renders — so each locale's page publishes the quote it shows, and its `itemReviewed` the
|
|
823
|
+
application by its site-wide `@id`, `${siteOrigin}/#software-application` (the one the pricing section gives
|
|
824
|
+
it). No `reviewRating`: the cards show none, and markup that says more than the page is spam.
|
|
825
|
+
- **Evidence**: none. These people did not review the product.
|
|
826
|
+
- **Logo band**: none — logo bands intentionally have no canonical shape, and emitting `Organization` from a logo
|
|
827
|
+
band confuses the entity graph.
|
|
828
|
+
- **Aggregate rating**: one `AggregateRating` whose `ratingValue` and `reviewCount` come from the same registry the
|
|
829
|
+
band renders, with `itemReviewed` the application's `@id`.
|
|
830
|
+
|
|
831
|
+
`getStructuredData` is an input of `.section(...)`, beside `config`.
|
|
832
|
+
|
|
833
|
+
### Step 5: The band and the intro
|
|
834
|
+
|
|
835
|
+
Every shape here stands on a band the section draws (`band`: `tone`, `spacing`, `decoration`) — a `STRIP` spacing
|
|
836
|
+
for a strip of names or logos — and takes the section intro above it (`intro`: `{}` for an eyebrow, a heading and a
|
|
837
|
+
lede; `{ eyebrow: false, lede: false }` for a heading only). For evidence, the intro's words are where the section
|
|
838
|
+
says whose words follow. The intro's words are declared from those flags, the block's from its config: nothing is
|
|
839
|
+
listed by hand, and a site block's `slots` lists only what its own markup reads.
|
|
840
|
+
|
|
841
|
+
### Step 6: Make it this site's own without forking the block
|
|
842
|
+
|
|
843
|
+
In this order: the theme, the config (its `motion`, keyed by `WebsiteQuoteCardsMotionPoint.QUOTES`, or `null` to
|
|
844
|
+
keep the quotes from staggering in), the site's config builder in the kit, and last an ordinary CSS rule on a hook
|
|
845
|
+
(`[data-website-block='quote-cards'] [data-website-part='source']`). The block's CSS is in the `wildo-website`
|
|
846
|
+
cascade layer, so an unlayered site rule wins without `!important`.
|
|
847
|
+
|
|
848
|
+
**Stop** after the section renders and (for testimonials or a rating) the JSON-LD validates in Google's Rich
|
|
849
|
+
Results test; if a `Review` restates a quote the page does not show, or evidence emits one, **return to Step 1**.
|
|
696
850
|
|
|
697
851
|
## Structured data (AEO)
|
|
698
852
|
|
|
699
853
|
Social-proof sections emit `Review` and/or `AggregateRating` only when
|
|
700
|
-
the page carries real review evidence. Logo walls
|
|
701
|
-
stay plain HTML.
|
|
854
|
+
the page carries real review evidence. Logo walls and evidence about the
|
|
855
|
+
problem stay plain HTML.
|
|
702
856
|
|
|
703
857
|
- **What earns its place**: visible testimonial copy, named reviewers or
|
|
704
858
|
a truthful aggregate score/count, and a clear `itemReviewed`.
|
|
705
|
-
- **What is NOT in this block**: anonymous logo strips,
|
|
706
|
-
averages,
|
|
859
|
+
- **What is NOT in this block**: anonymous logo strips, evidence quotes,
|
|
860
|
+
invented averages, ratings the page does not show, or off-site claims
|
|
861
|
+
the page does not actually support.
|
|
707
862
|
- **Verification grep**:
|
|
708
|
-
`rg -n "getStructuredData
|
|
709
|
-
(must return `>= 1` for testimonial/rating sections; logo
|
|
710
|
-
|
|
863
|
+
`rg -n "getStructuredData" website/src/sections/<page>.sections.tsx`
|
|
864
|
+
(must return `>= 1` for testimonial/rating sections; logo bands and
|
|
865
|
+
evidence intentionally return none for their own definition).
|
|
711
866
|
|
|
712
867
|
## Contribution to `llms.txt`
|
|
713
868
|
|
|
@@ -719,94 +874,348 @@ relevant page block in `website/src/content/llms.txt`.
|
|
|
719
874
|
- Prefer one compact evidence summary over a wall of logos or quote
|
|
720
875
|
excerpts.
|
|
721
876
|
- Do not invent aggregate stats or import claims from off-site decks the
|
|
722
|
-
page itself does not support
|
|
877
|
+
page itself does not support, and never summarise evidence about the
|
|
878
|
+
problem as praise of the product.
|
|
723
879
|
|
|
724
|
-
## Worked Example
|
|
880
|
+
## Worked Example
|
|
881
|
+
|
|
882
|
+
Evidence about the problem first, as the framework's reference application quotes it on a problem-led solution
|
|
883
|
+
page. Its config builder takes the source URLs by position and returns one quote per source, each attribution a link
|
|
884
|
+
to where the words were published; the builder's comment states the rule this skill rests on, that these people have
|
|
885
|
+
not used the product. The span below holds every config builder of that application's kit; the one evidence uses is
|
|
886
|
+
`evidenceConfig`.
|
|
887
|
+
|
|
888
|
+
|
|
889
|
+
## Usage Example
|
|
725
890
|
|
|
726
|
-
|
|
891
|
+
```tsx
|
|
892
|
+
// ── FEATURE GRID: capabilities as icon cards ─────────────────────────────────────────────────────────────────────────
|
|
893
|
+
|
|
894
|
+
/** Capabilities as cards, each with its glyph. `links` (by position) makes a card a link to the page that argues it. */
|
|
895
|
+
export function featureGridConfig({
|
|
896
|
+
icons,
|
|
897
|
+
columns = 3,
|
|
898
|
+
links,
|
|
899
|
+
}: {
|
|
900
|
+
icons: readonly WtIcon[];
|
|
901
|
+
columns?: 2 | 3 | 4;
|
|
902
|
+
links?: ReadonlyArray<string | undefined>;
|
|
903
|
+
}): WebsiteCardGridProps {
|
|
904
|
+
return {
|
|
905
|
+
columns,
|
|
906
|
+
items: icons.map((icon, position) => {
|
|
907
|
+
const routePath = links?.[position];
|
|
908
|
+
return {
|
|
909
|
+
ref: `item${position + 1}`,
|
|
910
|
+
icon: <Icon name={icon} />,
|
|
911
|
+
...(routePath === undefined ? {} : { link: { kind: WebsiteMenuLinkKind.PAGE, routePath } as const }),
|
|
912
|
+
};
|
|
913
|
+
}),
|
|
914
|
+
};
|
|
915
|
+
}
|
|
916
|
+
|
|
917
|
+
// ── STEPS ────────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
918
|
+
|
|
919
|
+
/** How it works, as an ordered list. `visuals` (by position) draws each step; without them, each step is numbered. */
|
|
920
|
+
export function stepsConfig({ count, visuals }: { count: number; visuals?: readonly ReactNode[] }): WebsiteStepsProps {
|
|
921
|
+
return {
|
|
922
|
+
steps: indexes(count).map((index) => ({ ref: `step${index}`, ...(visuals?.[index - 1] === undefined ? {} : { visual: visuals[index - 1] }) })),
|
|
923
|
+
};
|
|
924
|
+
}
|
|
925
|
+
|
|
926
|
+
// ── STATS: facts as numbers, counted up once ─────────────────────────────────────────────────────────────────────────
|
|
927
|
+
|
|
928
|
+
export function statsConfig(count: number): WebsiteStatsProps {
|
|
929
|
+
return { stats: indexes(count).map((index) => `stat${index}`) };
|
|
930
|
+
}
|
|
931
|
+
|
|
932
|
+
// ── COMPARISON and TABLE ─────────────────────────────────────────────────────────────────────────────────────────────
|
|
933
|
+
|
|
934
|
+
const rowRefs = (rows: number): string[] => indexes(rows).map((index) => `row${index}`);
|
|
935
|
+
const columnRefs = (columns: number): string[] => indexes(columns).map((index) => `column${index}`);
|
|
936
|
+
|
|
937
|
+
/** The product against the alternatives, honestly: a real table, the product's column first and marked. */
|
|
938
|
+
export function comparisonConfig(rows: number, columns: number): WebsiteComparisonTableProps {
|
|
939
|
+
return { rows: rowRefs(rows), columns: columnRefs(columns), highlight: 'column1' };
|
|
940
|
+
}
|
|
941
|
+
|
|
942
|
+
/** A plain data table: a caption, scoped column headers, the first cell of each row as its header. */
|
|
943
|
+
export function tableConfig(rows: number, columns: number): WebsiteFactTableProps {
|
|
944
|
+
return { rows: rowRefs(rows), columns: columnRefs(columns) };
|
|
945
|
+
}
|
|
946
|
+
|
|
947
|
+
// ── FAQ ──────────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
948
|
+
|
|
949
|
+
const questionRefs = (count: number): string[] => indexes(count).map((index) => `q${index}`);
|
|
950
|
+
|
|
951
|
+
/** Questions as `<details>`: answerable without JavaScript. The intro has no eyebrow. */
|
|
952
|
+
export function faqConfig(count: number): WebsiteFaqProps {
|
|
953
|
+
return { questions: questionRefs(count), intro: { eyebrow: false } };
|
|
954
|
+
}
|
|
955
|
+
|
|
956
|
+
/** The page's FAQPage JSON-LD, from the words the section shows. */
|
|
957
|
+
export function faqStructuredData(count: number): ReturnType<typeof websiteFaqStructuredData> {
|
|
958
|
+
return websiteFaqStructuredData(questionRefs(count));
|
|
959
|
+
}
|
|
960
|
+
|
|
961
|
+
// ── SOLUTION PATHS ───────────────────────────────────────────────────────────────────────────────────────────────────
|
|
962
|
+
|
|
963
|
+
/** One card per audience, each the whole-card link to the solution page written for it. */
|
|
964
|
+
export function solutionPathsConfig(slugs: readonly string[], icons: readonly WtIcon[]): WebsiteSolutionPathsProps {
|
|
965
|
+
return {
|
|
966
|
+
paths: slugs.map((slug, position) => ({
|
|
967
|
+
ref: slug,
|
|
968
|
+
link: { kind: WebsiteMenuLinkKind.PAGE, routePath: `/solutions/${slug}` } as const,
|
|
969
|
+
icon: <Icon name={icons[position] ?? WtIcon.USERS} />,
|
|
970
|
+
})),
|
|
971
|
+
};
|
|
972
|
+
}
|
|
973
|
+
|
|
974
|
+
// ── EVIDENCE: what people say about the problem, with the source ─────────────────────────────────────────────────────
|
|
975
|
+
|
|
976
|
+
/**
|
|
977
|
+
* Published observations about the PROBLEM, each linked to where it was published. Never a testimonial: these people
|
|
978
|
+
* have not used the product, and the block says whose words they are and where to read them. `sources` are the URLs,
|
|
979
|
+
* by position — addresses, not words, so they live in code.
|
|
980
|
+
*/
|
|
981
|
+
export function evidenceConfig(sources: readonly string[]): WebsiteQuoteCardsProps {
|
|
982
|
+
return { quotes: sources.map((href, position) => ({ ref: `quote${position + 1}`, source: { kind: WebsiteMenuLinkKind.EXTERNAL, href } as const })) };
|
|
983
|
+
}
|
|
984
|
+
|
|
985
|
+
// ── ROADMAP ──────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
986
|
+
|
|
987
|
+
/** A roadmap phase as a page shows it: its horizon (the application's own vocabulary) and how many items it lists. */
|
|
988
|
+
export interface RoadmapPhaseShown {
|
|
989
|
+
readonly horizon: RoadmapPhaseHorizon;
|
|
990
|
+
readonly items: number;
|
|
991
|
+
/** Every item of the phase works in the application today (verified there), so each is shown with a check. */
|
|
992
|
+
readonly available?: boolean;
|
|
993
|
+
}
|
|
994
|
+
|
|
995
|
+
/** The plan, in the open: what we build now, next and later — the product's own roadmap phases. */
|
|
996
|
+
export function roadmapConfig(phases: readonly RoadmapPhaseShown[]): WebsiteRoadmapProps {
|
|
997
|
+
return {
|
|
998
|
+
phases: phases.map((phase, position) => ({
|
|
999
|
+
ref: `phase${position + 1}`,
|
|
1000
|
+
horizon: phase.horizon,
|
|
1001
|
+
items: indexes(phase.items).map((index) => ({ ref: `item${index}`, available: phase.available === true })),
|
|
1002
|
+
})),
|
|
1003
|
+
};
|
|
1004
|
+
}
|
|
1005
|
+
|
|
1006
|
+
// ── LINK CARDS: one card per page of an area, each with its drawing ──────────────────────────────────────────────────
|
|
1007
|
+
|
|
1008
|
+
export function linkCardsConfig(
|
|
1009
|
+
cards: ReadonlyArray<{ readonly ref: string; readonly routePath: string; readonly icon: WtIcon; readonly visual?: ReactNode }>,
|
|
1010
|
+
): WebsiteCardGridProps {
|
|
1011
|
+
return {
|
|
1012
|
+
fit: WebsiteGridFit.AUTO,
|
|
1013
|
+
motion: { [WebsiteCardGridMotionPoint.ITEMS]: { stagger: WebsiteMotionReveal.SCALE }, [WebsiteCardGridMotionPoint.LINK_CARD]: { hover: WebsiteMotionHover.GLOW } },
|
|
1014
|
+
items: cards.map((card) => ({
|
|
1015
|
+
ref: card.ref,
|
|
1016
|
+
icon: <Icon name={card.icon} />,
|
|
1017
|
+
link: { kind: WebsiteMenuLinkKind.PAGE, routePath: card.routePath } as const,
|
|
1018
|
+
cta: true as const,
|
|
1019
|
+
...(card.visual === undefined ? {} : { media: card.visual }),
|
|
1020
|
+
})),
|
|
1021
|
+
};
|
|
1022
|
+
}
|
|
1023
|
+
|
|
1024
|
+
// ── FINAL CTA ────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
1025
|
+
|
|
1026
|
+
/** The page's close, on the inverse band, with the brand's three forward-leaning stripes behind it. */
|
|
1027
|
+
export function finalCtaConfig(secondaryRoutePath: string): WebsiteCtaBandProps {
|
|
1028
|
+
return { decoration: <Stripes className="brand-stripes-close" />, ...heroActions(secondaryRoutePath) };
|
|
1029
|
+
}
|
|
1030
|
+
|
|
1031
|
+
// ── PROBLEM: the reader's situation, before any product ─────────────────────────────────────────────────────────────
|
|
1032
|
+
|
|
1033
|
+
/**
|
|
1034
|
+
* The problem in the reader's own terms, before the product appears: one card per pain, each led by its figure (a cost
|
|
1035
|
+
* in minutes or hours, a count) so the pain is concrete. The figures are the reader's arithmetic, not our measurement.
|
|
1036
|
+
*/
|
|
1037
|
+
export function problemConfig(count: number): WebsiteCardGridProps {
|
|
1038
|
+
return { fit: WebsiteGridFit.AUTO, items: indexes(count).map((index) => ({ ref: `pain${index}`, figure: true })) };
|
|
1039
|
+
}
|
|
1040
|
+
```
|
|
1041
|
+
|
|
1042
|
+
The section factory then configures `websiteQuoteCardsBlock` with that config, on a band, under the full section
|
|
1043
|
+
intro (whose words say whose quotes follow), with `category: WebsiteSectionCategory.SOCIAL_PROOF` and no
|
|
1044
|
+
`getStructuredData`. The span holds the kit's other section factories too; the one this section uses is
|
|
1045
|
+
`evidenceSection`.
|
|
1046
|
+
|
|
1047
|
+
|
|
1048
|
+
## Usage Example
|
|
1049
|
+
|
|
1050
|
+
```tsx
|
|
1051
|
+
export function gridSection(
|
|
1052
|
+
input: Base & {
|
|
1053
|
+
readonly icons: readonly WtIcon[];
|
|
1054
|
+
readonly columns?: 2 | 3 | 4;
|
|
1055
|
+
readonly intro?: WebsiteSectionIntroOptions;
|
|
1056
|
+
readonly links?: ReadonlyArray<string | undefined>;
|
|
1057
|
+
readonly tone?: WebsiteSurfaceTone;
|
|
1058
|
+
readonly category?: WebsiteSectionCategory;
|
|
1059
|
+
},
|
|
1060
|
+
) {
|
|
1061
|
+
return websiteCardGridBlock.section({
|
|
1062
|
+
pageRef: input.pageRef,
|
|
1063
|
+
sectionRef: input.sectionRef,
|
|
1064
|
+
category: input.category ?? WebsiteSectionCategory.FEATURE_BENEFIT_SUMMARY,
|
|
1065
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
1066
|
+
intro: input.intro ?? {},
|
|
1067
|
+
config: featureGridConfig({ icons: input.icons, columns: input.columns ?? 3, ...(input.links === undefined ? {} : { links: input.links }) }),
|
|
1068
|
+
});
|
|
1069
|
+
}
|
|
1070
|
+
|
|
1071
|
+
export function stepsSection(input: Base & { readonly count: number; readonly intro?: WebsiteSectionIntroOptions; readonly tone?: WebsiteSurfaceTone }) {
|
|
1072
|
+
return websiteStepsBlock.section({
|
|
1073
|
+
pageRef: input.pageRef,
|
|
1074
|
+
sectionRef: input.sectionRef,
|
|
1075
|
+
category: WebsiteSectionCategory.HOW_IT_WORKS,
|
|
1076
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
1077
|
+
intro: input.intro ?? {},
|
|
1078
|
+
config: stepsConfig({ count: input.count }),
|
|
1079
|
+
});
|
|
1080
|
+
}
|
|
1081
|
+
|
|
1082
|
+
export function problemSection(input: Base & { readonly count: number; readonly tone?: WebsiteSurfaceTone }) {
|
|
1083
|
+
return websiteCardGridBlock.section({
|
|
1084
|
+
pageRef: input.pageRef,
|
|
1085
|
+
sectionRef: input.sectionRef,
|
|
1086
|
+
category: WebsiteSectionCategory.PROBLEM,
|
|
1087
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.TINTED },
|
|
1088
|
+
intro: {},
|
|
1089
|
+
config: problemConfig(input.count),
|
|
1090
|
+
});
|
|
1091
|
+
}
|
|
1092
|
+
|
|
1093
|
+
/** Published observations about the problem, each with its source — `sources` are the URLs, by position. */
|
|
1094
|
+
export function evidenceSection(input: Base & { readonly sources: readonly string[]; readonly tone?: WebsiteSurfaceTone }) {
|
|
1095
|
+
return websiteQuoteCardsBlock.section({
|
|
1096
|
+
pageRef: input.pageRef,
|
|
1097
|
+
sectionRef: input.sectionRef,
|
|
1098
|
+
category: WebsiteSectionCategory.SOCIAL_PROOF,
|
|
1099
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
1100
|
+
intro: {},
|
|
1101
|
+
config: evidenceConfig(input.sources),
|
|
1102
|
+
});
|
|
1103
|
+
}
|
|
1104
|
+
|
|
1105
|
+
export function comparisonSection(input: Base & { readonly rows: number; readonly columns: number; readonly tone?: WebsiteSurfaceTone }) {
|
|
1106
|
+
return websiteComparisonTableBlock.section({
|
|
1107
|
+
pageRef: input.pageRef,
|
|
1108
|
+
sectionRef: input.sectionRef,
|
|
1109
|
+
category: WebsiteSectionCategory.COMPARISON,
|
|
1110
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
1111
|
+
intro: {},
|
|
1112
|
+
config: comparisonConfig(input.rows, input.columns),
|
|
1113
|
+
});
|
|
1114
|
+
}
|
|
1115
|
+
|
|
1116
|
+
export function tableSection(input: Base & { readonly rows: number; readonly columns: number; readonly tone?: WebsiteSurfaceTone }) {
|
|
1117
|
+
return websiteFactTableBlock.section({
|
|
1118
|
+
pageRef: input.pageRef,
|
|
1119
|
+
sectionRef: input.sectionRef,
|
|
1120
|
+
category: WebsiteSectionCategory.FEATURE_DETAIL,
|
|
1121
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
1122
|
+
intro: {},
|
|
1123
|
+
config: tableConfig(input.rows, input.columns),
|
|
1124
|
+
});
|
|
1125
|
+
}
|
|
1126
|
+
```
|
|
1127
|
+
|
|
1128
|
+
Testimonials are the same block with a `Review` per quote shown:
|
|
1129
|
+
|
|
1130
|
+
<!-- TIER C WAIVER: no anchored application usage quotes customers about the product, so no anchor shows a testimonial section or its `Review` JSON-LD. This block shows the shape the Verification and Red Flags below reference: the `TESTIMONIALS` quotes in the config, a `source` link only where the words were published, `websiteQuoteCardsBlock.section(...)` with a heading-only intro, and a `getStructuredData` that builds one `Review` per quote from the slots the block renders, without a rating the cards do not show. Keep it inline until a testimonial section is deliberately anchored. -->
|
|
727
1131
|
```tsx
|
|
728
1132
|
// website/src/sections/<page>.sections.tsx
|
|
1133
|
+
import { WebsiteMenuLinkKind, websiteQuoteCardsBlock, WebsiteSectionCategory, type WebsiteQuote } from '@wildo-ai/saas-website';
|
|
1134
|
+
|
|
1135
|
+
/**
|
|
1136
|
+
* TESTIMONIALS: customers about the product, each quoted with their permission. `source` links the attribution to
|
|
1137
|
+
* where the words were published, when they were (a case study); a quote given to us directly has none.
|
|
1138
|
+
*/
|
|
1139
|
+
const TESTIMONIALS: readonly WebsiteQuote[] = [
|
|
1140
|
+
{ ref: 'jordan', source: { kind: WebsiteMenuLinkKind.PAGE, routePath: '/customers/acme' } },
|
|
1141
|
+
{ ref: 'sasha' },
|
|
1142
|
+
];
|
|
1143
|
+
|
|
1144
|
+
// Words derived from the config and the intro: heading, jordan.text, jordan.source, sasha.text, sasha.source.
|
|
1145
|
+
export const HOME_TESTIMONIALS_SECTION = websiteQuoteCardsBlock.section({
|
|
1146
|
+
pageRef: 'home',
|
|
1147
|
+
sectionRef: 'home-testimonials',
|
|
1148
|
+
category: WebsiteSectionCategory.SOCIAL_PROOF,
|
|
1149
|
+
intro: { eyebrow: false, lede: false },
|
|
1150
|
+
config: { quotes: TESTIMONIALS },
|
|
1151
|
+
// One Review per quote shown, from the same slots in the page's locale, about the application the pricing section
|
|
1152
|
+
// publishes (referenced by its `@id`, never re-emitted). No `reviewRating`: the cards show none.
|
|
1153
|
+
getStructuredData: ({ label, locale, siteOrigin }) =>
|
|
1154
|
+
TESTIMONIALS.map((quote) => ({
|
|
1155
|
+
'@type': 'Review',
|
|
1156
|
+
inLanguage: locale,
|
|
1157
|
+
reviewBody: label(`${quote.ref}.text`),
|
|
1158
|
+
author: { '@type': 'Person', name: label(`${quote.ref}.source`) },
|
|
1159
|
+
itemReviewed: { '@id': `${siteOrigin}/#software-application` },
|
|
1160
|
+
})),
|
|
1161
|
+
});
|
|
1162
|
+
```
|
|
1163
|
+
|
|
1164
|
+
A logo band has no engine block, so it is a block of the site's own, configured like any other:
|
|
1165
|
+
|
|
1166
|
+
<!-- TIER C WAIVER: no engine block covers a logo band and no anchored application usage builds one as a site block. This block shows Step 3's shape: `defineWebsiteBlock` with surface BAND and heading SECTION_INTRO, a small list of `WebsiteImage`s with their size and an `alt` read through one `useWebsiteSectionLabels()` call, `slots` derived from the same config the component renders, the section configured on a `STRIP` band under a heading-only intro, and no structured data. Keep it inline until a logo-band block ships. -->
|
|
1167
|
+
```tsx
|
|
1168
|
+
// website/src/sections/kit/logo-band.tsx — the block; the section goes in website/src/sections/<page>.sections.tsx
|
|
1169
|
+
import type { ReactNode } from 'react';
|
|
729
1170
|
import {
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
1171
|
+
defineWebsiteBlock,
|
|
1172
|
+
useWebsiteSectionLabels,
|
|
1173
|
+
WebsiteBandSpacing,
|
|
1174
|
+
WebsiteBlockHeading,
|
|
1175
|
+
WebsiteBlockSurface,
|
|
733
1176
|
WebsiteImage,
|
|
734
1177
|
WebsiteSectionCategory,
|
|
735
|
-
WebsiteText,
|
|
736
1178
|
} from '@wildo-ai/saas-website';
|
|
737
1179
|
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
rating: 1 | 2 | 3 | 4 | 5;
|
|
1180
|
+
/** Customers who agreed to be named, each with its logo file. The company's name is a word (`<ref>.name`), the alt. */
|
|
1181
|
+
interface LogoBandConfig {
|
|
1182
|
+
readonly logos: ReadonlyArray<{ readonly ref: string; readonly src: string; readonly width: number; readonly height: number }>;
|
|
742
1183
|
}
|
|
743
1184
|
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
{ ref: 'sasha', authorImageSrc: '/img/sasha.jpg', rating: 5 },
|
|
747
|
-
{ ref: 'dom', authorImageSrc: '/img/dom.jpg', rating: 4 },
|
|
748
|
-
] as const;
|
|
749
|
-
|
|
750
|
-
function SocialProofComponent() {
|
|
751
|
-
const title = useWebsiteLabel('title');
|
|
1185
|
+
function LogoBand({ logos }: LogoBandConfig): ReactNode {
|
|
1186
|
+
const label = useWebsiteSectionLabels();
|
|
752
1187
|
return (
|
|
753
|
-
<
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
</div>
|
|
1188
|
+
<ul className="site-logo-band">
|
|
1189
|
+
{logos.map((logo) => (
|
|
1190
|
+
<li key={logo.ref}>
|
|
1191
|
+
<WebsiteImage src={logo.src} alt={label(`${logo.ref}.name`)} width={logo.width} height={logo.height} />
|
|
1192
|
+
</li>
|
|
1193
|
+
))}
|
|
1194
|
+
</ul>
|
|
761
1195
|
);
|
|
762
1196
|
}
|
|
763
1197
|
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
<blockquote>
|
|
772
|
-
<WebsiteText>{quote}</WebsiteText>
|
|
773
|
-
</blockquote>
|
|
774
|
-
<figcaption>
|
|
775
|
-
<WebsiteImage src={testimonial.authorImageSrc} alt={altText} width={64} height={64} />
|
|
776
|
-
<span>{author}</span>
|
|
777
|
-
<span>{role}</span>
|
|
778
|
-
</figcaption>
|
|
779
|
-
</li>
|
|
780
|
-
);
|
|
781
|
-
}
|
|
1198
|
+
/** On the section's band, under the section's intro; it reads one word per logo, derived from the same config. */
|
|
1199
|
+
export const logoBandBlock = defineWebsiteBlock({
|
|
1200
|
+
surface: WebsiteBlockSurface.BAND,
|
|
1201
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
1202
|
+
slots: (config: LogoBandConfig) => config.logos.map((logo) => `${logo.ref}.name`),
|
|
1203
|
+
Component: LogoBand,
|
|
1204
|
+
});
|
|
782
1205
|
|
|
783
|
-
export const
|
|
784
|
-
|
|
1206
|
+
export const HOME_LOGOS_SECTION = logoBandBlock.section({
|
|
1207
|
+
pageRef: 'home',
|
|
1208
|
+
sectionRef: 'home-logos',
|
|
785
1209
|
category: WebsiteSectionCategory.SOCIAL_PROOF,
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
Component: SocialProofComponent,
|
|
796
|
-
getStructuredData: () => ({
|
|
797
|
-
'@context': 'https://schema.org',
|
|
798
|
-
'@type': 'Product',
|
|
799
|
-
name: 'Example Application',
|
|
800
|
-
aggregateRating: {
|
|
801
|
-
'@type': 'AggregateRating',
|
|
802
|
-
ratingValue: (
|
|
803
|
-
TESTIMONIALS.reduce((acc, t) => acc + t.rating, 0) / TESTIMONIALS.length
|
|
804
|
-
).toFixed(1),
|
|
805
|
-
reviewCount: TESTIMONIALS.length,
|
|
806
|
-
bestRating: 5,
|
|
807
|
-
worstRating: 1,
|
|
808
|
-
},
|
|
809
|
-
}),
|
|
1210
|
+
band: { spacing: WebsiteBandSpacing.STRIP },
|
|
1211
|
+
intro: { eyebrow: false, lede: false },
|
|
1212
|
+
config: {
|
|
1213
|
+
logos: [
|
|
1214
|
+
{ ref: 'acme', src: '/images/logos/acme.svg', width: 120, height: 32 },
|
|
1215
|
+
{ ref: 'globex', src: '/images/logos/globex.svg', width: 132, height: 32 },
|
|
1216
|
+
],
|
|
1217
|
+
},
|
|
1218
|
+
// No getStructuredData: a logo is not a review.
|
|
810
1219
|
});
|
|
811
1220
|
```
|
|
812
1221
|
|
|
@@ -814,9 +1223,9 @@ export const SOCIAL_PROOF_SECTION = defineWebsiteSection({
|
|
|
814
1223
|
|
|
815
1224
|
What a social-proof section emits:
|
|
816
1225
|
|
|
817
|
-
- `Review` (one per testimonial quote,
|
|
818
|
-
`
|
|
819
|
-
- `AggregateRating` (
|
|
1226
|
+
- `Review` (one per testimonial quote rendered, about the product — `SoftwareApplication` or `Product` — or
|
|
1227
|
+
`Organization`, referenced by `@id`).
|
|
1228
|
+
- `AggregateRating` (from a rating band that shows the score, scale, count and platform).
|
|
820
1229
|
|
|
821
1230
|
Keep these in the sections that own them — nothing rejects them here,
|
|
822
1231
|
since the audit checks each payload against the catalog and never
|
|
@@ -826,121 +1235,136 @@ against the section's category:
|
|
|
826
1235
|
`website-section-pricing`.
|
|
827
1236
|
- `FAQPage` → `website-section-faq`.
|
|
828
1237
|
|
|
829
|
-
A logo band
|
|
830
|
-
|
|
1238
|
+
A logo band, a press strip and evidence about the problem have no review to describe — leave `getStructuredData`
|
|
1239
|
+
undefined.
|
|
831
1240
|
|
|
832
1241
|
## Catalog integration (AEO)
|
|
833
1242
|
|
|
834
|
-
|
|
835
|
-
(when the section ships testimonial quotes and a rating roll-up).
|
|
836
|
-
Both are declared by the installed Schema.org catalog contract:
|
|
1243
|
+
Both payloads are declared by the installed Schema.org catalog contract:
|
|
837
1244
|
|
|
838
1245
|
- `REVIEW_CATALOG_ENTRY` (required: `author`, `reviewBody`,
|
|
839
1246
|
`itemReviewed`; `recommendOptionals: true`, so a missing
|
|
840
1247
|
`reviewRating` / `datePublished` is listed as a recommendation by
|
|
841
|
-
`wildo website audit` — information, never a finding).
|
|
1248
|
+
`wildo website audit` — information, never a finding). Leave it
|
|
1249
|
+
listed rather than adding a rating the cards do not show.
|
|
842
1250
|
- `AGGREGATE_RATING_CATALOG_ENTRY` (required: `ratingValue`,
|
|
843
1251
|
`reviewCount`; `recommendOptionals: true` for `bestRating` /
|
|
844
1252
|
`worstRating` so the AI engine can interpret the scale).
|
|
845
1253
|
|
|
846
1254
|
The page shell wires emission through the installed structured-data contract —
|
|
847
|
-
the section returns a
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
D-AG4).
|
|
852
|
-
|
|
853
|
-
**What earns its place in this section's emission**:
|
|
854
|
-
|
|
855
|
-
- One `Review` payload per testimonial quote rendered on the page —
|
|
856
|
-
`author.name` matches the on-page attribution; `reviewBody`
|
|
857
|
-
resolves to the quote text at the active locale; `itemReviewed`
|
|
858
|
-
references the brand `Organization` (or `SoftwareApplication` for
|
|
859
|
-
SaaS sites) via `@id`.
|
|
860
|
-
- A single `AggregateRating` payload whose `ratingValue` and
|
|
861
|
-
`reviewCount` are derived from the same `TESTIMONIALS` registry
|
|
862
|
-
the JSX renders (no hard-coded number — the math must derive from
|
|
863
|
-
the registry to stay consistent).
|
|
864
|
-
|
|
865
|
-
**What is NOT in this emission**:
|
|
866
|
-
|
|
867
|
-
- A standalone `Product` payload — that belongs in the pricing
|
|
868
|
-
section. Reference it via `@id` here, don't re-emit.
|
|
869
|
-
- `Review` payloads without `itemReviewed` — Schema.org requires the
|
|
870
|
-
reviewed entity, and the catalog will flag the omission.
|
|
871
|
-
- App overrides — adjustments to required-field lists live in the
|
|
872
|
-
app's `_catalogs/schema-org/review.catalog-spec.ts`, NOT in the
|
|
873
|
-
section.
|
|
874
|
-
|
|
875
|
-
**Verification grep** (run from the app root):
|
|
876
|
-
|
|
877
|
-
| Invariant | Command |
|
|
878
|
-
|---|---|
|
|
879
|
-
| Section emits structured data | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 when testimonials are rendered) |
|
|
880
|
-
| Both `@type`s present | see the commands below the table (must return ≥2) |
|
|
1255
|
+
the section returns one payload or a flat array, and the renderer emits one
|
|
1256
|
+
`<script type="application/ld+json">` block per payload. The companion's
|
|
1257
|
+
reconciliation surface validates each payload against the catalog and warns
|
|
1258
|
+
on drift (`wildo website audit --strict` fails on it).
|
|
881
1259
|
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
1260
|
+
**What earns its place**: one `Review` per testimonial rendered, its `author.name` and `reviewBody` being
|
|
1261
|
+
`label(slot)` of the attribution and quote slots; an `AggregateRating` whose numbers come from the registry the
|
|
1262
|
+
rating band renders.
|
|
1263
|
+
|
|
1264
|
+
**What is NOT in this emission**: a standalone `Product` payload (reference it via `@id`); a `Review` without
|
|
1265
|
+
`itemReviewed`; a `Review` for an evidence quote; app overrides of the required-field lists, which live in the
|
|
1266
|
+
app's `_catalogs/schema-org/review.catalog-spec.ts`, NOT in the section.
|
|
886
1267
|
|
|
887
1268
|
## References
|
|
888
1269
|
|
|
1270
|
+
- `references/framework-website-quote-cards-api.md` — source-backed `websiteQuoteCardsBlock` and
|
|
1271
|
+
`websiteMarqueeBlock`, the configured block contract (`defineWebsiteBlock`, for a site's logo or rating block),
|
|
1272
|
+
`WebsiteQuoteCards`, `WebsiteMarquee`, link targets, the band and the intro.
|
|
889
1273
|
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
|
|
1274
|
+
- `../website-building-blocks/references/framework-website-blocks-api.md` — every block and the stylesheet's hooks.
|
|
890
1275
|
|
|
891
1276
|
## Verification
|
|
892
1277
|
|
|
893
1278
|
- [ ] `category: WebsiteSectionCategory.SOCIAL_PROOF` (typed enum).
|
|
894
|
-
- [ ] One shape per section (logo band OR
|
|
895
|
-
|
|
896
|
-
- [ ]
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
1279
|
+
- [ ] One shape per section (logo band OR testimonials OR evidence OR aggregate rating); stack distinct sections if
|
|
1280
|
+
you need more.
|
|
1281
|
+
- [ ] Quotations are `websiteQuoteCardsBlock.section(...)` — no hand-built `<blockquote>`, no
|
|
1282
|
+
`defineWebsiteBlockSection` and no hand-listed slots.
|
|
1283
|
+
- [ ] Testimonials are customers about the product, quoted with permission; evidence is about the problem, its
|
|
1284
|
+
intro says whose words they are, and every evidence quote carries a `source` link.
|
|
1285
|
+
- [ ] A logo or rating band is a site block (`defineWebsiteBlock`) whose `slots` are derived from the same config
|
|
1286
|
+
its component renders.
|
|
1287
|
+
- [ ] A `Review` per testimonial rendered, its words read through `label(slot)`, with no `reviewRating`; none for
|
|
1288
|
+
evidence or logos.
|
|
1289
|
+
- [ ] An `AggregateRating`'s numbers come from a registry with a `figure-source:` comment, and the band shows them.
|
|
1290
|
+
- [ ] Every logo `WebsiteImage` has its size and an `alt` from the label pack.
|
|
1291
|
+
- [ ] A scrolling strip of names is `websiteMarqueeBlock.section(...)` — no hand-built track or endless CSS loop.
|
|
902
1292
|
|
|
903
1293
|
### Grep invariants
|
|
904
1294
|
|
|
905
|
-
|
|
906
|
-
|---|---|
|
|
907
|
-
| Factory used | `rg -n "defineWebsiteSection<?" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
|
|
908
|
-
| Section's payloads are its own, and valid | This section's `getStructuredData` returns `Review` / `AggregateRating` (wrapping `Product` / `Organization` / `SoftwareApplication` only as `itemReviewed`); `wildo website audit` reports no finding for the page |
|
|
909
|
-
| Image alt declared | see the commands below the table (every `WebsiteImage` must have alt) |
|
|
910
|
-
| Rating counts derived (no hardcoded `reviewCount`) | `rg -n "reviewCount: \\d+" website/src/sections/<page>.sections.tsx` (must return empty — `reviewCount` should always be `TESTIMONIALS.length`) |
|
|
1295
|
+
`npx astro check` in `website/` must pass. Then, from the app root:
|
|
911
1296
|
|
|
912
1297
|
```bash
|
|
913
|
-
#
|
|
914
|
-
rg -n "
|
|
1298
|
+
# Quotations are the configured block (must return >= 1 for a quote section)
|
|
1299
|
+
rg -n "websiteQuoteCardsBlock\.section\(" website/src/sections
|
|
1300
|
+
|
|
1301
|
+
# No hand-listed slots for the engine's blocks (must return empty: the words follow from the config)
|
|
1302
|
+
rg -n "websiteQuoteCardsSlots\(|websiteMarqueeSlots\(" website/src/sections
|
|
1303
|
+
|
|
1304
|
+
# No social-proof section declared by hand (must return empty)
|
|
1305
|
+
rg -U -n "defineWebsiteBlockSection\(\{[^}]*SOCIAL_PROOF" website/src/sections
|
|
1306
|
+
|
|
1307
|
+
# No hand-built quotation (must return empty)
|
|
1308
|
+
rg -n "<blockquote" website/src/sections
|
|
1309
|
+
|
|
1310
|
+
# Review words read through the context (must return >= 2 for a testimonial section: the quote and the author)
|
|
1311
|
+
rg -n 'label\(`\$\{[a-z]+\.ref\}\.(text|source)`\)' website/src/sections/<page>.sections.tsx
|
|
1312
|
+
|
|
1313
|
+
# No rating a quote card cannot show (must return empty)
|
|
1314
|
+
rg -n "reviewRating" website/src/sections/<page>.sections.tsx
|
|
1315
|
+
|
|
1316
|
+
# No hardcoded review count (must return empty: it comes from the registry the band renders)
|
|
1317
|
+
rg -n "reviewCount: [0-9]" website/src/sections/<page>.sections.tsx
|
|
1318
|
+
|
|
1319
|
+
# Every rating figure names its source (must return >= 1 for a rating band)
|
|
1320
|
+
rg -n "figure-source:" website/src/sections
|
|
1321
|
+
|
|
1322
|
+
# A scrolling strip is the engine's marquee (>= 1 when the page has one), and no hand-made loop (must return empty)
|
|
1323
|
+
rg -n "websiteMarqueeBlock\.section\(" website/src/sections
|
|
1324
|
+
rg -n "infinite" website/src/styles/
|
|
1325
|
+
|
|
1326
|
+
# Every logo image has an alt (each WebsiteImage hit must show alt= on its line)
|
|
1327
|
+
rg -n "<WebsiteImage" website/src/sections
|
|
1328
|
+
|
|
1329
|
+
# Evidence presented as praise in the packs (read each hit beside its section)
|
|
1330
|
+
rg -n -i "customers love|trusted by|our users say" website/src/i18n/
|
|
915
1331
|
```
|
|
916
1332
|
|
|
917
1333
|
## Common Rationalizations
|
|
918
1334
|
|
|
919
1335
|
| Rationalization | Reality |
|
|
920
1336
|
|---|---|
|
|
921
|
-
| "I'll mix logos + testimonials + ratings in one section" | Visual noise + fragmented JSON-LD. Stack
|
|
922
|
-
| "
|
|
1337
|
+
| "I'll mix logos + testimonials + ratings in one section" | Visual noise + fragmented JSON-LD. Stack distinct sections instead. |
|
|
1338
|
+
| "An analyst said our problem is real, that's a testimonial" | It is evidence about the problem. Those people never used the product; presenting their words as praise is a claim the page cannot back. |
|
|
1339
|
+
| "I'll add five stars to each quote card" | The cards show no rating, so a `reviewRating` would say more than the page. A rating belongs in a rating band that shows its source and count. |
|
|
1340
|
+
| "I'll fake a `5.0` rating to look better" | Nothing in the framework detects it, and Google treats fabricated review markup as spam — a manual action, not a ranking signal. |
|
|
923
1341
|
| "Logos band should still emit `Review`" | A logo is not a review. Without an actual rating or quote, do not emit `Review` — leave structured data undefined. |
|
|
924
|
-
| "I'll
|
|
1342
|
+
| "I'll write the quote cards myself so I can add a headshot" | The copy stops following the theme, the accent rule and every fix. If the shape needs a photo, it is not a quote-card section; say so rather than forking. |
|
|
1343
|
+
| "I'll list the quotes' slots with `websiteQuoteCardsSlots` and wrap the block myself" | The configured block derives the words from the quotes it renders. A hand list drifts from what is shown, and the label audit then demands words nobody sees. |
|
|
1344
|
+
| "The rating is a number, so it is a stats block" | A stat's value is a word of the label pack; a rating's score and count must be the registry's, the same ones its `AggregateRating` publishes. Make it a site block. |
|
|
925
1345
|
|
|
926
1346
|
## Red Flags
|
|
927
1347
|
|
|
928
|
-
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
|
|
938
|
-
|
|
1348
|
+
- A hand-built `<blockquote>` instead of `websiteQuoteCardsBlock` — catch with the "No hand-built quotation" grep above.
|
|
1349
|
+
- A quote or marquee section declared with `defineWebsiteBlockSection` and a slot list — catch with the "hand-listed
|
|
1350
|
+
slots" and "declared by hand" greps above.
|
|
1351
|
+
- A `Review` emitted for evidence quotes, or a section whose intro does not say whose words they are — catch with
|
|
1352
|
+
the evidence-as-praise grep and the `getStructuredData` grep, read beside the section.
|
|
1353
|
+
- A `reviewBody` that is a quoted sentence instead of `label(slot)` — one language on every locale's page; catch
|
|
1354
|
+
with the "Review words read through the context" grep above.
|
|
1355
|
+
- A `reviewRating` on a quote card's `Review` — catch with the `reviewRating` grep above.
|
|
1356
|
+
- A hardcoded `reviewCount` or an unsourced rating — catch with the `reviewCount` and `figure-source:` greps above.
|
|
1357
|
+
- A logo without `alt` or size — catch with the `WebsiteImage` grep above.
|
|
1358
|
+
- A hand-built scrolling strip (a CSS keyframe nothing pauses) — catch with the marquee and `infinite` greps above.
|
|
939
1359
|
|
|
940
1360
|
## Related Skills
|
|
941
1361
|
|
|
1362
|
+
- `website-building-blocks` — how the engine's blocks are configured as sections, how a site block is defined, and
|
|
1363
|
+
how a block is adjusted without forking.
|
|
942
1364
|
- `website-page-authoring` — composing social-proof sections.
|
|
943
|
-
- `website-label-pack` — quote +
|
|
1365
|
+
- `website-label-pack` — quote + attribution strings across locales.
|
|
1366
|
+
- `website-section-problem` — the problem the evidence is about.
|
|
1367
|
+
- `website-section-stats` — a figure such as a customer count, on `websiteStatsBlock`.
|
|
944
1368
|
- `website-section-hero` — for a single hero quote inline (instead
|
|
945
1369
|
of a dedicated social-proof section).
|
|
946
1370
|
- `website-seo-aeo-geo` — page-level `Organization` JSON-LD that
|