@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
|
@@ -0,0 +1,917 @@
|
|
|
1
|
+
# `WebsiteProductTour` and `WebsiteBento` — API (source-backed)
|
|
2
|
+
|
|
3
|
+
The two blocks that show the product's screens as a tour or as tiles (configured as `websiteProductTourBlock` and
|
|
4
|
+
`websiteBentoBlock`, their configs `WebsiteProductTourProps` and `WebsiteBentoProps`), how a block is configured as a
|
|
5
|
+
section, and the demo frame their screens play in.
|
|
6
|
+
|
|
7
|
+
- Read it when you need the exact shape of a `WebsiteProductTourTab` (`ref`, `screen`) or a `WebsiteBentoTile`
|
|
8
|
+
(`ref`, `visual`, `size`), the words a config produces (the slots `websiteProductTourSlots` and `websiteBentoSlots`
|
|
9
|
+
list, which the configured block derives for you), or how the tour rotates and stops.
|
|
10
|
+
- Read it when a drawn screen plays its scenario (`useWebsiteDemoScenario`) or reads its words inside a tab or tile.
|
|
11
|
+
|
|
12
|
+
## A block as a configured section
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/saas-website`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
*
|
|
24
|
+
* A block as a CONFIGURABLE section (#2742): the engine binds each block's renderer to the words it reads, so a
|
|
25
|
+
* section is configured, not written. `websiteHeroBlock.section({ pageRef, sectionRef, category, config })` is the
|
|
26
|
+
* whole section: the block renders the config, and the section's words are derived from THE SAME config, so a
|
|
27
|
+
* section cannot declare a word it does not render or render one it does not declare.
|
|
28
|
+
*
|
|
29
|
+
* Two properties of a block decide what the section around it may add, and the section input's TYPE follows them:
|
|
30
|
+
*
|
|
31
|
+
* - where it stands (`WebsiteBlockSurface`): `BAND`, on a band the section draws (`band`: tone, spacing,
|
|
32
|
+
* decoration); `OWN`, on a surface it draws itself (a hero, a call-to-action band), its tone in its config;
|
|
33
|
+
* - whether it has its own heading (`WebsiteBlockHeading`): `SECTION_INTRO`, the section may put its intro (eyebrow,
|
|
34
|
+
* heading, lede) above it (`intro`); `OWN`, it carries its own (a feature row, a FAQ, a hero), and a second heading
|
|
35
|
+
* above it would make one section with two titles.
|
|
36
|
+
*
|
|
37
|
+
* A config may hold nodes that read words of their own (a hero's visual, a tour's screens, a bento's drawings):
|
|
38
|
+
* declare those with `nodeSlots`, under the prefix the node reads them by.
|
|
39
|
+
*/
|
|
40
|
+
export enum WebsiteBlockSurface {
|
|
41
|
+
/** The block stands on a band the section draws. */
|
|
42
|
+
BAND = 'band',
|
|
43
|
+
/** The block draws its own surface: the section adds no band. */
|
|
44
|
+
OWN = 'own',
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export enum WebsiteBlockHeading {
|
|
48
|
+
/** The section may put its intro above the block. */
|
|
49
|
+
SECTION_INTRO = 'section-intro',
|
|
50
|
+
/** The block carries its own heading: the section adds no intro. */
|
|
51
|
+
OWN = 'own',
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
interface WebsiteBlockSectionCommonInput<TConfig> {
|
|
55
|
+
readonly pageRef: string;
|
|
56
|
+
readonly sectionRef: string;
|
|
57
|
+
/** What the section is for: a block serves several categories (a card grid lists benefits or integrations). */
|
|
58
|
+
readonly category: WebsiteSectionCategory;
|
|
59
|
+
/** The block's configuration: everything it renders, the same object its words are derived from. */
|
|
60
|
+
readonly config: TConfig;
|
|
61
|
+
/** Words read by nodes inside the config (a visual's drawing), already under the prefix the node reads them by. */
|
|
62
|
+
readonly nodeSlots?: readonly string[];
|
|
63
|
+
/** The section's DOM id, so a link can target it (`#pricing`). */
|
|
64
|
+
readonly anchorId?: string;
|
|
65
|
+
readonly getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/** The band a block standing on one is drawn on. */
|
|
69
|
+
export interface WebsiteBlockSectionBandInput {
|
|
70
|
+
readonly band?: Omit<WebsiteBandProps, 'children'>;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** The section intro above a block that takes one; absent: none. Its eyebrow and lede flags decide its words. */
|
|
74
|
+
export interface WebsiteBlockSectionIntroInput {
|
|
75
|
+
readonly intro?: Omit<WebsiteSectionIntroProps, 'children'>;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** What `section(...)` takes for a block standing where `TSurface` says, with the heading `THeading` says. */
|
|
79
|
+
export type WebsiteBlockSectionInput<TConfig, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> = WebsiteBlockSectionCommonInput<TConfig> &
|
|
80
|
+
(TSurface extends WebsiteBlockSurface.BAND ? WebsiteBlockSectionBandInput : Record<never, never>) &
|
|
81
|
+
(THeading extends WebsiteBlockHeading.SECTION_INTRO ? WebsiteBlockSectionIntroInput : Record<never, never>);
|
|
82
|
+
|
|
83
|
+
export interface WebsiteBlock<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> {
|
|
84
|
+
readonly surface: TSurface;
|
|
85
|
+
readonly heading: THeading;
|
|
86
|
+
/** The words the block reads for a configuration, as slots of the section. */
|
|
87
|
+
readonly slots: (config: TConfig) => string[];
|
|
88
|
+
/** The block's renderer. */
|
|
89
|
+
readonly Component: ComponentType<TConfig>;
|
|
90
|
+
/** The block as a whole section, its words derived from its config (see the module comment). */
|
|
91
|
+
readonly section: (input: WebsiteBlockSectionInput<TConfig, TSurface, THeading>) => TypedWebsiteSectionDefinition;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
export interface DefineWebsiteBlockInput<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> {
|
|
95
|
+
readonly surface: TSurface;
|
|
96
|
+
readonly heading: THeading;
|
|
97
|
+
readonly slots: (config: TConfig) => string[];
|
|
98
|
+
readonly Component: ComponentType<TConfig>;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
export function defineWebsiteBlock<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading>(
|
|
102
|
+
definition: DefineWebsiteBlockInput<TConfig, TSurface, THeading>,
|
|
103
|
+
): WebsiteBlock<TConfig, TSurface, THeading> {
|
|
104
|
+
const { surface, heading, slots, Component } = definition;
|
|
105
|
+
const section = (input: WebsiteBlockSectionInput<TConfig, TSurface, THeading>): TypedWebsiteSectionDefinition => {
|
|
106
|
+
const common: WebsiteBlockSectionCommonInput<TConfig> & WebsiteBlockSectionBandInput & WebsiteBlockSectionIntroInput = input;
|
|
107
|
+
// The types already refuse a band or an intro where the block does not take one; a value forced past them is ignored.
|
|
108
|
+
const banded = surface === WebsiteBlockSurface.BAND ? common : undefined;
|
|
109
|
+
const intro = heading === WebsiteBlockHeading.SECTION_INTRO ? common.intro : undefined;
|
|
110
|
+
const sectionSlots = [...(intro === undefined ? [] : websiteSectionIntroSlots(intro)), ...slots(common.config), ...(common.nodeSlots ?? [])];
|
|
111
|
+
const block = <Component {...common.config} />;
|
|
112
|
+
const SectionBody = (): ReactNode =>
|
|
113
|
+
banded === undefined ? (
|
|
114
|
+
block
|
|
115
|
+
) : (
|
|
116
|
+
<WebsiteBand {...(banded.band ?? {})}>
|
|
117
|
+
{intro === undefined ? null : <WebsiteSectionIntro {...intro} />}
|
|
118
|
+
{block}
|
|
119
|
+
</WebsiteBand>
|
|
120
|
+
);
|
|
121
|
+
SectionBody.displayName = `WebsiteBlockSection(${common.sectionRef})`;
|
|
122
|
+
return defineWebsiteBlockSection({
|
|
123
|
+
pageRef: common.pageRef,
|
|
124
|
+
sectionRef: common.sectionRef,
|
|
125
|
+
category: common.category,
|
|
126
|
+
slots: sectionSlots,
|
|
127
|
+
Component: SectionBody,
|
|
128
|
+
...(common.anchorId === undefined ? {} : { anchorId: common.anchorId }),
|
|
129
|
+
...(common.getStructuredData === undefined ? {} : { getStructuredData: common.getStructuredData }),
|
|
130
|
+
});
|
|
131
|
+
};
|
|
132
|
+
return { surface, heading, slots, Component, section };
|
|
133
|
+
}
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
## The product tour
|
|
137
|
+
|
|
138
|
+
## Import Origins
|
|
139
|
+
|
|
140
|
+
- `@wildo-ai/saas-website`
|
|
141
|
+
|
|
142
|
+
## Source Excerpts
|
|
143
|
+
|
|
144
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
145
|
+
|
|
146
|
+
```tsx
|
|
147
|
+
*
|
|
148
|
+
* `WebsiteProductTour`: the product in tabs (PRODUCT_SHOWCASE), one drawn screen per tab beside its title and one
|
|
149
|
+
* paragraph (#2742). Each tab has its label, a title and a body by slot (`<ref>.tab`, `<ref>.title`, `<ref>.body`) and
|
|
150
|
+
* its `screen`, drawn by the site with its own words (declare its slots beside the tour's); the tab list is named by
|
|
151
|
+
* `tabs-label`. `websiteProductTourSlots(tabs)`.
|
|
152
|
+
*
|
|
153
|
+
* It follows the WAI-ARIA tabs pattern: a `tablist` of real buttons, the arrow keys, Home and End move between them,
|
|
154
|
+
* one `tabpanel` labelled by its tab. The drawn screen is hidden from assistive technology, which reads the panel's
|
|
155
|
+
* title and body instead.
|
|
156
|
+
*
|
|
157
|
+
* It ROTATES on its own, one tab every `WEBSITE_PRODUCT_TOUR_DWELL_MS` (7 s, with a countdown line under the tab), and
|
|
158
|
+
* stops as an auto-rotating carousel must: for good once keyboard focus enters the tabs or the visitor picks a tab,
|
|
159
|
+
* and for as long as the pointer is over it. The tour sits in a `WebsiteMotionDemoGroup`, so its pause control (slots
|
|
160
|
+
* `pause`, `play`), the off-screen pause, reduced motion and a STILL site hold the rotation and every screen.
|
|
161
|
+
*
|
|
162
|
+
* spec-cite: WAI-ARIA APG, Carousel pattern, "About This Pattern" — https://www.w3.org/WAI/ARIA/apg/patterns/carousel/
|
|
163
|
+
* (fetched 2026-10-06): rotation "Stops rotating when keyboard focus enters the carousel. It does not restart unless
|
|
164
|
+
* the user explicitly requests it to do so." and "Stops rotating whenever the mouse is hovering over the carousel."
|
|
165
|
+
*
|
|
166
|
+
* Hooks: `data-website-block="product-tour"`, the parts `tabs`, `tab`, `progress` (`data-website-running` while it
|
|
167
|
+
* counts down), `panel`, `copy`, `title`, `body`, `screen-frame`, `screen`.
|
|
168
|
+
*/
|
|
169
|
+
export interface WebsiteProductTourTab {
|
|
170
|
+
readonly ref: string;
|
|
171
|
+
/** The tab's drawn screen. */
|
|
172
|
+
readonly screen: ReactNode;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
export function websiteProductTourSlots(tabs: readonly WebsiteProductTourTab[] | readonly string[]): string[] {
|
|
176
|
+
return [
|
|
177
|
+
'tabs-label',
|
|
178
|
+
'pause',
|
|
179
|
+
'play',
|
|
180
|
+
...tabs.map((tab) => (typeof tab === 'string' ? tab : tab.ref)).flatMap((ref) => [`${ref}.tab`, `${ref}.title`, `${ref}.body`]),
|
|
181
|
+
];
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
export interface WebsiteProductTourProps {
|
|
185
|
+
readonly tabs: readonly WebsiteProductTourTab[];
|
|
186
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* Advances the tour while the group plays. Rendered INSIDE the group so it reads the playback flag the pause control,
|
|
191
|
+
* the off-screen pause and reduced motion feed; renders nothing.
|
|
192
|
+
*/
|
|
193
|
+
function TourClock({ active, rotating, dwell, onAdvance }: { active: number; rotating: boolean; dwell: number; onAdvance: () => void }): null {
|
|
194
|
+
const playing = useWebsiteMotionDemoPlaying();
|
|
195
|
+
useEffect(() => {
|
|
196
|
+
if (!playing || !rotating) return undefined;
|
|
197
|
+
const timer = setTimeout(onAdvance, dwell);
|
|
198
|
+
return () => clearTimeout(timer);
|
|
199
|
+
}, [playing, rotating, active, dwell, onAdvance]);
|
|
200
|
+
return null;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/** The line under the active tab, counting down to the next one. It runs only while the tour rotates and plays. */
|
|
204
|
+
function TourProgress({ rotating }: { rotating: boolean }): ReactNode {
|
|
205
|
+
const playing = useWebsiteMotionDemoPlaying();
|
|
206
|
+
return <span data-website-part="progress" aria-hidden="true" {...(rotating && playing ? { 'data-website-running': '' } : {})} />;
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
export function WebsiteProductTour({ tabs, titleLevel = 3 }: WebsiteProductTourProps): ReactNode {
|
|
210
|
+
const label = useWebsiteSectionLabels();
|
|
211
|
+
const [active, setActive] = useState(0);
|
|
212
|
+
const [rotating, setRotating] = useState(true);
|
|
213
|
+
const [hovered, setHovered] = useState(false);
|
|
214
|
+
const tabRefs = useRef<Array<HTMLButtonElement | null>>([]);
|
|
215
|
+
const baseId = useId();
|
|
216
|
+
const advance = useCallback(() => setActive((current) => (current + 1) % tabs.length), [tabs.length]);
|
|
217
|
+
const choose = (index: number): void => {
|
|
218
|
+
setRotating(false);
|
|
219
|
+
setActive(index);
|
|
220
|
+
};
|
|
221
|
+
const onKeyDown = (event: KeyboardEvent<HTMLDivElement>): void => {
|
|
222
|
+
const delta = event.key === 'ArrowRight' ? 1 : event.key === 'ArrowLeft' ? -1 : 0;
|
|
223
|
+
if (delta === 0 && event.key !== 'Home' && event.key !== 'End') return;
|
|
224
|
+
event.preventDefault();
|
|
225
|
+
const next = event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : (active + delta + tabs.length) % tabs.length;
|
|
226
|
+
choose(next);
|
|
227
|
+
tabRefs.current[next]?.focus();
|
|
228
|
+
};
|
|
229
|
+
const current = tabs[active] ?? tabs[0];
|
|
230
|
+
if (current === undefined) return null;
|
|
231
|
+
// One tab has nothing to rotate to: no clock, no countdown, no entrance replayed every dwell.
|
|
232
|
+
const turning = rotating && !hovered && tabs.length > 1;
|
|
233
|
+
const hover = { onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false) };
|
|
234
|
+
return (
|
|
235
|
+
<div data-website-block="product-tour">
|
|
236
|
+
<WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
|
|
237
|
+
<TourClock active={active} rotating={turning} dwell={WEBSITE_PRODUCT_TOUR_DWELL_MS} onAdvance={advance} />
|
|
238
|
+
<div role="tablist" aria-label={label('tabs-label')} data-website-part="tabs" onKeyDown={onKeyDown} onFocus={() => setRotating(false)} {...hover}>
|
|
239
|
+
{tabs.map((tab, index) => (
|
|
240
|
+
<button
|
|
241
|
+
key={tab.ref}
|
|
242
|
+
ref={(element) => {
|
|
243
|
+
tabRefs.current[index] = element;
|
|
244
|
+
}}
|
|
245
|
+
type="button"
|
|
246
|
+
role="tab"
|
|
247
|
+
id={`${baseId}-tab-${index}`}
|
|
248
|
+
aria-selected={index === active}
|
|
249
|
+
aria-controls={`${baseId}-panel`}
|
|
250
|
+
tabIndex={index === active ? 0 : -1}
|
|
251
|
+
data-website-part="tab"
|
|
252
|
+
onClick={() => choose(index)}
|
|
253
|
+
>
|
|
254
|
+
{label(`${tab.ref}.tab`)}
|
|
255
|
+
{index === active && <TourProgress rotating={turning} />}
|
|
256
|
+
</button>
|
|
257
|
+
))}
|
|
258
|
+
</div>
|
|
259
|
+
{/*
|
|
260
|
+
The panel stays mounted, so a screen reader reading it keeps its place; its content is re-keyed so the
|
|
261
|
+
entrance plays for each tab. It announces a new tab only once the visitor has stopped the rotation (APG
|
|
262
|
+
carousel: live region off while rotating), and it is focusable because it holds nothing focusable (APG tabs).
|
|
263
|
+
*/}
|
|
264
|
+
<div
|
|
265
|
+
role="tabpanel"
|
|
266
|
+
id={`${baseId}-panel`}
|
|
267
|
+
aria-labelledby={`${baseId}-tab-${active}`}
|
|
268
|
+
aria-live={turning ? 'off' : 'polite'}
|
|
269
|
+
tabIndex={0}
|
|
270
|
+
data-website-part="panel"
|
|
271
|
+
onFocus={() => setRotating(false)}
|
|
272
|
+
{...hover}
|
|
273
|
+
>
|
|
274
|
+
<div key={`${current.ref}-copy`} data-website-part="copy">
|
|
275
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
276
|
+
{label(`${current.ref}.title`)}
|
|
277
|
+
</WebsiteHeading>
|
|
278
|
+
<p data-website-part="body">{label(`${current.ref}.body`)}</p>
|
|
279
|
+
</div>
|
|
280
|
+
{/* The entrance plays on this plain frame, never on the stage: the pause control holds every animation in a
|
|
281
|
+
stage, so a stage re-keyed while paused would hold its entrance at the first frame, invisible. */}
|
|
282
|
+
<div key={`${current.ref}-screen`} data-website-part="screen-frame">
|
|
283
|
+
<WebsiteMotionDemoStage>
|
|
284
|
+
<div data-website-part="screen">{current.screen}</div>
|
|
285
|
+
</WebsiteMotionDemoStage>
|
|
286
|
+
</div>
|
|
287
|
+
</div>
|
|
288
|
+
</WebsiteMotionDemoGroup>
|
|
289
|
+
</div>
|
|
290
|
+
);
|
|
291
|
+
}
|
|
292
|
+
WebsiteProductTour.displayName = 'WebsiteProductTour';
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
## The bento
|
|
296
|
+
|
|
297
|
+
## Import Origins
|
|
298
|
+
|
|
299
|
+
- `@wildo-ai/saas-website`
|
|
300
|
+
|
|
301
|
+
## Source Excerpts
|
|
302
|
+
|
|
303
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
304
|
+
|
|
305
|
+
```tsx
|
|
306
|
+
*
|
|
307
|
+
* `WebsiteBento`: capabilities as a bento grid (FEATURE_BENEFIT_SUMMARY), each tile a small drawing of the capability
|
|
308
|
+
* above its title and one line (#2742). A tile has a title and a body by slot (`<ref>.title`, `<ref>.body`;
|
|
309
|
+
* `websiteBentoSlots(tiles)`), and its `visual`: a drawing, usually a short loop, that the site draws with its own
|
|
310
|
+
* words (declare its slots beside the bento's). A tile is a third of the row (REGULAR) or half of it (WIDE): two WIDE
|
|
311
|
+
* tiles make a row, three REGULAR ones another. Every visual sits in one `WebsiteMotionDemoGroup`, so the bento has
|
|
312
|
+
* ONE pause control (slots `pause`, `play`), stops off screen and stays still under reduced motion or a STILL site;
|
|
313
|
+
* a visual is hidden from assistive technology, because the tile's words say what it shows.
|
|
314
|
+
*
|
|
315
|
+
* A tile is a `WebsiteCard` with media, so a site that has styled its media cards has styled its bento. Hooks:
|
|
316
|
+
* `data-website-block="bento"`, the part `tiles`, `data-website-size` on each tile.
|
|
317
|
+
*/
|
|
318
|
+
export enum WebsiteBentoMotionPoint {
|
|
319
|
+
/** The tiles arrive one after another, growing in. */
|
|
320
|
+
TILES = 'tiles',
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
const BENTO_MOTION = defineBlockMotionPoints<WebsiteBentoMotionPoint>({
|
|
324
|
+
[WebsiteBentoMotionPoint.TILES]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.SCALE } },
|
|
325
|
+
});
|
|
326
|
+
|
|
327
|
+
/** One tile: its slot prefix, its drawing, and how much of the row it takes. */
|
|
328
|
+
export interface WebsiteBentoTile {
|
|
329
|
+
readonly ref: string;
|
|
330
|
+
readonly visual: ReactNode;
|
|
331
|
+
readonly size?: WebsiteBentoTileSize;
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
export function websiteBentoSlots(tiles: readonly WebsiteBentoTile[] | readonly string[]): string[] {
|
|
335
|
+
return ['pause', 'play', ...tiles.map((tile) => (typeof tile === 'string' ? tile : tile.ref)).flatMap((ref) => [`${ref}.title`, `${ref}.body`])];
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
export interface WebsiteBentoProps {
|
|
339
|
+
readonly tiles: readonly WebsiteBentoTile[];
|
|
340
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
341
|
+
readonly motion?: WebsiteBlockMotion<WebsiteBentoMotionPoint>;
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
export function WebsiteBento({ tiles, titleLevel = 3, motion }: WebsiteBentoProps): ReactNode {
|
|
345
|
+
const label = useWebsiteSectionLabels();
|
|
346
|
+
return (
|
|
347
|
+
<div data-website-block="bento">
|
|
348
|
+
<WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
|
|
349
|
+
<ul data-website-part="tiles" {...blockMotionAttributes(WebsiteBentoMotionPoint.TILES, BENTO_MOTION, motion)}>
|
|
350
|
+
{tiles.map((tile) => (
|
|
351
|
+
<WebsiteCard key={tile.ref} size={tile.size ?? WebsiteBentoTileSize.REGULAR} media={<WebsiteMotionDemoStage>{tile.visual}</WebsiteMotionDemoStage>}>
|
|
352
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
353
|
+
{label(`${tile.ref}.title`)}
|
|
354
|
+
</WebsiteHeading>
|
|
355
|
+
<span data-website-part="body">{label(`${tile.ref}.body`)}</span>
|
|
356
|
+
</WebsiteCard>
|
|
357
|
+
))}
|
|
358
|
+
</ul>
|
|
359
|
+
</WebsiteMotionDemoGroup>
|
|
360
|
+
</div>
|
|
361
|
+
);
|
|
362
|
+
}
|
|
363
|
+
WebsiteBento.displayName = 'WebsiteBento';
|
|
364
|
+
```
|
|
365
|
+
|
|
366
|
+
## The layout vocabulary (tile sizes, the tour's dwell)
|
|
367
|
+
|
|
368
|
+
## Import Origins
|
|
369
|
+
|
|
370
|
+
- `@wildo-ai/saas-website`
|
|
371
|
+
|
|
372
|
+
## Source Excerpts
|
|
373
|
+
|
|
374
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
375
|
+
|
|
376
|
+
```typescript
|
|
377
|
+
*
|
|
378
|
+
* The layout vocabulary of the engine's building blocks (#2742). A block's LAYOUT is chosen per use and is never its
|
|
379
|
+
* section category: one card grid serves a feature summary, an integrations list and a values section.
|
|
380
|
+
*/
|
|
381
|
+
|
|
382
|
+
/** How much vertical room a band takes (`rhythm.section`, `rhythm.sectionCompact`, `rhythm.strip`). */
|
|
383
|
+
export enum WebsiteBandSpacing {
|
|
384
|
+
/** A section. */
|
|
385
|
+
DEFAULT = 'default',
|
|
386
|
+
/** A section that should not dominate: a short note between two long sections. */
|
|
387
|
+
COMPACT = 'compact',
|
|
388
|
+
/** A thin row between hairlines: a logo strip, a marquee. */
|
|
389
|
+
STRIP = 'strip',
|
|
390
|
+
}
|
|
391
|
+
|
|
392
|
+
/** How a section's intro sits. */
|
|
393
|
+
export enum WebsiteIntroAlign {
|
|
394
|
+
/** Centred above the content: most sections. */
|
|
395
|
+
CENTER = 'center',
|
|
396
|
+
/** Aligned with the content's start edge: an intro beside a list, an FAQ's side column. */
|
|
397
|
+
START = 'start',
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
/** How an eyebrow (the label above a heading) is drawn. */
|
|
401
|
+
export enum WebsiteEyebrowStyle {
|
|
402
|
+
/** The overline type role in the brand colour. */
|
|
403
|
+
PLAIN = 'plain',
|
|
404
|
+
/** A pill with the accent's dot: the hero's opening line. */
|
|
405
|
+
PILL = 'pill',
|
|
406
|
+
}
|
|
407
|
+
|
|
408
|
+
/** How a hero lays out its copy and its visual. */
|
|
409
|
+
export enum WebsiteHeroLayout {
|
|
410
|
+
/** The copy centred above a full-width visual: the home page's product stage. */
|
|
411
|
+
STAGE = 'stage',
|
|
412
|
+
/** The copy beside the visual, the visual taking the larger column: a product or solution page. */
|
|
413
|
+
SPLIT = 'split',
|
|
414
|
+
/** No visual: the copy centred, a shorter opening. Used automatically when no visual is given. */
|
|
415
|
+
COMPACT = 'compact',
|
|
416
|
+
}
|
|
417
|
+
|
|
418
|
+
/** What a hero draws behind its content. */
|
|
419
|
+
export enum WebsiteHeroSurface {
|
|
420
|
+
/** The band's own background. */
|
|
421
|
+
PLAIN = 'plain',
|
|
422
|
+
/** A soft glow of the brand's colour from the top. */
|
|
423
|
+
GLOW = 'glow',
|
|
424
|
+
/** The glow over a faint grid that fades toward the edges. */
|
|
425
|
+
GLOW_GRID = 'glow-grid',
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
/** Which side of a feature row the visual sits on; alternate them so consecutive rows zig-zag. */
|
|
429
|
+
export enum WebsiteFeatureRowLayout {
|
|
430
|
+
/** The copy first, the visual after it (on the right in a left-to-right page). */
|
|
431
|
+
VISUAL_END = 'visual-end',
|
|
432
|
+
/** The visual first. */
|
|
433
|
+
VISUAL_START = 'visual-start',
|
|
434
|
+
}
|
|
435
|
+
|
|
436
|
+
/** How many columns a card grid has on a wide screen. On smaller screens 4 narrows to 2 then 1; 2 and 3 go to 1. */
|
|
437
|
+
export type WebsiteCardGridColumns = 2 | 3 | 4;
|
|
438
|
+
|
|
439
|
+
/** How a grid of cards lays out its columns: a fixed count, or as many as fit (`layout.cardMin` wide at least). */
|
|
440
|
+
export enum WebsiteGridFit {
|
|
441
|
+
/** The `columns` the block is given, narrowing on smaller screens. */
|
|
442
|
+
FIXED = 'fixed',
|
|
443
|
+
/** As many columns as fit, each at least the theme's card width: right for a list whose length varies. */
|
|
444
|
+
AUTO = 'auto',
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
/** How the steps of a process run. */
|
|
448
|
+
export enum WebsiteStepsLayout {
|
|
449
|
+
/** Side by side, left to right, stacking on a narrow screen: three or four short steps. */
|
|
450
|
+
ROW = 'row',
|
|
451
|
+
/** One under the other: longer steps, or more of them. */
|
|
452
|
+
STACK = 'stack',
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
/** How big an icon tile is: the square of colour behind a glyph. */
|
|
456
|
+
export enum WebsiteIconTileSize {
|
|
457
|
+
/** Beside a line of text: a point of a list. */
|
|
458
|
+
SM = 'sm',
|
|
459
|
+
/** Leading a card. */
|
|
460
|
+
MD = 'md',
|
|
461
|
+
/** Leading a card that is a choice: a path, a plan. */
|
|
462
|
+
LG = 'lg',
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
/** How an icon tile is coloured. */
|
|
466
|
+
export enum WebsiteIconTileStyle {
|
|
467
|
+
/** The glyph in the tone's primary on a wash of it: quiet, the default. */
|
|
468
|
+
WASH = 'wash',
|
|
469
|
+
/** The glyph in the tone's background on its foreground: strong, for a card that is a choice. */
|
|
470
|
+
SOLID = 'solid',
|
|
471
|
+
}
|
|
472
|
+
|
|
473
|
+
/**
|
|
474
|
+
* How long a product tour's tab stays before the tour moves on, while it rotates (ms). One value for the component's
|
|
475
|
+
* clock and the stylesheet's countdown line, so the line always ends as the tab changes.
|
|
476
|
+
*/
|
|
477
|
+
export const WEBSITE_PRODUCT_TOUR_DWELL_MS = 7000;
|
|
478
|
+
|
|
479
|
+
/** How long a marquee's strip takes to scroll one copy of its list (s): slow enough to read a pill as it passes. */
|
|
480
|
+
export const WEBSITE_MARQUEE_LOOP_SECONDS = 38;
|
|
481
|
+
|
|
482
|
+
/** How much of a bento's row a tile takes: a third, or a half. */
|
|
483
|
+
export enum WebsiteBentoTileSize {
|
|
484
|
+
/** A third of the row: three tiles side by side. */
|
|
485
|
+
REGULAR = 'regular',
|
|
486
|
+
/** Half the row: the capability that leads, or a drawing that needs the room. */
|
|
487
|
+
WIDE = 'wide',
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
/** How an FAQ lays out its intro and its questions. */
|
|
491
|
+
export enum WebsiteFaqLayout {
|
|
492
|
+
/** The intro in a narrow column beside the questions. */
|
|
493
|
+
SIDE = 'side',
|
|
494
|
+
/** The intro above the questions. */
|
|
495
|
+
STACKED = 'stacked',
|
|
496
|
+
}
|
|
497
|
+
|
|
498
|
+
/**
|
|
499
|
+
* A block's motion, point by point: each named point of the block takes a `WebsiteMotionSpec`, or `null` to keep
|
|
500
|
+
* that point still. Points left out keep the block's defaults. The vocabulary is the engine's (`websiteMotion`), so a
|
|
501
|
+
* block's motion follows the site's tempo and stops under reduced motion like everything else.
|
|
502
|
+
*/
|
|
503
|
+
export type WebsiteBlockMotion<TPoint extends string> = Partial<Readonly<Record<TPoint, WebsiteMotionSpec | null>>>;
|
|
504
|
+
|
|
505
|
+
/**
|
|
506
|
+
* What a block's motion point IS, which decides what motion it may take (#2742 step 4). A block declares each of its
|
|
507
|
+
* points with a kind, and says whether the point belongs to the page's OPENING (the load sequence). Its default and
|
|
508
|
+
* every override are checked against both, so a site, a skill or the creation lane can only ask a point for motion that
|
|
509
|
+
* makes sense there. The rules are a table total over the kinds (`WEBSITE_MOTION_POINT_RULES`): a new kind does not
|
|
510
|
+
* compile until its rules are decided.
|
|
511
|
+
*/
|
|
512
|
+
export enum WebsiteMotionPointKind {
|
|
513
|
+
/** Copy that arrives as a whole: an intro, a feature row's copy, a closing band, a table, a line of the hero. */
|
|
514
|
+
COPY = 'copy',
|
|
515
|
+
/** A list or grid whose children arrive one after another. */
|
|
516
|
+
GROUP = 'group',
|
|
517
|
+
/** A card that is a link. */
|
|
518
|
+
LINK_CARD = 'link-card',
|
|
519
|
+
/** A drawing or an image: the hero's visual, a feature row's visual. */
|
|
520
|
+
MEDIA = 'media',
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
/** What a kind of point may take. */
|
|
524
|
+
export interface WebsiteMotionPointRules {
|
|
525
|
+
/** It may sequence its children (`stagger`). */
|
|
526
|
+
readonly stagger: boolean;
|
|
527
|
+
/** It may answer the pointer (`hover`). */
|
|
528
|
+
readonly hover: boolean;
|
|
529
|
+
/** It may arrive itself (`reveal`). */
|
|
530
|
+
readonly reveal: boolean;
|
|
531
|
+
/** It may take a scroll effect, or arrive by unveiling. */
|
|
532
|
+
readonly media: boolean;
|
|
533
|
+
}
|
|
534
|
+
|
|
535
|
+
export const WEBSITE_MOTION_POINT_RULES: Readonly<Record<WebsiteMotionPointKind, WebsiteMotionPointRules>> = {
|
|
536
|
+
[WebsiteMotionPointKind.COPY]: { stagger: false, hover: false, reveal: true, media: false },
|
|
537
|
+
[WebsiteMotionPointKind.GROUP]: { stagger: true, hover: false, reveal: true, media: false },
|
|
538
|
+
// A link card never arrives itself: its group sequences it.
|
|
539
|
+
[WebsiteMotionPointKind.LINK_CARD]: { stagger: false, hover: true, reveal: false, media: false },
|
|
540
|
+
[WebsiteMotionPointKind.MEDIA]: { stagger: false, hover: false, reveal: true, media: true },
|
|
541
|
+
};
|
|
542
|
+
|
|
543
|
+
/** One motion point of a block: what it is, whether it belongs to the page's opening, and how it moves by default. */
|
|
544
|
+
export interface WebsiteMotionPointDefault {
|
|
545
|
+
readonly kind: WebsiteMotionPointKind;
|
|
546
|
+
/**
|
|
547
|
+
* The point is part of the page's opening: it plays on load, in its `order`. Only such a point may take
|
|
548
|
+
* `trigger: LOAD`, and such a point takes a load reveal or no motion at all (no in-view reveal, no stagger, no scroll
|
|
549
|
+
* effect, no hover), so the opening is exactly the points the blocks declare as such: the hero's eyebrow, headline,
|
|
550
|
+
* lede, actions, note and visual. Whether a page has more than one opening (two heroes) is the page motion plan's
|
|
551
|
+
* question, not a point's.
|
|
552
|
+
*/
|
|
553
|
+
readonly opening?: boolean;
|
|
554
|
+
readonly spec: WebsiteMotionSpec | null;
|
|
555
|
+
}
|
|
556
|
+
|
|
557
|
+
/** Why a spec does not fit a point, or null when it fits. */
|
|
558
|
+
export function websiteMotionPointMisfit(kind: WebsiteMotionPointKind, spec: WebsiteMotionSpec | null, opening = false): string | null {
|
|
559
|
+
if (spec === null) return null;
|
|
560
|
+
// One widened view: the exclusive union is the caller's contract (see `websiteMotion`).
|
|
561
|
+
const { reveal, trigger, stagger, scroll, hover } = spec as {
|
|
562
|
+
readonly reveal?: WebsiteMotionReveal;
|
|
563
|
+
readonly trigger?: WebsiteMotionTrigger;
|
|
564
|
+
readonly stagger?: WebsiteMotionReveal;
|
|
565
|
+
readonly scroll?: WebsiteMotionScrollEffect;
|
|
566
|
+
readonly hover?: WebsiteMotionHover;
|
|
567
|
+
};
|
|
568
|
+
const rules = WEBSITE_MOTION_POINT_RULES[kind];
|
|
569
|
+
const moves = (value: WebsiteMotionReveal | undefined) => value !== undefined && value !== WebsiteMotionReveal.NONE;
|
|
570
|
+
const scrolls = scroll !== undefined && scroll !== WebsiteMotionScrollEffect.NONE;
|
|
571
|
+
// The kinds the table allows a capability, so a message names them from the same table that decided.
|
|
572
|
+
const allowed = (rule: keyof WebsiteMotionPointRules): string[] =>
|
|
573
|
+
(Object.keys(WEBSITE_MOTION_POINT_RULES) as WebsiteMotionPointKind[])
|
|
574
|
+
.filter((candidate) => WEBSITE_MOTION_POINT_RULES[candidate][rule])
|
|
575
|
+
.map((candidate) => candidate.toUpperCase().replace(/-/g, '_'));
|
|
576
|
+
const refused = (what: string, rule: keyof WebsiteMotionPointRules): string => {
|
|
577
|
+
const kinds = allowed(rule);
|
|
578
|
+
return `a ${kind.toUpperCase().replace(/-/g, '_')} point does not ${what}: ${kinds.length === 0 ? 'no kind does' : `only ${kinds.join(' or ')} does`}`;
|
|
579
|
+
};
|
|
580
|
+
if (moves(stagger) && !rules.stagger) return refused('sequence its children (stagger)', 'stagger');
|
|
581
|
+
const hovers = hover !== undefined && hover !== WebsiteMotionHover.NONE;
|
|
582
|
+
if (hovers && !rules.hover) return refused('answer the pointer (hover)', 'hover');
|
|
583
|
+
if (moves(reveal) && !rules.reveal) return refused('reveal itself', 'reveal');
|
|
584
|
+
if (scrolls && !rules.media) return refused('take a scroll effect', 'media');
|
|
585
|
+
if ((reveal === WebsiteMotionReveal.UNVEIL || stagger === WebsiteMotionReveal.UNVEIL) && !rules.media) return refused('unveil', 'media');
|
|
586
|
+
const onLoad = moves(reveal) && trigger === WebsiteMotionTrigger.LOAD;
|
|
587
|
+
if (onLoad && !opening) return 'only a point of the page\'s opening plays on load';
|
|
588
|
+
if (opening && (moves(stagger) || scrolls || hovers)) return 'a point of the page\'s opening takes a load reveal or no motion at all';
|
|
589
|
+
if (opening && moves(reveal) && !onLoad) return 'a point of the page\'s opening plays on load, in its order';
|
|
590
|
+
return null;
|
|
591
|
+
}
|
|
592
|
+
```
|
|
593
|
+
|
|
594
|
+
## The demo frame a drawn screen plays in
|
|
595
|
+
|
|
596
|
+
## Import Origins
|
|
597
|
+
|
|
598
|
+
- `@wildo-ai/saas-website`
|
|
599
|
+
|
|
600
|
+
## Source Excerpts
|
|
601
|
+
|
|
602
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
603
|
+
|
|
604
|
+
```tsx
|
|
605
|
+
*
|
|
606
|
+
* `WebsiteMotionDemo` — the frame around an ANIMATED PRODUCT DEMO: a drawn interface that plays on its own (a task
|
|
607
|
+
* list completing itself, an invoice assembling, an agent answering). Modern product sites show the product moving;
|
|
608
|
+
* this primitive owns the obligations that come with it, so a section only draws the interface and its keyframes.
|
|
609
|
+
*
|
|
610
|
+
* What it guarantees:
|
|
611
|
+
* - **A pause control** (WCAG 2.2.2 "Pause, Stop, Hide": content that moves on its own for more than five seconds,
|
|
612
|
+
* beside other content, must be pausable). A real `<button>` whose text says what it will do — `pauseLabel` while
|
|
613
|
+
* playing, `playLabel` while paused — so its name is the action, never a pressed state that contradicts it.
|
|
614
|
+
* - **Paused while off screen.** An IntersectionObserver marks the frame `data-website-demo-offscreen`, and the
|
|
615
|
+
* engine's motion stylesheet pauses every keyframe animation inside it. A page with six demos animates only what is
|
|
616
|
+
* seen. Paused — by the visitor or off screen — a demo HOLDS what it shows, as a paused video does, and resumes
|
|
617
|
+
* from there.
|
|
618
|
+
* - **A still frame under reduced motion, or a STILL tempo.** The stylesheet removes the stage's animations
|
|
619
|
+
* (`prefers-reduced-motion: reduce`, or a site whose tempo plays no choreography) and hides the control, since
|
|
620
|
+
* there is nothing to pause. So AUTHOR THE STAGE'S BASE STYLES AS THE FINAL STILL FRAME and let the keyframes only
|
|
621
|
+
* add movement: the no-motion-first pattern every other motion rule here follows. A scenario driven by
|
|
622
|
+
* `useWebsiteMotionDemoTimeline` shows its last step, also when the preference changes while the page is open.
|
|
623
|
+
* - **One accessible description instead of fake UI read aloud.** The drawn interface is decorative to a screen
|
|
624
|
+
* reader (`aria-hidden`), and `label` names what it shows (`<figure aria-label>`), the way an image's `alt` would.
|
|
625
|
+
*
|
|
626
|
+
* Demos driven by JavaScript (a tab rotation, a typed message) read `useWebsiteMotionDemoPlaying()` and advance only
|
|
627
|
+
* while it is `true`: the same three conditions (not paused, on screen, motion allowed) gate them.
|
|
628
|
+
*
|
|
629
|
+
* Every word comes from the section's label pack: the engine owns no copy here.
|
|
630
|
+
*
|
|
631
|
+
* @example
|
|
632
|
+
* <WebsiteMotionDemo
|
|
633
|
+
* label={useWebsiteLabel('demo.label')}
|
|
634
|
+
* pauseLabel={useWebsiteLabel('demo.pause')}
|
|
635
|
+
* playLabel={useWebsiteLabel('demo.play')}
|
|
636
|
+
* className="board-demo"
|
|
637
|
+
* >
|
|
638
|
+
* <TaskBoardScreen />
|
|
639
|
+
* </WebsiteMotionDemo>
|
|
640
|
+
*/
|
|
641
|
+
export interface WebsiteMotionDemoProps {
|
|
642
|
+
/** What the demo shows, for assistive technology — the demo's `alt`. From the label pack. */
|
|
643
|
+
label: string;
|
|
644
|
+
/** The control's text while the demo plays. From the label pack (e.g. "Pause the animation"). */
|
|
645
|
+
pauseLabel: string;
|
|
646
|
+
/** The control's text while the demo is paused. From the label pack (e.g. "Play the animation"). */
|
|
647
|
+
playLabel: string;
|
|
648
|
+
/** The drawn interface. Its base styles are the still frame; its keyframes add the movement. */
|
|
649
|
+
children: ReactNode;
|
|
650
|
+
/** The frame the drawing sits in (`WebsiteDemoFrameVariant`); none by default, for a site that frames it itself. */
|
|
651
|
+
frame?: WebsiteDemoFrameVariant;
|
|
652
|
+
className?: string;
|
|
653
|
+
style?: CSSProperties;
|
|
654
|
+
}
|
|
655
|
+
|
|
656
|
+
interface WebsiteMotionDemoPlaybackValue {
|
|
657
|
+
readonly playing: boolean;
|
|
658
|
+
/**
|
|
659
|
+
* Motion is not allowed at all (a reduced-motion preference, or a tempo that plays no choreography), as opposed to
|
|
660
|
+
* merely paused. A still demo shows its finished picture; a paused one holds what it shows.
|
|
661
|
+
*/
|
|
662
|
+
readonly still: boolean;
|
|
663
|
+
}
|
|
664
|
+
|
|
665
|
+
const WebsiteMotionDemoPlaybackContext = createContext<WebsiteMotionDemoPlaybackValue | null>(null);
|
|
666
|
+
|
|
667
|
+
const REDUCED_MOTION_QUERY = '(prefers-reduced-motion: reduce)';
|
|
668
|
+
|
|
669
|
+
function subscribeToReducedMotion(onChange: () => void): () => void {
|
|
670
|
+
if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return () => undefined;
|
|
671
|
+
const query = window.matchMedia(REDUCED_MOTION_QUERY);
|
|
672
|
+
query.addEventListener('change', onChange);
|
|
673
|
+
return () => query.removeEventListener('change', onChange);
|
|
674
|
+
}
|
|
675
|
+
|
|
676
|
+
function readReducedMotion(): boolean {
|
|
677
|
+
if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return false;
|
|
678
|
+
return window.matchMedia(REDUCED_MOTION_QUERY).matches;
|
|
679
|
+
}
|
|
680
|
+
|
|
681
|
+
/**
|
|
682
|
+
* Whether the enclosing demo is playing right now: not paused by the visitor, on screen, and allowed to move (no
|
|
683
|
+
* reduced-motion preference, a tempo that plays choreography). `false` on the server and before the frame has been
|
|
684
|
+
* observed, so a JavaScript-driven demo renders its first frame and starts only once it is known to be seen.
|
|
685
|
+
*
|
|
686
|
+
* Throws outside a `WebsiteMotionDemo` or `WebsiteMotionDemoGroup`: a timer that ignored the pause control would be the WCAG 2.2.2 failure this
|
|
687
|
+
* primitive exists to prevent, so there is no silent default.
|
|
688
|
+
*/
|
|
689
|
+
export function useWebsiteMotionDemoPlaying(): boolean {
|
|
690
|
+
const value = useContext(WebsiteMotionDemoPlaybackContext);
|
|
691
|
+
if (value === null) {
|
|
692
|
+
throw new Error('useWebsiteMotionDemoPlaying() must be called inside a <WebsiteMotionDemo> or a <WebsiteMotionDemoGroup>.');
|
|
693
|
+
}
|
|
694
|
+
return value.playing;
|
|
695
|
+
}
|
|
696
|
+
|
|
697
|
+
const VISUALLY_HIDDEN: CSSProperties = {
|
|
698
|
+
position: 'absolute',
|
|
699
|
+
width: 1,
|
|
700
|
+
height: 1,
|
|
701
|
+
padding: 0,
|
|
702
|
+
margin: -1,
|
|
703
|
+
overflow: 'hidden',
|
|
704
|
+
clip: 'rect(0, 0, 0, 0)',
|
|
705
|
+
whiteSpace: 'nowrap',
|
|
706
|
+
border: 0,
|
|
707
|
+
};
|
|
708
|
+
|
|
709
|
+
/** The control's glyph: two bars while playing (the action is "pause"), a triangle while paused. */
|
|
710
|
+
function DemoToggleGlyph({ paused }: { paused: boolean }): ReactNode {
|
|
711
|
+
return (
|
|
712
|
+
<svg width="12" height="12" viewBox="0 0 12 12" aria-hidden="true" focusable="false">
|
|
713
|
+
{paused ? (
|
|
714
|
+
<path d="M3 1.5v9l7.5-4.5z" fill="currentColor" />
|
|
715
|
+
) : (
|
|
716
|
+
<path d="M2.5 1.5h2.5v9H2.5zM7 1.5h2.5v9H7z" fill="currentColor" />
|
|
717
|
+
)}
|
|
718
|
+
</svg>
|
|
719
|
+
);
|
|
720
|
+
}
|
|
721
|
+
|
|
722
|
+
/** What both frames share: the observed frame, the visitor's pause, and the playback flag their timers read. */
|
|
723
|
+
function useMotionDemoPlayback(): {
|
|
724
|
+
readonly attachFrame: (element: HTMLElement | null) => void;
|
|
725
|
+
readonly paused: boolean;
|
|
726
|
+
readonly toggle: () => void;
|
|
727
|
+
readonly playing: boolean;
|
|
728
|
+
readonly still: boolean;
|
|
729
|
+
readonly frameAttributes: Record<string, string>;
|
|
730
|
+
} {
|
|
731
|
+
const frameRef = useRef<HTMLElement | null>(null);
|
|
732
|
+
const [paused, setPaused] = useState(false);
|
|
733
|
+
/** `null` until the observer has answered: neither "on screen" nor "off screen" is known yet. */
|
|
734
|
+
const [onScreen, setOnScreen] = useState<boolean | null>(null);
|
|
735
|
+
const reducedMotion = useSyncExternalStore(subscribeToReducedMotion, readReducedMotion, () => false);
|
|
736
|
+
const tempo = resolveWebsiteMotionTokens(useWebsiteDesignTokens().motion).tempo;
|
|
737
|
+
const tempoMoves = WEBSITE_MOTION_TEMPO[tempo].playsChoreography;
|
|
738
|
+
|
|
739
|
+
useEffect(() => {
|
|
740
|
+
const frame = frameRef.current;
|
|
741
|
+
if (frame === null) return undefined;
|
|
742
|
+
if (typeof IntersectionObserver === 'undefined') {
|
|
743
|
+
// No observer (an old engine, a test environment): treat the demo as seen rather than freezing it forever.
|
|
744
|
+
setOnScreen(true);
|
|
745
|
+
return undefined;
|
|
746
|
+
}
|
|
747
|
+
const observer = new IntersectionObserver((entries) => {
|
|
748
|
+
const entry = entries[entries.length - 1];
|
|
749
|
+
if (entry !== undefined) setOnScreen(entry.isIntersecting);
|
|
750
|
+
});
|
|
751
|
+
observer.observe(frame);
|
|
752
|
+
return () => observer.disconnect();
|
|
753
|
+
}, []);
|
|
754
|
+
|
|
755
|
+
const toggle = useCallback(() => setPaused((current) => !current), []);
|
|
756
|
+
const attachFrame = useCallback((element: HTMLElement | null) => {
|
|
757
|
+
frameRef.current = element;
|
|
758
|
+
}, []);
|
|
759
|
+
const frameAttributes: Record<string, string> = { [WebsiteMotionDemoAttribute.FRAME]: '' };
|
|
760
|
+
if (paused) frameAttributes[WebsiteMotionDemoAttribute.PAUSED] = '';
|
|
761
|
+
if (onScreen === false) frameAttributes[WebsiteMotionDemoAttribute.OFFSCREEN] = '';
|
|
762
|
+
const still = reducedMotion || !tempoMoves;
|
|
763
|
+
return { attachFrame, paused, toggle, playing: !paused && onScreen === true && !still, still, frameAttributes };
|
|
764
|
+
}
|
|
765
|
+
|
|
766
|
+
/** The pause / play control both frames render: a real button whose text is the action it will take. */
|
|
767
|
+
function DemoToggle({ paused, toggle, pauseLabel, playLabel }: { paused: boolean; toggle: () => void; pauseLabel: string; playLabel: string }): ReactNode {
|
|
768
|
+
return (
|
|
769
|
+
<button type="button" onClick={toggle} title={paused ? playLabel : pauseLabel} {...{ [WebsiteMotionDemoAttribute.TOGGLE]: '' }}>
|
|
770
|
+
<DemoToggleGlyph paused={paused} />
|
|
771
|
+
<span style={VISUALLY_HIDDEN}>{paused ? playLabel : pauseLabel}</span>
|
|
772
|
+
</button>
|
|
773
|
+
);
|
|
774
|
+
}
|
|
775
|
+
|
|
776
|
+
export function WebsiteMotionDemo({ label, pauseLabel, playLabel, children, frame, className, style }: WebsiteMotionDemoProps): ReactNode {
|
|
777
|
+
const { attachFrame, paused, toggle, playing, still, frameAttributes } = useMotionDemoPlayback();
|
|
778
|
+
return (
|
|
779
|
+
<WebsiteMotionDemoPlaybackContext.Provider value={{ playing, still }}>
|
|
780
|
+
<figure ref={attachFrame} className={className} style={style} aria-label={label} {...frameAttributes} {...websiteDemoFrameAttributes(frame)}>
|
|
781
|
+
<div {...{ [WebsiteMotionDemoAttribute.STAGE]: '' }} aria-hidden="true" inert>
|
|
782
|
+
{children}
|
|
783
|
+
</div>
|
|
784
|
+
<DemoToggle paused={paused} toggle={toggle} pauseLabel={pauseLabel} playLabel={playLabel} />
|
|
785
|
+
</figure>
|
|
786
|
+
</WebsiteMotionDemoPlaybackContext.Provider>
|
|
787
|
+
);
|
|
788
|
+
}
|
|
789
|
+
WebsiteMotionDemo.displayName = 'WebsiteMotionDemo';
|
|
790
|
+
|
|
791
|
+
/**
|
|
792
|
+
* `WebsiteMotionDemoGroup` — ONE pause control for several small animated visuals that sit among readable content:
|
|
793
|
+
* a bento grid whose tiles each carry a tiny loop, an integrations marquee beside its accessible list. Unlike
|
|
794
|
+
* `WebsiteMotionDemo`, the group's own content stays readable; each drawn visual inside it goes in a
|
|
795
|
+
* `WebsiteMotionDemoStage`, which is what the stylesheet pauses and assistive technology skips. Same guarantees:
|
|
796
|
+
* paused off screen, still under reduced motion, `useWebsiteMotionDemoPlaying()` for JavaScript timers.
|
|
797
|
+
*/
|
|
798
|
+
export interface WebsiteMotionDemoGroupProps {
|
|
799
|
+
/** The control's text while the visuals play. From the label pack. */
|
|
800
|
+
pauseLabel: string;
|
|
801
|
+
/** The control's text while they are paused. From the label pack. */
|
|
802
|
+
playLabel: string;
|
|
803
|
+
children: ReactNode;
|
|
804
|
+
className?: string;
|
|
805
|
+
style?: CSSProperties;
|
|
806
|
+
}
|
|
807
|
+
|
|
808
|
+
export function WebsiteMotionDemoGroup({ pauseLabel, playLabel, children, className, style }: WebsiteMotionDemoGroupProps): ReactNode {
|
|
809
|
+
const { attachFrame, paused, toggle, playing, still, frameAttributes } = useMotionDemoPlayback();
|
|
810
|
+
return (
|
|
811
|
+
<WebsiteMotionDemoPlaybackContext.Provider value={{ playing, still }}>
|
|
812
|
+
<div ref={attachFrame} className={className} style={style} {...frameAttributes}>
|
|
813
|
+
{/* First in reading order, before what it controls (the APG carousel pattern); drawn where the stylesheet places it. */}
|
|
814
|
+
<DemoToggle paused={paused} toggle={toggle} pauseLabel={pauseLabel} playLabel={playLabel} />
|
|
815
|
+
{children}
|
|
816
|
+
</div>
|
|
817
|
+
</WebsiteMotionDemoPlaybackContext.Provider>
|
|
818
|
+
);
|
|
819
|
+
}
|
|
820
|
+
WebsiteMotionDemoGroup.displayName = 'WebsiteMotionDemoGroup';
|
|
821
|
+
|
|
822
|
+
/**
|
|
823
|
+
* One drawn, animated visual inside a `WebsiteMotionDemoGroup`: decorative to assistive technology (the readable
|
|
824
|
+
* content beside it carries the meaning), and governed by the group's pause control. Refuses outside a group or a
|
|
825
|
+
* demo, so a loop can never escape the control.
|
|
826
|
+
*/
|
|
827
|
+
export function WebsiteMotionDemoStage({ children, className }: { children: ReactNode; className?: string }): ReactNode {
|
|
828
|
+
if (useContext(WebsiteMotionDemoPlaybackContext) === null) {
|
|
829
|
+
throw new Error('<WebsiteMotionDemoStage> must be placed inside a <WebsiteMotionDemoGroup> or a <WebsiteMotionDemo>.');
|
|
830
|
+
}
|
|
831
|
+
return (
|
|
832
|
+
<div className={className} aria-hidden="true" inert {...{ [WebsiteMotionDemoAttribute.STAGE]: '' }}>
|
|
833
|
+
{children}
|
|
834
|
+
</div>
|
|
835
|
+
);
|
|
836
|
+
}
|
|
837
|
+
WebsiteMotionDemoStage.displayName = 'WebsiteMotionDemoStage';
|
|
838
|
+
|
|
839
|
+
/**
|
|
840
|
+
* A drawn demo's scenario as STEPS, each held for its duration (ms) before the next; returns the step to draw.
|
|
841
|
+
*
|
|
842
|
+
* The LAST step is the still frame: what the server renders, and what a visitor who asked for reduced motion (or a
|
|
843
|
+
* site whose tempo is STILL) sees, also when that preference changes while the page is open. Author the scenario so
|
|
844
|
+
* its last step is the finished picture (the item completed, the change approved): the loop opens by holding it,
|
|
845
|
+
* then replays from step 0.
|
|
846
|
+
*
|
|
847
|
+
* PAUSED is different from still. When the visitor presses the control, or the demo leaves the screen, the timeline
|
|
848
|
+
* HOLDS the step it is on, as a paused video does, and resumes from it.
|
|
849
|
+
*
|
|
850
|
+
* Steps advance only while the enclosing demo plays (`useWebsiteMotionDemoPlaying`), which gives the visitor's pause
|
|
851
|
+
* control (WCAG 2.2.2) authority over the JavaScript half of a demo. The CSS half is the stage's keyframe animations,
|
|
852
|
+
* which the engine's stylesheet pauses; a transition runs only when a step changes, so a held step starts none.
|
|
853
|
+
* Throws outside a demo, for the same reason the playback flag does, and for an empty scenario.
|
|
854
|
+
*
|
|
855
|
+
* The durations are read by value, so an inline array is fine: a re-render with the same numbers keeps the timer.
|
|
856
|
+
*
|
|
857
|
+
* @example
|
|
858
|
+
* ```tsx
|
|
859
|
+
* const step = useWebsiteMotionDemoTimeline([700, 900, 3200]); // typed → added → completed (the still frame)
|
|
860
|
+
* return <li className={step >= 2 ? 'task task--done' : 'task'}>…</li>;
|
|
861
|
+
* ```
|
|
862
|
+
*/
|
|
863
|
+
export function useWebsiteMotionDemoTimeline(stepDurations: readonly number[]): number {
|
|
864
|
+
return useWebsiteMotionDemoTimelinePosition(stepDurations).step;
|
|
865
|
+
}
|
|
866
|
+
|
|
867
|
+
/**
|
|
868
|
+
* `useWebsiteMotionDemoTimeline`, with how many times the timeline has advanced. A step reached again on the next loop
|
|
869
|
+
* is a new VISIT of it, and `advances` tells the two apart where the step number cannot: the scenario player starts
|
|
870
|
+
* each visit's typing afresh by it, and a bespoke scene restarts anything it runs within a step the same way.
|
|
871
|
+
*/
|
|
872
|
+
export function useWebsiteMotionDemoTimelinePosition(stepDurations: readonly number[]): { readonly step: number; readonly advances: number } {
|
|
873
|
+
const playback = useContext(WebsiteMotionDemoPlaybackContext);
|
|
874
|
+
if (playback === null) {
|
|
875
|
+
throw new Error('A demo timeline (useWebsiteMotionDemoTimeline, useWebsiteDemoScenario) must run inside a <WebsiteMotionDemo> or a <WebsiteMotionDemoGroup>.');
|
|
876
|
+
}
|
|
877
|
+
if (stepDurations.length === 0) throw new Error('A demo timeline needs at least one step.');
|
|
878
|
+
const { playing, still } = playback;
|
|
879
|
+
const last = stepDurations.length - 1;
|
|
880
|
+
const durationsKey = stepDurations.join(',');
|
|
881
|
+
const durations = useRef(stepDurations);
|
|
882
|
+
durations.current = stepDurations;
|
|
883
|
+
const [position, setPosition] = useState({ step: last, advances: 0 });
|
|
884
|
+
useEffect(() => {
|
|
885
|
+
if (!playing) return undefined;
|
|
886
|
+
const timer = setTimeout(
|
|
887
|
+
() => setPosition((current) => ({ step: (current.step + 1) % durations.current.length, advances: current.advances + 1 })),
|
|
888
|
+
durations.current[position.step] ?? 1000,
|
|
889
|
+
);
|
|
890
|
+
return () => clearTimeout(timer);
|
|
891
|
+
}, [playing, position, durationsKey]);
|
|
892
|
+
return still ? { step: last, advances: position.advances } : { step: Math.min(position.step, last), advances: position.advances };
|
|
893
|
+
}
|
|
894
|
+
|
|
895
|
+
/**
|
|
896
|
+
* The frame a drawn product sits in on the page (#2742): `STAGE`, `PLAIN` or `BACKDROP` (`WebsiteDemoFrameVariant`).
|
|
897
|
+
* A frame is also the SIZE CONTAINER a drawing measures itself against, so the drawing inside scales with the frame as
|
|
898
|
+
* one picture, and it takes its container's full width, so it never collapses to its padding inside a parent that
|
|
899
|
+
* centres its children. On an INVERSE band a stage and a backdrop take the product's night colours; a site sets
|
|
900
|
+
* `--website-kit-frame-background` on a frame to give it its own background.
|
|
901
|
+
*
|
|
902
|
+
* Give `WebsiteMotionDemo` a `frame`, or wrap a drawing that sits inside another block's demo group (a product tour's
|
|
903
|
+
* screen, a bento tile) in `WebsiteDemoFrame`. Like a stage, a standalone frame refuses outside a group or a demo: a
|
|
904
|
+
* drawing's loops must always answer a pause control.
|
|
905
|
+
*/
|
|
906
|
+
export function websiteDemoFrameAttributes(variant: WebsiteDemoFrameVariant | undefined): Record<string, string> {
|
|
907
|
+
return variant === undefined ? {} : { [WebsiteMotionDemoAttribute.FRAME_VARIANT]: variant };
|
|
908
|
+
}
|
|
909
|
+
|
|
910
|
+
export function WebsiteDemoFrame({ variant, children }: { readonly variant: WebsiteDemoFrameVariant; readonly children: ReactNode }): ReactNode {
|
|
911
|
+
if (useContext(WebsiteMotionDemoPlaybackContext) === null) {
|
|
912
|
+
throw new Error('<WebsiteDemoFrame> must be placed inside a <WebsiteMotionDemoGroup> or a <WebsiteMotionDemo>.');
|
|
913
|
+
}
|
|
914
|
+
return <div {...websiteDemoFrameAttributes(variant)}>{children}</div>;
|
|
915
|
+
}
|
|
916
|
+
WebsiteDemoFrame.displayName = 'WebsiteDemoFrame';
|
|
917
|
+
```
|