@wildo-ai/framework-knowledge 1.1.9 → 1.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
- 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 +543 -80
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
- 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 +138 -21
- 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.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/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.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +17 -9
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -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 +89 -9
- 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 +6 -5
- 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 +6 -4
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- 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 +8 -4
- 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 +28 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -5
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +14 -6
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +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-conception/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
- 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 +34 -7
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -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 +14 -6
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
- 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 +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- 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 +15 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +497 -32
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-maturity.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-choice.config.md +20 -3
- package/dist/knowledge/references/brand.name-screening.config.md +58 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
- package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +76 -7
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/integration-plan.config.md +21 -1
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +107 -2
- package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
- package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
- package/dist/knowledge/references/platform.config.saas.md +106 -14
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +84 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
- package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
- package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
- package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
- package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
- package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +270 -0
- package/dist/knowledge/references/website-plan.config.md +561 -23
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
- package/dist/knowledge/references/zod.factories.code.md +18 -8
- package/dist/knowledge/references/zod.factories.duration.md +23 -13
- package/dist/knowledge/references/zod.factories.money.md +24 -14
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +2854 -246
- package/dist/knowledge/registries/playbooks.json +57 -36
- package/dist/knowledge/registries/source-tags.json +8863 -4569
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +63 -34
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
- package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
- package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
- package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17305 -8263
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
|
@@ -1,20 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: website-navigation-authoring
|
|
3
|
-
description: Author
|
|
3
|
+
description: Author the website's navigation — the declared site menu (`defineWebsiteMenu` in `website/src/site-menu.ts`) rendered by the engine's `WebsiteSiteHeader` (desktop panels, mobile drawer, sticky header) and `WebsiteSiteFooterMenu` — and the site's header and footer components. Use when the user says "add a menu item", "add a Products / Solutions mega menu", "wire site navigation", "add a sign-in button to the header", "make the header sticky / hide on scroll", "configure footer columns", or "swap the header on a campaign page".
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# Website Navigation Authoring (
|
|
8
|
-
|
|
9
|
-
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no concrete
|
|
10
|
-
> `HeaderSection` / `FooterSection`**. The framework ships **slot
|
|
11
|
-
> machinery only** — `WebsiteRootConfig.navigation.headerComponent` /
|
|
12
|
-
> `.footerComponent` typed `ComponentType<unknown>` slots, the
|
|
13
|
-
> `WebsiteRuntimeContextValue.navigation` carrier, and
|
|
14
|
-
> `WebsitePageLayout`'s deterministic resolution rules
|
|
15
|
-
> (per-page override → runtime fallback → explicit `null` to suppress).
|
|
16
|
-
> This skill documents the consumer-side authoring pattern that fills
|
|
17
|
-
> those slots.
|
|
7
|
+
# Website Navigation Authoring (menu, header, footer)
|
|
18
8
|
|
|
19
9
|
### Target Application Framing
|
|
20
10
|
|
|
@@ -30,400 +20,305 @@ Read and apply these patterns from the application-developer point of view:
|
|
|
30
20
|
|
|
31
21
|
## Overview
|
|
32
22
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
second `<header>`. A nested `<header>` puts a banner inside the
|
|
53
|
-
banner and gives the page two of them — three accessibility
|
|
54
|
-
violations at once, and a screen reader lists the site header twice.
|
|
55
|
-
The same holds for the footer and `<footer>`.
|
|
56
|
-
|
|
57
|
-
The framework decision (D19) is that navigation lives on
|
|
58
|
-
`WebsiteRuntimeContextValue` (alongside `locale`, `labelPack`,
|
|
59
|
-
`designTokens`) rather than in a separate `WebsiteNavigationContext`,
|
|
60
|
-
because `WebsitePageLayout` already reads runtime state and a second
|
|
61
|
-
context for two component refs would split the host adapter's wiring
|
|
62
|
-
surface without buying isolation.
|
|
23
|
+
The site's navigation is **declared, not hand-built**. One `defineWebsiteMenu({...})` in
|
|
24
|
+
`website/src/site-menu.ts` is the site's information architecture as data; the engine renders it:
|
|
25
|
+
|
|
26
|
+
- `WebsiteSiteHeader` — the header: the brand, the menu (direct links, and panels that open on click, Enter or
|
|
27
|
+
a short hover rest, one at a time, closing on Escape or a click outside), the header actions, a mobile drawer
|
|
28
|
+
with each panel as an accordion, the current page marked, and sticky / auto-hide / static scrolling. Panels and
|
|
29
|
+
the drawer are native disclosures, so they work before the page hydrates. When the site publishes two or more
|
|
30
|
+
locales, the bar also carries a language switcher (and the drawer a language list), each language linking to the
|
|
31
|
+
same page in that language.
|
|
32
|
+
- `WebsiteSiteFooterMenu` — the same menu as footer columns, so the footer cannot drift from the header.
|
|
33
|
+
- `WebsitePublicDocumentLinks` — the footer's legal links: the application's privacy notice and terms, each at the
|
|
34
|
+
page the APPLICATION serves it on, on its origin, plus the legal notice (imprint) when the operator is established in
|
|
35
|
+
the EU, the EEA, the UK or Switzerland. The site has no legal pages of its own.
|
|
36
|
+
- `WEBSITE_ROOT_CONFIG.menu` — the same object, so the build refuses a menu link to a route no page mounts and
|
|
37
|
+
demands every menu label in every locale pack, at keys DERIVED from the menu's refs. Nobody lists a menu key by
|
|
38
|
+
hand.
|
|
39
|
+
|
|
40
|
+
The application owns what the menu SAYS (entries, words, icons) and the header's brand; the engine owns how it
|
|
41
|
+
BEHAVES and its accessibility. Restyle it from `website.css`; never fork it.
|
|
63
42
|
|
|
64
43
|
## App Paths
|
|
65
44
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
|
73
|
-
|
|
|
74
|
-
|
|
45
|
+
| Surface | Application-relative location |
|
|
46
|
+
|---|---|
|
|
47
|
+
| The menu (entries + actions) | `website/src/site-menu.ts` |
|
|
48
|
+
| The header component (brand + `WebsiteSiteHeader`) | `website/src/components/HeaderComponent.tsx` |
|
|
49
|
+
| The footer component (brand, `WebsiteSiteFooterMenu`, legal, copyright) | `website/src/components/FooterComponent.tsx` |
|
|
50
|
+
| Registration (`menu`, the site's own chrome keys) | `website/src/website-root.config.ts` |
|
|
51
|
+
| The header and footer each page renders (`navigation`) | `website/src/pages-impl/*.bridge.tsx` |
|
|
52
|
+
| Menu words, per locale | `website/src/i18n/<locale>.json` (`website.chrome.menu*`) |
|
|
53
|
+
| Legal link words, per locale (framework-owned) | `website/src/i18n/<locale>.json` (`website.chrome.legal.*`) |
|
|
54
|
+
| Header and footer restyling | `website/src/styles/website.css` |
|
|
75
55
|
|
|
76
56
|
## When to Use
|
|
77
57
|
|
|
78
|
-
-
|
|
79
|
-
|
|
80
|
-
-
|
|
81
|
-
|
|
82
|
-
`WebsitePageLayout` per-page `header={null}` / `footer={null}`
|
|
83
|
-
escape hatch.
|
|
84
|
-
- The user wants to render a different header on a specific page
|
|
85
|
-
(eg. a minimal header on `/checkout`) — pass an alternate
|
|
86
|
-
`header={<MinimalHeader />}` per-page.
|
|
87
|
-
- The user wants the sign-up CTA in the header to carry the
|
|
88
|
-
parent-domain anonymous-session UUID into the SaaS app shell — see
|
|
89
|
-
the cross-frontend handoff section below and `website-anonymous-session`.
|
|
58
|
+
- Adding a page to the menu, or grouping pages into a Product or Solutions panel.
|
|
59
|
+
- Choosing the header's actions (sign in, start free) and its scroll behaviour.
|
|
60
|
+
- Building the footer's columns and legal links.
|
|
61
|
+
- Suppressing or replacing the header on one page (a campaign landing).
|
|
90
62
|
|
|
91
63
|
## When NOT to Use
|
|
92
64
|
|
|
93
|
-
-
|
|
94
|
-
|
|
95
|
-
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
`
|
|
103
|
-
`
|
|
65
|
+
- Creating the page itself → `website-page-authoring` (it adds the page's own menu entry).
|
|
66
|
+
- In-page section navigation (tabs, anchors) → the section's own skill.
|
|
67
|
+
- The APPLICATION's navigation (sidebar, menubar) → `config-navigation`.
|
|
68
|
+
|
|
69
|
+
## The menu, in one table
|
|
70
|
+
|
|
71
|
+
| Shape | Use it for | Notes |
|
|
72
|
+
|---|---|---|
|
|
73
|
+
| `LINK` entry | a page that answers one question: Pricing, Customers, Contact | a direct top-level link |
|
|
74
|
+
| `PANEL` entry, `LIST` layout | up to five related pages | compact rows |
|
|
75
|
+
| `PANEL` entry, `GRID` layout | a product's areas | two columns, each item an icon, a label and a one-line description |
|
|
76
|
+
| `PANEL` entry, `COLUMNS` layout | solutions cut several ways | one titled column per group ("By role", "By industry"); needs ≥ 2 groups |
|
|
77
|
+
| `featured` | one launch or case study inside a panel | a card beside the items; an optional `image: { src, width, height }` (its intrinsic pixel size, declared because the menu is configuration no build step measures) |
|
|
78
|
+
| `overview` | the panel's "see everything" page | a footer row in the panel |
|
|
79
|
+
| `actions` | the header's calls to action | at most two, at most one `PRIMARY`; into the application by `ApplicationEntryPoint` |
|
|
80
|
+
|
|
81
|
+
Links go to a page (`{ kind: PAGE, routePath }`, locale-prefixed for the visitor), into the application (`{ kind:
|
|
82
|
+
APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP }`, on the environment's `appOrigin` — never a path you guess),
|
|
83
|
+
or elsewhere (`{ kind: EXTERNAL, href }`, marked as external for every visitor). Keep the top level to the website
|
|
84
|
+
plan's entries, in its order (`WEBSITE_MENU_ENTRY_ORDER`): `product`, `solutions`, `pricing`, `blog`, `company`,
|
|
85
|
+
`contact` — and only those whose pages exist. The menu schema enforces neither that list nor its order, so this is
|
|
86
|
+
the authoring rule to keep. Anything more goes inside a panel (NN/g: a panel shows everything at once, an item
|
|
87
|
+
appears once).
|
|
104
88
|
|
|
105
89
|
## Workflow
|
|
106
90
|
|
|
107
|
-
### Step 1:
|
|
108
|
-
|
|
109
|
-
Plain React. Compose with the framework's L1 primitives
|
|
110
|
-
(`WebsiteHeading`, `WebsiteText`, `WebsiteInternalLink`,
|
|
111
|
-
`WebsiteInternalButton`, `WebsiteImage`) for token-aware defaults +
|
|
112
|
-
locale-correct routing. Read site-wide labels via
|
|
113
|
-
`useWebsiteLabelByKey('website.chrome.header.<slot>' as WebsiteLabelKey)`
|
|
114
|
-
— the leaf-relative `useWebsiteLabel` hook is **not available** in
|
|
115
|
-
chrome (it requires the page+section ambient that chrome doesn't have).
|
|
116
|
-
|
|
117
|
-
Decide up front:
|
|
118
|
-
|
|
119
|
-
- **Internal vs external link primitive** — for any `href` that
|
|
120
|
-
points at a route served by the SAME Astro build (`/features`,
|
|
121
|
-
`/pricing`, `/contact`), use `<WebsiteInternalLink routePath={...}>`
|
|
122
|
-
(or `<WebsiteInternalButton routePath={...}>` for CTA-styled buttons).
|
|
123
|
-
The internal primitives accept locale-NEUTRAL paths and the framework
|
|
124
|
-
auto-prefixes the active locale (`/pricing` → `/fr/pricing` on FR
|
|
125
|
-
pages). Authoring a raw `<WebsiteLink href="/pricing">` SILENTLY
|
|
126
|
-
BREAKS on non-default-locale pages — the visitor falls out of their
|
|
127
|
-
locale on every navigation, and unit tests do not catch it because
|
|
128
|
-
they navigate inside a single locale. Reserve `<WebsiteLink>` /
|
|
129
|
-
`<WebsiteButton>` (with `external` / fully-qualified URL) for
|
|
130
|
-
fully-qualified external URLs (cross-frontend handoffs, social, docs)
|
|
131
|
-
and for `mailto:` / `tel:` schemes.
|
|
132
|
-
- **Anchor link items** as a typed prop (`items: { labelKey, routePath }[]`)
|
|
133
|
-
rather than hardcoded JSX so the list can vary per build (English
|
|
134
|
-
site has more nav items than the AEO-pruned French build, etc.).
|
|
135
|
-
- **Mobile menu** is an interactive island — keep the trigger button
|
|
136
|
-
in the SSR tree but lazy-mount the open/close state with React.
|
|
137
|
-
The `WebsiteButton` primitive already handles `aria-expanded`.
|
|
138
|
-
|
|
139
|
-
### Step 2: Author the footer component
|
|
140
|
-
|
|
141
|
-
Same authoring shape. Footer extras:
|
|
142
|
-
|
|
143
|
-
- **Locale switcher** — emit `<a>` elements per locale with
|
|
144
|
-
`hreflang="<locale>"` so search engines understand the alternate-
|
|
145
|
-
language relationship. The locale switcher is the ONE place in
|
|
146
|
-
chrome that legitimately uses raw `<a>` (not `WebsiteInternalLink`):
|
|
147
|
-
each entry intentionally LEAVES the current locale to enter another,
|
|
148
|
-
so the auto-prefix behavior is exactly the wrong contract. Read the
|
|
149
|
-
locale list from `useWebsiteRuntime().locale` (the active locale)
|
|
150
|
-
plus `WebsiteRootConfig.locales` injected as a prop or imported
|
|
151
|
-
directly from your `website-root.config.ts`.
|
|
152
|
-
- **Legal columns** — copyright, privacy, terms. Use
|
|
153
|
-
`<WebsiteInternalLink routePath="/legal/privacy">` for in-app legal
|
|
154
|
-
pages (locale-prefixed automatically); reserve `<WebsiteLink href=...
|
|
155
|
-
external>` for cases where legal lives on a separate domain.
|
|
156
|
-
- **Social links** — always pass `external` to `WebsiteLink` so the
|
|
157
|
-
primitive applies `rel="noopener noreferrer"` + `target="_blank"`
|
|
158
|
-
automatically.
|
|
159
|
-
|
|
160
|
-
### Step 3: Register both components in `WebsiteRootConfig.navigation`
|
|
161
|
-
|
|
162
|
-
The `WebsiteRootConfig` exports the canonical site-wide config (see
|
|
163
|
-
`website-page-authoring`'s root-config block). The `navigation` field
|
|
164
|
-
takes the two component references — no factory call, no schema
|
|
165
|
-
validation beyond the typed `ComponentType<unknown>` slot. The
|
|
166
|
-
host adapter (Phase 5 `WebsitePageBridge.astro`) reads this config,
|
|
167
|
-
mounts the runtime context with `navigation: rootConfig.navigation`,
|
|
168
|
-
and `WebsitePageLayout` resolves the components from there at every
|
|
169
|
-
page render.
|
|
170
|
-
|
|
171
|
-
### Step 4: (Optional) Per-page override
|
|
172
|
-
|
|
173
|
-
If a single page needs different chrome, pass `header={…}` /
|
|
174
|
-
`footer={…}` to that page's `<WebsitePageLayout>`. Three resolution
|
|
175
|
-
rules (encoded in `WebsitePageLayout`):
|
|
176
|
-
|
|
177
|
-
- `header={null}` — explicit suppression. The `<header>` element is
|
|
178
|
-
omitted entirely.
|
|
179
|
-
- `header={<X />}` — per-page replacement. Any `ReactNode`.
|
|
180
|
-
- `header` omitted — fall back to the runtime navigation config.
|
|
181
|
-
|
|
182
|
-
Same rules for `footer`. Use the override sparingly — every page
|
|
183
|
-
that overrides loses the site-wide consistency the registration
|
|
184
|
-
buys.
|
|
185
|
-
|
|
186
|
-
### Step 5: Author the chrome label-pack entries
|
|
187
|
-
|
|
188
|
-
Header / footer copy lives under the synthetic page/section namespace
|
|
189
|
-
`website.chrome.header.`* and `website.chrome.footer.*`. The
|
|
190
|
-
`WebsiteLabelKeySchema` regex accepts these — `chrome` parses as a
|
|
191
|
-
kebab-case "page" ref; `header` / `footer` parse as kebab-case
|
|
192
|
-
"section" refs. This convention is what unblocks
|
|
193
|
-
`useWebsiteLabelByKey` for chrome without inventing a parallel label
|
|
194
|
-
schema. See `website-label-pack` for the pack file shape.
|
|
91
|
+
### Step 1: Shape the menu from the pages
|
|
195
92
|
|
|
196
|
-
|
|
93
|
+
Product pages go in a `product` panel, solution pages in a `solutions` panel grouped by how they cut the audience,
|
|
94
|
+
one-question pages are direct links. A build task's brief gives each page its exact entry; follow it. Every panel
|
|
95
|
+
item gets a one-line description written for the visitor — it is what makes a panel worth opening. Icons come from
|
|
96
|
+
the closed `WebsiteMenuIcon` set; pick the nearest concept or none.
|
|
197
97
|
|
|
198
|
-
|
|
199
|
-
both in `WebsiteRootConfig`, and per-page `header={null}` suppression)
|
|
200
|
-
are extracted to `references/worked-examples-header-footer.md` to keep
|
|
201
|
-
this skill within the inline-code-block discipline. Read that file
|
|
202
|
-
when you need the concrete component shapes.
|
|
203
|
-
|
|
204
|
-
The key authoring shapes captured there are:
|
|
205
|
-
|
|
206
|
-
- **`SiteHeader.tsx`** — typed `items` prop (`{ labelKey, routePath }[]`),
|
|
207
|
-
`<NavItemLink>` extraction so each `useWebsiteLabelByKey` call sits at
|
|
208
|
-
child-component top level (Rules of Hooks), `WebsiteInternalLink` for
|
|
209
|
-
same-build routes, `WebsiteLink` + `external` for the cross-frontend
|
|
210
|
-
CTA target.
|
|
211
|
-
- **`SiteFooter.tsx`** — discriminated `SiteFooterLink` union
|
|
212
|
-
(`internal` | `external`), per-row `<FooterLink>` / `<FooterColumn>`
|
|
213
|
-
extraction (same Rules-of-Hooks reason), raw `<a hrefLang="...">`
|
|
214
|
-
for the locale switcher (the ONE place chrome legitimately bypasses
|
|
215
|
-
`WebsiteInternalLink`), `external` flag on every social link so
|
|
216
|
-
`rel="noopener noreferrer"` + `target="_blank"` are applied.
|
|
217
|
-
- **`website-root.config.ts` registration** — bind both components
|
|
218
|
-
through small wrapper closures, mount them on
|
|
219
|
-
`WebsiteRootConfig.navigation.{headerComponent,footerComponent}`.
|
|
220
|
-
- **Per-page override** — pass `header={null}` (explicit suppression)
|
|
221
|
-
or `header={<MinimalHeader />}` (replacement) to a single page's
|
|
222
|
-
`<WebsitePageLayout>`; omit the prop to fall back to the runtime
|
|
223
|
-
config.
|
|
224
|
-
|
|
225
|
-
Variant vocabulary in the examples uses the bare placeholder enums
|
|
226
|
-
(`WebsiteButtonVariant.{PRIMARY,SECONDARY}`,
|
|
227
|
-
`WebsiteHeadingVariant.{DISPLAY,HEADLINE,TITLE}`,
|
|
228
|
-
`WebsiteTextVariant.{LEAD,BODY,CAPTION}`); consumers extend the variant
|
|
229
|
-
set by overriding the primitive at the L1 boundary — see
|
|
230
|
-
`website-primitive-overrides`. Picking a richer variant before the
|
|
231
|
-
override exists fails TypeScript at compile time, which is the intended
|
|
232
|
-
loud signal.
|
|
98
|
+
### Step 2: Choose the actions
|
|
233
99
|
|
|
234
|
-
|
|
100
|
+
The scaffold ships "Sign in" (`SECONDARY`, `SIGN_IN`) and "Get started" (`PRIMARY`, `SIGN_UP`). Rename them in the
|
|
101
|
+
locale packs; keep one primary. A visitor's anonymous session follows them into the application through its
|
|
102
|
+
cookie and is handed over on authentication (`website-anonymous-session`) — the action needs no special route.
|
|
235
103
|
|
|
236
|
-
|
|
237
|
-
crawlers understand the public information architecture.
|
|
104
|
+
### Step 3: Render it
|
|
238
105
|
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
-
|
|
247
|
-
|
|
248
|
-
|
|
106
|
+
`HeaderComponent` returns `<WebsiteSiteHeader menu={SITE_MENU} brand={<HeaderBrand />} scrollBehavior={…} />`:
|
|
107
|
+
`STICKY` (default), `AUTO_HIDE` (slides away reading down, returns scrolling up — long pages, phones) or `STATIC`.
|
|
108
|
+
The layout already renders the `<header>` landmark around it: never add a second one. The footer places
|
|
109
|
+
`<WebsiteSiteFooterMenu menu={SITE_MENU} />` beside its brand, then `<WebsitePublicDocumentLinks />` and the
|
|
110
|
+
copyright. Never hand-write a `/privacy`, `/terms`, `/legal-notice` or `/legal/...` link: the legal pages are the
|
|
111
|
+
application's, and their paths come from the constant its router mounts. Like the header's application links, the
|
|
112
|
+
component needs the page to pass `appOrigin` to its island, and `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}`
|
|
113
|
+
beside it (whether the legal-notice link is owed); the build fails without either. It also takes
|
|
114
|
+
`servedPublicDocumentRefs={WEBSITE_SITE_CONTEXT.servedPublicDocumentRefs}`, which documents the application serves, and
|
|
115
|
+
links only those (`references/framework-public-document-links-api.md`).
|
|
249
116
|
|
|
250
|
-
|
|
251
|
-
the file is redundant." The file is the crawler-facing assembly guide;
|
|
252
|
-
repeat the intentional primary route map there.
|
|
117
|
+
### Step 4: Register it and write the words
|
|
253
118
|
|
|
254
|
-
|
|
119
|
+
`WEBSITE_ROOT_CONFIG.menu = SITE_MENU`. Then every derived key in every locale pack: the build names any missing
|
|
120
|
+
one. The key shapes are in `references/menu-keys-and-styling.md`. A site with two or more locales also owes the
|
|
121
|
+
language switcher's one word, `website.chrome.locale-switcher.label`, in every pack (the framework names the languages
|
|
122
|
+
themselves); the route shells must pass `locales` to the island for the switcher to appear (`website-page-authoring`,
|
|
123
|
+
step 3). The legal links' words are framework-owned too: `website.chrome.legal.heading` (the landmark's name) and one
|
|
124
|
+
`website.chrome.legal.<document-id>` per public document (`privacy-notice`, `service-terms`), plus
|
|
125
|
+
`website.chrome.legal.legal-notice`, required in every pack and never listed in `CHROME_LABEL_KEYS`. A public document the framework adds is a missing key at the next build.
|
|
255
126
|
|
|
256
|
-
|
|
257
|
-
|---|---|
|
|
258
|
-
| Primary nav URLs are surfaced in `llms.txt` | `rg -n "\\]\\(.*/(features|pricing|contact|blog)?\\)" website/src/content/llms.txt` (must include the current primary routes) |
|
|
259
|
-
|
|
260
|
-
## Cross-frontend handoff CTA pattern (D16)
|
|
261
|
-
|
|
262
|
-
The header's primary CTA almost always targets the SaaS app's
|
|
263
|
-
sign-up / dashboard entry. To preserve the parent-domain anonymous-
|
|
264
|
-
session UUID across the marketing-site → app boundary:
|
|
265
|
-
|
|
266
|
-
- Point the CTA `href` at the app's handoff route, **not** at the
|
|
267
|
-
raw sign-up URL. The app's middleware reads the parent-domain
|
|
268
|
-
cookie, mints the app-side session, and redirects to the right
|
|
269
|
-
destination.
|
|
270
|
-
- Keep the handoff URL constant per build (one site-wide CTA target);
|
|
271
|
-
per-campaign variations belong on `website-section-cta` with their
|
|
272
|
-
own `?intent=…` query param.
|
|
273
|
-
- The header CTA is essential navigation the visitor asked for, so it is
|
|
274
|
-
never consent-gated. To give visitors a way back to their privacy choice,
|
|
275
|
-
add a footer link that calls `useWebsiteConsent().openSettings()` — see
|
|
276
|
-
`website-consent-gate-overrides`.
|
|
277
|
-
- The full anonymous-session contract (parent-domain cookie name,
|
|
278
|
-
TTL, transposition on sign-up) is documented in
|
|
279
|
-
`website-anonymous-session`.
|
|
280
|
-
|
|
281
|
-
## Site-wide chrome label-pack convention
|
|
282
|
-
|
|
283
|
-
Header/footer labels use the synthetic page/section namespace. This
|
|
284
|
-
is the only label namespace that is NOT registered in any page
|
|
285
|
-
manifest's `expectedLabelKeys` — the site-wide chrome doesn't
|
|
286
|
-
participate in per-page label-pack auditing because it ships once
|
|
287
|
-
per locale and is exercised from every page.
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
| Where | Convention |
|
|
291
|
-
| -------------------------------- | --------------------------------------------------------------------- |
|
|
292
|
-
| Header logo alt | `website.chrome.header.logo-alt` |
|
|
293
|
-
| Header nav items | `website.chrome.header.nav.<item-ref>` (e.g. `nav.features`) |
|
|
294
|
-
| Header primary CTA | `website.chrome.header.primary-cta` |
|
|
295
|
-
| Header mobile menu toggle (a11y) | `website.chrome.header.menu-toggle` |
|
|
296
|
-
| Footer column heading | `website.chrome.footer.<column-ref>.heading` (e.g. `product.heading`) |
|
|
297
|
-
| Footer column link | `website.chrome.footer.<column-ref>.<link-ref>` |
|
|
298
|
-
| Footer locale-switcher (a11y) | `website.chrome.footer.locale-switcher.label` |
|
|
299
|
-
| Footer legal copyright | `website.chrome.footer.legal.copyright` |
|
|
300
|
-
| Footer social link (a11y) | `website.chrome.footer.social.<network>` |
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
The `WebsiteLabelKeySchema` regex accepts these — `chrome` parses as
|
|
304
|
-
a kebab-case page ref; `header` / `footer` parse as kebab-case
|
|
305
|
-
section refs. The label-pack validator (`website-label-pack`)
|
|
306
|
-
auto-permits any `website.chrome.*` keys without manifest
|
|
307
|
-
registration so chrome copy doesn't need a synthetic manifest entry.
|
|
127
|
+
### Step 5: Restyle, if the brand needs it
|
|
308
128
|
|
|
309
|
-
|
|
129
|
+
Ordinary rules in `website.css` on the `data-website-site-*` hooks, or the `--website-site-header-*` custom
|
|
130
|
+
properties (height, max width, gutter, colours). The engine's rules sit in a cascade layer the site's unlayered CSS
|
|
131
|
+
always beats — no `!important`, no fork.
|
|
310
132
|
|
|
311
|
-
|
|
312
|
-
examples for `SiteHeader.tsx`, `SiteFooter.tsx`,
|
|
313
|
-
`WebsiteRootConfig.navigation` registration, and the per-page
|
|
314
|
-
`header={null}` suppression escape hatch. Inline blocks were
|
|
315
|
-
extracted to honor the inline-code-block discipline (Rule 10);
|
|
316
|
-
promote them to `example.website.chrome.*` Tier A
|
|
317
|
-
anchors when the consumer-side chrome lands in
|
|
318
|
-
`website/src/chrome/`.
|
|
319
|
-
- The three runtime moving parts (slot schema, runtime carrier,
|
|
320
|
-
layout resolution rules: per-page override → runtime fallback →
|
|
321
|
-
explicit `null` suppression) are framework-internal. Refer to
|
|
322
|
-
installed website contract — `WebsiteRootConfig.navigation`,
|
|
323
|
-
`WebsiteRuntimeContextValue.navigation`, and `WebsitePageLayout`
|
|
324
|
-
— when authoring a per-page override that needs to inspect or
|
|
325
|
-
participate in the resolution chain.
|
|
133
|
+
### Step 6: Override on one page, rarely
|
|
326
134
|
|
|
327
|
-
|
|
135
|
+
A page's bridge closes over the `navigation` it renders with, so a campaign page can pass its own header component
|
|
136
|
+
(for instance a `WebsiteSiteHeader` over a menu with no entries and one action). Every override loses the
|
|
137
|
+
site-wide consistency, so make it a deliberate exception — see the last section of the worked example.
|
|
328
138
|
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
(not per-page) — per-page overrides via `<WebsitePageLayout header={…} footer={…}>` are the exception, not the rule.
|
|
333
|
-
- No `defineWebsiteSection(...)` call wraps a header/footer
|
|
334
|
-
component — chrome is plain JSX, not a section definition.
|
|
335
|
-
- No `<WebsiteSection>` wrapper inside header/footer — they
|
|
336
|
-
render OUTSIDE `<main>` and have no section context.
|
|
337
|
-
- All user-visible strings come from `useWebsiteLabelByKey('website.chrome.<…>' as WebsiteLabelKey)` (NOT `useWebsiteLabel`, which requires
|
|
338
|
-
page+section context that chrome doesn't have).
|
|
339
|
-
- External `<WebsiteLink>` calls pass `external` so
|
|
340
|
-
`rel="noopener noreferrer"` + `target="_blank"` are applied
|
|
341
|
-
automatically.
|
|
342
|
-
- Locale switcher emits one `<a hreflang="<locale>">` per
|
|
343
|
-
`WebsiteRootConfig.locales` entry, with `aria-current="page"`
|
|
344
|
-
on the active locale.
|
|
345
|
-
- Header sign-up CTA targets the cross-frontend handoff route
|
|
346
|
-
(per `website-anonymous-session`), not the raw sign-up URL.
|
|
347
|
-
- Header and footer components render a `<div>` (or fragment) at their root, never
|
|
348
|
-
`<header>` / `<footer>` — the layout supplies the landmark.
|
|
349
|
-
- Per-page override (when used) passes `header={null}` for
|
|
350
|
-
explicit suppression OR a concrete `ReactNode` for replacement
|
|
351
|
-
— never `header={undefined}` (use the omission spelling: just
|
|
352
|
-
don't pass the prop).
|
|
139
|
+
**Stop** when `wildo website audit` passes (every menu route mounted, every menu key in every pack) and the header
|
|
140
|
+
works on a phone: open the drawer, open a panel, follow a link. If the audit names a missing key or route,
|
|
141
|
+
**return to Step 4**.
|
|
353
142
|
|
|
354
|
-
|
|
143
|
+
## Contribution to `llms.txt`
|
|
355
144
|
|
|
145
|
+
Open `website/src/content/llms.txt` with the primary destinations as markdown links — the menu's top level and its
|
|
146
|
+
panels' overview pages. Not every panel item, footer link or legal page: `llms.txt` wants the primary discovery
|
|
147
|
+
graph.
|
|
356
148
|
|
|
357
|
-
|
|
358
|
-
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
359
|
-
| Chrome lives outside `sections/` | `rg -l "useWebsiteLabel\(" website/src/chrome/` (must return empty — chrome must use `useWebsiteLabelByKey`) |
|
|
360
|
-
| Chrome registered, not authored as a section | `rg -n "defineWebsiteSection" website/src/chrome/` (must return empty) |
|
|
361
|
-
| Header CTA targets the handoff route | `rg -n "primaryCtaHref:" website/src/website-root.config.ts` (must reference `/auth/handoff` or the consumer's documented handoff path) |
|
|
362
|
-
| Locale switcher uses `hrefLang` | `rg -n "hrefLang" website/src/chrome/SiteFooter.tsx` (must return ≥1) |
|
|
363
|
-
| External social links are flagged | `rg -n "<WebsiteLink href=\"https" website/src/chrome/SiteFooter.tsx` (every match must also have `external`) |
|
|
364
|
-
| Chrome never re-declares the landmark | `rg -n "<header\b\|<footer\b" website/src/components/ website/src/chrome/` (must return empty — the layout already emits both) |
|
|
149
|
+
## Worked Example
|
|
365
150
|
|
|
151
|
+
A product panel with a featured card, a solutions panel in columns, direct links and two actions:
|
|
152
|
+
`references/worked-examples-header-footer.md`. The source-backed contracts:
|
|
153
|
+
|
|
154
|
+
## Import Origins
|
|
155
|
+
|
|
156
|
+
- `@wildo-ai/saas-website`
|
|
157
|
+
|
|
158
|
+
## Source Excerpts
|
|
159
|
+
|
|
160
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
161
|
+
|
|
162
|
+
```typescript
|
|
163
|
+
*
|
|
164
|
+
* `WebsiteMenu` — the site's header menu. Author it once in `website/src/site-menu.ts` with `defineWebsiteMenu`,
|
|
165
|
+
* hand it to `WebsiteSiteHeader` (the header) and to `WebsiteRootConfig.menu` (build validation + label keys).
|
|
166
|
+
*
|
|
167
|
+
* Structural rules, enforced at parse:
|
|
168
|
+
* - entry refs are unique; group refs are unique within their panel; item refs are unique within their group;
|
|
169
|
+
* action refs are unique — together that makes every derived label key unique;
|
|
170
|
+
* - a `COLUMNS` panel has at least two groups (one titled column is a `LIST`);
|
|
171
|
+
* - at most two actions, at most one of them `PRIMARY` — a header with two primary buttons has none.
|
|
172
|
+
*
|
|
173
|
+
* NN/g's guidance on size: a panel shows everything at once, no scrolling, and an item appears once. Keep the top
|
|
174
|
+
* level to about five entries; what does not fit belongs in a panel or in the footer.
|
|
175
|
+
*/
|
|
176
|
+
const _WebsiteMenuSchema = z
|
|
177
|
+
.strictObject({
|
|
178
|
+
entries: z.array(_WebsiteMenuEntrySchema),
|
|
179
|
+
actions: z.array(_WebsiteMenuActionSchema).max(2, { error: 'A header carries at most two actions.' }).default([]),
|
|
180
|
+
})
|
|
181
|
+
.superRefine((menu, ctx) => {
|
|
182
|
+
const entryRefs = new Set<string>();
|
|
183
|
+
for (const [entryIndex, entry] of menu.entries.entries()) {
|
|
184
|
+
if (entryRefs.has(entry.ref)) {
|
|
185
|
+
ctx.addIssue({ code: 'custom', path: ['entries', entryIndex, 'ref'], message: `Duplicate menu entry ref "${entry.ref}".` });
|
|
186
|
+
}
|
|
187
|
+
entryRefs.add(entry.ref);
|
|
188
|
+
if (entry.kind !== WebsiteMenuEntryKind.PANEL) continue;
|
|
189
|
+
if (entry.layout === WebsiteMenuPanelLayout.COLUMNS && entry.groups.length < 2) {
|
|
190
|
+
ctx.addIssue({
|
|
191
|
+
code: 'custom',
|
|
192
|
+
path: ['entries', entryIndex, 'layout'],
|
|
193
|
+
message: `Menu panel "${entry.ref}" is COLUMNS with one group; one column is a LIST or a GRID.`,
|
|
194
|
+
});
|
|
195
|
+
}
|
|
196
|
+
const groupRefs = new Set<string>();
|
|
197
|
+
for (const [groupIndex, group] of entry.groups.entries()) {
|
|
198
|
+
if (groupRefs.has(group.ref)) {
|
|
199
|
+
ctx.addIssue({
|
|
200
|
+
code: 'custom',
|
|
201
|
+
path: ['entries', entryIndex, 'groups', groupIndex, 'ref'],
|
|
202
|
+
message: `Duplicate group ref "${group.ref}" in menu panel "${entry.ref}".`,
|
|
203
|
+
});
|
|
204
|
+
}
|
|
205
|
+
groupRefs.add(group.ref);
|
|
206
|
+
const itemRefs = new Set<string>();
|
|
207
|
+
for (const [itemIndex, item] of group.items.entries()) {
|
|
208
|
+
if (itemRefs.has(item.ref)) {
|
|
209
|
+
ctx.addIssue({
|
|
210
|
+
code: 'custom',
|
|
211
|
+
path: ['entries', entryIndex, 'groups', groupIndex, 'items', itemIndex, 'ref'],
|
|
212
|
+
message: `Duplicate item ref "${item.ref}" in group "${group.ref}" of menu panel "${entry.ref}".`,
|
|
213
|
+
});
|
|
214
|
+
}
|
|
215
|
+
itemRefs.add(item.ref);
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
const actionRefs = new Set<string>();
|
|
220
|
+
for (const [actionIndex, action] of menu.actions.entries()) {
|
|
221
|
+
if (actionRefs.has(action.ref)) {
|
|
222
|
+
ctx.addIssue({ code: 'custom', path: ['actions', actionIndex, 'ref'], message: `Duplicate menu action ref "${action.ref}".` });
|
|
223
|
+
}
|
|
224
|
+
actionRefs.add(action.ref);
|
|
225
|
+
}
|
|
226
|
+
if (menu.actions.filter((action) => action.emphasis === WebsiteMenuActionEmphasis.PRIMARY).length > 1) {
|
|
227
|
+
ctx.addIssue({ code: 'custom', path: ['actions'], message: 'A header carries at most one PRIMARY action.' });
|
|
228
|
+
}
|
|
229
|
+
});
|
|
230
|
+
|
|
231
|
+
export const WebsiteMenuSchema: typeof _WebsiteMenuSchema = _WebsiteMenuSchema;
|
|
232
|
+
|
|
233
|
+
export type WebsiteMenu = z.infer<typeof _WebsiteMenuSchema>;
|
|
234
|
+
export type WebsiteMenuInput = z.input<typeof _WebsiteMenuSchema>;
|
|
235
|
+
|
|
236
|
+
/**
|
|
237
|
+
* Parse and freeze a site menu. Call it at module load in `website/src/site-menu.ts`, so a malformed menu fails
|
|
238
|
+
* the import — the dev server and the build both — instead of rendering wrong.
|
|
239
|
+
*/
|
|
240
|
+
export function defineWebsiteMenu(menu: WebsiteMenuInput): WebsiteMenu {
|
|
241
|
+
return WebsiteMenuSchema.parse(menu);
|
|
242
|
+
}
|
|
243
|
+
```
|
|
366
244
|
|
|
367
|
-
##
|
|
245
|
+
## References
|
|
246
|
+
|
|
247
|
+
- `references/worked-examples-header-footer.md` — a complete `site-menu.ts`, header, footer and registration.
|
|
248
|
+
- `references/menu-keys-and-styling.md` — every derived label key, and the styling hooks.
|
|
249
|
+
- `references/framework-menu-api.md` — source-backed: menu vocabulary, label keys, icons, the header and footer components, entry points.
|
|
250
|
+
- `references/framework-public-document-links-api.md` — source-backed `WebsitePublicDocumentLinks`, the footer's legal links.
|
|
251
|
+
|
|
252
|
+
## Verification
|
|
253
|
+
|
|
254
|
+
- [ ] Every menu entry, item and action is declared in `site-menu.ts` — no link list in a component.
|
|
255
|
+
- [ ] `WEBSITE_ROOT_CONFIG.menu` is `SITE_MENU`, and `wildo website audit` passes.
|
|
256
|
+
- [ ] Every panel item has a one-line description in every locale pack.
|
|
257
|
+
- [ ] Actions into the application name an `ApplicationEntryPoint`, never a path.
|
|
258
|
+
- [ ] `HeaderComponent` renders no `<header>` of its own.
|
|
259
|
+
- [ ] The footer renders `<WebsitePublicDocumentLinks />`, and no chrome file hand-writes a `/privacy`, `/terms`, `/legal-notice` or `/legal/` link.
|
|
260
|
+
- [ ] Every page that renders a bridge island forwards `legalNoticeOwed` and `servedPublicDocumentRefs` beside `appOrigin`.
|
|
368
261
|
|
|
262
|
+
### Grep invariants
|
|
263
|
+
|
|
264
|
+
| Invariant | Command |
|
|
265
|
+
|---|---|
|
|
266
|
+
| No hand-kept link list in chrome | see the commands below the table (must return empty) |
|
|
267
|
+
| The menu is declared to the build | `rg -n "menu: SITE_MENU" website/src/website-root.config.ts` (must return 1) |
|
|
268
|
+
| No nested banner | `rg -n "<header" website/src/components/HeaderComponent.tsx` (must return empty) |
|
|
269
|
+
| No guessed application path | see the commands below the table (must return empty — use `entryPoint`) |
|
|
270
|
+
| Menu keys are never listed by hand | `rg -n "['\"]website\.chrome\.menu" website/src/website-root.config.ts` (must return empty) |
|
|
271
|
+
| The footer links the legal documents | `rg -n "WebsitePublicDocumentLinks" website/src/components/FooterComponent.tsx` (must return ≥1) |
|
|
272
|
+
| No hand-written legal link | see the commands below the table (must return empty — the component owns those paths) |
|
|
273
|
+
| Every page forwards `legalNoticeOwed` | see the commands below the table (must return empty) |
|
|
274
|
+
| Every page forwards `servedPublicDocumentRefs` | see the commands below the table (must return empty) |
|
|
275
|
+
| Legal keys are never listed by hand | `rg -n "['\"]website\.chrome\.legal" website/src/website-root.config.ts` (must return empty) |
|
|
276
|
+
|
|
277
|
+
```bash
|
|
278
|
+
# No hand-kept link list in chrome
|
|
279
|
+
rg -n "NAV_ITEMS|navItems" website/src/components
|
|
280
|
+
|
|
281
|
+
# No guessed application path
|
|
282
|
+
rg -n "path: '/(login|register|signup)" website/src
|
|
283
|
+
|
|
284
|
+
# No hand-written legal link
|
|
285
|
+
rg -n "['\"]/(privacy|terms|legal-notice|legal/)" website/src
|
|
286
|
+
|
|
287
|
+
# Every page forwards `legalNoticeOwed` (a page whose props come from a shared shell module passes neither literally)
|
|
288
|
+
comm -23 <(rg -l "appOrigin=" website/src/pages | sort) <(rg -l "legalNoticeOwed=" website/src/pages | sort)
|
|
289
|
+
|
|
290
|
+
# Every page forwards `servedPublicDocumentRefs` (same caveat for a shared shell module)
|
|
291
|
+
comm -23 <(rg -l "appOrigin=" website/src/pages | sort) <(rg -l "servedPublicDocumentRefs=" website/src/pages | sort)
|
|
292
|
+
```
|
|
369
293
|
|
|
370
|
-
|
|
371
|
-
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
372
|
-
| "I'll wrap the header in `<WebsiteSection>` for analytics consistency" | Chrome is not a section. The framework emits `data-website-chrome="header"` on the runtime layout's `<header>` element; analytics that needs the chrome distinction reads that, not `data-section-ref`. Wrapping in `<WebsiteSection>` would corrupt the page's section context and break label-key derivation in chrome's children. |
|
|
373
|
-
| "I'll author header/footer once via `defineWebsiteSection` so they get the SEO contract" | Chrome doesn't have an SEO category. There is no `WebsiteSectionCategory.HEADER` for a reason — chrome doesn't emit JSON-LD; the page sections do. Forcing chrome into the section vocabulary breaks the one-skill-per-category mapping, and gains no structured data: the page's sections emit JSON-LD through `getStructuredData`, rendered by the page route. |
|
|
374
|
-
| "My header is the site's banner, so its root should be `<header>`" | It already is one: `WebsitePageLayout` renders `<header>{HeaderComponent}</header>`. A second `<header>` inside it is a banner nested in the banner and a page with two, which axe reports three ways and a screen reader lists twice. The layout owns the landmark; the component owns its contents. |
|
|
375
|
-
| "I'll register the header per page so each page can override it" | Per-page override IS supported (`header={…}` prop on `<WebsitePageLayout>`). Site-wide registration is the common case; per-page is the escape hatch. Using per-page registration as the default forces every page module to repeat the registration and loses the runtime-context single source of truth. |
|
|
376
|
-
| "Header CTA can target `https://app.example.com/signup` directly" | Direct URLs lose the parent-domain anonymous-session UUID at the cross-frontend boundary. The app-side cannot match the marketing-site visitor to the new sign-up. Use the handoff route (D16). |
|
|
377
|
-
| "I'll inline the locale switcher labels in JSX, they're just two-letter codes" | `EN` / `FR` is the right user-visible token, but the surrounding strings (a11y label on the `<nav>`, `aria-current` semantics) need locale-aware copy — and the tokens themselves may need locale-specific casing for some scripts. Keep them in the label pack from the start. |
|
|
294
|
+
## Common Rationalizations
|
|
378
295
|
|
|
296
|
+
| Rationalization | Reality |
|
|
297
|
+
|---|---|
|
|
298
|
+
| "A custom header gives us more control" | It loses the drawer, keyboard handling, current-page marking and the build's route check — the scaffold had no mobile menu for exactly that reason. Restyle the built-in one. |
|
|
299
|
+
| "I'll add the menu entry before the page exists" | The build refuses a menu link to an unmounted route. Add the entry with the page. |
|
|
300
|
+
| "Descriptions make the panel busy" | A label alone rarely says what is behind it; NN/g and every reference SaaS menu pair them. |
|
|
301
|
+
| "`'/register'` is fine, that's the app's route" | The application owns its paths; name the entry point and the link survives the day the route moves. |
|
|
302
|
+
| "Audience pages go first in the menu" | NN/g: audience navigation is a secondary path. Product first, Solutions after. |
|
|
379
303
|
|
|
380
304
|
## Red Flags
|
|
381
305
|
|
|
382
|
-
-
|
|
383
|
-
|
|
384
|
-
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
inner headings use `<h2>` / `<h3>`.
|
|
394
|
-
- **Re-importing `SiteHeader` from a section module to render it
|
|
395
|
-
inside a hero** — chrome rendered inside a section gets the wrong
|
|
396
|
-
`WebsitePageContext` and breaks label resolution. Compose chrome at
|
|
397
|
-
the layout level only.
|
|
398
|
-
- **A header that imports `~wildo-frontend-lib/`** or
|
|
399
|
-
`@wildo-ai/saas-frontend-lib**` — bundle-isolation boundary is
|
|
400
|
-
enforced by the installed package boundary contract. Use the L1
|
|
401
|
-
primitives (`WebsiteLink` / `WebsiteHeading` / `WebsiteText` /
|
|
402
|
-
`WebsiteImage` / `WebsiteButton`) and override them via
|
|
403
|
-
`website-primitive-overrides` if styling needs to swap.
|
|
404
|
-
- **A header that omits `data-website-chrome="header"`** — the
|
|
405
|
-
outer `<header>` element from `WebsitePageLayout` already carries
|
|
406
|
-
semantic landmark; the data attribute on the consumer's wrapper
|
|
407
|
-
is what analytics uses to disambiguate site-wide chrome from
|
|
408
|
-
per-page hero/footer-CTA renders.
|
|
306
|
+
- A component holding its own array of links — catch with the first grep above.
|
|
307
|
+
- A menu key listed in `CHROME_LABEL_KEYS` — catch with the **menu keys** grep; the validator derives them.
|
|
308
|
+
- A footer without `WebsitePublicDocumentLinks`, or a hand-written `/privacy` / `/terms` / `/legal-notice` /
|
|
309
|
+
`/legal/...` link — catch with the **legal links** greps above. The legal pages are the application's, on its origin.
|
|
310
|
+
- A page forwarding `appOrigin` but not `legalNoticeOwed` — its footer throws in the build, and a legal notice the
|
|
311
|
+
operator owes must not be dropped (catch with the **`legalNoticeOwed`** grep above).
|
|
312
|
+
- A page forwarding `appOrigin` but not `servedPublicDocumentRefs` — its footer links a privacy notice or terms the
|
|
313
|
+
application may not serve, and the visitor lands on "unavailable" (catch with the **`servedPublicDocumentRefs`** grep
|
|
314
|
+
above).
|
|
315
|
+
- A header that hides its navigation below some width with no drawer.
|
|
316
|
+
- Two `PRIMARY` actions — the schema refuses it; do not work around it with CSS.
|
|
409
317
|
|
|
410
318
|
## Related Skills
|
|
411
319
|
|
|
412
|
-
- `website-page-authoring` —
|
|
413
|
-
`
|
|
414
|
-
- `website-
|
|
415
|
-
|
|
416
|
-
- `website-
|
|
417
|
-
`WebsiteHeading` / `WebsiteText` / `WebsiteImage` / `WebsiteButton`
|
|
418
|
-
used inside chrome.
|
|
419
|
-
- `website-label-pack` — authoring the `website.chrome.*` synthetic-
|
|
420
|
-
namespace entries.
|
|
421
|
-
- `website-anonymous-session` — parent-domain cookie + cross-
|
|
422
|
-
frontend handoff route the header CTA targets.
|
|
423
|
-
- `website-consent-gate-overrides` — the visitor consent panel, and a
|
|
424
|
-
footer link that reopens it.
|
|
425
|
-
- `website-section-footer-cta` — the in-`<main>` last-impression CTA
|
|
426
|
-
band, distinct from this site footer.
|
|
427
|
-
- `website-seo-aeo-geo` — `hreflang` semantics the locale switcher
|
|
428
|
-
participates in.
|
|
429
|
-
- `website-bundle-discipline` — keeping the chrome bundle lean.
|
|
320
|
+
- `website-page-authoring` — page kinds, routes, and the menu entry each page adds.
|
|
321
|
+
- `website-motion-design` — the motion clock the header's panels open on.
|
|
322
|
+
- `website-label-pack` — locale packs.
|
|
323
|
+
- `website-anonymous-session` — how a visitor's session reaches the application.
|
|
324
|
+
- `website-consent-gate-overrides` — the footer link back to the privacy choice.
|