@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
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: provider-frontend-file-picker
|
|
3
3
|
description: Add or tune the frontend FILE PICKER provider — the browser-bound FrontendAppProviderModule that gives every framework file form field its accepted MIME types, size limit and selection count, and that custom views resolve for their own upload chrome. Use when the user says "add a file picker", "let users attach files", "restrict uploads to PDFs/images", "raise the upload size limit", "file field accepts anything", "picker allows too many files", or "wire a file upload provider for the app".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Frontend File-Picker Provider
|
|
@@ -79,6 +80,41 @@ contract. The file-picker `publicConfig` vocabulary the framework
|
|
|
79
80
|
reads: `acceptedMimeTypes` (string[]), `maxFileSizeMb` (number),
|
|
80
81
|
`maxSelectionCount` (number), `uploadNamespace` (string).
|
|
81
82
|
|
|
83
|
+
Declare `publicConfigSchema` with `defineFrontendPublicConfigSchema` — it is
|
|
84
|
+
MANDATORY. List every key the module's `publicConfig` carries that the
|
|
85
|
+
capability does not own (here `uploadNamespace`; the three limits come with
|
|
86
|
+
`FRONTEND_FILE_PICKER`), plus any public key the application supplies, such
|
|
87
|
+
as a vendor chooser's client id. A module without a readable schema is
|
|
88
|
+
refused at projection, at `wildo config sync` and at hydration, and every
|
|
89
|
+
value it would serve is compared against the environment's secrets. Read
|
|
90
|
+
`references/framework-frontend-public-config-api.md`.
|
|
91
|
+
|
|
92
|
+
Declare the module's `complianceProfile` in the same step — who runs the
|
|
93
|
+
software the picker touches, where it processes, and which legal entity
|
|
94
|
+
stands behind it:
|
|
95
|
+
|
|
96
|
+
| Picker shape | `complianceProfile` |
|
|
97
|
+
|---|---|
|
|
98
|
+
| Native input (the browser's own dialog, bytes stored by this application) | `deploymentModels: [SELF_HOSTED]`, `processingRegions: []` |
|
|
99
|
+
| Vendor chooser (Google Drive, OneDrive, Dropbox) | `deploymentModels: [VENDOR_HOSTED]`, the vendor's regions, `vendorLegalEntityName` |
|
|
100
|
+
|
|
101
|
+
A picker runs in the data subject's browser and a vendor chooser talks to
|
|
102
|
+
its vendor directly, so it is a recipient a privacy notice has to name. The
|
|
103
|
+
profile crosses into this service's served frontend bootstrap in the
|
|
104
|
+
generated `frontend-services.runtime-providers.generated.json`, and the
|
|
105
|
+
recipient population (processor register, privacy-notice recipients,
|
|
106
|
+
regional report) reads it from there. A picker with NO profile is reported
|
|
107
|
+
as not established, so state `SELF_HOSTED` rather than leaving it out.
|
|
108
|
+
|
|
109
|
+
Declare only capabilities a browser may host, and add module-level
|
|
110
|
+
`consentPurposes` only when the vendor's own processing goes beyond the
|
|
111
|
+
picker — a vendor chooser that also profiles people for its own purposes.
|
|
112
|
+
A picker that rests on consent does not load until the signed-in person
|
|
113
|
+
grants it; the framework file field then shows a consent-required state
|
|
114
|
+
with a grant action instead of the picker. A picker that starts workers or
|
|
115
|
+
plays media declares `csp.workerOrigins` / `csp.mediaOrigins`. Read
|
|
116
|
+
`references/framework-frontend-provider-consent-api.md`.
|
|
117
|
+
|
|
82
118
|
### Step 2: Export it through the providers barrel
|
|
83
119
|
|
|
84
120
|
`frontend/src/engine/providers/index.ts` re-exports the module; the
|
|
@@ -88,10 +124,15 @@ package's `./frontend-providers` entry exposes that barrel — the
|
|
|
88
124
|
### Step 3: Append the companion contribution
|
|
89
125
|
|
|
90
126
|
In `frontend/src/provider-contributions.ts`, append one entry to
|
|
91
|
-
`frontendProviderContributions
|
|
92
|
-
(
|
|
93
|
-
|
|
94
|
-
|
|
127
|
+
`frontendProviderContributions`, built by the engine's
|
|
128
|
+
`projectFrontendProviderContribution(module, AppFrontendType.SAAS_APP,
|
|
129
|
+
'<your-package>/frontend-providers')` from
|
|
130
|
+
`@wildo-ai/external-connectors-public/companion`, then add
|
|
131
|
+
`sourceModuleId` (the module that owns the provider semantically) —
|
|
132
|
+
see the worked example. Do not hand-write the `frontendEntry`: the
|
|
133
|
+
projection is what carries `csp`, `scripts`, the SDK descriptor, the
|
|
134
|
+
declared public-config keys, `fileStorage` and the `complianceProfile`,
|
|
135
|
+
and a literal carries only the fields it happens to name.
|
|
95
136
|
|
|
96
137
|
### Step 4: Declare the saas-config scope entry
|
|
97
138
|
|
|
@@ -108,6 +149,18 @@ Framework file fields pick the constraints up with no further wiring
|
|
|
108
149
|
precedence). A custom view resolves the module via
|
|
109
150
|
`findByProviderCapabilityAndProtocol(FRONTEND_FILE_PICKER, FRONTEND_SDK)`.
|
|
110
151
|
|
|
152
|
+
### A vendor chooser opens on the person's CONNECTION, not on its ref
|
|
153
|
+
|
|
154
|
+
A vendor chooser (OneDrive, Google Drive) opens as the signed-in person: the host asks
|
|
155
|
+
`GET /connections/<ref>/access-token` for their own short-lived token. That route answers with the grant
|
|
156
|
+
of the ref's CONNECTION. When the application declares the picker's ref as a member of a shared
|
|
157
|
+
connection (`providers.sharedConnections: { microsoft: { refs: ['microsoft-onedrive'] } }` in
|
|
158
|
+
`wildo.saas.config.ts`), the picker opens on the one Microsoft grant the person already gave — they
|
|
159
|
+
connect Microsoft once, and the connected-accounts settings screen shows ONE Microsoft row naming
|
|
160
|
+
OneDrive among the features it serves. Without that declaration the picker's ref is its own connection
|
|
161
|
+
and asks for its own consent. A `404` from the route means nothing is connected for that connection:
|
|
162
|
+
send the person to the connected-accounts screen rather than opening the chooser on nobody's files.
|
|
163
|
+
|
|
111
164
|
## Worked Example
|
|
112
165
|
|
|
113
166
|
The complete provider module — the generalized file-picker shape:
|
|
@@ -133,6 +186,24 @@ export const ApplicationFilePickerFrontendAppProvider: FrontendAppProviderModule
|
|
|
133
186
|
maxSelectionCount: 10,
|
|
134
187
|
uploadNamespace: 'task-attachments',
|
|
135
188
|
},
|
|
189
|
+
// MANDATORY (#1705): the keys this picker's publicConfig may carry, readable without running anything.
|
|
190
|
+
// The three limits above belong to the FRONTEND_FILE_PICKER capability and are admitted through it, so
|
|
191
|
+
// only this provider's own key is declared here. `wildo config sync` refuses a module without one, and
|
|
192
|
+
// compares every served value against the environment's secrets before it can reach a browser.
|
|
193
|
+
publicConfigSchema: defineFrontendPublicConfigSchema({
|
|
194
|
+
uploadNamespace: { kind: FrontendPublicConfigValueKind.STRING, description: 'Storage namespace uploads land under.' },
|
|
195
|
+
}),
|
|
196
|
+
// WHO runs it and WHERE (#1743). This picker is the browser's own file dialog: it loads no vendor
|
|
197
|
+
// SDK, and the bytes go to this application's own storage — so the operator runs everything it
|
|
198
|
+
// touches, and it is NOT a third-party recipient. Stated rather than left absent, because a
|
|
199
|
+
// frontend provider with no profile is reported as NOT ESTABLISHED by the recipient population,
|
|
200
|
+
// which reads this profile from the served frontend bootstrap. A picker that fronts a VENDOR
|
|
201
|
+
// (Drive, OneDrive, Dropbox) declares `VENDOR_HOSTED`, the vendor's regions and its legal entity.
|
|
202
|
+
complianceProfile: {
|
|
203
|
+
deploymentModels: [ProviderDeploymentModel.SELF_HOSTED],
|
|
204
|
+
// Empty is the honest answer for a self-hosted provider: the region is wherever the operator runs it.
|
|
205
|
+
processingRegions: [],
|
|
206
|
+
},
|
|
136
207
|
};
|
|
137
208
|
```
|
|
138
209
|
|
|
@@ -150,6 +221,13 @@ What earns its place:
|
|
|
150
221
|
exactly this pair.
|
|
151
222
|
- `publicConfig` carries ONLY the four picker keys — no secrets, no
|
|
152
223
|
labels, no per-field decisions.
|
|
224
|
+
- `publicConfigSchema` declares `uploadNamespace`, the one key the picker
|
|
225
|
+
capability does not own. Without it the module is refused before
|
|
226
|
+
anything is served.
|
|
227
|
+
- `complianceProfile` says `SELF_HOSTED` with no regions, because a
|
|
228
|
+
native-input picker reaches no third party. A vendor chooser says
|
|
229
|
+
`VENDOR_HOSTED` with at least one region — the schema refuses a
|
|
230
|
+
vendor-hosted profile without one.
|
|
153
231
|
|
|
154
232
|
And its companion contribution — the registration half:
|
|
155
233
|
|
|
@@ -159,19 +237,20 @@ And its companion contribution — the registration half:
|
|
|
159
237
|
```typescript
|
|
160
238
|
function buildFilePickerContribution(): ProviderCompanionContribution {
|
|
161
239
|
return {
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
240
|
+
// Projected by the ENGINE, not hand-written: `projectFrontendProviderContribution` carries every
|
|
241
|
+
// DATA field of the module across — `csp`, `scripts`, the SDK descriptor, contributed components,
|
|
242
|
+
// the declared publicConfig keys, `fileStorage` and the `complianceProfile` — to the CLI, which
|
|
243
|
+
// composes the service's Content-Security-Policy and the served bootstrap from the artifact
|
|
244
|
+
// without executing this browser-bound module. A hand-written `frontendEntry` carries whatever
|
|
245
|
+
// subset it happens to name: this one used to name four fields, so the picker's compliance
|
|
246
|
+
// profile never reached the recipient population that reads it from that bootstrap (#1743).
|
|
247
|
+
...projectFrontendProviderContribution(
|
|
248
|
+
ApplicationFilePickerFrontendAppProvider,
|
|
249
|
+
AppFrontendType.SAAS_APP,
|
|
250
|
+
FRONTEND_PROVIDERS_IMPORT_PATH,
|
|
251
|
+
),
|
|
252
|
+
// Added on top of the projection, which cannot know it: the engine's own providers belong to no
|
|
253
|
+
// application module, so the projection has nothing to attribute them to.
|
|
175
254
|
sourceModuleId: 'tasks-manager',
|
|
176
255
|
};
|
|
177
256
|
}
|
|
@@ -202,9 +281,10 @@ export const frontendProviderContributions = [
|
|
|
202
281
|
] satisfies ReadonlyArray<ProviderCompanionContribution>;
|
|
203
282
|
```
|
|
204
283
|
|
|
205
|
-
-
|
|
206
|
-
|
|
207
|
-
|
|
284
|
+
- `projectFrontendProviderContribution` reads every field FROM the
|
|
285
|
+
module object, so the contribution cannot drift from the module and
|
|
286
|
+
no data field (the CSP footprint, the compliance profile) is dropped
|
|
287
|
+
on the way into the generated artifact.
|
|
208
288
|
- `runtimeImportPath` is the app package's `./frontend-providers`
|
|
209
289
|
entry — the door the provider-runtime sync validates.
|
|
210
290
|
- The engine contributions spread (`...engineFrontendAppProviderContributions`)
|
|
@@ -217,14 +297,31 @@ export const frontendProviderContributions = [
|
|
|
217
297
|
- `references/framework-file-provider-constraints-api.md` — how
|
|
218
298
|
framework file fields resolve constraints from the provider
|
|
219
299
|
(source-backed)
|
|
300
|
+
- `references/framework-frontend-public-config-api.md` — the mandatory
|
|
301
|
+
`publicConfigSchema`, which keys are checked from where, and the secret
|
|
302
|
+
VALUE screen `wildo config sync` and the backend run over what is served
|
|
303
|
+
(source-backed)
|
|
304
|
+
- `references/framework-frontend-provider-consent-api.md` — which
|
|
305
|
+
capabilities a browser may host, provider-level consent purposes,
|
|
306
|
+
consent-gated component loading, the worker/media CSP buckets and the
|
|
307
|
+
address-lookup slot (source-backed)
|
|
308
|
+
- `references/framework-provider-component-registry-api.md` — how a
|
|
309
|
+
provider's `components` declaration reaches the application, the
|
|
310
|
+
marketing website and the documentation site: the shared registry, where a
|
|
311
|
+
component's loader comes from, the load states, and the slot each surface
|
|
312
|
+
mounts (source-backed)
|
|
220
313
|
|
|
221
314
|
## Verification
|
|
222
315
|
|
|
223
316
|
- [ ] Module lives under `frontend/src/engine/providers/` and exports a typed `FrontendAppProviderModule`
|
|
224
317
|
- [ ] Capability/protocol use the `BUILTIN_PROVIDER_*` vocabulary members, not string literals
|
|
225
318
|
- [ ] `publicConfig` holds only the picker keys — no secret, no localized string
|
|
319
|
+
- [ ] Module declares a `publicConfigSchema` (`defineFrontendPublicConfigSchema`) covering every key its `publicConfig` carries beyond the capability's own
|
|
320
|
+
- [ ] `wildo config sync` passes: no served value equals a secret in the environment's `secrets.json`
|
|
226
321
|
- [ ] Barrel + `./frontend-providers` entry expose the module
|
|
227
|
-
- [ ]
|
|
322
|
+
- [ ] Module declares `complianceProfile` (`SELF_HOSTED` for a native input, `VENDOR_HOSTED` + regions for a vendor chooser)
|
|
323
|
+
- [ ] Contribution is built by `projectFrontendProviderContribution` and names `sourceModuleId`
|
|
324
|
+
- [ ] Every declared capability is browser-hosted, and any module-level `consentPurposes` are `ConsentPurpose` members (the projection refuses otherwise)
|
|
228
325
|
- [ ] `wildo.saas.config.ts` scope entry exists for `<ref>` (reachability validation passes)
|
|
229
326
|
- [ ] A file form field without schema-level constraints shows the provider's limits
|
|
230
327
|
|
|
@@ -236,9 +333,13 @@ Run from the app root, substituting `<ref>`:
|
|
|
236
333
|
|---|---|
|
|
237
334
|
| Module declares the typed capability pair | `rg -n "FRONTEND_FILE_PICKER" frontend/src/engine/providers/` |
|
|
238
335
|
| No string-literal capability/protocol in the module | `rg -n "providerCapabilities: \['" frontend/src/engine/providers/` (must be empty) |
|
|
239
|
-
|
|
|
336
|
+
| Module states who runs it | `rg -n "complianceProfile" frontend/src/engine/providers/<ref>.frontend-app.module.ts` |
|
|
337
|
+
| Contribution is the engine projection (no hand-written entry) | `rg -n "projectFrontendProviderContribution" frontend/src/provider-contributions.ts` |
|
|
338
|
+
| No hand-written `frontendEntry` literal | `rg -n "frontendEntry: \{" frontend/src/provider-contributions.ts` (must be empty) |
|
|
240
339
|
| Scope entry present | `rg -n "<ref>" wildo.saas.config.ts` |
|
|
340
|
+
| Consent purposes use the vocabulary, not strings | `rg -n "consentPurposes: \['" frontend/src/engine/providers/` (must be empty) |
|
|
241
341
|
| No secret-looking key in publicConfig | `rg -in "secret\|apikey\|token" frontend/src/engine/providers/<ref>.frontend-app.module.ts` (must be empty) |
|
|
342
|
+
| Module declares its public-config keys | `rg -n "publicConfigSchema: defineFrontendPublicConfigSchema" frontend/src/engine/providers/<ref>.frontend-app.module.ts` |
|
|
242
343
|
|
|
243
344
|
## Common Rationalizations
|
|
244
345
|
|
|
@@ -248,14 +349,22 @@ Run from the app root, substituting `<ref>`:
|
|
|
248
349
|
| "String literals for capability/protocol are fine" | The resolver looks the module up by the exact vocabulary pair; a typo silently yields schema-only constraints with no error. |
|
|
249
350
|
| "The provider should carry the field's stricter limit" | Per-field constraints belong on the field's schema — schema metadata deliberately WINS over the provider so one strict field never loosens the app default. |
|
|
250
351
|
| "Skip the saas-config scope entry, it already works in dev" | The provider-runtime sync cross-validates contribution ↔ scope; the missing entry fails reachability validation at sync time, after you have moved on. |
|
|
352
|
+
| "A native-input picker needs no compliance profile" | A provider with no profile is reported as NOT ESTABLISHED by the recipient population, so an absent one reads as an unanswered recipient question. `SELF_HOSTED` is the answer, and it takes two lines. |
|
|
353
|
+
| "Writing the `frontendEntry` by hand is simpler than calling the projection" | A literal carries only the fields it names. That is how a compliance profile was authored on a picker and dropped before any compliance reader could see it. |
|
|
354
|
+
| "The picker only helps people upload, so its vendor needs no consent" | The capability's floor says the picker does not; a vendor whose chooser also profiles people for its own purposes must add `consentPurposes`, or it loads for everyone who declined. |
|
|
355
|
+
| "The module reads only a couple of keys, a schema is overkill" | Without a readable key list nothing can refuse a key the module never reads, so ANY key — a secret under an innocent name included — would be served to every browser. The module is refused until it declares one. |
|
|
356
|
+
| "Renaming the key gets past the secret refusal" | The refusal compares VALUES, not names: the same secret under any key is refused. Serve the vendor's public key instead, and rotate the secret if it was ever served. |
|
|
251
357
|
| "Put the display name in publicConfig" | Display text is i18n-owned: `metadata.displayNameLabelKey` + the label pipeline. A frozen string ships one language to every locale. |
|
|
252
358
|
|
|
253
359
|
## Red Flags
|
|
254
360
|
|
|
255
361
|
- A capability or protocol string literal in the module (catch with the **no string-literal** grep)
|
|
256
|
-
- The contribution
|
|
362
|
+
- The contribution hand-writes a `frontendEntry` instead of calling `projectFrontendProviderContribution` (catch with the **no hand-written `frontendEntry`** grep)
|
|
363
|
+
- A picker module with no `complianceProfile`, or a vendor chooser declaring `SELF_HOSTED` (catch with the **states who runs it** grep)
|
|
257
364
|
- A secret, publishable-key-lookalike or localized string inside `publicConfig` (catch with the **no secret-looking key** grep)
|
|
365
|
+
- A provider module with no `publicConfigSchema`, or one that omits a key its `publicConfig` carries (catch with the **declares its public-config keys** grep)
|
|
258
366
|
- An upload surface with its own hardcoded MIME/size table beside the provider
|
|
367
|
+
- A surface that renders nothing when `useProviderComponent` reports `CONSENT_REQUIRED` (catch with the consent-purposes grep above, then check the surface's `renderConsentRequired`)
|
|
259
368
|
- `maxFileSizeMb` treated as bytes somewhere — the resolver converts Mb → bytes; consumers must not convert again
|
|
260
369
|
|
|
261
370
|
## Related Skills
|
|
@@ -0,0 +1,399 @@
|
|
|
1
|
+
# Consent, CSP buckets and the address-lookup slot — what a frontend provider module must declare
|
|
2
|
+
|
|
3
|
+
Read this when a frontend provider module:
|
|
4
|
+
|
|
5
|
+
- declares a capability, and you need to know whether a browser may host it at all;
|
|
6
|
+
- belongs to a vendor whose own processing goes beyond the service the person asked for;
|
|
7
|
+
- contributes a component, and you need to know when that component is allowed to load;
|
|
8
|
+
- starts a web worker or plays audio or video;
|
|
9
|
+
- is an address lookup (`FRONTEND_ADDRESS_LOOKUP`).
|
|
10
|
+
|
|
11
|
+
## Every capability is classified, and a browser may host only some
|
|
12
|
+
|
|
13
|
+
Each provider capability is classified for the browser in one table, total over the whole vocabulary.
|
|
14
|
+
A frontend module may declare only a capability classified `browserHosted: true`; a server-only
|
|
15
|
+
capability (`LLM_CHAT`, `EMAIL_TRANSACTIONAL`, …) on a frontend module is refused when the contribution
|
|
16
|
+
is projected, and a provider that reaches a browser with one anyway never starts. The table also gives
|
|
17
|
+
each hosted capability its consent FLOOR — only `FRONTEND_PRODUCT_ANALYTICS` rests on consent
|
|
18
|
+
(`ANALYTICS`); `SSO_OAUTH2` is hosted without consent (browser sign-in code, such as a vendor's one-tap
|
|
19
|
+
SDK), and `BILLING` is server-only.
|
|
20
|
+
|
|
21
|
+
A frontend module exists for code that RUNS in the page. Do not declare one to give a provider a
|
|
22
|
+
display name: the name is `providers.<ref>.displayName`, generated for every declared provider ref, and
|
|
23
|
+
the sign-in buttons, the identity-links page and the billing components resolve it from the ref they
|
|
24
|
+
already hold (`auth.socialOAuth2Providers`, `billing.providerRef`). Redirect-based sign-in and hosted
|
|
25
|
+
checkout run no vendor code in the browser, so they have no frontend module. A browser-hosted capability
|
|
26
|
+
fills an engine slot only when that slot's work happens on the page (error monitoring, product
|
|
27
|
+
analytics); one that maps to a backend slot is refused when projected.
|
|
28
|
+
|
|
29
|
+
## Import Origins
|
|
30
|
+
|
|
31
|
+
- `@wildo-ai/external-connectors-public`
|
|
32
|
+
|
|
33
|
+
## Source Excerpts
|
|
34
|
+
|
|
35
|
+
### Origin Package: `@wildo-ai/external-connectors-public`
|
|
36
|
+
|
|
37
|
+
```typescript
|
|
38
|
+
/**
|
|
39
|
+
* The consent classification of EVERY provider capability — total over the vocabulary, so a capability
|
|
40
|
+
* added tomorrow does not compile until it is classified here (#1702).
|
|
41
|
+
*
|
|
42
|
+
* A frontend provider module may declare only capabilities classified `browserHosted: true`; it rests on
|
|
43
|
+
* the union of their `consentPurposes` and its own module-level `consentPurposes`.
|
|
44
|
+
*/
|
|
45
|
+
export const PROVIDER_CAPABILITY_FRONTEND_CONSENT_CLASSIFICATION = Object.freeze({
|
|
46
|
+
// Browser-hosted, consent-based: measuring how the service is used.
|
|
47
|
+
FRONTEND_PRODUCT_ANALYTICS: Object.freeze({ browserHosted: true, consentPurposes: Object.freeze([ConsentPurpose.ANALYTICS]) }),
|
|
48
|
+
// Browser-hosted, no consent at the floor: each delivers or protects a service the person asked for.
|
|
49
|
+
FRONTEND_ERROR_MONITORING: HOSTED_WITHOUT_CONSENT,
|
|
50
|
+
FRONTEND_CAPTCHA: HOSTED_WITHOUT_CONSENT,
|
|
51
|
+
FRONTEND_SEARCH: HOSTED_WITHOUT_CONSENT,
|
|
52
|
+
FRONTEND_FILE_PICKER: HOSTED_WITHOUT_CONSENT,
|
|
53
|
+
FRONTEND_ADDRESS_LOOKUP: HOSTED_WITHOUT_CONSENT,
|
|
54
|
+
// Browser sign-in code (a vendor's one-tap or button SDK). The person asked to sign in; that is not
|
|
55
|
+
// consent-based processing. No engine module declares it today: the redirect-based sign-in the engine
|
|
56
|
+
// ships runs no vendor code on the page, and its button labels come from the ref (#1701).
|
|
57
|
+
SSO_OAUTH2: HOSTED_WITHOUT_CONSENT,
|
|
58
|
+
// Server-side only. A frontend module declaring any of these is refused.
|
|
59
|
+
// BILLING is the backend billing slot (subscriptions, checkout sessions, the portal link, webhooks).
|
|
60
|
+
// Checkout and the customer portal are hosted redirects, so no billing code runs in the browser; a
|
|
61
|
+
// frontend module declaring it used to FILL the engine's billing slot from the browser (#1701). An
|
|
62
|
+
// embedded payment UI would be its own browser capability, decided in #1741.
|
|
63
|
+
BILLING: SERVER_ONLY,
|
|
64
|
+
EMAIL_TRANSACTIONAL: SERVER_ONLY,
|
|
65
|
+
EMAIL_MARKETING: SERVER_ONLY,
|
|
66
|
+
EMAIL_INBOUND: SERVER_ONLY,
|
|
67
|
+
SMS: SERVER_ONLY,
|
|
68
|
+
SSO_SAML: SERVER_ONLY,
|
|
69
|
+
LLM_CHAT: SERVER_ONLY,
|
|
70
|
+
LLM_EMBEDDINGS: SERVER_ONLY,
|
|
71
|
+
DOCUMENT_TEXT_EXTRACTION: SERVER_ONLY,
|
|
72
|
+
CODING_AGENT: SERVER_ONLY,
|
|
73
|
+
IMAGE_GENERATION: SERVER_ONLY,
|
|
74
|
+
LLM_OBSERVABILITY: SERVER_ONLY,
|
|
75
|
+
OBSERVABILITY_TELEMETRY: SERVER_ONLY,
|
|
76
|
+
COMPLIANCE_AUDIT_TRAIL: SERVER_ONLY,
|
|
77
|
+
} as const satisfies Readonly<Record<ProviderCapability, FrontendCapabilityConsentClassification>>);
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## A consent-based provider must be stoppable
|
|
81
|
+
|
|
82
|
+
Consent can be withdrawn at any moment, and a withdrawal must stop what the grant started, in the same
|
|
83
|
+
page. So a provider that rests on ANY purpose — from its capability or its own `consentPurposes` — must:
|
|
84
|
+
|
|
85
|
+
- ship as an `sdk`, never as `scripts`. An injected `<script>` cannot be stopped (removing the element
|
|
86
|
+
undoes nothing it already ran), so a consent-based module declaring `scripts` is refused when its
|
|
87
|
+
contribution is projected, withheld at hydration, and its scripts are never injected. A vendor that ships
|
|
88
|
+
as a script loads it from inside `sdk.activate`, where it can also stop it;
|
|
89
|
+
- declare `sdk.stoppable: true`, and return a `deactivate` from `activate` that fully stops the vendor and
|
|
90
|
+
removes what it stored in the page's own storage. Check what the vendor's teardown really clears: PostHog's
|
|
91
|
+
`reset(true)` alone writes a FRESH distinct id and device id back, so the engine's PostHog module starts it
|
|
92
|
+
with `opt_out_persistence_by_default: true` and then `opt_out_capturing()` removes its localStorage entry
|
|
93
|
+
and cookie. What a vendor stored in cookies of its OWN domain cannot be cleared by the page, which is one
|
|
94
|
+
more reason it starts only on consent. Without the declaration the provider never starts; with it and no
|
|
95
|
+
`deactivate`, the runner reports a broken promise.
|
|
96
|
+
|
|
97
|
+
A provider that rests on no purpose (error monitoring, a file picker) is not held to this: nothing can be
|
|
98
|
+
withdrawn from it.
|
|
99
|
+
|
|
100
|
+
## The application starts it on the signed-in person's grant
|
|
101
|
+
|
|
102
|
+
The application's startup activation runs before anyone is known, so it starts only providers that rest
|
|
103
|
+
on no purpose. The consent-based ones are started by `ConsentBasedProviderSdksProvider`, mounted by the
|
|
104
|
+
framework beside analytics: it reads the person's `privacy.consentedPurposes` from their preferences,
|
|
105
|
+
starts the consent-based providers once the purposes they rest on are granted, and calls their `deactivate`
|
|
106
|
+
on withdrawal and on sign-out (which publishes `privacy: null`). A change to the granted subset of those
|
|
107
|
+
purposes restarts all of them, one start only after the previous stop has finished. Pre-authentication pages start none. The consent decision itself is the audited preference
|
|
108
|
+
write; starting and stopping a provider records nothing more.
|
|
109
|
+
|
|
110
|
+
A `FRONTEND_PRODUCT_ANALYTICS` provider's activation returns a `FrontendProductAnalyticsSink`
|
|
111
|
+
(`track`, `page`, `identify`, `reset`). `useAnalytics().track()` and the framework's own
|
|
112
|
+
auto-instrumentation dispatch to every running sink, behind the `analytics.enabled` master switch. Each
|
|
113
|
+
running sink is identified with the framework's opaque user id of the identity analytics already holds, and
|
|
114
|
+
reset when that identity leaves. That is
|
|
115
|
+
the only way a vendor receives the application's analytics: declare the vendor's frontend module in the
|
|
116
|
+
application's frontend scope (the engine ships `posthog` for the app tier); there is no second provider
|
|
117
|
+
list inside analytics.
|
|
118
|
+
|
|
119
|
+
## Import Origins
|
|
120
|
+
|
|
121
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
122
|
+
|
|
123
|
+
## Source Excerpts
|
|
124
|
+
|
|
125
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
126
|
+
|
|
127
|
+
```tsx
|
|
128
|
+
/**
|
|
129
|
+
* The consent-based providers currently RUNNING on the application, in registry order (#1704).
|
|
130
|
+
*
|
|
131
|
+
* Empty until the signed-in person grants the purposes a provider rests on, and emptied again on withdrawal or
|
|
132
|
+
* sign-out — immediately, before the providers' `deactivate` has finished. A consumer that dispatches to a
|
|
133
|
+
* provider (`AnalyticsContext` does, for `FRONTEND_PRODUCT_ANALYTICS`) reads this and never holds a handle past it.
|
|
134
|
+
*/
|
|
135
|
+
export function useConsentBasedProviderActivations(): ReadonlyArray<ConsentBasedProviderActivation> {
|
|
136
|
+
return useContext(ConsentBasedProviderActivationsContext);
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
## A vendor may ADD consent purposes, never remove them
|
|
141
|
+
|
|
142
|
+
Declare `consentPurposes` on the module when the vendor does more than its capability's floor — a
|
|
143
|
+
captcha whose vendor also analyses visitors for its own purposes is the case this exists for. The
|
|
144
|
+
provider then rests on the union of these and the floor, so declaring `consentPurposes: []` on an
|
|
145
|
+
analytics provider changes nothing. A value outside `ConsentPurpose` is refused at projection; do not
|
|
146
|
+
invent a purpose, adding one is a product decision with legal weight.
|
|
147
|
+
|
|
148
|
+
The purposes gate EVERYTHING of that provider on every surface: its SDK is not activated and its
|
|
149
|
+
components are not downloaded until the person has granted them. It declares no `<script>` tags at all —
|
|
150
|
+
see "A consent-based provider must be stoppable" above.
|
|
151
|
+
|
|
152
|
+
## Loading a component is consent-gated
|
|
153
|
+
|
|
154
|
+
`useProviderComponent` asks the registry before downloading anything. A provider resting on a purpose the
|
|
155
|
+
signed-in person has not granted reports `ProviderComponentStatus.CONSENT_REQUIRED` with the
|
|
156
|
+
`missingConsentPurposes`, and a surface must render a consent-required state there — announced, with a
|
|
157
|
+
keyboard-reachable action that grants exactly those purposes — never a blank. `ProviderFilePickerHost`
|
|
158
|
+
does this for the file picker; pass `renderConsentRequired` to word it in your own chrome. Granting goes
|
|
159
|
+
through the person's audited preference write, and the component loads without a re-mount.
|
|
160
|
+
|
|
161
|
+
## Worker and media origins
|
|
162
|
+
|
|
163
|
+
A provider that starts a web worker declares `csp.workerOrigins` (a `blob:` scheme source is allowed);
|
|
164
|
+
one that plays audio or video declares `csp.mediaOrigins`. Both compose into the service's
|
|
165
|
+
`worker-src` / `media-src` like every other bucket. When the application's policy does not state that
|
|
166
|
+
directive, the framework seeds it from the directive it was falling back to, so declaring
|
|
167
|
+
`workerOrigins: ['blob:']` never revokes the page's own `'self'` workers.
|
|
168
|
+
|
|
169
|
+
## The address-lookup slot
|
|
170
|
+
|
|
171
|
+
Enabling a lookup (Google Places) and writing one for another vendor are taught by `provider-address-lookup`: a
|
|
172
|
+
lookup reaches its vendor only through the application backend, and needs no consent at the capability floor. What
|
|
173
|
+
follows is the slot contract itself.
|
|
174
|
+
|
|
175
|
+
An address-lookup component returns a `ProviderAddressLookupSelection`: the structured `z_address()`
|
|
176
|
+
value, plus the vendor's place id only if its component descriptor declares `placeIdRetention: TRANSIENT`
|
|
177
|
+
(usable for the interaction). A place id is never stored, whatever the vendor's terms allow: the field keeps
|
|
178
|
+
only the address. An undeclared retention means the component returns no place id, and a selection carrying
|
|
179
|
+
one is refused by `receiveProviderAddressLookupSelection`.
|
|
180
|
+
|
|
181
|
+
## Import Origins
|
|
182
|
+
|
|
183
|
+
- `@wildo-ai/saas-models`
|
|
184
|
+
|
|
185
|
+
## Source Excerpts
|
|
186
|
+
|
|
187
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
188
|
+
|
|
189
|
+
```typescript
|
|
190
|
+
/**
|
|
191
|
+
* What an address lookup hands back for ONE chosen place.
|
|
192
|
+
*
|
|
193
|
+
* `address` is the application's own value: the person chose it, and it is stored exactly as a typed
|
|
194
|
+
* address would be. `placeId` is the VENDOR's key for the place, present only when the component's
|
|
195
|
+
* declared `placeIdRetention` allows one; the framework refuses a selection that carries a place id its
|
|
196
|
+
* component declared it never returns, and never stores one (#561 D3).
|
|
197
|
+
*/
|
|
198
|
+
export interface ProviderAddressLookupSelection {
|
|
199
|
+
readonly address: AddressValue;
|
|
200
|
+
/** The vendor's identifier for the matched place. Opaque, usable for this interaction only, and never stored. */
|
|
201
|
+
readonly placeId?: string;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
/**
|
|
205
|
+
* The props every `FRONTEND_ADDRESS_LOOKUP` component receives.
|
|
206
|
+
*
|
|
207
|
+
* Deliberately narrow. The component suggests and resolves; the FIELD owns the value, its validation
|
|
208
|
+
* (`z_address()` with its `countriesAllowed`) and its persistence. That split is what lets an address
|
|
209
|
+
* field work with no lookup at all, which is why the capability fills no engine slot.
|
|
210
|
+
*
|
|
211
|
+
* ## The vendor is reached through `suggest` and `retrieve`, never directly (#561 D2)
|
|
212
|
+
*
|
|
213
|
+
* The framework's host binds both to the operations the component's descriptor declares
|
|
214
|
+
* (`addressLookup.suggestOperationId` / `retrieveOperationId`) and runs them through the application
|
|
215
|
+
* backend's provider-operation door. The host also writes the vendor session token into each input when the
|
|
216
|
+
* descriptor names `sessionTokenInput` (#561 D4) — a component never generates, holds or rotates one. Each
|
|
217
|
+
* resolves to the operation's parsed output, and rejects with the door's error (a refusal, a throttle, a
|
|
218
|
+
* vendor timeout); a component reports that through `onError` and the field stays usable by hand.
|
|
219
|
+
*/
|
|
220
|
+
export interface ProviderAddressLookupProps {
|
|
221
|
+
/** The provider's own `ref`. */
|
|
222
|
+
readonly providerRef: string;
|
|
223
|
+
/** The provider's public configuration, already validated against its `publicConfigSchema` when it declares one. */
|
|
224
|
+
readonly publicConfig: Readonly<Record<string, unknown>>;
|
|
225
|
+
/**
|
|
226
|
+
* ISO 3166-1 alpha-2 codes the field accepts (`z_address({ countriesAllowed })`). A component should
|
|
227
|
+
* restrict its suggestions to them; the field still validates whatever comes back.
|
|
228
|
+
*/
|
|
229
|
+
readonly countriesAllowed?: readonly string[];
|
|
230
|
+
/** The field's default country, a hint for ranking suggestions. */
|
|
231
|
+
readonly defaultCountry?: string;
|
|
232
|
+
/** The person's language (BCP 47), so suggestions and the retrieved address are spelled in it where the vendor can. */
|
|
233
|
+
readonly languageCode: string;
|
|
234
|
+
/** True while the field is disabled or read-only: the component offers no search then. */
|
|
235
|
+
readonly disabled: boolean;
|
|
236
|
+
/**
|
|
237
|
+
* The search control's form NAME. The host renders the control's visible label (from the application's
|
|
238
|
+
* labels) for the element whose id is `field-<name>` — the id every engine form control takes — so the
|
|
239
|
+
* component puts that id on its focusable control and invents no label text of its own.
|
|
240
|
+
*/
|
|
241
|
+
readonly name: string;
|
|
242
|
+
/**
|
|
243
|
+
* The vendor's required attribution (#561 D4), from the descriptor's `attributionMark`, or absent when the vendor
|
|
244
|
+
* requires none. `mark` is the vendor's text, verbatim; `accessibleLabel` is a sentence from the application's
|
|
245
|
+
* labels naming it, for assistive technology.
|
|
246
|
+
*
|
|
247
|
+
* The component shows it INSIDE the container that shows its suggestions, whenever suggestions are shown — the
|
|
248
|
+
* placement Google requires ("within the same visual container" as the content). Render it with
|
|
249
|
+
* `ProviderAddressLookupAttribution` (`@wildo-ai/saas-frontend-lib`), which applies the vendor's text rules
|
|
250
|
+
* (untranslated, on one line, in a permitted colour); the framework's own lookup combobox does.
|
|
251
|
+
* spec-cite: https://developers.google.com/maps/documentation/places/web-service/policies — text attribution rules,
|
|
252
|
+
* fetched 2026-09-29.
|
|
253
|
+
*/
|
|
254
|
+
readonly attribution?: ProviderAddressLookupAttributionText;
|
|
255
|
+
/** Run the declared SUGGEST operation with this input. */
|
|
256
|
+
suggest(input: Readonly<Record<string, unknown>>): Promise<unknown>;
|
|
257
|
+
/** Run the declared RETRIEVE operation with this input. Ends the vendor session, whatever it answers. */
|
|
258
|
+
retrieve(input: Readonly<Record<string, unknown>>): Promise<unknown>;
|
|
259
|
+
/** The person chose a place. Called at most once per interaction. */
|
|
260
|
+
onSelect(selection: ProviderAddressLookupSelection): void;
|
|
261
|
+
/** The person dismissed the lookup without choosing. Ends the vendor session. */
|
|
262
|
+
onCancel(): void;
|
|
263
|
+
/**
|
|
264
|
+
* The lookup could not run — the door refused it, the vendor timed out or answered a shape the adapter
|
|
265
|
+
* cannot read. Reported rather than thrown, for the reason the file-picker contract gives: a throw inside
|
|
266
|
+
* a component's own event handler reaches no React error boundary.
|
|
267
|
+
*/
|
|
268
|
+
onError(error: Error): void;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
/** A vendor's required attribution, as the host hands it to a lookup component. */
|
|
272
|
+
export interface ProviderAddressLookupAttributionText {
|
|
273
|
+
/** The vendor's own attribution text, never translated or restyled ("Google Maps"). */
|
|
274
|
+
readonly mark: string;
|
|
275
|
+
/** A sentence from the application's labels that names the mark, for assistive technology. */
|
|
276
|
+
readonly accessibleLabel: string;
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
/** One suggestion, as a person reads it. Vendor text, never derived by the framework. */
|
|
280
|
+
export interface ProviderAddressLookupSuggestion {
|
|
281
|
+
/** The vendor's handle for the suggestion, passed back to `buildRetrieveInput`. Opaque; never stored. */
|
|
282
|
+
readonly id: string;
|
|
283
|
+
/** The line a person recognises the place by (the street address). */
|
|
284
|
+
readonly primaryText: string;
|
|
285
|
+
/** The line that disambiguates it (town, region, country), when the vendor gives one. */
|
|
286
|
+
readonly secondaryText?: string;
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
/**
|
|
290
|
+
* Everything VENDOR-SPECIFIC about an address lookup, as four pure functions: how a query becomes the
|
|
291
|
+
* suggest operation's input, how its answer becomes suggestions, how a chosen suggestion becomes the retrieve
|
|
292
|
+
* operation's input, and how that answer becomes the framework's `AddressValue`.
|
|
293
|
+
*
|
|
294
|
+
* With it, the framework's own combobox (`ProviderAddressLookupCombobox` in `@wildo-ai/saas-frontend-lib`)
|
|
295
|
+
* is a complete lookup component: the keyboard pattern, the debounce, the minimum query length, stale-answer
|
|
296
|
+
* handling and the manual-entry fallback are written once rather than once per vendor. A provider whose
|
|
297
|
+
* lookup needs its own UI implements `ProviderAddressLookupProps` directly instead.
|
|
298
|
+
*
|
|
299
|
+
* `readAddress` returns TEXT parts only: a vendor geocode is never taken (#561 D3). A stored coordinate has no
|
|
300
|
+
* expiry, while a lookup's geocode is at best storable for a limited time (Google: 30 days) or not at all (Mapbox
|
|
301
|
+
* Search Box) — #561's 2026-09-14 reading of both vendors' terms — and nothing runs the vendor's clock. The
|
|
302
|
+
* field drops coordinates anyway.
|
|
303
|
+
*/
|
|
304
|
+
export interface ProviderAddressLookupAdapter {
|
|
305
|
+
buildSuggestInput(request: {
|
|
306
|
+
readonly query: string;
|
|
307
|
+
readonly countriesAllowed?: readonly string[];
|
|
308
|
+
readonly defaultCountry?: string;
|
|
309
|
+
readonly languageCode: string;
|
|
310
|
+
}): Record<string, unknown>;
|
|
311
|
+
/** Never throws on a well-formed but empty answer; returns `[]`. Throws only on an answer it cannot read. */
|
|
312
|
+
readSuggestions(output: unknown): readonly ProviderAddressLookupSuggestion[];
|
|
313
|
+
buildRetrieveInput(request: { readonly suggestion: ProviderAddressLookupSuggestion; readonly languageCode: string }): Record<string, unknown>;
|
|
314
|
+
/** `undefined` when the vendor answered with no postal address for the place (a place with no street address). */
|
|
315
|
+
readAddress(output: unknown): AddressValue | undefined;
|
|
316
|
+
}
|
|
317
|
+
```
|
|
318
|
+
|
|
319
|
+
The FIELD a lookup fills is `FormFieldAddress`, which every `z_address()` field renders. It depends on no
|
|
320
|
+
provider: its `renderLookup` slot hands whatever renders there an `AddressFieldLookupHost` — the field's
|
|
321
|
+
accepted countries, its default country, whether it is editable, and `applyAddress`. A lookup validates
|
|
322
|
+
the selection (`receiveProviderAddressLookupSelection` with the field's schema), then calls `applyAddress`,
|
|
323
|
+
which replaces every text part and the country as if the person had typed the chosen address, and leaves
|
|
324
|
+
them editable. It always clears the coordinates, including any the lookup passes: a vendor geocode is at
|
|
325
|
+
best storable for a limited time, while a stored address geocode never expires, so it is never filled from
|
|
326
|
+
a lookup. Do not fill the address's coordinates from a vendor response by any other route either.
|
|
327
|
+
|
|
328
|
+
## Import Origins
|
|
329
|
+
|
|
330
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
331
|
+
|
|
332
|
+
## Source Excerpts
|
|
333
|
+
|
|
334
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
335
|
+
|
|
336
|
+
```tsx
|
|
337
|
+
/**
|
|
338
|
+
* Props of `FormFieldAddress` (`@wildo-ai/saas-frontend-lib`), the control the framework renders for every
|
|
339
|
+
* field declared with `z_address()`. Forms dispatch to it automatically; an application passes these
|
|
340
|
+
* props itself only when it renders the control directly or fills its lookup slot.
|
|
341
|
+
*/
|
|
342
|
+
export interface FormFieldAddressProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
|
|
343
|
+
value?: AddressValue;
|
|
344
|
+
/**
|
|
345
|
+
* `undefined` is emitted when the user empties every part of a clearable field — the control's
|
|
346
|
+
* "no address" gesture. A pre-selected country alone is not an entry and does not count.
|
|
347
|
+
*/
|
|
348
|
+
onChange?: (value: AddressValue | undefined) => void;
|
|
349
|
+
defaultValue?: AddressValue;
|
|
350
|
+
/**
|
|
351
|
+
* The resolved, displayable error of each part that has one, keyed by the part's dotted path inside
|
|
352
|
+
* the value (`city`, `coordinates.longitude` — see `listAddressPartPaths`). Resolved by the form,
|
|
353
|
+
* which owns touch/submit visibility; the control only places each message under its input.
|
|
354
|
+
*/
|
|
355
|
+
partErrors?: Readonly<Record<string, string | undefined>>;
|
|
356
|
+
/**
|
|
357
|
+
* Renders an address LOOKUP (a vendor autocomplete) above the parts. Omitted, the field is the plain
|
|
358
|
+
* multi-part control, and it stays fully usable by hand when a lookup is refused or fails. The field
|
|
359
|
+
* decides nothing about which lookup this is and imports no provider code: whoever fills the slot
|
|
360
|
+
* resolves the provider, its consent and its errors, and fills the field through
|
|
361
|
+
* {@link AddressFieldLookupHost.applyAddress}.
|
|
362
|
+
*/
|
|
363
|
+
renderLookup?: (host: AddressFieldLookupHost) => React.ReactNode;
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
/**
|
|
367
|
+
* What an address field hands to the lookup rendered in its `renderLookup` slot.
|
|
368
|
+
*
|
|
369
|
+
* Deliberately provider-free: every member is the FIELD's own knowledge (its `z_address()` options and
|
|
370
|
+
* its editability) plus one way to fill it. A vendor lookup narrows its suggestions to
|
|
371
|
+
* `countriesAllowed`, ranks by `defaultCountry`, and calls `applyAddress` with the place the person chose.
|
|
372
|
+
*/
|
|
373
|
+
export interface AddressFieldLookupHost {
|
|
374
|
+
/** ISO 3166-1 alpha-2 codes the field accepts, from `z_address({ countriesAllowed })`. Absent means any; never empty. */
|
|
375
|
+
readonly countriesAllowed?: readonly string[];
|
|
376
|
+
/** The field's default country, from `z_address({ defaultCountry })` — a ranking hint for suggestions. */
|
|
377
|
+
readonly defaultCountry?: string;
|
|
378
|
+
/** True while the field is disabled or read-only. A lookup must not offer to fill it then; `applyAddress` ignores the call. */
|
|
379
|
+
readonly disabled: boolean;
|
|
380
|
+
/**
|
|
381
|
+
* Replace every TEXT part and the country with the chosen address, as though the person had typed
|
|
382
|
+
* it, and emit the value.
|
|
383
|
+
*
|
|
384
|
+
* Every text part is replaced, including the ones the chosen address omits: a `line2` left over from
|
|
385
|
+
* the previous address describes a different place, so keeping it would compose an address that exists
|
|
386
|
+
* nowhere.
|
|
387
|
+
*
|
|
388
|
+
* Coordinates are ALWAYS cleared, whatever `address` carries. The previous geocode describes the previous
|
|
389
|
+
* place, and a lookup's geocode is never stored: vendors' terms either forbid storing it or allow it for a
|
|
390
|
+
* limited time, while a stored `coordinates` has no expiry, so nothing would ever delete it on the
|
|
391
|
+
* vendor's clock. The person can still enter coordinates by hand where the field offers them.
|
|
392
|
+
*
|
|
393
|
+
* The value is NOT validated here: it goes through the same form validation as a typed address, so a
|
|
394
|
+
* country outside `countriesAllowed` shows the same error under the country part. A caller that wants to
|
|
395
|
+
* refuse such a value before it reaches the field (the provider path does) validates it first.
|
|
396
|
+
*/
|
|
397
|
+
applyAddress(address: AddressValue): void;
|
|
398
|
+
}
|
|
399
|
+
```
|