@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,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: website-section-contact
|
|
3
|
-
description: Author a Contact section that renders the engine's `InboundContactForm`, submitting an `InboundContact` through the site's `WebsiteAnonymousSessionClient
|
|
3
|
+
description: Author a Contact section that renders the engine's `InboundContactForm`, submitting an `InboundContact` through the site's `WebsiteAnonymousSessionClient`, by configuring the engine's `websiteFeatureRowBlock` with the form as its visual and the form's words as `nodeSlots` (`websiteFeatureRowBlock.section({ category: WebsiteSectionCategory.CONTACT, band, config, nodeSlots })`). Use when the user says "add a contact section", "wire a contact form to inbound contacts", "compose a contact-us section with an email field", or "build a sales-contact landing form".
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -20,15 +20,16 @@ Read and apply these patterns from the application-developer point of view:
|
|
|
20
20
|
|
|
21
21
|
# Website Section — Authoring API (source-backed)
|
|
22
22
|
|
|
23
|
-
Shared API excerpts for every `
|
|
23
|
+
Shared API excerpts for every `website-section-<category>` skill. The
|
|
24
24
|
contract is identical across categories; the per-category guidance lives
|
|
25
25
|
in each skill's own `SKILL.md`.
|
|
26
26
|
|
|
27
27
|
## Category vocabulary (closed enum)
|
|
28
28
|
|
|
29
|
-
The `category`
|
|
30
|
-
free string. Adding a new value requires
|
|
31
|
-
`
|
|
29
|
+
The `category` of a section (`category` in `block.section(...)`) is a closed enum, not a
|
|
30
|
+
free string. Adding a new value requires a matching
|
|
31
|
+
`website-section-<value>` skill (`RAW` is covered by
|
|
32
|
+
`website-factory-advanced`).
|
|
32
33
|
|
|
33
34
|
## Import Origins
|
|
34
35
|
|
|
@@ -68,8 +69,9 @@ free string. Adding a new value requires seeding a matching
|
|
|
68
69
|
* (`website-factory-advanced` skill) which bypasses the category
|
|
69
70
|
* vocabulary entirely.
|
|
70
71
|
*
|
|
71
|
-
* **Adding a value**: requires (a) a new entry here
|
|
72
|
-
* `
|
|
72
|
+
* **Adding a value**: requires (a) a new entry here, (b) the matching member of
|
|
73
|
+
* the website plan's `WebsiteSectionKind`, and (c) its `website-section-<value>`
|
|
74
|
+
* skill, which `WEBSITE_SECTION_SKILL_REF` must name or the plan does not compile. Removing a value
|
|
73
75
|
* is a labelled rename — every consumer's
|
|
74
76
|
* `defineWebsiteSection({ category: … })` declaration breaks at compile
|
|
75
77
|
* time, which is the desired loud failure.
|
|
@@ -84,6 +86,24 @@ export enum WebsiteSectionCategory {
|
|
|
84
86
|
SOCIAL_PROOF = 'social-proof',
|
|
85
87
|
FAQ = 'faq',
|
|
86
88
|
FOOTER_CTA = 'footer-cta',
|
|
89
|
+
/** The problem the audience lives with, before any product appears (a solution page's opening argument). */
|
|
90
|
+
PROBLEM = 'problem',
|
|
91
|
+
/** How it works, in three or four steps. */
|
|
92
|
+
HOW_IT_WORKS = 'how-it-works',
|
|
93
|
+
/** The product itself, shown: its real interface framed, a bento of key screens, or tabs across its views. */
|
|
94
|
+
PRODUCT_SHOWCASE = 'product-showcase',
|
|
95
|
+
/** One card per audience, each linking to the solution page written for it. */
|
|
96
|
+
SOLUTION_PATHS = 'solution-paths',
|
|
97
|
+
/** The product against the alternatives, honestly. */
|
|
98
|
+
COMPARISON = 'comparison',
|
|
99
|
+
/** Facts about the product as figures, each one a value the application declares. */
|
|
100
|
+
STATS = 'stats',
|
|
101
|
+
/** The systems the product connects to, by name, each one a provider or protocol the application declares. */
|
|
102
|
+
INTEGRATIONS = 'integrations',
|
|
103
|
+
/** The newest posts of the site's blog, read from the posts' own frontmatter. */
|
|
104
|
+
LATEST_POSTS = 'latest-posts',
|
|
105
|
+
/** What has shipped and what is next, as the application's roadmap declares it. */
|
|
106
|
+
ROADMAP = 'roadmap',
|
|
87
107
|
/**
|
|
88
108
|
* Escape hatch for sections that don't fit any standard category
|
|
89
109
|
* (third-party widgets, custom one-off marketing pieces). Authors should
|
|
@@ -105,8 +125,9 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
|
|
|
105
125
|
The schema declares the **observable contract** the page-manifest
|
|
106
126
|
registration, the label-pack validator, `renderPageStructuredData` and
|
|
107
127
|
the structured-data audit depend on. The
|
|
108
|
-
factory
|
|
109
|
-
|
|
128
|
+
factory adds what the schema cannot express: `Component` takes no props
|
|
129
|
+
(the page mounts it as `<Component />`), so a component that requires
|
|
130
|
+
one is refused at compile time.
|
|
110
131
|
|
|
111
132
|
## Import Origins
|
|
112
133
|
|
|
@@ -119,28 +140,29 @@ compile-time prop checking.
|
|
|
119
140
|
```typescript
|
|
120
141
|
*
|
|
121
142
|
* `WebsiteSectionDefinition` — the runtime contract returned by the
|
|
122
|
-
* `defineWebsiteSection({ … })` factory (
|
|
123
|
-
*
|
|
124
|
-
*
|
|
125
|
-
* because it is the **observable contract** the page-manifest
|
|
143
|
+
* `defineWebsiteSection({ … })` factory (which lives apart from this
|
|
144
|
+
* schema because its input carries React types). The shape is declared
|
|
145
|
+
* with the schemas because it is the **observable contract** the page-manifest
|
|
126
146
|
* registration, the label-pack validator, `renderPageStructuredData` and the
|
|
127
147
|
* structured-data audit depend on.
|
|
128
148
|
*
|
|
129
|
-
* **Shape rationale** (each field carries semantic weight
|
|
130
|
-
* `design-philosophy.mdc`):
|
|
149
|
+
* **Shape rationale** (each field carries semantic weight):
|
|
131
150
|
*
|
|
132
|
-
* - `sectionRef` — the section's identity
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
151
|
+
* - `sectionRef` — the section's identity across the SITE. The build
|
|
152
|
+
* collects every section by its ref (`collectExpectedLabelKeysFromSections`)
|
|
153
|
+
* and refuses two sections that share one with different label keys,
|
|
154
|
+
* which two pages' sections always have (each key is rooted at its own
|
|
155
|
+
* page). So a ref names its page when two pages would share one
|
|
156
|
+
* (`landing-hero`, `pricing-hero`); the manifest registry additionally
|
|
157
|
+
* refuses a ref listed twice on one page.
|
|
136
158
|
* - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
|
|
137
159
|
* for skill-mapping and analytics labelling. It does NOT select the
|
|
138
160
|
* section's structured data.
|
|
139
161
|
* - `expectedLabelKeys` — the **fully-composed** label keys the section
|
|
140
|
-
* commits to consuming.
|
|
141
|
-
*
|
|
142
|
-
*
|
|
143
|
-
*
|
|
162
|
+
* commits to consuming. Leaf-relative keys (`'headline'`) resolved at
|
|
163
|
+
* runtime against the page+section context would also work, but
|
|
164
|
+
* storing the fully-composed key on the definition has three concrete
|
|
165
|
+
* benefits:
|
|
144
166
|
* 1. The label-pack validator (`validateLabelPackAgainstManifest`)
|
|
145
167
|
* runs as a pure function with no need to walk the JSX tree at
|
|
146
168
|
* build time to discover the leaf-to-key resolution.
|
|
@@ -163,15 +185,15 @@ compile-time prop checking.
|
|
|
163
185
|
* valid HTML id that is also URL-fragment-safe: a letter, then
|
|
164
186
|
* letters, digits, `-` or `_`. Uniqueness on a page is the author's
|
|
165
187
|
* to keep, like the id attribute it becomes.
|
|
166
|
-
* - `Component` — the React component that renders the section.
|
|
167
|
-
*
|
|
168
|
-
*
|
|
169
|
-
*
|
|
170
|
-
*
|
|
171
|
-
* guards the runtime shape of "is callable as a React component".
|
|
188
|
+
* - `Component` — the React component that renders the section. The
|
|
189
|
+
* page mounts it with NO props (`<WebsitePageSections>`), which the
|
|
190
|
+
* factory (`defineWebsiteSection`, `WebsiteSectionComponentProps`) enforces at
|
|
191
|
+
* compile time; this schema only guards the runtime shape of "is
|
|
192
|
+
* callable as a React component".
|
|
172
193
|
* - `getStructuredData?` — optional pure function the SEO/AEO/GEO
|
|
173
|
-
* builder library invokes
|
|
174
|
-
*
|
|
194
|
+
* builder library invokes on the server to materialize JSON-LD for the
|
|
195
|
+
* section, handing it the page it renders on (`WebsiteStructuredDataContext`).
|
|
196
|
+
* The return type is intentionally `unknown` here;
|
|
175
197
|
* nothing narrows it by `category` — the section returns whatever
|
|
176
198
|
* vocabulary it emits, and `wildo website audit` reconciles that
|
|
177
199
|
* against the application's Schema.org catalog.
|
|
@@ -202,25 +224,23 @@ export const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSch
|
|
|
202
224
|
/**
|
|
203
225
|
* Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and
|
|
204
226
|
* `getStructuredData` are typed precisely on the factory return type
|
|
205
|
-
* (`defineWebsiteSection
|
|
227
|
+
* (`defineWebsiteSection`); the schema-inferred
|
|
206
228
|
* type is the lowest common denominator used at the persistence /
|
|
207
229
|
* validation boundary only.
|
|
208
230
|
*
|
|
209
231
|
* **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:
|
|
210
232
|
* React component props are CONTRAVARIANT in `ComponentType<T>` —
|
|
211
|
-
*
|
|
212
|
-
* `ComponentType<unknown>` (because a caller could pass
|
|
213
|
-
* the narrower component cannot accept).
|
|
214
|
-
*
|
|
215
|
-
*
|
|
216
|
-
*
|
|
217
|
-
*
|
|
218
|
-
*
|
|
219
|
-
*
|
|
220
|
-
*
|
|
221
|
-
*
|
|
222
|
-
* components directly with arbitrary props — the consumer's JSX
|
|
223
|
-
* supplies the right props at the call site.
|
|
233
|
+
* the factory's `ComponentType<WebsiteSectionComponentProps>` is NOT
|
|
234
|
+
* assignable to `ComponentType<unknown>` (because a caller could pass
|
|
235
|
+
* an `unknown` the narrower component cannot accept). That would stop
|
|
236
|
+
* every `TypedWebsiteSectionDefinition` from reaching the helpers typed
|
|
237
|
+
* against the bare `WebsiteSectionDefinition` — collectors, validators,
|
|
238
|
+
* and registries. `any` is the escape hatch the React typings
|
|
239
|
+
* themselves use for heterogeneous component containers
|
|
240
|
+
* (`React.forwardRef`, `React.lazy`'s internal component slot, etc.).
|
|
241
|
+
* It widens nothing at runtime: the page mounts every section
|
|
242
|
+
* component as `<Component />`, with no props, and
|
|
243
|
+
* `defineWebsiteSection` refuses a component that requires one.
|
|
224
244
|
*/
|
|
225
245
|
export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {
|
|
226
246
|
Component: ComponentType<any>;
|
|
@@ -235,23 +255,76 @@ export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSection
|
|
|
235
255
|
* optional fields per entity; locking them in TS would be both
|
|
236
256
|
* impractical and brittle as Schema.org evolves). The companion
|
|
237
257
|
* catalog reconciliation surface catches missing-required and
|
|
238
|
-
* deprecated-field-used at the SEMANTIC layer (
|
|
239
|
-
*
|
|
258
|
+
* deprecated-field-used at the SEMANTIC layer (warnings; failures
|
|
259
|
+
* under `wildo website audit --strict`), so the runtime type stays loose.
|
|
240
260
|
*
|
|
241
261
|
* Returns `null`, `undefined`, or `[]` when the section has no
|
|
242
262
|
* structured-data contribution for the current state — the
|
|
243
263
|
* renderer short-circuits all three.
|
|
264
|
+
*
|
|
265
|
+
* **The context** (`WebsiteStructuredDataContext`): the page's locale,
|
|
266
|
+
* refs, route and origin, and `label(slot)` — the section's own words
|
|
267
|
+
* in that locale. Structured data restates what the section shows, so a
|
|
268
|
+
* section with words (an FAQ, a product description) reads them here,
|
|
269
|
+
* once per locale and on the server only, rather than hard-coding one
|
|
270
|
+
* language or importing every locale's pack into the browser bundle. A
|
|
271
|
+
* function that declares no parameter is still accepted: a payload with
|
|
272
|
+
* no words (a site-wide `Organization` id) needs no context.
|
|
244
273
|
*/
|
|
245
|
-
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
274
|
+
getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
246
275
|
}
|
|
247
276
|
```
|
|
248
277
|
|
|
249
|
-
##
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
278
|
+
## Structured data reads the section's words through its context
|
|
279
|
+
|
|
280
|
+
`getStructuredData` receives the page the section is published on, a
|
|
281
|
+
`WebsiteStructuredDataContext` (from `@wildo-ai/saas-website`), and runs
|
|
282
|
+
on the server only:
|
|
283
|
+
|
|
284
|
+
- `label(slot)` — the section's word for `slot` in the page's locale,
|
|
285
|
+
the key `useWebsiteLabel(slot)` reads in the component. It throws when
|
|
286
|
+
the locale's pack has no word, so a raw key is never published.
|
|
287
|
+
- `pageUrl` — the page's URL in this locale, for `url` and `@id`;
|
|
288
|
+
`siteOrigin` — the site's public origin, for site-wide `@id`s;
|
|
289
|
+
`locale` — for `inLanguage`.
|
|
290
|
+
|
|
291
|
+
A word the section shows reaches its JSON-LD only through `label(slot)`:
|
|
292
|
+
never typed into the payload (one language on every locale's page) and
|
|
293
|
+
never read from a label pack imported into the sections file (every
|
|
294
|
+
visitor downloads the pack). A payload with no words may keep
|
|
295
|
+
`() => …`. The route passes the context
|
|
296
|
+
(`renderPageStructuredData({ sections, context: runtime.structuredData })`),
|
|
297
|
+
and `wildo website audit` checks every route a page is published at, in
|
|
298
|
+
that route's locale, as the page renders it. The full contract is in the `website-seo-aeo-geo` skill.
|
|
299
|
+
|
|
300
|
+
## How a section is defined: a configured block
|
|
301
|
+
|
|
302
|
+
When the section comes from the website plan, its `design` already names the block, its layout, its surface and what
|
|
303
|
+
its demo shows, and says whether it is the page's signature section. Build what it names; the guidance below is for
|
|
304
|
+
the fields the plan left open. When the section is built, look at it: `wildo website look <route> --all-locales`
|
|
305
|
+
photographs the page in every locale the site serves, at a desktop and a phone width, and runs an accessibility pass; judge the pictures against the
|
|
306
|
+
`website-building-blocks` skill's `references/website-visual-quality-rubric.md` and fix every violation it lists.
|
|
307
|
+
|
|
308
|
+
A section is almost always one of the engine's blocks, CONFIGURED:
|
|
309
|
+
`websiteHeroBlock.section({ pageRef, sectionRef, category, config })`,
|
|
310
|
+
`websiteCardGridBlock.section({ …, band, intro, config })`. The block
|
|
311
|
+
renders `config` (its props), and the section's words are derived from
|
|
312
|
+
the same `config`, so a section cannot declare a word it does not render.
|
|
313
|
+
`band` and `intro` are accepted only by the blocks that take them, and
|
|
314
|
+
`nodeSlots` declares the words a node inside the config reads (a drawing,
|
|
315
|
+
a form). A section no engine block covers is a block of the site's own,
|
|
316
|
+
`defineWebsiteBlock({ surface, heading, slots, Component })`, with the
|
|
317
|
+
same `.section(...)`. Pricing is the one exception: its words follow the
|
|
318
|
+
plans the catalogue publishes, so it is declared with
|
|
319
|
+
`defineWebsiteBlockSection` and `websitePricingSlots`. The
|
|
320
|
+
`website-building-blocks` skill lists every block and what each takes.
|
|
321
|
+
|
|
322
|
+
Underneath, every one of these calls the `defineWebsiteSection` factory
|
|
323
|
+
below. Never build a `WebsiteSectionDefinition` literal by hand: the
|
|
324
|
+
factory parses inputs through the schema (single audited validation
|
|
325
|
+
chokepoint) and types `Component` as taking NO props
|
|
326
|
+
(`WebsiteSectionComponentProps`), since the page mounts each section as
|
|
327
|
+
`<Component />`. A configured block binds its config for you.
|
|
255
328
|
|
|
256
329
|
## Import Origins
|
|
257
330
|
|
|
@@ -263,11 +336,18 @@ JSX composition stays strongly typed.
|
|
|
263
336
|
|
|
264
337
|
```typescript
|
|
265
338
|
*
|
|
266
|
-
*
|
|
267
|
-
*
|
|
268
|
-
*
|
|
269
|
-
*
|
|
270
|
-
*
|
|
339
|
+
* The props a section component receives: NONE. A page renders its sections through
|
|
340
|
+
* `<WebsitePageSections>`, which mounts each one as `<Component />` — nothing composes a section with props. A
|
|
341
|
+
* component that requires one is therefore refused by `defineWebsiteSection` at compile time; before this type, it
|
|
342
|
+
* compiled and then read `undefined` on the live page. A section reads what it
|
|
343
|
+
* shows from its labels (`useWebsiteLabel`), the page runtime (`useWebsiteRuntime`) and module constants; a variant of
|
|
344
|
+
* a shared body or block is BOUND in the definition (`Component: () => <WebsiteHero layout={WebsiteHeroLayout.STAGE} visual={<ProductShot />} />`).
|
|
345
|
+
*/
|
|
346
|
+
export type WebsiteSectionComponentProps = Record<string, never>;
|
|
347
|
+
|
|
348
|
+
/**
|
|
349
|
+
* Input shape consumed by `defineWebsiteSection`. Mirrors `WebsiteSectionDefinition`, with `Component` a component
|
|
350
|
+
* that takes no props (`WebsiteSectionComponentProps`): one that requires a prop is refused at compile time.
|
|
271
351
|
*
|
|
272
352
|
* **String inputs vs. branded inputs**: `sectionRef` and
|
|
273
353
|
* `expectedLabelKeys` accept raw strings as well as already-branded
|
|
@@ -276,7 +356,7 @@ JSX composition stays strongly typed.
|
|
|
276
356
|
* ergonomic drag of forcing every section author to remember to call
|
|
277
357
|
* `WebsiteSectionRefSchema.parse(...)` in their definition.
|
|
278
358
|
*/
|
|
279
|
-
export interface DefineWebsiteSectionInput<TProps> {
|
|
359
|
+
export interface DefineWebsiteSectionInput<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps> {
|
|
280
360
|
sectionRef: WebsiteSectionRef | string;
|
|
281
361
|
category: WebsiteSectionCategory;
|
|
282
362
|
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
@@ -286,32 +366,24 @@ export interface DefineWebsiteSectionInput<TProps> {
|
|
|
286
366
|
/**
|
|
287
367
|
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
288
368
|
* full authoring contract. The factory passes the function through
|
|
289
|
-
* unchanged;
|
|
290
|
-
*
|
|
369
|
+
* unchanged; `renderPageStructuredData()` invokes it on the server with
|
|
370
|
+
* the page's `WebsiteStructuredDataContext`.
|
|
291
371
|
*/
|
|
292
|
-
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
372
|
+
getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
293
373
|
}
|
|
294
374
|
|
|
295
375
|
/**
|
|
296
|
-
* Return shape of `defineWebsiteSection
|
|
297
|
-
*
|
|
298
|
-
* caller-supplied generic prop shape rather than the schema's
|
|
299
|
-
* lowest-common-denominator `ComponentType<unknown>`.
|
|
300
|
-
*
|
|
301
|
-
* **Why this matters**: a consumer's `pageComponent` JSX composes
|
|
302
|
-
* sections like `<HERO_SECTION.Component {...heroProps} />`. Without
|
|
303
|
-
* preserving `TProps`, the spread would be untyped and a renamed prop
|
|
304
|
-
* would silently miss the type system. With `TProps` preserved, the
|
|
305
|
-
* call site fails to compile the moment the prop contract drifts.
|
|
376
|
+
* Return shape of `defineWebsiteSection`. Identical to `WebsiteSectionDefinition` except `Component` is typed as the
|
|
377
|
+
* prop-less component it is, rather than the schema's lowest-common-denominator `ComponentType<any>`.
|
|
306
378
|
*/
|
|
307
|
-
export interface TypedWebsiteSectionDefinition<TProps>
|
|
379
|
+
export interface TypedWebsiteSectionDefinition<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>
|
|
308
380
|
extends Omit<WebsiteSectionDefinition, 'Component' | 'getStructuredData'> {
|
|
309
381
|
Component: ComponentType<TProps>;
|
|
310
|
-
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
382
|
+
getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
311
383
|
}
|
|
312
384
|
|
|
313
385
|
/**
|
|
314
|
-
* `defineWebsiteSection
|
|
386
|
+
* `defineWebsiteSection` — factory that materializes a
|
|
315
387
|
* `WebsiteSectionDefinition` from authored input.
|
|
316
388
|
*
|
|
317
389
|
* **Two responsibilities**, one entry point:
|
|
@@ -319,9 +391,11 @@ export interface TypedWebsiteSectionDefinition<TProps>
|
|
|
319
391
|
* `WebsiteSectionDefinitionSchema` so brand checks, regex
|
|
320
392
|
* validations, and array refinements run at module load time
|
|
321
393
|
* (not at render time, not at build-output time).
|
|
322
|
-
* 2.
|
|
323
|
-
*
|
|
324
|
-
*
|
|
394
|
+
* 2. The props contract — `Component` takes no props, because the
|
|
395
|
+
* page mounts it as `<Component />`. A component that requires a
|
|
396
|
+
* prop fails to compile here rather than reading `undefined` live.
|
|
397
|
+
* The type parameter exists so an explicit type argument equal to
|
|
398
|
+
* `WebsiteSectionComponentProps` stays valid; it cannot be widened.
|
|
325
399
|
*
|
|
326
400
|
* **Why a factory instead of constructing the literal directly**:
|
|
327
401
|
* - Consumers don't have to remember to parse refs / keys
|
|
@@ -329,25 +403,22 @@ export interface TypedWebsiteSectionDefinition<TProps>
|
|
|
329
403
|
* - The schema parse provides a single audited validation chokepoint,
|
|
330
404
|
* and the parsed `expectedLabelKeys` are what `wildo website audit`
|
|
331
405
|
* checks every locale pack against, without re-entering the React graph.
|
|
332
|
-
* - The factory is the documented authoring API
|
|
333
|
-
* `
|
|
406
|
+
* - The factory is the documented authoring API every
|
|
407
|
+
* `website-section-*` skill teaches — keeping the
|
|
334
408
|
* authoring surface narrow lets the framework evolve the
|
|
335
409
|
* internal schema (add fields, refinements) without churning
|
|
336
410
|
* every section definition in every consumer app.
|
|
337
411
|
*
|
|
338
412
|
* @param input section authoring input (see `DefineWebsiteSectionInput`).
|
|
339
|
-
* @returns a `TypedWebsiteSectionDefinition
|
|
340
|
-
* preserved at the precise prop type.
|
|
413
|
+
* @returns a `TypedWebsiteSectionDefinition` whose `Component` takes no props.
|
|
341
414
|
*
|
|
342
415
|
* @example
|
|
343
|
-
*
|
|
344
|
-
*
|
|
345
|
-
*
|
|
346
|
-
* }
|
|
347
|
-
* function HeroSection({ headlineKey, subheadlineKey }: HeroProps) {
|
|
416
|
+
* function HeroSection() {
|
|
417
|
+
* const headline = useWebsiteLabel('headline');
|
|
418
|
+
* const subheadline = useWebsiteLabel('subheadline');
|
|
348
419
|
* // …
|
|
349
420
|
* }
|
|
350
|
-
* export const HERO_SECTION = defineWebsiteSection
|
|
421
|
+
* export const HERO_SECTION = defineWebsiteSection({
|
|
351
422
|
* sectionRef: 'hero',
|
|
352
423
|
* category: WebsiteSectionCategory.HERO,
|
|
353
424
|
* expectedLabelKeys: [
|
|
@@ -357,7 +428,7 @@ export interface TypedWebsiteSectionDefinition<TProps>
|
|
|
357
428
|
* Component: HeroSection,
|
|
358
429
|
* });
|
|
359
430
|
*/
|
|
360
|
-
export function defineWebsiteSection<TProps>(
|
|
431
|
+
export function defineWebsiteSection<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>(
|
|
361
432
|
input: DefineWebsiteSectionInput<TProps>,
|
|
362
433
|
): TypedWebsiteSectionDefinition<TProps> {
|
|
363
434
|
const parsed = WebsiteSectionDefinitionSchema.parse({
|
|
@@ -370,8 +441,8 @@ export function defineWebsiteSection<TProps>(
|
|
|
370
441
|
});
|
|
371
442
|
/**
|
|
372
443
|
* Re-attach `Component` and `getStructuredData` from the original
|
|
373
|
-
* input so
|
|
374
|
-
*
|
|
444
|
+
* input so they keep their declared types — `parsed.Component` is
|
|
445
|
+
* `unknown` per the schema's `z.unknown()` contract.
|
|
375
446
|
*/
|
|
376
447
|
return {
|
|
377
448
|
sectionRef: parsed.sectionRef,
|
|
@@ -388,9 +459,12 @@ export function defineWebsiteSection<TProps>(
|
|
|
388
459
|
|
|
389
460
|
Inside the section's React component, always read labels via
|
|
390
461
|
`useWebsiteLabel('<leaf>')`. The hook composes the leaf with the
|
|
391
|
-
ambient page+section context
|
|
392
|
-
|
|
393
|
-
`expectedLabelKeys
|
|
462
|
+
ambient page+section context into the fully-qualified `WebsiteLabelKey`
|
|
463
|
+
and looks it up in the page's label pack; a missing word logs a warning
|
|
464
|
+
and renders the raw key. It does not consult `expectedLabelKeys`: the
|
|
465
|
+
build checks every locale pack against the keys the section DECLARES
|
|
466
|
+
there, so a key the component reads without declaring it is never
|
|
467
|
+
checked — declare every slot it reads.
|
|
394
468
|
|
|
395
469
|
## Import Origins
|
|
396
470
|
|
|
@@ -412,10 +486,12 @@ ambient page+section context to produce the fully-qualified
|
|
|
412
486
|
* **Author ergonomics**: section authors call
|
|
413
487
|
* `useWebsiteLabel('headline')` from inside their section component
|
|
414
488
|
* without ever typing the page or section ref — the hook reads them
|
|
415
|
-
* from context
|
|
416
|
-
*
|
|
417
|
-
*
|
|
418
|
-
*
|
|
489
|
+
* from the context the page layout and the surrounding `<WebsiteSection>`
|
|
490
|
+
* provide. The keys therefore follow the page a section renders on, while
|
|
491
|
+
* the section's declared `expectedLabelKeys` name one page: a section
|
|
492
|
+
* belongs to one page, and the website plan refuses a section ref
|
|
493
|
+
* declared on two. Share the BLOCK (a component reading slots) between
|
|
494
|
+
* pages, and give each page its own section around it.
|
|
419
495
|
*
|
|
420
496
|
* **Fail-loud diagnostics** for missing keys: returns the composed key
|
|
421
497
|
* itself (visible in the rendered DOM as e.g. `website.landing.hero.headline`)
|
|
@@ -478,8 +554,8 @@ export function useWebsiteLabel(slotPath: string): string {
|
|
|
478
554
|
The framework's `<WebsiteSection>` wrapper is what the page composition
|
|
479
555
|
mounts to host a section's component. It provides
|
|
480
556
|
`WebsiteSectionContext`, renders a semantic `<section>` with
|
|
481
|
-
`data-section-ref` and `data-section-category`, and forwards a11y
|
|
482
|
-
pass-throughs (`
|
|
557
|
+
`data-section-ref` and `data-section-category`, and forwards the a11y
|
|
558
|
+
pass-throughs it declares (`ariaLabel`, `ariaLabelledBy`).
|
|
483
559
|
|
|
484
560
|
## Import Origins
|
|
485
561
|
|
|
@@ -505,10 +581,11 @@ pass-throughs (`aria-labelledby`, `role`, etc.).
|
|
|
505
581
|
* sections without parsing className conventions. Optional
|
|
506
582
|
* `id` prop wires up anchor-link navigation
|
|
507
583
|
* (`<a href="#pricing">`).
|
|
508
|
-
* 3. **Provides a styling seam** —
|
|
509
|
-
*
|
|
510
|
-
*
|
|
511
|
-
*
|
|
584
|
+
* 3. **Provides a styling seam** — the data attributes above are
|
|
585
|
+
* what a site's CSS styles a section by. `className` is forwarded
|
|
586
|
+
* to the `<section>` element only when a site renders
|
|
587
|
+
* `WebsiteSection` itself; `WebsitePageSections`, which wraps every
|
|
588
|
+
* section of a page, passes none.
|
|
512
589
|
*
|
|
513
590
|
* **Why NOT render a `<div>` instead of `<section>`**: marketing
|
|
514
591
|
* pages benefit from semantic landmarks for SEO scoring and
|
|
@@ -517,13 +594,13 @@ pass-throughs (`aria-labelledby`, `role`, etc.).
|
|
|
517
594
|
* a `<div>` with the same data-attribute carries the same metadata
|
|
518
595
|
* but loses the landmark benefit.
|
|
519
596
|
*
|
|
520
|
-
* **Why
|
|
597
|
+
* **Why `as` is NOT a prop**: switching the rendered tag
|
|
521
598
|
* (`<article>` for blog post bodies, `<aside>` for sidebar widgets)
|
|
522
|
-
* is legitimate but rare
|
|
523
|
-
*
|
|
524
|
-
*
|
|
525
|
-
*
|
|
526
|
-
*
|
|
599
|
+
* is legitimate but rare; a section that needs one renders that
|
|
600
|
+
* element inside its body. Keeping `WebsiteSection` rendered as a
|
|
601
|
+
* literal `<section>` removes a rarely-used prop from the
|
|
602
|
+
* section-author API and keeps the SEO landmark contract guaranteed
|
|
603
|
+
* at the type level.
|
|
527
604
|
*/
|
|
528
605
|
export interface WebsiteSectionProps {
|
|
529
606
|
/**
|
|
@@ -550,21 +627,22 @@ export interface WebsiteSectionProps {
|
|
|
550
627
|
*/
|
|
551
628
|
id?: string;
|
|
552
629
|
/**
|
|
553
|
-
* Optional className applied to the `<section>` element
|
|
554
|
-
*
|
|
555
|
-
*
|
|
556
|
-
*
|
|
630
|
+
* Optional className applied to the `<section>` element, for a site
|
|
631
|
+
* that renders `WebsiteSection` itself. `WebsitePageSections` passes
|
|
632
|
+
* none: a page's sections are styled through `[data-section-ref]` /
|
|
633
|
+
* `[data-section-category]`.
|
|
557
634
|
*/
|
|
558
635
|
className?: string;
|
|
559
636
|
/**
|
|
560
|
-
* The section's body
|
|
561
|
-
* (`<HeroSection
|
|
562
|
-
* sections that don't justify a
|
|
637
|
+
* The section's body: the section's own component, which takes no
|
|
638
|
+
* props (`<HeroSection />`; see `WebsiteSectionComponentProps`). May be
|
|
639
|
+
* plain JSX for one-off sections that don't justify a
|
|
640
|
+
* `defineWebsiteSection` factory call.
|
|
563
641
|
*/
|
|
564
642
|
children: ReactNode;
|
|
565
643
|
/**
|
|
566
|
-
* Pass-through `aria
|
|
567
|
-
* to refine their landmark semantics (eg. `aria-label="Featured
|
|
644
|
+
* Pass-through `aria-label` / `aria-labelledby` (the only two it
|
|
645
|
+
* forwards) for sections that need to refine their landmark semantics (eg. `aria-label="Featured
|
|
568
646
|
* customer logos"` on a logo wall).
|
|
569
647
|
*/
|
|
570
648
|
ariaLabel?: string;
|
|
@@ -619,11 +697,15 @@ WebsiteSection.displayName = 'WebsiteSection';
|
|
|
619
697
|
```
|
|
620
698
|
|
|
621
699
|
|
|
622
|
-
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no
|
|
623
|
-
>
|
|
624
|
-
> `
|
|
625
|
-
>
|
|
626
|
-
>
|
|
700
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no Contact
|
|
701
|
+
> block**. It ships the form, `InboundContactForm`, and the block that argues one thing beside
|
|
702
|
+
> a visual, `websiteFeatureRowBlock`. A Contact section is that block, configured, with the
|
|
703
|
+
> form as its `visual`: the copy (eyebrow, heading, body, the points that say what happens to
|
|
704
|
+
> the visitor's details) on one side, the form in a card on the other. The block's words are
|
|
705
|
+
> derived from its `config`; the form's words, which the block cannot know, are declared as
|
|
706
|
+
> the section's `nodeSlots`. This skill documents that pattern for a contact / lead-capture
|
|
707
|
+
> form that feeds the `InboundContact` CREATE flow with full marketing-metadata propagation.
|
|
708
|
+
> How blocks are configured in general is `website-building-blocks`.
|
|
627
709
|
|
|
628
710
|
## Overview
|
|
629
711
|
|
|
@@ -662,7 +744,9 @@ What the category does — and, for structured data, does not — decide:
|
|
|
662
744
|
|
|
663
745
|
| Surface | Glob (relative to app root) |
|
|
664
746
|
|---|---|
|
|
665
|
-
|
|
|
747
|
+
| The form card, its slot constant, the configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
|
|
748
|
+
| The site's config builder for a feature row (its points' icons, its layout) | `website/src/sections/kit/**` |
|
|
749
|
+
| The site's one anonymous-session client | `website/src/anonymous-session.client.ts` |
|
|
666
750
|
| Page composition | `website/src/pages-impl/contact.page.tsx` |
|
|
667
751
|
| Label pack (per locale) | `website/src/i18n/<locale>.json` |
|
|
668
752
|
|
|
@@ -673,7 +757,7 @@ What the category does — and, for structured data, does not — decide:
|
|
|
673
757
|
service, no manual email forwarding).
|
|
674
758
|
- The marketing site needs the cross-app anonymous-session UUID +
|
|
675
759
|
first-touch attribution to land on the resulting `InboundContact`
|
|
676
|
-
row
|
|
760
|
+
row.
|
|
677
761
|
|
|
678
762
|
## When NOT to Use
|
|
679
763
|
|
|
@@ -708,25 +792,43 @@ visible misconfiguration message when it is absent.
|
|
|
708
792
|
`InboundContactFormLabels` is required — field labels, the submit and
|
|
709
793
|
sending states, the success, error and anti-spam refusal notes, and the
|
|
710
794
|
sentence shown beside an invalid email address. Resolve each one with
|
|
711
|
-
`useWebsiteLabel` and list its
|
|
712
|
-
|
|
713
|
-
|
|
795
|
+
`useWebsiteLabel` and list its slot in one module constant of the form's
|
|
796
|
+
words (with `unavailable`, the misconfiguration message of Step 2). Leaving
|
|
797
|
+
a label out is a type error in your section, and a key your pack does not
|
|
798
|
+
carry renders as the key itself, so a missing label is visible rather than
|
|
714
799
|
silently English.
|
|
715
800
|
|
|
716
801
|
`marketingConsentLabel` is a separate, unticked checkbox. Word it as the
|
|
717
802
|
purpose it grants ("Keep me updated about news and offers"), never as a
|
|
718
803
|
condition of sending the form.
|
|
719
804
|
|
|
720
|
-
### Step 4:
|
|
805
|
+
### Step 4: Configure the feature row with the form as its visual
|
|
806
|
+
|
|
807
|
+
The section is `websiteFeatureRowBlock.section({ pageRef, sectionRef, category:
|
|
808
|
+
WebsiteSectionCategory.CONTACT, band, config, nodeSlots })`:
|
|
809
|
+
|
|
810
|
+
- `config` is the feature row's props (`WebsiteFeatureRowProps`): `visual` is the form card of Steps 2–3 (a
|
|
811
|
+
component taking no props, so it reads its own words); `points` (each with a `ref` and an `icon`) say what
|
|
812
|
+
happens to the visitor's details, in the visitor's terms; `layout` (`WebsiteFeatureRowLayout.VISUAL_END` puts the
|
|
813
|
+
form after the copy, `VISUAL_START` before it); `eyebrow` and `body` (both shown by default); `link` (rare here).
|
|
814
|
+
A site config builder that fixes its icons and its numbering of points keeps the section one call.
|
|
815
|
+
- `band` — the feature row stands on a band the section draws (`{ tone: WebsiteSurfaceTone.TINTED }` sets the form
|
|
816
|
+
apart from the hero).
|
|
817
|
+
- No `intro`: the feature row carries its own heading, and the block's type refuses a second.
|
|
818
|
+
- `nodeSlots` — the form's words constant of Step 3. The block derives its own words from the config (`eyebrow`,
|
|
819
|
+
`heading`, `body`, each point's `title` and `body`) and does not know what the form reads, so its words reach
|
|
820
|
+
the section only through `nodeSlots`. Two words with one slot are refused when the section is defined.
|
|
821
|
+
|
|
822
|
+
### Step 5: Compose into the page
|
|
721
823
|
|
|
722
824
|
The page lives at `/contact` (typically) with this section as the
|
|
723
|
-
|
|
825
|
+
primary band after the hero.
|
|
724
826
|
|
|
725
827
|
**Stop** after the contact form mounts in dev and submits an
|
|
726
|
-
`InboundContact` through the shared client; if the
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
828
|
+
`InboundContact` through the shared client; if the label-pack audit
|
|
829
|
+
fails, **return to Step 3** — every one of the form's labels is a slot
|
|
830
|
+
in `nodeSlots` and a leaf of your section's pack, and a missing leaf
|
|
831
|
+
renders as the key string.
|
|
730
832
|
|
|
731
833
|
## Structured data (AEO)
|
|
732
834
|
|
|
@@ -759,27 +861,34 @@ Contact-section authoring contributes the engagement-routing sentence in
|
|
|
759
861
|
|
|
760
862
|
## Worked Example
|
|
761
863
|
|
|
762
|
-
|
|
864
|
+
The form card is a component of the site's own that reads every word the engine's form needs, and the section's
|
|
865
|
+
`nodeSlots` lists exactly those words:
|
|
866
|
+
|
|
867
|
+
<!-- TIER C WAIVER: the anchored contact section below shows the configured block, but not the form card or its words constant, which live beside it unanchored. This block shows what Steps 2–3 and the Verification below reference: the shared `WebsiteAnonymousSessionClient`, every `InboundContactFormLabels` entry resolved with `useWebsiteLabel`, the `apiOrigin` guard with its visible message, and the one constant of the form's words that becomes `nodeSlots`. Keep it inline until the form card is deliberately anchored. -->
|
|
763
868
|
```tsx
|
|
764
869
|
// website/src/sections/<page>.sections.tsx
|
|
765
870
|
import type { ReactNode } from 'react';
|
|
766
871
|
import {
|
|
767
|
-
defineWebsiteSection,
|
|
768
872
|
InboundContactForm,
|
|
873
|
+
type InboundContactFormLabels,
|
|
769
874
|
useWebsiteLabel,
|
|
770
875
|
useWebsiteRuntime,
|
|
771
|
-
WebsiteHeading,
|
|
772
|
-
WebsiteSectionCategory,
|
|
773
876
|
WebsiteText,
|
|
774
|
-
|
|
877
|
+
WebsiteTextVariant,
|
|
775
878
|
} from '@wildo-ai/saas-website';
|
|
776
879
|
|
|
777
880
|
import { getAnonymousSessionClient } from '../anonymous-session.client';
|
|
778
881
|
|
|
779
|
-
|
|
882
|
+
/** The form's words: every one the engine form shows, plus the misconfiguration message. The section's `nodeSlots`. */
|
|
883
|
+
const LEAD_FORM_SLOTS = [
|
|
884
|
+
'field.email-label', 'field.first-name-label', 'field.last-name-label', 'field.phone-label',
|
|
885
|
+
'field.marketing-consent-label', 'field.email-invalid-note', 'submit', 'submitting',
|
|
886
|
+
'success-note', 'error-note', 'challenge-refused-note', 'unavailable',
|
|
887
|
+
] as const;
|
|
780
888
|
|
|
781
|
-
function
|
|
889
|
+
function LeadFormCard(): ReactNode {
|
|
782
890
|
const { apiOrigin } = useWebsiteRuntime();
|
|
891
|
+
const unavailable = useWebsiteLabel('unavailable');
|
|
783
892
|
const labels: InboundContactFormLabels = {
|
|
784
893
|
emailLabel: useWebsiteLabel('field.email-label'),
|
|
785
894
|
firstNameLabel: useWebsiteLabel('field.first-name-label'),
|
|
@@ -793,44 +902,124 @@ function ContactFormBody(): ReactNode {
|
|
|
793
902
|
challengeRefusedMessage: useWebsiteLabel('challenge-refused-note'),
|
|
794
903
|
invalidEmailMessage: useWebsiteLabel('field.email-invalid-note'),
|
|
795
904
|
};
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
<div className="contact">
|
|
801
|
-
<WebsiteHeading level={2}>{heading}</WebsiteHeading>
|
|
802
|
-
{apiOrigin ? (
|
|
803
|
-
<InboundContactForm client={getAnonymousSessionClient(apiOrigin)} labels={labels} />
|
|
804
|
-
) : (
|
|
805
|
-
<WebsiteText>{unavailable}</WebsiteText>
|
|
806
|
-
)}
|
|
807
|
-
</div>
|
|
905
|
+
return apiOrigin ? (
|
|
906
|
+
<InboundContactForm client={getAnonymousSessionClient(apiOrigin)} labels={labels} />
|
|
907
|
+
) : (
|
|
908
|
+
<WebsiteText variant={WebsiteTextVariant.CAPTION}>{unavailable}</WebsiteText>
|
|
808
909
|
);
|
|
809
910
|
}
|
|
911
|
+
```
|
|
912
|
+
|
|
913
|
+
The framework's reference application then configures the section: the feature row on a tinted band, its config
|
|
914
|
+
from the site's feature-row builder with the form card as the visual and three points, and the form's words as
|
|
915
|
+
`nodeSlots`:
|
|
810
916
|
|
|
811
|
-
|
|
917
|
+
|
|
918
|
+
## Usage Example
|
|
919
|
+
|
|
920
|
+
```tsx
|
|
921
|
+
export const CONTACT_FORM_SECTION = websiteFeatureRowBlock.section({
|
|
922
|
+
pageRef: PAGE_REF,
|
|
812
923
|
sectionRef: 'contact-form',
|
|
813
924
|
category: WebsiteSectionCategory.CONTACT,
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
'field.marketing-consent-label', 'field.email-invalid-note', 'submit', 'submitting',
|
|
818
|
-
'success-note', 'error-note', 'challenge-refused-note',
|
|
819
|
-
].map(key),
|
|
820
|
-
Component: ContactFormBody,
|
|
925
|
+
band: { tone: WebsiteSurfaceTone.TINTED },
|
|
926
|
+
config: featureRowConfig({ visual: <LeadFormCard />, bullets: 3, icons: [WtIcon.MAIL, WtIcon.CHECK_CIRCLE, WtIcon.ARROW_RIGHT] }),
|
|
927
|
+
nodeSlots: LEAD_FORM_SLOTS,
|
|
821
928
|
});
|
|
822
929
|
```
|
|
823
930
|
|
|
931
|
+
`featureRowConfig` is the site's builder for every feature row: each point's icon, the layout from `reverse`, and an
|
|
932
|
+
optional link:
|
|
933
|
+
|
|
934
|
+
|
|
935
|
+
## Usage Example
|
|
936
|
+
|
|
937
|
+
```tsx
|
|
938
|
+
/** The hero's actions: the application's sign-up, and a page of this site. */
|
|
939
|
+
const heroActions = (secondaryRoutePath: string) => ({
|
|
940
|
+
primaryAction: { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP } as const,
|
|
941
|
+
secondaryAction: { kind: WebsiteMenuLinkKind.PAGE, routePath: secondaryRoutePath } as const,
|
|
942
|
+
});
|
|
943
|
+
|
|
944
|
+
/** The brand's three forward-leaning stripes, the site's motif behind its hero and its closing call to action. */
|
|
945
|
+
function Stripes({ className }: { className: string }): ReactNode {
|
|
946
|
+
return (
|
|
947
|
+
<span className={className}>
|
|
948
|
+
<i />
|
|
949
|
+
<i />
|
|
950
|
+
<i />
|
|
951
|
+
</span>
|
|
952
|
+
);
|
|
953
|
+
}
|
|
954
|
+
|
|
955
|
+
/**
|
|
956
|
+
* A page's opening: the engine's hero with this site's choices, the glow-over-grid surface, the stripes motif, and
|
|
957
|
+
* the application's sign-up as the primary action. `WebsiteHeroLayout.STAGE` is the home page's product stage, `SPLIT`
|
|
958
|
+
* puts the visual beside the copy; without a visual the engine makes it a compact opening.
|
|
959
|
+
*/
|
|
960
|
+
export function heroConfig({
|
|
961
|
+
secondaryRoutePath,
|
|
962
|
+
visual,
|
|
963
|
+
note = false,
|
|
964
|
+
layout = WebsiteHeroLayout.SPLIT,
|
|
965
|
+
}: {
|
|
966
|
+
secondaryRoutePath: string;
|
|
967
|
+
visual?: ReactNode;
|
|
968
|
+
note?: boolean;
|
|
969
|
+
layout?: WebsiteHeroLayout;
|
|
970
|
+
}): WebsiteHeroProps {
|
|
971
|
+
return {
|
|
972
|
+
layout,
|
|
973
|
+
surface: WebsiteHeroSurface.GLOW_GRID,
|
|
974
|
+
decoration: <Stripes className="brand-stripes" />,
|
|
975
|
+
note,
|
|
976
|
+
...(visual === undefined ? {} : { visual }),
|
|
977
|
+
...heroActions(secondaryRoutePath),
|
|
978
|
+
};
|
|
979
|
+
}
|
|
980
|
+
```
|
|
981
|
+
|
|
982
|
+
## Usage Example
|
|
983
|
+
|
|
984
|
+
```tsx
|
|
985
|
+
/**
|
|
986
|
+
* The copy on one side — what it is, why it matters, its points — and the product doing it on the other. `reverse`
|
|
987
|
+
* swaps the sides, so consecutive rows zig-zag. Each point carries its glyph, a check unless one is given.
|
|
988
|
+
*/
|
|
989
|
+
export function featureRowConfig({
|
|
990
|
+
visual,
|
|
991
|
+
bullets = 3,
|
|
992
|
+
icons,
|
|
993
|
+
linkRoutePath,
|
|
994
|
+
reverse = false,
|
|
995
|
+
}: {
|
|
996
|
+
visual: ReactNode;
|
|
997
|
+
bullets?: number;
|
|
998
|
+
icons?: readonly WtIcon[];
|
|
999
|
+
linkRoutePath?: string;
|
|
1000
|
+
reverse?: boolean;
|
|
1001
|
+
}): WebsiteFeatureRowProps {
|
|
1002
|
+
return {
|
|
1003
|
+
points: indexes(bullets).map((index) => ({ ref: `point${index}`, icon: <Icon name={icons?.[index - 1] ?? WtIcon.CHECK} /> })),
|
|
1004
|
+
visual,
|
|
1005
|
+
layout: reverse ? WebsiteFeatureRowLayout.VISUAL_START : WebsiteFeatureRowLayout.VISUAL_END,
|
|
1006
|
+
...(linkRoutePath === undefined ? {} : { link: { kind: WebsiteMenuLinkKind.PAGE, routePath: linkRoutePath } as const }),
|
|
1007
|
+
};
|
|
1008
|
+
}
|
|
1009
|
+
```
|
|
1010
|
+
|
|
1011
|
+
The section holds no heading markup, no band markup and no list of the copy's words: the feature row renders the
|
|
1012
|
+
copy and derives its words from the config; only the form's words, which no block can know, are listed, once.
|
|
1013
|
+
|
|
824
1014
|
## Structured-data contract
|
|
825
1015
|
|
|
826
1016
|
`CONTACT` does not own a dedicated JSON-LD vocabulary at the section
|
|
827
1017
|
level. Page-level emission of `Organization.contactPoint` (with
|
|
828
1018
|
`contactType`, `email`, `availableLanguage`) is the standard
|
|
829
|
-
companion —
|
|
830
|
-
not here.
|
|
1019
|
+
companion — a page-level payload, not this section's.
|
|
831
1020
|
|
|
832
1021
|
Leave the section's `getStructuredData` undefined — emit
|
|
833
|
-
`Organization.contactPoint`
|
|
1022
|
+
`Organization.contactPoint` as a page-level payload instead (see
|
|
834
1023
|
"Catalog integration" below).
|
|
835
1024
|
|
|
836
1025
|
## Catalog integration (AEO)
|
|
@@ -841,13 +1030,13 @@ is a property of the brand `Organization` entity — emitting a
|
|
|
841
1030
|
separate `ContactPoint` payload from this section would split the
|
|
842
1031
|
identity that the AI assistant tries to consolidate.
|
|
843
1032
|
|
|
844
|
-
The right pattern: the page
|
|
845
|
-
|
|
846
|
-
`
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
`@id` deduplication folds duplicate
|
|
850
|
-
canonical block.
|
|
1033
|
+
The right pattern: the page's own payloads — the route's
|
|
1034
|
+
`pagePayloads`, returned for the audit from
|
|
1035
|
+
`structured-data/page-payloads.ts` — carry the `Organization` once,
|
|
1036
|
+
with a `contactPoint[]` field aggregating every contact channel the
|
|
1037
|
+
page surfaces. The contact section's JSX renders the same data; the
|
|
1038
|
+
JSON-LD lives at the page level so `@id` deduplication folds duplicate
|
|
1039
|
+
contact info into a single canonical block.
|
|
851
1040
|
|
|
852
1041
|
The installed `ORGANIZATION_CATALOG_ENTRY` contract hosts `contactPoint`
|
|
853
1042
|
and lists it in
|
|
@@ -857,9 +1046,8 @@ when a top-level `Organization` payload lacks it).
|
|
|
857
1046
|
**What earns its place in this section's emission**:
|
|
858
1047
|
|
|
859
1048
|
- Nothing — leave `getStructuredData` undefined.
|
|
860
|
-
- The contact data informs the page
|
|
861
|
-
|
|
862
|
-
emission.
|
|
1049
|
+
- The contact data informs the page-level `Organization` payload
|
|
1050
|
+
via `contactPoint[]`, NOT a separate section-level emission.
|
|
863
1051
|
|
|
864
1052
|
**What is NOT in this emission**:
|
|
865
1053
|
|
|
@@ -877,11 +1065,14 @@ when a top-level `Organization` payload lacks it).
|
|
|
877
1065
|
| Invariant | Command |
|
|
878
1066
|
|---|---|
|
|
879
1067
|
| Section does NOT emit standalone ContactPoint | `rg -n "'ContactPoint'" website/src/sections/<page>.sections.tsx` (must return 0) |
|
|
880
|
-
| Page
|
|
1068
|
+
| Page emits Organization with contactPoint | `rg -n "contactPoint" website/src/structured-data/page-payloads.ts` (must return ≥1 on contact-bearing pages; the route passes the same payloads as `pagePayloads`) |
|
|
881
1069
|
|
|
882
1070
|
## References
|
|
883
1071
|
|
|
884
1072
|
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
|
|
1073
|
+
- `../website-building-blocks/references/framework-website-blocks-api.md` — source-backed `defineWebsiteBlock`
|
|
1074
|
+
(what `section(...)` takes, `nodeSlots`), `websiteFeatureRowBlock`, the `WebsiteFeatureRow` props and their
|
|
1075
|
+
words, the band and the stylesheet hooks.
|
|
885
1076
|
|
|
886
1077
|
## Verification
|
|
887
1078
|
|
|
@@ -895,16 +1086,38 @@ when a top-level `Organization` payload lacks it).
|
|
|
895
1086
|
it is essential; its marketing opt-in is an unticked checkbox.
|
|
896
1087
|
- [ ] All visible strings via `useWebsiteLabel`.
|
|
897
1088
|
- [ ] Every `InboundContactFormLabels` entry is passed, resolved with
|
|
898
|
-
`useWebsiteLabel`, and listed in `
|
|
1089
|
+
`useWebsiteLabel`, and listed in the form's words constant passed as `nodeSlots`.
|
|
1090
|
+
- [ ] The section is `websiteFeatureRowBlock.section(...)` with the form card as `config.visual` — no
|
|
1091
|
+
`defineWebsiteSection` with `expectedLabelKeys`, no hand-built band, intro or heading around the form.
|
|
1092
|
+
- [ ] No word of the feature row's copy is listed by hand: the section derives them from the config.
|
|
899
1093
|
|
|
900
1094
|
### Grep invariants
|
|
901
1095
|
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
1096
|
+
`npx astro check` in `website/` must pass: the block's `section(...)` type refuses an `intro` for the feature row.
|
|
1097
|
+
Then, from the app root:
|
|
1098
|
+
|
|
1099
|
+
```bash
|
|
1100
|
+
# Engine form used, no ad-hoc fetch (must return >= 1)
|
|
1101
|
+
rg -n "<InboundContactForm\b" website/src/sections
|
|
1102
|
+
|
|
1103
|
+
# The contact section is the configured feature row (must return >= 1)
|
|
1104
|
+
rg -n "websiteFeatureRowBlock\.section\(" website/src/sections/<page>.sections.tsx
|
|
1105
|
+
|
|
1106
|
+
# The form's words reach the section (must return >= 1 in the contact section)
|
|
1107
|
+
rg -n "nodeSlots:" website/src/sections/<page>.sections.tsx
|
|
1108
|
+
|
|
1109
|
+
# No section declared by hand with its keys (must return empty)
|
|
1110
|
+
rg -n "defineWebsiteSection\(|expectedLabelKeys" website/src/sections/<page>.sections.tsx
|
|
1111
|
+
|
|
1112
|
+
# No bare fetch (must return empty)
|
|
1113
|
+
rg -n "fetch\('/api/inbound-contacts" website/src/sections/<page>.sections.tsx
|
|
1114
|
+
|
|
1115
|
+
# Form not gated on optional consent (must return empty)
|
|
1116
|
+
rg -n "WebsiteConsentGate purpose" website/src/sections/<page>.sections.tsx
|
|
1117
|
+
|
|
1118
|
+
# Every form label passed (must return empty; the full type makes an omitted label a type error)
|
|
1119
|
+
rg -n "Partial<InboundContactFormLabels>" website/src/sections/
|
|
1120
|
+
```
|
|
908
1121
|
|
|
909
1122
|
## Common Rationalizations
|
|
910
1123
|
|
|
@@ -913,7 +1126,9 @@ when a top-level `Organization` payload lacks it).
|
|
|
913
1126
|
| "I'll call `fetch('/api/inbound-contacts')` directly" | Bypasses anonymous-session UUID + first-touch metadata propagation; the resulting `InboundContact` row is orphaned from the visitor's session. |
|
|
914
1127
|
| "Gate the form behind the consent banner to be safe" | Sending a form the visitor chose to fill in is essential. Gating it on optional consent blocks every visitor who declined analytics from contacting you. |
|
|
915
1128
|
| "I'll pass the labels I care about; the form has sensible defaults" | It has none. Every `InboundContactFormLabels` entry is required, so an omission does not compile, and the form would otherwise show English to every locale with no key anyone could find. |
|
|
916
|
-
| "I'll
|
|
1129
|
+
| "I'll put the form under a `WebsiteBand` and a `WebsiteSectionIntro` in a section of my own" | Then the copy's words are listed by hand apart from what renders. Configure `websiteFeatureRowBlock.section(...)` with the form as its `visual`: the copy's words follow the config, and only the form's are listed, as `nodeSlots`. |
|
|
1130
|
+
| "The form's words are the block's business, I'll leave `nodeSlots` out" | The block does not know what a node inside its config reads. Leave them out and the label audit never checks them: a locale missing one shows its raw key on the form. |
|
|
1131
|
+
| "I'll hard-redirect to `/thank-you` on success" | The form confirms in place: its `successMessage` replaces the form inside the same section, and its `onSubmitted` callback is where a completion event belongs. A redirect needs a page of its own, with its own words in every locale, to say what the form already says. |
|
|
917
1132
|
|
|
918
1133
|
## Red Flags
|
|
919
1134
|
|
|
@@ -925,6 +1140,11 @@ when a top-level `Organization` payload lacks it).
|
|
|
925
1140
|
- A "contact form" section that POSTs into a third-party service
|
|
926
1141
|
(Mailchimp, Hubspot) — out of scope for this category. Build a
|
|
927
1142
|
bespoke section using `website-factory-advanced`.
|
|
1143
|
+
- A contact section declared with `defineWebsiteSection` and a hand-written `expectedLabelKeys` list, or a form
|
|
1144
|
+
wrapped in a hand-built band and intro — catch with the "No section declared by hand" and configured-feature-row
|
|
1145
|
+
greps above.
|
|
1146
|
+
- A form word read in the card but missing from `nodeSlots` — the audit never asks for it, and a locale without it
|
|
1147
|
+
shows the key. Compare the card's `useWebsiteLabel` calls with the constant.
|
|
928
1148
|
- A section that builds its form labels as a `Partial` or spreads a
|
|
929
1149
|
set of default words into them — the form has no defaults, and a
|
|
930
1150
|
fallback there is English in every locale. Catch it with the
|
|
@@ -942,3 +1162,6 @@ when a top-level `Organization` payload lacks it).
|
|
|
942
1162
|
the form's session UUID rides on.
|
|
943
1163
|
- `website-page-authoring` — composing the contact section into
|
|
944
1164
|
`/contact`.
|
|
1165
|
+
- `website-building-blocks` — how the engine's blocks are configured as sections, derive their words and take
|
|
1166
|
+
`nodeSlots` for a node's words.
|
|
1167
|
+
- `website-section-feature-detail` — the feature row this section configures, for arguing one capability.
|