@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
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/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- 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/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -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 +321 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- 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 +0 -3
- 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 +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- 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 +55 -10
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- 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 +1 -6
- 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 +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
- 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 +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- 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 +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- 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 +0 -1
- 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 +10 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- 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.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- 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/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- 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.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
- 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 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- 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/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- 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/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- 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/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- 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/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- 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 +11 -0
- 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 +7 -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.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 +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- 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 +14 -30
- 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.module.companion-exports.full.md +8 -13
- 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 +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -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 +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -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 +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- 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.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/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -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 +21 -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 +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- 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 +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- 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 +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- 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 +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -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 +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -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.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- 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-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- 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.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- 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 +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- 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 +667 -6
- 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.http-api-binding.md +812 -29
- 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.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 +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -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.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.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.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 +34 -0
- 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 +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -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 +242 -7
- 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 +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- 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 +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -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 +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -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 +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- 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 +10 -10
- 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 +5 -2
- 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 +23 -4
- 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/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- 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 +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- 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 +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -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 +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- 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 +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- 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 +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -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 +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- 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 +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -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 +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -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 +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -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 +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -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 +43 -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 +32 -1
- 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 +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- 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-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- 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 +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- 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 +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- 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 +272 -33
- 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-package-allow-list-api.md +111 -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 +132 -23
- 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 +29 -0
- 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 +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -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 +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -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 +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- 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 +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- 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 +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- 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 +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- 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 +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- 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 +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- 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 +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- 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 +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -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 +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -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 +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -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 +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- 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 +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -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 +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- 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 +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- 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 +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5957 -1729
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md
ADDED
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
# Framework 3D Layout Contract API
|
|
2
|
+
|
|
3
|
+
What a 3D layout is: where the regions go (the placement, which has nothing 3D in it), what the frame draws (the
|
|
4
|
+
scene), what it plays (the transitions) and under which constraints — with the built-in layouts and every
|
|
5
|
+
vocabulary a layout declares.
|
|
6
|
+
|
|
7
|
+
Read this when you:
|
|
8
|
+
|
|
9
|
+
- choose between the built-in layouts;
|
|
10
|
+
- author an application's own layout (its placement, its transitions, an id of its own);
|
|
11
|
+
- need to know what a transition does and why it can never make text unreadable.
|
|
12
|
+
|
|
13
|
+
## Import Origins
|
|
14
|
+
|
|
15
|
+
- `@wildo-ai/presets-components-3d`
|
|
16
|
+
|
|
17
|
+
## Source Excerpts
|
|
18
|
+
|
|
19
|
+
### Origin Package: `@wildo-ai/presets-components-3d`
|
|
20
|
+
|
|
21
|
+
```typescript
|
|
22
|
+
/**
|
|
23
|
+
* A 3D layout: where the regions go (`placement`, 3D-free), and what the frame draws around them (`scene`,
|
|
24
|
+
* `transitions`), under `constraints`.
|
|
25
|
+
*/
|
|
26
|
+
export interface Layout3DDefinition {
|
|
27
|
+
/** A {@link Layout3DId} for a built-in layout; an application's own layout names itself. */
|
|
28
|
+
id: string;
|
|
29
|
+
placement: ShellLayoutPlacement;
|
|
30
|
+
scene: {
|
|
31
|
+
camera: Layout3DCamera;
|
|
32
|
+
/** The frame styles, per theme, with a fallback for any theme id the catalog does not name. */
|
|
33
|
+
frameStyles: Frame3DStyleCatalog;
|
|
34
|
+
};
|
|
35
|
+
/** What the frame plays on an appearance change, a navigation, a sidebar resize and a zone focus. */
|
|
36
|
+
transitions: Layout3DTransitions;
|
|
37
|
+
constraints: {
|
|
38
|
+
/** The shell appearance the layout is designed for; any other is reported once (a console warning), never switched. */
|
|
39
|
+
requiredShellAppearance: ShellAppearance | null;
|
|
40
|
+
restPose: Layout3DRestPose;
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* The 2D disposal, unchanged, with the frame under it. On navigation the content slab lifts and settles; when
|
|
46
|
+
* the sidebar collapses or expands, the light swings across and back.
|
|
47
|
+
*/
|
|
48
|
+
export const INHERIT_LAYOUT_3D: Layout3DDefinition = {
|
|
49
|
+
id: Layout3DId.INHERIT,
|
|
50
|
+
placement: { kind: ShellLayoutPlacementKind.INHERIT },
|
|
51
|
+
scene: { camera: Layout3DCamera.FLAT_ORTHOGRAPHIC, frameStyles: INHERIT_FRAME_STYLES },
|
|
52
|
+
transitions: {
|
|
53
|
+
appearance: Layout3DAppearanceTransition.CROSS_FADE,
|
|
54
|
+
navigation: Layout3DFrameChoreography.ELEVATION_SETTLE,
|
|
55
|
+
sidebarResize: Layout3DFrameChoreography.LIGHT_SWEEP,
|
|
56
|
+
zoneFocus: Layout3DZoneFocusTransition.RIM,
|
|
57
|
+
},
|
|
58
|
+
constraints: { requiredShellAppearance: ShellAppearance.CONTINUOUS, restPose: Layout3DRestPose.FLAT },
|
|
59
|
+
};
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* The header-first disposal, with the frame lit from the header down. On navigation the light swings from the header
|
|
63
|
+
* and returns; when the sidebar collapses or expands, the content slab lifts and settles.
|
|
64
|
+
*/
|
|
65
|
+
export const HEADER_FIRST_LAYOUT_3D: Layout3DDefinition = {
|
|
66
|
+
id: Layout3DId.HEADER_FIRST,
|
|
67
|
+
placement: { kind: ShellLayoutPlacementKind.COMPOSED, container: HeaderFirstShellContainer },
|
|
68
|
+
scene: { camera: Layout3DCamera.FLAT_ORTHOGRAPHIC, frameStyles: HEADER_FIRST_FRAME_STYLES },
|
|
69
|
+
transitions: {
|
|
70
|
+
appearance: Layout3DAppearanceTransition.CROSS_FADE,
|
|
71
|
+
navigation: Layout3DFrameChoreography.LIGHT_SWEEP,
|
|
72
|
+
sidebarResize: Layout3DFrameChoreography.ELEVATION_SETTLE,
|
|
73
|
+
zoneFocus: Layout3DZoneFocusTransition.RIM,
|
|
74
|
+
},
|
|
75
|
+
constraints: { requiredShellAppearance: ShellAppearance.CONTINUOUS, restPose: Layout3DRestPose.FLAT },
|
|
76
|
+
};
|
|
77
|
+
/**
|
|
78
|
+
* The focal plane (#2049): the shell regions, each navigation pane and each popup are glass objects in depth under one
|
|
79
|
+
* still camera. Whatever you work with rests on the focal plane; the rest steps back. No WebGL frame: the depth is in
|
|
80
|
+
* the HTML objects themselves, so the frame styles and frame transitions below are not drawn.
|
|
81
|
+
*/
|
|
82
|
+
export const FOCAL_PLANE_LAYOUT_3D: Layout3DDefinition = {
|
|
83
|
+
id: Layout3DId.FOCAL_PLANE,
|
|
84
|
+
placement: { kind: ShellLayoutPlacementKind.COMPOSED, container: FocalPlaneShellContainer },
|
|
85
|
+
scene: { camera: Layout3DCamera.STILL_PERSPECTIVE, frameStyles: INHERIT_FRAME_STYLES },
|
|
86
|
+
transitions: {
|
|
87
|
+
appearance: Layout3DAppearanceTransition.CROSS_FADE,
|
|
88
|
+
navigation: Layout3DFrameChoreography.NONE,
|
|
89
|
+
sidebarResize: Layout3DFrameChoreography.NONE,
|
|
90
|
+
zoneFocus: Layout3DZoneFocusTransition.NONE,
|
|
91
|
+
},
|
|
92
|
+
constraints: { requiredShellAppearance: ShellAppearance.CONTINUOUS, restPose: Layout3DRestPose.FLAT },
|
|
93
|
+
};
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
### Origin Package: `@wildo-ai/presets-components-3d`
|
|
97
|
+
|
|
98
|
+
```typescript
|
|
99
|
+
/**
|
|
100
|
+
* The built-in 3D layouts. An application uses exactly ONE, chosen when it registers the library; there
|
|
101
|
+
* is no switch. An application may also define its own layout with an id of its own.
|
|
102
|
+
*/
|
|
103
|
+
export enum Layout3DId {
|
|
104
|
+
/** The 2D shell's own disposal, unchanged, with the 3D frame drawn under its regions. */
|
|
105
|
+
INHERIT = 'inherit',
|
|
106
|
+
/**
|
|
107
|
+
* The menubar and the status bars span the whole width; the navigation rails (activity bar, sidebar, utility
|
|
108
|
+
* panel) sit between them, beside the content. The default disposal is sidebar-first; this one is header-first.
|
|
109
|
+
*/
|
|
110
|
+
HEADER_FIRST = 'header-first',
|
|
111
|
+
/**
|
|
112
|
+
* The focal plane (#2049): one still perspective camera; the shell regions, each navigation pane and each popup are
|
|
113
|
+
* separate glass objects that travel in depth. Whatever you work with rests on the focal plane at its true size;
|
|
114
|
+
* everything else steps back. Nothing is angled and the camera never moves (Paul, 2026-09-30).
|
|
115
|
+
*/
|
|
116
|
+
FOCAL_PLANE = 'focal-plane',
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* The cameras a 3D layout is seen through. The flat camera's transitions are all drawn IN the flat frame (elevation,
|
|
121
|
+
* light, rims), so a slab never leaves its region's box; the still-perspective camera moves the HTML objects instead.
|
|
122
|
+
*/
|
|
123
|
+
export enum Layout3DCamera {
|
|
124
|
+
/** Orthographic, matched 1:1 to CSS pixels: the frame lies flat under the regions, exactly on their boxes. */
|
|
125
|
+
FLAT_ORTHOGRAPHIC = 'flat-orthographic',
|
|
126
|
+
/**
|
|
127
|
+
* A still perspective camera, in CSS: the HTML objects themselves carry depth, around one shared vanishing point, and
|
|
128
|
+
* no WebGL frame is drawn. The camera never moves; objects do (#2049). Only a placement that stages the objects can
|
|
129
|
+
* be seen through it.
|
|
130
|
+
*/
|
|
131
|
+
STILL_PERSPECTIVE = 'still-perspective',
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* How the frame answers an APPEARANCE change: a theme, a density, a reduced-motion switch.
|
|
136
|
+
*
|
|
137
|
+
* Whatever the member, a light/dark switch SNAPS: text changes colour at once, and a backdrop halfway between two
|
|
138
|
+
* modes is bounded against neither foreground.
|
|
139
|
+
*/
|
|
140
|
+
export enum Layout3DAppearanceTransition {
|
|
141
|
+
/** The frame cross-fades to the new appearance over the theme's normal motion duration. */
|
|
142
|
+
CROSS_FADE = 'cross-fade',
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* A choreography the frame plays once, as a PULSE that rises and settles, when a shell state changes. The same
|
|
147
|
+
* vocabulary serves every pulse-shaped trigger of {@link Layout3DTransitions} (a navigation, a sidebar resize), so a
|
|
148
|
+
* layout picks per trigger and a new choreography is available to every trigger at once.
|
|
149
|
+
*
|
|
150
|
+
* Every member is drawn in the FRAME. No member transforms a region: a CSS transform blurs text while it runs and
|
|
151
|
+
* makes the region the containing block of its `position: fixed` overlays. A choreography that moved regions would
|
|
152
|
+
* need an untransformed portal target on the shell providers (a default-off option, not built) and its own
|
|
153
|
+
* member here; none exists.
|
|
154
|
+
*
|
|
155
|
+
* Every member stays inside the contrast bound (see each), and plays nothing under reduced motion, where the theme's
|
|
156
|
+
* motion duration is zero.
|
|
157
|
+
*/
|
|
158
|
+
export enum Layout3DFrameChoreography {
|
|
159
|
+
/** Nothing moves. For an application's own layout that wants a still frame on this trigger. */
|
|
160
|
+
NONE = 'none',
|
|
161
|
+
/**
|
|
162
|
+
* The content slab lifts toward the reader and settles back: its shadow spreads and drops further, and its rim
|
|
163
|
+
* brightens toward its hover opacity, then both return. Only blur, offset and rim move — never the shadow's
|
|
164
|
+
* opacity, and never the rim past the hover opacity the bound was proved for.
|
|
165
|
+
*/
|
|
166
|
+
ELEVATION_SETTLE = 'elevation-settle',
|
|
167
|
+
/**
|
|
168
|
+
* The light swings across the frame and back: every gradient re-orients along the moving light. Every colour it
|
|
169
|
+
* shows is a point of a gradient the bound already covers; only its direction changes.
|
|
170
|
+
*/
|
|
171
|
+
LIGHT_SWEEP = 'light-sweep',
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* What the frame shows for the FOCUSED navigation zone (`useNavigationState().focusedZone`), when two or more zones
|
|
176
|
+
* are side by side.
|
|
177
|
+
*/
|
|
178
|
+
export enum Layout3DZoneFocusTransition {
|
|
179
|
+
/** Nothing marks the focused zone in the frame. */
|
|
180
|
+
NONE = 'none',
|
|
181
|
+
/**
|
|
182
|
+
* A rim in the content slab's rim colour, at most its hover opacity, around the focused zone; it moves to another
|
|
183
|
+
* zone with the theme's gesture spring. Inset clear of the content slab's own rim band, so where it is drawn it is
|
|
184
|
+
* the case the bound was proved for — a rim at hover opacity over the frost — except that it is written as a second
|
|
185
|
+
* framebuffer layer, rounded to 8 bits twice rather than once (at most 1/255 apart), and that the emphasis values
|
|
186
|
+
* between rest and hover are not checked one by one: both limits are shared with the slab rim's own hover emphasis.
|
|
187
|
+
*/
|
|
188
|
+
RIM = 'rim',
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* What a layout does to the regions at rest. Only FLAT exists: a CSS 3D transform blurs text, and any transform
|
|
193
|
+
* makes a region the containing block of its `position: fixed` descendants. A layout that wants a persistent tilt
|
|
194
|
+
* needs an untransformed portal target on the shell providers (not built: no choreography moves a region) and a new member here.
|
|
195
|
+
*/
|
|
196
|
+
export enum Layout3DRestPose {
|
|
197
|
+
/** The regions are never transformed at rest. */
|
|
198
|
+
FLAT = 'flat',
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/**
|
|
202
|
+
* What a layout plays, per trigger. The triggers are read from existing state only: the navigation state
|
|
203
|
+
* (`useNavigationState`) and the shell's own region measurement. Whatever a layout picks, the frame FOLLOWS every
|
|
204
|
+
* region's box frame by frame while the shell animates (the alignment invariant); these are what it plays
|
|
205
|
+
* ON TOP of following.
|
|
206
|
+
*/
|
|
207
|
+
export interface Layout3DTransitions {
|
|
208
|
+
/** A theme, density or reduced-motion change. */
|
|
209
|
+
appearance: Layout3DAppearanceTransition;
|
|
210
|
+
/**
|
|
211
|
+
* The content changed: any structural zone's top entry is a different place (its URL). The route sync hooks mirror
|
|
212
|
+
* router navigations into those stacks, so a sidebar link and a record opened beside a list both count; the
|
|
213
|
+
* overlay zone does not (a dialog is not a place).
|
|
214
|
+
*/
|
|
215
|
+
navigation: Layout3DFrameChoreography;
|
|
216
|
+
/** The sidebar collapsed, expanded or was resized: its measured width changed while it stayed on screen. */
|
|
217
|
+
sidebarResize: Layout3DFrameChoreography;
|
|
218
|
+
/** The navigation state's focused zone changed while two or more zones are side by side. */
|
|
219
|
+
zoneFocus: Layout3DZoneFocusTransition;
|
|
220
|
+
}
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
### Origin Package: `@wildo-ai/presets-components-3d`
|
|
224
|
+
|
|
225
|
+
```typescript
|
|
226
|
+
/**
|
|
227
|
+
* How a shell layout disposes the regions — the half of a layout with nothing 3D in it.
|
|
228
|
+
*
|
|
229
|
+
* Named for the SHELL, not for 3D, on purpose: a composed placement is an ordinary shell container built from the
|
|
230
|
+
* building blocks of `@wildo-ai/saas-frontend-lib` (`AppShellProviders`, the region, content and overlays outlets,
|
|
231
|
+
* `AppShellLoadingState`), so the same shape can serve a general layout system for 2D shells — planned, not built —
|
|
232
|
+
* without renaming. The 3D half (scene, transitions, rest pose) lives in `Layout3DDefinition`.
|
|
233
|
+
*/
|
|
234
|
+
export enum ShellLayoutPlacementKind {
|
|
235
|
+
/** The main container the registration captured (the 2D default, or an application's own), rendered unchanged. */
|
|
236
|
+
INHERIT = 'inherit',
|
|
237
|
+
/** A container of the layout's own, composed from the shell building blocks. */
|
|
238
|
+
COMPOSED = 'composed',
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/** A shell layout's disposal. */
|
|
242
|
+
export type ShellLayoutPlacement =
|
|
243
|
+
| { kind: ShellLayoutPlacementKind.INHERIT }
|
|
244
|
+
| { kind: ShellLayoutPlacementKind.COMPOSED; container: React.ComponentType<AppLayoutPreset_MainContainer_DefaultProps> };
|
|
245
|
+
```
|
package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# Framework 3D Layout Registration API
|
|
2
|
+
|
|
3
|
+
The one call that makes an application 3D, and the options it takes.
|
|
4
|
+
|
|
5
|
+
Read this when you:
|
|
6
|
+
|
|
7
|
+
- add the registration to `frontend/src/engine/component-registrations.frontend.ts`;
|
|
8
|
+
- need to know what `register3DLayout` refuses (nothing registered yet, a second layout, a borrowed built-in id);
|
|
9
|
+
- pass frame-style overrides or an application's own layout.
|
|
10
|
+
|
|
11
|
+
## Import Origins
|
|
12
|
+
|
|
13
|
+
- `@wildo-ai/presets-components-3d`
|
|
14
|
+
|
|
15
|
+
## Source Excerpts
|
|
16
|
+
|
|
17
|
+
### Origin Package: `@wildo-ai/presets-components-3d`
|
|
18
|
+
|
|
19
|
+
```tsx
|
|
20
|
+
/** What a 3D main container draws: the layout, and the application's frame-style overrides. */
|
|
21
|
+
export interface Layout3DOptions {
|
|
22
|
+
/**
|
|
23
|
+
* The layout: its disposal, its scene and its transitions. Defaults to {@link INHERIT_LAYOUT_3D}, the 2D disposal
|
|
24
|
+
* with the frame under it. An application uses ONE layout for its whole life.
|
|
25
|
+
*/
|
|
26
|
+
layout?: Layout3DDefinition;
|
|
27
|
+
/** Frame-style overrides layered over the layout's built-in styles. */
|
|
28
|
+
frameStyles?: Frame3DStyleOverrides;
|
|
29
|
+
/**
|
|
30
|
+
* Overrides of the focal plane's numbers (camera distance, layer depth, motion, dims, blurs, window opacity), for
|
|
31
|
+
* {@link FOCAL_PLANE_LAYOUT_3D}; each is checked at registration. Omitted, the defaults.
|
|
32
|
+
*/
|
|
33
|
+
focalPlane?: Partial<FocalPlaneSettings>;
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### Origin Package: `@wildo-ai/presets-components-3d`
|
|
38
|
+
|
|
39
|
+
```typescript
|
|
40
|
+
/**
|
|
41
|
+
* Make an application's signed-in shell 3D: the shell's regions — unchanged HTML, with all their contexts —
|
|
42
|
+
* arranged by a 3D layout, with a decorative WebGL frame drawn under them.
|
|
43
|
+
*
|
|
44
|
+
* There is no 2D/3D switch and no option to enable it. An application is 3D because it CALLS this, from
|
|
45
|
+
* its engine module's `componentRegistrations` — the entries `registerFrontendComponentRegistrations`
|
|
46
|
+
* runs AFTER the framework presets are registered, so the Default main container exists by then:
|
|
47
|
+
*
|
|
48
|
+
* ```ts
|
|
49
|
+
* import { register3DLayout } from '@wildo-ai/presets-components-3d';
|
|
50
|
+
*
|
|
51
|
+
* export const engineComponentRegistrations: FrontendComponentRegistration[] = [register3DLayout()];
|
|
52
|
+
* ```
|
|
53
|
+
*
|
|
54
|
+
* It registers under `Default` for `APP_LAYOUTS_MAIN_CONTAINER`, the only preset key the shell resolves,
|
|
55
|
+
* after capturing the container registered there before it. An INHERIT layout renders that captured container,
|
|
56
|
+
* unchanged; a layout with a disposal of its own renders its composed container instead, built from the same
|
|
57
|
+
* shell building blocks — either way every region, context and behaviour is the application's own.
|
|
58
|
+
*
|
|
59
|
+
* - **Refuses** when nothing is registered yet: capturing `null` would render no shell at all, and the
|
|
60
|
+
* cause — the registration running before the framework presets — is worth an error, not a blank app.
|
|
61
|
+
* - **Idempotent**: a registration that finds a 3D container already there (a second call, or the
|
|
62
|
+
* registry surviving a hot reload on `globalThis`) wraps the 2D container IT captured, never itself.
|
|
63
|
+
* - **Keeps the registration's metadata**: the captured container's `isConfigurable` is carried over, so
|
|
64
|
+
* nothing that reads the registry's metadata sees a difference.
|
|
65
|
+
*
|
|
66
|
+
* `options.layout` selects the layout (`INHERIT_LAYOUT_3D` by default); `options.frameStyles` layers an
|
|
67
|
+
* application's frame styles over the layout's own (per theme id, or for all themes).
|
|
68
|
+
*
|
|
69
|
+
* - **One layout per application.** A registration that finds a 3D container of a DIFFERENT layout already
|
|
70
|
+
* registered refuses: an application is not 3D in two ways, and a silent replacement would hide which one it
|
|
71
|
+
* is. The same layout again is idempotent. (A layout changed in code during a hot reload needs a full page
|
|
72
|
+
* reload, because the registry outlives the hot reload.)
|
|
73
|
+
*/
|
|
74
|
+
export function register3DLayout(options: Layout3DOptions = {}): FrontendComponentRegistration {
|
|
75
|
+
let capturedIsConfigurable = false;
|
|
76
|
+
return {
|
|
77
|
+
componentRef: FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER,
|
|
78
|
+
preset: CorePresetNames.DEFAULT,
|
|
79
|
+
get isConfigurable(): boolean {
|
|
80
|
+
return capturedIsConfigurable;
|
|
81
|
+
},
|
|
82
|
+
loadComponent: async () => {
|
|
83
|
+
const current = ComponentRegistryService.resolve(FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER, CorePresetNames.DEFAULT);
|
|
84
|
+
if (!current) {
|
|
85
|
+
throw new Error(
|
|
86
|
+
'register3DLayout(): no Default APP_LAYOUTS_MAIN_CONTAINER is registered to capture. Call it from the engine module\'s '
|
|
87
|
+
+ '`componentRegistrations`, which run after the framework presets — not from a module evaluated before them.',
|
|
88
|
+
);
|
|
89
|
+
}
|
|
90
|
+
const layout = options.layout ?? INHERIT_LAYOUT_3D;
|
|
91
|
+
// An application's own layout may not borrow a built-in id: the one-layout check compares ids, and a borrowed
|
|
92
|
+
// one would make two different layouts look like the same.
|
|
93
|
+
if ((Object.values(Layout3DId) as string[]).includes(layout.id) && BUILT_IN_LAYOUTS_3D[layout.id as Layout3DId] !== layout) {
|
|
94
|
+
throw new Error(`register3DLayout(): the layout id '${layout.id}' belongs to a built-in layout; give the application's own layout an id of its own.`);
|
|
95
|
+
}
|
|
96
|
+
if (isLayout3DMainContainer(current) && current.layout.id !== layout.id) {
|
|
97
|
+
throw new Error(
|
|
98
|
+
`register3DLayout(): this application already registered the 3D layout '${current.layout.id}' and now asks for '${layout.id}'. `
|
|
99
|
+
+ 'An application uses one layout: remove the other registration — or, if you just changed the layout in code, '
|
|
100
|
+
+ 'reload the page (the component registry outlives a hot reload).',
|
|
101
|
+
);
|
|
102
|
+
}
|
|
103
|
+
capturedIsConfigurable = ComponentRegistryService.getMetadata(FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER, CorePresetNames.DEFAULT)?.isConfigurable ?? false;
|
|
104
|
+
return create3DMainContainer(isLayout3DMainContainer(current) ? current.captured : current, options);
|
|
105
|
+
},
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
```
|
package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md
ADDED
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
# Framework Shell Building Blocks API
|
|
2
|
+
|
|
3
|
+
The providers and outlets a shell container is composed from. A layout with an arrangement of its own
|
|
4
|
+
(`ShellLayoutPlacementKind.COMPOSED`) renders a container built only from these, so every region, provider and
|
|
5
|
+
context stays the application's own.
|
|
6
|
+
|
|
7
|
+
Read this when you author an application's own layout with a composed placement.
|
|
8
|
+
|
|
9
|
+
## Import Origins
|
|
10
|
+
|
|
11
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
12
|
+
|
|
13
|
+
## Source Excerpts
|
|
14
|
+
|
|
15
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
16
|
+
|
|
17
|
+
```tsx
|
|
18
|
+
/**
|
|
19
|
+
* # App shell building blocks
|
|
20
|
+
*
|
|
21
|
+
* The signed-in shell is a LAYOUT — where the regions sit — over parts that do not depend on the layout: the
|
|
22
|
+
* region components themselves (each resolved from the component registry by its wrapper), the content area,
|
|
23
|
+
* the overlays, and two providers every region reads. These building blocks are those parts, so a layout
|
|
24
|
+
* preset only decides the ARRANGEMENT. `AppLayoutPreset_MainContainer_Default` is composed from them, and any
|
|
25
|
+
* other layout container an application registers should be too — a different arrangement of the same regions,
|
|
26
|
+
* or, later, an alternative rendering that draws decoration around them.
|
|
27
|
+
*
|
|
28
|
+
* A layout preset uses them like this:
|
|
29
|
+
*
|
|
30
|
+
* ```tsx
|
|
31
|
+
* const layout = useAppShellLayout();
|
|
32
|
+
* const hasBeenReady = useAppShellFirstReady(layout.isLayoutReady);
|
|
33
|
+
* if (!layout.isLayoutReady && !hasBeenReady) return <AppShellLoadingState />;
|
|
34
|
+
* return (
|
|
35
|
+
* <AppShellProviders layout={layout}>
|
|
36
|
+
* <div className="my-arrangement">
|
|
37
|
+
* <AppShellRegionOutlet region={ShellRegion.SIDEBAR} placement={HorizontalPlacement.START} />
|
|
38
|
+
* <AppShellRegionOutlet region={ShellRegion.MENUBAR} />
|
|
39
|
+
* <AppShellContentOutlet className="flex-1 relative min-w-0">{children}</AppShellContentOutlet>
|
|
40
|
+
* <AppShellOverlaysOutlet />
|
|
41
|
+
* </div>
|
|
42
|
+
* </AppShellProviders>
|
|
43
|
+
* );
|
|
44
|
+
* ```
|
|
45
|
+
*
|
|
46
|
+
* Four rules keep a custom layout correct:
|
|
47
|
+
*
|
|
48
|
+
* - **Render `AppShellProviders` exactly once, around the whole shell.** It owns the single open state and the
|
|
49
|
+
* single hotkey registration of the command menu, notification center and quick switcher; two copies would
|
|
50
|
+
* make one shortcut open two dialogs.
|
|
51
|
+
* - **Place every region the application configures.** An outlet renders nothing when its region is not
|
|
52
|
+
* configured, so placing an outlet is always safe; leaving one out silently drops a region.
|
|
53
|
+
* - **Render `AppShellContentOutlet` exactly once.** It is the `<main>` landmark, and overlays portal into it —
|
|
54
|
+
* unless the layout also renders `AppShellOverlayPortalLayer`, which then takes the overlays instead. A layout that
|
|
55
|
+
* transforms its regions (a 3D placement) must render that layer OUTSIDE the transformed subtree: a transformed
|
|
56
|
+
* ancestor is the containing block of every `position: fixed` descendant, so a dialog in `<main>` would be confined
|
|
57
|
+
* to the pane and a menu would be placed in the wrong coordinates.
|
|
58
|
+
* - **Give the root `position: relative`, not `isolation: isolate`,** when the theme may declare a background
|
|
59
|
+
* layer. That layer is painted in its own stacking context above ordinary in-flow content, so shell text with
|
|
60
|
+
* no positioned ancestor is painted UNDER it; positioning the root lifts the whole shell above it. `isolate`
|
|
61
|
+
* would also lift it, but would make the shell one stacking context, so an overlay outside the shell with a
|
|
62
|
+
* lower z-index (a consent prompt) would paint over the shell's own dialogs.
|
|
63
|
+
*/
|
|
64
|
+
|
|
65
|
+
/** The layout decisions `useAppShellLayout()` computed, shared with every outlet below the providers. */
|
|
66
|
+
const AppShellLayoutContext = createContext<AppShellLayoutInfo | null>(null);
|
|
67
|
+
|
|
68
|
+
/** Lets the content outlet hand its `<main>` element to the providers, which expose it as the portal container. */
|
|
69
|
+
const AppShellPortalTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);
|
|
70
|
+
|
|
71
|
+
/** Lets `AppShellOverlayPortalLayer` hand its element to the providers, which then prefer it over `<main>`. */
|
|
72
|
+
const AppShellOverlayLayerTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);
|
|
73
|
+
|
|
74
|
+
function useAppShellLayoutContext(consumer: string): AppShellLayoutInfo {
|
|
75
|
+
const layout = useContext(AppShellLayoutContext);
|
|
76
|
+
if (!layout) {
|
|
77
|
+
throw new Error(`${consumer} must be rendered inside <AppShellProviders>, which supplies the layout it places regions from.`);
|
|
78
|
+
}
|
|
79
|
+
return layout;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Latches the FIRST time the shell becomes ready.
|
|
84
|
+
*
|
|
85
|
+
* `isLayoutReady` derives from configuration presence and can drop transiently after bootstrap (an
|
|
86
|
+
* organization switch reloading config, for example). Replacing the mounted shell with a loading state on such
|
|
87
|
+
* a drop would unmount every provider and zone below it and destroy navigation state — the failure mode
|
|
88
|
+
* `AppLoadingGate` documents. So a layout shows its loading state only while this returns `false`.
|
|
89
|
+
*/
|
|
90
|
+
export function useAppShellFirstReady(isLayoutReady: boolean): boolean {
|
|
91
|
+
const [hasLayoutBeenReady, setHasLayoutBeenReady] = useState(false);
|
|
92
|
+
useEffect(() => {
|
|
93
|
+
if (isLayoutReady) setHasLayoutBeenReady(true);
|
|
94
|
+
}, [isLayoutReady]);
|
|
95
|
+
return hasLayoutBeenReady;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* The shell's loading state: a centred spinner on the page background, announced politely. What every layout
|
|
100
|
+
* shows while `useAppShellFirstReady` says the shell has never been ready — one component rather than a copy per
|
|
101
|
+
* layout, so the loading state is the same whatever the disposal.
|
|
102
|
+
*/
|
|
103
|
+
export function AppShellLoadingState(): React.JSX.Element {
|
|
104
|
+
return (
|
|
105
|
+
<Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>
|
|
106
|
+
<div className="h-screen w-screen bg-background flex items-center justify-center" role="status" aria-live="polite">
|
|
107
|
+
<div className="text-center">
|
|
108
|
+
<LoadingSpinner size={32} className="text-primary mx-auto mb-field" aria-hidden="true" />
|
|
109
|
+
</div>
|
|
110
|
+
</div>
|
|
111
|
+
</Surface>
|
|
112
|
+
);
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
export interface AppShellProvidersProps {
|
|
116
|
+
/** The result of `useAppShellLayout()`, computed once by the layout and shared with every outlet. */
|
|
117
|
+
layout: AppShellLayoutInfo;
|
|
118
|
+
children: React.ReactNode;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* The providers every shell region reads, and nothing else — they render no DOM of their own:
|
|
123
|
+
*
|
|
124
|
+
* - `PortalContainerContext`, holding the `<main>` element `AppShellContentOutlet` registers, so overlays opened
|
|
125
|
+
* from any region portal into the content area — or, when the layout renders `AppShellOverlayPortalLayer`, that
|
|
126
|
+
* layer instead;
|
|
127
|
+
* - `HostedComponentInteractionsProvider`, the single owner of the open state and the open hotkey of the
|
|
128
|
+
* interactive hosted components (command menu, notification center, quick switcher), which may be hosted in the
|
|
129
|
+
* menubar and the sidebar at once.
|
|
130
|
+
*/
|
|
131
|
+
export function AppShellProviders({ layout, children }: AppShellProvidersProps): React.JSX.Element {
|
|
132
|
+
const [portalContainer, setPortalContainer] = useState<HTMLElement | null>(null);
|
|
133
|
+
const [overlayLayer, setOverlayLayer] = useState<HTMLElement | null>(null);
|
|
134
|
+
const registerPortalTarget = useCallback((node: HTMLElement | null) => {
|
|
135
|
+
setPortalContainer(node);
|
|
136
|
+
}, []);
|
|
137
|
+
const registerOverlayLayer = useCallback((node: HTMLElement | null) => {
|
|
138
|
+
setOverlayLayer(node);
|
|
139
|
+
}, []);
|
|
140
|
+
return (
|
|
141
|
+
<AppShellLayoutContext.Provider value={layout}>
|
|
142
|
+
<AppShellPortalTargetContext.Provider value={registerPortalTarget}>
|
|
143
|
+
<AppShellOverlayLayerTargetContext.Provider value={registerOverlayLayer}>
|
|
144
|
+
{/* The dedicated overlay layer wins when a layout renders one; otherwise overlays stay in `<main>`. */}
|
|
145
|
+
<PortalContainerContext.Provider value={overlayLayer ?? portalContainer}>
|
|
146
|
+
<HostedComponentInteractionsProvider>{children}</HostedComponentInteractionsProvider>
|
|
147
|
+
</PortalContainerContext.Provider>
|
|
148
|
+
</AppShellOverlayLayerTargetContext.Provider>
|
|
149
|
+
</AppShellPortalTargetContext.Provider>
|
|
150
|
+
</AppShellLayoutContext.Provider>
|
|
151
|
+
);
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* A dedicated layer every overlay (dialog, sheet, menu, popover, tooltip) portals into, for a layout whose regions
|
|
156
|
+
* are TRANSFORMED — a 3D placement. Render it once, inside the providers but OUTSIDE the transformed subtree; the
|
|
157
|
+
* providers then prefer it to `<main>`. A layout that transforms nothing does not need it.
|
|
158
|
+
*
|
|
159
|
+
* It is a zero-size, untransformed box at the shell root's origin (the root fills the viewport), with NO z-index and
|
|
160
|
+
* NOT `position: fixed`: either would make it a stacking context and cap every overlay inside it below anything
|
|
161
|
+
* positioned outside the shell — a consent prompt would paint over the shell's own dialogs (the reordering #1830
|
|
162
|
+
* measured and avoided). So each overlay keeps its own global z-index. An overlay positioned `fixed` still resolves
|
|
163
|
+
* against the viewport (nothing between it and the viewport is transformed), one positioned `absolute` against the
|
|
164
|
+
* root's origin, so floating content lands where its trigger is on screen. The layout's root must be positioned.
|
|
165
|
+
*/
|
|
166
|
+
export function AppShellOverlayPortalLayer(): React.JSX.Element {
|
|
167
|
+
const register = useContext(AppShellOverlayLayerTargetContext);
|
|
168
|
+
if (!register) {
|
|
169
|
+
throw new Error('AppShellOverlayPortalLayer must be rendered inside <AppShellProviders>, which exposes it as the portal container.');
|
|
170
|
+
}
|
|
171
|
+
return <div ref={register} data-shell-overlay-layer="" className="absolute left-0 top-0 h-0 w-0" />;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Which region to render, and — for a region that sits at an edge — at which edge. The content area is not
|
|
176
|
+
* among them: it has its own outlet, because it owns `<main>` and the page.
|
|
177
|
+
*
|
|
178
|
+
* `placement` renders the region only when the application configured THAT placement. A layout that places the
|
|
179
|
+
* same region at two positions — as the default layout does for the sidebar's start and end edges — renders one
|
|
180
|
+
* outlet per edge. Omitted, the region renders at whatever placement is configured. The type admits only the
|
|
181
|
+
* placement axis the region has, so a sidebar cannot be asked for a vertical edge and render nothing.
|
|
182
|
+
*/
|
|
183
|
+
export type AppShellRegionOutletProps =
|
|
184
|
+
| { region: ShellRegion.SIDEBAR | ShellRegion.UTILITY_PANEL; placement?: HorizontalPlacement.START | HorizontalPlacement.END }
|
|
185
|
+
| { region: ShellRegion.STATUS_BAR; placement?: StatusBarPlacement }
|
|
186
|
+
| { region: ShellRegion.ACTIVITY_BAR | ShellRegion.MENUBAR | ShellRegion.TOOLBAR; placement?: never };
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* Renders one shell region's component — the registry-resolved wrapper, with its placement prop — when the
|
|
190
|
+
* application configures that region (and, if `placement` is given, at that placement). Renders nothing
|
|
191
|
+
* otherwise, so placing an outlet for every region is always safe.
|
|
192
|
+
*/
|
|
193
|
+
export function AppShellRegionOutlet(props: AppShellRegionOutletProps): React.JSX.Element | null {
|
|
194
|
+
const layout = useAppShellLayoutContext('AppShellRegionOutlet');
|
|
195
|
+
const { region, placement } = props;
|
|
196
|
+
const at = <T extends HorizontalPlacement | VerticalPlacement>(configured: T): T | null =>
|
|
197
|
+
placement === undefined || placement === configured ? configured : null;
|
|
198
|
+
|
|
199
|
+
switch (region) {
|
|
200
|
+
case ShellRegion.ACTIVITY_BAR:
|
|
201
|
+
return layout.hasActivityBar ? <ApplicationLevel_ActivityBar /> : null;
|
|
202
|
+
case ShellRegion.MENUBAR:
|
|
203
|
+
return layout.hasMenubar ? <ApplicationLevel_MenuBar /> : null;
|
|
204
|
+
case ShellRegion.TOOLBAR:
|
|
205
|
+
return layout.hasToolbar ? <ApplicationLevel_Toolbar /> : null;
|
|
206
|
+
case ShellRegion.SIDEBAR: {
|
|
207
|
+
const sidebarPlacement = at(layout.sidebarPlacement);
|
|
208
|
+
return layout.hasSidebar && sidebarPlacement ? <ApplicationLevel_Sidebar placement={sidebarPlacement} /> : null;
|
|
209
|
+
}
|
|
210
|
+
case ShellRegion.UTILITY_PANEL: {
|
|
211
|
+
const utilityPanelPlacement = at(layout.utilityPanelPlacement);
|
|
212
|
+
return layout.hasUtilityPanel && utilityPanelPlacement ? <ApplicationLevel_UtilityPanel position={utilityPanelPlacement} /> : null;
|
|
213
|
+
}
|
|
214
|
+
case ShellRegion.STATUS_BAR: {
|
|
215
|
+
const statusBarPlacement = at(layout.statusBarPlacement);
|
|
216
|
+
return layout.hasStatusBar && statusBarPlacement ? <ApplicationLevel_StatusBar placement={statusBarPlacement} /> : null;
|
|
217
|
+
}
|
|
218
|
+
default: {
|
|
219
|
+
const unhandled: never = region;
|
|
220
|
+
throw new Error(`AppShellRegionOutlet has no rendering for region "${String(unhandled)}".`);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
export interface AppShellContentOutletProps {
|
|
226
|
+
/** Classes for the `<main>` element — the layout decides how the content area sizes within its arrangement. */
|
|
227
|
+
className?: string;
|
|
228
|
+
/** The route outlet the layout container receives; rendered by the navigation zones while their stack is empty. */
|
|
229
|
+
children?: React.ReactNode;
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
/**
|
|
233
|
+
* The content area: the `<main>` landmark carrying `ShellRegion.CONTENT`, the navigation zones, and the floating
|
|
234
|
+
* quick-action button when configured. Its element is registered with `AppShellProviders` as the portal
|
|
235
|
+
* container, so it must be rendered exactly once, inside the providers.
|
|
236
|
+
*/
|
|
237
|
+
export function AppShellContentOutlet({ className, children }: AppShellContentOutletProps): React.JSX.Element {
|
|
238
|
+
const layout = useAppShellLayoutContext('AppShellContentOutlet');
|
|
239
|
+
const registerPortalTarget = useContext(AppShellPortalTargetContext);
|
|
240
|
+
return (
|
|
241
|
+
<main ref={registerPortalTarget ?? undefined} data-component-area={ShellRegion.CONTENT} className={className}>
|
|
242
|
+
<NavigationContentAreas routerChildren={children} />
|
|
243
|
+
|
|
244
|
+
{/* Floating Quick Action Button */}
|
|
245
|
+
{layout.hasQuickActionButton && <ApplicationLevel_QuickActionButton placement="floating" />}
|
|
246
|
+
</main>
|
|
247
|
+
);
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
/** The shell's overlay layer: navigation dialogs and sheets, then guidance (tours, tooltips, highlights). */
|
|
251
|
+
export function AppShellOverlaysOutlet(): React.JSX.Element {
|
|
252
|
+
return (
|
|
253
|
+
<>
|
|
254
|
+
<NavigationOverlays />
|
|
255
|
+
<GuidanceRenderer />
|
|
256
|
+
</>
|
|
257
|
+
);
|
|
258
|
+
}
|
|
259
|
+
```
|
package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Framework Shell Region Marker API
|
|
2
|
+
|
|
3
|
+
The `data-component-area` marker every shell region's root element carries. The 3D frame finds each region by it
|
|
4
|
+
and draws that region's surface behind it, so a custom region preset that drops the marker gets no surface.
|
|
5
|
+
|
|
6
|
+
Read this when the application replaces a region preset, or a region shows no frame behind it.
|
|
7
|
+
|
|
8
|
+
## Import Origins
|
|
9
|
+
|
|
10
|
+
- `@wildo-ai/presets-components-models`
|
|
11
|
+
|
|
12
|
+
## Source Excerpts
|
|
13
|
+
|
|
14
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
/**
|
|
18
|
+
* The painted REGIONS of the signed-in application shell — the value of the `data-component-area` attribute
|
|
19
|
+
* every region's ROOT element carries.
|
|
20
|
+
*
|
|
21
|
+
* This is a public contract, not decoration: it is how anything that must find the shell's regions without
|
|
22
|
+
* knowing any preset's markup does so — a browser test, guidance anchoring, and an alternative layout
|
|
23
|
+
* renderer (the optional 3D layout measures each region to draw a surface under it, #1820). A custom 2D preset
|
|
24
|
+
* package that replaces a region preset must set the same marker on its root.
|
|
25
|
+
*
|
|
26
|
+
* Placement is NOT part of the value: it travels separately as `data-placement` (a `HorizontalPlacement` or
|
|
27
|
+
* `VerticalPlacement` value), so one region is one value wherever it sits.
|
|
28
|
+
*
|
|
29
|
+
* Distinct from `ApplicationLevelComponentType`, deliberately: that vocabulary names COMPONENTS an application
|
|
30
|
+
* configures, this one names AREAS the shell paints. The two differ in both directions — the content area
|
|
31
|
+
* (`<main>`) is a region and no component, while the command menu and the hotkey layer are components that own
|
|
32
|
+
* no region. The floating quick-action button is not a region either: it overlays the content, it does not tile.
|
|
33
|
+
*
|
|
34
|
+
* Wire values are kebab-case; `menubar` predates this enum and is selected verbatim by three browser scenarios.
|
|
35
|
+
*/
|
|
36
|
+
export enum ShellRegion {
|
|
37
|
+
/** The top application bar: identity, scope switcher, command-menu trigger, user/organization menu. */
|
|
38
|
+
MENUBAR = 'menubar',
|
|
39
|
+
/** The navigation rail, full height, at the start or end edge (also its mobile drawer, marked `data-mobile-drawer`). */
|
|
40
|
+
SIDEBAR = 'sidebar',
|
|
41
|
+
/** The contextual action bar, above or below the content. */
|
|
42
|
+
TOOLBAR = 'toolbar',
|
|
43
|
+
/** The narrow icon column (or row) of top-level destinations. */
|
|
44
|
+
ACTIVITY_BAR = 'activity-bar',
|
|
45
|
+
/** The full-height column that hosts the utility panel's trigger at the start or end edge. */
|
|
46
|
+
UTILITY_PANEL = 'utility-panel',
|
|
47
|
+
/** The connection/status strip, at the top or bottom edge. */
|
|
48
|
+
STATUS_BAR = 'status-bar',
|
|
49
|
+
/** The `<main>` element: the navigation zones and the page content. */
|
|
50
|
+
CONTENT = 'content',
|
|
51
|
+
}
|
|
52
|
+
```
|