@wildo-ai/framework-knowledge 1.1.10 → 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/derived-artifacts.md +4 -2
- 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 +459 -76
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.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.d.ts.map +1 -1
- 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/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +5 -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 +11 -6
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -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 +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +4 -1
- 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 +3 -3
- 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 +3 -2
- 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 +2 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
- 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 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.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.compliance-document-candidate/playbook.definition.d.ts.map +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 +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.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/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- 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 +6 -4
- 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.map +1 -1
- 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.map +1 -1
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +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.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.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.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.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 +8 -2
- 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 +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.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-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.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.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +4 -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 +350 -23
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +6 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +248 -9
- 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 +3 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +12 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +13 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +4 -3
- 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 +33 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +20 -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 +97 -23
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +30 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- 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 +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +2 -2
- 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/playbook.json +1 -1
- 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 +3 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -1
- 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 +4 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +5 -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.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +238 -8
- 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.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.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -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.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.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +52 -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.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 +16 -0
- 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.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +75 -13
- 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/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.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.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 +7 -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.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.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 +18 -16
- 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 +10 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- 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 +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +89 -51
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +9 -6
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +66 -4
- 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 +18 -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 +58 -6
- 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 +58 -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.organization-defaults.md +6 -6
- 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 +34 -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 +51 -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 +38 -9
- 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 +17 -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 +98 -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 +21 -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 +19 -4
- 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.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 +44 -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.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 +544 -32
- 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 +73 -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 +75 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- 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 +4 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +32 -4
- 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 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- 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 +2411 -139
- package/dist/knowledge/registries/playbooks.json +51 -30
- package/dist/knowledge/registries/source-tags.json +8500 -4768
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/skills/INDEX.md +60 -33
- 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-database-migrations/SKILL.md +27 -9
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +6 -6
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +124 -3
- 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 +35 -1
- 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 +3 -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 +127 -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/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 +134 -33
- 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 +57 -28
- 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 +17 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- 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/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 +2 -0
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +11 -3
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- 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 +5 -3
- 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 +14 -0
- 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 +46 -5
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +7 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- 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 +281 -20
- 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 +91 -5
- 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 +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +27 -17
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +136 -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 +1 -1
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +4 -1
- 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 +107 -2
- 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/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +9 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +9 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +2 -1
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +2 -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 +150 -4
- 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 +50 -27
- 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/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 +1 -1
- 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 +9 -5
- 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 +26 -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 +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- 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 +132 -55
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +49 -4
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +58 -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 +102 -4
- 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 +6 -0
- 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 +18 -0
- 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 +60 -3
- 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 +1 -1
- 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 +195 -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 +176 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +88 -50
- 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 +71 -12
- 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 +3 -1
- 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 +26 -10
- 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 +9 -7
- 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 +79 -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 +32 -4
- 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 +116 -66
- 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 +203 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +155 -76
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +19 -17
- 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 +168 -58
- 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/references/data-seeding-mode-picker.md +16 -1
- 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 +141 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +66 -4
- 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/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- 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 +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +5 -0
- 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 +11 -4
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- 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 +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +251 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1064 -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 +39 -18
- 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 +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- 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 +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- 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 +255 -397
- 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 +28 -6
- 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 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- 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 +24 -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 +48 -28
- 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 +561 -302
- 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 +647 -274
- 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 +572 -264
- 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 +603 -332
- 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 +549 -378
- 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 +739 -315
- 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 +183 -67
- 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 +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- 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 +16442 -8572
- 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-hero
|
|
3
|
-
description: Author a Hero section
|
|
3
|
+
description: Author a Hero section — the top-of-page first-impression band (eyebrow / headline / subheadline / primary+secondary action / visual) — by configuring the engine's `websiteHeroBlock` (`websiteHeroBlock.section({ category: WebsiteSectionCategory.HERO, config })`), its words derived from the config, with the page's `Organization` / `WebSite` JSON-LD. Use when the user says "add a hero section", "write the landing hero", "compose a hero with headline / subheadline / CTA", or "customize the hero layout".
|
|
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,20 +697,28 @@ WebsiteSection.displayName = 'WebsiteSection';
|
|
|
619
697
|
```
|
|
620
698
|
|
|
621
699
|
|
|
622
|
-
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships
|
|
623
|
-
>
|
|
624
|
-
>
|
|
625
|
-
>
|
|
626
|
-
>
|
|
627
|
-
> JSON-LD
|
|
700
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships the hero as a
|
|
701
|
+
> configurable block, `websiteHeroBlock`: its renderer (`WebsiteHero`) owns the layout, the one
|
|
702
|
+
> `<h1>`, the actions, the responsive behaviour, the entrance and the look, all read from the
|
|
703
|
+
> site's theme, and its words are derived from the same configuration it renders. A hero section
|
|
704
|
+
> is `websiteHeroBlock.section({ pageRef, sectionRef, category, config })`. This skill covers what
|
|
705
|
+
> a hero must SAY and CARRY — its category, its words, its `Organization` / `WebSite` JSON-LD and
|
|
706
|
+
> its `llms.txt` contribution — and which configuration says it. How blocks are configured in
|
|
707
|
+
> general is `website-building-blocks`.
|
|
628
708
|
|
|
629
709
|
## Overview
|
|
630
710
|
|
|
631
711
|
The Hero is the first section of a landing page (or the topmost
|
|
632
712
|
section of any standalone marketing page). It carries the page's
|
|
633
713
|
positioning promise through a lead headline and concise supporting context.
|
|
634
|
-
|
|
635
|
-
|
|
714
|
+
Only the headline is mandatory. The eyebrow, the subheadline, the actions,
|
|
715
|
+
the visual and the note are deliberate configuration choices, not decoration:
|
|
716
|
+
the hero drops the eyebrow when `eyebrow` is false and the subheadline
|
|
717
|
+
when `lede` is false, renders an action only when it is given, falls back to a
|
|
718
|
+
compact, copy-only opening when no `visual` is given, and renders the note
|
|
719
|
+
only when `note` is set — and the section's words follow, so a word the hero
|
|
720
|
+
does not show is not declared. Honor a description-only or deferred-hero brief
|
|
721
|
+
with that configuration rather than with invented copy.
|
|
636
722
|
|
|
637
723
|
Before writing the homepage hero, read the installed
|
|
638
724
|
[homepage content and art-direction workflow](../website-page-authoring/references/homepage-content-and-art-direction.md).
|
|
@@ -641,7 +727,7 @@ headline or image while making a focused refinement. Intentional phrase breaks
|
|
|
641
727
|
must still allow natural wrapping at narrow widths and in supported locales.
|
|
642
728
|
|
|
643
729
|
In the framework's mental model, a Hero is **not a layout shape** —
|
|
644
|
-
it's a `
|
|
730
|
+
it's a section definition (the one `websiteHeroBlock.section(...)` returns) tagged with
|
|
645
731
|
`WebsiteSectionCategory.HERO`. The category drives two non-render
|
|
646
732
|
concerns — skill mapping and analytics labelling — and does not
|
|
647
733
|
control structured data, which is listed first because a hero usually
|
|
@@ -662,15 +748,17 @@ carries it:
|
|
|
662
748
|
|
|
663
749
|
## App Paths
|
|
664
750
|
|
|
665
|
-
The installed `@wildo-ai/saas-website` package provides the contract
|
|
666
|
-
|
|
751
|
+
The installed `@wildo-ai/saas-website` package provides the contract and the
|
|
752
|
+
configured block, `websiteHeroBlock`. The hero section is authored inside the
|
|
753
|
+
application's website module:
|
|
667
754
|
|
|
668
755
|
| Surface | Glob (relative to app root) |
|
|
669
756
|
|---|---|
|
|
670
|
-
|
|
|
671
|
-
|
|
|
757
|
+
| The configured section (`websiteHeroBlock.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) |
|
|
758
|
+
| The site's hero config builder (its surface, motif and primary action, fixed once) and section factory | `website/src/sections/kit/**` |
|
|
672
759
|
| Page composition | `website/src/pages-impl/<page-ref>.page.tsx` (calls `defineWebsitePageManifest`) |
|
|
673
760
|
| Label pack (per locale) | `website/src/i18n/<locale>.json` |
|
|
761
|
+
| The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
|
|
674
762
|
|
|
675
763
|
## When to Use
|
|
676
764
|
|
|
@@ -684,80 +772,141 @@ Hero is authored inside the consumer's application website module:
|
|
|
684
772
|
- Mid-page conversion band → `website-section-cta`.
|
|
685
773
|
- Pre-footer last-impression band → `website-section-footer-cta`.
|
|
686
774
|
- Single-feature deep-dive → `website-section-feature-detail`.
|
|
687
|
-
-
|
|
688
|
-
|
|
689
|
-
|
|
775
|
+
- The hero's colours, type, spacing or corners → `website-theme-authoring`;
|
|
776
|
+
the block reads them from the theme.
|
|
777
|
+
- An animated entrance → NOT a reason to leave this skill: the hero
|
|
778
|
+
plays the page's signature entrance itself, and its config's `motion`
|
|
779
|
+
takes the `website-motion-design` vocabulary (Step 5). A drawn product
|
|
780
|
+
demo plays in the engine's demo frame (Step 6). Only a bespoke canvas /
|
|
781
|
+
WebGL piece with its own React hooks goes to `website-factory-advanced`
|
|
782
|
+
(raw React escape hatch; loses the schema-validated authoring chokepoint).
|
|
690
783
|
|
|
691
784
|
## Workflow
|
|
692
785
|
|
|
693
|
-
### Step 1:
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
`
|
|
703
|
-
`
|
|
704
|
-
|
|
705
|
-
`
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
786
|
+
### Step 1: Choose the hero's configuration
|
|
787
|
+
|
|
788
|
+
The hero's config is `WebsiteHeroProps`: its choices are values, never label keys.
|
|
789
|
+
|
|
790
|
+
| Config | Values | Choose |
|
|
791
|
+
|---|---|---|
|
|
792
|
+
| `layout` | `WebsiteHeroLayout.STAGE` · `SPLIT` (default) · `COMPACT` | `STAGE` for the home page's product stage (copy centred above a full-width visual); `SPLIT` for a product or solution page (copy beside the visual); no `visual` gives `COMPACT` automatically |
|
|
793
|
+
| `surface` | `WebsiteHeroSurface.PLAIN` · `GLOW` (default) · `GLOW_GRID` | what is drawn behind the hero |
|
|
794
|
+
| `tone` | `WebsiteSurfaceTone.DEFAULT` (default) · `TINTED` · `INVERSE` · `BRAND` | the surface the hero sits on (a hero draws its own surface, so its tone is in its config, never a `band`) |
|
|
795
|
+
| `eyebrow` | boolean, `true` by default | `false` when the brief has no category line above the headline |
|
|
796
|
+
| `lede` | boolean, `true` by default | `false` for a headline-only opening (no subheadline) |
|
|
797
|
+
| `primaryAction`, `secondaryAction` | a `WebsiteLinkTo` each, both optional | one primary action, at most one low-commitment secondary |
|
|
798
|
+
| `note` | boolean | a short line under the actions ("No card required") |
|
|
799
|
+
| `visual` | a React node | the product: a `WebsiteImage` or a drawn demo (Step 6) |
|
|
800
|
+
| `decoration` | a React node | the site's motif in the backdrop, rendered `aria-hidden` |
|
|
801
|
+
| `motion` | per `WebsiteHeroMotionPoint`, or `null` per point | the signature entrance (Step 5) |
|
|
802
|
+
|
|
803
|
+
An action is a `WebsiteLinkTo`: `{ kind: WebsiteMenuLinkKind.APPLICATION, entryPoint:
|
|
804
|
+
ApplicationEntryPoint.SIGN_UP }` opens the application's sign-up page on this
|
|
805
|
+
environment's `appOrigin`; `{ kind: WebsiteMenuLinkKind.PAGE, routePath: '/features' }`
|
|
806
|
+
opens a page of this site with the visitor's locale prefix. Never write an application
|
|
807
|
+
URL or a locale prefix by hand: the block resolves both, the same way the site header does.
|
|
808
|
+
|
|
809
|
+
When several pages open on a hero, the site's fixed choices (its surface, its motif, its
|
|
810
|
+
primary action) belong in ONE config builder in `website/src/sections/kit/` that returns
|
|
811
|
+
`WebsiteHeroProps`, so each page passes only what differs (the layout, the secondary
|
|
812
|
+
action, the visual). See the Worked Example.
|
|
813
|
+
|
|
814
|
+
### Step 2: Configure the section, and let its words follow
|
|
815
|
+
|
|
816
|
+
`websiteHeroBlock.section({ pageRef, sectionRef, category: WebsiteSectionCategory.HERO, config })`
|
|
817
|
+
is the whole section. The block renders `config`, and the section's words are derived from
|
|
818
|
+
the same `config` (the block runs `websiteHeroSlots(config)` for you): `eyebrow` (unless
|
|
819
|
+
`eyebrow` is false), `headline` (the page's only `<h1>`), `subheadline` (unless `lede` is
|
|
820
|
+
false), `cta.primary` / `cta.secondary` (only for the actions given), and `note` (only when
|
|
821
|
+
`note` is set). Nothing is listed by hand; turn a word off in the config and its key goes
|
|
822
|
+
with it. The section derives the fully-composed `website.<page-ref>.<section-ref>.<slot>`
|
|
823
|
+
keys and refuses a slot declared twice.
|
|
824
|
+
|
|
825
|
+
What else `.section(...)` takes follows from the block, and its type refuses the rest:
|
|
826
|
+
|
|
827
|
+
- **No `band` and no `intro`.** A hero draws its own surface (its `tone` and `surface` are
|
|
828
|
+
config) and carries its own heading, so a band or a section intro would give the page a
|
|
829
|
+
second surface and a second title.
|
|
830
|
+
- **`nodeSlots`** for the words a node INSIDE the config reads by itself: a screenshot's
|
|
831
|
+
`visual-alt`, a drawn demo's frame label and pause/play words, the screen's own labels.
|
|
832
|
+
The block does not know what a visual reads, so declare those under the prefix the node
|
|
833
|
+
reads them by (`prefixedWebsiteSlots('demo', …)` for a prefixed drawing).
|
|
834
|
+
- **`getStructuredData`** passes straight through to the section (Step 3).
|
|
835
|
+
- **`anchorId`** when a link must target the hero.
|
|
836
|
+
|
|
837
|
+
The page renders each section with no props, so every choice lives in `config`; a page
|
|
838
|
+
cannot hand the hero its layout. A word a node inside the config renders itself is read
|
|
839
|
+
with the leaf-relative `useWebsiteLabel('<slot>')`, never `useWebsiteLabelByKey(...)`.
|
|
840
|
+
|
|
841
|
+
### Step 3: Optionally pass `getStructuredData`
|
|
715
842
|
|
|
716
843
|
If the hero is the appropriate place to emit `Organization` /
|
|
717
844
|
`WebSite` JSON-LD for the page (typically true for the landing-page
|
|
718
|
-
hero only — internal pages should NOT re-emit these),
|
|
719
|
-
|
|
720
|
-
`
|
|
721
|
-
|
|
722
|
-
`
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
845
|
+
hero only — internal pages should NOT re-emit these), pass
|
|
846
|
+
`getStructuredData({ siteOrigin, locale, label })` to
|
|
847
|
+
`websiteHeroBlock.section(...)`, a pure function the server calls with
|
|
848
|
+
the page it is published on. Build every `url` and `@id` from
|
|
849
|
+
`siteOrigin` (never a typed origin), and read any word the hero shows —
|
|
850
|
+
a `description` from the subheadline — through `label(slot)`, so each
|
|
851
|
+
locale's page publishes its own language. Nothing narrows it by
|
|
852
|
+
category: `wildo website audit` checks each payload against the
|
|
853
|
+
Schema.org catalog, once per locale, and the page route renders it
|
|
854
|
+
through `renderPageStructuredData({ sections, context: runtime.structuredData })`.
|
|
855
|
+
|
|
856
|
+
### Step 4: Compose into a page
|
|
857
|
+
|
|
858
|
+
Add the exported hero section to the page's sections list
|
|
727
859
|
(`<PAGE>_SECTIONS` in `website/src/sections/<page>.sections.tsx`) at its
|
|
728
860
|
reading-order position, normally first. The page renders that list through
|
|
729
861
|
`<WebsitePageSections>`, which wraps each section in its `WebsiteSection` and
|
|
730
|
-
renders
|
|
862
|
+
renders it with NO props, and the manifest's `sectionRefs` derive from
|
|
731
863
|
the same list, so the label-pack validator audits it with no further edit.
|
|
732
|
-
|
|
733
|
-
(
|
|
734
|
-
page
|
|
864
|
+
When many pages open on the same hero, a section factory in the site's kit
|
|
865
|
+
(one function calling `websiteHeroBlock.section(...)` with the config
|
|
866
|
+
builder of Step 1) makes each page's hero one call.
|
|
867
|
+
|
|
868
|
+
### Step 5: Keep the page's signature entrance on the hero
|
|
869
|
+
|
|
870
|
+
The hero is where a page's ONE orchestrated moment belongs, and the hero plays it by
|
|
871
|
+
default: on load, in reading order — eyebrow, headline (`BLUR`), subheadline, actions, note,
|
|
872
|
+
then the visual (`SCALE`), each part only when the hero renders it. It plays once, from the first paint, before the island hydrates,
|
|
873
|
+
and not at all for a visitor who asked for reduced motion. Adjust it point by point through
|
|
874
|
+
the config's `motion`, keyed by `WebsiteHeroMotionPoint` (`{ [WebsiteHeroMotionPoint.HEADLINE]: { reveal:
|
|
875
|
+
WebsiteMotionReveal.RISE, trigger: WebsiteMotionTrigger.LOAD, order: 2 } }`), or set a point
|
|
876
|
+
to `null` to keep it still. Nothing else on the page gets a `LOAD` reveal. See
|
|
877
|
+
`website-motion-design`.
|
|
878
|
+
|
|
879
|
+
### Step 6: When the product visual is a drawn demo, play it in the demo frame
|
|
880
|
+
|
|
881
|
+
A website plan often gives the hero's product visual as a DRAWN DEMO — the application's own screen drawn with the
|
|
882
|
+
kit's atoms, moving through one short scenario — rather than a screenshot. Put a `WebsiteMotionDemo` in the config's
|
|
883
|
+
`visual` (its `label`, `pauseLabel` and `playLabel` from the label pack, in place of `visual-alt`), and declare the
|
|
884
|
+
frame's words and the screen's as the section's `nodeSlots`: the block's visual point carries its `LOAD` reveal, and
|
|
885
|
+
the frame gives the visitor the pause control WCAG 2.2.2 requires, pauses it off screen, and shows its finished last
|
|
886
|
+
step on the server and under reduced motion. Draw only what the application shows, write the scenario as data and play
|
|
887
|
+
it with `useWebsiteDemoScenario`: `website-section-product-showcase` Step 2a teaches the drawing and the scenario,
|
|
888
|
+
`website-motion-design` Step 6 the frame, and `website-building-blocks`'
|
|
889
|
+
`references/framework-website-demo-examples.md` has a worked demo per archetype.
|
|
890
|
+
|
|
891
|
+
### Step 7: Make it this site's own without forking the block
|
|
892
|
+
|
|
893
|
+
In this order: the theme (`website-theme-authoring`), the config of Step 1, a config builder in
|
|
894
|
+
the site's kit, and last an ordinary CSS rule on a hook (`[data-website-block='hero']
|
|
895
|
+
[data-website-part='visual']`). The block's CSS is in the `wildo-website` cascade layer, so an
|
|
896
|
+
unlayered site rule wins without `!important`; read colours from the current tone
|
|
897
|
+
(`var(--website-tone-foreground)`), never a hex. A copied hero stops following the theme.
|
|
735
898
|
|
|
736
899
|
**Finish** after the hero compiles and renders without TypeScript errors,
|
|
737
|
-
the page manifest includes the exported
|
|
900
|
+
the page manifest includes the exported hero section, and the homepage
|
|
738
901
|
reference’s editorial and rendered-page checks pass: responsive phrase wrapping,
|
|
739
902
|
image meaning and delivery, supported themes/locales, keyboard/reduced-motion
|
|
740
903
|
behavior, and the approved action policy. Compilation alone is insufficient.
|
|
741
904
|
Nothing warns about a landing hero without `Organization` JSON-LD, so
|
|
742
905
|
check it yourself: if `wildo website audit` shows no payload for the
|
|
743
|
-
landing page, **return to Step
|
|
906
|
+
landing page, **return to Step 3** — `getStructuredData` is opt-in
|
|
744
907
|
but recommended there, because search and answer engines ground the
|
|
745
908
|
site's entity on it.
|
|
746
909
|
|
|
747
|
-
## Structured data (AEO)
|
|
748
|
-
|
|
749
|
-
Hero is the natural home for the page's site-identity entities:
|
|
750
|
-
`Organization` and `WebSite`.
|
|
751
|
-
|
|
752
|
-
- **What earns its place**: homepage or top-level landing hero, stable
|
|
753
|
-
site/company identity, canonical site URL.
|
|
754
|
-
- **What is NOT in this block**: pricing offers, FAQs, testimonial
|
|
755
|
-
claims, or duplicate `Organization` payloads emitted from every inner
|
|
756
|
-
page hero.
|
|
757
|
-
- **Verification grep**:
|
|
758
|
-
`rg -n "getStructuredData" website/src/sections/<page>.sections.tsx`
|
|
759
|
-
(must return `>= 1` when the hero owns site identity on that page).
|
|
760
|
-
|
|
761
910
|
## Contribution to `llms.txt`
|
|
762
911
|
|
|
763
912
|
Hero authoring contributes the top-level framing sentence for a page's
|
|
@@ -772,228 +921,350 @@ entry in `website/src/content/llms.txt`.
|
|
|
772
921
|
|
|
773
922
|
## Worked Example
|
|
774
923
|
|
|
775
|
-
|
|
924
|
+
A site fixes its hero choices once, in a config builder of its kit: the glow-over-grid
|
|
925
|
+
surface, the site's stripes motif as the `decoration`, the application's sign-up as the
|
|
926
|
+
primary action, and a page of the site as the secondary. It returns the hero's config:
|
|
927
|
+
|
|
928
|
+
|
|
929
|
+
## Usage Example
|
|
930
|
+
|
|
931
|
+
```tsx
|
|
932
|
+
/** The hero's actions: the application's sign-up, and a page of this site. */
|
|
933
|
+
const heroActions = (secondaryRoutePath: string) => ({
|
|
934
|
+
primaryAction: { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP } as const,
|
|
935
|
+
secondaryAction: { kind: WebsiteMenuLinkKind.PAGE, routePath: secondaryRoutePath } as const,
|
|
936
|
+
});
|
|
937
|
+
|
|
938
|
+
/** The brand's three forward-leaning stripes, the site's motif behind its hero and its closing call to action. */
|
|
939
|
+
function Stripes({ className }: { className: string }): ReactNode {
|
|
940
|
+
return (
|
|
941
|
+
<span className={className}>
|
|
942
|
+
<i />
|
|
943
|
+
<i />
|
|
944
|
+
<i />
|
|
945
|
+
</span>
|
|
946
|
+
);
|
|
947
|
+
}
|
|
948
|
+
|
|
949
|
+
/**
|
|
950
|
+
* A page's opening: the engine's hero with this site's choices, the glow-over-grid surface, the stripes motif, and
|
|
951
|
+
* the application's sign-up as the primary action. `WebsiteHeroLayout.STAGE` is the home page's product stage, `SPLIT`
|
|
952
|
+
* puts the visual beside the copy; without a visual the engine makes it a compact opening.
|
|
953
|
+
*/
|
|
954
|
+
export function heroConfig({
|
|
955
|
+
secondaryRoutePath,
|
|
956
|
+
visual,
|
|
957
|
+
note = false,
|
|
958
|
+
layout = WebsiteHeroLayout.SPLIT,
|
|
959
|
+
}: {
|
|
960
|
+
secondaryRoutePath: string;
|
|
961
|
+
visual?: ReactNode;
|
|
962
|
+
note?: boolean;
|
|
963
|
+
layout?: WebsiteHeroLayout;
|
|
964
|
+
}): WebsiteHeroProps {
|
|
965
|
+
return {
|
|
966
|
+
layout,
|
|
967
|
+
surface: WebsiteHeroSurface.GLOW_GRID,
|
|
968
|
+
decoration: <Stripes className="brand-stripes" />,
|
|
969
|
+
note,
|
|
970
|
+
...(visual === undefined ? {} : { visual }),
|
|
971
|
+
...heroActions(secondaryRoutePath),
|
|
972
|
+
};
|
|
973
|
+
}
|
|
974
|
+
```
|
|
975
|
+
|
|
976
|
+
## Usage Example
|
|
977
|
+
|
|
978
|
+
```tsx
|
|
979
|
+
/**
|
|
980
|
+
* The copy on one side — what it is, why it matters, its points — and the product doing it on the other. `reverse`
|
|
981
|
+
* swaps the sides, so consecutive rows zig-zag. Each point carries its glyph, a check unless one is given.
|
|
982
|
+
*/
|
|
983
|
+
export function featureRowConfig({
|
|
984
|
+
visual,
|
|
985
|
+
bullets = 3,
|
|
986
|
+
icons,
|
|
987
|
+
linkRoutePath,
|
|
988
|
+
reverse = false,
|
|
989
|
+
}: {
|
|
990
|
+
visual: ReactNode;
|
|
991
|
+
bullets?: number;
|
|
992
|
+
icons?: readonly WtIcon[];
|
|
993
|
+
linkRoutePath?: string;
|
|
994
|
+
reverse?: boolean;
|
|
995
|
+
}): WebsiteFeatureRowProps {
|
|
996
|
+
return {
|
|
997
|
+
points: indexes(bullets).map((index) => ({ ref: `point${index}`, icon: <Icon name={icons?.[index - 1] ?? WtIcon.CHECK} /> })),
|
|
998
|
+
visual,
|
|
999
|
+
layout: reverse ? WebsiteFeatureRowLayout.VISUAL_START : WebsiteFeatureRowLayout.VISUAL_END,
|
|
1000
|
+
...(linkRoutePath === undefined ? {} : { link: { kind: WebsiteMenuLinkKind.PAGE, routePath: linkRoutePath } as const }),
|
|
1001
|
+
};
|
|
1002
|
+
}
|
|
1003
|
+
```
|
|
1004
|
+
|
|
1005
|
+
The framework's reference application opens its home page on that builder, configured as a
|
|
1006
|
+
section: the `STAGE` layout, the note under the actions, the framed product drawing as the
|
|
1007
|
+
`visual`, and the words that drawing reads as `nodeSlots`. Notice there is no band, no
|
|
1008
|
+
intro and no list of the hero's own words — the block derives them from the config:
|
|
1009
|
+
|
|
1010
|
+
|
|
1011
|
+
## Usage Example
|
|
1012
|
+
|
|
1013
|
+
```tsx
|
|
1014
|
+
const HERO_VISUAL: VisualSpec = { draw: (prefix) => <WeeklyPlanScreen prefix={prefix} />, slots: weeklyPlanSlots };
|
|
1015
|
+
|
|
1016
|
+
export const LANDING_HERO_SECTION = websiteHeroBlock.section({
|
|
1017
|
+
pageRef: PAGE_REF,
|
|
1018
|
+
sectionRef: 'landing-hero',
|
|
1019
|
+
category: WebsiteSectionCategory.HERO,
|
|
1020
|
+
config: heroConfig({ layout: WebsiteHeroLayout.STAGE, note: true, secondaryRoutePath: '/features', visual: visualNode(HERO_VISUAL) }),
|
|
1021
|
+
nodeSlots: visualSlots(HERO_VISUAL),
|
|
1022
|
+
});
|
|
1023
|
+
```
|
|
1024
|
+
|
|
1025
|
+
That landing hero emits no JSON-LD. A landing hero that carries the site's identity passes
|
|
1026
|
+
`getStructuredData` through the same call, beside a screenshot whose `alt` is a word of
|
|
1027
|
+
the section:
|
|
1028
|
+
|
|
1029
|
+
<!-- TIER C WAIVER: no anchored application usage shows a hero section's `getStructuredData` — the `Organization` / `WebSite` payloads built from `siteOrigin` and read through `label(slot)` — on a configured `websiteHeroBlock.section(...)`, nor a screenshot visual whose alt is a `nodeSlots` word. The configuration itself IS anchored (above). Keep this inline until a hero with structured data is deliberately anchored. -->
|
|
776
1030
|
```tsx
|
|
777
1031
|
// website/src/sections/<page>.sections.tsx
|
|
1032
|
+
import type { ReactNode } from 'react';
|
|
1033
|
+
import { ApplicationEntryPoint } from '@wildo-ai/saas-models/public-runtime';
|
|
778
1034
|
import {
|
|
779
|
-
defineWebsiteSection,
|
|
780
1035
|
useWebsiteLabel,
|
|
781
|
-
|
|
782
|
-
|
|
1036
|
+
websiteHeroBlock,
|
|
1037
|
+
WebsiteHeroLayout,
|
|
1038
|
+
WebsiteHeroSurface,
|
|
783
1039
|
WebsiteImage,
|
|
1040
|
+
WebsiteMenuLinkKind,
|
|
784
1041
|
WebsiteSectionCategory,
|
|
785
|
-
WebsiteText,
|
|
786
1042
|
} from '@wildo-ai/saas-website';
|
|
787
1043
|
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
/** Optional hero visual; if absent the layout collapses to text-only. */
|
|
792
|
-
visualSrc?: string;
|
|
793
|
-
}
|
|
794
|
-
|
|
795
|
-
function HeroSectionComponent({ alignment, visualSrc }: HeroSectionProps) {
|
|
796
|
-
const eyebrow = useWebsiteLabel('eyebrow');
|
|
797
|
-
const headline = useWebsiteLabel('headline');
|
|
798
|
-
const subheadline = useWebsiteLabel('subheadline');
|
|
799
|
-
const primaryCta = useWebsiteLabel('primary-cta');
|
|
800
|
-
const secondaryCta = useWebsiteLabel('secondary-cta');
|
|
801
|
-
const visualAlt = useWebsiteLabel('visual-alt');
|
|
802
|
-
|
|
803
|
-
return (
|
|
804
|
-
<div data-alignment={alignment} className="hero">
|
|
805
|
-
<div className="hero__copy">
|
|
806
|
-
<WebsiteText variant="eyebrow">{eyebrow}</WebsiteText>
|
|
807
|
-
<WebsiteHeading level={1} variant="display">{headline}</WebsiteHeading>
|
|
808
|
-
<WebsiteText variant="lead">{subheadline}</WebsiteText>
|
|
809
|
-
<div className="hero__ctas">
|
|
810
|
-
<WebsiteButton href="/signup" variant="primary">{primaryCta}</WebsiteButton>
|
|
811
|
-
<WebsiteButton href="/demo" variant="secondary">{secondaryCta}</WebsiteButton>
|
|
812
|
-
</div>
|
|
813
|
-
</div>
|
|
814
|
-
{visualSrc && (
|
|
815
|
-
<WebsiteImage
|
|
816
|
-
src={visualSrc}
|
|
817
|
-
alt={visualAlt}
|
|
818
|
-
width={960}
|
|
819
|
-
height={640}
|
|
820
|
-
/>
|
|
821
|
-
)}
|
|
822
|
-
</div>
|
|
823
|
-
);
|
|
1044
|
+
/** The product screenshot. Its alt is a word of this section, declared below as a node slot. */
|
|
1045
|
+
function HeroVisual(): ReactNode {
|
|
1046
|
+
return <WebsiteImage src="/hero/product.png" alt={useWebsiteLabel('visual-alt')} width={1440} height={900} loading="eager" />;
|
|
824
1047
|
}
|
|
825
1048
|
|
|
826
|
-
export const
|
|
827
|
-
|
|
1049
|
+
export const LANDING_HERO_SECTION = websiteHeroBlock.section({
|
|
1050
|
+
pageRef: 'landing',
|
|
1051
|
+
sectionRef: 'landing-hero',
|
|
828
1052
|
category: WebsiteSectionCategory.HERO,
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
|
|
1053
|
+
// The block renders this, and declares eyebrow, headline, subheadline, cta.primary and
|
|
1054
|
+
// cta.secondary from it. `eyebrow: false, lede: false` makes a headline-only opening: words follow.
|
|
1055
|
+
config: {
|
|
1056
|
+
layout: WebsiteHeroLayout.STAGE,
|
|
1057
|
+
surface: WebsiteHeroSurface.GLOW_GRID,
|
|
1058
|
+
primaryAction: { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP },
|
|
1059
|
+
secondaryAction: { kind: WebsiteMenuLinkKind.PAGE, routePath: '/features' },
|
|
1060
|
+
visual: <HeroVisual />,
|
|
1061
|
+
},
|
|
1062
|
+
// A word the visual reads itself: the block does not know it.
|
|
1063
|
+
nodeSlots: ['visual-alt'],
|
|
1064
|
+
// URLs from the site's public origin; the description in the page's locale, from the slot the
|
|
1065
|
+
// hero renders. The brand name is a proper name, the same in every locale.
|
|
1066
|
+
getStructuredData: ({ siteOrigin, locale, label }) => [
|
|
839
1067
|
{
|
|
840
1068
|
'@type': 'Organization',
|
|
841
|
-
'@id':
|
|
1069
|
+
'@id': `${siteOrigin}/#organization`,
|
|
842
1070
|
name: 'Example Application',
|
|
843
|
-
url:
|
|
844
|
-
logo:
|
|
1071
|
+
url: siteOrigin,
|
|
1072
|
+
logo: `${siteOrigin}/og/logo.png`,
|
|
845
1073
|
},
|
|
846
1074
|
{
|
|
847
1075
|
'@type': 'WebSite',
|
|
848
|
-
'@id':
|
|
1076
|
+
'@id': `${siteOrigin}/#website`,
|
|
849
1077
|
name: 'Example Application',
|
|
850
|
-
url:
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
},
|
|
1078
|
+
url: siteOrigin,
|
|
1079
|
+
inLanguage: locale,
|
|
1080
|
+
description: label('subheadline'),
|
|
1081
|
+
publisher: { '@id': `${siteOrigin}/#organization` },
|
|
854
1082
|
},
|
|
855
1083
|
],
|
|
856
1084
|
});
|
|
857
1085
|
```
|
|
858
1086
|
|
|
1087
|
+
The section holds no heading markup, no layout CSS, no motion code, no URL and no list of
|
|
1088
|
+
its words: the block owns them.
|
|
1089
|
+
|
|
859
1090
|
## Structured-data contract
|
|
860
1091
|
|
|
861
|
-
|
|
1092
|
+
Hero is the natural home for the page's site-identity entities, on the homepage or top-level landing hero only:
|
|
862
1093
|
|
|
863
1094
|
- `WebSite` — on the landing page hero only (one per site).
|
|
864
|
-
- `Organization` — on the landing page hero, referenced from
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
than the pricing section) owns the product claim. Emit it from one
|
|
868
|
-
section per page.
|
|
1095
|
+
- `Organization` — on the landing page hero, referenced from `WebSite.publisher` by `@id`.
|
|
1096
|
+
- `SoftwareApplication` — the product itself, when the hero (rather than the pricing section) owns the product
|
|
1097
|
+
claim. Emit it from one section per page.
|
|
869
1098
|
|
|
870
|
-
Keep these in the sections that own them — nothing rejects them here,
|
|
871
|
-
|
|
872
|
-
against the section's category:
|
|
1099
|
+
Keep these in the sections that own them — nothing rejects them here, since the audit checks each payload against
|
|
1100
|
+
the catalog and never against the section's category:
|
|
873
1101
|
|
|
874
1102
|
- `FAQPage` → emit from `website-section-faq` instead.
|
|
875
|
-
- `Product` / `Offer` / `AggregateOffer` → emit from
|
|
876
|
-
|
|
877
|
-
- `Review` / `AggregateRating` → emit from
|
|
878
|
-
`website-section-social-proof` instead.
|
|
1103
|
+
- `Product` / `Offer` / `AggregateOffer` → emit from `website-section-pricing` instead.
|
|
1104
|
+
- `Review` / `AggregateRating` → emit from `website-section-social-proof` instead.
|
|
879
1105
|
|
|
880
|
-
If structured data isn't relevant for a given hero (e.g. an internal
|
|
881
|
-
|
|
1106
|
+
If structured data isn't relevant for a given hero (e.g. an internal `/about` hero), simply omit
|
|
1107
|
+
`getStructuredData` — it's optional. The block renders the hero; the section still owns its JSON-LD.
|
|
882
1108
|
|
|
883
1109
|
## Catalog integration (AEO)
|
|
884
1110
|
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
- `
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
|
|
893
|
-
|
|
894
|
-
`recommendOptionals: true`, so a missing `sameAs` / `logo` is
|
|
895
|
-
listed as a recommendation — `sameAs` is the strongest
|
|
896
|
-
disambiguation signal AI engines use).
|
|
897
|
-
|
|
898
|
-
The hero is the single emission site for both entities; sub-pages
|
|
899
|
-
reference them via `@id` rather than re-emitting them. The page-shell
|
|
900
|
-
wires emission through its installed structured-data contract — the renderer
|
|
901
|
-
dedupes by `@id`, so an accidental double-emit collapses to
|
|
902
|
-
a single block (last-wins).
|
|
1111
|
+
Both payloads are declared by the installed Schema.org catalog contract:
|
|
1112
|
+
|
|
1113
|
+
- `WEB_SITE_CATALOG_ENTRY` (required: `name`, `url`; `recommendOptionals: true`, so a missing `potentialAction` /
|
|
1114
|
+
`inLanguage` is listed as a recommendation by `wildo website audit` — information, never a finding).
|
|
1115
|
+
- `ORGANIZATION_CATALOG_ENTRY` (required: `name`, `url`; `recommendOptionals: true`, so a missing `sameAs` / `logo`
|
|
1116
|
+
is listed as a recommendation — `sameAs` is the strongest disambiguation signal AI engines use).
|
|
1117
|
+
|
|
1118
|
+
The hero is the single emission site for both entities; sub-pages reference them via `@id` rather than re-emitting
|
|
1119
|
+
them. The renderer dedupes by `@id`, so an accidental double-emit collapses to a single block (last-wins).
|
|
903
1120
|
|
|
904
1121
|
**What earns its place in this section's emission**:
|
|
905
1122
|
|
|
906
|
-
- A `WebSite` payload with the site's `name` + canonical `url` and
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
brand-controlled social URL) and `logo` (the URL of the brand
|
|
911
|
-
asset).
|
|
1123
|
+
- A `WebSite` payload with the site's `name` + canonical `url` and (optional but recommended) `inLanguage` +
|
|
1124
|
+
`publisher` referencing the `Organization` via `@id`.
|
|
1125
|
+
- An `Organization` payload with `name` + `url`, plus `sameAs` (every brand-controlled social URL) and `logo` (the
|
|
1126
|
+
URL of the brand asset).
|
|
912
1127
|
|
|
913
1128
|
**What is NOT in this emission**:
|
|
914
1129
|
|
|
915
|
-
- `BreadcrumbList` for the home page (the home page has no breadcrumb
|
|
916
|
-
|
|
917
|
-
-
|
|
918
|
-
|
|
919
|
-
`spec-catalog-authoring`); the section's emission stays the same
|
|
920
|
-
shape.
|
|
921
|
-
- For SaaS sites, the `SoftwareApplication` payload — emit from the
|
|
922
|
-
pricing / features section instead, NOT the hero.
|
|
1130
|
+
- `BreadcrumbList` for the home page (the home page has no breadcrumb trail).
|
|
1131
|
+
- App overrides — apps replace `Organization` / `WebSite` with their own catalog entries via the override mechanism
|
|
1132
|
+
(see `spec-catalog-authoring`); the section's emission stays the same shape.
|
|
1133
|
+
- Pricing offers, FAQs, testimonial claims, or `Organization` re-emitted from every inner page's hero.
|
|
923
1134
|
|
|
924
1135
|
**Verification grep** (run from the app root):
|
|
925
1136
|
|
|
926
|
-
| Invariant | Command |
|
|
927
|
-
|---|---|
|
|
928
|
-
| Hero emits structured data on the landing page | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 for landing-page hero) |
|
|
929
|
-
| Both `@type`s present | see the commands below the table (must return ≥2) |
|
|
930
|
-
|
|
931
1137
|
```bash
|
|
932
|
-
#
|
|
1138
|
+
# Hero emits structured data on the landing page (must return >= 1 for the landing-page hero)
|
|
1139
|
+
rg -n "getStructuredData" website/src/sections/<page>.sections.tsx
|
|
1140
|
+
|
|
1141
|
+
# Both @types present (must return >= 2)
|
|
933
1142
|
rg -n "'WebSite'|'Organization'" website/src/sections/<page>.sections.tsx
|
|
934
1143
|
```
|
|
935
1144
|
|
|
936
1145
|
## References
|
|
937
1146
|
|
|
938
|
-
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts (shared with all `
|
|
1147
|
+
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts (shared with all `website-section-*` skills via `partials/website-section-authoring-api.partial.md`).
|
|
1148
|
+
- `../website-building-blocks/references/framework-website-blocks-api.md` — source-backed `defineWebsiteBlock` and the configured blocks (`websiteHeroBlock` among them), `WebsiteHero`'s props and slots, `WebsiteHeroMotionPoint`, `WebsiteLinkTo` and the stylesheet hooks.
|
|
939
1149
|
|
|
940
1150
|
## Verification
|
|
941
1151
|
|
|
942
|
-
-
|
|
943
|
-
|
|
944
|
-
|
|
1152
|
+
- [ ] The editorial and rendered-page review in the homepage content and art-direction
|
|
1153
|
+
reference passes, on actual narrow and wide layouts, not only source.
|
|
945
1154
|
- [ ] `category: WebsiteSectionCategory.HERO` (typed enum, never a string literal).
|
|
946
|
-
- [ ] `sectionRef` is kebab-case and unique
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
1155
|
+
- [ ] `sectionRef` is kebab-case and unique across the site (the website plan refuses one declared on two
|
|
1156
|
+
pages, and most pages open on a hero, so name it after its page: `landing-hero`, `pricing-hero`).
|
|
1157
|
+
- [ ] The section is `websiteHeroBlock.section(...)` (directly or through a factory in the site's kit),
|
|
1158
|
+
not a hand-built hero body and not `defineWebsiteBlockSection` with a hand-listed slot array.
|
|
1159
|
+
- [ ] Its words follow its `config`; the only words declared beside it are `nodeSlots` a node in the
|
|
1160
|
+
config reads itself (`visual-alt`, a demo frame's labels, a drawn screen's words).
|
|
1161
|
+
- [ ] Every action is a `WebsiteLinkTo` (`APPLICATION` with an `entryPoint`, `PAGE` with a
|
|
1162
|
+
`routePath`); no application URL, no typed `href`, no hand-written locale prefix.
|
|
1163
|
+
- [ ] Every word a node in the config renders itself comes from `useWebsiteLabel('<slot>')` (not
|
|
1164
|
+
props, not hardcoded).
|
|
1165
|
+
- [ ] If `getStructuredData` is passed, it returns only
|
|
1166
|
+
`WebSite` / `Organization` (or is omitted entirely), builds every
|
|
1167
|
+
`url` / `@id` from `siteOrigin`, and reads any word the hero shows
|
|
1168
|
+
through `label(slot)`.
|
|
1169
|
+
- [ ] The look is adjusted through the theme, the config, or a rule on a `data-website-*` hook —
|
|
1170
|
+
no copied hero markup, no `!important`, no raw colour.
|
|
1171
|
+
- [ ] A screenshot visual is a `WebsiteImage` with explicit `width` and `height` and
|
|
1172
|
+
`loading="eager"` (it is above the fold).
|
|
1173
|
+
- [ ] A drawn-demo product visual plays inside `WebsiteMotionDemo`: a kit drawing played by a scenario through
|
|
1174
|
+
`useWebsiteDemoScenario` (Step 6).
|
|
1175
|
+
- [ ] The exported hero section is an entry of the page's `<PAGE>_SECTIONS`
|
|
956
1176
|
list, and the page renders that list through `<WebsitePageSections>`
|
|
957
1177
|
rather than placing the hero in its JSX by hand.
|
|
958
1178
|
|
|
959
1179
|
### Grep invariants
|
|
960
1180
|
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
1181
|
+
`npx astro check` in `website/` must pass: `.section(...)` refuses a `band` or an `intro` for
|
|
1182
|
+
the hero, and a config that is not `WebsiteHeroProps`. Then, from the app root:
|
|
1183
|
+
|
|
1184
|
+
```bash
|
|
1185
|
+
# The hero is the engine's block, configured (must return >= 1)
|
|
1186
|
+
rg -n "websiteHeroBlock\.section\(" website/src/sections
|
|
1187
|
+
|
|
1188
|
+
# No hero declared with a hand-listed slot array (must return empty)
|
|
1189
|
+
rg -n "websiteHeroSlots\(" website/src/sections
|
|
1190
|
+
|
|
1191
|
+
# No hand-built hero: no second <h1> beside the block's (must return empty)
|
|
1192
|
+
rg -n "level=\{1\}|<h1" website/src/sections/<page>.sections.tsx
|
|
1193
|
+
|
|
1194
|
+
# No typed link (must return empty: an action is a WebsiteLinkTo)
|
|
1195
|
+
rg -n "href=" website/src/sections/<page>.sections.tsx
|
|
1196
|
+
|
|
1197
|
+
# Category enum used, no string literal (must return empty)
|
|
1198
|
+
rg -n "category: 'hero'" website/src/sections/<page>.sections.tsx
|
|
1199
|
+
|
|
1200
|
+
# No raw text outside JSX expressions (must return empty)
|
|
1201
|
+
rg -n ">[A-Z][a-z]+ [a-z]+<" website/src/sections/<page>.sections.tsx
|
|
1202
|
+
|
|
1203
|
+
# No typed origin in the JSON-LD (must return empty: build from siteOrigin)
|
|
1204
|
+
rg -n "('@id'|url): 'https?://" website/src/sections/<page>.sections.tsx
|
|
1205
|
+
|
|
1206
|
+
# A moving visual plays in the demo frame (each scenario sits inside a WebsiteMotionDemo; no bare timer, no hand-timed steps)
|
|
1207
|
+
rg -n "useWebsiteDemoScenario|useWebsiteMotionDemoTimeline|setInterval|setTimeout" website/src/sections/
|
|
1208
|
+
|
|
1209
|
+
# !important or a raw colour against the block (must return empty)
|
|
1210
|
+
rg -n '!important|#[0-9a-fA-F]{3,8}\b' website/src/styles
|
|
1211
|
+
```
|
|
967
1212
|
|
|
968
1213
|
## Common Rationalizations
|
|
969
1214
|
|
|
970
1215
|
| Rationalization | Reality |
|
|
971
1216
|
|---|---|
|
|
972
|
-
| "I'll inline the headline string for now" | Breaks the i18n contract. Every string the user sees is locale-dependent;
|
|
973
|
-
| "I'll
|
|
1217
|
+
| "I'll inline the headline string for now" | Breaks the i18n contract. Every string the user sees is locale-dependent; the derived slots are the audit surface. |
|
|
1218
|
+
| "I'll copy the hero's JSX and tweak it" | The copy stops following the theme, the motion vocabulary and every fix to the block. Change the config, the theme, or one rule on a `data-website-*` hook. |
|
|
1219
|
+
| "I'll list the hero's label keys by hand" | `websiteHeroBlock.section` derives them from the config it renders. A hand list drifts, and the audit then demands words nobody shows — or misses one that is shown. |
|
|
1220
|
+
| "I'll wrap `WebsiteHero` in my own component and declare it with `defineWebsiteBlockSection`" | Then the words are listed apart from what renders. Return the config from a builder in the site's kit and let `websiteHeroBlock.section` render it. |
|
|
1221
|
+
| "The screenshot's alt is part of the hero, the block will declare it" | The block knows its own words, not a node's. Declare `visual-alt` (or the demo's words) as `nodeSlots`. |
|
|
974
1222
|
| "I'll re-emit `WebSite` JSON-LD on every page hero" | Search engines deduplicate, but a second `WebSite` claims the site identity from a page that is not its home. Nothing flags it for you — emit `WebSite` on the landing hero only. |
|
|
975
|
-
| "
|
|
1223
|
+
| "I'll build the sign-up URL from the app's origin" | `{ kind: APPLICATION, entryPoint: SIGN_UP }` resolves it per environment, as the header does. A typed URL names one environment. |
|
|
1224
|
+
| "The page can pass the hero its layout" | The page renders each section with no props. Every choice is in the section's `config`. |
|
|
976
1225
|
|
|
977
1226
|
## Red Flags
|
|
978
1227
|
|
|
1228
|
+
- A hero section that renders its own `<h1>` / `WebsiteHeading level={1}` and button row
|
|
1229
|
+
instead of configuring `websiteHeroBlock` — catch with the "No hand-built hero" and
|
|
1230
|
+
"engine's block, configured" greps above.
|
|
1231
|
+
- Hero words listed by hand (`websiteHeroSlots(...)` spread into a `slots` array, or
|
|
1232
|
+
`expectedLabelKeys: ['website.landing.hero.headline', …]`) — catch with the
|
|
1233
|
+
"hand-listed slot array" grep above.
|
|
1234
|
+
- A CTA with a typed `href` (`"/signup"`, `"https://app.example.com/…"`)
|
|
1235
|
+
— it names one environment and skips the locale prefix; catch with the
|
|
1236
|
+
"No typed link" grep above.
|
|
979
1237
|
- A hero component that imports `~wildo-frontend-lib/**` or an
|
|
980
1238
|
undeclared deep package path — the installed website package is boundary-
|
|
981
|
-
scanned. Use the
|
|
982
|
-
`
|
|
983
|
-
|
|
984
|
-
- `expectedLabelKeys` not rooted under the hero's `sectionRef` — the
|
|
985
|
-
factory throws at module load time, but if you see the error, fix
|
|
986
|
-
the leaf root, don't suppress.
|
|
1239
|
+
scanned. Use the package's blocks and primitives, or the site's own
|
|
1240
|
+
components (`website-primitive-overrides`); `npx astro check` and the
|
|
1241
|
+
package's export map refuse the deep path.
|
|
987
1242
|
- Two heroes on the same page with the same `sectionRef` — uniqueness
|
|
988
1243
|
is enforced per page at manifest registration; rename one of them.
|
|
1244
|
+
- A `band` or `intro` passed to `websiteHeroBlock.section` — the hero draws its own surface and
|
|
1245
|
+
heading, and the type refuses both; set `tone` / `surface` in the config instead. Catch with `npx astro check`.
|
|
1246
|
+
- A hero payload with a typed `'https://…'` URL or a quoted sentence the
|
|
1247
|
+
hero also renders — the URL drifts from `publicOrigin` per environment
|
|
1248
|
+
and the sentence is one language on every locale's page; catch the URL
|
|
1249
|
+
with the "No typed origin" grep above, and read the words through
|
|
1250
|
+
`label(slot)`.
|
|
1251
|
+
- An animated product visual with no pause control (a GIF, a hand-rolled
|
|
1252
|
+
timer, a CSS loop outside a demo frame) — catch with the moving-visual
|
|
1253
|
+
grep above, and play it in `WebsiteMotionDemo` (Step 6).
|
|
1254
|
+
- `!important` or a raw colour in a rule against the hero — catch with the last grep above;
|
|
1255
|
+
the block's CSS is in a cascade layer, and the current tone's variables are right on every band.
|
|
989
1256
|
|
|
990
1257
|
## Related Skills
|
|
991
1258
|
|
|
1259
|
+
- `website-building-blocks` — how the engine's blocks are configured, how their words follow, and how they are adjusted without forking.
|
|
992
1260
|
- `website-page-authoring` — how to compose this Hero into a page manifest.
|
|
993
1261
|
- `website-label-pack` — authoring the EN/FR strings the hero consumes.
|
|
1262
|
+
- `website-theme-authoring` — the theme the hero's look is read from.
|
|
994
1263
|
- `website-section-cta` — the mid-page sibling band.
|
|
995
1264
|
- `website-section-footer-cta` — the pre-footer sibling band.
|
|
996
|
-
- `website-
|
|
1265
|
+
- `website-motion-design` — the hero's signature entrance and the vocabulary its config's `motion` takes.
|
|
1266
|
+
- `website-section-product-showcase` — the product visual that often follows the hero.
|
|
1267
|
+
- `website-factory-advanced` — escape hatch for a bespoke canvas / WebGL hero only.
|
|
997
1268
|
- `website-seo-aeo-geo` — how the structured-data builder consumes
|
|
998
|
-
`getStructuredData
|
|
1269
|
+
`getStructuredData` and which vocabularies are allowed per
|
|
999
1270
|
category.
|