@wildo-ai/framework-knowledge 1.1.4 → 1.1.6
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 +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +547 -17
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- 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 +1 -4
- 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 +135 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
- 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 +374 -11
- 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 +6 -4
- 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 +22 -20
- 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 +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 +1 -6
- 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 +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- 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 +18 -8
- 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 +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
- 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 +68 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -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 +1 -2
- 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 +78 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- 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 +172 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
- 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 +173 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
- 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 +9 -8
- 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 +3 -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 +23 -4
- 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 +6 -4
- 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 +22 -13
- 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 +193 -28
- 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 +173 -34
- 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.d.ts +3 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
- 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 +183 -6
- 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 +192 -6
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
- 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 +173 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
- 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.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
- 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.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
- 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.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
- 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 +33 -5
- 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 +28 -4
- 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 -3
- 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 +5 -3
- 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 +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
- 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 +19 -5
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
- 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 +187 -5
- 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 +7 -6
- 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 +28 -19
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- 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 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
- 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/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +174 -0
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +318 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +217 -0
- package/dist/knowledge/references/market.alternative.config.md +2 -2
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +4 -4
- package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
- package/dist/knowledge/references/market.gain.config.md +2 -2
- package/dist/knowledge/references/market.icp.config.md +3 -3
- package/dist/knowledge/references/market.job.config.md +2 -2
- package/dist/knowledge/references/market.message-template.config.md +3 -3
- package/dist/knowledge/references/market.objection.config.md +2 -2
- package/dist/knowledge/references/market.pain.config.md +2 -2
- package/dist/knowledge/references/market.persona.config.md +3 -3
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +2 -2
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
- package/dist/knowledge/references/market.trigger.config.md +2 -2
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +375 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +15 -36
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
- package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +238 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +4 -2
- package/dist/knowledge/references/zod.factories.duration.md +6 -4
- package/dist/knowledge/references/zod.factories.money.md +5 -3
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +2602 -214
- package/dist/knowledge/registries/playbooks.json +468 -92
- package/dist/knowledge/registries/source-tags.json +6171 -1996
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +137 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +67 -29
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
- package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
- package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
- package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
- package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +12659 -4142
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md
ADDED
|
@@ -0,0 +1,480 @@
|
|
|
1
|
+
# Framework component catalog — the chooser
|
|
2
|
+
|
|
3
|
+
Every component the framework exports for an application to compose, with what it
|
|
4
|
+
renders, when it is the right choice, and when it is not.
|
|
5
|
+
|
|
6
|
+
**Do not read this file whole — it is ~18,000 tokens.** Pull the one group you
|
|
7
|
+
need (`sed -n '/^## <Group> /,/^## /p'`) or search it by keyword; the rows are
|
|
8
|
+
one per line. The skill body carries the map of groups, so you can narrow before
|
|
9
|
+
opening anything. Read `framework-component-usage.md` — one entry at a time —
|
|
10
|
+
once you have picked a component and need its props, its composition rules, or a
|
|
11
|
+
truthful snippet.
|
|
12
|
+
|
|
13
|
+
Everything below is imported from a single package:
|
|
14
|
+
|
|
15
|
+
```tsx
|
|
16
|
+
import { Badge, Card, DescriptionList } from '@wildo-ai/saas-frontend-lib';
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Groups are functional, taken from where each component's specification lives, and
|
|
20
|
+
ordered alphabetically so a group keeps its place as components are added. A
|
|
21
|
+
component that is not listed here is not importable — the framework mounts it itself (the high-level
|
|
22
|
+
views, the guidance renderers, the settings hub, the lifecycle home screens), and
|
|
23
|
+
an application reaches those through configuration, never through JSX.
|
|
24
|
+
|
|
25
|
+
## Actions (6)
|
|
26
|
+
|
|
27
|
+
| Component | Renders | Use when | Avoid when |
|
|
28
|
+
| --- | --- | --- | --- |
|
|
29
|
+
| `ActionBar` | Horizontal toolbar of `ActionButton` entries following the WAI-ARIA toolbar pattern (roving tabindex). | Use when several related actions apply to the same context (table row, card header, editor chrome) and some may collapse into overflow. | Avoid when a single primary action suffices; prefer an isolated `Button` or `ActionButton`. |
|
|
30
|
+
| `ActionButton` | Toolbar or row-level action control that composes the framework `Button` with tooltip and propagation-safe click handling. | Use when space is limited (data tables, cards, toolbars) and the primary affordance is an icon, optionally with a short adjacent label. | Avoid for the main call-to-action of a form or dialog; prefer `LOW_LEVEL_BUTTON` when the action needs full-width or prominent text. |
|
|
31
|
+
| `Button` | Low-level actionable control that downstream presets, forms, dialogs, and resource surfaces can rely on as the default button primitive. | Use this slot when the product needs a standard framework button with predictable action semantics rather than a specialized action bar, toggle, or navigation-only affordance. | Avoid treating this slot as the owner of domain-specific workflow semantics; higher-level action presets should add that meaning on top rather than overloading the primitive itself. |
|
|
32
|
+
| `ButtonGroup` | Layout primitive with `role="group"` that removes inner borders/radius between children for a unified affordance. | Use when tightly related actions or inputs should read as one control cluster (e.g. pagination prev/next, segmented filters). | Avoid when children are unrelated; prefer spacing them as separate buttons. |
|
|
33
|
+
| `ButtonGroupSeparator` | Decorative or semantic divider implemented with the framework `Separator` primitive, oriented for group layout. | Use when grouping unrelated action clusters inside one `ButtonGroup` shell. | Avoid when spacing alone is enough; separators add visual weight. |
|
|
34
|
+
| `ButtonGroupText` | Static text cell that shares border, padding, and typography rhythm with adjacent grouped controls. | Use for unit labels, currency prefixes, or short descriptors that belong visually inside the group. | Avoid for long paragraphs; keep content to a short phrase. |
|
|
35
|
+
|
|
36
|
+
## Ai Elements / Artifacts (6)
|
|
37
|
+
|
|
38
|
+
| Component | Renders | Use when | Avoid when |
|
|
39
|
+
| --- | --- | --- | --- |
|
|
40
|
+
| `AI_Artifact` | Compound artifact surface used in chat and trace timelines. | Use when a model returns downloadable or previewable artifacts. | Avoid for plain text snippets — prefer `AI_CodeBlock` or inline message content. |
|
|
41
|
+
| `AI_ArtifactList` | Compound list + item + content variants for artifact browser UIs. | Use when multiple artifacts must be discoverable in one surface. | Avoid when a single artifact suffices inline. |
|
|
42
|
+
| `AI_CodeBlock` | Read-only code presentation inside assistant messages. | Use for snippets and command examples returned by the model. | Avoid when monospace plain text in a message is enough. |
|
|
43
|
+
| `AI_DiffBlock` | Read-only review of a change before the person decides on it — a run's writes, a task's change set, a schema-plan drift. Long files start collapsed; a binary or oversized file renders a one-line notice. | Use wherever a person is shown WHAT changed and asked to accept, revert or act on it. | Avoid for a single file's full content (the code block) and for a change that is not a text diff. |
|
|
44
|
+
| `AI_Image` | Image tile for multimodal assistant output. | Use when image parts are present in model responses. | Avoid when only external URLs are shown without generation metadata. |
|
|
45
|
+
| `AI_WebPreview` | Compound preview for web browsing tool results. | Use when agents return URLs that should be inspected in-place. | Avoid when link cards or plain anchors meet the need. |
|
|
46
|
+
|
|
47
|
+
## Ai Elements / Chat (6)
|
|
48
|
+
|
|
49
|
+
| Component | Renders | Use when | Avoid when |
|
|
50
|
+
| --- | --- | --- | --- |
|
|
51
|
+
| `AI_Conversation` | Stick-to-bottom compound wrapping message lists. | Use as the root of assistant chat layouts. | Avoid for single-shot prompts without history. |
|
|
52
|
+
| `AI_Message` | Large compound covering user/assistant/system roles. | Use for every message row inside `AI_Conversation`. | Avoid when rendering plain text without actions or branching. |
|
|
53
|
+
| `AI_PromptInput` | Very large compound built from command/menu/select primitives. | Use as the primary chat input for power users. | Avoid when a single textarea without attachments is enough. |
|
|
54
|
+
| `AI_Sources` | Popover-style sources list with external links. | Use when RAG or web browsing produces reference URLs. | Avoid when answers are not attributed to sources. |
|
|
55
|
+
| `AI_Suggestion` | Chip-style CTA feeding the composer. | Use beneath assistant messages to steer the next turn. | Avoid when suggestions are shown only as a batch list. |
|
|
56
|
+
| `AI_Suggestions` | Horizontal suggestion scroller. | Use when several follow-ups should be visible at once. | Avoid when only one suggestion is offered. |
|
|
57
|
+
|
|
58
|
+
## Ai Elements / Decision (4)
|
|
59
|
+
|
|
60
|
+
| Component | Renders | Use when | Avoid when |
|
|
61
|
+
| --- | --- | --- | --- |
|
|
62
|
+
| `AI_ApprovalQueue` | Batch review surface for multiple approval requests. | Use in operator consoles managing many concurrent agent actions. | Avoid when only one approval is ever in flight. |
|
|
63
|
+
| `AI_ApprovalRequest` | Inline human-in-the-loop gate for risky tool calls. | Use when policies require explicit approval before execution. | Avoid when automation should proceed without confirmation. |
|
|
64
|
+
| `AI_DecisionRequest` | Branching UI for structured decisions returned by agents. | Use when the model enumerates explicit next-step choices. | Avoid when free-text replies are preferred over enumerated options. |
|
|
65
|
+
| `AI_HumanInputRequest` | Form-like prompt embedded in agent flows. | Use when agents pause for missing parameters or clarifications. | Avoid when structured enums cover all inputs. |
|
|
66
|
+
|
|
67
|
+
## Ai Elements / Execution (4)
|
|
68
|
+
|
|
69
|
+
| Component | Renders | Use when | Avoid when |
|
|
70
|
+
| --- | --- | --- | --- |
|
|
71
|
+
| `AI_Confirmation` | Inline alert showing approve/deny outcomes for tools. | Use when tools require explicit user approval in the transcript. | Avoid for general notifications — use `Alert`. |
|
|
72
|
+
| `AI_Queue` | Compound list for agent task queues. | Use when plans expose structured steps or parallel todos. | Avoid for simple linear logs without sections. |
|
|
73
|
+
| `AI_Task` | Task runner visualization inside traces. | Use when breaking work into checklist-style tasks. | Avoid when a flat log of events is clearer. |
|
|
74
|
+
| `AI_Tool` | Collapsible tool call viewer mirroring AI SDK tool UI states. | Use for every tool part rendered in an assistant message. | Avoid when tool IO should remain hidden. |
|
|
75
|
+
|
|
76
|
+
## Ai Elements / Graph (7)
|
|
77
|
+
|
|
78
|
+
| Component | Renders | Use when | Avoid when |
|
|
79
|
+
| --- | --- | --- | --- |
|
|
80
|
+
| `AI_Canvas` | Graph workspace root for nodes, edges, and controls. | Use for visual planners, workflows, or tool graphs. | Avoid when a textual trace fully substitutes for a graph. |
|
|
81
|
+
| `AI_Connection` | Geometry-based edge drawing helper. | Use in custom graph layouts between handles. | Avoid when standard `AI_Edge` from React Flow suffices exclusively. |
|
|
82
|
+
| `AI_Controls` | Wrapper around xyflow Controls primitive. | Use on graph surfaces needing camera controls. | Avoid on read-only tiny previews. |
|
|
83
|
+
| `AI_Edge` | Custom edge preset between `AI_Node` instances. | Use in agent graphs with explicit directed relationships. | Avoid when graphs are not used. |
|
|
84
|
+
| `AI_Node` | Primary vertex visual for flow graphs. | Use for each step, tool, or decision in a visual plan. | Avoid for list-only traces. |
|
|
85
|
+
| `AI_Panel` | Simple div shell positioned beside or over the canvas. | Use when selection details should sit adjacent to the graph. | Avoid when modals replace side panels. |
|
|
86
|
+
| `AI_Toolbar` | Distinct from `APPLICATION_LEVEL_TOOLBAR` — scoped to graph interactions. | Use above or floating on graph canvases. | Avoid when graph is view-only without editing actions. |
|
|
87
|
+
|
|
88
|
+
## Ai Elements / Meta (7)
|
|
89
|
+
|
|
90
|
+
| Component | Renders | Use when | Avoid when |
|
|
91
|
+
| --- | --- | --- | --- |
|
|
92
|
+
| `AI_AgentCapabilities` | Capability matrix or bullet list in configuration UI. | Use when transparency about tool access is required. | Avoid when capabilities are implied and need not be listed. |
|
|
93
|
+
| `AI_AgentCard` | Dense summary tile within agent configuration flows. | Use in grids comparing agents or showing detail previews. | Avoid when list rows without cards suffice. |
|
|
94
|
+
| `AI_AgentList` | Agent catalog row list for settings or launcher surfaces. | Use when users manage multiple agents side by side. | Avoid for single-agent products without switching. |
|
|
95
|
+
| `AI_AgentPromptSpec` | Prompt inspector block with formatting tuned for long text. | Use in agent authoring and audit screens. | Avoid when prompts are fully opaque to end users. |
|
|
96
|
+
| `AI_Context` | Hover-card based usage breakdown. | Use near prompts or messages to explain cost/limit context. | Avoid when usage telemetry is not surfaced to users. |
|
|
97
|
+
| `AI_ModelSelector` | Dialog + command palette composition for LLM choice. | Use when users can switch models mid-session. | Avoid when model is fixed per tenant. |
|
|
98
|
+
| `AI_OpenInChat` | Provider menu (ChatGPT, Claude, …) anchored on a trigger. | Use for “open in …” affordances on prompts or citations. | Avoid when external handoff is disallowed. |
|
|
99
|
+
|
|
100
|
+
## Ai Elements / Shared (2)
|
|
101
|
+
|
|
102
|
+
| Component | Renders | Use when | Avoid when |
|
|
103
|
+
| --- | --- | --- | --- |
|
|
104
|
+
| `AI_Loader` | Inline loading indicator sized for chat rows. | Use while waiting for first token or tool output. | Avoid for full-page loading — use framework loading overlays. |
|
|
105
|
+
| `AI_Shimmer` | Motion highlight over arbitrary text or headings. | Use for skeleton-like text effects in AI surfaces. | Avoid when reduced-motion or static placeholders are required. |
|
|
106
|
+
|
|
107
|
+
## Ai Elements / Trace (5)
|
|
108
|
+
|
|
109
|
+
| Component | Renders | Use when | Avoid when |
|
|
110
|
+
| --- | --- | --- | --- |
|
|
111
|
+
| `AI_ChainOfThought` | Trace visualization for reasoning segments. Compound: `AI_ChainOfThought` (the disclosure root), `AI_ChainOfThoughtHeader`, `AI_ChainOfThoughtStep` (label, description, status, icon), `AI_ChainOfThoughtSearchResults` / `AI_ChainOfThoughtSearchResult`, `AI_ChainOfThoughtContent`, `AI_ChainOfThoughtImage`. | Use when models expose intermediate reasoning safely. | Avoid when policy hides chain-of-thought from end users. |
|
|
112
|
+
| `AI_Checkpoint` | Dot/flag in trace timelines. | Use to mark saved states or resume points. | Avoid when linear logs do not support resume semantics. |
|
|
113
|
+
| `AI_InlineCitation` | Compound citation with carousel for multi-source references. | Use inside assistant markdown for attributed claims. | Avoid when citations are only footnotes without hover UI. |
|
|
114
|
+
| `AI_Plan` | Card + collapsible composition for structured plans. | Use when agents emit explicit multi-step plans. | Avoid for unstructured prose-only replies. |
|
|
115
|
+
| `AI_Reasoning` | Collapsible content area with streaming-friendly layout. | Use when showing model reasoning separate from final answer. | Avoid when reasoning must not be displayed. |
|
|
116
|
+
|
|
117
|
+
## App (10)
|
|
118
|
+
|
|
119
|
+
| Component | Renders | Use when | Avoid when |
|
|
120
|
+
| --- | --- | --- | --- |
|
|
121
|
+
| `AppLayout_ConsentGate` | Mounted by the authenticated route around the application shell, so it runs on every signed-in page (page content is rendered by the navigation zones, not by the route outlet). REQUIRED replaces the whole shell with a panel naming the missing purposes, the operator's description of what they gate, the optional purposes unticked, and agree / sign-out actions; PROMPT draws a non-blocking fixed panel in the viewport's bottom-right corner. Each row carries the purpose NAME, a sentence saying what agreeing to it means for the person, and an unticked control, led by an always-active row — checked and disabled — that states what runs whatever they choose. The panel is height-capped with the rows scrolling inside it, so the actions stay reachable; decline-all and grant-all carry the SAME variant and neither is the filled one, and a save action appears only where a MIXED choice exists to save (two or more optional purposes). The wrapper, not the preset, decides whether the application renders. | Use through `AppLayout_AuthenticatedRoute`, which already mounts it; replace the preset to restyle the panels. | Avoid on public routes (sign-in, registration, the public privacy notice must stay reachable without consent) and for visitor-tier website consent, which is `WebsiteConsentGate`. Never render the application from a custom preset: the wrapper withholds it while a required purpose is missing. |
|
|
122
|
+
| `AppLayout_DocumentAcceptanceGate` | Mounted by the authenticated route around the consent gate, so it runs on every signed-in page and a person agrees to the terms before being asked about processing. While an acceptance is owed the wrapper renders the preset INSTEAD of the application: a panel with a heading that says whether they never accepted or the terms changed, the same acceptance control registration uses (so the three acceptance modes, the reading gate and the document links behave identically), and two equal outline actions — sign out, and accept and continue, the latter disabled until the mode's condition is met. The owed set is read from the server, the application renders while that read is in flight, and a read that fails lets the application render rather than lock everyone out: acceptance is a rendering posture, not a server-side gate. | Use through `AppLayout_AuthenticatedRoute`, which already mounts it; replace the preset to restyle the panel. | Avoid on public routes (sign-in, registration and the public documents must stay reachable without accepting anything) and for the acceptance asked AT sign-up, which is `PublicLayout_UserRegister`. Never render the application from a custom preset: the wrapper withholds it while an acceptance is owed. |
|
|
123
|
+
| `AppLayout_ErrorBoundary` | ErrorDisplay shell driven by caught error + errorInfo with try-again and go-home actions. | Use inside app-level error boundary when a subtree throws. | Avoid for router-level errors — prefer `APP_LAYOUTS_ROUTER_ERROR_BOUNDARY`. |
|
|
124
|
+
| `AppLayout_Home` | Lifecycle-aware router that renders progression widgets and navigates to configured home targets. | Use as the default post-auth landing route. | Avoid for marketing or unauthenticated flows. |
|
|
125
|
+
| `AppLayout_MainContainer` | Root layout preset wiring `useAppShellLayout` with sidebar, toolbars, overlays, and loading gates. | Use as the top-level wrapper for signed-in SaaS experiences. | Avoid for marketing or auth-only public pages — use `PUBLIC_LAYOUTS_MAIN_CONTAINER`. |
|
|
126
|
+
| `AppLayout_RouterErrorBoundary` | ErrorDisplay presets for 404/403/5xx, application crashes, and unknown failures. | Use at the router boundary wrapping navigable content. | Avoid for isolated component errors — use `APP_LAYOUTS_ERROR_BOUNDARY`. |
|
|
127
|
+
| `Files_UploadGrantDrop` | Focused public shell — the target field and its constraints, one file chooser, one upload, then a terminal state (received, already used, expired, cancelled). | Reached only through a grant’s `uploadPageUrl`. It is the fallback for an assistant host that cannot perform the upload itself; a host that can run a command uses the grant’s curl example instead. | Never as a general upload surface — authenticated uploads go through the resource file fields, and nothing on this page is reachable without a grant token. |
|
|
128
|
+
| `PublicLayout_MainContainer` | Minimal full-viewport wrapper driven by `usePublicShellLayout`. In card mode it may open the card with a brand header: the mark when one resolves, and the name — set from the TYPOGRAPHY.HEADING recipe, and not a heading element, since the card content owns the page heading. The login page may pass `organizationBranding` from identification; an explicit shell identity still wins. Tenant color is a decorative identity accent, not a replacement for accessible application theme tokens. Other public pages keep their defaults. | Use for auth flows, static marketing content, and other pre-app surfaces. | Avoid for authenticated app shells — use `APP_LAYOUTS_MAIN_CONTAINER`. |
|
|
129
|
+
| `PublicLayout_StaticContentContainer` | Thin wrapper around centered content within the public shell. | Use for legal, help, or marketing pages that do not need auth chrome. | Avoid for authenticated app surfaces. |
|
|
130
|
+
| `PublicLayout_Terms` | Public legal-document layout that shows release version and effective date for a release, a draft notice for an unreleased draft, and a "not yet established" note beneath any clause the document states is incomplete; it shows no partial content when nothing may be displayed, and withholds unapproved releases and drafts only when the application arms its governed-document approval gate (`compliance.governedDocumentApprovalGate`), the same switch every acceptance surface reads. | Use on `/privacy`, `/terms` and future stable-definition public document routes. | Avoid for authenticated governance records, off-site documents, or rendering a draft candidate directly — drafts reach this page only as projected public documents. |
|
|
131
|
+
|
|
132
|
+
## Auth (14)
|
|
133
|
+
|
|
134
|
+
| Component | Renders | Use when | Avoid when |
|
|
135
|
+
| --- | --- | --- | --- |
|
|
136
|
+
| `Auth_AuthCallback` | Spinner + error alert flow tied to auth redirect parameters, redirecting to the post-sign-in target or to organization onboarding. | Use on the auth callback route configured with the identity provider. | Avoid for password login — use `PUBLIC_LAYOUTS_USER_AUTH`. |
|
|
137
|
+
| `Auth_ConfirmEmail` | Token-driven confirm surface with resend and support paths. | Use on the confirm-email route after signup. | Avoid when email verification is disabled. |
|
|
138
|
+
| `Auth_EnrollmentRequired` | Method picker with per-method enrollment ceremonies (TOTP, passkey, phone), or a terminal sign-out when nothing can be enrolled. | Use when an authentication answer requires a second factor and none is usable. | Avoid when a usable second factor exists — use `PUBLIC_LAYOUTS_MFA_CHALLENGE`. |
|
|
139
|
+
| `Auth_Invitation` | Invitation card with accept/decline and optional sign-in handoff. | Use on invitation deep links. | Avoid when invitations are disabled. |
|
|
140
|
+
| `Auth_MagicLinkVerify` | Progress + error states for email link verification. | Use on the magic-link landing route. | Avoid when magic links are not offered. |
|
|
141
|
+
| `Auth_Main` | Large automated form host switching between password, magic link, passkey, and SSO methods; before any email is typed it also offers username-less passkey sign-in — a sign-in-with-a-passkey button and passkey autofill on the email field — where the device lists every account the person holds a passkey for. Two things it will NOT show: password recovery beside a method that is not the password, and an enterprise method and a password fallback as equal choices — where the tenant requires the former, the page says so. | Use on the main authentication route. | Avoid for step-up or MFA-only flows — use dedicated MFA layout. |
|
|
142
|
+
| `Auth_MfaChallenge` | Session-bound MFA form with method-specific inputs. | Use when `requiresMFA` is returned from identify. | Avoid for first-factor identification. |
|
|
143
|
+
| `Auth_OAuthConsent` | Approve/deny decision surface for user-delegated (A2A/MCP) OAuth authorization on the /oauth/consent route. | Use on the /oauth/consent route, reached when GET /oauth/authorize returns `consent_required` for an opt-in client; the decision is POSTed to /oauth/authorize/decision. | Avoid for trusted/first-party or machine clients — they auto-grant (requiresConsent defaults false), so the screen never renders for them. |
|
|
144
|
+
| `Auth_OAuthLoggedOut` | Post-logout confirmation surface on the /oauth/logged-out route; informational only (the session is already terminated server-side by the per-session revocation fence). | Use on the /oauth/logged-out route, reached when GET /oauth/end-session has no registered post_logout_redirect_uri to redirect to (RP-Initiated Logout 1.0 §5). | Avoid when the logout request carries a registered post_logout_redirect_uri — the OP redirects straight back to the relying party (§3) and this screen never renders. |
|
|
145
|
+
| `Auth_OAuthLogoutConfirm` | Pre-logout confirmation surface on the /oauth/logout-confirm route; token-driven (never gates on a Bearer). Confirm terminates the session and lands on /oauth/logged-out. | Use on the /oauth/logout-confirm route, reached when GET /oauth/end-session is NOT a trusted RP logout — i.e. anything except a valid id_token_hint plus an exact-match registered post_logout_redirect_uri (RP-Initiated Logout 1.0 §6). | Avoid for a trusted RP logout (valid id_token_hint + registered exact-match post_logout_redirect_uri) — the OP terminates and redirects to the relying party directly, without a prompt (the Keycloak-style posture). |
|
|
146
|
+
| `Auth_OneOffSession` | Focused auth shell without full account chrome. | Use for flows that require a fresh scoped session. | Avoid for standard user login. |
|
|
147
|
+
| `Auth_OrganizationOnboarding` | A names form or an organization-name form, whichever obligation is next; or an expired-session notice with a sign-in link. | Use when an authentication answer parks the account at `ONBOARDING_PENDING` (registration, verification, enrollment or sign-in). | Avoid for names asked on the sign-up form (`profileNamesCollectedAt: REGISTRATION`) and for organizations named at registration (`ASK`) or derived automatically — neither parks an account. |
|
|
148
|
+
| `Auth_PasswordLost` | Email capture + token reset form with validation messaging. | Use on forgot-password routes. | Avoid when password auth is disabled. |
|
|
149
|
+
| `Auth_Register` | Multi-step registration host sharing components with auth main. Presets customize presentation only after the native policy gateway permits public registration. The acceptance control takes the shape the application declares in `compliance.governedDocumentAcceptanceMode`: IMPLIED_BY_REGISTERING renders a notice above the submit control and withholds nothing, EXPLICIT_CHECKBOX (the default) renders an unticked box and withholds the submit until it is ticked, and EXPLICIT_AFTER_READING adds a scroll-to-end pane per served document and withholds the box until every pane has been passed over. It renders nothing at all when the application declares no in-force release permitting CONTRACT_ACCEPTED, and the reading gate degrades to EXPLICIT_CHECKBOX when no public document is served for a required release — the act survives, only the claim that the text was presented is dropped. | Use on public signup routes; the wrapper renders the fixed unavailable state for non-open or frontend-disabled policies. | Do not call a preset directly as an availability or authorization boundary, and do not use it as a CONSENT surface: optional consent purposes are asked of a signed-in person by `AppLayout_ConsentGate` and of a website visitor by `WebsiteConsentGate`. What is asked here is acceptance of documents, which is a different question about a different record. |
|
|
150
|
+
|
|
151
|
+
## Billing (6)
|
|
152
|
+
|
|
153
|
+
| Component | Renders | Use when | Avoid when |
|
|
154
|
+
| --- | --- | --- | --- |
|
|
155
|
+
| `BillingPortalLink` | A thin link or button that opens the billing provider’s customer portal, delegating to the `useBillingSafe` portal opener when uncontrolled; renders an explicit unavailable state rather than empty or zero data when the portal is not reachable. | Use when users must self-serve payment methods or invoices. | Avoid when portal access is unavailable for the current customer. |
|
|
156
|
+
| `InvoiceHistory` | Unavailable slices render an explicit unavailable state instead of empty or zero data; independently available billing panels remain usable. Billing summary table wired to optional `useBillingSafe` defaults. | Use on account or subscription settings surfaces. | Avoid when billing provider does not expose invoice history. |
|
|
157
|
+
| `PlanChangePreview` | Composed by PricingTable after plan selection, with estimate, cancel, retry and a confirmation enabled only for the current server-bound preview. | Use when changing an existing subscription plan; new subscriptions use checkout. | Avoid for anonymous pricing pages without an active subscription context. |
|
|
158
|
+
| `PricingTable` | Unavailable slices render an explicit unavailable state instead of empty or zero data; independently available billing panels remain usable. Marketing-grade plan grid integrated with catalog metadata: the catalogue decides which plan is recommended (emphasised, never worded as popularity), how much of each price is stated (listed, a starting price, or on request with a contact-sales action when `contactSalesHref` is given), and which plans are announced but not yet on sale (listed, selection disabled). | For an existing subscription, selection composes a provider invoice preview and explicit server-bound confirmation; new subscribers use checkout. Use on upgrade paths and public pricing when embedded in the app. | Avoid when a single plan replaces self-serve tiers. A custom-quote plan belongs in the grid as an on-request product, not in a separate component. |
|
|
159
|
+
| `SubscriptionStatus` | Unavailable slices render an explicit unavailable state instead of empty or zero data; independently available billing panels remain usable. Read-only status panel with optional actions to manage billing. | Use on account settings and billing overview routes. | Avoid for users without an active billing subject. |
|
|
160
|
+
| `UsageDashboard` | Unavailable slices render an explicit unavailable state instead of empty or zero data; usage and credit balance availability are independent, so either section can remain usable when the other fails. Dashboard cards/charts fed by billing usage APIs. | Use when plans include metered entitlements or quota warnings. | Avoid when billing is flat-rate without usage signals. |
|
|
161
|
+
|
|
162
|
+
## Data Display (10)
|
|
163
|
+
|
|
164
|
+
| Component | Renders | Use when | Avoid when |
|
|
165
|
+
| --- | --- | --- | --- |
|
|
166
|
+
| `Avatar` | Low-level circular media surface with image and text fallback slots, resolved as one registry entry. | Use when showing people, workspaces, or bots with optional photos and initials fallback. | Avoid for non-identity decorative circles; prefer badges or icons. |
|
|
167
|
+
| `Badge` | Inline pill or span-styled indicator for counts, states, and labels. | Use for tags, beta markers, validation states, and lightweight emphasis. | Avoid when the control must be keyboard-focusable for a primary action; use `Button` size icon variants instead. |
|
|
168
|
+
| `DescriptionDetails` | Definition value styling inside a description list. | Use as the value side of a key/value row inside `DescriptionList`. | Avoid for long prose articles without a matching term; use rich content layouts instead. |
|
|
169
|
+
| `DescriptionList` | Definition list container matching typography and spacing recipes, in one of two layouts: divided rows, or a fixed key column with values beside it. | Use for key/value summaries, metadata panels, and invoice-style field blocks. | Avoid for tabular data that needs column alignment; use `Table`. |
|
|
170
|
+
| `DescriptionTerm` | Definition term styling inside a description list. | Use as the label side of a key/value row inside `DescriptionList`. | Avoid outside a description list semantics; use `Label` for form fields. |
|
|
171
|
+
| `Duration` | A terse clock sitting inline beside the record it times — 9s, 4m 20s, 1h 07m — that advances once a second while the record is unsettled and freezes when it settles. | Use beside anything long-running an operator watches — a job, a dispatch, a run — where the question is whether it is still moving rather than when it began. | Avoid for a duration a record CARRIES as a value (use the duration display field, which reads full unit words from the DurationUnit system enum), and for an absolute instant (use the datetime field). |
|
|
172
|
+
| `Identifier` | Monospaced, wrapping, receding behind the prose it identifies; the same treatment the field pipeline gives StringDisplayMode.IDENTIFIER. | Use wherever a surface renders an address a machine assigned rather than words a person wrote, including on hand-built rows outside the field pipeline. | Avoid for prose, for a human-authored name, and for a code BLOCK (use the code artifact element, which owns scrolling and copy). |
|
|
173
|
+
| `Kbd` | A small quiet key cap in the monospaced face on the inset surface; the same cap wherever an application names a key. | Use wherever a surface tells a reader what to press: a shortcut hint on a control, a hotkey help list, a keyboard-driven list that says so. | Avoid for a machine address (Identifier) and for inline code (the CODE typography variant): a key cap depicts a control, not a value. |
|
|
174
|
+
| `NotificationIndicator` | A small count bubble, a colored signal dot, or nothing — surfaced on nav items and shell affordances. | Use to surface a notification-badge definition’s live count/dot on a sidebar item or shell control. | Avoid for arbitrary status chips (use `Badge`); this is driven by a resolved notification-badge count. |
|
|
175
|
+
| `Timeline` | Compound: `Timeline` (the rail, an ordered list), `TimelineEntry` (tone, optional custom marker; under a `selectable` rail, `option` + `selected` make it a pickable grid row — never a listbox option, because an entry carries `TimelineActions` and an option may not contain a control), `TimelineMarker`, `TimelineTime`, `TimelineBody`, `TimelineActions`. Renders in DOM order; ordering, filtering, elapsed clocks and words are the consumer's. | Use for any stream of things that happened in order — runs, dispatches, writes, a flow execution's events, an audit trail — wherever a reader asks what happened, then what. | Avoid for a sequence a person WALKS (the stepper), for an unordered set (a list card), and for a reasoning trace with nested content (the chain-of-thought elements). |
|
|
176
|
+
|
|
177
|
+
## Data Display / Formatters (25)
|
|
178
|
+
|
|
179
|
+
| Component | Renders | Use when | Avoid when |
|
|
180
|
+
| --- | --- | --- | --- |
|
|
181
|
+
| `DisplayFieldAddress` | Read-only address block. | Use for fields declared with z_address(). | Avoid when the address must follow a country-specific postal layout; that needs address-format data this component does not carry. |
|
|
182
|
+
| `DisplayFieldBigDecimal` | Typed display surface for `bigdecimal`-flavoured Zod fields. | Use when rendering schema-backed decimal quantities, amounts, or scores that are not modelled as money. | Avoid when the value is money with currency semantics; prefer the money display slot. |
|
|
183
|
+
| `DisplayFieldBoolean` | Read-only boolean indicator aligned with design-system typography and spacing. | Use for toggles, flags, and binary attributes in read templates. | Avoid when the user must change the value; use a form boolean control instead. |
|
|
184
|
+
| `DisplayFieldCode` | Monospace-friendly read-only value cell for identifiers, hashes, or inline code samples. | Use when the underlying field is semantically “code-like” and should not use proportional body text. | Avoid for long multi-line program listings without a dedicated code block layout. |
|
|
185
|
+
| `DisplayFieldDate` | Locale-aware date-only display. | Use for birthdays, due dates, and calendar-day attributes. | Avoid when the instant matters across time zones; use datetime. |
|
|
186
|
+
| `DisplayFieldDateTime` | Timestamp display for point-in-time fields. | Use for audit timestamps, “last updated”, and scheduling instants. | Avoid for wall-time-only values; consider date or time slots. |
|
|
187
|
+
| `DisplayFieldDuration` | Readable duration formatter for interval-backed fields. | Use when the schema represents a time span rather than an instant. | Avoid for single timestamps; use date, datetime, or time slots. |
|
|
188
|
+
| `DisplayFieldEnum` | Read-only enum label resolver for constrained string/enum fields. | Use when displaying picklist values in resource read views or summaries. | Avoid when the raw stored token should remain visible for debugging; use the string slot instead. |
|
|
189
|
+
| `DisplayFieldFile` | File reference display cell with optional actions. | Use for arbitrary file attachments where MIME-specific previews are not required. | Avoid when a dedicated image, video, or audio preview slot is registered for the same shape. |
|
|
190
|
+
| `DisplayFieldFileAudio` | Read-only audio attachment cell. | Use for podcast clips, voicemails, or other audio blobs. | Avoid when only a download link is required; the generic file slot may suffice. |
|
|
191
|
+
| `DisplayFieldFileDocument` | Read-only document attachment cell. | Use for contracts, PDFs, and office documents. | Avoid for inline text extraction views; those belong in higher-level readers. |
|
|
192
|
+
| `DisplayFieldFileGallery` | Read-only gallery layout for several image files. | Use when the field stores multiple images shown together. | Avoid for a single image; prefer the image file slot. |
|
|
193
|
+
| `DisplayFieldFileImage` | Read-only image file cell. | Use for image uploads and image URLs in resource layouts. | Avoid for non-image blobs; use the generic file slot. |
|
|
194
|
+
| `DisplayFieldFileVideo` | Read-only video attachment cell. | Use when the stored file is video content. | Avoid for streaming URLs that need a custom embed; compose higher-level media views instead. |
|
|
195
|
+
| `DisplayFieldMoney` | Locale-aware money readout for monetary Zod fields. | Use for prices, balances, and invoicing amounts. | Avoid for non-currency decimals; use bigdecimal or number slots. |
|
|
196
|
+
| `DisplayFieldNumber` | General-purpose numeric readout. | Use for counts, scores, and measurements without currency semantics. | Avoid for money or high-precision decimal fields that have dedicated slots. |
|
|
197
|
+
| `DisplayFieldPhone` | Read-only phone number cell. | Use for contact fields and verification hints. | Avoid when storing raw tokens that must not be reformatted. |
|
|
198
|
+
| `DisplayFieldRangeBigDecimal` | Range control readout for paired bigdecimal bounds. | Use for tolerances, intervals, and numeric bands. | Avoid for single scalar decimals. |
|
|
199
|
+
| `DisplayFieldRangeDate` | Date range display for bookings and availability windows. | Use when both ends are date-only values. | Avoid for instants spanning zones; model as datetime range. |
|
|
200
|
+
| `DisplayFieldRangeDateTime` | Datetime range display for sessions, meetings, or traces. | Use when both ends include time-of-day semantics. | Avoid for date-only ranges; use the date range slot. |
|
|
201
|
+
| `DisplayFieldRangeMoney` | Range readout for money bounds. | Use for budget bands, price intervals, and FX spreads. | Avoid for single money amounts. |
|
|
202
|
+
| `DisplayFieldRangeNumber` | Range readout for paired numeric bounds. | Use for sliders persisted as intervals or validation ranges. | Avoid for money or bigdecimal ranges that have dedicated slots. |
|
|
203
|
+
| `DisplayFieldRangeTime` | Time range display for shifts or opening hours. | Use when both ends are time-only. | Avoid for full timestamps; use datetime range. |
|
|
204
|
+
| `DisplayFieldString` | Plain text cell with optional label and description. | Use for short text, names, titles, and tokens that do not need specialized formatters. | Avoid for secrets that should be masked, money, or locale-sensitive dates. |
|
|
205
|
+
| `DisplayFieldTime` | Clock-time display for time-only fields. | Use for business hours, durations-as-time, or local wall times. | Avoid when the value is a full timestamp; use datetime. |
|
|
206
|
+
|
|
207
|
+
## Feedback (10)
|
|
208
|
+
|
|
209
|
+
| Component | Renders | Use when | Avoid when |
|
|
210
|
+
| --- | --- | --- | --- |
|
|
211
|
+
| `AppCelebrationOverlay` | Transient positive feedback layer mounted near the app root. | Use after milestone completions, onboarding wins, or shareable achievements. | Avoid for inline validation success; use toasts or subtle banners instead. |
|
|
212
|
+
| `DangerZone` | Soft destructive surface (border + tinted background) for grouped risky actions. | Use around delete account, reset data, or other high-impact controls. | Avoid for ordinary form sections; use `Card` or neutral panels. |
|
|
213
|
+
| `EmptyState` | Centered placeholder panel when a container has no primary content. | Use for dashboards, lists, or panels that may start without data. | Avoid when resource-specific i18n and config should drive copy; prefer `ResourceEmptyState` and `RESOURCES_LAYOUTS_EMPTY_STATE`. |
|
|
214
|
+
| `ErrorDisplay` | Primary failure communication surface for pages, dialogs, and resource errors. | Use when surfacing HTTP failures, blocked operations, or user-recoverable faults. | Avoid for field-level validation; use inline field errors instead. |
|
|
215
|
+
| `LoadingOverlay` | Blocking-but-friendly loading treatment over existing content. | Use with loading gates that choose an opacity overlay strategy. | Avoid for inline skeleton states where layout should not be obscured. |
|
|
216
|
+
| `LoadingSpinner` | Compact loading glyph for buttons, table cells, and inline fetches. | Use when `LoadingGate` selects a spinner treatment or for standalone busy hints. | Avoid as the only feedback for long tasks; pair with progress or skeletons. |
|
|
217
|
+
| `OperationsConfirmCritical` | Critical confirmation gate with explicit cancel and validate callbacks. | Use when a typed confirmation or dual-action acknowledgement is required before proceeding. | Avoid for low-risk toggles; use ordinary dialogs or buttons. |
|
|
218
|
+
| `Progress` | Linear progress indicator with optional custom value label formatter. | Use when upload, import, or batch jobs expose fractional completion. | Avoid when only busy/idle is known; prefer spinners. |
|
|
219
|
+
| `Skeleton` | Neutral skeleton surface for text, media, and card placeholders. | Use inside lists, cards, and dashboards during data fetches. | Avoid when an overlay spinner already communicates the wait. |
|
|
220
|
+
| `Toaster` | Ephemeral notification surface for success, error, and info messages. | Use via `toast(...)` helpers after mounting the registered `Toaster` near the app root. | Avoid for critical blocking errors; use `ErrorDisplay` or modal flows. |
|
|
221
|
+
|
|
222
|
+
## Feedback / Features (4)
|
|
223
|
+
|
|
224
|
+
| Component | Renders | Use when | Avoid when |
|
|
225
|
+
| --- | --- | --- | --- |
|
|
226
|
+
| `FeatureLimitIndicator` | Compact meter or label summarizing quota consumption. | Use near upgrade prompts or settings where plan limits must be visible. | Avoid when limits are unlimited or undefined; the wrapper returns null. |
|
|
227
|
+
| `FeatureLockBadge` | Small lock affordance with optional list of missing feature identifiers. | Use beside disabled controls, menu items, or upsell entry points. | Avoid as the sole explanation for a blocked flow; pair with dialogs or prompts. |
|
|
228
|
+
| `FeatureUnavailableDialog` | Blocking dialog variant of the feature-unavailable prompt. | Use when navigation or a button attempt must stop with explicit acknowledgement. | Avoid for non-blocking hints; use `FeatureUnavailablePrompt` inline instead. |
|
|
229
|
+
| `FeatureUnavailablePrompt` | Non-modal upsell / explanation surface embedded in pages or drawers. | Use when a feature gate should explain why content is hidden without a full dialog. | Avoid when user acknowledgement is mandatory; prefer the dialog slot. |
|
|
230
|
+
|
|
231
|
+
## Form (3)
|
|
232
|
+
|
|
233
|
+
| Component | Renders | Use when | Avoid when |
|
|
234
|
+
| --- | --- | --- | --- |
|
|
235
|
+
| `AutosaveIndicator` | Compact status glyph or text beside controlled inputs. | Use when `FormField` or automated templates surface debounced persistence feedback. | Avoid as the only error surface; pair with field-level validation messaging. |
|
|
236
|
+
| `Combobox` | Popover listbox tied to a text filter, bridging schema options and RHF-controlled values. | Use for medium/large option sets where typeahead beats a plain `Select`. | Avoid when options always fit in a short static list without search. |
|
|
237
|
+
| `ComboboxMultiple` | Popover listbox supporting multiple values, clear-all, and loading states. | Use when users must pick several options from a large set (enums, tags, resource search). | Avoid when only one value is allowed — use `LOW_LEVEL_COMBOBOX` or `LOW_LEVEL_SELECT`. |
|
|
238
|
+
|
|
239
|
+
## Form / Chromes (14)
|
|
240
|
+
|
|
241
|
+
| Component | Renders | Use when | Avoid when |
|
|
242
|
+
| --- | --- | --- | --- |
|
|
243
|
+
| `Field` | Div-based field row/stack used outside the newer content-section system. | Use when migrating older layouts that still rely on `Field*`-family atoms. | Prefer `LOW_LEVEL_CONTENT_SECTION*` for new page-level composition. |
|
|
244
|
+
| `FieldContent` | Hosts the actual control next to titles/labels. | Use with `Field` + `FieldLabel` stacks. | Avoid in greenfield layouts; migrate to content sections. |
|
|
245
|
+
| `FieldDescription` | Muted description paragraph under field titles. | Use with `Field` layouts needing inline guidance. | Prefer `FormDescription` inside RHF primitives. |
|
|
246
|
+
| `FieldError` | Destructive text list for validation failures. | Use when surfacing `errors` arrays adjacent to legacy fields. | Prefer `FormMessage` for RHF-native flows. |
|
|
247
|
+
| `FieldLabel` | Caption element tied to nested controls. | Use inside `Field` compositions. | Prefer `FormLabel` for RHF-driven forms. |
|
|
248
|
+
| `FieldSeparator` | Spacing + separator affordance inside dense forms. | Use between repeated `Field` blocks. | Avoid when whitespace alone suffices. |
|
|
249
|
+
| `FieldTitle` | Emphasized label line above controls. | Use when a field group needs a heading distinct from control labels. | Avoid duplicating resource headings; keep hierarchy shallow. |
|
|
250
|
+
| `FormControl` | Accessibility-focused control slot for form field chrome. | Use inside generated form layouts between `FormLabel` and the actual control. | Avoid bypassing it when using the stock form primitives; it carries a11y wiring. |
|
|
251
|
+
| `FormDescription` | Secondary copy under labels for hints and formatting guidance. | Use when a field needs long-form guidance that should not sit in the label. | Avoid for validation errors; use `FormMessage` or `FieldError` instead. |
|
|
252
|
+
| `FormFieldPrimitive` | Binds Zod-backed field metadata to child render functions across automated and manual forms. | Use whenever a field participates in the shared FormField chrome pipeline. | Avoid duplicating controller logic for one-off experiments outside the framework contract. |
|
|
253
|
+
| `FormItem` | Vertical stack spacing for one logical field in RHF forms. | Use as the structural unit inside `FormField` output. | Avoid omitting it when mixing `FormLabel`/`FormControl` manually; spacing tokens assume this wrapper. |
|
|
254
|
+
| `FormLabel` | Primary caption for a form item with error-state styling hooks. | Use for every field that should announce its name to assistive tech. | Avoid replacing page-level headings; keep copy concise. |
|
|
255
|
+
| `FormMessage` | Error-colored text region with optional summaries for wizard/array experiences. | Use to render `FormField` validation output or aggregated errors. | Avoid duplicating inline `FieldError` content unless the layout requires both. |
|
|
256
|
+
| `FormRoot` | Context provider that wires RHF methods to descendant `FormField` primitives. | Use as the outermost form wrapper for RHF-driven flows. | Avoid nesting multiple providers without deliberate scope splitting. |
|
|
257
|
+
|
|
258
|
+
## Form / Controls (7)
|
|
259
|
+
|
|
260
|
+
| Component | Renders | Use when | Avoid when |
|
|
261
|
+
| --- | --- | --- | --- |
|
|
262
|
+
| `Input` | Primary single-line control for strings, emails, URLs, tel, and constrained numbers. | Use for standard form fields backed by Zod string/number formats. | Avoid for secrets needing masking toggles; use `PasswordInput`. |
|
|
263
|
+
| `InputGroup` | Recipe-driven group container with delegated focus/error rings to the nested control slot. | Use when prefix/suffix chrome, copy/clear buttons, or currency units sit flush against the field. | Avoid when a standalone `Input` with simple field chrome suffices. |
|
|
264
|
+
| `InputGroupAddon` | Click-to-focus addon strip with inline-start/inline-end/block-start/block-end alignment. | Use inside `InputGroup` to show units, leading icons, or helper kbd hints. | Avoid for primary actions — prefer `InputGroupButton`. |
|
|
265
|
+
| `InputGroupButton` | Ghost/outline `Button` derivative sized for inline group density (xs/icon-xs by default). | Use for affordances that must live inside the grouped field without growing row height. | Avoid for full-width actions outside the field — use `LOW_LEVEL_BUTTON`. |
|
|
266
|
+
| `InputGroupInput` | `InputRoot` configured with `data-slot=input-group-control` for delegated focus styling. | Use as the primary text control inside `InputGroup`. | Avoid outside a group — prefer `LOW_LEVEL_INPUT`. |
|
|
267
|
+
| `InputGroupText` | Typography-aligned span with icon sizing conventions matching addons. | Use for short read-only fragments adjacent to the control. | Avoid for interactive content — use `InputGroupButton` or `InputGroupAddon`. |
|
|
268
|
+
| `InputGroupTextarea` | `TextareaRoot` with group control slot and no inner chrome. | Use for comment or description fields that need grouped addons with textarea behavior. | Avoid outside a group — prefer `LOW_LEVEL_TEXTAREA`. |
|
|
269
|
+
|
|
270
|
+
## Form / Controls / Boolean (4)
|
|
271
|
+
|
|
272
|
+
| Component | Renders | Use when | Avoid when |
|
|
273
|
+
| --- | --- | --- | --- |
|
|
274
|
+
| `Checkbox` | Binary choice aligned with design-system checkbox recipe. | Use for explicit opt-in flags and multi-select groups. | Avoid for immediate settings that behave like hardware switches; consider `Switch`. |
|
|
275
|
+
| `Switch` | Slider-style on/off control. | Use for feature toggles and binary preferences. | Avoid when a checkbox better matches form semantics (e.g. terms acceptance). |
|
|
276
|
+
| `Toggle` | Button-styled boolean control for dense toolbars. | Use inside `ToggleGroup` or standalone icon toggles. | Avoid when a sliding switch metaphor is required. |
|
|
277
|
+
| `ToggleGroupBoolean` | Two-state segmented control. | Use when UX requires explicit Yes/No chips. | Avoid when more than two states are needed; use `ToggleGroup`. |
|
|
278
|
+
|
|
279
|
+
## Form / Controls / Date Time (8)
|
|
280
|
+
|
|
281
|
+
| Component | Renders | Use when | Avoid when |
|
|
282
|
+
| --- | --- | --- | --- |
|
|
283
|
+
| `Calendar` | Date selection surface embedded in pickers or read-write templates. | Use inside `DatePicker` presets or standalone scheduling UIs. | Avoid when a text mask suffices; use simpler inputs. |
|
|
284
|
+
| `CalendarDayButton` | Interactive day tile with outside-month and modifier styling. | Use when tenants need custom day rendering without forking the full calendar. | Avoid standalone usage outside a calendar context. |
|
|
285
|
+
| `DatePicker` | Structured date entry with locale-aware formatting. | Use for schema `date` fields without time components. | Avoid when timezone-aware instants are required; use `DateTimePicker`. |
|
|
286
|
+
| `DateRangePicker` | Range calendar with start/end chips. | Use for booking windows and reporting periods. | Avoid when times matter on both ends; use `DateTimeRangePicker`. |
|
|
287
|
+
| `DateTimePicker` | Popover flow capturing instants with calendar + time subcontrols. | Use for timestamp fields in user-local workflow contexts. | Avoid when only dates matter; use `DatePicker`. |
|
|
288
|
+
| `DateTimeRangePicker` | Dual datetime selection for sessions or traces. | Use when both ends require time-of-day precision. | Avoid for calendar-day-only filters. |
|
|
289
|
+
| `TimePicker` | Structured time entry with optional seconds and stepping. | Use for business hours and reminders. | Avoid for full timestamps; use `DateTimePicker`. |
|
|
290
|
+
| `TimeRangePicker` | Dual time inputs with shared formatting policy. | Use for shifts, opening hours, or duration boundaries. | Avoid when calendar context is required on the ends. |
|
|
291
|
+
|
|
292
|
+
## Form / Controls / Enum (5)
|
|
293
|
+
|
|
294
|
+
| Component | Renders | Use when | Avoid when |
|
|
295
|
+
| --- | --- | --- | --- |
|
|
296
|
+
| `RadioGroup` | Vertical/horizontal radio cluster bound to enum options. | Use when all options should remain visible (small cardinality). | Avoid for huge enumerations; prefer `Select` or `Combobox`. |
|
|
297
|
+
| `RadioGroupItem` | Radix radio indicator paired with labels inside `RadioGroup`. | Use when composing custom radio layouts that still resolve through the registry. | Prefer the bundled `RadioGroup` options API for standard cases. |
|
|
298
|
+
| `Select` | Trigger + popper list wired to `FieldOption` metadata. | Use for static enumerations with predictable cardinality. | Avoid when search/async filtering is required; use `Combobox`. |
|
|
299
|
+
| `SelectMultiple` | Popover checklist for many-to-one enum arrays. | Use when users must pick several visible options. | Avoid for single selection; use `Select`. |
|
|
300
|
+
| `ToggleGroup` | Toolbar-style option chips with shared sizing variants. | Use for compact enum switching (filters, alignment modes). | Avoid when a dropdown saves space better. |
|
|
301
|
+
|
|
302
|
+
## Form / Controls / File (2)
|
|
303
|
+
|
|
304
|
+
| Component | Renders | Use when | Avoid when |
|
|
305
|
+
| --- | --- | --- | --- |
|
|
306
|
+
| `FileUpload` | File control with progress, validation, and preview hooks. | Use for blob fields backed by upload pipelines. | Avoid when only a URL paste is required. |
|
|
307
|
+
| `ImageCrop` | Crop dialog with fixed aspect frame, optional circular avatar mask, and zoom slider; exports a constraint-conforming image file. | Mounted by file fields whose `z_file` imageConstraints declare an aspectRatio; generic over any ratio. | Avoid for unconstrained file fields — they keep the direct upload flow without a crop step. |
|
|
308
|
+
|
|
309
|
+
## Form / Controls / Number (2)
|
|
310
|
+
|
|
311
|
+
| Component | Renders | Use when | Avoid when |
|
|
312
|
+
| --- | --- | --- | --- |
|
|
313
|
+
| `RangeSlider` | Range selection mapped to `{ from, to }` values. | Use for budgets, time windows, or tolerance bands. | Avoid for single scalar values; use `Slider`. |
|
|
314
|
+
| `Slider` | Drag affordance bound to min/max/step. | Use for continuous numeric parameters (volume, probability). | Avoid for paired min/max; use `RangeSlider`. |
|
|
315
|
+
|
|
316
|
+
## Form / Controls / String (6)
|
|
317
|
+
|
|
318
|
+
| Component | Renders | Use when | Avoid when |
|
|
319
|
+
| --- | --- | --- | --- |
|
|
320
|
+
| `ColorInput` | Chooses a CSS color value for theming or design tools. | Use for brand color pickers or theme overrides. | Avoid when a simple text token is enough. |
|
|
321
|
+
| `InlineEditText` | An in-place text control that reads as content until it is edited — single click focuses and selects, double-click or Enter/F2 enters edit, Enter or blur commits, Escape cancels. | Use where a value is read far more often than it is changed and a form would be heavier than the edit itself — a checklist item, a title on a card, a renameable label in a list. | Avoid inside a form that already has an explicit save (the control commits on its own, so two commit paths would disagree), and avoid for a value that must be validated against others before it is accepted — a form field can refuse, this control only commits or cancels. |
|
|
322
|
+
| `InputOTP` | OTP capture for MFA and email/SMS verification. | Use when verifying short numeric or alphanumeric codes. | Avoid for full passwords or unconstrained text. |
|
|
323
|
+
| `MarkdownEditor` | Source-level markdown editing plane inside form surfaces; deliberately NOT a WYSIWYG — display rendering stays on the `StringDisplayMode.MARKDOWN` pipeline (`MarkdownContent`). | Use for long-form string fields whose display renders as markdown and whose authors edit the source directly (bio, description, notes authored with `StringEditMode.MARKDOWN`). | Avoid for plain multi-line text (`Textarea`), for code values with a language axis (`FormFieldCode`), and for rich visual editing (a separate future WYSIWYG component). |
|
|
324
|
+
| `PasswordInput` | Masked input for credentials. | Use for authentication and secret rotation flows. | Avoid storing secrets in plain `Input type="password"` without the preset behaviors. |
|
|
325
|
+
| `Textarea` | Resizable or fixed-height textarea for descriptions and notes. | Use when schema fields allow long free-form text. | Avoid for single-line tokens; use `Input`. |
|
|
326
|
+
|
|
327
|
+
## Form / Fields (20)
|
|
328
|
+
|
|
329
|
+
| Component | Renders | Use when | Avoid when |
|
|
330
|
+
| --- | --- | --- | --- |
|
|
331
|
+
| `FormFieldAddress` | Grouped address control with browser autofill tokens on every part. | Use for fields declared with z_address(). | Avoid for a free-text location nobody needs to validate, compare or geocode. |
|
|
332
|
+
| `FormFieldBigDecimal` | Numeric form control for decimal fields. | Use when editing `bigdecimal` Zod-backed resource or form fields. | Avoid when a simple floating `number` field is sufficient without decimal semantics. |
|
|
333
|
+
| `FormFieldBoolean` | Binary choice control aligned with form chrome and validation modes. | Use for flags, toggles, and yes/no fields in automated or manual forms. | Avoid when the value is tri-state or not strictly boolean; consider enum instead. |
|
|
334
|
+
| `FormFieldCode` | Language-aware code editor surface pairing a language Select with a syntax-tinted editor plane. | Use when the schema marks a field as code (`z_code`), with optional allowed-language and length metadata. | Avoid for long prose (string variants tuned for plain text) and for markdown source (the `MarkdownEditor` slot, `StringEditMode.MARKDOWN`). |
|
|
335
|
+
| `FormFieldDate` | Calendar-driven date control without time components. | Use for calendar dates on forms backed by date schemas. | Avoid when the field requires time-of-day; use datetime instead. |
|
|
336
|
+
| `FormFieldDateTime` | Date-time picker control for instant-like values. | Use when the schema represents a full timestamp. | Avoid for date-only business dates; use the date field instead. |
|
|
337
|
+
| `FormFieldDuration` | Temporal duration editor. | Use when editing duration-typed fields. | Avoid for plain time-of-day; use time or datetime. |
|
|
338
|
+
| `FormFieldEnum` | Option list control bound to enum schema metadata. | Use for categorical fields with a closed set of values. | Avoid when options are dynamic unbounded search surfaces without enum closure. |
|
|
339
|
+
| `FormFieldFile` | File field for documents, images, and attachments. | Use when the schema declares a file-like field with storage metadata. | Avoid when only a URL string is needed without upload UX. |
|
|
340
|
+
| `FormFieldMoney` | Money editor with currency and formatting hints. | Use for monetary amounts on forms. | Avoid for unitless numbers; use number or bigdecimal. |
|
|
341
|
+
| `FormFieldNumber` | Standard number editor. | Use for integer or floating numeric fields. | Avoid when decimal precision policy requires bigdecimal. |
|
|
342
|
+
| `FormFieldPhone` | Tel-oriented control. | Use for phone-typed string fields. | Avoid for arbitrary strings without phone semantics. |
|
|
343
|
+
| `FormFieldRangeBigDecimal` | Paired high-precision numeric inputs. | Use for range bigdecimal schemas. | Avoid for single scalar bigdecimal values. |
|
|
344
|
+
| `FormFieldRangeDate` | Paired date pickers for inclusive ranges. | Use for date range filters or fields. | Avoid when each endpoint needs time-of-day. |
|
|
345
|
+
| `FormFieldRangeDateTime` | Paired timestamp pickers. | Use for datetime range schemas. | Avoid for single instants. |
|
|
346
|
+
| `FormFieldRangeMoney` | Paired money editors. | Use for monetary interval fields. | Avoid for single money amounts. |
|
|
347
|
+
| `FormFieldRangeNumber` | Paired number inputs. | Use for numeric interval fields. | Avoid for non-numeric ranges. |
|
|
348
|
+
| `FormFieldRangeTime` | Paired time pickers. | Use for time-only ranges. | Avoid when dates are required. |
|
|
349
|
+
| `FormFieldString` | Primary text entry primitive for forms. | Use for most string-backed fields. | Avoid when a specialized typed control (money, phone, enum) already matches the schema. For a field holding SEVERAL roles, use an array of roles rather than the single-role edit mode. |
|
|
350
|
+
| `FormFieldTime` | Clock-style time picker. | Use for time-only fields. | Avoid for full timestamps or durations. |
|
|
351
|
+
|
|
352
|
+
## High Level Views (2)
|
|
353
|
+
|
|
354
|
+
| Component | Renders | Use when | Avoid when |
|
|
355
|
+
| --- | --- | --- | --- |
|
|
356
|
+
| `ChartView` | Data visualization host bound to chart definitions and backend chart data APIs. | Use when navigation resolves to `HIGH_LEVEL_VIEWS_CHART_ECHARTS` through the component registry. | Avoid for dashboard grid tiles; prefer `HIGH_LEVEL_VIEWS_CHART_WIDGET` for composite layouts. |
|
|
357
|
+
| `ChartWidget` | Grid-friendly chart tile wrapping the core chart renderer. | Use inside composite view grids that reference chart cells. | Avoid when a standalone routed chart page is enough; use `HIGH_LEVEL_VIEWS_CHART_ECHARTS`. |
|
|
358
|
+
|
|
359
|
+
## Layout (6)
|
|
360
|
+
|
|
361
|
+
| Component | Renders | Use when | Avoid when |
|
|
362
|
+
| --- | --- | --- | --- |
|
|
363
|
+
| `AspectRatio` | Layout wrapper that applies CSS aspect-ratio to its content box. | Use when media or placeholders must preserve a consistent shape across breakpoints. | Avoid when intrinsic sizing from content is preferred. |
|
|
364
|
+
| `Carousel` | Compound viewport + track + navigation controls registered as one slot family. | Use when multiple items share one viewport and users navigate sequentially. | Avoid for simple static grids; prefer CSS grid without carousel semantics. |
|
|
365
|
+
| `Divider` | Horizontal rule with design-system border treatment. | Use between major content blocks where a full-width line aids scanability. | Avoid when a `Separator` inside flex layouts is more appropriate. |
|
|
366
|
+
| `ResizablePanelGroup` | Compound layout primitive: group container + panels + drag handles. | Use when two or more panes must share space and users need interactive resize. | Avoid for static responsive columns without drag handles. |
|
|
367
|
+
| `ScrollArea` | Compound `ScrollArea` + `ScrollBar` registered under one slot. | Use for fixed-height regions (sidebars, modals, data panels) where native overflow styling is insufficient. | Avoid for full-page scroll; prefer document flow. |
|
|
368
|
+
| `Separator` | 1px line that can be vertical or horizontal with optional decorative semantics. | Use inside toolbars, menus, and button groups for subtle division. | Avoid for full-width section breaks; prefer `Divider`. |
|
|
369
|
+
|
|
370
|
+
## Layout Internals (3)
|
|
371
|
+
|
|
372
|
+
| Component | Renders | Use when | Avoid when |
|
|
373
|
+
| --- | --- | --- | --- |
|
|
374
|
+
| `ContentSection` | Titled, optionally-framed group of fields inside a form or display layout. | Wrap a labelled section of fields; pass `legend`/`description` as structured props and the fields as children. | Do not use for multi-section orchestration (tabs/accordion/grid/stepper) — that is `ContentSectionContainer` (the unregistered i18n-bundle slot). |
|
|
375
|
+
| `ContentSectionGroup` | Neutral grouping div for sibling fields within a section. | Group repeated or sub-fields inside a ContentSection. | Not a standalone section — use ContentSection for the titled region. |
|
|
376
|
+
| `ContentSectionLegend` | Accessible name / heading for a grouped section. | Provide a section heading inside a ContentSection. | Not for body content or standalone use outside a section. |
|
|
377
|
+
|
|
378
|
+
## Navigation (5)
|
|
379
|
+
|
|
380
|
+
| Component | Renders | Use when | Avoid when |
|
|
381
|
+
| --- | --- | --- | --- |
|
|
382
|
+
| `Breadcrumb` | Compound `<nav>` + list semantics for wayfinding above page content. | Use when the IA is deeper than one level and users benefit from jumping to parents. | Avoid for flat single-screen apps or when URL context is obvious without a trail. |
|
|
383
|
+
| `Command` | cmdk-style compound: root, dialog shell, input, list, groups, items, shortcuts. | Use for power-user navigation, quick actions, or search-from-anywhere palettes. | Avoid when a simple button menu or static list is enough. |
|
|
384
|
+
| `Menubar` | Desktop-style application menu compound built on floating menu primitives. | Use for dense desktop shells mirroring OS menu conventions. | Avoid on narrow mobile layouts where a drawer or command menu fits better. |
|
|
385
|
+
| `NavigationMenu` | Radix navigation menu compound (list, triggers, content, viewport, indicator). | Use for primary marketing or app nav with hover/focus disclosure patterns. | Avoid when a simple list of links or sidebar IA is clearer. |
|
|
386
|
+
| `Sidebar` | Large compound: provider, rail, groups, menu trees, triggers, and layout inset. | Use for persistent multi-section navigation beside main content. | Avoid when navigation should stay in a top bar or bottom tabs only. |
|
|
387
|
+
|
|
388
|
+
## Navigation / App Level (13)
|
|
389
|
+
|
|
390
|
+
| Component | Renders | Use when | Avoid when |
|
|
391
|
+
| --- | --- | --- | --- |
|
|
392
|
+
| `ApplicationLevel_ActivityBar` | Shell chrome driven by `useActivityBarBehavior` and icon registry rendering. | Use when the product switches between major modes (e.g. build / operate / analyze). | Avoid when a single mode app has no mode-switching requirement. |
|
|
393
|
+
| `ApplicationLevel_CommandMenu` | Application-level wrapper around the search palette with container placement hooks, a responsive open trigger (full input-like control, or compact icon on mobile / collapsed rail) with per-placement width, a desktop dialog-width cap plus mobile bottom-drawer shape, and a unified record-above-command ordered result list. | Use for a searchable everything-palette across the app shell (records + quick actions); host it in the menubar and/or sidebar `hostedComponents` (with a per-placement `triggerWidth`) to show a visible search trigger reachable on mobile; enable `OMNIBOX` policy with `searchResources` when users should search live resource records (e.g. todos, tasks) — set `searchResources[].order` to tune where each record group sits relative to the command categories. | Avoid when page-local command surfaces (`LOW_LEVEL_COMMAND`) suffice. |
|
|
394
|
+
| `ApplicationLevel_ControlPanel` | Shell control panel preset with placement and behavior hooks from app configuration. | Use when secondary tools should live beside main content without a route change. | Avoid when a modal or dedicated page communicates the tools more clearly. |
|
|
395
|
+
| `ApplicationLevel_MenuBar` | Wraps the low-level menubar primitives with app-level layout and behavior. | Use for desktop shells that expose File/Edit-style menus across the top edge. | Avoid on mobile-first layouts without horizontal space for a menubar. |
|
|
396
|
+
| `ApplicationLevel_MenuUserOrg` | Application-level dropdown preset combining avatar trigger and structured sections. | Use in the shell header for account switching and session management. | Avoid when authentication is anonymous or handled entirely off-app. |
|
|
397
|
+
| `ApplicationLevel_NavigationBack` | Icon button integrated with routing/resource header patterns. | Use inside nested resource layouts where users need an explicit up-level action. | Avoid when browser back or breadcrumbs already cover wayfinding. |
|
|
398
|
+
| `ApplicationLevel_NotificationCenter` | Application-level surface distinct from the low-level `NotificationCenter` feedback widget. | Use when notifications should be reviewable from a persistent shell control. | Avoid duplicating toast-only flows that never need an inbox. |
|
|
399
|
+
| `ApplicationLevel_QuickActionButton` | FAB-style shell control wired to app quick-action configuration. | Use when a single high-priority action should stay thumb- or cursor-close. | Avoid when multiple equal actions belong in a balanced toolbar instead. |
|
|
400
|
+
| `ApplicationLevel_QuickSwitcher` | Command or modal style switcher preset for multi-tenant shells. | Use when users frequently jump between organizations or environments. | Avoid for single-tenant products with no switching surface. |
|
|
401
|
+
| `ApplicationLevel_Sidebar` | App-level preset layered on `LOW_LEVEL_SIDEBAR` primitives with behavior hooks. | Use as the primary navigation column for multi-resource SaaS shells. | Avoid when navigation should live solely in top tabs or a single hub page. |
|
|
402
|
+
| `ApplicationLevel_StatusBar` | Thin shell chrome that aggregates lightweight operational telemetry. | Use when users need persistent awareness without opening a panel. | Avoid when toast notifications or inline indicators already cover the same signals. |
|
|
403
|
+
| `ApplicationLevel_Toolbar` | Horizontal shell region hosting icon buttons, splits, and responsive overflow. | Use when 3–7 high-frequency actions should stay one click away. | Avoid when actions are rarely used — prefer menus or command palette. |
|
|
404
|
+
| `ApplicationLevel_UtilityPanel` | Shell utility region with show/hide behavior tied to app configuration. | Use when persistent helper UI should coexist with main canvas content. | Avoid when a single sliding drawer or modal covers the helper use case. |
|
|
405
|
+
|
|
406
|
+
## Overlays / Containers (5)
|
|
407
|
+
|
|
408
|
+
| Component | Renders | Use when | Avoid when |
|
|
409
|
+
| --- | --- | --- | --- |
|
|
410
|
+
| `Alert` | Compound alert surface (root, title, description) with semantic severity and surface variants. | Use for contextual feedback that should remain visible within the page flow. | Avoid for modal confirmations; use `AlertDialog` or `Dialog` instead. |
|
|
411
|
+
| `AlertDialog` | Alert dialog compound: trigger, content, header, title, description, primary/secondary actions. | Use when the user must explicitly confirm or cancel before proceeding. | Avoid for non-critical information or inline validation — prefer `Dialog` or `Alert`. |
|
|
412
|
+
| `Dialog` | Dialog compound with trigger, content, chrome (header/footer/title/description), and close control. | Use when content needs focused attention without a full route change. | Avoid for irreversible confirmations — prefer `AlertDialog`. |
|
|
413
|
+
| `Drawer` | Drawer compound mirroring dialog chrome for mobile-first auxiliary surfaces. | Use for filters, quick edits, or auxiliary panels that slide over content. | Avoid when a centered modal or inline expansion communicates better. |
|
|
414
|
+
| `Sheet` | Sheet compound sharing dialog primitives with directional content placement. | Use for mobile patterns or desktop inspectors that slide from an edge. | Avoid when a centered dialog or full `Drawer` interaction is required. |
|
|
415
|
+
|
|
416
|
+
## Overlays / Floating (5)
|
|
417
|
+
|
|
418
|
+
| Component | Renders | Use when | Avoid when |
|
|
419
|
+
| --- | --- | --- | --- |
|
|
420
|
+
| `ContextMenu` | Context menu compound built from shared floating menu primitives. | Use for secondary actions scoped to a specific element or selection. | Avoid when actions should be discoverable without a context gesture. |
|
|
421
|
+
| `DropdownMenu` | Dropdown menu compound with trigger, content, items, separators, and shortcuts. | Use for button-adjacent action lists, overflow menus, and compact command surfaces. | Avoid when all actions should stay visible — prefer toolbars or sidebars. |
|
|
422
|
+
| `HoverCard` | Hover card compound with trigger and positioned content. | Use for lightweight previews (profiles, summaries) without navigation. | Avoid for essential information or touch-only flows without hover equivalents. |
|
|
423
|
+
| `Popover` | Popover compound: trigger, content, optional anchor. | Use when auxiliary UI should appear adjacent to its trigger. | Avoid for full-screen tasks — prefer `Dialog` or `Sheet`. |
|
|
424
|
+
| `Tooltip` | Tooltip compound: root, trigger, content, plus provider for delay policy. | Use for icon-only controls, truncated labels, and keyboard discoverability. | Avoid for long content or essential instructions — prefer inline help. |
|
|
425
|
+
|
|
426
|
+
## Progression (1)
|
|
427
|
+
|
|
428
|
+
| Component | Renders | Use when | Avoid when |
|
|
429
|
+
| --- | --- | --- | --- |
|
|
430
|
+
| `ProgressionMilestoneTracker` | A card summarising milestone progress — from a one-line glance to a full per-category breakdown, chosen by `variant`. | Use on a dashboard, a home screen or an achievements page when the application declares milestones and wants people to see their progress. Pick the variant by how much of the screen progression deserves there. | Avoid when the application declares no milestones (the card renders nothing useful), and do not use it to show a single milestone's celebration — that is the celebration overlay, which fires on its own when a milestone is reached. |
|
|
431
|
+
|
|
432
|
+
## Resources (19)
|
|
433
|
+
|
|
434
|
+
| Component | Renders | Use when | Avoid when |
|
|
435
|
+
| --- | --- | --- | --- |
|
|
436
|
+
| `ResourceEmptyState` | Layout-level empty placeholder for list/read views tied to a resource type. | Use inside resource layouts when `frontendConfiguration.emptyState` and resource keys should drive copy. | Avoid for non-resource generic panels; use `LOW_LEVEL_EMPTY_STATE` with explicit props. |
|
|
437
|
+
| `ResourceFieldDisplay_ResourceReference` | Display formatter for relationship fields in read templates and summaries. | Use when automatic displayer or read views render relationship fields. | Avoid for editing; use the EDIT category `ResourceFieldEdit_ResourceReference`. |
|
|
438
|
+
| `ResourceFieldEdit_ResourceReference` | Form control for choosing related records inside resource forms. | Use on relationship fields rendered by the automated form pipeline. | Avoid for read-only relationship display; use the DISPLAY category wrapper. |
|
|
439
|
+
| `ResourceLayout_Action` | Action cluster for a resource operation header or toolbar region. | Use when exposing semantic operations next to resource titles. | Avoid duplicating global app actions unrelated to the current resource. |
|
|
440
|
+
| `ResourceLayout_Breadcrumb` | Navigation breadcrumb strip above resource surfaces. | Use on list/read/search operations that expose parent resource requirements. | Avoid when the view is a flat resource with no declared parent chain. |
|
|
441
|
+
| `ResourceLayout_ContainerDialogs` | Dialog container bound to resource layout context. | Use as the framework hook for operation-scoped dialogs. | Avoid bypassing it with ad-hoc portals when resource context should propagate. |
|
|
442
|
+
| `ResourceLayout_ContainerNested` | Embedded composition of owned child collections and single child records inside a parent resource view. | Use to surface the children of a record on that record's own page — the child list/detail rendered inline rather than reached by navigating away. | Avoid for reference-only edges (a pointer to an independent record belongs in the foreign-key field display, not an embedded section), and avoid as a navigation host — it reads relationships, never URL segments. |
|
|
443
|
+
| `ResourceLayout_Create` | Resource creation layout shell. | Use on CREATE operations generated by the resource framework. | Avoid for non-resource standalone forms. |
|
|
444
|
+
| `ResourceLayout_DangerZone` | Fenced, destructive-toned section at the bottom of the read view, hosting destructive actions as rows (title, description, button). | Use when a resource exposes destructive (DANGER_ZONE-placement) operations that should be segregated out of the primary action bar. | Avoid when the resource has no destructive operations; the section renders nothing. |
|
|
445
|
+
| `ResourceLayout_Filters` | Filter controls layout for resource collections. | Use on LIST or SEARCH when filter definitions exist for the resource. | Avoid when the operation has no filter schema. |
|
|
446
|
+
| `ResourceLayout_Header` | Primary resource header chrome. | Use on operations that need consistent resource titling. | Avoid stuffing unrelated widgets into the header; prefer toolbars. |
|
|
447
|
+
| `ResourceLayout_List` | Primary LIST/SEARCH surface that composes resource chrome with the collection renderer; presents as stacked cards or a sortable table per the operation `displayMode`, optionally letting the user switch (choice persisted per resource). | Use for generated LIST operations that need the standard resource list layout lane. | Avoid when the operation replaces the entire view with a custom resource view override. |
|
|
448
|
+
| `ResourceLayout_OperationBulk` | Bulk operations host for selected rows. | Use when LIST enables multi-select with bulk semantics. | Avoid when selection is not supported. |
|
|
449
|
+
| `ResourceLayout_OperationsItems` | Inline item operations renderer. | Use for row-level actions in collections. | Avoid replacing the entire row renderer unless intentional. |
|
|
450
|
+
| `ResourceLayout_Pagination` | Collection pagination strip. | Use for paginated LIST/SEARCH surfaces. | Avoid when the backend uses infinite scroll only. |
|
|
451
|
+
| `ResourceLayout_Read` | Hosts the canonical detail page shell for one resource operation, including header, detail display, inserted views, and nested surfaces. | Use this component target when the UI needs the framework-owned resource detail shell through the standard resource-layout preset lane. | Avoid treating this target as the home of operation-owned custom views. Resource-specific read overrides belong to the resource specification and UI behavior metadata, not to this injectable component family. |
|
|
452
|
+
| `ResourceLayout_ReadSummary` | Condensed read layout distinct from the full `RESOURCES_LAYOUTS_READ` shell. | Use when LIST, SEARCH, or nested views need a lighter read preview. | Avoid when the full detail read page is required. |
|
|
453
|
+
| `ResourceLayout_Search` | Primary SEARCH surface for resource discovery flows. | Use for generated SEARCH operations that participate in the resource layout system. | Avoid when replacing the view entirely with a custom search experience unrelated to resource config. |
|
|
454
|
+
| `ResourceLayout_Update` | Resource update layout shell. | Use on UPDATE operations from the resource framework. | Avoid for wizard flows that are not operation-backed. |
|
|
455
|
+
|
|
456
|
+
## Sections (8)
|
|
457
|
+
|
|
458
|
+
| Component | Renders | Use when | Avoid when |
|
|
459
|
+
| --- | --- | --- | --- |
|
|
460
|
+
| `Accordion` | Compound accordion: root, item, trigger, content. | Use when vertical space must be conserved and users scan section titles before revealing detail. | Avoid when all content should stay visible; prefer `Collapsible` single regions or plain layout. |
|
|
461
|
+
| `Card` | Compound card shell: `Card`, `CardListbox`, `CardHeader`, `CardTitle`, `CardDescription`, `CardAction`, `CardContent`, `CardFooter`. A card can carry a status edge, be the selected one of its list, and be an option of a `CardListbox`. | Use for summaries, entity snapshots, dashboard tiles, and form sections that need a clear boundary. | Avoid nesting many interactive cards inside tiny lists without spacing; consider table rows instead. |
|
|
462
|
+
| `Collapsible` | Compound: root, trigger, content. | Use for optional detail blocks, advanced settings, or progressive disclosure around one trigger. | Avoid when multiple independent sections need coordinated single-open behaviour; use `Accordion`. |
|
|
463
|
+
| `Pagination` | Compound pagination: `Pagination`, `PaginationContent`, `PaginationItem`, `PaginationLink`, `PaginationPrevious`, `PaginationNext`, `PaginationEllipsis`. | Use with list and table views that load a slice of results per request. | Avoid for infinite scroll-only surfaces without page semantics. |
|
|
464
|
+
| `StackedLayout` | Compound layout shell for CRUD/read surfaces with consistent spacing and max-width constraints. | Use as the structural backbone for resource read/update pages and dashboard sections. | Avoid when a minimal flex stack suffices; this slot carries many sub-regions. |
|
|
465
|
+
| `Stepper` | Compound stepper: root, item, indicator, separator, title, description per step index. | Use when the user must understand position in a bounded sequence of steps. | Avoid for non-linear graphs; use a dedicated flow/graph visualization. |
|
|
466
|
+
| `Table` | Compound table: `Table`, `TableHeader`, `TableBody`, `TableFooter`, `TableRow`, `TableHead`, `TableCell`, `TableCaption`. | Use for dense relational data, comparison matrices, and audit logs. | Avoid when a single-column list is enough; consider responsive cards on narrow viewports. |
|
|
467
|
+
| `Tabs` | Compound tabs: `Tabs`, `TabsList`, `TabsTrigger`, `TabsContent` with roving focus on triggers. A trigger takes `count` (how many things are behind the tab; zero renders nothing) and `countTone` (an IndicatorVariant, NEUTRAL by default). | Use when content is mutually exclusive but contextually related (settings sections, dashboard modules). | Avoid when navigation should change URL or when more than ~5 tabs would overflow; consider a different nav pattern. |
|
|
468
|
+
|
|
469
|
+
## Typography (8)
|
|
470
|
+
|
|
471
|
+
| Component | Renders | Use when | Avoid when |
|
|
472
|
+
| --- | --- | --- | --- |
|
|
473
|
+
| `Code` | Semantic `<code>` element for inline technical fragments inside prose. | Use for short inline code tokens inside paragraphs, labels, or tables. | Avoid for multi-line blocks; use dedicated code-block or AI artifact components. |
|
|
474
|
+
| `Heading` | Primary title element that carries document outline semantics and theme-aware type scale. | Use for the main title of a view, card, or section when hierarchy should map to heading levels. | Avoid when styling body copy; prefer `LOW_LEVEL_TEXT` or `LOW_LEVEL_SUBHEADING` for de-emphasized titles. |
|
|
475
|
+
| `Label` | Native `label` element styled via `UIBehavior.TYPOGRAPHY` recipes. | Use when associating visible text with an input via `htmlFor` or wrapping the control. | Avoid for non-interactive headings; use `Heading` or `Text`. |
|
|
476
|
+
| `Link` | Interactive anchor styled as a text link with semantic color variants and underline modes. | Use for in-app navigation, external references, and inline textual actions that should read as links. | Avoid when the control should be a button (form submit, dialog trigger); prefer `Button` or `ActionButton`. |
|
|
477
|
+
| `Strong` | Strong emphasis inline element composed inside paragraphs and labels. | Use for critical words or values inside a sentence that need weight, not a new heading. | Avoid for whole lines of text; use `Heading` or styled `Text` variants instead. |
|
|
478
|
+
| `Subheading` | Secondary title with smaller type scale while still using heading outline semantics. | Use directly under a main `Heading` or as a section strapline. | Avoid for long body copy; use `LOW_LEVEL_TEXT` instead. |
|
|
479
|
+
| `Text` | Paragraph or inline text primitive defaulting to `<p>` with optional `as` override. | Use for descriptive copy, helper text, and list-adjacent prose. | Avoid for navigational anchors; use `Link` or `TextLink`. |
|
|
480
|
+
| `TextLink` | Same props surface as `Link` (`LinkProps`) but registered as `TextLink` for preset overrides inside rich text. | Use inside paragraphs and descriptions where the link should inherit text flow semantics. | Avoid for standalone CTAs; use `Link` directly when not embedded in `Text` blocks. |
|