@wildo-ai/framework-knowledge 1.1.10 → 1.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +459 -76
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +11 -6
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +4 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +3 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +350 -23
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +6 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +248 -9
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +12 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +13 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +33 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +20 -3
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +97 -23
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +30 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +4 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +5 -4
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-maturity.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +238 -8
- package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +52 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +16 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/integration-plan.config.md +21 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +75 -13
- package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
- package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
- package/dist/knowledge/references/platform.config.saas.md +106 -14
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +7 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
- package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +18 -16
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +10 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +89 -51
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +9 -6
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +66 -4
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
- package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
- package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
- package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +58 -6
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
- package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +58 -2
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -6
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +34 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +38 -9
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +270 -0
- package/dist/knowledge/references/website-plan.config.md +544 -32
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +73 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +75 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +4 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +32 -4
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +2411 -139
- package/dist/knowledge/registries/playbooks.json +51 -30
- package/dist/knowledge/registries/source-tags.json +8500 -4768
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/skills/INDEX.md +60 -33
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +27 -9
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +6 -6
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +124 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +35 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +3 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +134 -33
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +57 -28
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +17 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -0
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +11 -3
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +5 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
- package/dist/knowledge/skills/configure-billing/SKILL.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +46 -5
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +7 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +281 -20
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +27 -17
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +136 -14
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +4 -1
- package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +107 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +9 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +9 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +2 -1
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +2 -1
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +150 -4
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +50 -27
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +26 -14
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +132 -55
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +49 -4
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +58 -2
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +102 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +6 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +18 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +60 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +1 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +195 -23
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +176 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +88 -50
- package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +3 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +26 -10
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +9 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +79 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +32 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +116 -66
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +203 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +155 -76
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +19 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +168 -58
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +141 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +66 -4
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +5 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +11 -4
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +251 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1064 -192
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +39 -18
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +24 -3
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +561 -302
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +647 -274
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +572 -264
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +603 -332
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +549 -378
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +739 -315
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +16442 -8572
- package/package.json +4 -4
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md
ADDED
|
@@ -0,0 +1,3050 @@
|
|
|
1
|
+
# Website building blocks — API (source-backed)
|
|
2
|
+
|
|
3
|
+
The blocks a section composes, their layout vocabulary, how a section declares the words they read, how a link
|
|
4
|
+
resolves, and the stylesheet hooks a site adjusts them through. Read it when you need a block's exact props, a slot
|
|
5
|
+
name, or the hook a CSS rule should target.
|
|
6
|
+
|
|
7
|
+
## The layout vocabulary
|
|
8
|
+
|
|
9
|
+
## Import Origins
|
|
10
|
+
|
|
11
|
+
- `@wildo-ai/saas-website`
|
|
12
|
+
|
|
13
|
+
## Source Excerpts
|
|
14
|
+
|
|
15
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
16
|
+
|
|
17
|
+
```typescript
|
|
18
|
+
*
|
|
19
|
+
* The layout vocabulary of the engine's building blocks (#2742). A block's LAYOUT is chosen per use and is never its
|
|
20
|
+
* section category: one card grid serves a feature summary, an integrations list and a values section.
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
/** How much vertical room a band takes (`rhythm.section`, `rhythm.sectionCompact`, `rhythm.strip`). */
|
|
24
|
+
export enum WebsiteBandSpacing {
|
|
25
|
+
/** A section. */
|
|
26
|
+
DEFAULT = 'default',
|
|
27
|
+
/** A section that should not dominate: a short note between two long sections. */
|
|
28
|
+
COMPACT = 'compact',
|
|
29
|
+
/** A thin row between hairlines: a logo strip, a marquee. */
|
|
30
|
+
STRIP = 'strip',
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** How a section's intro sits. */
|
|
34
|
+
export enum WebsiteIntroAlign {
|
|
35
|
+
/** Centred above the content: most sections. */
|
|
36
|
+
CENTER = 'center',
|
|
37
|
+
/** Aligned with the content's start edge: an intro beside a list, an FAQ's side column. */
|
|
38
|
+
START = 'start',
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** How an eyebrow (the label above a heading) is drawn. */
|
|
42
|
+
export enum WebsiteEyebrowStyle {
|
|
43
|
+
/** The overline type role in the brand colour. */
|
|
44
|
+
PLAIN = 'plain',
|
|
45
|
+
/** A pill with the accent's dot: the hero's opening line. */
|
|
46
|
+
PILL = 'pill',
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** How a hero lays out its copy and its visual. */
|
|
50
|
+
export enum WebsiteHeroLayout {
|
|
51
|
+
/** The copy centred above a full-width visual: the home page's product stage. */
|
|
52
|
+
STAGE = 'stage',
|
|
53
|
+
/** The copy beside the visual, the visual taking the larger column: a product or solution page. */
|
|
54
|
+
SPLIT = 'split',
|
|
55
|
+
/** No visual: the copy centred, a shorter opening. Used automatically when no visual is given. */
|
|
56
|
+
COMPACT = 'compact',
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** What a hero draws behind its content. */
|
|
60
|
+
export enum WebsiteHeroSurface {
|
|
61
|
+
/** The band's own background. */
|
|
62
|
+
PLAIN = 'plain',
|
|
63
|
+
/** A soft glow of the brand's colour from the top. */
|
|
64
|
+
GLOW = 'glow',
|
|
65
|
+
/** The glow over a faint grid that fades toward the edges. */
|
|
66
|
+
GLOW_GRID = 'glow-grid',
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** Which side of a feature row the visual sits on; alternate them so consecutive rows zig-zag. */
|
|
70
|
+
export enum WebsiteFeatureRowLayout {
|
|
71
|
+
/** The copy first, the visual after it (on the right in a left-to-right page). */
|
|
72
|
+
VISUAL_END = 'visual-end',
|
|
73
|
+
/** The visual first. */
|
|
74
|
+
VISUAL_START = 'visual-start',
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** How many columns a card grid has on a wide screen. On smaller screens 4 narrows to 2 then 1; 2 and 3 go to 1. */
|
|
78
|
+
export type WebsiteCardGridColumns = 2 | 3 | 4;
|
|
79
|
+
|
|
80
|
+
/** How a grid of cards lays out its columns: a fixed count, or as many as fit (`layout.cardMin` wide at least). */
|
|
81
|
+
export enum WebsiteGridFit {
|
|
82
|
+
/** The `columns` the block is given, narrowing on smaller screens. */
|
|
83
|
+
FIXED = 'fixed',
|
|
84
|
+
/** As many columns as fit, each at least the theme's card width: right for a list whose length varies. */
|
|
85
|
+
AUTO = 'auto',
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** How the steps of a process run. */
|
|
89
|
+
export enum WebsiteStepsLayout {
|
|
90
|
+
/** Side by side, left to right, stacking on a narrow screen: three or four short steps. */
|
|
91
|
+
ROW = 'row',
|
|
92
|
+
/** One under the other: longer steps, or more of them. */
|
|
93
|
+
STACK = 'stack',
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** How big an icon tile is: the square of colour behind a glyph. */
|
|
97
|
+
export enum WebsiteIconTileSize {
|
|
98
|
+
/** Beside a line of text: a point of a list. */
|
|
99
|
+
SM = 'sm',
|
|
100
|
+
/** Leading a card. */
|
|
101
|
+
MD = 'md',
|
|
102
|
+
/** Leading a card that is a choice: a path, a plan. */
|
|
103
|
+
LG = 'lg',
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** How an icon tile is coloured. */
|
|
107
|
+
export enum WebsiteIconTileStyle {
|
|
108
|
+
/** The glyph in the tone's primary on a wash of it: quiet, the default. */
|
|
109
|
+
WASH = 'wash',
|
|
110
|
+
/** The glyph in the tone's background on its foreground: strong, for a card that is a choice. */
|
|
111
|
+
SOLID = 'solid',
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* How long a product tour's tab stays before the tour moves on, while it rotates (ms). One value for the component's
|
|
116
|
+
* clock and the stylesheet's countdown line, so the line always ends as the tab changes.
|
|
117
|
+
*/
|
|
118
|
+
export const WEBSITE_PRODUCT_TOUR_DWELL_MS = 7000;
|
|
119
|
+
|
|
120
|
+
/** How long a marquee's strip takes to scroll one copy of its list (s): slow enough to read a pill as it passes. */
|
|
121
|
+
export const WEBSITE_MARQUEE_LOOP_SECONDS = 38;
|
|
122
|
+
|
|
123
|
+
/** How much of a bento's row a tile takes: a third, or a half. */
|
|
124
|
+
export enum WebsiteBentoTileSize {
|
|
125
|
+
/** A third of the row: three tiles side by side. */
|
|
126
|
+
REGULAR = 'regular',
|
|
127
|
+
/** Half the row: the capability that leads, or a drawing that needs the room. */
|
|
128
|
+
WIDE = 'wide',
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/** How an FAQ lays out its intro and its questions. */
|
|
132
|
+
export enum WebsiteFaqLayout {
|
|
133
|
+
/** The intro in a narrow column beside the questions. */
|
|
134
|
+
SIDE = 'side',
|
|
135
|
+
/** The intro above the questions. */
|
|
136
|
+
STACKED = 'stacked',
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* A block's motion, point by point: each named point of the block takes a `WebsiteMotionSpec`, or `null` to keep
|
|
141
|
+
* that point still. Points left out keep the block's defaults. The vocabulary is the engine's (`websiteMotion`), so a
|
|
142
|
+
* block's motion follows the site's tempo and stops under reduced motion like everything else.
|
|
143
|
+
*/
|
|
144
|
+
export type WebsiteBlockMotion<TPoint extends string> = Partial<Readonly<Record<TPoint, WebsiteMotionSpec | null>>>;
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* What a block's motion point IS, which decides what motion it may take (#2742 step 4). A block declares each of its
|
|
148
|
+
* points with a kind, and says whether the point belongs to the page's OPENING (the load sequence). Its default and
|
|
149
|
+
* every override are checked against both, so a site, a skill or the creation lane can only ask a point for motion that
|
|
150
|
+
* makes sense there. The rules are a table total over the kinds (`WEBSITE_MOTION_POINT_RULES`): a new kind does not
|
|
151
|
+
* compile until its rules are decided.
|
|
152
|
+
*/
|
|
153
|
+
export enum WebsiteMotionPointKind {
|
|
154
|
+
/** Copy that arrives as a whole: an intro, a feature row's copy, a closing band, a table, a line of the hero. */
|
|
155
|
+
COPY = 'copy',
|
|
156
|
+
/** A list or grid whose children arrive one after another. */
|
|
157
|
+
GROUP = 'group',
|
|
158
|
+
/** A card that is a link. */
|
|
159
|
+
LINK_CARD = 'link-card',
|
|
160
|
+
/** A drawing or an image: the hero's visual, a feature row's visual. */
|
|
161
|
+
MEDIA = 'media',
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** What a kind of point may take. */
|
|
165
|
+
export interface WebsiteMotionPointRules {
|
|
166
|
+
/** It may sequence its children (`stagger`). */
|
|
167
|
+
readonly stagger: boolean;
|
|
168
|
+
/** It may answer the pointer (`hover`). */
|
|
169
|
+
readonly hover: boolean;
|
|
170
|
+
/** It may arrive itself (`reveal`). */
|
|
171
|
+
readonly reveal: boolean;
|
|
172
|
+
/** It may take a scroll effect, or arrive by unveiling. */
|
|
173
|
+
readonly media: boolean;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
export const WEBSITE_MOTION_POINT_RULES: Readonly<Record<WebsiteMotionPointKind, WebsiteMotionPointRules>> = {
|
|
177
|
+
[WebsiteMotionPointKind.COPY]: { stagger: false, hover: false, reveal: true, media: false },
|
|
178
|
+
[WebsiteMotionPointKind.GROUP]: { stagger: true, hover: false, reveal: true, media: false },
|
|
179
|
+
// A link card never arrives itself: its group sequences it.
|
|
180
|
+
[WebsiteMotionPointKind.LINK_CARD]: { stagger: false, hover: true, reveal: false, media: false },
|
|
181
|
+
[WebsiteMotionPointKind.MEDIA]: { stagger: false, hover: false, reveal: true, media: true },
|
|
182
|
+
};
|
|
183
|
+
|
|
184
|
+
/** One motion point of a block: what it is, whether it belongs to the page's opening, and how it moves by default. */
|
|
185
|
+
export interface WebsiteMotionPointDefault {
|
|
186
|
+
readonly kind: WebsiteMotionPointKind;
|
|
187
|
+
/**
|
|
188
|
+
* The point is part of the page's opening: it plays on load, in its `order`. Only such a point may take
|
|
189
|
+
* `trigger: LOAD`, and such a point takes a load reveal or no motion at all (no in-view reveal, no stagger, no scroll
|
|
190
|
+
* effect, no hover), so the opening is exactly the points the blocks declare as such: the hero's eyebrow, headline,
|
|
191
|
+
* lede, actions, note and visual. Whether a page has more than one opening (two heroes) is the page motion plan's
|
|
192
|
+
* question, not a point's.
|
|
193
|
+
*/
|
|
194
|
+
readonly opening?: boolean;
|
|
195
|
+
readonly spec: WebsiteMotionSpec | null;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/** Why a spec does not fit a point, or null when it fits. */
|
|
199
|
+
export function websiteMotionPointMisfit(kind: WebsiteMotionPointKind, spec: WebsiteMotionSpec | null, opening = false): string | null {
|
|
200
|
+
if (spec === null) return null;
|
|
201
|
+
// One widened view: the exclusive union is the caller's contract (see `websiteMotion`).
|
|
202
|
+
const { reveal, trigger, stagger, scroll, hover } = spec as {
|
|
203
|
+
readonly reveal?: WebsiteMotionReveal;
|
|
204
|
+
readonly trigger?: WebsiteMotionTrigger;
|
|
205
|
+
readonly stagger?: WebsiteMotionReveal;
|
|
206
|
+
readonly scroll?: WebsiteMotionScrollEffect;
|
|
207
|
+
readonly hover?: WebsiteMotionHover;
|
|
208
|
+
};
|
|
209
|
+
const rules = WEBSITE_MOTION_POINT_RULES[kind];
|
|
210
|
+
const moves = (value: WebsiteMotionReveal | undefined) => value !== undefined && value !== WebsiteMotionReveal.NONE;
|
|
211
|
+
const scrolls = scroll !== undefined && scroll !== WebsiteMotionScrollEffect.NONE;
|
|
212
|
+
// The kinds the table allows a capability, so a message names them from the same table that decided.
|
|
213
|
+
const allowed = (rule: keyof WebsiteMotionPointRules): string[] =>
|
|
214
|
+
(Object.keys(WEBSITE_MOTION_POINT_RULES) as WebsiteMotionPointKind[])
|
|
215
|
+
.filter((candidate) => WEBSITE_MOTION_POINT_RULES[candidate][rule])
|
|
216
|
+
.map((candidate) => candidate.toUpperCase().replace(/-/g, '_'));
|
|
217
|
+
const refused = (what: string, rule: keyof WebsiteMotionPointRules): string => {
|
|
218
|
+
const kinds = allowed(rule);
|
|
219
|
+
return `a ${kind.toUpperCase().replace(/-/g, '_')} point does not ${what}: ${kinds.length === 0 ? 'no kind does' : `only ${kinds.join(' or ')} does`}`;
|
|
220
|
+
};
|
|
221
|
+
if (moves(stagger) && !rules.stagger) return refused('sequence its children (stagger)', 'stagger');
|
|
222
|
+
const hovers = hover !== undefined && hover !== WebsiteMotionHover.NONE;
|
|
223
|
+
if (hovers && !rules.hover) return refused('answer the pointer (hover)', 'hover');
|
|
224
|
+
if (moves(reveal) && !rules.reveal) return refused('reveal itself', 'reveal');
|
|
225
|
+
if (scrolls && !rules.media) return refused('take a scroll effect', 'media');
|
|
226
|
+
if ((reveal === WebsiteMotionReveal.UNVEIL || stagger === WebsiteMotionReveal.UNVEIL) && !rules.media) return refused('unveil', 'media');
|
|
227
|
+
const onLoad = moves(reveal) && trigger === WebsiteMotionTrigger.LOAD;
|
|
228
|
+
if (onLoad && !opening) return 'only a point of the page\'s opening plays on load';
|
|
229
|
+
if (opening && (moves(stagger) || scrolls || hovers)) return 'a point of the page\'s opening takes a load reveal or no motion at all';
|
|
230
|
+
if (opening && moves(reveal) && !onLoad) return 'a point of the page\'s opening plays on load, in its order';
|
|
231
|
+
return null;
|
|
232
|
+
}
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
## A section is a configured block
|
|
236
|
+
|
|
237
|
+
Prefer this over composing a section by hand: `<block>.section({ pageRef, sectionRef, category, band, intro, config })`
|
|
238
|
+
renders the block from `config` and derives the section's words from the same `config`.
|
|
239
|
+
|
|
240
|
+
## Import Origins
|
|
241
|
+
|
|
242
|
+
- `@wildo-ai/saas-website`
|
|
243
|
+
|
|
244
|
+
## Source Excerpts
|
|
245
|
+
|
|
246
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
247
|
+
|
|
248
|
+
```tsx
|
|
249
|
+
*
|
|
250
|
+
* A block as a CONFIGURABLE section (#2742): the engine binds each block's renderer to the words it reads, so a
|
|
251
|
+
* section is configured, not written. `websiteHeroBlock.section({ pageRef, sectionRef, category, config })` is the
|
|
252
|
+
* whole section: the block renders the config, and the section's words are derived from THE SAME config, so a
|
|
253
|
+
* section cannot declare a word it does not render or render one it does not declare.
|
|
254
|
+
*
|
|
255
|
+
* Two properties of a block decide what the section around it may add, and the section input's TYPE follows them:
|
|
256
|
+
*
|
|
257
|
+
* - where it stands (`WebsiteBlockSurface`): `BAND`, on a band the section draws (`band`: tone, spacing,
|
|
258
|
+
* decoration); `OWN`, on a surface it draws itself (a hero, a call-to-action band), its tone in its config;
|
|
259
|
+
* - whether it has its own heading (`WebsiteBlockHeading`): `SECTION_INTRO`, the section may put its intro (eyebrow,
|
|
260
|
+
* heading, lede) above it (`intro`); `OWN`, it carries its own (a feature row, a FAQ, a hero), and a second heading
|
|
261
|
+
* above it would make one section with two titles.
|
|
262
|
+
*
|
|
263
|
+
* A config may hold nodes that read words of their own (a hero's visual, a tour's screens, a bento's drawings):
|
|
264
|
+
* declare those with `nodeSlots`, under the prefix the node reads them by.
|
|
265
|
+
*/
|
|
266
|
+
export enum WebsiteBlockSurface {
|
|
267
|
+
/** The block stands on a band the section draws. */
|
|
268
|
+
BAND = 'band',
|
|
269
|
+
/** The block draws its own surface: the section adds no band. */
|
|
270
|
+
OWN = 'own',
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
export enum WebsiteBlockHeading {
|
|
274
|
+
/** The section may put its intro above the block. */
|
|
275
|
+
SECTION_INTRO = 'section-intro',
|
|
276
|
+
/** The block carries its own heading: the section adds no intro. */
|
|
277
|
+
OWN = 'own',
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
interface WebsiteBlockSectionCommonInput<TConfig> {
|
|
281
|
+
readonly pageRef: string;
|
|
282
|
+
readonly sectionRef: string;
|
|
283
|
+
/** What the section is for: a block serves several categories (a card grid lists benefits or integrations). */
|
|
284
|
+
readonly category: WebsiteSectionCategory;
|
|
285
|
+
/** The block's configuration: everything it renders, the same object its words are derived from. */
|
|
286
|
+
readonly config: TConfig;
|
|
287
|
+
/** Words read by nodes inside the config (a visual's drawing), already under the prefix the node reads them by. */
|
|
288
|
+
readonly nodeSlots?: readonly string[];
|
|
289
|
+
/** The section's DOM id, so a link can target it (`#pricing`). */
|
|
290
|
+
readonly anchorId?: string;
|
|
291
|
+
readonly getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
/** The band a block standing on one is drawn on. */
|
|
295
|
+
export interface WebsiteBlockSectionBandInput {
|
|
296
|
+
readonly band?: Omit<WebsiteBandProps, 'children'>;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/** The section intro above a block that takes one; absent: none. Its eyebrow and lede flags decide its words. */
|
|
300
|
+
export interface WebsiteBlockSectionIntroInput {
|
|
301
|
+
readonly intro?: Omit<WebsiteSectionIntroProps, 'children'>;
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
/** What `section(...)` takes for a block standing where `TSurface` says, with the heading `THeading` says. */
|
|
305
|
+
export type WebsiteBlockSectionInput<TConfig, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> = WebsiteBlockSectionCommonInput<TConfig> &
|
|
306
|
+
(TSurface extends WebsiteBlockSurface.BAND ? WebsiteBlockSectionBandInput : Record<never, never>) &
|
|
307
|
+
(THeading extends WebsiteBlockHeading.SECTION_INTRO ? WebsiteBlockSectionIntroInput : Record<never, never>);
|
|
308
|
+
|
|
309
|
+
export interface WebsiteBlock<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> {
|
|
310
|
+
readonly surface: TSurface;
|
|
311
|
+
readonly heading: THeading;
|
|
312
|
+
/** The words the block reads for a configuration, as slots of the section. */
|
|
313
|
+
readonly slots: (config: TConfig) => string[];
|
|
314
|
+
/** The block's renderer. */
|
|
315
|
+
readonly Component: ComponentType<TConfig>;
|
|
316
|
+
/** The block as a whole section, its words derived from its config (see the module comment). */
|
|
317
|
+
readonly section: (input: WebsiteBlockSectionInput<TConfig, TSurface, THeading>) => TypedWebsiteSectionDefinition;
|
|
318
|
+
}
|
|
319
|
+
|
|
320
|
+
export interface DefineWebsiteBlockInput<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading> {
|
|
321
|
+
readonly surface: TSurface;
|
|
322
|
+
readonly heading: THeading;
|
|
323
|
+
readonly slots: (config: TConfig) => string[];
|
|
324
|
+
readonly Component: ComponentType<TConfig>;
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
export function defineWebsiteBlock<TConfig extends object, TSurface extends WebsiteBlockSurface, THeading extends WebsiteBlockHeading>(
|
|
328
|
+
definition: DefineWebsiteBlockInput<TConfig, TSurface, THeading>,
|
|
329
|
+
): WebsiteBlock<TConfig, TSurface, THeading> {
|
|
330
|
+
const { surface, heading, slots, Component } = definition;
|
|
331
|
+
const section = (input: WebsiteBlockSectionInput<TConfig, TSurface, THeading>): TypedWebsiteSectionDefinition => {
|
|
332
|
+
const common: WebsiteBlockSectionCommonInput<TConfig> & WebsiteBlockSectionBandInput & WebsiteBlockSectionIntroInput = input;
|
|
333
|
+
// The types already refuse a band or an intro where the block does not take one; a value forced past them is ignored.
|
|
334
|
+
const banded = surface === WebsiteBlockSurface.BAND ? common : undefined;
|
|
335
|
+
const intro = heading === WebsiteBlockHeading.SECTION_INTRO ? common.intro : undefined;
|
|
336
|
+
const sectionSlots = [...(intro === undefined ? [] : websiteSectionIntroSlots(intro)), ...slots(common.config), ...(common.nodeSlots ?? [])];
|
|
337
|
+
const block = <Component {...common.config} />;
|
|
338
|
+
const SectionBody = (): ReactNode =>
|
|
339
|
+
banded === undefined ? (
|
|
340
|
+
block
|
|
341
|
+
) : (
|
|
342
|
+
<WebsiteBand {...(banded.band ?? {})}>
|
|
343
|
+
{intro === undefined ? null : <WebsiteSectionIntro {...intro} />}
|
|
344
|
+
{block}
|
|
345
|
+
</WebsiteBand>
|
|
346
|
+
);
|
|
347
|
+
SectionBody.displayName = `WebsiteBlockSection(${common.sectionRef})`;
|
|
348
|
+
return defineWebsiteBlockSection({
|
|
349
|
+
pageRef: common.pageRef,
|
|
350
|
+
sectionRef: common.sectionRef,
|
|
351
|
+
category: common.category,
|
|
352
|
+
slots: sectionSlots,
|
|
353
|
+
Component: SectionBody,
|
|
354
|
+
...(common.anchorId === undefined ? {} : { anchorId: common.anchorId }),
|
|
355
|
+
...(common.getStructuredData === undefined ? {} : { getStructuredData: common.getStructuredData }),
|
|
356
|
+
});
|
|
357
|
+
};
|
|
358
|
+
return { surface, heading, slots, Component, section };
|
|
359
|
+
}
|
|
360
|
+
```
|
|
361
|
+
|
|
362
|
+
## Import Origins
|
|
363
|
+
|
|
364
|
+
- `@wildo-ai/saas-website`
|
|
365
|
+
|
|
366
|
+
## Source Excerpts
|
|
367
|
+
|
|
368
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
369
|
+
|
|
370
|
+
```typescript
|
|
371
|
+
*
|
|
372
|
+
* Every engine block as a configurable section (`defineWebsiteBlock`): configure the block, and the section's words
|
|
373
|
+
* follow from the configuration. `websiteCardGridBlock.section({ pageRef, sectionRef, category, band, intro, config })`
|
|
374
|
+
* is a whole section; `websiteHeroBlock.section({ … config })` too, without band or intro since a hero draws its own
|
|
375
|
+
* surface and heading. The hero, the call-to-action band, the feature row and the FAQ carry their own heading.
|
|
376
|
+
*
|
|
377
|
+
* Pricing is not here: its words depend on the plans the catalogue publishes, which a section reads when it renders,
|
|
378
|
+
* so it is still declared with `defineWebsiteBlockSection` and `websitePricingSlots`.
|
|
379
|
+
*/
|
|
380
|
+
export const websiteHeroBlock: WebsiteBlock<WebsiteHeroProps, WebsiteBlockSurface.OWN, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
|
|
381
|
+
surface: WebsiteBlockSurface.OWN,
|
|
382
|
+
heading: WebsiteBlockHeading.OWN,
|
|
383
|
+
slots: (config) => websiteHeroSlots(config),
|
|
384
|
+
Component: WebsiteHero,
|
|
385
|
+
});
|
|
386
|
+
|
|
387
|
+
export const websiteCtaBandBlock: WebsiteBlock<WebsiteCtaBandProps, WebsiteBlockSurface.OWN, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
|
|
388
|
+
surface: WebsiteBlockSurface.OWN,
|
|
389
|
+
heading: WebsiteBlockHeading.OWN,
|
|
390
|
+
slots: (config) => websiteCtaBandSlots(config),
|
|
391
|
+
Component: WebsiteCtaBand,
|
|
392
|
+
});
|
|
393
|
+
|
|
394
|
+
export const websiteFeatureRowBlock: WebsiteBlock<WebsiteFeatureRowProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
|
|
395
|
+
surface: WebsiteBlockSurface.BAND,
|
|
396
|
+
heading: WebsiteBlockHeading.OWN,
|
|
397
|
+
slots: (config) => websiteFeatureRowSlots(config),
|
|
398
|
+
Component: WebsiteFeatureRow,
|
|
399
|
+
});
|
|
400
|
+
|
|
401
|
+
export const websiteCardGridBlock: WebsiteBlock<WebsiteCardGridProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
402
|
+
surface: WebsiteBlockSurface.BAND,
|
|
403
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
404
|
+
slots: (config) => websiteCardGridSlots(config.items),
|
|
405
|
+
Component: WebsiteCardGrid,
|
|
406
|
+
});
|
|
407
|
+
|
|
408
|
+
export const websiteBentoBlock: WebsiteBlock<WebsiteBentoProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
409
|
+
surface: WebsiteBlockSurface.BAND,
|
|
410
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
411
|
+
slots: (config) => websiteBentoSlots(config.tiles),
|
|
412
|
+
Component: WebsiteBento,
|
|
413
|
+
});
|
|
414
|
+
|
|
415
|
+
export const websiteProductTourBlock: WebsiteBlock<WebsiteProductTourProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
416
|
+
surface: WebsiteBlockSurface.BAND,
|
|
417
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
418
|
+
slots: (config) => websiteProductTourSlots(config.tabs),
|
|
419
|
+
Component: WebsiteProductTour,
|
|
420
|
+
});
|
|
421
|
+
|
|
422
|
+
export const websiteMarqueeBlock: WebsiteBlock<WebsiteMarqueeProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
423
|
+
surface: WebsiteBlockSurface.BAND,
|
|
424
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
425
|
+
slots: (config) => websiteMarqueeSlots(config.items, config.label === undefined ? {} : { label: config.label }),
|
|
426
|
+
Component: WebsiteMarquee,
|
|
427
|
+
});
|
|
428
|
+
|
|
429
|
+
export const websiteFaqBlock: WebsiteBlock<WebsiteFaqProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.OWN> = defineWebsiteBlock({
|
|
430
|
+
surface: WebsiteBlockSurface.BAND,
|
|
431
|
+
heading: WebsiteBlockHeading.OWN,
|
|
432
|
+
slots: (config) => websiteFaqSlots(config.questions, config.intro),
|
|
433
|
+
Component: WebsiteFaq,
|
|
434
|
+
});
|
|
435
|
+
|
|
436
|
+
export const websiteStepsBlock: WebsiteBlock<WebsiteStepsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
437
|
+
surface: WebsiteBlockSurface.BAND,
|
|
438
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
439
|
+
slots: (config) => websiteStepsSlots(config.steps),
|
|
440
|
+
Component: WebsiteSteps,
|
|
441
|
+
});
|
|
442
|
+
|
|
443
|
+
export const websiteStatsBlock: WebsiteBlock<WebsiteStatsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
444
|
+
surface: WebsiteBlockSurface.BAND,
|
|
445
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
446
|
+
slots: (config) => websiteStatsSlots(config.stats),
|
|
447
|
+
Component: WebsiteStats,
|
|
448
|
+
});
|
|
449
|
+
|
|
450
|
+
export const websiteQuoteCardsBlock: WebsiteBlock<WebsiteQuoteCardsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
451
|
+
surface: WebsiteBlockSurface.BAND,
|
|
452
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
453
|
+
slots: (config) => websiteQuoteCardsSlots(config.quotes),
|
|
454
|
+
Component: WebsiteQuoteCards,
|
|
455
|
+
});
|
|
456
|
+
|
|
457
|
+
export const websiteRoadmapBlock: WebsiteBlock<WebsiteRoadmapProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
458
|
+
surface: WebsiteBlockSurface.BAND,
|
|
459
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
460
|
+
slots: (config) => websiteRoadmapSlots(config.phases),
|
|
461
|
+
Component: WebsiteRoadmap,
|
|
462
|
+
});
|
|
463
|
+
|
|
464
|
+
export const websiteSolutionPathsBlock: WebsiteBlock<WebsiteSolutionPathsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
465
|
+
surface: WebsiteBlockSurface.BAND,
|
|
466
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
467
|
+
slots: (config) => websiteSolutionPathsSlots(config.paths),
|
|
468
|
+
Component: WebsiteSolutionPaths,
|
|
469
|
+
});
|
|
470
|
+
|
|
471
|
+
export const websiteLatestPostsBlock: WebsiteBlock<WebsiteLatestPostsProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
472
|
+
surface: WebsiteBlockSurface.BAND,
|
|
473
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
474
|
+
slots: (config) => websiteLatestPostsSlots(config),
|
|
475
|
+
Component: WebsiteLatestPosts,
|
|
476
|
+
});
|
|
477
|
+
|
|
478
|
+
export const websiteComparisonTableBlock: WebsiteBlock<WebsiteComparisonTableProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
479
|
+
surface: WebsiteBlockSurface.BAND,
|
|
480
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
481
|
+
slots: (config) => websiteComparisonTableSlots(config.rows, config.columns),
|
|
482
|
+
Component: WebsiteComparisonTable,
|
|
483
|
+
});
|
|
484
|
+
|
|
485
|
+
export const websiteFactTableBlock: WebsiteBlock<WebsiteFactTableProps, WebsiteBlockSurface.BAND, WebsiteBlockHeading.SECTION_INTRO> = defineWebsiteBlock({
|
|
486
|
+
surface: WebsiteBlockSurface.BAND,
|
|
487
|
+
heading: WebsiteBlockHeading.SECTION_INTRO,
|
|
488
|
+
slots: (config) => websiteFactTableSlots(config.rows, config.columns),
|
|
489
|
+
Component: WebsiteFactTable,
|
|
490
|
+
});
|
|
491
|
+
```
|
|
492
|
+
|
|
493
|
+
## Declaring a section's words: slots
|
|
494
|
+
|
|
495
|
+
## Import Origins
|
|
496
|
+
|
|
497
|
+
- `@wildo-ai/saas-website`
|
|
498
|
+
|
|
499
|
+
## Source Excerpts
|
|
500
|
+
|
|
501
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
502
|
+
|
|
503
|
+
```typescript
|
|
504
|
+
*
|
|
505
|
+
* How a section built from the engine's blocks declares its words (#2742). Every block reads its words by SLOT
|
|
506
|
+
* (`heading`, `cta.primary`, `item3.title`) and exports the slot list it reads for a given configuration
|
|
507
|
+
* (`websiteHeroSlots({ note: true })`). A section declares exactly the union of the blocks it renders, so the label
|
|
508
|
+
* audit demands precisely what is rendered, in every locale, and nothing else.
|
|
509
|
+
*
|
|
510
|
+
* - `websiteSectionLabelKeys(pageRef, sectionRef, slots)`: the full keys (`website.<page>.<section>.<slot>`).
|
|
511
|
+
* - `numberedWebsiteSlots('item', 3, ['title', 'body'])`: `item1.title`, `item1.body`, … `item3.body`.
|
|
512
|
+
* - `prefixedWebsiteSlots('demo', slots)`: `demo.<slot>`, so one block's slots can sit beside another's.
|
|
513
|
+
* - `defineWebsiteBlockSection(...)`: a section from its slots, refusing a slot declared twice (two blocks reading
|
|
514
|
+
* one word would be one word doing two jobs).
|
|
515
|
+
*/
|
|
516
|
+
export function websiteSectionLabelKeys(pageRef: string, sectionRef: string, slots: readonly string[]): string[] {
|
|
517
|
+
return slots.map((slot) => `website.${pageRef}.${sectionRef}.${slot}`);
|
|
518
|
+
}
|
|
519
|
+
|
|
520
|
+
export function numberedWebsiteSlots(prefix: string, count: number, suffixes: readonly string[]): string[] {
|
|
521
|
+
return Array.from({ length: count }, (_, index) => suffixes.map((suffix) => `${prefix}${index + 1}.${suffix}`)).flat();
|
|
522
|
+
}
|
|
523
|
+
|
|
524
|
+
export function prefixedWebsiteSlots(prefix: string, slots: readonly string[]): string[] {
|
|
525
|
+
return slots.map((slot) => `${prefix}.${slot}`);
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
export interface DefineWebsiteBlockSectionInput {
|
|
529
|
+
readonly pageRef: string;
|
|
530
|
+
readonly sectionRef: string;
|
|
531
|
+
readonly category: WebsiteSectionCategory;
|
|
532
|
+
/** The union of the slots the section's blocks read. */
|
|
533
|
+
readonly slots: readonly string[];
|
|
534
|
+
/** The section's body, mounted as `<Component />`: one that requires a prop is refused at compile time, as by `defineWebsiteSection`. */
|
|
535
|
+
readonly Component: ComponentType<WebsiteSectionComponentProps>;
|
|
536
|
+
/** The section's DOM id, so a link can target it (`#pricing`). */
|
|
537
|
+
readonly anchorId?: string;
|
|
538
|
+
readonly getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
539
|
+
}
|
|
540
|
+
|
|
541
|
+
export function defineWebsiteBlockSection(input: DefineWebsiteBlockSectionInput): TypedWebsiteSectionDefinition {
|
|
542
|
+
const seen = new Set<string>();
|
|
543
|
+
for (const slot of input.slots) {
|
|
544
|
+
if (seen.has(slot)) throw new Error(`[website] Section "${input.sectionRef}" declares the slot "${slot}" twice.`);
|
|
545
|
+
seen.add(slot);
|
|
546
|
+
}
|
|
547
|
+
return defineWebsiteSection({
|
|
548
|
+
sectionRef: input.sectionRef,
|
|
549
|
+
category: input.category,
|
|
550
|
+
expectedLabelKeys: websiteSectionLabelKeys(input.pageRef, input.sectionRef, input.slots),
|
|
551
|
+
Component: input.Component,
|
|
552
|
+
...(input.anchorId === undefined ? {} : { anchorId: input.anchorId }),
|
|
553
|
+
...(input.getStructuredData === undefined ? {} : { getStructuredData: input.getStructuredData }),
|
|
554
|
+
});
|
|
555
|
+
}
|
|
556
|
+
```
|
|
557
|
+
|
|
558
|
+
## Import Origins
|
|
559
|
+
|
|
560
|
+
- `@wildo-ai/saas-website`
|
|
561
|
+
|
|
562
|
+
## Source Excerpts
|
|
563
|
+
|
|
564
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
565
|
+
|
|
566
|
+
```typescript
|
|
567
|
+
*
|
|
568
|
+
* Every word of the CURRENT section, by slot: returns `label(slot)`, the same lookup as `useWebsiteLabel(slot)`. One
|
|
569
|
+
* hook call, so a component can read the words of a list of any length (`label(`${item}.title`)` inside a `.map`)
|
|
570
|
+
* without calling a hook in a loop. A missing word renders its key, as `useWebsiteLabel` does, so it looks missing.
|
|
571
|
+
*/
|
|
572
|
+
export function useWebsiteSectionLabels(): (slotPath: string) => string {
|
|
573
|
+
const { labelPack } = useWebsiteRuntime();
|
|
574
|
+
const { pageRef } = useWebsitePage();
|
|
575
|
+
const { sectionRef } = useWebsiteSection();
|
|
576
|
+
return useMemo(
|
|
577
|
+
() => (slotPath: string) => {
|
|
578
|
+
const fullKey = composeWebsiteLabelKey({ pageRef: pageRef as unknown as string, sectionRef: sectionRef as unknown as string, slotPath }) as unknown as string;
|
|
579
|
+
const resolved = labelPack[fullKey];
|
|
580
|
+
if (resolved === undefined) {
|
|
581
|
+
console.warn(`[useWebsiteSectionLabels] Missing label for key "${fullKey}". Add it to the active locale's pack.`);
|
|
582
|
+
return fullKey;
|
|
583
|
+
}
|
|
584
|
+
return resolved;
|
|
585
|
+
},
|
|
586
|
+
[labelPack, pageRef, sectionRef],
|
|
587
|
+
);
|
|
588
|
+
}
|
|
589
|
+
```
|
|
590
|
+
|
|
591
|
+
## The band and the intro
|
|
592
|
+
|
|
593
|
+
## Import Origins
|
|
594
|
+
|
|
595
|
+
- `@wildo-ai/saas-website`
|
|
596
|
+
|
|
597
|
+
## Source Excerpts
|
|
598
|
+
|
|
599
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
600
|
+
|
|
601
|
+
```tsx
|
|
602
|
+
*
|
|
603
|
+
* `WebsiteBand`: a section's outer shell (#2742). The surface it sits on (`tone`), its vertical room (`spacing`), and
|
|
604
|
+
* the width-limited column inside. Everything in it paints with the band's tone, so a card, an eyebrow or a button is
|
|
605
|
+
* right on a tinted or inverse band without a rule per band. Two adjacent sections on the same tone read as one band:
|
|
606
|
+
* the second drops its top padding. Choose tones per section to give a long page its rhythm (`personality.surfaceRhythm`
|
|
607
|
+
* says how strongly the brand alternates them).
|
|
608
|
+
*
|
|
609
|
+
* `decoration` is drawn behind the content, `aria-hidden` and click-through: a brand motif, never content.
|
|
610
|
+
*/
|
|
611
|
+
export interface WebsiteBandProps {
|
|
612
|
+
readonly tone?: WebsiteSurfaceTone;
|
|
613
|
+
readonly spacing?: WebsiteBandSpacing;
|
|
614
|
+
readonly decoration?: ReactNode;
|
|
615
|
+
readonly children: ReactNode;
|
|
616
|
+
}
|
|
617
|
+
|
|
618
|
+
export function WebsiteBand({ tone = WebsiteSurfaceTone.DEFAULT, spacing = WebsiteBandSpacing.DEFAULT, decoration, children }: WebsiteBandProps): ReactNode {
|
|
619
|
+
return (
|
|
620
|
+
<div data-website-block="band" data-website-tone={tone} data-website-band-spacing={spacing}>
|
|
621
|
+
{decoration !== undefined && (
|
|
622
|
+
<div data-website-part="decoration" aria-hidden="true">
|
|
623
|
+
{decoration}
|
|
624
|
+
</div>
|
|
625
|
+
)}
|
|
626
|
+
<div data-website-shell="">{children}</div>
|
|
627
|
+
</div>
|
|
628
|
+
);
|
|
629
|
+
}
|
|
630
|
+
WebsiteBand.displayName = 'WebsiteBand';
|
|
631
|
+
```
|
|
632
|
+
|
|
633
|
+
## Import Origins
|
|
634
|
+
|
|
635
|
+
- `@wildo-ai/saas-website`
|
|
636
|
+
|
|
637
|
+
## Source Excerpts
|
|
638
|
+
|
|
639
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
640
|
+
|
|
641
|
+
```tsx
|
|
642
|
+
*
|
|
643
|
+
* `WebsiteSectionIntro`: a section's opening lines, by slot: `eyebrow` (optional), `heading` (an H2), `lede`
|
|
644
|
+
* (optional). `websiteSectionIntroSlots(options)` lists the slots it reads, for the section's declaration.
|
|
645
|
+
*
|
|
646
|
+
* `WebsiteEyebrow`: the short label above a heading, in the brand's colour on any band; `PILL` draws it as a pill
|
|
647
|
+
* with the accent's dot (a hero's opening line).
|
|
648
|
+
*/
|
|
649
|
+
export interface WebsiteSectionIntroOptions {
|
|
650
|
+
/** Whether the intro has an eyebrow (slot `eyebrow`). Default true. */
|
|
651
|
+
readonly eyebrow?: boolean;
|
|
652
|
+
/** Whether the intro has a lede (slot `lede`). Default true. */
|
|
653
|
+
readonly lede?: boolean;
|
|
654
|
+
}
|
|
655
|
+
|
|
656
|
+
export function websiteSectionIntroSlots({ eyebrow = true, lede = true }: WebsiteSectionIntroOptions = {}): string[] {
|
|
657
|
+
return [...(eyebrow ? ['eyebrow'] : []), 'heading', ...(lede ? ['lede'] : [])];
|
|
658
|
+
}
|
|
659
|
+
|
|
660
|
+
export function WebsiteEyebrow({ style = WebsiteEyebrowStyle.PLAIN, children }: { style?: WebsiteEyebrowStyle; children: ReactNode }): ReactNode {
|
|
661
|
+
return <p data-website-eyebrow={style}>{children}</p>;
|
|
662
|
+
}
|
|
663
|
+
WebsiteEyebrow.displayName = 'WebsiteEyebrow';
|
|
664
|
+
|
|
665
|
+
/** The intro's one motion point: the whole intro rises in as it scrolls into view. */
|
|
666
|
+
export enum WebsiteSectionIntroMotionPoint {
|
|
667
|
+
INTRO = 'intro',
|
|
668
|
+
}
|
|
669
|
+
|
|
670
|
+
const INTRO_MOTION = defineBlockMotionPoints<WebsiteSectionIntroMotionPoint>({
|
|
671
|
+
[WebsiteSectionIntroMotionPoint.INTRO]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
|
|
672
|
+
});
|
|
673
|
+
|
|
674
|
+
export interface WebsiteSectionIntroProps extends WebsiteSectionIntroOptions {
|
|
675
|
+
readonly align?: WebsiteIntroAlign;
|
|
676
|
+
/** The heading's level: 2 for a section of the page, 3 for one nested under another section's heading. */
|
|
677
|
+
readonly headingLevel?: WebsiteHeadingLevel;
|
|
678
|
+
readonly motion?: WebsiteBlockMotion<WebsiteSectionIntroMotionPoint>;
|
|
679
|
+
}
|
|
680
|
+
|
|
681
|
+
export function WebsiteSectionIntro({ eyebrow = true, lede = true, align = WebsiteIntroAlign.CENTER, headingLevel = 2, motion }: WebsiteSectionIntroProps): ReactNode {
|
|
682
|
+
const label = useWebsiteSectionLabels();
|
|
683
|
+
return (
|
|
684
|
+
<div data-website-block="intro" data-website-align={align} {...blockMotionAttributes(WebsiteSectionIntroMotionPoint.INTRO, INTRO_MOTION, motion)}>
|
|
685
|
+
{eyebrow && <WebsiteEyebrow>{label('eyebrow')}</WebsiteEyebrow>}
|
|
686
|
+
<WebsiteHeading level={headingLevel} variant={WebsiteHeadingVariant.HEADLINE} part="heading">
|
|
687
|
+
{label('heading')}
|
|
688
|
+
</WebsiteHeading>
|
|
689
|
+
{lede && (
|
|
690
|
+
<WebsiteText variant={WebsiteTextVariant.LEAD} part="lede">
|
|
691
|
+
{label('lede')}
|
|
692
|
+
</WebsiteText>
|
|
693
|
+
)}
|
|
694
|
+
</div>
|
|
695
|
+
);
|
|
696
|
+
}
|
|
697
|
+
WebsiteSectionIntro.displayName = 'WebsiteSectionIntro';
|
|
698
|
+
```
|
|
699
|
+
|
|
700
|
+
## Calls to action and links
|
|
701
|
+
|
|
702
|
+
## Import Origins
|
|
703
|
+
|
|
704
|
+
- `@wildo-ai/saas-website`
|
|
705
|
+
|
|
706
|
+
## Source Excerpts
|
|
707
|
+
|
|
708
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
709
|
+
|
|
710
|
+
```tsx
|
|
711
|
+
*
|
|
712
|
+
* A block's calls to action. Each names where it goes as a typed link, the same union the site menu uses:
|
|
713
|
+
* `{ kind: APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP }` (the application's sign-up, on the environment's
|
|
714
|
+
* app origin), `{ kind: PAGE, routePath: '/pricing' }` (a page of the site, locale-prefixed), or
|
|
715
|
+
* `{ kind: EXTERNAL, href }`. Its words are the slots `cta.primary` and `cta.secondary`.
|
|
716
|
+
*
|
|
717
|
+
* `WebsiteBlockLink`: a link any block draws (a card, an arrow link), resolved by the same rule as the actions: a PAGE
|
|
718
|
+
* link is localized, an APPLICATION link goes to the environment's app origin, an EXTERNAL one is marked outbound.
|
|
719
|
+
*
|
|
720
|
+
* `WebsiteArrowLink`: a quiet link with an arrow that nudges forward on hover (slot given by the caller).
|
|
721
|
+
*/
|
|
722
|
+
export interface WebsiteCallToActionsProps {
|
|
723
|
+
readonly primary?: WebsiteLinkTo;
|
|
724
|
+
readonly secondary?: WebsiteLinkTo;
|
|
725
|
+
readonly size?: WebsiteButtonSize;
|
|
726
|
+
}
|
|
727
|
+
|
|
728
|
+
export function websiteCallToActionSlots(actions: { readonly primary?: unknown; readonly secondary?: unknown }): string[] {
|
|
729
|
+
return [...(actions.primary !== undefined ? ['cta.primary'] : []), ...(actions.secondary !== undefined ? ['cta.secondary'] : [])];
|
|
730
|
+
}
|
|
731
|
+
|
|
732
|
+
function ActionButton({ link, variant, size, children }: { link: WebsiteLinkTo; variant: WebsiteButtonVariant; size: WebsiteButtonSize; children: ReactNode }): ReactNode {
|
|
733
|
+
// One rule for every kind: the resolver checks the link and writes its address (a page's locale and fragment
|
|
734
|
+
// included), so an action, a card and the menu go to the same place for the same link.
|
|
735
|
+
const target = useWebsiteLinkTarget()(link);
|
|
736
|
+
return (
|
|
737
|
+
<WebsiteButton href={target.href} external={target.external} variant={variant} size={size}>
|
|
738
|
+
{children}
|
|
739
|
+
</WebsiteButton>
|
|
740
|
+
);
|
|
741
|
+
}
|
|
742
|
+
|
|
743
|
+
export function WebsiteCallToActions({ primary, secondary, size = WebsiteButtonSize.LG }: WebsiteCallToActionsProps): ReactNode {
|
|
744
|
+
const label = useWebsiteSectionLabels();
|
|
745
|
+
return (
|
|
746
|
+
<>
|
|
747
|
+
{primary !== undefined && (
|
|
748
|
+
<ActionButton link={primary} variant={WebsiteButtonVariant.PRIMARY} size={size}>
|
|
749
|
+
{label('cta.primary')}
|
|
750
|
+
</ActionButton>
|
|
751
|
+
)}
|
|
752
|
+
{secondary !== undefined && (
|
|
753
|
+
<ActionButton link={secondary} variant={WebsiteButtonVariant.SECONDARY} size={size}>
|
|
754
|
+
{label('cta.secondary')}
|
|
755
|
+
</ActionButton>
|
|
756
|
+
)}
|
|
757
|
+
</>
|
|
758
|
+
);
|
|
759
|
+
}
|
|
760
|
+
WebsiteCallToActions.displayName = 'WebsiteCallToActions';
|
|
761
|
+
|
|
762
|
+
export interface WebsiteBlockLinkProps {
|
|
763
|
+
readonly link: WebsiteLinkTo;
|
|
764
|
+
/** The `data-website-part` the link carries, so a block's stylesheet (or the site's) can target it. */
|
|
765
|
+
readonly part?: string;
|
|
766
|
+
readonly motion?: WebsiteMotionSpec;
|
|
767
|
+
readonly children: ReactNode;
|
|
768
|
+
}
|
|
769
|
+
|
|
770
|
+
export function WebsiteBlockLink({ link, part, motion, children }: WebsiteBlockLinkProps): ReactNode {
|
|
771
|
+
const target = useWebsiteLinkTarget()(link);
|
|
772
|
+
const shared = { ...(part === undefined ? {} : { part }), ...(motion === undefined ? {} : { motion }) };
|
|
773
|
+
return (
|
|
774
|
+
<WebsiteLink href={target.href} external={target.external} {...shared}>
|
|
775
|
+
{children}
|
|
776
|
+
</WebsiteLink>
|
|
777
|
+
);
|
|
778
|
+
}
|
|
779
|
+
WebsiteBlockLink.displayName = 'WebsiteBlockLink';
|
|
780
|
+
|
|
781
|
+
export function WebsiteArrowLink({ link, children }: { link: WebsiteLinkTo; children: ReactNode }): ReactNode {
|
|
782
|
+
return (
|
|
783
|
+
<WebsiteBlockLink link={link} part="arrow-link">
|
|
784
|
+
{children}
|
|
785
|
+
<WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
|
|
786
|
+
</WebsiteBlockLink>
|
|
787
|
+
);
|
|
788
|
+
}
|
|
789
|
+
WebsiteArrowLink.displayName = 'WebsiteArrowLink';
|
|
790
|
+
```
|
|
791
|
+
|
|
792
|
+
## Import Origins
|
|
793
|
+
|
|
794
|
+
- `@wildo-ai/saas-website`
|
|
795
|
+
|
|
796
|
+
## Source Excerpts
|
|
797
|
+
|
|
798
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
799
|
+
|
|
800
|
+
```typescript
|
|
801
|
+
*
|
|
802
|
+
* Where a website link goes, resolved for the page being rendered (#2742): a PAGE link (`{ kind: PAGE, routePath }`)
|
|
803
|
+
* gets the visitor's locale prefix, an APPLICATION link (`{ kind: APPLICATION, entryPoint }`: home, sign in, sign up)
|
|
804
|
+
* the environment's `appOrigin`, an EXTERNAL link stays as written.
|
|
805
|
+
*
|
|
806
|
+
* One rule for every link the engine draws: the header and footer menus, and the calls to action of the section
|
|
807
|
+
* components. The link is checked as the menu checks its own: a PAGE link names a route of the site (`/pricing`, never
|
|
808
|
+
* a `#anchor` or a pre-prefixed `/fr/pricing`), an EXTERNAL link an http(s) URL. An APPLICATION link with no
|
|
809
|
+
* `appOrigin` throws rather than falling back to a host: a "Start free" that sends a visitor to localhost in production
|
|
810
|
+
* is worse than a page that fails to render in development.
|
|
811
|
+
*/
|
|
812
|
+
/**
|
|
813
|
+
* Where a link goes, as a component takes it: the menu's link union with a plain route path (the menu itself checks
|
|
814
|
+
* its paths against the page registry at build; a component's are checked when the link renders).
|
|
815
|
+
*/
|
|
816
|
+
export type WebsiteLinkTo = z.input<typeof WebsiteMenuLinkSchema>;
|
|
817
|
+
|
|
818
|
+
export interface WebsiteLinkTarget {
|
|
819
|
+
readonly href: string;
|
|
820
|
+
/** True for an EXTERNAL link: rendered with an outbound marker and opened as a plain link. */
|
|
821
|
+
readonly external: boolean;
|
|
822
|
+
}
|
|
823
|
+
|
|
824
|
+
export function resolveWebsiteLinkTarget(
|
|
825
|
+
link: WebsiteLinkTo,
|
|
826
|
+
page: { readonly locale: AvailableLanguage; readonly defaultLocale: AvailableLanguage; readonly appOrigin?: string | undefined },
|
|
827
|
+
): WebsiteLinkTarget {
|
|
828
|
+
const valid = WebsiteMenuLinkSchema.parse(link);
|
|
829
|
+
switch (valid.kind) {
|
|
830
|
+
case WebsiteMenuLinkKind.PAGE: {
|
|
831
|
+
const prefix = detectAccidentalLocalePrefix(valid.routePath);
|
|
832
|
+
if (prefix !== null) {
|
|
833
|
+
throw new Error(
|
|
834
|
+
`A website link names the route "${valid.routePath}", which starts with the locale "${prefix}". Name the ` +
|
|
835
|
+
'locale-neutral route ("/pricing"): the page prefixes the visitor\'s locale itself.',
|
|
836
|
+
);
|
|
837
|
+
}
|
|
838
|
+
const href = buildLocalizedRoutePath({ locale: page.locale, defaultLocale: page.defaultLocale, routePath: valid.routePath });
|
|
839
|
+
return { href: valid.fragment === undefined ? href : `${href}#${valid.fragment}`, external: false };
|
|
840
|
+
}
|
|
841
|
+
case WebsiteMenuLinkKind.APPLICATION:
|
|
842
|
+
if (page.appOrigin === undefined) {
|
|
843
|
+
throw new Error(
|
|
844
|
+
'A website link goes to the application, but the page has no appOrigin. Pass ' +
|
|
845
|
+
'`appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` to the page island in its .astro route.',
|
|
846
|
+
);
|
|
847
|
+
}
|
|
848
|
+
return { href: `${page.appOrigin}${APPLICATION_ENTRY_POINT_PATHS[valid.entryPoint ?? ApplicationEntryPoint.HOME]}`, external: false };
|
|
849
|
+
case WebsiteMenuLinkKind.EXTERNAL:
|
|
850
|
+
return { href: valid.href, external: true };
|
|
851
|
+
}
|
|
852
|
+
}
|
|
853
|
+
|
|
854
|
+
/** `resolveWebsiteLinkTarget` bound to the page being rendered. */
|
|
855
|
+
export function useWebsiteLinkTarget(): (link: WebsiteLinkTo) => WebsiteLinkTarget {
|
|
856
|
+
const runtime = useWebsiteRuntime();
|
|
857
|
+
return (link) => resolveWebsiteLinkTarget(link, runtime);
|
|
858
|
+
}
|
|
859
|
+
```
|
|
860
|
+
|
|
861
|
+
## The hero
|
|
862
|
+
|
|
863
|
+
## Import Origins
|
|
864
|
+
|
|
865
|
+
- `@wildo-ai/saas-website`
|
|
866
|
+
|
|
867
|
+
## Source Excerpts
|
|
868
|
+
|
|
869
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
870
|
+
|
|
871
|
+
```tsx
|
|
872
|
+
*
|
|
873
|
+
* `WebsiteHero`: a page's opening (category HERO), and its ONE signature entrance. Slots: `eyebrow` (unless
|
|
874
|
+
* `eyebrow` is false), `headline` (the page's only H1), `subheadline` (unless `lede` is false), `cta.primary` /
|
|
875
|
+
* `cta.secondary` (when the actions are given), `note` (when `note` is true). `websiteHeroSlots({ ... })` lists them,
|
|
876
|
+
* given the same options, so a hero that drops a word declares it dropped.
|
|
877
|
+
*
|
|
878
|
+
* - `layout`: STAGE (copy centred above a full-width `visual`), SPLIT (copy beside it), COMPACT (no visual; chosen
|
|
879
|
+
* automatically when `visual` is absent).
|
|
880
|
+
* - `surface`: what is drawn behind it (a glow, a glow over a grid); `decoration` adds the site's own motif in the
|
|
881
|
+
* backdrop, `aria-hidden`.
|
|
882
|
+
* - `motion`: the entrance, point by point (`eyebrow`, `headline`, `lede`, `actions`, `note`, `visual`), played once
|
|
883
|
+
* on load in that order. Override a point, or set it to `null` to keep it still.
|
|
884
|
+
*/
|
|
885
|
+
export enum WebsiteHeroMotionPoint {
|
|
886
|
+
EYEBROW = 'eyebrow',
|
|
887
|
+
HEADLINE = 'headline',
|
|
888
|
+
LEDE = 'lede',
|
|
889
|
+
ACTIONS = 'actions',
|
|
890
|
+
NOTE = 'note',
|
|
891
|
+
VISUAL = 'visual',
|
|
892
|
+
}
|
|
893
|
+
|
|
894
|
+
const onLoad = (reveal: WebsiteMotionReveal, order: number): WebsiteMotionSpec => ({ reveal, trigger: WebsiteMotionTrigger.LOAD, order });
|
|
895
|
+
|
|
896
|
+
const HERO_MOTION = defineBlockMotionPoints<WebsiteHeroMotionPoint>({
|
|
897
|
+
[WebsiteHeroMotionPoint.EYEBROW]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.RISE, 1) },
|
|
898
|
+
[WebsiteHeroMotionPoint.HEADLINE]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.BLUR, 2) },
|
|
899
|
+
[WebsiteHeroMotionPoint.LEDE]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.RISE, 3) },
|
|
900
|
+
[WebsiteHeroMotionPoint.ACTIONS]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.RISE, 4) },
|
|
901
|
+
[WebsiteHeroMotionPoint.NOTE]: { kind: WebsiteMotionPointKind.COPY, opening: true, spec: onLoad(WebsiteMotionReveal.FADE, 5) },
|
|
902
|
+
[WebsiteHeroMotionPoint.VISUAL]: { kind: WebsiteMotionPointKind.MEDIA, opening: true, spec: onLoad(WebsiteMotionReveal.SCALE, 6) },
|
|
903
|
+
});
|
|
904
|
+
|
|
905
|
+
export interface WebsiteHeroProps {
|
|
906
|
+
readonly layout?: WebsiteHeroLayout;
|
|
907
|
+
readonly surface?: WebsiteHeroSurface;
|
|
908
|
+
readonly tone?: WebsiteSurfaceTone;
|
|
909
|
+
readonly primaryAction?: WebsiteLinkTo;
|
|
910
|
+
readonly secondaryAction?: WebsiteLinkTo;
|
|
911
|
+
/** The short label above the headline; false for an opening that is the headline alone. */
|
|
912
|
+
readonly eyebrow?: boolean;
|
|
913
|
+
/** The sentence under the headline (slot `subheadline`); false for a headline-only opening. */
|
|
914
|
+
readonly lede?: boolean;
|
|
915
|
+
readonly note?: boolean;
|
|
916
|
+
readonly visual?: ReactNode;
|
|
917
|
+
readonly decoration?: ReactNode;
|
|
918
|
+
readonly motion?: WebsiteBlockMotion<WebsiteHeroMotionPoint>;
|
|
919
|
+
}
|
|
920
|
+
|
|
921
|
+
export function websiteHeroSlots(options: {
|
|
922
|
+
readonly primaryAction?: unknown;
|
|
923
|
+
readonly secondaryAction?: unknown;
|
|
924
|
+
readonly eyebrow?: boolean;
|
|
925
|
+
readonly lede?: boolean;
|
|
926
|
+
readonly note?: boolean;
|
|
927
|
+
}): string[] {
|
|
928
|
+
return [
|
|
929
|
+
...(options.eyebrow === false ? [] : ['eyebrow']),
|
|
930
|
+
'headline',
|
|
931
|
+
...(options.lede === false ? [] : ['subheadline']),
|
|
932
|
+
...websiteCallToActionSlots({ primary: options.primaryAction, secondary: options.secondaryAction }),
|
|
933
|
+
...(options.note === true ? ['note'] : []),
|
|
934
|
+
];
|
|
935
|
+
}
|
|
936
|
+
|
|
937
|
+
export function WebsiteHero({
|
|
938
|
+
layout = WebsiteHeroLayout.SPLIT,
|
|
939
|
+
surface = WebsiteHeroSurface.GLOW,
|
|
940
|
+
tone = WebsiteSurfaceTone.DEFAULT,
|
|
941
|
+
primaryAction,
|
|
942
|
+
secondaryAction,
|
|
943
|
+
eyebrow = true,
|
|
944
|
+
lede = true,
|
|
945
|
+
note = false,
|
|
946
|
+
visual,
|
|
947
|
+
decoration,
|
|
948
|
+
motion,
|
|
949
|
+
}: WebsiteHeroProps): ReactNode {
|
|
950
|
+
const label = useWebsiteSectionLabels();
|
|
951
|
+
const resolvedLayout = visual === undefined ? WebsiteHeroLayout.COMPACT : layout;
|
|
952
|
+
const at = (point: WebsiteHeroMotionPoint) => blockMotionAttributes(point, HERO_MOTION, motion);
|
|
953
|
+
return (
|
|
954
|
+
<div data-website-block="hero" data-website-layout={resolvedLayout} data-website-hero-surface={surface} data-website-tone={tone}>
|
|
955
|
+
<div data-website-part="backdrop" aria-hidden="true">
|
|
956
|
+
{decoration}
|
|
957
|
+
</div>
|
|
958
|
+
<div data-website-shell="" data-website-part="inner">
|
|
959
|
+
<div data-website-part="copy">
|
|
960
|
+
{eyebrow && (
|
|
961
|
+
<div {...at(WebsiteHeroMotionPoint.EYEBROW)}>
|
|
962
|
+
<WebsiteEyebrow style={WebsiteEyebrowStyle.PILL}>{label('eyebrow')}</WebsiteEyebrow>
|
|
963
|
+
</div>
|
|
964
|
+
)}
|
|
965
|
+
<div {...at(WebsiteHeroMotionPoint.HEADLINE)}>
|
|
966
|
+
<WebsiteHeading level={1} variant={WebsiteHeadingVariant.DISPLAY} part="headline">
|
|
967
|
+
{label('headline')}
|
|
968
|
+
</WebsiteHeading>
|
|
969
|
+
</div>
|
|
970
|
+
{lede && (
|
|
971
|
+
<div {...at(WebsiteHeroMotionPoint.LEDE)}>
|
|
972
|
+
<WebsiteText variant={WebsiteTextVariant.LEAD} part="lede">
|
|
973
|
+
{label('subheadline')}
|
|
974
|
+
</WebsiteText>
|
|
975
|
+
</div>
|
|
976
|
+
)}
|
|
977
|
+
{(primaryAction !== undefined || secondaryAction !== undefined) && (
|
|
978
|
+
<div data-website-actions="" {...at(WebsiteHeroMotionPoint.ACTIONS)}>
|
|
979
|
+
<WebsiteCallToActions {...(primaryAction === undefined ? {} : { primary: primaryAction })} {...(secondaryAction === undefined ? {} : { secondary: secondaryAction })} />
|
|
980
|
+
</div>
|
|
981
|
+
)}
|
|
982
|
+
{note && (
|
|
983
|
+
<div {...at(WebsiteHeroMotionPoint.NOTE)}>
|
|
984
|
+
<WebsiteText variant={WebsiteTextVariant.CAPTION} part="note">
|
|
985
|
+
{label('note')}
|
|
986
|
+
</WebsiteText>
|
|
987
|
+
</div>
|
|
988
|
+
)}
|
|
989
|
+
</div>
|
|
990
|
+
{visual !== undefined && (
|
|
991
|
+
<div data-website-part="visual" {...at(WebsiteHeroMotionPoint.VISUAL)}>
|
|
992
|
+
{visual}
|
|
993
|
+
</div>
|
|
994
|
+
)}
|
|
995
|
+
</div>
|
|
996
|
+
</div>
|
|
997
|
+
);
|
|
998
|
+
}
|
|
999
|
+
WebsiteHero.displayName = 'WebsiteHero';
|
|
1000
|
+
```
|
|
1001
|
+
|
|
1002
|
+
## The feature row
|
|
1003
|
+
|
|
1004
|
+
## Import Origins
|
|
1005
|
+
|
|
1006
|
+
- `@wildo-ai/saas-website`
|
|
1007
|
+
|
|
1008
|
+
## Source Excerpts
|
|
1009
|
+
|
|
1010
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1011
|
+
|
|
1012
|
+
```tsx
|
|
1013
|
+
*
|
|
1014
|
+
* `WebsiteFeatureRow`: one capability argued beside its visual (FEATURE_DETAIL, CONTACT). Slots: `eyebrow`, `heading`,
|
|
1015
|
+
* `body`, then per point `<ref>.title` and `<ref>.body`, and `link` when a link is given. `websiteFeatureRowSlots`
|
|
1016
|
+
* lists them. Each point has an optional icon node (a check by default). `layout` puts the visual on either side;
|
|
1017
|
+
* alternate it so consecutive rows zig-zag.
|
|
1018
|
+
*/
|
|
1019
|
+
export enum WebsiteFeatureRowMotionPoint {
|
|
1020
|
+
COPY = 'copy',
|
|
1021
|
+
VISUAL = 'visual',
|
|
1022
|
+
}
|
|
1023
|
+
|
|
1024
|
+
const ROW_MOTION = defineBlockMotionPoints<WebsiteFeatureRowMotionPoint>({
|
|
1025
|
+
[WebsiteFeatureRowMotionPoint.COPY]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
|
|
1026
|
+
[WebsiteFeatureRowMotionPoint.VISUAL]: { kind: WebsiteMotionPointKind.MEDIA, spec: { reveal: WebsiteMotionReveal.SCALE } },
|
|
1027
|
+
});
|
|
1028
|
+
|
|
1029
|
+
/** One point of a feature row: its slot prefix (`point1`, or a meaningful ref) and its icon. */
|
|
1030
|
+
export interface WebsiteFeaturePoint {
|
|
1031
|
+
readonly ref: string;
|
|
1032
|
+
readonly icon?: ReactNode;
|
|
1033
|
+
}
|
|
1034
|
+
|
|
1035
|
+
export function websiteFeatureRowSlots(options: {
|
|
1036
|
+
readonly points?: readonly WebsiteFeaturePoint[] | readonly string[];
|
|
1037
|
+
readonly link?: unknown;
|
|
1038
|
+
readonly eyebrow?: boolean;
|
|
1039
|
+
readonly body?: boolean;
|
|
1040
|
+
}): string[] {
|
|
1041
|
+
const refs = (options.points ?? []).map((point) => (typeof point === 'string' ? point : point.ref));
|
|
1042
|
+
return [
|
|
1043
|
+
...(options.eyebrow === false ? [] : ['eyebrow']),
|
|
1044
|
+
'heading',
|
|
1045
|
+
...(options.body === false ? [] : ['body']),
|
|
1046
|
+
...refs.flatMap((ref) => [`${ref}.title`, `${ref}.body`]),
|
|
1047
|
+
...(options.link !== undefined ? ['link'] : []),
|
|
1048
|
+
];
|
|
1049
|
+
}
|
|
1050
|
+
|
|
1051
|
+
export interface WebsiteFeatureRowProps {
|
|
1052
|
+
/** The points listed under the copy; none renders no list. */
|
|
1053
|
+
readonly points?: readonly WebsiteFeaturePoint[];
|
|
1054
|
+
readonly visual: ReactNode;
|
|
1055
|
+
/** The short label above the heading; false to open on the heading. */
|
|
1056
|
+
readonly eyebrow?: boolean;
|
|
1057
|
+
/** The paragraph under the heading; false when the points carry the argument alone. */
|
|
1058
|
+
readonly body?: boolean;
|
|
1059
|
+
/** The heading's level: 2 for a section of the page, 3 for one nested under another section's heading. */
|
|
1060
|
+
readonly headingLevel?: WebsiteHeadingLevel;
|
|
1061
|
+
readonly link?: WebsiteLinkTo;
|
|
1062
|
+
readonly layout?: WebsiteFeatureRowLayout;
|
|
1063
|
+
readonly motion?: WebsiteBlockMotion<WebsiteFeatureRowMotionPoint>;
|
|
1064
|
+
}
|
|
1065
|
+
|
|
1066
|
+
export function WebsiteFeatureRow({
|
|
1067
|
+
points = [],
|
|
1068
|
+
visual,
|
|
1069
|
+
link,
|
|
1070
|
+
eyebrow = true,
|
|
1071
|
+
body = true,
|
|
1072
|
+
headingLevel = 2,
|
|
1073
|
+
layout = WebsiteFeatureRowLayout.VISUAL_END,
|
|
1074
|
+
motion,
|
|
1075
|
+
}: WebsiteFeatureRowProps): ReactNode {
|
|
1076
|
+
const label = useWebsiteSectionLabels();
|
|
1077
|
+
return (
|
|
1078
|
+
<div data-website-block="feature-row" data-website-layout={layout}>
|
|
1079
|
+
<div data-website-part="copy" {...blockMotionAttributes(WebsiteFeatureRowMotionPoint.COPY, ROW_MOTION, motion)}>
|
|
1080
|
+
{eyebrow && <WebsiteEyebrow>{label('eyebrow')}</WebsiteEyebrow>}
|
|
1081
|
+
<WebsiteHeading level={headingLevel} variant={WebsiteHeadingVariant.HEADLINE} part="heading">
|
|
1082
|
+
{label('heading')}
|
|
1083
|
+
</WebsiteHeading>
|
|
1084
|
+
{body && (
|
|
1085
|
+
<WebsiteText variant={WebsiteTextVariant.LEAD} part="body">
|
|
1086
|
+
{label('body')}
|
|
1087
|
+
</WebsiteText>
|
|
1088
|
+
)}
|
|
1089
|
+
{points.length > 0 && (
|
|
1090
|
+
<ul data-website-point-list="">
|
|
1091
|
+
{points.map((point) => (
|
|
1092
|
+
<li key={point.ref} data-website-point="">
|
|
1093
|
+
<WebsiteIconTile size={WebsiteIconTileSize.SM}>{point.icon ?? <WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.CHECK} />}</WebsiteIconTile>
|
|
1094
|
+
<span>
|
|
1095
|
+
<strong>{label(`${point.ref}.title`)}</strong> {label(`${point.ref}.body`)}
|
|
1096
|
+
</span>
|
|
1097
|
+
</li>
|
|
1098
|
+
))}
|
|
1099
|
+
</ul>
|
|
1100
|
+
)}
|
|
1101
|
+
{link !== undefined && <WebsiteArrowLink link={link}>{label('link')}</WebsiteArrowLink>}
|
|
1102
|
+
</div>
|
|
1103
|
+
<div data-website-part="visual" {...blockMotionAttributes(WebsiteFeatureRowMotionPoint.VISUAL, ROW_MOTION, motion)}>
|
|
1104
|
+
{visual}
|
|
1105
|
+
</div>
|
|
1106
|
+
</div>
|
|
1107
|
+
);
|
|
1108
|
+
}
|
|
1109
|
+
WebsiteFeatureRow.displayName = 'WebsiteFeatureRow';
|
|
1110
|
+
```
|
|
1111
|
+
|
|
1112
|
+
## The card grid
|
|
1113
|
+
|
|
1114
|
+
## Import Origins
|
|
1115
|
+
|
|
1116
|
+
- `@wildo-ai/saas-website`
|
|
1117
|
+
|
|
1118
|
+
## Source Excerpts
|
|
1119
|
+
|
|
1120
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1121
|
+
|
|
1122
|
+
```tsx
|
|
1123
|
+
*
|
|
1124
|
+
* `WebsiteCardGrid`: a grid of cards, serving whatever category the section binds: FEATURE_BENEFIT_SUMMARY (icon-led
|
|
1125
|
+
* cards), PROBLEM (figure-led cards: what the reader's situation costs), PRODUCT_SHOWCASE (media cards that each link
|
|
1126
|
+
* to the page that shows more), INTEGRATIONS, a values section. Each card has a title and a body by slot
|
|
1127
|
+
* (`<ref>.title`, `<ref>.body`; `websiteCardGridSlots(items)` lists every slot the items read), and may be one link
|
|
1128
|
+
* (`link`: a page of the site, the application, or an external URL). A card's title is a heading (`titleLevel`, `3`
|
|
1129
|
+
* under a section's `h2`), so the page outline lists the cards. Cards lift to the band's raised surface, so they read
|
|
1130
|
+
* on a tinted or inverse band. `fit` AUTO lays out as many columns as fit, for a list whose length varies. Pair it
|
|
1131
|
+
* with `WebsiteSectionIntro` above.
|
|
1132
|
+
*/
|
|
1133
|
+
export enum WebsiteCardGridMotionPoint {
|
|
1134
|
+
/** The cards arrive one after another as the grid scrolls into view. */
|
|
1135
|
+
ITEMS = 'items',
|
|
1136
|
+
/** A card that is a link responds to the pointer. */
|
|
1137
|
+
LINK_CARD = 'link-card',
|
|
1138
|
+
}
|
|
1139
|
+
|
|
1140
|
+
const GRID_MOTION = defineBlockMotionPoints<WebsiteCardGridMotionPoint>({
|
|
1141
|
+
[WebsiteCardGridMotionPoint.ITEMS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
1142
|
+
[WebsiteCardGridMotionPoint.LINK_CARD]: { kind: WebsiteMotionPointKind.LINK_CARD, spec: { hover: WebsiteMotionHover.LIFT } },
|
|
1143
|
+
});
|
|
1144
|
+
|
|
1145
|
+
/**
|
|
1146
|
+
* One card: its slot prefix and what it carries. `figure` leads it with a number (slot `<ref>.figure`: a cost, a
|
|
1147
|
+
* count), `icon` with a glyph in a tile, `media` with a drawing edge to edge. `link` makes the whole card one link,
|
|
1148
|
+
* and `cta` adds the words that say where it goes (slot `<ref>.cta`, drawn with an arrow), so it needs a `link`: an
|
|
1149
|
+
* arrow that goes nowhere is a link that is not one.
|
|
1150
|
+
*/
|
|
1151
|
+
interface WebsiteCardItemContent {
|
|
1152
|
+
readonly ref: string;
|
|
1153
|
+
readonly icon?: ReactNode;
|
|
1154
|
+
readonly figure?: boolean;
|
|
1155
|
+
readonly media?: ReactNode;
|
|
1156
|
+
}
|
|
1157
|
+
|
|
1158
|
+
export type WebsiteCardItem = WebsiteCardItemContent &
|
|
1159
|
+
({ readonly link?: WebsiteLinkTo; readonly cta?: false } | { readonly link: WebsiteLinkTo; readonly cta: true });
|
|
1160
|
+
|
|
1161
|
+
/** What a card's words depend on, for its slot helper. */
|
|
1162
|
+
export type WebsiteCardSlotItem = Pick<WebsiteCardItemContent, 'ref' | 'figure'> & { readonly cta?: boolean };
|
|
1163
|
+
|
|
1164
|
+
export function websiteCardGridSlots(items: readonly WebsiteCardSlotItem[] | readonly string[]): string[] {
|
|
1165
|
+
return items.flatMap((item) => {
|
|
1166
|
+
const card: WebsiteCardSlotItem = typeof item === 'string' ? { ref: item } : item;
|
|
1167
|
+
return [
|
|
1168
|
+
...(card.figure === true ? [`${card.ref}.figure`] : []),
|
|
1169
|
+
`${card.ref}.title`,
|
|
1170
|
+
`${card.ref}.body`,
|
|
1171
|
+
...(card.cta === true ? [`${card.ref}.cta`] : []),
|
|
1172
|
+
];
|
|
1173
|
+
});
|
|
1174
|
+
}
|
|
1175
|
+
|
|
1176
|
+
export interface WebsiteCardGridProps {
|
|
1177
|
+
readonly items: readonly WebsiteCardItem[];
|
|
1178
|
+
/** The column count on a wide screen, when `fit` is FIXED. */
|
|
1179
|
+
readonly columns?: WebsiteCardGridColumns;
|
|
1180
|
+
/** FIXED (`columns`) or AUTO (as many as fit, each at least the theme's `layout.cardMin`). */
|
|
1181
|
+
readonly fit?: WebsiteGridFit;
|
|
1182
|
+
/** The heading level of each card's title: one below the section's heading. */
|
|
1183
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
1184
|
+
readonly motion?: WebsiteBlockMotion<WebsiteCardGridMotionPoint>;
|
|
1185
|
+
}
|
|
1186
|
+
|
|
1187
|
+
export function WebsiteCardGrid({ items, columns = 3, fit = WebsiteGridFit.FIXED, titleLevel = 3, motion }: WebsiteCardGridProps): ReactNode {
|
|
1188
|
+
const label = useWebsiteSectionLabels();
|
|
1189
|
+
const linkMotion = resolveBlockMotion(WebsiteCardGridMotionPoint.LINK_CARD, GRID_MOTION, motion);
|
|
1190
|
+
return (
|
|
1191
|
+
<ul
|
|
1192
|
+
data-website-block="card-grid"
|
|
1193
|
+
data-website-columns={fit === WebsiteGridFit.AUTO ? WebsiteGridFit.AUTO : String(columns)}
|
|
1194
|
+
{...blockMotionAttributes(WebsiteCardGridMotionPoint.ITEMS, GRID_MOTION, motion)}
|
|
1195
|
+
>
|
|
1196
|
+
{items.map((item) => {
|
|
1197
|
+
if (item.cta === true && item.link === undefined) {
|
|
1198
|
+
throw new Error(`[website card grid] Card "${item.ref}" has a call to action and no link: give it a \`link\`, or drop \`cta\`.`);
|
|
1199
|
+
}
|
|
1200
|
+
return (
|
|
1201
|
+
<WebsiteCard
|
|
1202
|
+
key={item.ref}
|
|
1203
|
+
{...(item.link === undefined ? {} : { link: item.link })}
|
|
1204
|
+
{...(item.media === undefined ? {} : { media: item.media })}
|
|
1205
|
+
{...(item.link === undefined || linkMotion === null || linkMotion === undefined ? {} : { hover: linkMotion })}
|
|
1206
|
+
>
|
|
1207
|
+
{item.figure === true && <span data-website-part="figure">{label(`${item.ref}.figure`)}</span>}
|
|
1208
|
+
{item.icon !== undefined && <WebsiteIconTile>{item.icon}</WebsiteIconTile>}
|
|
1209
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
1210
|
+
{label(`${item.ref}.title`)}
|
|
1211
|
+
</WebsiteHeading>
|
|
1212
|
+
<span data-website-part="body">{label(`${item.ref}.body`)}</span>
|
|
1213
|
+
{item.cta === true && (
|
|
1214
|
+
<span data-website-part="arrow-link">
|
|
1215
|
+
{label(`${item.ref}.cta`)}
|
|
1216
|
+
<WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
|
|
1217
|
+
</span>
|
|
1218
|
+
)}
|
|
1219
|
+
</WebsiteCard>
|
|
1220
|
+
);
|
|
1221
|
+
})}
|
|
1222
|
+
</ul>
|
|
1223
|
+
);
|
|
1224
|
+
}
|
|
1225
|
+
WebsiteCardGrid.displayName = 'WebsiteCardGrid';
|
|
1226
|
+
```
|
|
1227
|
+
|
|
1228
|
+
## The closing band
|
|
1229
|
+
|
|
1230
|
+
## Import Origins
|
|
1231
|
+
|
|
1232
|
+
- `@wildo-ai/saas-website`
|
|
1233
|
+
|
|
1234
|
+
## Source Excerpts
|
|
1235
|
+
|
|
1236
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1237
|
+
|
|
1238
|
+
```tsx
|
|
1239
|
+
*
|
|
1240
|
+
* `WebsiteCtaBand`: a call to action as a band of its own (FOOTER_CTA, or a mid-page CTA on another `tone`), INVERSE
|
|
1241
|
+
* by default, with an optional eyebrow, the heading, an optional sentence and the actions centred; `decoration` draws
|
|
1242
|
+
* the site's motif behind it. Slots: `eyebrow` (when `eyebrow` is true), `heading`, `body` (unless `body` is false),
|
|
1243
|
+
* `cta.primary` / `cta.secondary` (`websiteCtaBandSlots`, given the same options).
|
|
1244
|
+
*/
|
|
1245
|
+
export enum WebsiteCtaBandMotionPoint {
|
|
1246
|
+
CONTENT = 'content',
|
|
1247
|
+
}
|
|
1248
|
+
|
|
1249
|
+
const CTA_MOTION = defineBlockMotionPoints<WebsiteCtaBandMotionPoint>({
|
|
1250
|
+
[WebsiteCtaBandMotionPoint.CONTENT]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
|
|
1251
|
+
});
|
|
1252
|
+
|
|
1253
|
+
export function websiteCtaBandSlots(options: {
|
|
1254
|
+
readonly primaryAction?: unknown;
|
|
1255
|
+
readonly secondaryAction?: unknown;
|
|
1256
|
+
readonly eyebrow?: boolean;
|
|
1257
|
+
readonly body?: boolean;
|
|
1258
|
+
}): string[] {
|
|
1259
|
+
return [
|
|
1260
|
+
...(options.eyebrow === true ? ['eyebrow'] : []),
|
|
1261
|
+
'heading',
|
|
1262
|
+
...(options.body === false ? [] : ['body']),
|
|
1263
|
+
...websiteCallToActionSlots({ primary: options.primaryAction, secondary: options.secondaryAction }),
|
|
1264
|
+
];
|
|
1265
|
+
}
|
|
1266
|
+
|
|
1267
|
+
export interface WebsiteCtaBandProps {
|
|
1268
|
+
readonly tone?: WebsiteSurfaceTone;
|
|
1269
|
+
readonly spacing?: WebsiteBandSpacing;
|
|
1270
|
+
/** A short label above the heading; off by default, as a page's close rarely needs one. */
|
|
1271
|
+
readonly eyebrow?: boolean;
|
|
1272
|
+
/** The sentence under the heading; false for a heading and buttons alone. */
|
|
1273
|
+
readonly body?: boolean;
|
|
1274
|
+
/** The heading's level: 2 for a section of the page, 3 for one nested under another section's heading. */
|
|
1275
|
+
readonly headingLevel?: WebsiteHeadingLevel;
|
|
1276
|
+
readonly primaryAction?: WebsiteLinkTo;
|
|
1277
|
+
readonly secondaryAction?: WebsiteLinkTo;
|
|
1278
|
+
readonly decoration?: ReactNode;
|
|
1279
|
+
readonly motion?: WebsiteBlockMotion<WebsiteCtaBandMotionPoint>;
|
|
1280
|
+
}
|
|
1281
|
+
|
|
1282
|
+
export function WebsiteCtaBand({
|
|
1283
|
+
tone = WebsiteSurfaceTone.INVERSE,
|
|
1284
|
+
spacing = WebsiteBandSpacing.DEFAULT,
|
|
1285
|
+
eyebrow = false,
|
|
1286
|
+
body = true,
|
|
1287
|
+
headingLevel = 2,
|
|
1288
|
+
primaryAction,
|
|
1289
|
+
secondaryAction,
|
|
1290
|
+
decoration,
|
|
1291
|
+
motion,
|
|
1292
|
+
}: WebsiteCtaBandProps): ReactNode {
|
|
1293
|
+
const label = useWebsiteSectionLabels();
|
|
1294
|
+
return (
|
|
1295
|
+
<div data-website-block="band" data-website-band-role="cta" data-website-tone={tone} data-website-band-spacing={spacing}>
|
|
1296
|
+
{decoration !== undefined && (
|
|
1297
|
+
<div data-website-part="decoration" aria-hidden="true">
|
|
1298
|
+
{decoration}
|
|
1299
|
+
</div>
|
|
1300
|
+
)}
|
|
1301
|
+
<div data-website-shell="" data-website-block="cta" {...blockMotionAttributes(WebsiteCtaBandMotionPoint.CONTENT, CTA_MOTION, motion)}>
|
|
1302
|
+
{eyebrow && <WebsiteEyebrow>{label('eyebrow')}</WebsiteEyebrow>}
|
|
1303
|
+
<WebsiteHeading level={headingLevel} variant={WebsiteHeadingVariant.HEADLINE} part="heading">
|
|
1304
|
+
{label('heading')}
|
|
1305
|
+
</WebsiteHeading>
|
|
1306
|
+
{body && (
|
|
1307
|
+
<WebsiteText variant={WebsiteTextVariant.LEAD} part="body">
|
|
1308
|
+
{label('body')}
|
|
1309
|
+
</WebsiteText>
|
|
1310
|
+
)}
|
|
1311
|
+
{(primaryAction !== undefined || secondaryAction !== undefined) && (
|
|
1312
|
+
<div data-website-actions="">
|
|
1313
|
+
<WebsiteCallToActions {...(primaryAction === undefined ? {} : { primary: primaryAction })} {...(secondaryAction === undefined ? {} : { secondary: secondaryAction })} />
|
|
1314
|
+
</div>
|
|
1315
|
+
)}
|
|
1316
|
+
</div>
|
|
1317
|
+
</div>
|
|
1318
|
+
);
|
|
1319
|
+
}
|
|
1320
|
+
WebsiteCtaBand.displayName = 'WebsiteCtaBand';
|
|
1321
|
+
```
|
|
1322
|
+
|
|
1323
|
+
## Cards and icon tiles
|
|
1324
|
+
|
|
1325
|
+
## Import Origins
|
|
1326
|
+
|
|
1327
|
+
- `@wildo-ai/saas-website`
|
|
1328
|
+
|
|
1329
|
+
## Source Excerpts
|
|
1330
|
+
|
|
1331
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1332
|
+
|
|
1333
|
+
```tsx
|
|
1334
|
+
*
|
|
1335
|
+
* `WebsiteCard`: one card, the shell every card-shaped block shares (#2742). A raised surface of the band it sits on,
|
|
1336
|
+
* the theme's card corner and padding, a hairline edge. With `link` the whole card is one link (a single tab stop,
|
|
1337
|
+
* named by its content), with `hover` motion when it is. `media` is drawn edge to edge above the copy: a product
|
|
1338
|
+
* drawing, a screenshot. The card is an `<li>` by default, because cards come in lists; `as="div"` for a lone card.
|
|
1339
|
+
* Hook: `data-website-card` (`data-website-card="media"` when it carries media).
|
|
1340
|
+
*
|
|
1341
|
+
* `WebsiteIconTile`: the square of colour behind a glyph, `aria-hidden` (the glyph decorates, the words beside it
|
|
1342
|
+
* say what it is). `size` SM beside a line, MD leading a card, LG leading a card that is a choice; `tileStyle` WASH (the
|
|
1343
|
+
* tone's primary on a wash of it) or SOLID (the tone's background on its foreground).
|
|
1344
|
+
*/
|
|
1345
|
+
export interface WebsiteCardProps {
|
|
1346
|
+
readonly link?: WebsiteLinkTo;
|
|
1347
|
+
/** The hover response of a card that is a link; none when omitted. */
|
|
1348
|
+
readonly hover?: WebsiteMotionSpec;
|
|
1349
|
+
readonly media?: ReactNode;
|
|
1350
|
+
/** The card's size in its block's layout (`data-website-size`): a bento tile's. */
|
|
1351
|
+
readonly size?: WebsiteBentoTileSize;
|
|
1352
|
+
readonly as?: 'li' | 'div';
|
|
1353
|
+
readonly children: ReactNode;
|
|
1354
|
+
}
|
|
1355
|
+
|
|
1356
|
+
export function WebsiteCard({ link, hover, media, size, as = 'li', children }: WebsiteCardProps): ReactNode {
|
|
1357
|
+
const Element = as;
|
|
1358
|
+
const content = (
|
|
1359
|
+
<>
|
|
1360
|
+
{media !== undefined && (
|
|
1361
|
+
// Divs, not spans: a drawing (a demo stage) is block content, which a span may not hold.
|
|
1362
|
+
<div data-website-part="media" aria-hidden="true">
|
|
1363
|
+
{media}
|
|
1364
|
+
</div>
|
|
1365
|
+
)}
|
|
1366
|
+
{media !== undefined ? <div data-website-part="copy">{children}</div> : children}
|
|
1367
|
+
</>
|
|
1368
|
+
);
|
|
1369
|
+
return (
|
|
1370
|
+
<Element data-website-card={media !== undefined ? 'media' : ''} {...(size === undefined ? {} : { 'data-website-size': size })}>
|
|
1371
|
+
{link === undefined ? (
|
|
1372
|
+
content
|
|
1373
|
+
) : (
|
|
1374
|
+
<WebsiteBlockLink link={link} part="link" {...(hover === undefined ? {} : { motion: hover })}>
|
|
1375
|
+
{content}
|
|
1376
|
+
</WebsiteBlockLink>
|
|
1377
|
+
)}
|
|
1378
|
+
</Element>
|
|
1379
|
+
);
|
|
1380
|
+
}
|
|
1381
|
+
WebsiteCard.displayName = 'WebsiteCard';
|
|
1382
|
+
|
|
1383
|
+
export function WebsiteIconTile({
|
|
1384
|
+
size = WebsiteIconTileSize.MD,
|
|
1385
|
+
tileStyle = WebsiteIconTileStyle.WASH,
|
|
1386
|
+
children,
|
|
1387
|
+
}: {
|
|
1388
|
+
size?: WebsiteIconTileSize;
|
|
1389
|
+
tileStyle?: WebsiteIconTileStyle;
|
|
1390
|
+
children: ReactNode;
|
|
1391
|
+
}): ReactNode {
|
|
1392
|
+
return (
|
|
1393
|
+
<span data-website-icon-tile={size} data-website-icon-tile-style={tileStyle} aria-hidden="true">
|
|
1394
|
+
{children}
|
|
1395
|
+
</span>
|
|
1396
|
+
);
|
|
1397
|
+
}
|
|
1398
|
+
WebsiteIconTile.displayName = 'WebsiteIconTile';
|
|
1399
|
+
```
|
|
1400
|
+
|
|
1401
|
+
## Steps
|
|
1402
|
+
|
|
1403
|
+
## Import Origins
|
|
1404
|
+
|
|
1405
|
+
- `@wildo-ai/saas-website`
|
|
1406
|
+
|
|
1407
|
+
## Source Excerpts
|
|
1408
|
+
|
|
1409
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1410
|
+
|
|
1411
|
+
```tsx
|
|
1412
|
+
*
|
|
1413
|
+
* `WebsiteSteps`: how it works (HOW_IT_WORKS), as an ordered list of numbered cards (#2742). Each step has a title and
|
|
1414
|
+
* a body by slot (`<ref>.title`, `<ref>.body`; `websiteStepsSlots(steps)`), and may carry a `visual` drawn above it
|
|
1415
|
+
* (a small product drawing, `aria-hidden`: the words say what the step is). `layout` ROW sets them side by side and
|
|
1416
|
+
* stacks them on a narrow screen; STACK puts them one under the other. The number is the list's own order, drawn in a
|
|
1417
|
+
* disc; a step's title is a heading one level under the section's (`titleLevel`).
|
|
1418
|
+
*/
|
|
1419
|
+
export enum WebsiteStepsMotionPoint {
|
|
1420
|
+
/** The steps arrive one after another, in their order. */
|
|
1421
|
+
STEPS = 'steps',
|
|
1422
|
+
}
|
|
1423
|
+
|
|
1424
|
+
const STEPS_MOTION = defineBlockMotionPoints<WebsiteStepsMotionPoint>({
|
|
1425
|
+
[WebsiteStepsMotionPoint.STEPS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
1426
|
+
});
|
|
1427
|
+
|
|
1428
|
+
/** One step: its slot prefix, and a drawing of it if the step is better shown than told. */
|
|
1429
|
+
export interface WebsiteStep {
|
|
1430
|
+
readonly ref: string;
|
|
1431
|
+
readonly visual?: ReactNode;
|
|
1432
|
+
}
|
|
1433
|
+
|
|
1434
|
+
export function websiteStepsSlots(steps: readonly WebsiteStep[] | readonly string[]): string[] {
|
|
1435
|
+
return steps.map((step) => (typeof step === 'string' ? step : step.ref)).flatMap((ref) => [`${ref}.title`, `${ref}.body`]);
|
|
1436
|
+
}
|
|
1437
|
+
|
|
1438
|
+
export interface WebsiteStepsProps {
|
|
1439
|
+
readonly steps: readonly WebsiteStep[];
|
|
1440
|
+
readonly layout?: WebsiteStepsLayout;
|
|
1441
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
1442
|
+
readonly motion?: WebsiteBlockMotion<WebsiteStepsMotionPoint>;
|
|
1443
|
+
}
|
|
1444
|
+
|
|
1445
|
+
export function WebsiteSteps({ steps, layout = WebsiteStepsLayout.ROW, titleLevel = 3, motion }: WebsiteStepsProps): ReactNode {
|
|
1446
|
+
const label = useWebsiteSectionLabels();
|
|
1447
|
+
return (
|
|
1448
|
+
<ol data-website-block="steps" data-website-layout={layout} {...blockMotionAttributes(WebsiteStepsMotionPoint.STEPS, STEPS_MOTION, motion)}>
|
|
1449
|
+
{steps.map((step, position) => (
|
|
1450
|
+
<li key={step.ref} data-website-card="">
|
|
1451
|
+
{step.visual !== undefined && (
|
|
1452
|
+
<div data-website-part="visual" aria-hidden="true">
|
|
1453
|
+
{step.visual}
|
|
1454
|
+
</div>
|
|
1455
|
+
)}
|
|
1456
|
+
<span data-website-part="number" aria-hidden="true">
|
|
1457
|
+
{position + 1}
|
|
1458
|
+
</span>
|
|
1459
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
1460
|
+
{label(`${step.ref}.title`)}
|
|
1461
|
+
</WebsiteHeading>
|
|
1462
|
+
<span data-website-part="body">{label(`${step.ref}.body`)}</span>
|
|
1463
|
+
</li>
|
|
1464
|
+
))}
|
|
1465
|
+
</ol>
|
|
1466
|
+
);
|
|
1467
|
+
}
|
|
1468
|
+
WebsiteSteps.displayName = 'WebsiteSteps';
|
|
1469
|
+
```
|
|
1470
|
+
|
|
1471
|
+
## Stats and the count-up
|
|
1472
|
+
|
|
1473
|
+
## Import Origins
|
|
1474
|
+
|
|
1475
|
+
- `@wildo-ai/saas-website`
|
|
1476
|
+
|
|
1477
|
+
## Source Excerpts
|
|
1478
|
+
|
|
1479
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1480
|
+
|
|
1481
|
+
```tsx
|
|
1482
|
+
*
|
|
1483
|
+
* `WebsiteStats`: facts as numbers (STATS), a description list of cells joined by hairlines (#2742). Each stat has a
|
|
1484
|
+
* value, a label and a note by slot (`<ref>.value`, `<ref>.label`, `<ref>.note`; `websiteStatsSlots(stats)`). The
|
|
1485
|
+
* value is the figure a person reads first; it counts up once, the first time it is seen (`WebsiteCountUp`).
|
|
1486
|
+
*
|
|
1487
|
+
* `WebsiteCountUp`: a number in a text counting up from zero, once, on the site's tempo (about 1.7 × the tempo's long
|
|
1488
|
+
* duration: 1.4 s on FLUID). The text itself is what the server renders, what a screen reader reads (the moving copy
|
|
1489
|
+
* is `aria-hidden`) and what a visitor who asked for reduced motion, or a STILL site, sees. A one-off movement under
|
|
1490
|
+
* two seconds, so no pause control is owed (WCAG 2.2.2's five seconds). A text with no number is shown as it is.
|
|
1491
|
+
* The figure is read in the PAGE's locale (`parseWebsiteCountUpFigure`): "10,000" is ten thousand on an English page,
|
|
1492
|
+
* "1 234" one thousand two hundred and thirty-four on a French one, and the moving copy keeps the figure's grouping
|
|
1493
|
+
* and decimals. A figure the locale cannot read unambiguously is shown as written, never counted wrongly.
|
|
1494
|
+
*/
|
|
1495
|
+
export enum WebsiteStatsMotionPoint {
|
|
1496
|
+
/** The stats arrive one after another. */
|
|
1497
|
+
STATS = 'stats',
|
|
1498
|
+
}
|
|
1499
|
+
|
|
1500
|
+
const STATS_MOTION = defineBlockMotionPoints<WebsiteStatsMotionPoint>({
|
|
1501
|
+
[WebsiteStatsMotionPoint.STATS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
1502
|
+
});
|
|
1503
|
+
|
|
1504
|
+
export function websiteStatsSlots(stats: readonly string[]): string[] {
|
|
1505
|
+
return stats.flatMap((ref) => [`${ref}.value`, `${ref}.label`, `${ref}.note`]);
|
|
1506
|
+
}
|
|
1507
|
+
|
|
1508
|
+
export interface WebsiteStatsProps {
|
|
1509
|
+
/** The slot prefix of each stat, in order. */
|
|
1510
|
+
readonly stats: readonly string[];
|
|
1511
|
+
readonly columns?: WebsiteCardGridColumns;
|
|
1512
|
+
/** False to show each figure as it is, without counting. */
|
|
1513
|
+
readonly countUp?: boolean;
|
|
1514
|
+
readonly motion?: WebsiteBlockMotion<WebsiteStatsMotionPoint>;
|
|
1515
|
+
}
|
|
1516
|
+
|
|
1517
|
+
export function WebsiteStats({ stats, columns = 4, countUp = true, motion }: WebsiteStatsProps): ReactNode {
|
|
1518
|
+
const label = useWebsiteSectionLabels();
|
|
1519
|
+
return (
|
|
1520
|
+
<dl data-website-block="stats" data-website-columns={String(columns)} {...blockMotionAttributes(WebsiteStatsMotionPoint.STATS, STATS_MOTION, motion)}>
|
|
1521
|
+
{stats.map((ref) => (
|
|
1522
|
+
<div key={ref} data-website-part="stat">
|
|
1523
|
+
<dt data-website-part="label">{label(`${ref}.label`)}</dt>
|
|
1524
|
+
<dd data-website-part="value">{countUp ? <WebsiteCountUp text={label(`${ref}.value`)} /> : label(`${ref}.value`)}</dd>
|
|
1525
|
+
<dd data-website-part="note">{label(`${ref}.note`)}</dd>
|
|
1526
|
+
</div>
|
|
1527
|
+
))}
|
|
1528
|
+
</dl>
|
|
1529
|
+
);
|
|
1530
|
+
}
|
|
1531
|
+
WebsiteStats.displayName = 'WebsiteStats';
|
|
1532
|
+
|
|
1533
|
+
/** A figure inside a text, read in a locale: what stands before and after it, its value, and how it is written. */
|
|
1534
|
+
export interface WebsiteCountUpFigure {
|
|
1535
|
+
readonly prefix: string;
|
|
1536
|
+
readonly value: number;
|
|
1537
|
+
readonly fractionDigits: number;
|
|
1538
|
+
/** The mark grouping the figure's thousands as the text writes it, or null when it is written ungrouped. */
|
|
1539
|
+
readonly groupMark: string | null;
|
|
1540
|
+
readonly suffix: string;
|
|
1541
|
+
}
|
|
1542
|
+
|
|
1543
|
+
/**
|
|
1544
|
+
* Marks a writer types for the same group mark: any space for a space (a figure may always group with one), and either
|
|
1545
|
+
* apostrophe where the locale groups with an apostrophe (Swiss German: ICU writes ', people often type ’).
|
|
1546
|
+
*/
|
|
1547
|
+
const SPACE_MARKS = new Set([' ', '\u00a0', '\u202f']);
|
|
1548
|
+
const APOSTROPHE_MARKS = new Set(["'", '\u2019']);
|
|
1549
|
+
|
|
1550
|
+
const escapeForCharacterClass = (value: string) => value.replace(/[\\\]^-]/g, '\\$&');
|
|
1551
|
+
|
|
1552
|
+
/**
|
|
1553
|
+
* Reads the first figure in `text` the way a reader of `locale` reads it: the locale's decimal mark separates the
|
|
1554
|
+
* fraction, its group mark (or a space) groups thousands. Null when there is no figure, or when the figure is not
|
|
1555
|
+
* one number written the way the locale writes it: the figure is accepted only when writing its value back, with
|
|
1556
|
+
* the same grouping and decimals, gives exactly the figure. So "1,5x" on an English page, "10,00", "Top 3 2024" or
|
|
1557
|
+
* "4 1/2" are shown as written rather than counted to 15, 1000, 32024 or 41.
|
|
1558
|
+
*/
|
|
1559
|
+
export function parseWebsiteCountUpFigure(text: string, locale: string): WebsiteCountUpFigure | null {
|
|
1560
|
+
const parts = new Intl.NumberFormat(locale).formatToParts(11111.1);
|
|
1561
|
+
const decimalMark = parts.find((part) => part.type === 'decimal')?.value ?? '.';
|
|
1562
|
+
const localeGroup = parts.find((part) => part.type === 'group')?.value ?? ',';
|
|
1563
|
+
const marks = escapeForCharacterClass(`.,'\u2019\u00a0\u202f ${localeGroup}${decimalMark}`);
|
|
1564
|
+
const match = new RegExp(`^(\\D*?)(\\d(?:[\\d${marks}]*\\d)?)(.*)$`, 'su').exec(text);
|
|
1565
|
+
if (match === null) return null;
|
|
1566
|
+
const [, prefix = '', body = '', suffix = ''] = match;
|
|
1567
|
+
const isGroupMark = (mark: string) => mark === localeGroup || SPACE_MARKS.has(mark) || (APOSTROPHE_MARKS.has(mark) && APOSTROPHE_MARKS.has(localeGroup));
|
|
1568
|
+
const pieces = body.split(decimalMark);
|
|
1569
|
+
if (pieces.length > 2) return null;
|
|
1570
|
+
const [integerPart = '', fractionPart = ''] = pieces;
|
|
1571
|
+
if (!/^\d*$/.test(fractionPart)) return null;
|
|
1572
|
+
const groupMarks = [...integerPart].filter((character) => !/\d/.test(character));
|
|
1573
|
+
if (!groupMarks.every(isGroupMark)) return null;
|
|
1574
|
+
const digits = integerPart.replace(/\D/g, '');
|
|
1575
|
+
const figure: WebsiteCountUpFigure = {
|
|
1576
|
+
prefix,
|
|
1577
|
+
value: Number(`${digits}.${fractionPart || '0'}`),
|
|
1578
|
+
fractionDigits: fractionPart.length,
|
|
1579
|
+
groupMark: groupMarks[0] ?? null,
|
|
1580
|
+
suffix,
|
|
1581
|
+
};
|
|
1582
|
+
return formatCountUpValue(figure.value, figure, locale) === body ? figure : null;
|
|
1583
|
+
}
|
|
1584
|
+
|
|
1585
|
+
/** A value written the way its figure is: the same decimals, grouped with the same mark (or not at all). */
|
|
1586
|
+
function formatCountUpValue(value: number, figure: WebsiteCountUpFigure, locale: string): string {
|
|
1587
|
+
// Latin digits: the figure was written with them (the reader matches nothing else), so the count uses them too.
|
|
1588
|
+
const formatter = new Intl.NumberFormat(locale, {
|
|
1589
|
+
numberingSystem: 'latn',
|
|
1590
|
+
useGrouping: figure.groupMark !== null,
|
|
1591
|
+
minimumFractionDigits: figure.fractionDigits,
|
|
1592
|
+
maximumFractionDigits: figure.fractionDigits,
|
|
1593
|
+
});
|
|
1594
|
+
return formatter
|
|
1595
|
+
.formatToParts(value)
|
|
1596
|
+
.map((part) => (part.type === 'group' && figure.groupMark !== null ? figure.groupMark : part.value))
|
|
1597
|
+
.join('');
|
|
1598
|
+
}
|
|
1599
|
+
|
|
1600
|
+
const REDUCED_MOTION = '(prefers-reduced-motion: reduce)';
|
|
1601
|
+
/** How many of the tempo's long durations a count lasts: long enough to read as counting, short enough to be done. */
|
|
1602
|
+
const COUNT_UP_TEMPO_MULTIPLE = 1.7;
|
|
1603
|
+
|
|
1604
|
+
export function WebsiteCountUp({ text }: { text: string }): ReactNode {
|
|
1605
|
+
const tempo = WEBSITE_MOTION_TEMPO[resolveWebsiteMotionTokens(useWebsiteDesignTokens().motion).tempo];
|
|
1606
|
+
const { locale } = useWebsiteRuntime();
|
|
1607
|
+
const figure = parseWebsiteCountUpFigure(text, locale);
|
|
1608
|
+
const target = figure === null ? null : figure.value;
|
|
1609
|
+
const scale = 10 ** (figure?.fractionDigits ?? 0);
|
|
1610
|
+
const duration = Number.parseFloat(tempo.durationLong) * COUNT_UP_TEMPO_MULTIPLE;
|
|
1611
|
+
const ref = useRef<HTMLSpanElement | null>(null);
|
|
1612
|
+
const [shown, setShown] = useState<number | null>(null);
|
|
1613
|
+
useEffect(() => {
|
|
1614
|
+
const element = ref.current;
|
|
1615
|
+
if (element === null || target === null || target === 0 || !tempo.playsChoreography || !(duration > 0)) return undefined;
|
|
1616
|
+
if (typeof window.matchMedia === 'function' && window.matchMedia(REDUCED_MOTION).matches) return undefined;
|
|
1617
|
+
if (typeof IntersectionObserver === 'undefined') return undefined;
|
|
1618
|
+
let frame = 0;
|
|
1619
|
+
const observer = new IntersectionObserver((entries) => {
|
|
1620
|
+
if (!entries.some((entry) => entry.isIntersecting)) return;
|
|
1621
|
+
observer.disconnect();
|
|
1622
|
+
const start = performance.now();
|
|
1623
|
+
const tick = (now: number): void => {
|
|
1624
|
+
const progress = Math.min(1, (now - start) / duration);
|
|
1625
|
+
const eased = 1 - (1 - progress) ** 3;
|
|
1626
|
+
setShown(progress >= 1 ? null : Math.round(target * eased * scale) / scale);
|
|
1627
|
+
if (progress < 1) frame = requestAnimationFrame(tick);
|
|
1628
|
+
};
|
|
1629
|
+
setShown(0);
|
|
1630
|
+
frame = requestAnimationFrame(tick);
|
|
1631
|
+
});
|
|
1632
|
+
observer.observe(element);
|
|
1633
|
+
return () => {
|
|
1634
|
+
observer.disconnect();
|
|
1635
|
+
cancelAnimationFrame(frame);
|
|
1636
|
+
};
|
|
1637
|
+
}, [target, scale, duration, tempo.playsChoreography]);
|
|
1638
|
+
if (figure === null) return <span>{text}</span>;
|
|
1639
|
+
return (
|
|
1640
|
+
<span ref={ref} data-website-count-up="">
|
|
1641
|
+
<span data-website-part="final">{text}</span>
|
|
1642
|
+
{shown !== null && (
|
|
1643
|
+
<span data-website-part="moving" aria-hidden="true">
|
|
1644
|
+
{figure.prefix}
|
|
1645
|
+
{formatCountUpValue(shown, figure, locale)}
|
|
1646
|
+
{figure.suffix}
|
|
1647
|
+
</span>
|
|
1648
|
+
)}
|
|
1649
|
+
</span>
|
|
1650
|
+
);
|
|
1651
|
+
}
|
|
1652
|
+
WebsiteCountUp.displayName = 'WebsiteCountUp';
|
|
1653
|
+
```
|
|
1654
|
+
|
|
1655
|
+
## Comparison and fact tables
|
|
1656
|
+
|
|
1657
|
+
## Import Origins
|
|
1658
|
+
|
|
1659
|
+
- `@wildo-ai/saas-website`
|
|
1660
|
+
|
|
1661
|
+
## Source Excerpts
|
|
1662
|
+
|
|
1663
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1664
|
+
|
|
1665
|
+
```tsx
|
|
1666
|
+
*
|
|
1667
|
+
* Two real tables (#2742), scrollable sideways inside their frame on a narrow screen, never squeezed:
|
|
1668
|
+
*
|
|
1669
|
+
* - `WebsiteComparisonTable` (COMPARISON): the product against the alternatives. A caption naming the table (slot
|
|
1670
|
+
* `caption`, visually hidden unless `showCaption`: the section's heading says it to a sighted reader, the caption
|
|
1671
|
+
* says it to a screen reader moving through tables), a corner header (slot `criterion`),
|
|
1672
|
+
* one column per option (`<column>.name`), one row per criterion (`<row>.criterion`, then `<row>.<column>` per
|
|
1673
|
+
* cell). `highlight` names the column that is the product's, tinted and named in the header's colour, so the
|
|
1674
|
+
* honest table still says which side the page is on. `websiteComparisonTableSlots(rows, columns)`.
|
|
1675
|
+
* - `WebsiteFactTable`: facts in rows (a retention schedule, a limits table). A caption (slot `caption`, visually
|
|
1676
|
+
* hidden unless `showCaption`), one header per column (`<column>.name`), the first cell of each row as its header
|
|
1677
|
+
* (`<row>.<column>`). `websiteFactTableSlots(rows, columns)`.
|
|
1678
|
+
*
|
|
1679
|
+
* Rows and columns are named by REF, so a page's words stay readable (`row1.column2` is fine; `retention.audit`
|
|
1680
|
+
* better). Hook: `data-website-block="table"`, `data-website-layout` COMPARISON or FACTS, `data-website-part
|
|
1681
|
+
* ="highlight"` on the product's cells.
|
|
1682
|
+
*/
|
|
1683
|
+
export enum WebsiteTableMotionPoint {
|
|
1684
|
+
/** The table rises into place as it scrolls into view. */
|
|
1685
|
+
TABLE = 'table',
|
|
1686
|
+
}
|
|
1687
|
+
|
|
1688
|
+
const TABLE_MOTION = defineBlockMotionPoints<WebsiteTableMotionPoint>({
|
|
1689
|
+
[WebsiteTableMotionPoint.TABLE]: { kind: WebsiteMotionPointKind.COPY, spec: { reveal: WebsiteMotionReveal.RISE } },
|
|
1690
|
+
});
|
|
1691
|
+
|
|
1692
|
+
/** Which table a `WebsiteTable*` block draws: the layout hook its stylesheet reads. */
|
|
1693
|
+
export enum WebsiteTableLayout {
|
|
1694
|
+
COMPARISON = 'comparison',
|
|
1695
|
+
FACTS = 'facts',
|
|
1696
|
+
}
|
|
1697
|
+
|
|
1698
|
+
export function websiteComparisonTableSlots(rows: readonly string[], columns: readonly string[]): string[] {
|
|
1699
|
+
return ['caption', 'criterion', ...columns.map((column) => `${column}.name`), ...rows.flatMap((row) => [`${row}.criterion`, ...columns.map((column) => `${row}.${column}`)])];
|
|
1700
|
+
}
|
|
1701
|
+
|
|
1702
|
+
export function websiteFactTableSlots(rows: readonly string[], columns: readonly string[]): string[] {
|
|
1703
|
+
return ['caption', ...columns.map((column) => `${column}.name`), ...rows.flatMap((row) => columns.map((column) => `${row}.${column}`))];
|
|
1704
|
+
}
|
|
1705
|
+
|
|
1706
|
+
export interface WebsiteComparisonTableProps {
|
|
1707
|
+
readonly rows: readonly string[];
|
|
1708
|
+
readonly columns: readonly string[];
|
|
1709
|
+
/** The product's own column. */
|
|
1710
|
+
readonly highlight?: string;
|
|
1711
|
+
/** Show the caption above the table; by default it is read by assistive technology only (the section's heading names the table). */
|
|
1712
|
+
readonly showCaption?: boolean;
|
|
1713
|
+
readonly motion?: WebsiteBlockMotion<WebsiteTableMotionPoint>;
|
|
1714
|
+
}
|
|
1715
|
+
|
|
1716
|
+
/**
|
|
1717
|
+
* A table is wider than a phone (its `min-width`), so its wrapper scrolls sideways there, and a region that scrolls must
|
|
1718
|
+
* be reachable by keyboard (WCAG 2.1.1; axe's `scrollable-region-focusable`, found by `wildo website look` on two
|
|
1719
|
+
* pages, #2742 step 5f). So the wrapper is a focusable region named by the table's own caption, as the practice for a
|
|
1720
|
+
* scrolling table is: arrow keys scroll it once focused, and a screen reader announces what it holds.
|
|
1721
|
+
*/
|
|
1722
|
+
// semantic-literal-boundary: an ARIA role and tab index, the DOM's own vocabulary
|
|
1723
|
+
function scrollRegion(captionId: string): { readonly role: 'region'; readonly tabIndex: 0; readonly 'aria-labelledby': string } {
|
|
1724
|
+
return { role: 'region', tabIndex: 0, 'aria-labelledby': captionId };
|
|
1725
|
+
}
|
|
1726
|
+
|
|
1727
|
+
export function WebsiteComparisonTable({ rows, columns, highlight, showCaption = false, motion }: WebsiteComparisonTableProps): ReactNode {
|
|
1728
|
+
const label = useWebsiteSectionLabels();
|
|
1729
|
+
const captionId = useId();
|
|
1730
|
+
const part = (column: string) => (column === highlight ? { 'data-website-part': 'highlight' } : {});
|
|
1731
|
+
return (
|
|
1732
|
+
<div data-website-block="table" data-website-layout={WebsiteTableLayout.COMPARISON} {...scrollRegion(captionId)} {...blockMotionAttributes(WebsiteTableMotionPoint.TABLE, TABLE_MOTION, motion)}>
|
|
1733
|
+
<table>
|
|
1734
|
+
<caption id={captionId} {...(showCaption ? {} : { 'data-website-visually-hidden': '' })}>{label('caption')}</caption>
|
|
1735
|
+
<thead>
|
|
1736
|
+
<tr>
|
|
1737
|
+
<th scope="col">{label('criterion')}</th>
|
|
1738
|
+
{columns.map((column) => (
|
|
1739
|
+
<th key={column} scope="col" {...part(column)}>
|
|
1740
|
+
{label(`${column}.name`)}
|
|
1741
|
+
</th>
|
|
1742
|
+
))}
|
|
1743
|
+
</tr>
|
|
1744
|
+
</thead>
|
|
1745
|
+
<tbody>
|
|
1746
|
+
{rows.map((row) => (
|
|
1747
|
+
<tr key={row}>
|
|
1748
|
+
<th scope="row">{label(`${row}.criterion`)}</th>
|
|
1749
|
+
{columns.map((column) => (
|
|
1750
|
+
<td key={column} {...part(column)}>
|
|
1751
|
+
{label(`${row}.${column}`)}
|
|
1752
|
+
</td>
|
|
1753
|
+
))}
|
|
1754
|
+
</tr>
|
|
1755
|
+
))}
|
|
1756
|
+
</tbody>
|
|
1757
|
+
</table>
|
|
1758
|
+
</div>
|
|
1759
|
+
);
|
|
1760
|
+
}
|
|
1761
|
+
WebsiteComparisonTable.displayName = 'WebsiteComparisonTable';
|
|
1762
|
+
|
|
1763
|
+
export interface WebsiteFactTableProps {
|
|
1764
|
+
readonly rows: readonly string[];
|
|
1765
|
+
readonly columns: readonly string[];
|
|
1766
|
+
/** Show the caption above the table; by default it is read by assistive technology only (the section's heading names the table). */
|
|
1767
|
+
readonly showCaption?: boolean;
|
|
1768
|
+
readonly motion?: WebsiteBlockMotion<WebsiteTableMotionPoint>;
|
|
1769
|
+
}
|
|
1770
|
+
|
|
1771
|
+
export function WebsiteFactTable({ rows, columns, showCaption = false, motion }: WebsiteFactTableProps): ReactNode {
|
|
1772
|
+
const label = useWebsiteSectionLabels();
|
|
1773
|
+
const captionId = useId();
|
|
1774
|
+
return (
|
|
1775
|
+
<div data-website-block="table" data-website-layout={WebsiteTableLayout.FACTS} {...scrollRegion(captionId)} {...blockMotionAttributes(WebsiteTableMotionPoint.TABLE, TABLE_MOTION, motion)}>
|
|
1776
|
+
<table>
|
|
1777
|
+
<caption id={captionId} {...(showCaption ? {} : { 'data-website-visually-hidden': '' })}>{label('caption')}</caption>
|
|
1778
|
+
<thead>
|
|
1779
|
+
<tr>
|
|
1780
|
+
{columns.map((column) => (
|
|
1781
|
+
<th key={column} scope="col">
|
|
1782
|
+
{label(`${column}.name`)}
|
|
1783
|
+
</th>
|
|
1784
|
+
))}
|
|
1785
|
+
</tr>
|
|
1786
|
+
</thead>
|
|
1787
|
+
<tbody>
|
|
1788
|
+
{rows.map((row) => (
|
|
1789
|
+
<tr key={row}>
|
|
1790
|
+
{columns.map((column, position) =>
|
|
1791
|
+
position === 0 ? (
|
|
1792
|
+
<th key={column} scope="row">
|
|
1793
|
+
{label(`${row}.${column}`)}
|
|
1794
|
+
</th>
|
|
1795
|
+
) : (
|
|
1796
|
+
<td key={column}>{label(`${row}.${column}`)}</td>
|
|
1797
|
+
),
|
|
1798
|
+
)}
|
|
1799
|
+
</tr>
|
|
1800
|
+
))}
|
|
1801
|
+
</tbody>
|
|
1802
|
+
</table>
|
|
1803
|
+
</div>
|
|
1804
|
+
);
|
|
1805
|
+
}
|
|
1806
|
+
WebsiteFactTable.displayName = 'WebsiteFactTable';
|
|
1807
|
+
```
|
|
1808
|
+
|
|
1809
|
+
## FAQ and its structured data
|
|
1810
|
+
|
|
1811
|
+
## Import Origins
|
|
1812
|
+
|
|
1813
|
+
- `@wildo-ai/saas-website`
|
|
1814
|
+
|
|
1815
|
+
## Source Excerpts
|
|
1816
|
+
|
|
1817
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1818
|
+
|
|
1819
|
+
```tsx
|
|
1820
|
+
*
|
|
1821
|
+
* `WebsiteFaq`: questions and answers (FAQ), each a native `<details>`, so it opens without JavaScript and every answer
|
|
1822
|
+
* is in the page for search engines and answer engines alike (#2742). Each question has a `question` and an `answer`
|
|
1823
|
+
* by slot (`<ref>.question`, `<ref>.answer`), under the section's intro (`intro`: which of its words it shows).
|
|
1824
|
+
* `layout` SIDE puts the intro in a narrow column beside the questions, STACKED above them.
|
|
1825
|
+
* `websiteFaqSlots(questions, intro)` lists every slot.
|
|
1826
|
+
*
|
|
1827
|
+
* Each question can be linked to: its entry carries the id `websiteFaqQuestionId(sectionRef, ref)` (`<section>-<ref>`,
|
|
1828
|
+
* unique on the page because section refs are), so a support answer or another page can link `/pricing#pricing-faq-q3`.
|
|
1829
|
+
* The page scrolls to the question, and the block opens it, on load and on every change of the fragment. Without
|
|
1830
|
+
* JavaScript the question is still in view, closed, one click from its answer.
|
|
1831
|
+
*
|
|
1832
|
+
* `websiteFaqStructuredData(questions)`: the section's FAQPage JSON-LD, built from the SAME words the section shows,
|
|
1833
|
+
* in the page's locale, on the server. Pass it as the section's `getStructuredData`. An FAQ is one of the
|
|
1834
|
+
* highest-leverage answer-engine surfaces, and a JSON-LD that says something the page does not is worse than none.
|
|
1835
|
+
* Each Question's `@id` is its link on the page; the FAQPage's is the section's (`#<section>`), so two FAQ sections on
|
|
1836
|
+
* one page publish two FAQPages that do not collide.
|
|
1837
|
+
*/
|
|
1838
|
+
export function websiteFaqQuestionId(sectionRef: string, ref: string): string {
|
|
1839
|
+
return `${sectionRef}-${ref}`;
|
|
1840
|
+
}
|
|
1841
|
+
|
|
1842
|
+
export function websiteFaqSlots(questions: readonly string[], intro: WebsiteSectionIntroOptions = { eyebrow: false }): string[] {
|
|
1843
|
+
return [...websiteSectionIntroSlots(intro), ...questions.flatMap((ref) => [`${ref}.question`, `${ref}.answer`])];
|
|
1844
|
+
}
|
|
1845
|
+
|
|
1846
|
+
export function websiteFaqStructuredData(questions: readonly string[]): (context: WebsiteStructuredDataContext) => WebsiteStructuredDataPayload {
|
|
1847
|
+
return ({ label, pageUrl, locale, sectionRef }) => ({
|
|
1848
|
+
'@type': 'FAQPage',
|
|
1849
|
+
'@id': `${pageUrl}#${sectionRef}`,
|
|
1850
|
+
inLanguage: locale,
|
|
1851
|
+
mainEntity: questions.map((ref) => ({
|
|
1852
|
+
'@type': 'Question',
|
|
1853
|
+
'@id': `${pageUrl}#${websiteFaqQuestionId(sectionRef, ref)}`,
|
|
1854
|
+
name: label(`${ref}.question`),
|
|
1855
|
+
acceptedAnswer: { '@type': 'Answer', text: label(`${ref}.answer`) },
|
|
1856
|
+
})),
|
|
1857
|
+
});
|
|
1858
|
+
}
|
|
1859
|
+
|
|
1860
|
+
export interface WebsiteFaqProps {
|
|
1861
|
+
/** The slot prefix of each question, in order. */
|
|
1862
|
+
readonly questions: readonly string[];
|
|
1863
|
+
readonly intro?: WebsiteSectionIntroOptions;
|
|
1864
|
+
readonly layout?: WebsiteFaqLayout;
|
|
1865
|
+
}
|
|
1866
|
+
|
|
1867
|
+
export function WebsiteFaq({ questions, intro = { eyebrow: false }, layout = WebsiteFaqLayout.SIDE }: WebsiteFaqProps): ReactNode {
|
|
1868
|
+
const label = useWebsiteSectionLabels();
|
|
1869
|
+
const { sectionRef } = useWebsiteSection();
|
|
1870
|
+
const root = useRef<HTMLDivElement | null>(null);
|
|
1871
|
+
// A link to a question opens it: the browser scrolls to the entry, which a closed disclosure leaves showing only its question.
|
|
1872
|
+
useEffect(() => {
|
|
1873
|
+
const openLinkedQuestion = (): void => {
|
|
1874
|
+
const id = decodedFragment(window.location.hash);
|
|
1875
|
+
const entry = id === '' ? null : document.getElementById(id);
|
|
1876
|
+
if (entry instanceof HTMLDetailsElement && root.current?.contains(entry)) entry.open = true;
|
|
1877
|
+
};
|
|
1878
|
+
openLinkedQuestion();
|
|
1879
|
+
window.addEventListener('hashchange', openLinkedQuestion);
|
|
1880
|
+
return () => window.removeEventListener('hashchange', openLinkedQuestion);
|
|
1881
|
+
}, []);
|
|
1882
|
+
return (
|
|
1883
|
+
<div ref={root} data-website-block="faq" data-website-layout={layout}>
|
|
1884
|
+
<WebsiteSectionIntro {...intro} align={layout === WebsiteFaqLayout.SIDE ? WebsiteIntroAlign.START : WebsiteIntroAlign.CENTER} />
|
|
1885
|
+
<div data-website-part="list">
|
|
1886
|
+
{questions.map((ref) => (
|
|
1887
|
+
<details key={ref} id={websiteFaqQuestionId(sectionRef, ref)} data-website-part="entry">
|
|
1888
|
+
<summary>{label(`${ref}.question`)}</summary>
|
|
1889
|
+
<WebsiteText part="answer">{label(`${ref}.answer`)}</WebsiteText>
|
|
1890
|
+
</details>
|
|
1891
|
+
))}
|
|
1892
|
+
</div>
|
|
1893
|
+
</div>
|
|
1894
|
+
);
|
|
1895
|
+
}
|
|
1896
|
+
WebsiteFaq.displayName = 'WebsiteFaq';
|
|
1897
|
+
```
|
|
1898
|
+
|
|
1899
|
+
## Solution paths
|
|
1900
|
+
|
|
1901
|
+
## Import Origins
|
|
1902
|
+
|
|
1903
|
+
- `@wildo-ai/saas-website`
|
|
1904
|
+
|
|
1905
|
+
## Source Excerpts
|
|
1906
|
+
|
|
1907
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1908
|
+
|
|
1909
|
+
```tsx
|
|
1910
|
+
*
|
|
1911
|
+
* `WebsiteSolutionPaths` (SOLUTION_PATHS): one card per audience, each the whole-card link to the page written for it
|
|
1912
|
+
* (#2742). A path has a short label naming the audience, a title, a body and the words of its link by slot
|
|
1913
|
+
* (`<ref>.label`, `<ref>.title`, `<ref>.body`, `<ref>.cta`; `websiteSolutionPathsSlots(paths)`), and its glyph in a
|
|
1914
|
+
* solid tile: a path is a choice the reader makes, so it leads with a strong mark. As many columns as fit.
|
|
1915
|
+
*/
|
|
1916
|
+
export enum WebsiteSolutionPathsMotionPoint {
|
|
1917
|
+
PATHS = 'paths',
|
|
1918
|
+
/** A path responds to the pointer: it is a link. */
|
|
1919
|
+
PATH = 'path',
|
|
1920
|
+
}
|
|
1921
|
+
|
|
1922
|
+
const PATHS_MOTION = defineBlockMotionPoints<WebsiteSolutionPathsMotionPoint>({
|
|
1923
|
+
[WebsiteSolutionPathsMotionPoint.PATHS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
1924
|
+
[WebsiteSolutionPathsMotionPoint.PATH]: { kind: WebsiteMotionPointKind.LINK_CARD, spec: { hover: WebsiteMotionHover.LIFT } },
|
|
1925
|
+
});
|
|
1926
|
+
|
|
1927
|
+
/** One audience: its slot prefix, the page written for it, and its glyph. */
|
|
1928
|
+
export interface WebsiteSolutionPath {
|
|
1929
|
+
readonly ref: string;
|
|
1930
|
+
readonly link: WebsiteLinkTo;
|
|
1931
|
+
readonly icon: ReactNode;
|
|
1932
|
+
}
|
|
1933
|
+
|
|
1934
|
+
export function websiteSolutionPathsSlots(paths: readonly WebsiteSolutionPath[] | readonly string[]): string[] {
|
|
1935
|
+
return paths.map((path) => (typeof path === 'string' ? path : path.ref)).flatMap((ref) => [`${ref}.label`, `${ref}.title`, `${ref}.body`, `${ref}.cta`]);
|
|
1936
|
+
}
|
|
1937
|
+
|
|
1938
|
+
export interface WebsiteSolutionPathsProps {
|
|
1939
|
+
readonly paths: readonly WebsiteSolutionPath[];
|
|
1940
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
1941
|
+
readonly motion?: WebsiteBlockMotion<WebsiteSolutionPathsMotionPoint>;
|
|
1942
|
+
}
|
|
1943
|
+
|
|
1944
|
+
export function WebsiteSolutionPaths({ paths, titleLevel = 3, motion }: WebsiteSolutionPathsProps): ReactNode {
|
|
1945
|
+
const label = useWebsiteSectionLabels();
|
|
1946
|
+
const hover = resolveBlockMotion(WebsiteSolutionPathsMotionPoint.PATH, PATHS_MOTION, motion);
|
|
1947
|
+
return (
|
|
1948
|
+
<ul data-website-block="solution-paths" {...blockMotionAttributes(WebsiteSolutionPathsMotionPoint.PATHS, PATHS_MOTION, motion)}>
|
|
1949
|
+
{paths.map((path) => (
|
|
1950
|
+
<WebsiteCard key={path.ref} link={path.link} {...(hover === null || hover === undefined ? {} : { hover })}>
|
|
1951
|
+
<WebsiteIconTile size={WebsiteIconTileSize.LG} tileStyle={WebsiteIconTileStyle.SOLID}>
|
|
1952
|
+
{path.icon}
|
|
1953
|
+
</WebsiteIconTile>
|
|
1954
|
+
<span data-website-part="label">{label(`${path.ref}.label`)}</span>
|
|
1955
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
1956
|
+
{label(`${path.ref}.title`)}
|
|
1957
|
+
</WebsiteHeading>
|
|
1958
|
+
<span data-website-part="body">{label(`${path.ref}.body`)}</span>
|
|
1959
|
+
<span data-website-part="arrow-link">
|
|
1960
|
+
{label(`${path.ref}.cta`)}
|
|
1961
|
+
<WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
|
|
1962
|
+
</span>
|
|
1963
|
+
</WebsiteCard>
|
|
1964
|
+
))}
|
|
1965
|
+
</ul>
|
|
1966
|
+
);
|
|
1967
|
+
}
|
|
1968
|
+
WebsiteSolutionPaths.displayName = 'WebsiteSolutionPaths';
|
|
1969
|
+
```
|
|
1970
|
+
|
|
1971
|
+
## Quotations
|
|
1972
|
+
|
|
1973
|
+
## Import Origins
|
|
1974
|
+
|
|
1975
|
+
- `@wildo-ai/saas-website`
|
|
1976
|
+
|
|
1977
|
+
## Source Excerpts
|
|
1978
|
+
|
|
1979
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
1980
|
+
|
|
1981
|
+
```tsx
|
|
1982
|
+
*
|
|
1983
|
+
* `WebsiteQuoteCards` (SOCIAL_PROOF, or evidence about the problem): quotations, each with whose words they are and,
|
|
1984
|
+
* when published, a link to where (#2742). A quote has its `text` and its `source` by slot (`<ref>.text`,
|
|
1985
|
+
* `<ref>.source`; `websiteQuoteCardsSlots(quotes)`). `source` given a link makes the attribution that link, so a
|
|
1986
|
+
* reader can check the words. A quotation is a `<blockquote>`; the card carries the accent's rule on its leading edge.
|
|
1987
|
+
*
|
|
1988
|
+
* What the block cannot know is whose words they are: a TESTIMONIAL is a customer about the product, EVIDENCE is
|
|
1989
|
+
* anyone about the problem. Never present evidence as a testimonial (the `website-section-social-proof` skill).
|
|
1990
|
+
*/
|
|
1991
|
+
export enum WebsiteQuoteCardsMotionPoint {
|
|
1992
|
+
QUOTES = 'quotes',
|
|
1993
|
+
}
|
|
1994
|
+
|
|
1995
|
+
const QUOTES_MOTION = defineBlockMotionPoints<WebsiteQuoteCardsMotionPoint>({
|
|
1996
|
+
[WebsiteQuoteCardsMotionPoint.QUOTES]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
1997
|
+
});
|
|
1998
|
+
|
|
1999
|
+
/** One quotation: its slot prefix, and where it was published, if it was. */
|
|
2000
|
+
export interface WebsiteQuote {
|
|
2001
|
+
readonly ref: string;
|
|
2002
|
+
readonly source?: WebsiteLinkTo;
|
|
2003
|
+
}
|
|
2004
|
+
|
|
2005
|
+
export function websiteQuoteCardsSlots(quotes: readonly WebsiteQuote[] | readonly string[]): string[] {
|
|
2006
|
+
return quotes.map((quote) => (typeof quote === 'string' ? quote : quote.ref)).flatMap((ref) => [`${ref}.text`, `${ref}.source`]);
|
|
2007
|
+
}
|
|
2008
|
+
|
|
2009
|
+
export interface WebsiteQuoteCardsProps {
|
|
2010
|
+
readonly quotes: readonly WebsiteQuote[];
|
|
2011
|
+
readonly motion?: WebsiteBlockMotion<WebsiteQuoteCardsMotionPoint>;
|
|
2012
|
+
}
|
|
2013
|
+
|
|
2014
|
+
export function WebsiteQuoteCards({ quotes, motion }: WebsiteQuoteCardsProps): ReactNode {
|
|
2015
|
+
const label = useWebsiteSectionLabels();
|
|
2016
|
+
return (
|
|
2017
|
+
<ul data-website-block="quote-cards" {...blockMotionAttributes(WebsiteQuoteCardsMotionPoint.QUOTES, QUOTES_MOTION, motion)}>
|
|
2018
|
+
{quotes.map((quote) => (
|
|
2019
|
+
<li key={quote.ref} data-website-part="quote">
|
|
2020
|
+
<blockquote data-website-part="text">{label(`${quote.ref}.text`)}</blockquote>
|
|
2021
|
+
{quote.source === undefined ? (
|
|
2022
|
+
<span data-website-part="source">{label(`${quote.ref}.source`)}</span>
|
|
2023
|
+
) : (
|
|
2024
|
+
<WebsiteBlockLink link={quote.source} part="source">
|
|
2025
|
+
{label(`${quote.ref}.source`)}
|
|
2026
|
+
</WebsiteBlockLink>
|
|
2027
|
+
)}
|
|
2028
|
+
</li>
|
|
2029
|
+
))}
|
|
2030
|
+
</ul>
|
|
2031
|
+
);
|
|
2032
|
+
}
|
|
2033
|
+
WebsiteQuoteCards.displayName = 'WebsiteQuoteCards';
|
|
2034
|
+
```
|
|
2035
|
+
|
|
2036
|
+
## Roadmap
|
|
2037
|
+
|
|
2038
|
+
## Import Origins
|
|
2039
|
+
|
|
2040
|
+
- `@wildo-ai/saas-website`
|
|
2041
|
+
|
|
2042
|
+
## Source Excerpts
|
|
2043
|
+
|
|
2044
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
2045
|
+
|
|
2046
|
+
```tsx
|
|
2047
|
+
*
|
|
2048
|
+
* `WebsiteRoadmap` (ROADMAP): the plan in the open, one card per roadmap phase in its order (#2742). A phase has its
|
|
2049
|
+
* horizon's word, a title and a body by slot (`<ref>.stage`, `<ref>.title`, `<ref>.body`) and its items
|
|
2050
|
+
* (`<ref>.<item>.text`; `websiteRoadmapSlots(phases)`). `horizon` is the application's own `RoadmapPhaseHorizon`,
|
|
2051
|
+
* the vocabulary its roadmap specification declares.
|
|
2052
|
+
*
|
|
2053
|
+
* An item is listed with a clock, as a promise, unless it is declared `available`: it works in the application
|
|
2054
|
+
* today, and then it gets a check. The horizon does not decide this, because a NOW phase is one in delivery,
|
|
2055
|
+
* not one delivered. Only a NOW phase may hold an available item: an item that works today in a phase the roadmap places
|
|
2056
|
+
* NEXT or LATER is a roadmap that has not caught up, and the page refuses it rather than show a check under a
|
|
2057
|
+
* later horizon. The check and the clock are drawings, so each item also carries its status in words for a screen
|
|
2058
|
+
* reader, visually hidden: `status.available` or `status.planned`, each declared only when an item needs it. Hooks:
|
|
2059
|
+
* `data-website-horizon` on each phase, `data-website-available` on an available item.
|
|
2060
|
+
*/
|
|
2061
|
+
export enum WebsiteRoadmapMotionPoint {
|
|
2062
|
+
PHASES = 'phases',
|
|
2063
|
+
}
|
|
2064
|
+
|
|
2065
|
+
const ROADMAP_MOTION = defineBlockMotionPoints<WebsiteRoadmapMotionPoint>({
|
|
2066
|
+
[WebsiteRoadmapMotionPoint.PHASES]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
2067
|
+
});
|
|
2068
|
+
|
|
2069
|
+
/** One item of a phase: its slot prefix, and whether it works in the application today. */
|
|
2070
|
+
export interface WebsiteRoadmapItem {
|
|
2071
|
+
readonly ref: string;
|
|
2072
|
+
/** It works in the application today: verified there, not planned. Only a NOW phase may hold one. */
|
|
2073
|
+
readonly available?: boolean;
|
|
2074
|
+
}
|
|
2075
|
+
|
|
2076
|
+
/** One phase: its slot prefix, its horizon, and its items. */
|
|
2077
|
+
export interface WebsiteRoadmapPhase {
|
|
2078
|
+
readonly ref: string;
|
|
2079
|
+
readonly horizon: RoadmapPhaseHorizon;
|
|
2080
|
+
readonly items: readonly WebsiteRoadmapItem[];
|
|
2081
|
+
}
|
|
2082
|
+
|
|
2083
|
+
export function websiteRoadmapSlots(phases: readonly WebsiteRoadmapPhase[]): string[] {
|
|
2084
|
+
const items = phases.flatMap((phase) => phase.items);
|
|
2085
|
+
return [
|
|
2086
|
+
...(items.some((item) => item.available === true) ? ['status.available'] : []),
|
|
2087
|
+
...(items.some((item) => item.available !== true) ? ['status.planned'] : []),
|
|
2088
|
+
...phases.flatMap((phase) => [`${phase.ref}.stage`, `${phase.ref}.title`, `${phase.ref}.body`, ...phase.items.map((item) => `${phase.ref}.${item.ref}.text`)]),
|
|
2089
|
+
];
|
|
2090
|
+
}
|
|
2091
|
+
|
|
2092
|
+
function assertAvailableOnlyNow(phase: WebsiteRoadmapPhase): void {
|
|
2093
|
+
const early = phase.items.find((item) => item.available === true);
|
|
2094
|
+
if (early !== undefined && phase.horizon !== RoadmapPhaseHorizon.NOW) {
|
|
2095
|
+
throw new Error(
|
|
2096
|
+
`[website roadmap] Item "${phase.ref}.${early.ref}" is declared available, but its phase is ${phase.horizon.toUpperCase()}. `
|
|
2097
|
+
+ 'Something that works today belongs to a NOW phase: move the item, or update the roadmap specification first.',
|
|
2098
|
+
);
|
|
2099
|
+
}
|
|
2100
|
+
}
|
|
2101
|
+
|
|
2102
|
+
export interface WebsiteRoadmapProps {
|
|
2103
|
+
readonly phases: readonly WebsiteRoadmapPhase[];
|
|
2104
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
2105
|
+
readonly motion?: WebsiteBlockMotion<WebsiteRoadmapMotionPoint>;
|
|
2106
|
+
}
|
|
2107
|
+
|
|
2108
|
+
function RoadmapPhaseCard({ phase, titleLevel }: { phase: WebsiteRoadmapPhase; titleLevel: WebsiteHeadingLevel }): ReactNode {
|
|
2109
|
+
const label = useWebsiteSectionLabels();
|
|
2110
|
+
assertAvailableOnlyNow(phase);
|
|
2111
|
+
return (
|
|
2112
|
+
<li data-website-card="" data-website-horizon={phase.horizon}>
|
|
2113
|
+
<span data-website-part="stage">{label(`${phase.ref}.stage`)}</span>
|
|
2114
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
2115
|
+
{label(`${phase.ref}.title`)}
|
|
2116
|
+
</WebsiteHeading>
|
|
2117
|
+
<span data-website-part="body">{label(`${phase.ref}.body`)}</span>
|
|
2118
|
+
<ul data-website-part="items">
|
|
2119
|
+
{phase.items.map((item) => (
|
|
2120
|
+
<li key={item.ref} {...(item.available === true ? { 'data-website-available': '' } : {})}>
|
|
2121
|
+
<WebsiteInterfaceGlyph name={item.available === true ? WebsiteInterfaceGlyphName.CHECK : WebsiteInterfaceGlyphName.CLOCK} part="marker" />
|
|
2122
|
+
<span>
|
|
2123
|
+
<span data-website-visually-hidden="">{label(item.available === true ? 'status.available' : 'status.planned')} </span>
|
|
2124
|
+
{label(`${phase.ref}.${item.ref}.text`)}
|
|
2125
|
+
</span>
|
|
2126
|
+
</li>
|
|
2127
|
+
))}
|
|
2128
|
+
</ul>
|
|
2129
|
+
</li>
|
|
2130
|
+
);
|
|
2131
|
+
}
|
|
2132
|
+
|
|
2133
|
+
export function WebsiteRoadmap({ phases, titleLevel = 3, motion }: WebsiteRoadmapProps): ReactNode {
|
|
2134
|
+
return (
|
|
2135
|
+
<ol data-website-block="roadmap" {...blockMotionAttributes(WebsiteRoadmapMotionPoint.PHASES, ROADMAP_MOTION, motion)}>
|
|
2136
|
+
{phases.map((phase) => (
|
|
2137
|
+
<RoadmapPhaseCard key={phase.ref} phase={phase} titleLevel={titleLevel} />
|
|
2138
|
+
))}
|
|
2139
|
+
</ol>
|
|
2140
|
+
);
|
|
2141
|
+
}
|
|
2142
|
+
WebsiteRoadmap.displayName = 'WebsiteRoadmap';
|
|
2143
|
+
```
|
|
2144
|
+
|
|
2145
|
+
## Import Origins
|
|
2146
|
+
|
|
2147
|
+
- `@wildo-ai/saas-models`
|
|
2148
|
+
|
|
2149
|
+
## Source Excerpts
|
|
2150
|
+
|
|
2151
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
2152
|
+
|
|
2153
|
+
```typescript
|
|
2154
|
+
*
|
|
2155
|
+
* Coarse delivery-horizon bucket a roadmap phase sits in — the classic NOW / NEXT / LATER lens. Fixed vocabulary
|
|
2156
|
+
* (enum, per project rule — enums over literal unions). Orthogonal to a phase's `sequence` (which gives the precise
|
|
2157
|
+
* order) and to its `kind` (which classifies the phase's lifecycle stage): `horizon` answers "how soon", coarsely, for
|
|
2158
|
+
* at-a-glance roadmap grouping. Optional on a phase.
|
|
2159
|
+
*
|
|
2160
|
+
* It lives here, import-free, rather than beside the roadmap specification schema (`RoadmapPhaseConfig` in
|
|
2161
|
+
* `@wildo-ai/saas-specifications`) because two audiences read it: the specification that declares a phase, and the
|
|
2162
|
+
* website that shows it (`WebsiteRoadmap`, which ships to the browser and reaches it through
|
|
2163
|
+
* `@wildo-ai/saas-models/public-runtime`). One vocabulary, so the site cannot call "now" what the roadmap calls "next".
|
|
2164
|
+
*/
|
|
2165
|
+
export enum RoadmapPhaseHorizon {
|
|
2166
|
+
/** In active delivery now / imminently. */
|
|
2167
|
+
NOW = 'now',
|
|
2168
|
+
/** Queued directly after the current horizon. */
|
|
2169
|
+
NEXT = 'next',
|
|
2170
|
+
/** Further-out intent — directionally committed, not yet scheduled. */
|
|
2171
|
+
LATER = 'later',
|
|
2172
|
+
}
|
|
2173
|
+
```
|
|
2174
|
+
|
|
2175
|
+
## Pricing
|
|
2176
|
+
|
|
2177
|
+
## Import Origins
|
|
2178
|
+
|
|
2179
|
+
- `@wildo-ai/saas-website`
|
|
2180
|
+
|
|
2181
|
+
## Source Excerpts
|
|
2182
|
+
|
|
2183
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
2184
|
+
|
|
2185
|
+
```tsx
|
|
2186
|
+
*
|
|
2187
|
+
* `WebsitePricing` (PRICING): the plans the application sells, from its billing catalogue (#2742). A price is never a
|
|
2188
|
+
* word: amounts, currency, recurrence, basis, trial length, the recommended plan and the price disclosure all come from
|
|
2189
|
+
* the catalogue the route delivers (`useWebsitePricingCatalog`), so the page, its JSON-LD and checkout cannot disagree.
|
|
2190
|
+
*
|
|
2191
|
+
* - `layout` TEASER: each plan's name, price and summary, and a link to the pricing page (`pricingPage`). PLANS: the
|
|
2192
|
+
* full cards, with a monthly / yearly switch when the catalogue prices plans at both cadences, each plan's feature
|
|
2193
|
+
* lines, its trial, and its call to action (`signUp`, the application's sign-up by default; a plan's own `link`
|
|
2194
|
+
* instead, e.g. a contact page for a plan priced on request). Each plan card carries the id `plan-<key>`, the
|
|
2195
|
+
* fragment the pricing page's offer JSON-LD (`buildWebsitePricingOfferStructuredData`) gives each offer's URL.
|
|
2196
|
+
* - The WORDS are per plan, keyed by the catalogue's plan key: `plans` says which plans the site has words for, and
|
|
2197
|
+
* which feature lines each shows. A plan the catalogue lists without words stops the page (rather than render raw
|
|
2198
|
+
* keys); a feature line names the GRANT it describes (a feature or limit id of the plan's product), and a line naming
|
|
2199
|
+
* something the plan does not grant stops the page too — a pricing page must not promise what checkout does not sell.
|
|
2200
|
+
* - A PRICE IS A SENTENCE the catalogue decides, and every part of it is a declared word:
|
|
2201
|
+
* - its recurrence: `periods` lists the ones the section has words for (`websitePricingPeriodSlot`: `period.month`,
|
|
2202
|
+
* `period.year`, `period.once` for a one-time price, `period.month.3` for every three months). Defaults: a
|
|
2203
|
+
* month for TEASER, a month and a year for PLANS (which also declares the switch's words);
|
|
2204
|
+
* - its state, through `statements` (`WebsitePricingStatement`): a floor (STARTING_AT, `price.from` before the
|
|
2205
|
+
* amount), a price per unit (PER_UNIT, `price.per-unit` after the period, e.g. "per member"), a price whose total
|
|
2206
|
+
* depends on quantity (VARIABLE, `price.variable` IN PLACE of the amount: the catalogue forbids presenting that
|
|
2207
|
+
* amount as the price), a plan priced on request (ON_REQUEST, `price.on-request` in place of the amount and the
|
|
2208
|
+
* period), a free trial (TRIAL, `trial.before` N `trial.after`), a plan announced and not yet on sale (UPCOMING,
|
|
2209
|
+
* `upcoming` where the call to action would be: sign-up refuses it, so the card must not offer it).
|
|
2210
|
+
* A plan whose price needs a word the section did not declare stops the page, naming the statement or period to
|
|
2211
|
+
* declare. So a catalogue change (a per-seat price, a yearly-only plan) can never render as a wrong sentence.
|
|
2212
|
+
*
|
|
2213
|
+
* Slots: `websitePricingSlots(options)`. Hooks: `data-website-block="pricing"`, `data-website-layout`, the parts
|
|
2214
|
+
* `plans` (`data-website-columns`: the plan count), `plan` (`data-website-recommended` on the recommended one,
|
|
2215
|
+
* `data-website-availability`), `badge`, `name`, `price`, `from`, `amount`, `period`, `per-unit`, `variable`,
|
|
2216
|
+
* `on-request`, `summary`, `trial`, `features`, `marker`, `upcoming`, `cadence`, `note`, `link`.
|
|
2217
|
+
*/
|
|
2218
|
+
export enum WebsitePricingLayout {
|
|
2219
|
+
/** A summary of the plans for a page that is not the pricing page: name, price, one line, and a link. */
|
|
2220
|
+
TEASER = 'teaser',
|
|
2221
|
+
/** The pricing page's plan cards. */
|
|
2222
|
+
PLANS = 'plans',
|
|
2223
|
+
}
|
|
2224
|
+
|
|
2225
|
+
/** A state of a plan or of its price that the section has words for. */
|
|
2226
|
+
export enum WebsitePricingStatement {
|
|
2227
|
+
/** The price is a floor: `price.from` before the amount. */
|
|
2228
|
+
STARTING_AT = 'starting-at',
|
|
2229
|
+
/** The price is per unit (a seat, a member): `price.per-unit` after the period. */
|
|
2230
|
+
PER_UNIT = 'per-unit',
|
|
2231
|
+
/** The total depends on quantity: `price.variable` in place of the amount, which the catalogue forbids as the price. */
|
|
2232
|
+
VARIABLE = 'variable',
|
|
2233
|
+
/** The plan is priced on request: `price.on-request` in place of the amount and the period. */
|
|
2234
|
+
ON_REQUEST = 'on-request',
|
|
2235
|
+
/** The plan offers a free trial: `trial.before` N `trial.after`. */
|
|
2236
|
+
TRIAL = 'trial',
|
|
2237
|
+
/** The plan is announced, not yet on sale: `upcoming` in place of the call to action. */
|
|
2238
|
+
UPCOMING = 'upcoming',
|
|
2239
|
+
}
|
|
2240
|
+
|
|
2241
|
+
const STATEMENT_SLOTS: Readonly<Record<WebsitePricingStatement, readonly string[]>> = {
|
|
2242
|
+
[WebsitePricingStatement.STARTING_AT]: ['price.from'],
|
|
2243
|
+
[WebsitePricingStatement.PER_UNIT]: ['price.per-unit'],
|
|
2244
|
+
[WebsitePricingStatement.VARIABLE]: ['price.variable'],
|
|
2245
|
+
[WebsitePricingStatement.ON_REQUEST]: ['price.on-request'],
|
|
2246
|
+
[WebsitePricingStatement.TRIAL]: ['trial.before', 'trial.after'],
|
|
2247
|
+
[WebsitePricingStatement.UPCOMING]: ['upcoming'],
|
|
2248
|
+
};
|
|
2249
|
+
|
|
2250
|
+
/** A recurrence the section has a word for. */
|
|
2251
|
+
export interface WebsitePricingPeriod {
|
|
2252
|
+
readonly unit: PublicPricingRecurrenceUnit;
|
|
2253
|
+
readonly count: number;
|
|
2254
|
+
}
|
|
2255
|
+
|
|
2256
|
+
/** The slot of a recurrence's word: `period.once`, `period.month`, `period.year`, or `period.<unit>.<count>`. */
|
|
2257
|
+
export function websitePricingPeriodSlot({ unit, count }: WebsitePricingPeriod): string {
|
|
2258
|
+
if (unit === PublicPricingRecurrenceUnit.ONE_TIME) return 'period.once';
|
|
2259
|
+
return count === 1 ? `period.${unit}` : `period.${unit}.${count}`;
|
|
2260
|
+
}
|
|
2261
|
+
|
|
2262
|
+
const MONTHLY: WebsitePricingPeriod = { unit: PublicPricingRecurrenceUnit.MONTH, count: 1 };
|
|
2263
|
+
const YEARLY: WebsitePricingPeriod = { unit: PublicPricingRecurrenceUnit.YEAR, count: 1 };
|
|
2264
|
+
|
|
2265
|
+
export enum WebsitePricingMotionPoint {
|
|
2266
|
+
PLANS = 'plans',
|
|
2267
|
+
}
|
|
2268
|
+
|
|
2269
|
+
const PRICING_MOTION = defineBlockMotionPoints<WebsitePricingMotionPoint>({
|
|
2270
|
+
[WebsitePricingMotionPoint.PLANS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
2271
|
+
});
|
|
2272
|
+
|
|
2273
|
+
/** One line of a plan card: its slot (`plans.<key>.<ref>`) and the feature or limit id of the plan it describes. */
|
|
2274
|
+
export interface WebsitePricingFeatureLine {
|
|
2275
|
+
readonly ref: string;
|
|
2276
|
+
readonly grant: string;
|
|
2277
|
+
}
|
|
2278
|
+
|
|
2279
|
+
/** The words a site has for one catalogue plan, and where its call to action goes when not to sign-up. */
|
|
2280
|
+
export interface WebsitePricingPlanWords {
|
|
2281
|
+
readonly key: string;
|
|
2282
|
+
readonly features?: readonly WebsitePricingFeatureLine[];
|
|
2283
|
+
/** This plan's call to action, instead of the block's `signUp`: an ON_REQUEST plan's contact page, say. */
|
|
2284
|
+
readonly link?: WebsiteLinkTo;
|
|
2285
|
+
}
|
|
2286
|
+
|
|
2287
|
+
export interface WebsitePricingSlotOptions {
|
|
2288
|
+
readonly layout: WebsitePricingLayout;
|
|
2289
|
+
readonly plans: readonly WebsitePricingPlanWords[];
|
|
2290
|
+
/** TEASER: the link to the pricing page has words (`link`). */
|
|
2291
|
+
readonly pricingPage?: unknown;
|
|
2292
|
+
/** PLANS: a note under the plans (`note`): what an add-on costs, what the plans exclude. */
|
|
2293
|
+
readonly note?: boolean;
|
|
2294
|
+
/** The recurrences the section has words for. Defaults: a month (TEASER); a month and a year (PLANS). */
|
|
2295
|
+
readonly periods?: readonly WebsitePricingPeriod[];
|
|
2296
|
+
/** The price and plan states the section has words for. */
|
|
2297
|
+
readonly statements?: readonly WebsitePricingStatement[];
|
|
2298
|
+
}
|
|
2299
|
+
|
|
2300
|
+
function periodsOf(options: Pick<WebsitePricingSlotOptions, 'layout' | 'periods'>): readonly WebsitePricingPeriod[] {
|
|
2301
|
+
return options.periods ?? (options.layout === WebsitePricingLayout.TEASER ? [MONTHLY] : [MONTHLY, YEARLY]);
|
|
2302
|
+
}
|
|
2303
|
+
|
|
2304
|
+
const isPeriod = (period: WebsitePricingPeriod, other: WebsitePricingPeriod) => period.unit === other.unit && period.count === other.count;
|
|
2305
|
+
|
|
2306
|
+
/** PLANS with words for both a month and a year: the section can offer the cadence switch. */
|
|
2307
|
+
function declaresCadenceSwitch(options: Pick<WebsitePricingSlotOptions, 'layout' | 'periods'>): boolean {
|
|
2308
|
+
const periods = periodsOf(options);
|
|
2309
|
+
return options.layout === WebsitePricingLayout.PLANS && periods.some((period) => isPeriod(period, MONTHLY)) && periods.some((period) => isPeriod(period, YEARLY));
|
|
2310
|
+
}
|
|
2311
|
+
|
|
2312
|
+
export function websitePricingSlots(options: WebsitePricingSlotOptions): string[] {
|
|
2313
|
+
const teaser = options.layout === WebsitePricingLayout.TEASER;
|
|
2314
|
+
return [
|
|
2315
|
+
'recommended',
|
|
2316
|
+
...periodsOf(options).map(websitePricingPeriodSlot),
|
|
2317
|
+
...(options.statements ?? []).flatMap((statement) => STATEMENT_SLOTS[statement]),
|
|
2318
|
+
...(declaresCadenceSwitch(options) ? ['billing.label', 'billing.monthly', 'billing.yearly'] : []),
|
|
2319
|
+
...(teaser ? (options.pricingPage !== undefined ? ['link'] : []) : options.note === true ? ['note'] : []),
|
|
2320
|
+
...options.plans.flatMap((plan) => [
|
|
2321
|
+
`plans.${plan.key}.name`,
|
|
2322
|
+
`plans.${plan.key}.summary`,
|
|
2323
|
+
...(teaser ? [] : [`plans.${plan.key}.cta`, ...(plan.features ?? []).map((line) => `plans.${plan.key}.${line.ref}`)]),
|
|
2324
|
+
]),
|
|
2325
|
+
];
|
|
2326
|
+
}
|
|
2327
|
+
|
|
2328
|
+
export interface WebsitePricingProps extends WebsitePricingSlotOptions {
|
|
2329
|
+
/** Where every plan's call to action goes (PLANS). */
|
|
2330
|
+
readonly signUp?: WebsiteLinkTo;
|
|
2331
|
+
/** The pricing page (TEASER). */
|
|
2332
|
+
readonly pricingPage?: WebsiteLinkTo;
|
|
2333
|
+
readonly motion?: WebsiteBlockMotion<WebsitePricingMotionPoint>;
|
|
2334
|
+
}
|
|
2335
|
+
|
|
2336
|
+
const DEFAULT_SIGN_UP: WebsiteLinkTo = { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP };
|
|
2337
|
+
|
|
2338
|
+
/** The plan's price at a cadence, or its default when it has none at that cadence (a free plan is monthly only). */
|
|
2339
|
+
function priceAt(plan: PublicPricingPlan, cadence: WebsitePricingPeriod): PublicPricingPrice | undefined {
|
|
2340
|
+
return plan.prices.find((price) => isPeriod(price.recurrence, cadence)) ?? plan.prices.find((price) => price.isDefault) ?? plan.prices[0];
|
|
2341
|
+
}
|
|
2342
|
+
|
|
2343
|
+
/** The words a plan's card and price need in a layout, each with the declaration that provides it. */
|
|
2344
|
+
function wordsOfPrice(plan: PublicPricingPlan, price: PublicPricingPrice | undefined, layout: WebsitePricingLayout): ReadonlyArray<readonly [string, string]> {
|
|
2345
|
+
const statement = (value: WebsitePricingStatement) => STATEMENT_SLOTS[value].map((slot) => [slot, `the statement WebsitePricingStatement.${value.toUpperCase().replace(/-/g, '_')}`] as const);
|
|
2346
|
+
const words: Array<readonly [string, string]> = [];
|
|
2347
|
+
if (plan.availability === ProductAvailability.UPCOMING) words.push(...statement(WebsitePricingStatement.UPCOMING));
|
|
2348
|
+
// Only the plan cards state a trial; the teaser is name, price and one line.
|
|
2349
|
+
if (plan.trialDays !== undefined && layout === WebsitePricingLayout.PLANS) words.push(...statement(WebsitePricingStatement.TRIAL));
|
|
2350
|
+
if (plan.priceDisclosure === ProductPriceDisclosure.ON_REQUEST) return [...words, ...statement(WebsitePricingStatement.ON_REQUEST)];
|
|
2351
|
+
if (price === undefined) return words;
|
|
2352
|
+
if (plan.priceDisclosure === ProductPriceDisclosure.STARTING_AT) words.push(...statement(WebsitePricingStatement.STARTING_AT));
|
|
2353
|
+
if (price.amountBasis === PublicPricingAmountBasis.VARIABLE) return [...words, ...statement(WebsitePricingStatement.VARIABLE)];
|
|
2354
|
+
const slot = websitePricingPeriodSlot(price.recurrence);
|
|
2355
|
+
words.push([slot, `the period { unit: ${price.recurrence.unit}, count: ${price.recurrence.count} } in \`periods\``]);
|
|
2356
|
+
if (price.amountBasis === PublicPricingAmountBasis.PER_UNIT) words.push(...statement(WebsitePricingStatement.PER_UNIT));
|
|
2357
|
+
return words;
|
|
2358
|
+
}
|
|
2359
|
+
|
|
2360
|
+
interface ShownPlan {
|
|
2361
|
+
readonly plan: PublicPricingPlan;
|
|
2362
|
+
readonly words: WebsitePricingPlanWords;
|
|
2363
|
+
}
|
|
2364
|
+
|
|
2365
|
+
/**
|
|
2366
|
+
* The plans the site shows, in catalogue order (every plan the catalogue lists publicly), each checked to have its
|
|
2367
|
+
* words, honest feature lines, and a word for every part of every price it can show at the cadences the block offers.
|
|
2368
|
+
*/
|
|
2369
|
+
function useShownPlans(options: WebsitePricingSlotOptions, cadences: readonly WebsitePricingPeriod[]): readonly ShownPlan[] {
|
|
2370
|
+
const { plans } = useWebsitePricingCatalog();
|
|
2371
|
+
const declared = new Set(websitePricingSlots(options));
|
|
2372
|
+
return plans.map((plan) => {
|
|
2373
|
+
const planWords = options.plans.find((entry) => entry.key === plan.key);
|
|
2374
|
+
if (planWords === undefined) {
|
|
2375
|
+
throw new Error(
|
|
2376
|
+
`[website pricing] The billing catalogue lists plan "${plan.key}", which the section has no words for. `
|
|
2377
|
+
+ 'Add it to the pricing block\'s `plans` and its words to every label pack.',
|
|
2378
|
+
);
|
|
2379
|
+
}
|
|
2380
|
+
for (const cadence of cadences) {
|
|
2381
|
+
for (const [slot, declaration] of wordsOfPrice(plan, priceAt(plan, cadence), options.layout)) {
|
|
2382
|
+
if (!declared.has(slot)) {
|
|
2383
|
+
throw new Error(
|
|
2384
|
+
`[website pricing] Plan "${plan.key}" needs the word "${slot}", which the section did not declare. Declare ${declaration} `
|
|
2385
|
+
+ 'on the pricing block and its slot helper, and the word in every label pack.',
|
|
2386
|
+
);
|
|
2387
|
+
}
|
|
2388
|
+
}
|
|
2389
|
+
}
|
|
2390
|
+
const grants = new Set([...plan.grantedFeatures, ...plan.grantedLimits]);
|
|
2391
|
+
for (const line of planWords.features ?? []) {
|
|
2392
|
+
if (!grants.has(line.grant)) {
|
|
2393
|
+
throw new Error(
|
|
2394
|
+
`[website pricing] The line "plans.${plan.key}.${line.ref}" describes "${line.grant}", which plan "${plan.key}" `
|
|
2395
|
+
+ `does not grant (it grants: ${[...grants].join(', ') || 'nothing'}). A pricing page must not promise what checkout does not sell.`,
|
|
2396
|
+
);
|
|
2397
|
+
}
|
|
2398
|
+
}
|
|
2399
|
+
return { plan, words: planWords };
|
|
2400
|
+
});
|
|
2401
|
+
}
|
|
2402
|
+
|
|
2403
|
+
/** A catalogue amount in the page's locale and the price's own currency, from the exact decimal, never a float sum. */
|
|
2404
|
+
function useAmount(price: PublicPricingPrice | undefined): string {
|
|
2405
|
+
const { locale } = useWebsiteRuntime();
|
|
2406
|
+
if (price === undefined) return '';
|
|
2407
|
+
const decimal = publicPricingAmountDecimal(price);
|
|
2408
|
+
return new Intl.NumberFormat(locale, {
|
|
2409
|
+
style: 'currency',
|
|
2410
|
+
currency: price.currency,
|
|
2411
|
+
maximumFractionDigits: decimal.includes('.') && !decimal.endsWith('.00') ? price.decimals : 0,
|
|
2412
|
+
}).format(Number(decimal));
|
|
2413
|
+
}
|
|
2414
|
+
|
|
2415
|
+
/** The price as the catalogue states it: a floor, an amount, its recurrence and its unit, or the word in its place. */
|
|
2416
|
+
function PriceStatement({ plan, price, Period }: { plan: PublicPricingPlan; price: PublicPricingPrice | undefined; Period: 'span' | 'small' }): ReactNode {
|
|
2417
|
+
const amount = useAmount(price);
|
|
2418
|
+
const label = useWebsiteSectionLabels();
|
|
2419
|
+
if (plan.priceDisclosure === ProductPriceDisclosure.ON_REQUEST) return <span data-website-part="on-request">{label('price.on-request')}</span>;
|
|
2420
|
+
if (price === undefined) return null;
|
|
2421
|
+
const from = plan.priceDisclosure === ProductPriceDisclosure.STARTING_AT && <span data-website-part="from">{label('price.from')}</span>;
|
|
2422
|
+
if (price.amountBasis === PublicPricingAmountBasis.VARIABLE) {
|
|
2423
|
+
return (
|
|
2424
|
+
<>
|
|
2425
|
+
{from}
|
|
2426
|
+
<span data-website-part="variable">{label('price.variable')}</span>
|
|
2427
|
+
</>
|
|
2428
|
+
);
|
|
2429
|
+
}
|
|
2430
|
+
return (
|
|
2431
|
+
<>
|
|
2432
|
+
{from}
|
|
2433
|
+
<span data-website-part="amount">{amount}</span>
|
|
2434
|
+
<Period data-website-part="period">{label(websitePricingPeriodSlot(price.recurrence))}</Period>
|
|
2435
|
+
{price.amountBasis === PublicPricingAmountBasis.PER_UNIT && <span data-website-part="per-unit">{label('price.per-unit')}</span>}
|
|
2436
|
+
</>
|
|
2437
|
+
);
|
|
2438
|
+
}
|
|
2439
|
+
|
|
2440
|
+
function TeaserPlan({ plan }: { plan: PublicPricingPlan }): ReactNode {
|
|
2441
|
+
const label = useWebsiteSectionLabels();
|
|
2442
|
+
return (
|
|
2443
|
+
<li data-website-part="plan" data-website-availability={plan.availability} {...(plan.isRecommended ? { 'data-website-recommended': '' } : {})}>
|
|
2444
|
+
{plan.isRecommended && <span data-website-part="badge">{label('recommended')}</span>}
|
|
2445
|
+
<strong data-website-part="name">{label(`plans.${plan.key}.name`)}</strong>
|
|
2446
|
+
<span data-website-part="price">
|
|
2447
|
+
<PriceStatement plan={plan} price={priceAt(plan, MONTHLY)} Period="small" />
|
|
2448
|
+
</span>
|
|
2449
|
+
<span data-website-part="summary">{label(`plans.${plan.key}.summary`)}</span>
|
|
2450
|
+
{plan.availability === ProductAvailability.UPCOMING && <span data-website-part="upcoming">{label('upcoming')}</span>}
|
|
2451
|
+
</li>
|
|
2452
|
+
);
|
|
2453
|
+
}
|
|
2454
|
+
|
|
2455
|
+
function PlanCard({ plan, words, cadence, signUp }: { plan: PublicPricingPlan; words: WebsitePricingPlanWords; cadence: WebsitePricingPeriod; signUp: WebsiteLinkTo }): ReactNode {
|
|
2456
|
+
const label = useWebsiteSectionLabels();
|
|
2457
|
+
const target = useWebsiteLinkTarget()(words.link ?? signUp);
|
|
2458
|
+
return (
|
|
2459
|
+
<li
|
|
2460
|
+
id={`plan-${plan.key}`}
|
|
2461
|
+
data-website-part="plan"
|
|
2462
|
+
data-website-availability={plan.availability}
|
|
2463
|
+
{...(plan.isRecommended ? { 'data-website-recommended': '' } : {})}
|
|
2464
|
+
>
|
|
2465
|
+
{plan.isRecommended && <span data-website-part="badge">{label('recommended')}</span>}
|
|
2466
|
+
<strong data-website-part="name">{label(`plans.${plan.key}.name`)}</strong>
|
|
2467
|
+
<p data-website-part="price">
|
|
2468
|
+
<PriceStatement plan={plan} price={priceAt(plan, cadence)} Period="span" />
|
|
2469
|
+
</p>
|
|
2470
|
+
<span data-website-part="summary">
|
|
2471
|
+
{label(`plans.${plan.key}.summary`)}
|
|
2472
|
+
{plan.trialDays !== undefined && (
|
|
2473
|
+
<span data-website-part="trial">
|
|
2474
|
+
{label('trial.before')} {plan.trialDays}
|
|
2475
|
+
{label('trial.after')}
|
|
2476
|
+
</span>
|
|
2477
|
+
)}
|
|
2478
|
+
</span>
|
|
2479
|
+
<ul data-website-part="features">
|
|
2480
|
+
{(words.features ?? []).map((line) => (
|
|
2481
|
+
<li key={line.ref}>
|
|
2482
|
+
<WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.CHECK} part="marker" />
|
|
2483
|
+
{label(`plans.${plan.key}.${line.ref}`)}
|
|
2484
|
+
</li>
|
|
2485
|
+
))}
|
|
2486
|
+
</ul>
|
|
2487
|
+
{plan.availability === ProductAvailability.UPCOMING ? (
|
|
2488
|
+
// Sign-up refuses a plan not yet on sale, so the card announces it instead of offering a door that would refuse.
|
|
2489
|
+
<span data-website-part="upcoming">{label('upcoming')}</span>
|
|
2490
|
+
) : (
|
|
2491
|
+
<div data-website-actions="">
|
|
2492
|
+
<WebsiteButton href={target.href} external={target.external} variant={plan.isRecommended ? WebsiteButtonVariant.PRIMARY : WebsiteButtonVariant.SECONDARY}>
|
|
2493
|
+
{label(`plans.${plan.key}.cta`)}
|
|
2494
|
+
</WebsiteButton>
|
|
2495
|
+
</div>
|
|
2496
|
+
)}
|
|
2497
|
+
</li>
|
|
2498
|
+
);
|
|
2499
|
+
}
|
|
2500
|
+
|
|
2501
|
+
/** The monthly / yearly switch: a radio group, so it is one tab stop and the arrow keys move between cadences. */
|
|
2502
|
+
function CadenceSwitch({ cadence, onChange }: { cadence: WebsitePricingPeriod; onChange: (cadence: WebsitePricingPeriod) => void }): ReactNode {
|
|
2503
|
+
const label = useWebsiteSectionLabels();
|
|
2504
|
+
const name = useId();
|
|
2505
|
+
const cadences = [
|
|
2506
|
+
[MONTHLY, label('billing.monthly')],
|
|
2507
|
+
[YEARLY, label('billing.yearly')],
|
|
2508
|
+
] as const;
|
|
2509
|
+
return (
|
|
2510
|
+
<fieldset data-website-part="cadence">
|
|
2511
|
+
<legend data-website-visually-hidden="">{label('billing.label')}</legend>
|
|
2512
|
+
{cadences.map(([option, text]) => (
|
|
2513
|
+
<label key={option.unit}>
|
|
2514
|
+
<input type="radio" name={name} value={option.unit} checked={isPeriod(option, cadence)} onChange={() => onChange(option)} />
|
|
2515
|
+
{text}
|
|
2516
|
+
</label>
|
|
2517
|
+
))}
|
|
2518
|
+
</fieldset>
|
|
2519
|
+
);
|
|
2520
|
+
}
|
|
2521
|
+
|
|
2522
|
+
/** Does any plan the catalogue lists have a price at this cadence? */
|
|
2523
|
+
function catalogPricesAt(plans: readonly PublicPricingPlan[], cadence: WebsitePricingPeriod): boolean {
|
|
2524
|
+
return plans.some((plan) => plan.prices.some((price) => isPeriod(price.recurrence, cadence)));
|
|
2525
|
+
}
|
|
2526
|
+
|
|
2527
|
+
export function WebsitePricing(props: WebsitePricingProps): ReactNode {
|
|
2528
|
+
const { layout, pricingPage, note = false, signUp = DEFAULT_SIGN_UP, motion } = props;
|
|
2529
|
+
const label = useWebsiteSectionLabels();
|
|
2530
|
+
const [cadence, setCadence] = useState(MONTHLY);
|
|
2531
|
+
const { plans } = useWebsitePricingCatalog();
|
|
2532
|
+
// The switch is offered when the catalogue prices plans at both cadences; the section must then have its words.
|
|
2533
|
+
const offersSwitch = layout === WebsitePricingLayout.PLANS && catalogPricesAt(plans, MONTHLY) && catalogPricesAt(plans, YEARLY);
|
|
2534
|
+
if (offersSwitch && !declaresCadenceSwitch(props)) {
|
|
2535
|
+
throw new Error(
|
|
2536
|
+
'[website pricing] The billing catalogue prices plans monthly and yearly, so the plans offer a switch between them, and the '
|
|
2537
|
+
+ 'section has no words for it. Declare both periods (a month and a year) in `periods` on the block and its slot helper.',
|
|
2538
|
+
);
|
|
2539
|
+
}
|
|
2540
|
+
const shown = useShownPlans(props, layout === WebsitePricingLayout.TEASER ? [MONTHLY] : offersSwitch ? [MONTHLY, YEARLY] : [MONTHLY]);
|
|
2541
|
+
const list = (
|
|
2542
|
+
<ul data-website-part="plans" data-website-columns={String(shown.length)} {...blockMotionAttributes(WebsitePricingMotionPoint.PLANS, PRICING_MOTION, motion)}>
|
|
2543
|
+
{shown.map(({ plan, words }) =>
|
|
2544
|
+
layout === WebsitePricingLayout.TEASER ? <TeaserPlan key={plan.key} plan={plan} /> : <PlanCard key={plan.key} plan={plan} words={words} cadence={cadence} signUp={signUp} />,
|
|
2545
|
+
)}
|
|
2546
|
+
</ul>
|
|
2547
|
+
);
|
|
2548
|
+
if (layout === WebsitePricingLayout.TEASER) {
|
|
2549
|
+
return (
|
|
2550
|
+
<div data-website-block="pricing" data-website-layout={layout}>
|
|
2551
|
+
{list}
|
|
2552
|
+
{pricingPage !== undefined && (
|
|
2553
|
+
<p data-website-part="link">
|
|
2554
|
+
<WebsiteArrowLink link={pricingPage}>{label('link')}</WebsiteArrowLink>
|
|
2555
|
+
</p>
|
|
2556
|
+
)}
|
|
2557
|
+
</div>
|
|
2558
|
+
);
|
|
2559
|
+
}
|
|
2560
|
+
return (
|
|
2561
|
+
<div data-website-block="pricing" data-website-layout={layout}>
|
|
2562
|
+
{offersSwitch && <CadenceSwitch cadence={cadence} onChange={setCadence} />}
|
|
2563
|
+
{list}
|
|
2564
|
+
{note && <p data-website-part="note">{label('note')}</p>}
|
|
2565
|
+
</div>
|
|
2566
|
+
);
|
|
2567
|
+
}
|
|
2568
|
+
WebsitePricing.displayName = 'WebsitePricing';
|
|
2569
|
+
```
|
|
2570
|
+
|
|
2571
|
+
## Latest posts
|
|
2572
|
+
|
|
2573
|
+
## Import Origins
|
|
2574
|
+
|
|
2575
|
+
- `@wildo-ai/saas-website`
|
|
2576
|
+
|
|
2577
|
+
## Source Excerpts
|
|
2578
|
+
|
|
2579
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
2580
|
+
|
|
2581
|
+
```tsx
|
|
2582
|
+
*
|
|
2583
|
+
* `WebsiteLatestPosts` (LATEST_POSTS): the blog's newest posts as cards (#2742). Each card is read from the post's own
|
|
2584
|
+
* frontmatter through `useWebsiteBlogIndex()` (its cover, date, title, summary and tags), never copied into the label
|
|
2585
|
+
* pack, and links to the post. The date is `formatWebsitePublicationDate`, the formatter a post's byline uses, and each
|
|
2586
|
+
* tag is shown by its word (`website.chrome.blog-tag.<tag>`), never by its ref. A post with no cover gets a drawn
|
|
2587
|
+
* placeholder in the brand's colours. The section owns only its framing words and two link labels: `read` on each
|
|
2588
|
+
* card, `all` on the link to the blog (`allPosts`, omitted on the blog index itself). `websiteLatestPostsSlots(...)`.
|
|
2589
|
+
*/
|
|
2590
|
+
export enum WebsiteLatestPostsMotionPoint {
|
|
2591
|
+
POSTS = 'posts',
|
|
2592
|
+
/** A post card responds to the pointer: it is a link. */
|
|
2593
|
+
POST = 'post',
|
|
2594
|
+
}
|
|
2595
|
+
|
|
2596
|
+
const POSTS_MOTION = defineBlockMotionPoints<WebsiteLatestPostsMotionPoint>({
|
|
2597
|
+
[WebsiteLatestPostsMotionPoint.POSTS]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.RISE } },
|
|
2598
|
+
[WebsiteLatestPostsMotionPoint.POST]: { kind: WebsiteMotionPointKind.LINK_CARD, spec: { hover: WebsiteMotionHover.LIFT } },
|
|
2599
|
+
});
|
|
2600
|
+
|
|
2601
|
+
export function websiteLatestPostsSlots(options: { readonly allPosts?: unknown } = {}): string[] {
|
|
2602
|
+
return ['read', ...(options.allPosts !== undefined ? ['all'] : [])];
|
|
2603
|
+
}
|
|
2604
|
+
|
|
2605
|
+
export interface WebsiteLatestPostsProps {
|
|
2606
|
+
/** The blog's index page, linked under the cards; omit on the blog index itself. */
|
|
2607
|
+
readonly allPosts?: WebsiteLinkTo;
|
|
2608
|
+
/** How many posts at most, newest first; every post when omitted. */
|
|
2609
|
+
readonly limit?: number;
|
|
2610
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
2611
|
+
readonly motion?: WebsiteBlockMotion<WebsiteLatestPostsMotionPoint>;
|
|
2612
|
+
}
|
|
2613
|
+
|
|
2614
|
+
/** A tag by its word, never its ref. */
|
|
2615
|
+
export function WebsiteBlogTag({ tag }: { tag: string }): ReactNode {
|
|
2616
|
+
return <li data-website-part="tag">{useWebsiteLabelByKey(websiteBlogTagLabelKey(tag))}</li>;
|
|
2617
|
+
}
|
|
2618
|
+
WebsiteBlogTag.displayName = 'WebsiteBlogTag';
|
|
2619
|
+
|
|
2620
|
+
function PostCard({ entry, titleLevel, hover }: { entry: WebsiteBlogIndexEntry; titleLevel: WebsiteHeadingLevel; hover: WebsiteMotionSpec | null | undefined }): ReactNode {
|
|
2621
|
+
const { locale } = useWebsiteRuntime();
|
|
2622
|
+
const label = useWebsiteSectionLabels();
|
|
2623
|
+
return (
|
|
2624
|
+
<WebsiteCard link={{ kind: WebsiteMenuLinkKind.PAGE, routePath: entry.routePath }} {...(hover === null || hover === undefined ? {} : { hover })}>
|
|
2625
|
+
{entry.cover === undefined ? (
|
|
2626
|
+
<span data-website-part="cover" aria-hidden="true" />
|
|
2627
|
+
) : (
|
|
2628
|
+
// The cover's own size, measured when the site was built; the card frames it at the link-preview ratio.
|
|
2629
|
+
<WebsiteImage part="cover" src={entry.cover.src} alt="" width={entry.cover.width} height={entry.cover.height} />
|
|
2630
|
+
)}
|
|
2631
|
+
<time data-website-part="meta" dateTime={entry.publishedAt}>
|
|
2632
|
+
{formatWebsitePublicationDate(entry.publishedAt, locale)}
|
|
2633
|
+
</time>
|
|
2634
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
2635
|
+
{entry.title}
|
|
2636
|
+
</WebsiteHeading>
|
|
2637
|
+
<span data-website-part="summary">{entry.summary}</span>
|
|
2638
|
+
{entry.tags.length > 0 && (
|
|
2639
|
+
<ul data-website-part="tags">
|
|
2640
|
+
{entry.tags.map((tag) => (
|
|
2641
|
+
<WebsiteBlogTag key={tag} tag={tag} />
|
|
2642
|
+
))}
|
|
2643
|
+
</ul>
|
|
2644
|
+
)}
|
|
2645
|
+
<span data-website-part="arrow-link">
|
|
2646
|
+
{label('read')}
|
|
2647
|
+
<WebsiteInterfaceGlyph name={WebsiteInterfaceGlyphName.ARROW_RIGHT} part="arrow" />
|
|
2648
|
+
</span>
|
|
2649
|
+
</WebsiteCard>
|
|
2650
|
+
);
|
|
2651
|
+
}
|
|
2652
|
+
|
|
2653
|
+
export function WebsiteLatestPosts({ allPosts, limit, titleLevel = 3, motion }: WebsiteLatestPostsProps): ReactNode {
|
|
2654
|
+
const { entries } = useWebsiteBlogIndex();
|
|
2655
|
+
const label = useWebsiteSectionLabels();
|
|
2656
|
+
const hover = resolveBlockMotion(WebsiteLatestPostsMotionPoint.POST, POSTS_MOTION, motion);
|
|
2657
|
+
const shown = limit === undefined ? entries : entries.slice(0, limit);
|
|
2658
|
+
return (
|
|
2659
|
+
<div data-website-block="latest-posts">
|
|
2660
|
+
<ul data-website-part="posts" {...blockMotionAttributes(WebsiteLatestPostsMotionPoint.POSTS, POSTS_MOTION, motion)}>
|
|
2661
|
+
{shown.map((entry) => (
|
|
2662
|
+
<PostCard key={entry.slug} entry={entry} titleLevel={titleLevel} hover={hover} />
|
|
2663
|
+
))}
|
|
2664
|
+
</ul>
|
|
2665
|
+
{allPosts !== undefined && (
|
|
2666
|
+
<p data-website-part="link">
|
|
2667
|
+
<WebsiteArrowLink link={allPosts}>{label('all')}</WebsiteArrowLink>
|
|
2668
|
+
</p>
|
|
2669
|
+
)}
|
|
2670
|
+
</div>
|
|
2671
|
+
);
|
|
2672
|
+
}
|
|
2673
|
+
WebsiteLatestPosts.displayName = 'WebsiteLatestPosts';
|
|
2674
|
+
```
|
|
2675
|
+
|
|
2676
|
+
## Product tour
|
|
2677
|
+
|
|
2678
|
+
## Import Origins
|
|
2679
|
+
|
|
2680
|
+
- `@wildo-ai/saas-website`
|
|
2681
|
+
|
|
2682
|
+
## Source Excerpts
|
|
2683
|
+
|
|
2684
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
2685
|
+
|
|
2686
|
+
```tsx
|
|
2687
|
+
*
|
|
2688
|
+
* `WebsiteProductTour`: the product in tabs (PRODUCT_SHOWCASE), one drawn screen per tab beside its title and one
|
|
2689
|
+
* paragraph (#2742). Each tab has its label, a title and a body by slot (`<ref>.tab`, `<ref>.title`, `<ref>.body`) and
|
|
2690
|
+
* its `screen`, drawn by the site with its own words (declare its slots beside the tour's); the tab list is named by
|
|
2691
|
+
* `tabs-label`. `websiteProductTourSlots(tabs)`.
|
|
2692
|
+
*
|
|
2693
|
+
* It follows the WAI-ARIA tabs pattern: a `tablist` of real buttons, the arrow keys, Home and End move between them,
|
|
2694
|
+
* one `tabpanel` labelled by its tab. The drawn screen is hidden from assistive technology, which reads the panel's
|
|
2695
|
+
* title and body instead.
|
|
2696
|
+
*
|
|
2697
|
+
* It ROTATES on its own, one tab every `WEBSITE_PRODUCT_TOUR_DWELL_MS` (7 s, with a countdown line under the tab), and
|
|
2698
|
+
* stops as an auto-rotating carousel must: for good once keyboard focus enters the tabs or the visitor picks a tab,
|
|
2699
|
+
* and for as long as the pointer is over it. The tour sits in a `WebsiteMotionDemoGroup`, so its pause control (slots
|
|
2700
|
+
* `pause`, `play`), the off-screen pause, reduced motion and a STILL site hold the rotation and every screen.
|
|
2701
|
+
*
|
|
2702
|
+
* spec-cite: WAI-ARIA APG, Carousel pattern, "About This Pattern" — https://www.w3.org/WAI/ARIA/apg/patterns/carousel/
|
|
2703
|
+
* (fetched 2026-10-06): rotation "Stops rotating when keyboard focus enters the carousel. It does not restart unless
|
|
2704
|
+
* the user explicitly requests it to do so." and "Stops rotating whenever the mouse is hovering over the carousel."
|
|
2705
|
+
*
|
|
2706
|
+
* Hooks: `data-website-block="product-tour"`, the parts `tabs`, `tab`, `progress` (`data-website-running` while it
|
|
2707
|
+
* counts down), `panel`, `copy`, `title`, `body`, `screen-frame`, `screen`.
|
|
2708
|
+
*/
|
|
2709
|
+
export interface WebsiteProductTourTab {
|
|
2710
|
+
readonly ref: string;
|
|
2711
|
+
/** The tab's drawn screen. */
|
|
2712
|
+
readonly screen: ReactNode;
|
|
2713
|
+
}
|
|
2714
|
+
|
|
2715
|
+
export function websiteProductTourSlots(tabs: readonly WebsiteProductTourTab[] | readonly string[]): string[] {
|
|
2716
|
+
return [
|
|
2717
|
+
'tabs-label',
|
|
2718
|
+
'pause',
|
|
2719
|
+
'play',
|
|
2720
|
+
...tabs.map((tab) => (typeof tab === 'string' ? tab : tab.ref)).flatMap((ref) => [`${ref}.tab`, `${ref}.title`, `${ref}.body`]),
|
|
2721
|
+
];
|
|
2722
|
+
}
|
|
2723
|
+
|
|
2724
|
+
export interface WebsiteProductTourProps {
|
|
2725
|
+
readonly tabs: readonly WebsiteProductTourTab[];
|
|
2726
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
2727
|
+
}
|
|
2728
|
+
|
|
2729
|
+
/**
|
|
2730
|
+
* Advances the tour while the group plays. Rendered INSIDE the group so it reads the playback flag the pause control,
|
|
2731
|
+
* the off-screen pause and reduced motion feed; renders nothing.
|
|
2732
|
+
*/
|
|
2733
|
+
function TourClock({ active, rotating, dwell, onAdvance }: { active: number; rotating: boolean; dwell: number; onAdvance: () => void }): null {
|
|
2734
|
+
const playing = useWebsiteMotionDemoPlaying();
|
|
2735
|
+
useEffect(() => {
|
|
2736
|
+
if (!playing || !rotating) return undefined;
|
|
2737
|
+
const timer = setTimeout(onAdvance, dwell);
|
|
2738
|
+
return () => clearTimeout(timer);
|
|
2739
|
+
}, [playing, rotating, active, dwell, onAdvance]);
|
|
2740
|
+
return null;
|
|
2741
|
+
}
|
|
2742
|
+
|
|
2743
|
+
/** The line under the active tab, counting down to the next one. It runs only while the tour rotates and plays. */
|
|
2744
|
+
function TourProgress({ rotating }: { rotating: boolean }): ReactNode {
|
|
2745
|
+
const playing = useWebsiteMotionDemoPlaying();
|
|
2746
|
+
return <span data-website-part="progress" aria-hidden="true" {...(rotating && playing ? { 'data-website-running': '' } : {})} />;
|
|
2747
|
+
}
|
|
2748
|
+
|
|
2749
|
+
export function WebsiteProductTour({ tabs, titleLevel = 3 }: WebsiteProductTourProps): ReactNode {
|
|
2750
|
+
const label = useWebsiteSectionLabels();
|
|
2751
|
+
const [active, setActive] = useState(0);
|
|
2752
|
+
const [rotating, setRotating] = useState(true);
|
|
2753
|
+
const [hovered, setHovered] = useState(false);
|
|
2754
|
+
const tabRefs = useRef<Array<HTMLButtonElement | null>>([]);
|
|
2755
|
+
const baseId = useId();
|
|
2756
|
+
const advance = useCallback(() => setActive((current) => (current + 1) % tabs.length), [tabs.length]);
|
|
2757
|
+
const choose = (index: number): void => {
|
|
2758
|
+
setRotating(false);
|
|
2759
|
+
setActive(index);
|
|
2760
|
+
};
|
|
2761
|
+
const onKeyDown = (event: KeyboardEvent<HTMLDivElement>): void => {
|
|
2762
|
+
const delta = event.key === 'ArrowRight' ? 1 : event.key === 'ArrowLeft' ? -1 : 0;
|
|
2763
|
+
if (delta === 0 && event.key !== 'Home' && event.key !== 'End') return;
|
|
2764
|
+
event.preventDefault();
|
|
2765
|
+
const next = event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : (active + delta + tabs.length) % tabs.length;
|
|
2766
|
+
choose(next);
|
|
2767
|
+
tabRefs.current[next]?.focus();
|
|
2768
|
+
};
|
|
2769
|
+
const current = tabs[active] ?? tabs[0];
|
|
2770
|
+
if (current === undefined) return null;
|
|
2771
|
+
// One tab has nothing to rotate to: no clock, no countdown, no entrance replayed every dwell.
|
|
2772
|
+
const turning = rotating && !hovered && tabs.length > 1;
|
|
2773
|
+
const hover = { onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false) };
|
|
2774
|
+
return (
|
|
2775
|
+
<div data-website-block="product-tour">
|
|
2776
|
+
<WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
|
|
2777
|
+
<TourClock active={active} rotating={turning} dwell={WEBSITE_PRODUCT_TOUR_DWELL_MS} onAdvance={advance} />
|
|
2778
|
+
<div role="tablist" aria-label={label('tabs-label')} data-website-part="tabs" onKeyDown={onKeyDown} onFocus={() => setRotating(false)} {...hover}>
|
|
2779
|
+
{tabs.map((tab, index) => (
|
|
2780
|
+
<button
|
|
2781
|
+
key={tab.ref}
|
|
2782
|
+
ref={(element) => {
|
|
2783
|
+
tabRefs.current[index] = element;
|
|
2784
|
+
}}
|
|
2785
|
+
type="button"
|
|
2786
|
+
role="tab"
|
|
2787
|
+
id={`${baseId}-tab-${index}`}
|
|
2788
|
+
aria-selected={index === active}
|
|
2789
|
+
aria-controls={`${baseId}-panel`}
|
|
2790
|
+
tabIndex={index === active ? 0 : -1}
|
|
2791
|
+
data-website-part="tab"
|
|
2792
|
+
onClick={() => choose(index)}
|
|
2793
|
+
>
|
|
2794
|
+
{label(`${tab.ref}.tab`)}
|
|
2795
|
+
{index === active && <TourProgress rotating={turning} />}
|
|
2796
|
+
</button>
|
|
2797
|
+
))}
|
|
2798
|
+
</div>
|
|
2799
|
+
{/*
|
|
2800
|
+
The panel stays mounted, so a screen reader reading it keeps its place; its content is re-keyed so the
|
|
2801
|
+
entrance plays for each tab. It announces a new tab only once the visitor has stopped the rotation (APG
|
|
2802
|
+
carousel: live region off while rotating), and it is focusable because it holds nothing focusable (APG tabs).
|
|
2803
|
+
*/}
|
|
2804
|
+
<div
|
|
2805
|
+
role="tabpanel"
|
|
2806
|
+
id={`${baseId}-panel`}
|
|
2807
|
+
aria-labelledby={`${baseId}-tab-${active}`}
|
|
2808
|
+
aria-live={turning ? 'off' : 'polite'}
|
|
2809
|
+
tabIndex={0}
|
|
2810
|
+
data-website-part="panel"
|
|
2811
|
+
onFocus={() => setRotating(false)}
|
|
2812
|
+
{...hover}
|
|
2813
|
+
>
|
|
2814
|
+
<div key={`${current.ref}-copy`} data-website-part="copy">
|
|
2815
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
2816
|
+
{label(`${current.ref}.title`)}
|
|
2817
|
+
</WebsiteHeading>
|
|
2818
|
+
<p data-website-part="body">{label(`${current.ref}.body`)}</p>
|
|
2819
|
+
</div>
|
|
2820
|
+
{/* The entrance plays on this plain frame, never on the stage: the pause control holds every animation in a
|
|
2821
|
+
stage, so a stage re-keyed while paused would hold its entrance at the first frame, invisible. */}
|
|
2822
|
+
<div key={`${current.ref}-screen`} data-website-part="screen-frame">
|
|
2823
|
+
<WebsiteMotionDemoStage>
|
|
2824
|
+
<div data-website-part="screen">{current.screen}</div>
|
|
2825
|
+
</WebsiteMotionDemoStage>
|
|
2826
|
+
</div>
|
|
2827
|
+
</div>
|
|
2828
|
+
</WebsiteMotionDemoGroup>
|
|
2829
|
+
</div>
|
|
2830
|
+
);
|
|
2831
|
+
}
|
|
2832
|
+
WebsiteProductTour.displayName = 'WebsiteProductTour';
|
|
2833
|
+
```
|
|
2834
|
+
|
|
2835
|
+
## Bento
|
|
2836
|
+
|
|
2837
|
+
## Import Origins
|
|
2838
|
+
|
|
2839
|
+
- `@wildo-ai/saas-website`
|
|
2840
|
+
|
|
2841
|
+
## Source Excerpts
|
|
2842
|
+
|
|
2843
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
2844
|
+
|
|
2845
|
+
```tsx
|
|
2846
|
+
*
|
|
2847
|
+
* `WebsiteBento`: capabilities as a bento grid (FEATURE_BENEFIT_SUMMARY), each tile a small drawing of the capability
|
|
2848
|
+
* above its title and one line (#2742). A tile has a title and a body by slot (`<ref>.title`, `<ref>.body`;
|
|
2849
|
+
* `websiteBentoSlots(tiles)`), and its `visual`: a drawing, usually a short loop, that the site draws with its own
|
|
2850
|
+
* words (declare its slots beside the bento's). A tile is a third of the row (REGULAR) or half of it (WIDE): two WIDE
|
|
2851
|
+
* tiles make a row, three REGULAR ones another. Every visual sits in one `WebsiteMotionDemoGroup`, so the bento has
|
|
2852
|
+
* ONE pause control (slots `pause`, `play`), stops off screen and stays still under reduced motion or a STILL site;
|
|
2853
|
+
* a visual is hidden from assistive technology, because the tile's words say what it shows.
|
|
2854
|
+
*
|
|
2855
|
+
* A tile is a `WebsiteCard` with media, so a site that has styled its media cards has styled its bento. Hooks:
|
|
2856
|
+
* `data-website-block="bento"`, the part `tiles`, `data-website-size` on each tile.
|
|
2857
|
+
*/
|
|
2858
|
+
export enum WebsiteBentoMotionPoint {
|
|
2859
|
+
/** The tiles arrive one after another, growing in. */
|
|
2860
|
+
TILES = 'tiles',
|
|
2861
|
+
}
|
|
2862
|
+
|
|
2863
|
+
const BENTO_MOTION = defineBlockMotionPoints<WebsiteBentoMotionPoint>({
|
|
2864
|
+
[WebsiteBentoMotionPoint.TILES]: { kind: WebsiteMotionPointKind.GROUP, spec: { stagger: WebsiteMotionReveal.SCALE } },
|
|
2865
|
+
});
|
|
2866
|
+
|
|
2867
|
+
/** One tile: its slot prefix, its drawing, and how much of the row it takes. */
|
|
2868
|
+
export interface WebsiteBentoTile {
|
|
2869
|
+
readonly ref: string;
|
|
2870
|
+
readonly visual: ReactNode;
|
|
2871
|
+
readonly size?: WebsiteBentoTileSize;
|
|
2872
|
+
}
|
|
2873
|
+
|
|
2874
|
+
export function websiteBentoSlots(tiles: readonly WebsiteBentoTile[] | readonly string[]): string[] {
|
|
2875
|
+
return ['pause', 'play', ...tiles.map((tile) => (typeof tile === 'string' ? tile : tile.ref)).flatMap((ref) => [`${ref}.title`, `${ref}.body`])];
|
|
2876
|
+
}
|
|
2877
|
+
|
|
2878
|
+
export interface WebsiteBentoProps {
|
|
2879
|
+
readonly tiles: readonly WebsiteBentoTile[];
|
|
2880
|
+
readonly titleLevel?: WebsiteHeadingLevel;
|
|
2881
|
+
readonly motion?: WebsiteBlockMotion<WebsiteBentoMotionPoint>;
|
|
2882
|
+
}
|
|
2883
|
+
|
|
2884
|
+
export function WebsiteBento({ tiles, titleLevel = 3, motion }: WebsiteBentoProps): ReactNode {
|
|
2885
|
+
const label = useWebsiteSectionLabels();
|
|
2886
|
+
return (
|
|
2887
|
+
<div data-website-block="bento">
|
|
2888
|
+
<WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
|
|
2889
|
+
<ul data-website-part="tiles" {...blockMotionAttributes(WebsiteBentoMotionPoint.TILES, BENTO_MOTION, motion)}>
|
|
2890
|
+
{tiles.map((tile) => (
|
|
2891
|
+
<WebsiteCard key={tile.ref} size={tile.size ?? WebsiteBentoTileSize.REGULAR} media={<WebsiteMotionDemoStage>{tile.visual}</WebsiteMotionDemoStage>}>
|
|
2892
|
+
<WebsiteHeading level={titleLevel} variant={WebsiteHeadingVariant.TITLE} part="title">
|
|
2893
|
+
{label(`${tile.ref}.title`)}
|
|
2894
|
+
</WebsiteHeading>
|
|
2895
|
+
<span data-website-part="body">{label(`${tile.ref}.body`)}</span>
|
|
2896
|
+
</WebsiteCard>
|
|
2897
|
+
))}
|
|
2898
|
+
</ul>
|
|
2899
|
+
</WebsiteMotionDemoGroup>
|
|
2900
|
+
</div>
|
|
2901
|
+
);
|
|
2902
|
+
}
|
|
2903
|
+
WebsiteBento.displayName = 'WebsiteBento';
|
|
2904
|
+
```
|
|
2905
|
+
|
|
2906
|
+
## Marquee
|
|
2907
|
+
|
|
2908
|
+
## Import Origins
|
|
2909
|
+
|
|
2910
|
+
- `@wildo-ai/saas-website`
|
|
2911
|
+
|
|
2912
|
+
## Source Excerpts
|
|
2913
|
+
|
|
2914
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
2915
|
+
|
|
2916
|
+
```tsx
|
|
2917
|
+
*
|
|
2918
|
+
* `WebsiteMarquee`: a list that scrolls past, slowly and for ever: the integrations, the tools a product works with
|
|
2919
|
+
* (INTEGRATIONS, SOCIAL_PROOF strips) (#2742). Each item has its word by slot (`<ref>.text`) and may carry an `icon`;
|
|
2920
|
+
* an optional line above says what the list is (`label`). `websiteMarqueeSlots(items, { label })`.
|
|
2921
|
+
*
|
|
2922
|
+
* What a reader and a screen reader get is the PLAIN list: a visually hidden `<ul>` of the words, in order. The moving
|
|
2923
|
+
* copy is drawn twice for a seamless loop inside a `WebsiteMotionDemoStage`, hidden from assistive technology, under
|
|
2924
|
+
* one pause control (slots `pause`, `play`) that the visitor, the off-screen pause, reduced motion and a STILL site all
|
|
2925
|
+
* govern: still, the strip shows its first items, unmoving.
|
|
2926
|
+
*
|
|
2927
|
+
* One copy of the list scrolls past in `WEBSITE_MARQUEE_LOOP_SECONDS` (38 s), so a long list moves faster: past a
|
|
2928
|
+
* dozen items, the strip reads better as two. Hooks: `data-website-block="marquee"`, the parts `label`, `track`, `item`, `icon`.
|
|
2929
|
+
*/
|
|
2930
|
+
export interface WebsiteMarqueeItem {
|
|
2931
|
+
readonly ref: string;
|
|
2932
|
+
readonly icon?: ReactNode;
|
|
2933
|
+
}
|
|
2934
|
+
|
|
2935
|
+
export interface WebsiteMarqueeSlotOptions {
|
|
2936
|
+
/** A line above the strip saying what the list is (`label`). Default true. */
|
|
2937
|
+
readonly label?: boolean;
|
|
2938
|
+
}
|
|
2939
|
+
|
|
2940
|
+
export function websiteMarqueeSlots(items: readonly WebsiteMarqueeItem[] | readonly string[], { label = true }: WebsiteMarqueeSlotOptions = {}): string[] {
|
|
2941
|
+
return [...(label ? ['label'] : []), 'pause', 'play', ...items.map((item) => `${typeof item === 'string' ? item : item.ref}.text`)];
|
|
2942
|
+
}
|
|
2943
|
+
|
|
2944
|
+
export interface WebsiteMarqueeProps extends WebsiteMarqueeSlotOptions {
|
|
2945
|
+
readonly items: readonly WebsiteMarqueeItem[];
|
|
2946
|
+
}
|
|
2947
|
+
|
|
2948
|
+
function MarqueeItem({ item }: { item: WebsiteMarqueeItem }): ReactNode {
|
|
2949
|
+
const label = useWebsiteSectionLabels();
|
|
2950
|
+
return (
|
|
2951
|
+
<span data-website-part="item">
|
|
2952
|
+
{item.icon !== undefined && <span data-website-part="icon">{item.icon}</span>}
|
|
2953
|
+
{label(`${item.ref}.text`)}
|
|
2954
|
+
</span>
|
|
2955
|
+
);
|
|
2956
|
+
}
|
|
2957
|
+
|
|
2958
|
+
export function WebsiteMarquee({ items, label: showLabel = true }: WebsiteMarqueeProps): ReactNode {
|
|
2959
|
+
const label = useWebsiteSectionLabels();
|
|
2960
|
+
return (
|
|
2961
|
+
<div data-website-block="marquee">
|
|
2962
|
+
<WebsiteMotionDemoGroup pauseLabel={label('pause')} playLabel={label('play')}>
|
|
2963
|
+
{showLabel && <p data-website-part="label">{label('label')}</p>}
|
|
2964
|
+
<ul data-website-visually-hidden="">
|
|
2965
|
+
{items.map((item) => (
|
|
2966
|
+
<li key={item.ref}>{label(`${item.ref}.text`)}</li>
|
|
2967
|
+
))}
|
|
2968
|
+
</ul>
|
|
2969
|
+
<WebsiteMotionDemoStage>
|
|
2970
|
+
<div data-website-part="track">
|
|
2971
|
+
{[...items, ...items].map((item, index) => (
|
|
2972
|
+
<MarqueeItem key={`${item.ref}-${index < items.length ? 'a' : 'b'}`} item={item} />
|
|
2973
|
+
))}
|
|
2974
|
+
</div>
|
|
2975
|
+
</WebsiteMotionDemoStage>
|
|
2976
|
+
</WebsiteMotionDemoGroup>
|
|
2977
|
+
</div>
|
|
2978
|
+
);
|
|
2979
|
+
}
|
|
2980
|
+
WebsiteMarquee.displayName = 'WebsiteMarquee';
|
|
2981
|
+
```
|
|
2982
|
+
|
|
2983
|
+
## The stylesheet and its hooks
|
|
2984
|
+
|
|
2985
|
+
## Import Origins
|
|
2986
|
+
|
|
2987
|
+
- `@wildo-ai/saas-website`
|
|
2988
|
+
|
|
2989
|
+
## Source Excerpts
|
|
2990
|
+
|
|
2991
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
2992
|
+
|
|
2993
|
+
```typescript
|
|
2994
|
+
*
|
|
2995
|
+
* The engine's building blocks, styled from the theme (#2742).
|
|
2996
|
+
*
|
|
2997
|
+
* Every rule reads the site's tokens: the CURRENT tone for colour (`--website-tone-*`, which `data-website-tone`
|
|
2998
|
+
* re-binds on a band), the type roles, the space and rhythm scales, the radius roles, the elevation. So a site's look
|
|
2999
|
+
* is its `designTokens`, and a block is right on every band with no rule per band.
|
|
3000
|
+
*
|
|
3001
|
+
* It sits in the `wildo-website` cascade layer: a site's own stylesheet is unlayered and wins whatever its
|
|
3002
|
+
* specificity, so a site adjusts a block by writing an ordinary rule against its `data-website-*` hooks, never with
|
|
3003
|
+
* `!important` and never by forking the component. The page layout renders it once per page, before the content.
|
|
3004
|
+
*
|
|
3005
|
+
* The hooks a site's rule targets:
|
|
3006
|
+
*
|
|
3007
|
+
* | Hook | On | Values |
|
|
3008
|
+
* |---|---|---|
|
|
3009
|
+
* | `data-website-block` | a block's root | `band`, `intro`, `hero`, `feature-row`, `card-grid`, `cta`, `steps`, `stats`, `table`, `faq`, `solution-paths`, `quote-cards`, `roadmap`, `pricing`, `latest-posts`, `product-tour`, `bento`, `marquee` |
|
|
3010
|
+
* | `data-website-part` | a part inside a block | shared by every block: `inner`, `copy`, `visual`, `backdrop`, `decoration`, `headline`, `lede`, `note`, `heading`, `body`, `title`, `link`, `arrow-link`, `arrow`, `marker`; each block names its own (a plan's `amount`, a stat's `value`) in its own documentation |
|
|
3011
|
+
* | `data-website-tone` | a band | `default`, `tinted`, `inverse`, `brand` |
|
|
3012
|
+
* | `data-website-layout` | a hero, a feature row, steps, an FAQ, a table, pricing | `stage`, `split`, `compact`; `visual-end`, `visual-start`; `row`, `stack`; `side`, `stacked`; `comparison`, `facts`; `teaser`, `plans` |
|
|
3013
|
+
* | `data-website-band-spacing`, `data-website-band-role` | a band | `default`, `compact`, `strip`; `cta` |
|
|
3014
|
+
* | `data-website-hero-surface` | a hero | `plain`, `glow`, `glow-grid` |
|
|
3015
|
+
* | `data-website-align`, `data-website-columns` | an intro; a card grid, stats, the plans | `start`, `center`; `2`, `3`, `4`, `auto` |
|
|
3016
|
+
* | `data-website-horizon`, `data-website-available` | a roadmap phase; an item that works today | `now`, `next`, `later` |
|
|
3017
|
+
* | `data-website-recommended`, `data-website-availability` | a plan | the catalogue's `available`, `upcoming` |
|
|
3018
|
+
* | `data-website-size` | a card in a bento | `regular`, `wide` |
|
|
3019
|
+
* | `data-website-running` | a product tour's countdown line | present while the tour rotates and plays |
|
|
3020
|
+
* | `--website-card-padding` | a card (`data-website-card`) | a length: the card's padding, which a linked card's link and a media card's copy take too; set it on a block or a card to pad its cards differently |
|
|
3021
|
+
* | `data-website-blog-post-slug`, `data-website-blog-post-cover`, `-summary`, `-meta`, `-author`, `-tags` | a blog post's `<article>` and its opening | the post's slug; present |
|
|
3022
|
+
* | `data-website-visually-hidden` | any element | present: read by assistive technology, not drawn (a table's caption, a roadmap item's status) |
|
|
3023
|
+
* | `data-website-shell`, `data-website-eyebrow`, `data-website-actions`, `data-website-card`, `data-website-point-list`, `data-website-point`, `data-website-icon-tile`, `data-website-icon-tile-style`, `data-website-count-up` | the shared parts | the eyebrow: `plain`, `pill`; the card: `media` for a card led by a drawing; the icon tile: `sm`, `md`, `lg`, and `wash` or `solid` |
|
|
3024
|
+
*
|
|
3025
|
+
* A site's media queries use the two widths below, so its own layouts stack where the blocks do.
|
|
3026
|
+
*
|
|
3027
|
+
* The base rules a page gets before any block: box sizing, the page's background, text colour, font and leading, links
|
|
3028
|
+
* drawn without an underline (a block's links are links by their shape; running text inside `data-website-prose`
|
|
3029
|
+
* keeps its underline), the selection and the focus ring in the tone's primary.
|
|
3030
|
+
*
|
|
3031
|
+
* What is NOT a token, and why: the button size ramp (`sm` / `md` / `lg` heights and paddings) and the icon glyph boxes
|
|
3032
|
+
* (1rem in a 1.75rem tile, a 2.5rem tile) are control geometry, fixed so a hit target and a glyph stay legible whatever
|
|
3033
|
+
* the density; the eyebrow pill's padding and dot are optical, set against the overline's size; the primary button's
|
|
3034
|
+
* top highlight and hover darkening are drawn relative to the action colour; the hero's glow and grid sizes are
|
|
3035
|
+
* decoration. The content blocks add: the step number's disc (2rem), the roadmap and plan markers (1rem, 1.05rem) and
|
|
3036
|
+
* the plan badge's lift above its card, control geometry like the glyph boxes; the heights of drawings (a step's
|
|
3037
|
+
* visual, 10rem; a post's drawn cover, 9rem) and the cover's link-preview ratio, decoration; the comparison table's
|
|
3038
|
+
* width before it scrolls sideways (44rem) and the stacked plans' width (30rem), layout limits chosen so a cell or a
|
|
3039
|
+
* card stays readable; the focus ring's 2px, the same on every control so it is always seen. The animated blocks
|
|
3040
|
+
* add: a bento drawing's 13rem floor (a row of tiles lines up whatever each drawing measures), the marquee's fade at
|
|
3041
|
+
* 10% of each end (an item arrives and leaves rather than being cut), the tour's 0.7 / 1.3 split of copy and screen
|
|
3042
|
+
* (the screen is the point), and the countdown line at two edge widths. Where a block varies a
|
|
3043
|
+
* token rather than replacing it (a plan's padding at 7/6 of the card padding, a tag's at 13/15 of `md`), the value
|
|
3044
|
+
* follows the theme's density. Everything a site's personality is meant to change (corners, gaps, colours, type) is
|
|
3045
|
+
* a token.
|
|
3046
|
+
*/
|
|
3047
|
+
/** The widths a stacked layout starts at: below `stack` a split stacks, below `single` a grid has one column. */
|
|
3048
|
+
export const WEBSITE_BLOCKS_STACK_MAX_WIDTH = '1024px';
|
|
3049
|
+
export const WEBSITE_BLOCKS_SINGLE_COLUMN_MAX_WIDTH = '760px';
|
|
3050
|
+
```
|