@wildo-ai/framework-knowledge 1.1.9 → 1.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +543 -80
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +138 -21
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +17 -9
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +89 -9
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +6 -4
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +28 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -5
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +14 -6
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +34 -7
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +14 -6
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +15 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +497 -32
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-maturity.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-choice.config.md +20 -3
- package/dist/knowledge/references/brand.name-screening.config.md +58 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
- package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +76 -7
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/integration-plan.config.md +21 -1
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +107 -2
- package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
- package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
- package/dist/knowledge/references/platform.config.saas.md +106 -14
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +84 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
- package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
- package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
- package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
- package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
- package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +270 -0
- package/dist/knowledge/references/website-plan.config.md +561 -23
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
- package/dist/knowledge/references/zod.factories.code.md +18 -8
- package/dist/knowledge/references/zod.factories.duration.md +23 -13
- package/dist/knowledge/references/zod.factories.money.md +24 -14
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +2854 -246
- package/dist/knowledge/registries/playbooks.json +57 -36
- package/dist/knowledge/registries/source-tags.json +8863 -4569
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +63 -34
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
- package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
- package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
- package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17305 -8263
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: website-section-feature-detail
|
|
3
|
-
description: Author a Feature Detail section
|
|
3
|
+
description: Author a Feature Detail section — one capability argued beside its screenshot or drawn demo, rows alternating visual-left / visual-right — by configuring the engine's `websiteFeatureRowBlock` (`websiteFeatureRowBlock.section({ category: WebsiteSectionCategory.FEATURE_DETAIL, band, config })`), its words derived from the config; a capability's facts in rows configure `websiteFactTableBlock`. Use when the user says "add a deep-dive feature section", "compose alternating image+copy bands", "build a feature spotlight", or "deep-dive a single feature with screenshot".
|
|
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,22 +697,27 @@ 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
|
-
>
|
|
700
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships the feature row as a
|
|
701
|
+
> configurable block, `websiteFeatureRowBlock`: its renderer (`WebsiteFeatureRow`) puts the copy
|
|
702
|
+
> on one side (a heading, and optionally an eyebrow, a body, a list of points and a link) and the
|
|
703
|
+
> visual on the other, the side chosen by its `layout`, stacking on a narrow screen, with its
|
|
704
|
+
> reveal and its look read from the site's theme. A feature-detail section is
|
|
705
|
+
> `websiteFeatureRowBlock.section({ pageRef, sectionRef, category, band, config })`: the block
|
|
706
|
+
> stands on the section's band, renders the config, and the section's words are derived from that
|
|
707
|
+
> same config. This skill covers what a feature-detail section must SAY and CARRY — its category,
|
|
708
|
+
> its words, its (absent) structured data and its `llms.txt` contribution — and which
|
|
709
|
+
> configuration says it. How blocks are configured in general is `website-building-blocks`.
|
|
628
710
|
|
|
629
711
|
## Overview
|
|
630
712
|
|
|
631
713
|
A Feature Detail section is the deep-dive complement to
|
|
632
714
|
`website-section-feature-benefit-summary`. Each instance covers ONE
|
|
633
|
-
feature in depth:
|
|
634
|
-
|
|
635
|
-
on a "Features" page is the
|
|
636
|
-
|
|
637
|
-
|
|
715
|
+
feature in depth: a heading, a paragraph-length explanation, usually a
|
|
716
|
+
short list of points, and a visual (a screenshot or a drawn demo of the
|
|
717
|
+
product doing it). Stacking 2–4 of these on a "Features" page is the
|
|
718
|
+
standard pattern; alternating the visual's side from row to row
|
|
719
|
+
(`WebsiteFeatureRowLayout.VISUAL_END`, then `VISUAL_START`, …) keeps the
|
|
720
|
+
rhythm visually engaging.
|
|
638
721
|
|
|
639
722
|
What the category does — and, for structured data, does not — decide:
|
|
640
723
|
|
|
@@ -650,13 +733,15 @@ What the category does — and, for structured data, does not — decide:
|
|
|
650
733
|
|
|
651
734
|
| Surface | Glob (relative to app root) |
|
|
652
735
|
|---|---|
|
|
653
|
-
|
|
|
736
|
+
| The configured section (`websiteFeatureRowBlock.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) |
|
|
737
|
+
| The site's feature-row config builder (its icon set, its link shape) and section factory | `website/src/sections/kit/**` |
|
|
654
738
|
| Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
|
|
655
739
|
| Label pack (per locale) | `website/src/i18n/<locale>.json` |
|
|
740
|
+
| The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
|
|
656
741
|
|
|
657
742
|
## When to Use
|
|
658
743
|
|
|
659
|
-
- Spotlighting one feature per band with rich copy and a
|
|
744
|
+
- Spotlighting one feature per band with rich copy and a visual.
|
|
660
745
|
- Stacking multiple feature-detail instances on a page (each gets
|
|
661
746
|
its own `sectionRef`).
|
|
662
747
|
- The feature warrants more than 1-2 sentences of explanation.
|
|
@@ -665,35 +750,114 @@ What the category does — and, for structured data, does not — decide:
|
|
|
665
750
|
|
|
666
751
|
- A grid of 3–6 short benefits → `website-section-feature-benefit-summary`.
|
|
667
752
|
- Pricing tier comparison → `website-section-pricing`.
|
|
668
|
-
-
|
|
669
|
-
`website-
|
|
753
|
+
- The product's interface shown as a framed screen, bento or tabs →
|
|
754
|
+
`website-section-product-showcase`; motion on a detail's screenshot
|
|
755
|
+
(unveil, zoom) is `website-motion-design`, not a reason to leave this skill.
|
|
756
|
+
- The row's colours, type or spacing → `website-theme-authoring`; the block reads them from the theme.
|
|
670
757
|
|
|
671
758
|
## Workflow
|
|
672
759
|
|
|
673
760
|
### Step 1: One section instance per feature
|
|
674
761
|
|
|
675
|
-
Stacking three feature-detail
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
762
|
+
Stacking three feature-detail rows means three configured sections
|
|
763
|
+
(or one section factory that produces them), each with a distinct `sectionRef`
|
|
764
|
+
named after its page and feature (`features-tasks`,
|
|
765
|
+
`features-collaboration`). One section holding several rows stamped out
|
|
766
|
+
with `.map(…)` is a summary, not a detail.
|
|
767
|
+
|
|
768
|
+
### Step 2: Configure the row
|
|
769
|
+
|
|
770
|
+
The config is a `WebsiteFeatureRowProps`; the band around it is the section's:
|
|
771
|
+
|
|
772
|
+
| Choice | Where | Values |
|
|
773
|
+
|---|---|---|
|
|
774
|
+
| The surface this row sits on | `band.tone` | `WebsiteSurfaceTone.DEFAULT` · `TINTED` · `INVERSE` · `BRAND` |
|
|
775
|
+
| The side the visual sits on | config `layout` | `WebsiteFeatureRowLayout.VISUAL_END` (default) · `VISUAL_START` |
|
|
776
|
+
| Whether the copy opens with an eyebrow | config `eyebrow` | `true` (default) · `false` |
|
|
777
|
+
| Whether a paragraph follows the heading | config `body` | `true` (default) · `false` when the points carry the argument alone |
|
|
778
|
+
| The points the copy lists | config `points` | `{ ref, icon? }[]`, optional — none (or an empty list) renders no list; a check is drawn when a point has no icon |
|
|
779
|
+
| The page that argues it further | config `link` | a `WebsiteLinkTo`, usually `{ kind: WebsiteMenuLinkKind.PAGE, routePath }` |
|
|
780
|
+
| The visual | config `visual` | a React node: a `WebsiteImage` (Step 4) or a drawn demo (Step 5) |
|
|
781
|
+
| The heading's level | config `headingLevel` | 2 (default), or 3 for a row nested under another section's heading |
|
|
782
|
+
|
|
783
|
+
The row carries its own heading, so the section takes NO `intro` (the type refuses
|
|
784
|
+
one): an intro above it would make one section with two titles. It stands on a band,
|
|
785
|
+
so the section takes `band` (`tone`, `spacing`, `decoration`).
|
|
786
|
+
|
|
787
|
+
The alternation is decided where the instances are configured, in page order:
|
|
788
|
+
each section binds its own `layout`, and the block renders the side it is
|
|
789
|
+
given. The page renders each section with no props, so a page cannot hand a row
|
|
790
|
+
its layout, points or visual — every choice is in the section's `config`.
|
|
791
|
+
Two consecutive rows on the same tone read as one band (the second drops its top
|
|
792
|
+
padding); change the tone between them only when the page's rhythm asks for it.
|
|
793
|
+
|
|
794
|
+
### Step 3: Let the words follow the config
|
|
795
|
+
|
|
796
|
+
The block derives the section's words from the config it renders (it runs
|
|
797
|
+
`websiteFeatureRowSlots(config)` for you): `eyebrow` (unless `eyebrow` is false),
|
|
798
|
+
`heading`, `body` (unless `body` is false), then `<ref>.title` and `<ref>.body`
|
|
799
|
+
for each point, and `link` when a link is given. Nothing is listed by hand: add a
|
|
800
|
+
point to the config and its words are declared; drop the link and its word goes.
|
|
801
|
+
The section derives the full `website.<page>.<section>.<slot>` keys and refuses a
|
|
802
|
+
slot declared twice.
|
|
803
|
+
|
|
804
|
+
The block does not know what its VISUAL reads. Declare those words as the
|
|
805
|
+
section's `nodeSlots`: the screenshot's `visual-alt`, or a drawn demo's frame
|
|
806
|
+
label, pause and play words and its screen's words, under the prefix the drawing
|
|
807
|
+
reads them by (`prefixedWebsiteSlots('demo', …)`).
|
|
808
|
+
|
|
809
|
+
### Step 3b: A capability's facts in rows — `websiteFactTableBlock`
|
|
810
|
+
|
|
811
|
+
When the detail is a set of facts rather than an argument (limits, retention
|
|
812
|
+
periods, what each plan keeps), configure `websiteFactTableBlock.section({ …,
|
|
813
|
+
category: WebsiteSectionCategory.FEATURE_DETAIL, band, intro, config: { rows,
|
|
814
|
+
columns } })`. It takes the section `intro` (its heading names the table), and its
|
|
815
|
+
words follow from the config: `caption`, `<column>.name` per column, and
|
|
816
|
+
`<row>.<column>` per cell. The caption is read by assistive technology only unless
|
|
817
|
+
`showCaption` is set. A config builder in the site's kit can number the rows and
|
|
818
|
+
columns once (`row1`…, `column1`…), so a section passes only how many there are.
|
|
819
|
+
|
|
820
|
+
### Step 4: A screenshot visual is a `WebsiteImage` with its size
|
|
821
|
+
|
|
822
|
+
Put in the config's `visual` a small component that renders `WebsiteImage` with
|
|
823
|
+
explicit `width` and `height` (so the page does not shift as it loads) and its
|
|
824
|
+
`alt` from the section's own `visual-alt` slot (`useWebsiteLabel('visual-alt')`),
|
|
825
|
+
declared as a `nodeSlots` word. The block's visual point carries its `SCALE`
|
|
826
|
+
reveal; nothing more is needed for motion.
|
|
827
|
+
|
|
828
|
+
### Step 5: When the visual is a drawn demo, play it in the demo frame
|
|
829
|
+
|
|
830
|
+
A website plan often gives a feature row's visual as a DRAWN DEMO — the
|
|
831
|
+
product's own screen drawn with the kit's atoms, moving through one short
|
|
832
|
+
scenario — instead of a screenshot. Then the visual is not a
|
|
833
|
+
`WebsiteImage`: it is a `WebsiteMotionDemo` (its `label`, `pauseLabel`
|
|
834
|
+
and `playLabel` from the label pack, in place of `visual-alt`), whose
|
|
835
|
+
frame gives the visitor the pause control WCAG 2.2.2 requires, pauses it
|
|
836
|
+
off screen, and shows its finished last step under reduced motion. Its
|
|
837
|
+
words, and its screen's, are the section's `nodeSlots`. Draw
|
|
838
|
+
only what the application shows, write the scenario as data and play it with
|
|
839
|
+
`useWebsiteDemoScenario`: `website-section-product-showcase` Step 2a teaches
|
|
840
|
+
the drawing and the scenario, `website-motion-design` Step 6 the frame, and
|
|
841
|
+
`website-building-blocks`' `references/framework-website-demo-examples.md`
|
|
842
|
+
has a worked demo per archetype.
|
|
843
|
+
|
|
844
|
+
### Step 6: Make it this site's own without forking the block
|
|
845
|
+
|
|
846
|
+
In this order: the theme (`website-theme-authoring`), the config of Step 2,
|
|
847
|
+
a config builder in the site's kit that fixes its icon set and link shape once,
|
|
848
|
+
and last an ordinary CSS rule on a hook (`[data-website-block='feature-row']
|
|
849
|
+
[data-website-part='visual']`). The block's CSS sits in the `wildo-website`
|
|
850
|
+
cascade layer, so an unlayered site rule wins without `!important`; read
|
|
851
|
+
colours from the current tone (`var(--website-tone-foreground)`). The block's
|
|
852
|
+
reveals (`COPY` rises, `VISUAL` scales) are adjusted through the config's `motion`,
|
|
853
|
+
keyed by `WebsiteFeatureRowMotionPoint`, or set to `null` to keep a point still.
|
|
690
854
|
|
|
691
855
|
**Stop** after the feature-detail section renders and the
|
|
692
|
-
label-pack audit covers every declared
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
856
|
+
label-pack audit covers every declared slot; if a word of the visual shows its
|
|
857
|
+
key as text or the image lacks an alt, **return to Step 3** — the row's own words
|
|
858
|
+
follow its config, but a visual's words are declared only through `nodeSlots`,
|
|
859
|
+
and the build checks every locale's pack against the declared slots, NOT what is
|
|
860
|
+
rendered at runtime.
|
|
697
861
|
|
|
698
862
|
## Structured data (AEO)
|
|
699
863
|
|
|
@@ -723,93 +887,192 @@ for a page block in `website/src/content/llms.txt`.
|
|
|
723
887
|
|
|
724
888
|
## Worked Example
|
|
725
889
|
|
|
726
|
-
|
|
890
|
+
A site fixes its row choices once, in a config builder for the feature row: its
|
|
891
|
+
icon set for the points (a check unless a glyph is given), its link shape, and
|
|
892
|
+
`reverse` mapped to `WebsiteFeatureRowLayout.VISUAL_START`. It returns the row's
|
|
893
|
+
config, `WebsiteFeatureRowProps`:
|
|
894
|
+
|
|
895
|
+
|
|
896
|
+
## Usage Example
|
|
897
|
+
|
|
898
|
+
```tsx
|
|
899
|
+
/** The hero's actions: the application's sign-up, and a page of this site. */
|
|
900
|
+
const heroActions = (secondaryRoutePath: string) => ({
|
|
901
|
+
primaryAction: { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP } as const,
|
|
902
|
+
secondaryAction: { kind: WebsiteMenuLinkKind.PAGE, routePath: secondaryRoutePath } as const,
|
|
903
|
+
});
|
|
904
|
+
|
|
905
|
+
/** The brand's three forward-leaning stripes, the site's motif behind its hero and its closing call to action. */
|
|
906
|
+
function Stripes({ className }: { className: string }): ReactNode {
|
|
907
|
+
return (
|
|
908
|
+
<span className={className}>
|
|
909
|
+
<i />
|
|
910
|
+
<i />
|
|
911
|
+
<i />
|
|
912
|
+
</span>
|
|
913
|
+
);
|
|
914
|
+
}
|
|
915
|
+
|
|
916
|
+
/**
|
|
917
|
+
* A page's opening: the engine's hero with this site's choices, the glow-over-grid surface, the stripes motif, and
|
|
918
|
+
* the application's sign-up as the primary action. `WebsiteHeroLayout.STAGE` is the home page's product stage, `SPLIT`
|
|
919
|
+
* puts the visual beside the copy; without a visual the engine makes it a compact opening.
|
|
920
|
+
*/
|
|
921
|
+
export function heroConfig({
|
|
922
|
+
secondaryRoutePath,
|
|
923
|
+
visual,
|
|
924
|
+
note = false,
|
|
925
|
+
layout = WebsiteHeroLayout.SPLIT,
|
|
926
|
+
}: {
|
|
927
|
+
secondaryRoutePath: string;
|
|
928
|
+
visual?: ReactNode;
|
|
929
|
+
note?: boolean;
|
|
930
|
+
layout?: WebsiteHeroLayout;
|
|
931
|
+
}): WebsiteHeroProps {
|
|
932
|
+
return {
|
|
933
|
+
layout,
|
|
934
|
+
surface: WebsiteHeroSurface.GLOW_GRID,
|
|
935
|
+
decoration: <Stripes className="brand-stripes" />,
|
|
936
|
+
note,
|
|
937
|
+
...(visual === undefined ? {} : { visual }),
|
|
938
|
+
...heroActions(secondaryRoutePath),
|
|
939
|
+
};
|
|
940
|
+
}
|
|
941
|
+
```
|
|
942
|
+
|
|
943
|
+
## Usage Example
|
|
944
|
+
|
|
945
|
+
```tsx
|
|
946
|
+
/**
|
|
947
|
+
* The copy on one side — what it is, why it matters, its points — and the product doing it on the other. `reverse`
|
|
948
|
+
* swaps the sides, so consecutive rows zig-zag. Each point carries its glyph, a check unless one is given.
|
|
949
|
+
*/
|
|
950
|
+
export function featureRowConfig({
|
|
951
|
+
visual,
|
|
952
|
+
bullets = 3,
|
|
953
|
+
icons,
|
|
954
|
+
linkRoutePath,
|
|
955
|
+
reverse = false,
|
|
956
|
+
}: {
|
|
957
|
+
visual: ReactNode;
|
|
958
|
+
bullets?: number;
|
|
959
|
+
icons?: readonly WtIcon[];
|
|
960
|
+
linkRoutePath?: string;
|
|
961
|
+
reverse?: boolean;
|
|
962
|
+
}): WebsiteFeatureRowProps {
|
|
963
|
+
return {
|
|
964
|
+
points: indexes(bullets).map((index) => ({ ref: `point${index}`, icon: <Icon name={icons?.[index - 1] ?? WtIcon.CHECK} /> })),
|
|
965
|
+
visual,
|
|
966
|
+
layout: reverse ? WebsiteFeatureRowLayout.VISUAL_START : WebsiteFeatureRowLayout.VISUAL_END,
|
|
967
|
+
...(linkRoutePath === undefined ? {} : { link: { kind: WebsiteMenuLinkKind.PAGE, routePath: linkRoutePath } as const }),
|
|
968
|
+
};
|
|
969
|
+
}
|
|
970
|
+
```
|
|
971
|
+
|
|
972
|
+
The framework's reference application then configures a row as a section: on the
|
|
973
|
+
inverse band, the config from that builder (four points, their glyphs, the page
|
|
974
|
+
that argues it, the visual a drawn demo in the site's demo frame), and the words
|
|
975
|
+
that drawing reads as `nodeSlots`. The row's own words are not listed: the block
|
|
976
|
+
derives them from the config.
|
|
977
|
+
|
|
978
|
+
|
|
979
|
+
## Usage Example
|
|
980
|
+
|
|
981
|
+
```tsx
|
|
982
|
+
// A section is an engine block, configured: the block renders the config, and the section's words are derived from
|
|
983
|
+
// the same config. The drawing inside the config reads words of its own, declared as `nodeSlots`.
|
|
984
|
+
const ASSISTANT_POINT_ICONS: readonly WtIcon[] = [WtIcon.APPROVE, WtIcon.SEARCH, WtIcon.CLOCK, WtIcon.PLUG];
|
|
985
|
+
const ASSISTANT_VISUAL: VisualSpec = { draw: (prefix) => <ApprovalLadder prefix={prefix} />, slots: approvalLadderSlots };
|
|
986
|
+
|
|
987
|
+
export const LANDING_ASSISTANT_SECTION = websiteFeatureRowBlock.section({
|
|
988
|
+
pageRef: PAGE_REF,
|
|
989
|
+
sectionRef: 'landing-assistant',
|
|
990
|
+
category: WebsiteSectionCategory.FEATURE_DETAIL,
|
|
991
|
+
band: { tone: WebsiteSurfaceTone.INVERSE },
|
|
992
|
+
config: featureRowConfig({ bullets: 4, icons: ASSISTANT_POINT_ICONS, linkRoutePath: '/product/assistant', visual: visualNode(ASSISTANT_VISUAL) }),
|
|
993
|
+
nodeSlots: visualSlots(ASSISTANT_VISUAL),
|
|
994
|
+
});
|
|
995
|
+
```
|
|
996
|
+
|
|
997
|
+
Stacked rows that alternate sides, with a screenshot as the visual:
|
|
998
|
+
|
|
999
|
+
<!-- TIER C WAIVER: no anchored application usage shows the defining shape of this section kind — several feature-detail sections stacked in page order, each binding its own `WebsiteFeatureRowLayout` so the rows alternate, with a `WebsiteImage` screenshot whose `visual-alt` word the section declares as `nodeSlots`. The anchored usages above show one row with a drawn demo. Keep this inline until a stacked screenshot sequence is deliberately anchored. -->
|
|
727
1000
|
```tsx
|
|
728
1001
|
// website/src/sections/<page>.sections.tsx
|
|
1002
|
+
import type { ReactNode } from 'react';
|
|
729
1003
|
import {
|
|
730
|
-
defineWebsiteSection,
|
|
731
1004
|
useWebsiteLabel,
|
|
732
|
-
|
|
1005
|
+
websiteFeatureRowBlock,
|
|
1006
|
+
WebsiteFeatureRowLayout,
|
|
733
1007
|
WebsiteImage,
|
|
1008
|
+
WebsiteMenuLinkKind,
|
|
734
1009
|
WebsiteSectionCategory,
|
|
735
|
-
|
|
1010
|
+
type WebsiteFeaturePoint,
|
|
736
1011
|
} from '@wildo-ai/saas-website';
|
|
737
1012
|
|
|
738
|
-
|
|
739
|
-
imagePosition: 'left' | 'right';
|
|
740
|
-
imageSrc: string;
|
|
741
|
-
imageWidth: number;
|
|
742
|
-
imageHeight: number;
|
|
743
|
-
}
|
|
744
|
-
|
|
745
|
-
function FeatureDetailComponent({
|
|
746
|
-
imagePosition,
|
|
747
|
-
imageSrc,
|
|
748
|
-
imageWidth,
|
|
749
|
-
imageHeight,
|
|
750
|
-
}: FeatureDetailSectionProps) {
|
|
751
|
-
const title = useWebsiteLabel('title');
|
|
752
|
-
const description = useWebsiteLabel('description');
|
|
753
|
-
const bullet1 = useWebsiteLabel('bullet-1');
|
|
754
|
-
const bullet2 = useWebsiteLabel('bullet-2');
|
|
755
|
-
const bullet3 = useWebsiteLabel('bullet-3');
|
|
756
|
-
const imageAlt = useWebsiteLabel('image-alt');
|
|
1013
|
+
import { BoltIcon, UsersIcon } from './icons';
|
|
757
1014
|
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
<div className="feature-detail__copy">
|
|
761
|
-
<WebsiteHeading level={2} variant="title">{title}</WebsiteHeading>
|
|
762
|
-
<WebsiteText variant="lead">{description}</WebsiteText>
|
|
763
|
-
<ul className="feature-detail__bullets">
|
|
764
|
-
<li>{bullet1}</li>
|
|
765
|
-
<li>{bullet2}</li>
|
|
766
|
-
<li>{bullet3}</li>
|
|
767
|
-
</ul>
|
|
768
|
-
</div>
|
|
769
|
-
<WebsiteImage
|
|
770
|
-
src={imageSrc}
|
|
771
|
-
alt={imageAlt}
|
|
772
|
-
width={imageWidth}
|
|
773
|
-
height={imageHeight}
|
|
774
|
-
/>
|
|
775
|
-
</div>
|
|
776
|
-
);
|
|
1015
|
+
function Screenshot({ src }: { src: string }): ReactNode {
|
|
1016
|
+
return <WebsiteImage src={src} alt={useWebsiteLabel('visual-alt')} width={1200} height={800} />;
|
|
777
1017
|
}
|
|
778
1018
|
|
|
779
|
-
/**
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
const root = `website.${pageRef}.${sectionRef}` as const;
|
|
785
|
-
return defineWebsiteSection<FeatureDetailSectionProps>({
|
|
786
|
-
sectionRef,
|
|
1019
|
+
/** One feature, one section: its points, its screenshot, the side the visual sits on, the page that argues it. */
|
|
1020
|
+
function featureDetail(instance: { sectionRef: string; layout: WebsiteFeatureRowLayout; points: readonly WebsiteFeaturePoint[]; src: string; routePath: string }) {
|
|
1021
|
+
return websiteFeatureRowBlock.section({
|
|
1022
|
+
pageRef: 'features',
|
|
1023
|
+
sectionRef: instance.sectionRef,
|
|
787
1024
|
category: WebsiteSectionCategory.FEATURE_DETAIL,
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
1025
|
+
// The row declares eyebrow, heading, body, <ref>.title and <ref>.body per point, and link, from this config.
|
|
1026
|
+
config: {
|
|
1027
|
+
points: instance.points,
|
|
1028
|
+
layout: instance.layout,
|
|
1029
|
+
link: { kind: WebsiteMenuLinkKind.PAGE, routePath: instance.routePath },
|
|
1030
|
+
visual: <Screenshot src={instance.src} />,
|
|
1031
|
+
},
|
|
1032
|
+
// The screenshot reads its alt itself: the block does not know it.
|
|
1033
|
+
nodeSlots: ['visual-alt'],
|
|
797
1034
|
});
|
|
798
1035
|
}
|
|
799
1036
|
|
|
800
|
-
export const
|
|
801
|
-
|
|
802
|
-
|
|
1037
|
+
export const FEATURES_TASKS_SECTION = featureDetail({
|
|
1038
|
+
sectionRef: 'features-tasks',
|
|
1039
|
+
layout: WebsiteFeatureRowLayout.VISUAL_END,
|
|
1040
|
+
points: [{ ref: 'point1' }, { ref: 'point2' }, { ref: 'point3', icon: <BoltIcon aria-hidden="true" /> }],
|
|
1041
|
+
src: '/features/tasks.png',
|
|
1042
|
+
routePath: '/product/tasks',
|
|
1043
|
+
});
|
|
1044
|
+
export const FEATURES_COLLABORATION_SECTION = featureDetail({
|
|
1045
|
+
sectionRef: 'features-collaboration',
|
|
1046
|
+
layout: WebsiteFeatureRowLayout.VISUAL_START,
|
|
1047
|
+
points: [{ ref: 'point1', icon: <UsersIcon aria-hidden="true" /> }, { ref: 'point2' }],
|
|
1048
|
+
src: '/features/collaboration.png',
|
|
1049
|
+
routePath: '/product/collaboration',
|
|
1050
|
+
});
|
|
1051
|
+
export const FEATURES_AUTOMATION_SECTION = featureDetail({
|
|
1052
|
+
sectionRef: 'features-automation',
|
|
1053
|
+
layout: WebsiteFeatureRowLayout.VISUAL_END,
|
|
1054
|
+
// No points: the body argues it alone, and the row renders no list (and declares no point words).
|
|
1055
|
+
points: [],
|
|
1056
|
+
src: '/features/automation.png',
|
|
1057
|
+
routePath: '/product/automation',
|
|
1058
|
+
});
|
|
803
1059
|
```
|
|
804
1060
|
|
|
1061
|
+
The sections hold no layout CSS, no heading markup, no hand-written list and no
|
|
1062
|
+
list of their words: the row, its stacking on a narrow screen, its reveal and its
|
|
1063
|
+
words come from the block. A section given no `band` stands on the default one.
|
|
1064
|
+
|
|
805
1065
|
## Structured-data contract
|
|
806
1066
|
|
|
807
1067
|
`FEATURE_DETAIL` does not own a dedicated JSON-LD vocabulary. The
|
|
808
|
-
page may aggregate features via `
|
|
809
|
-
|
|
1068
|
+
page may aggregate features via the `featureList` of the
|
|
1069
|
+
`SoftwareApplication` payload it publishes (from the section that owns
|
|
1070
|
+
the product claim). Do NOT emit `Product` / `Offer` / `FAQPage`
|
|
810
1071
|
from this section; they belong to the sections that own them. Nothing
|
|
811
1072
|
warns if you do — the audit checks each payload against the catalog,
|
|
812
|
-
never against the section's category.
|
|
1073
|
+
never against the section's category. Configuring `websiteFeatureRowBlock`
|
|
1074
|
+
changes nothing here: the block renders the row, and the section still
|
|
1075
|
+
decides whether `getStructuredData` exists (`.section(...)` passes it through).
|
|
813
1076
|
|
|
814
1077
|
Leave `getStructuredData` undefined unless the feature group rises
|
|
815
1078
|
to the level of an `ItemList` (see "Catalog integration" below).
|
|
@@ -824,7 +1087,7 @@ discrete, ordered set of feature items the AI assistant should be
|
|
|
824
1087
|
able to enumerate (e.g. "list every feature of Plan Pro").
|
|
825
1088
|
|
|
826
1089
|
If your section meets that bar, the emission flows the standard way:
|
|
827
|
-
the page-shell wires every section's `getStructuredData
|
|
1090
|
+
the page-shell wires every section's `getStructuredData` through
|
|
828
1091
|
the installed structured-data contract — but because `ItemList` is not in the
|
|
829
1092
|
installed catalog yet, the companion
|
|
830
1093
|
will emit a `catalog-miss` warning. The right resolution is to
|
|
@@ -839,82 +1102,135 @@ will emit a `catalog-miss` warning. The right resolution is to
|
|
|
839
1102
|
**What earns its place in this section's emission**:
|
|
840
1103
|
|
|
841
1104
|
- For a single feature row (the typical case) — nothing. Leave
|
|
842
|
-
`getStructuredData` undefined; the feature is listed
|
|
843
|
-
|
|
844
|
-
array).
|
|
1105
|
+
`getStructuredData` undefined; the feature is listed in the page's
|
|
1106
|
+
`SoftwareApplication.featureList` (string array).
|
|
845
1107
|
- For a discrete enumerable set (rare) — an `ItemList` payload with
|
|
846
|
-
`itemListElement[]` mapping 1:1 to the feature rows the
|
|
847
|
-
renders,
|
|
1108
|
+
`itemListElement[]` mapping 1:1 to the feature rows the page
|
|
1109
|
+
renders, each item's name read through `label(slot)` of the context
|
|
1110
|
+
`getStructuredData` receives, AFTER adding `ItemList` to the catalog
|
|
1111
|
+
(see above).
|
|
848
1112
|
|
|
849
1113
|
**What is NOT in this emission**:
|
|
850
1114
|
|
|
851
1115
|
- A standalone `Product` / `Offer` payload — those belong in pricing.
|
|
852
1116
|
- A `FAQPage` — those belong in the FAQ section.
|
|
853
|
-
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
**Verification grep** (run from the app root):
|
|
1117
|
+
- A duplicate of the `SoftwareApplication.featureList` — that field
|
|
1118
|
+
is the single source of truth.
|
|
857
1119
|
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
1120
|
+
**Verification**: this section's own definition declares no
|
|
1121
|
+
`getStructuredData`, or one returning an `ItemList` (a page's sections
|
|
1122
|
+
file also holds its other sections, so a file-wide grep for their types
|
|
1123
|
+
proves nothing); `wildo website audit` reports no finding for the page.
|
|
861
1124
|
|
|
862
1125
|
## References
|
|
863
1126
|
|
|
864
1127
|
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
|
|
1128
|
+
- `../website-building-blocks/references/framework-website-blocks-api.md` — source-backed `defineWebsiteBlock` and the configured blocks (`websiteFeatureRowBlock`, `websiteFactTableBlock`), `WebsiteFeatureRow`, `WebsiteFactTable` and `WebsiteBand` props, their slots, `WebsiteLinkTo` and the stylesheet hooks.
|
|
865
1129
|
|
|
866
1130
|
## Verification
|
|
867
1131
|
|
|
868
|
-
- [ ] One
|
|
869
|
-
(or a
|
|
1132
|
+
- [ ] One configured section per feature-detail instance
|
|
1133
|
+
(or a section factory, as in the worked example), each `websiteFeatureRowBlock.section(...)`
|
|
1134
|
+
— no hand-built copy/visual split, and no `defineWebsiteBlockSection` with a hand-listed slot array.
|
|
870
1135
|
- [ ] Each instance has a unique `sectionRef`.
|
|
871
|
-
- [ ] `
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
- [ ]
|
|
875
|
-
|
|
1136
|
+
- [ ] Each instance binds its own `WebsiteFeatureRowLayout` member in its config, so consecutive rows
|
|
1137
|
+
alternate; the layout is never a label key and never something the page passes.
|
|
1138
|
+
- [ ] No `intro` beside a feature row (it carries its own heading); its surface is the section's `band`.
|
|
1139
|
+
- [ ] Its words follow its config; the only words declared beside it are `nodeSlots` its visual reads
|
|
1140
|
+
itself (`visual-alt`, a demo's frame and screen words).
|
|
1141
|
+
- [ ] A link is a `WebsiteLinkTo`, never a typed `href`.
|
|
1142
|
+
- [ ] `WebsiteImage` always receives explicit `width`+`height`, so the
|
|
1143
|
+
image's space is reserved and the page does not shift as it loads.
|
|
1144
|
+
- [ ] A drawn-demo visual plays inside `WebsiteMotionDemo`: a kit drawing
|
|
1145
|
+
played by a scenario through `useWebsiteDemoScenario` (Step 5).
|
|
1146
|
+
- [ ] A facts table is `websiteFactTableBlock.section(...)` with an `intro`, never a hand-built `<table>`.
|
|
1147
|
+
- [ ] The look is adjusted through the theme, the config, or a rule on a `data-website-*`
|
|
1148
|
+
hook — no copied row markup, no `!important`, no raw colour.
|
|
876
1149
|
|
|
877
1150
|
### Grep invariants
|
|
878
1151
|
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
1152
|
+
`npx astro check` in `website/` must pass: `.section(...)` refuses an `intro` beside a
|
|
1153
|
+
feature row, and a config that is not the block's props. Then, from the app root:
|
|
1154
|
+
|
|
1155
|
+
```bash
|
|
1156
|
+
# Each instance is the engine's row, configured (>= 1 per instance, or one in the section factory)
|
|
1157
|
+
rg -n "websiteFeatureRowBlock\.section\(" website/src/sections
|
|
1158
|
+
|
|
1159
|
+
# No row whose words are listed by hand (must return empty)
|
|
1160
|
+
rg -n "websiteFeatureRowSlots\(" website/src/sections
|
|
1161
|
+
|
|
1162
|
+
# Category enum (must return >= 1 per instance)
|
|
1163
|
+
rg -n "FEATURE_DETAIL" website/src/sections/<page>.sections.tsx
|
|
1164
|
+
|
|
1165
|
+
# The rows alternate: both layout members (or the site builder's reverse flag) appear when two or more rows are stacked
|
|
1166
|
+
rg -n "WebsiteFeatureRowLayout\.(VISUAL_END|VISUAL_START)|reverse: true" website/src/sections
|
|
1167
|
+
|
|
1168
|
+
# Image dimensions present (each WebsiteImage must have both)
|
|
1169
|
+
rg -n "WebsiteImage" -A 3 website/src/sections/<page>.sections.tsx | rg -n "width=|height="
|
|
1170
|
+
|
|
1171
|
+
# A facts table is the engine's block (no hand-built table; must return empty)
|
|
1172
|
+
rg -n "<table" website/src/sections
|
|
1173
|
+
|
|
1174
|
+
# No typed link (must return empty: a link is a WebsiteLinkTo)
|
|
1175
|
+
rg -n "href=" website/src/sections/<page>.sections.tsx
|
|
1176
|
+
|
|
1177
|
+
# A drawn demo plays in the frame (each scenario sits inside a WebsiteMotionDemo; no bare timer, no hand-timed steps)
|
|
1178
|
+
rg -n "useWebsiteDemoScenario|useWebsiteMotionDemoTimeline|setInterval|setTimeout" website/src/sections/
|
|
1179
|
+
|
|
1180
|
+
# !important or a raw colour against the block (must return empty)
|
|
1181
|
+
rg -n '!important|#[0-9a-fA-F]{3,8}\b' website/src/styles
|
|
1182
|
+
```
|
|
885
1183
|
|
|
886
1184
|
## Common Rationalizations
|
|
887
1185
|
|
|
888
1186
|
| Rationalization | Reality |
|
|
889
1187
|
|---|---|
|
|
890
|
-
| "I'll alternate
|
|
891
|
-
| "I'll
|
|
1188
|
+
| "I'll alternate the visual's side based on instance index inside the component" | Each section binds its own `layout` in its config; the alternation is decided by the sections, in page order. A component that alternates by index breaks a single row and any reordering. |
|
|
1189
|
+
| "I'll copy the row's JSX to change its spacing" | The copy stops following the theme, the motion vocabulary and every fix to the block. Change the theme, the config, or one rule on a `data-website-*` hook. |
|
|
1190
|
+
| "I'll wrap `WebsiteFeatureRow` in my own component and list its words with `defineWebsiteBlockSection`" | Then the words are listed apart from what renders. Return the config from a builder in the site's kit and let `websiteFeatureRowBlock.section` render it. |
|
|
1191
|
+
| "The row needs a section intro above it" | It carries its own eyebrow, heading and body; an intro would give the section two titles, and the type refuses it. |
|
|
1192
|
+
| "The page can pass each instance its image and layout" | The page renders each section with no props. Bind them in the instance's config. |
|
|
1193
|
+
| "I'll skip width/height on the image — CSS handles it" | CSS layout doesn't fix CLS; the browser needs intrinsic dimensions to reserve space before the image loads. |
|
|
892
1194
|
| "All instances can share one `sectionRef`" | The label-pack validator and the analytics layer both rely on per-section refs. Reuse breaks both. |
|
|
893
|
-
| "
|
|
1195
|
+
| "The screenshot's alt is part of the row, the block declares it" | The block knows its own words, not its visual's. Declare `visual-alt` (or the demo's words) as `nodeSlots`. |
|
|
894
1196
|
|
|
895
1197
|
## Red Flags
|
|
896
1198
|
|
|
897
|
-
- A single `
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
1199
|
+
- A single `FEATURE_DETAIL` section with three internal "features"
|
|
1200
|
+
stamped out via a `.map(…)` — that's a feature-summary shape; use
|
|
1201
|
+
`website-section-feature-benefit-summary` instead. Catch with the
|
|
1202
|
+
"Category enum" grep above (one hit per instance, not one per page).
|
|
1203
|
+
- A hand-built copy/visual split (`<div className="feature-detail">`, a
|
|
1204
|
+
`WebsiteHeading` beside an image) instead of the configured row —
|
|
1205
|
+
catch with the "engine's row, configured" grep above.
|
|
1206
|
+
- Feature-row words listed by hand (`websiteFeatureRowSlots(...)` spread into a `slots` array, or
|
|
1207
|
+
keys written out) — translators ship copy for a slot nothing renders, or a rendered point shows its
|
|
1208
|
+
key. Catch with the "listed by hand" grep above.
|
|
1209
|
+
- Every stacked row on the same side — catch with the alternation grep above.
|
|
1210
|
+
- A screenshot without intrinsic dimensions — catch with the image-dimensions grep above.
|
|
1211
|
+
- An `intro` passed beside a feature row, or a band drawn around it by hand — the row carries its
|
|
1212
|
+
heading and the section draws its band; catch with `npx astro check`.
|
|
1213
|
+
- A hand-built facts `<table>` — catch with the table grep above.
|
|
1214
|
+
- A typed `href` on the "read more" link — catch with the "No typed link" grep above.
|
|
1215
|
+
- An animated feature visual with no pause control (a GIF, a
|
|
1216
|
+
hand-rolled timer, a CSS loop outside a demo frame) — catch with the
|
|
1217
|
+
drawn-demo grep above, and play it in `WebsiteMotionDemo` (Step 5).
|
|
1218
|
+
- `!important` or a raw colour in a rule against the row — catch with the last grep above.
|
|
909
1219
|
|
|
910
1220
|
## Related Skills
|
|
911
1221
|
|
|
1222
|
+
- `website-building-blocks` — how the engine's blocks are configured, how their words follow, and how they are adjusted without forking.
|
|
912
1223
|
- `website-page-authoring` — composing the stack of feature-detail
|
|
913
1224
|
instances into the Features page manifest.
|
|
914
1225
|
- `website-label-pack` — authoring per-instance EN/FR strings.
|
|
1226
|
+
- `website-theme-authoring` — the theme the row's look is read from.
|
|
915
1227
|
- `website-section-feature-benefit-summary` — the higher-level
|
|
916
1228
|
"why us" grid sibling.
|
|
917
1229
|
- `website-seo-aeo-geo` — page-level
|
|
918
1230
|
`SoftwareApplication.featureList` declaration.
|
|
1231
|
+
- `website-section-product-showcase` — drawing a demo from the
|
|
1232
|
+
application's resources (Step 2a).
|
|
1233
|
+
- `website-motion-design` — the demo frame, its pause control and the
|
|
1234
|
+
scenario timeline (Step 6), and the vocabulary the row's config `motion` takes.
|
|
919
1235
|
- `website-primitive-overrides` — overriding the `WebsiteImage` /
|
|
920
1236
|
`WebsiteHeading` primitives if the deep-dive needs richer media.
|