@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-theme-authoring/references/framework-website-theme-api.md
ADDED
|
@@ -0,0 +1,893 @@
|
|
|
1
|
+
# Website theme — API (source-backed)
|
|
2
|
+
|
|
3
|
+
The token bundle, the personality point it is composed from, the composer, the tones and the readers. Read it when
|
|
4
|
+
you need an exact token name, an axis value, or what an override may contain.
|
|
5
|
+
|
|
6
|
+
## The point: `WebsitePersonality`
|
|
7
|
+
|
|
8
|
+
## Import Origins
|
|
9
|
+
|
|
10
|
+
- `@wildo-ai/saas-website`
|
|
11
|
+
|
|
12
|
+
## Source Excerpts
|
|
13
|
+
|
|
14
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
*
|
|
18
|
+
* `WebsitePersonality` — the point a website's theme is composed from (#2742).
|
|
19
|
+
*
|
|
20
|
+
* It is the APPLICATION's theme personality (`ThemePersonality`: density, shape, elevation, motion, material, type
|
|
21
|
+
* voice, danger style, selection emphasis, letter case, edge weight), so one brand looks and moves one way on its
|
|
22
|
+
* product and on its site, plus two axes only a marketing page has:
|
|
23
|
+
*
|
|
24
|
+
* - `surfaceRhythm` — how a page's sections alternate their surfaces ({@link WebsiteSurfaceRhythm});
|
|
25
|
+
* - `displayScale` — how large the page's display headings are against its body text ({@link WebsiteDisplayScale}).
|
|
26
|
+
*
|
|
27
|
+
* `composeWebsiteDesignTokens` turns the point into every token value (`@wildo-ai/saas-website`). The build's
|
|
28
|
+
* `design-system-brand` step derives it from the brand's visual tone (`deriveWebsitePersonality`) and writes it to
|
|
29
|
+
* `website/src/brand-theme.ts`; the site's root config states an axis itself only where the brand's words do not
|
|
30
|
+
* describe the site it wants.
|
|
31
|
+
*/
|
|
32
|
+
export enum WebsiteSurfaceRhythm {
|
|
33
|
+
/** Every section on the page's own background: a calm page whose rhythm is spacing alone. */
|
|
34
|
+
FLAT = 'flat',
|
|
35
|
+
/** Sections alternate between the page background and a quiet tint of it. */
|
|
36
|
+
TINTED = 'tinted',
|
|
37
|
+
/** Sections alternate tints, and the page's turning points (the numbers, the closing call to action) go inverse. */
|
|
38
|
+
CONTRASTING = 'contrasting',
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** How large display headings run against body text, the one typographic choice a brand's words decide most. */
|
|
42
|
+
export enum WebsiteDisplayScale {
|
|
43
|
+
/** Headings a step above the body: documentation-like, quiet, information-first. */
|
|
44
|
+
MODEST = 'modest',
|
|
45
|
+
/** Large display headings with tight tracking: the confident default of a modern product site. */
|
|
46
|
+
BOLD = 'bold',
|
|
47
|
+
/** Very large, poster-like headings: one idea per screen. */
|
|
48
|
+
DRAMATIC = 'dramatic',
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/*
|
|
52
|
+
* The ten shared axes under website names, so a site states its point with imports from `@wildo-ai/saas-website`
|
|
53
|
+
* alone (a site does not depend on the application's models package). Each IS the application's enum, the same
|
|
54
|
+
* object, the way `WebsiteMotionTempo` is `ThemeMotion`: one vocabulary, two doors. The motion axis is
|
|
55
|
+
* `WebsiteMotionTempo` (`website-motion.shared.schemas.ts`).
|
|
56
|
+
*/
|
|
57
|
+
export const WebsiteDensity: typeof ThemeDensity = ThemeDensity;
|
|
58
|
+
export type WebsiteDensity = ThemeDensity;
|
|
59
|
+
export const WebsiteShape: typeof ThemeShape = ThemeShape;
|
|
60
|
+
export type WebsiteShape = ThemeShape;
|
|
61
|
+
export const WebsiteElevation: typeof ThemeElevation = ThemeElevation;
|
|
62
|
+
export type WebsiteElevation = ThemeElevation;
|
|
63
|
+
export const WebsiteMaterial: typeof ThemeMaterial = ThemeMaterial;
|
|
64
|
+
export type WebsiteMaterial = ThemeMaterial;
|
|
65
|
+
export const WebsiteTypeVoice: typeof ThemeTypeVoice = ThemeTypeVoice;
|
|
66
|
+
export type WebsiteTypeVoice = ThemeTypeVoice;
|
|
67
|
+
export const WebsiteDangerStyle: typeof ThemeDangerStyle = ThemeDangerStyle;
|
|
68
|
+
export type WebsiteDangerStyle = ThemeDangerStyle;
|
|
69
|
+
export const WebsiteSelectionEmphasis: typeof ThemeSelectionEmphasis = ThemeSelectionEmphasis;
|
|
70
|
+
export type WebsiteSelectionEmphasis = ThemeSelectionEmphasis;
|
|
71
|
+
export const WebsiteLetterCase: typeof ThemeLetterCase = ThemeLetterCase;
|
|
72
|
+
export type WebsiteLetterCase = ThemeLetterCase;
|
|
73
|
+
export const WebsiteEdgeWeight: typeof ThemeEdgeWeight = ThemeEdgeWeight;
|
|
74
|
+
export type WebsiteEdgeWeight = ThemeEdgeWeight;
|
|
75
|
+
|
|
76
|
+
export interface WebsitePersonality extends ThemePersonality {
|
|
77
|
+
readonly surfaceRhythm: WebsiteSurfaceRhythm;
|
|
78
|
+
readonly displayScale: WebsiteDisplayScale;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** The point a site gets when nothing is said: the application's default point, tinted rhythm, bold display. */
|
|
82
|
+
export const DEFAULT_WEBSITE_PERSONALITY: WebsitePersonality = {
|
|
83
|
+
...DEFAULT_THEME_PERSONALITY,
|
|
84
|
+
surfaceRhythm: WebsiteSurfaceRhythm.TINTED,
|
|
85
|
+
displayScale: WebsiteDisplayScale.BOLD,
|
|
86
|
+
};
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Deriving the point from the brand's words
|
|
90
|
+
|
|
91
|
+
## Import Origins
|
|
92
|
+
|
|
93
|
+
- `@wildo-ai/saas-website`
|
|
94
|
+
|
|
95
|
+
## Source Excerpts
|
|
96
|
+
|
|
97
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
98
|
+
|
|
99
|
+
```typescript
|
|
100
|
+
*
|
|
101
|
+
* The website point a brand's visual tone names: `deriveThemePersonality` for the ten shared axes (the same point the
|
|
102
|
+
* application's theme is composed from), and the same word-matching for `surfaceRhythm` and `displayScale`.
|
|
103
|
+
* Deterministic, and an axis no word reaches keeps the default's value.
|
|
104
|
+
*
|
|
105
|
+
* @example
|
|
106
|
+
* deriveWebsitePersonality({ styleKeywords: ['bold', 'vibrant', 'playful'], mood: 'energetic' });
|
|
107
|
+
* // → …the application's point…, surfaceRhythm: CONTRASTING, displayScale: DRAMATIC
|
|
108
|
+
*/
|
|
109
|
+
export function deriveWebsitePersonality(visualTone: { readonly styleKeywords: readonly string[]; readonly mood?: string }): WebsitePersonality
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
## The composer's input: the palette and the overrides
|
|
113
|
+
|
|
114
|
+
## Import Origins
|
|
115
|
+
|
|
116
|
+
- `@wildo-ai/saas-website`
|
|
117
|
+
|
|
118
|
+
## Source Excerpts
|
|
119
|
+
|
|
120
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
121
|
+
|
|
122
|
+
```typescript
|
|
123
|
+
*
|
|
124
|
+
* `WebsitePalette` — the brand colours a site's theme is composed from. The build writes it to
|
|
125
|
+
* `website/src/brand-theme.ts` (`BRAND_WEBSITE_PALETTE`) from the same seeds as the application's palette.
|
|
126
|
+
*
|
|
127
|
+
* - `colors`: the light roles (page background and text, primary, accent, the tinted surface, hairlines).
|
|
128
|
+
* - `raised`: the surface a card lifts to on a tinted band (the application's raised surface, white on a light
|
|
129
|
+
* palette). Absent: the page background.
|
|
130
|
+
* - `inverse`: the dark roles the INVERSE tone uses (the application's dark-mode roles). Absent: the light roles
|
|
131
|
+
* swapped, which reads but is not the brand's own dark.
|
|
132
|
+
* - `product`: the colours a drawn product needs that the website's roles do not carry (#2742), derived by the build
|
|
133
|
+
* from the APPLICATION's palette: per `IndicatorVariant` a chip's soft fill and ink (from the app's success,
|
|
134
|
+
* warning, info and destructive colours), avatar fills that carry white initials, and chart series.
|
|
135
|
+
*/
|
|
136
|
+
export interface WebsitePalette {
|
|
137
|
+
readonly colors: WebsiteColorTokens;
|
|
138
|
+
readonly raised?: string;
|
|
139
|
+
readonly inverse?: Pick<WebsiteToneTokens, 'background' | 'foreground' | 'mutedForeground' | 'border' | 'raised' | 'primary' | 'primaryForeground'>;
|
|
140
|
+
readonly product: WebsiteProductPalette;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/** The product colours the build derives from the application's palette (`WebsitePalette.product`). */
|
|
144
|
+
export interface WebsiteProductPalette {
|
|
145
|
+
readonly status: Readonly<Record<IndicatorVariant, WebsiteProductStatusTokens>>;
|
|
146
|
+
readonly avatars: Readonly<Record<WebsiteProductAvatar, string>>;
|
|
147
|
+
readonly series: Readonly<Record<WebsiteProductSeries, string>>;
|
|
148
|
+
/** The success colour on the brand's dark, readable at 4.5:1 there: a live dot, a command that ran. */
|
|
149
|
+
readonly nightPositive: string;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/** Override any token of any group; a group is merged key by key, a tone and a type role likewise. */
|
|
153
|
+
export interface WebsiteDesignTokenOverrides {
|
|
154
|
+
readonly colors?: Partial<WebsiteColorTokens>;
|
|
155
|
+
readonly tones?: Partial<{ readonly [Tone in WebsiteSurfaceTone]: Partial<WebsiteToneTokens> }>;
|
|
156
|
+
readonly fonts?: Partial<WebsiteFontTokens>;
|
|
157
|
+
readonly type?: Partial<{ readonly [Role in keyof WebsiteTypeTokens]: Partial<WebsiteTypeRoleTokens> }>;
|
|
158
|
+
readonly space?: Partial<WebsiteSpaceTokens>;
|
|
159
|
+
readonly rhythm?: Partial<WebsiteRhythmTokens>;
|
|
160
|
+
readonly elevation?: Partial<WebsiteElevationTokens>;
|
|
161
|
+
readonly edges?: Partial<WebsiteEdgeTokens>;
|
|
162
|
+
readonly layout?: Partial<WebsiteLayoutTokens>;
|
|
163
|
+
readonly radii?: Partial<WebsiteRadiusTokens>;
|
|
164
|
+
/** A drawn product's colours, key by key; `night`, a status, the avatars and the series merge likewise. */
|
|
165
|
+
readonly product?: Partial<Omit<WebsiteProductTokens, 'night' | 'status' | 'avatars' | 'series' | 'selection'>> & {
|
|
166
|
+
readonly night?: Partial<WebsiteProductTokens['night']>;
|
|
167
|
+
readonly selection?: Partial<WebsiteProductTokens['selection']>;
|
|
168
|
+
readonly status?: Partial<Readonly<Record<IndicatorVariant, Partial<WebsiteProductStatusTokens>>>>;
|
|
169
|
+
readonly avatars?: Partial<WebsiteProductTokens['avatars']>;
|
|
170
|
+
readonly series?: Partial<WebsiteProductTokens['series']>;
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
export interface ComposeWebsiteDesignTokensInput {
|
|
175
|
+
readonly palette: WebsitePalette;
|
|
176
|
+
/** The point to compose from; an axis left out keeps `DEFAULT_WEBSITE_PERSONALITY`'s value. */
|
|
177
|
+
readonly personality?: Partial<WebsitePersonality>;
|
|
178
|
+
/** The font stacks, over the type voice's defaults: name the brand's font first (`Inter, ui-sans-serif, …`). */
|
|
179
|
+
readonly fonts?: Partial<WebsiteFontTokens>;
|
|
180
|
+
/** The fonts the site serves itself (`@font-face`), when its stacks name a font the visitor may not have. */
|
|
181
|
+
readonly fontFaces?: readonly WebsiteFontFace[];
|
|
182
|
+
/** Motion choices; absent, the tempo is the personality's `motion` and pages cross-fade. */
|
|
183
|
+
readonly motion?: WebsiteMotionTokens;
|
|
184
|
+
/** What the brand does differently from what its point derives. Say why at the site. */
|
|
185
|
+
readonly overrides?: WebsiteDesignTokenOverrides;
|
|
186
|
+
}
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
## The composer
|
|
190
|
+
|
|
191
|
+
## Import Origins
|
|
192
|
+
|
|
193
|
+
- `@wildo-ai/saas-website`
|
|
194
|
+
|
|
195
|
+
## Source Excerpts
|
|
196
|
+
|
|
197
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
198
|
+
|
|
199
|
+
```typescript
|
|
200
|
+
*
|
|
201
|
+
* Compose a site's whole theme (`WebsiteDesignTokens`) from the brand's palette and a personality point. Every value
|
|
202
|
+
* is derived:
|
|
203
|
+
* - `density` → `space`, `rhythm`;
|
|
204
|
+
* - `shape` → the radius roles;
|
|
205
|
+
* - `elevation` → shadows;
|
|
206
|
+
* - `edgeWeight` → line width and how strongly hairlines read;
|
|
207
|
+
* - `typeVoice`, `displayScale`, `letterCase` → `fonts` and the type scale;
|
|
208
|
+
* - the palette → the four tones;
|
|
209
|
+
* - `motion` → the tempo.
|
|
210
|
+
*
|
|
211
|
+
* `overrides` then replaces what the brand does differently, group by group and key by key. The result is validated
|
|
212
|
+
* against `WebsiteDesignTokensSchema`, so an override that would inject CSS refuses at config load.
|
|
213
|
+
*
|
|
214
|
+
* @example
|
|
215
|
+
* import { BRAND_WEBSITE_PALETTE, BRAND_WEBSITE_PERSONALITY } from './brand-theme';
|
|
216
|
+
* designTokens: composeWebsiteDesignTokens({
|
|
217
|
+
* palette: BRAND_WEBSITE_PALETTE,
|
|
218
|
+
* personality: { ...BRAND_WEBSITE_PERSONALITY, shape: ThemeShape.ROUND }, // the site is rounder than the brand's words
|
|
219
|
+
* fonts: { sans: "Inter, ui-sans-serif, system-ui, sans-serif" },
|
|
220
|
+
* }),
|
|
221
|
+
*/
|
|
222
|
+
export function composeWebsiteDesignTokens(input: ComposeWebsiteDesignTokensInput): WebsiteDesignTokens
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## The bundle
|
|
226
|
+
|
|
227
|
+
## Import Origins
|
|
228
|
+
|
|
229
|
+
- `@wildo-ai/saas-website`
|
|
230
|
+
|
|
231
|
+
## Source Excerpts
|
|
232
|
+
|
|
233
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
234
|
+
|
|
235
|
+
```typescript
|
|
236
|
+
*
|
|
237
|
+
* `WebsiteDesignTokens` — the complete design-token bundle attached to `WebsiteRootConfig.designTokens` (#2742):
|
|
238
|
+
* the theme of the whole site.
|
|
239
|
+
*
|
|
240
|
+
* **Compose it, do not type it.** `composeWebsiteDesignTokens({ palette, personality, fonts, overrides })` derives
|
|
241
|
+
* every value from the brand's palette and a personality point, and a site states only what its brand does
|
|
242
|
+
* differently. The build writes the brand's palette and point to `website/src/brand-theme.ts`.
|
|
243
|
+
*
|
|
244
|
+
* - Value groups are emitted as `--website-<group>-<path>` by `renderWebsiteDesignTokensCss`: `colors`, `tones`
|
|
245
|
+
* (`--website-tones-inverse-background`), `fonts`, `type` (`--website-type-display-size`), `space`, `rhythm`,
|
|
246
|
+
* `elevation`, `edges`, `layout`, `radii`, `product` (`--website-product-status-success-foreground`, read only by
|
|
247
|
+
* drawn products). The renderer also emits the CURRENT tone (`--website-tone-*`), which
|
|
248
|
+
* `data-website-tone` re-binds, and an `@font-face` per `fontFaces` entry.
|
|
249
|
+
* - `motion` and `personality` are CHOICES, never emitted verbatim: the motion stylesheet derives `--website-motion-*`
|
|
250
|
+
* from `motion`; components whose structure follows an axis read `personality`.
|
|
251
|
+
*
|
|
252
|
+
* D7 (colours and radius only, typography and spacing in the application's CSS) was superseded on 2026-10-08: a
|
|
253
|
+
* site's look is its theme, and the engine's components draw it.
|
|
254
|
+
*/
|
|
255
|
+
const _WebsiteDesignTokensSchema = z.object({
|
|
256
|
+
colors: _WebsiteColorTokensSchema,
|
|
257
|
+
tones: _WebsiteTonesTokensSchema,
|
|
258
|
+
fonts: _WebsiteFontTokensSchema,
|
|
259
|
+
fontFaces: z.array(_WebsiteFontFaceSchema),
|
|
260
|
+
type: _WebsiteTypeTokensSchema,
|
|
261
|
+
space: _WebsiteSpaceTokensSchema,
|
|
262
|
+
rhythm: _WebsiteRhythmTokensSchema,
|
|
263
|
+
elevation: _WebsiteElevationTokensSchema,
|
|
264
|
+
edges: _WebsiteEdgeTokensSchema,
|
|
265
|
+
layout: _WebsiteLayoutTokensSchema,
|
|
266
|
+
radii: _WebsiteRadiusTokensSchema,
|
|
267
|
+
product: _WebsiteProductTokensSchema,
|
|
268
|
+
personality: _WebsitePersonalityTokensSchema,
|
|
269
|
+
motion: WebsiteMotionTokensSchema.optional(),
|
|
270
|
+
});
|
|
271
|
+
|
|
272
|
+
export const WebsiteDesignTokensSchema: typeof _WebsiteDesignTokensSchema = _WebsiteDesignTokensSchema;
|
|
273
|
+
|
|
274
|
+
export type WebsiteDesignTokens = z.infer<typeof _WebsiteDesignTokensSchema>;
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
## A drawn product's colours: `WebsiteProductTokens`
|
|
278
|
+
|
|
279
|
+
What a demo's drawn windows, chips, avatars and charts are painted with (`--website-product-*`), read through
|
|
280
|
+
`websiteProductCssVar`. A site does not set them by hand: the build derives `palette.product` from the application's
|
|
281
|
+
palette, and `overrides.product` adjusts one, key by key.
|
|
282
|
+
|
|
283
|
+
## Import Origins
|
|
284
|
+
|
|
285
|
+
- `@wildo-ai/saas-website`
|
|
286
|
+
|
|
287
|
+
## Source Excerpts
|
|
288
|
+
|
|
289
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
290
|
+
|
|
291
|
+
```typescript
|
|
292
|
+
*
|
|
293
|
+
* `WebsiteProductTokens`: the colours of the PRODUCT a website draws (#2742), the windows, rows, chips, avatars and
|
|
294
|
+
* charts of a demo. Emitted as `--website-product-<path>` and read by the drawn-product kit and by an application's own
|
|
295
|
+
* demo atoms through `websiteProductCssVar`, never by a section: a section is the website, a demo is the product.
|
|
296
|
+
*
|
|
297
|
+
* `composeWebsiteDesignTokens` derives them: the surfaces from the website's colours, the night panel from the brand's
|
|
298
|
+
* dark roles with the site's inverse overrides, and the status, avatar and series colours from `palette.product`, which the build derives from the
|
|
299
|
+
* APPLICATION's palette (its success, warning, info and destructive colours), so a drawing shows the product's own.
|
|
300
|
+
*
|
|
301
|
+
* - `window` · `surface` · `sunken` · `line` · `ink` · `muted`: the drawn window's background, a card on it, a recessed
|
|
302
|
+
* well, hairlines, text and secondary text.
|
|
303
|
+
* - `primary` · `primaryForeground` · `primarySoft`: the product's action colour, its label, and its tint (a selected
|
|
304
|
+
* rail item, a focused row). `shadow`: the colour a drawn element's shadow is cast in.
|
|
305
|
+
* - From the PERSONALITY, so a drawing has the application's character as well as its colours: `selection` (a selected
|
|
306
|
+
* item's fill and text, from `selectionEmphasis`: the brand's tint, or a quiet neutral wash), `radius` (a multiplier
|
|
307
|
+
* on every corner, from `shape`) and `pill` (the corner of a pill-shaped chip, a pill for a round brand and a small
|
|
308
|
+
* corner for a sharp one), `space` (a multiplier on every padding and gap, from `density`). Hairlines follow the
|
|
309
|
+
* site's `edges.width` (`edgeWeight`).
|
|
310
|
+
* - `night`: a dark panel (an activity stream, a terminal), from the brand's dark roles with the site's inverse
|
|
311
|
+
* overrides (its hairline unadjusted by edge weight, like every drawn hairline); its `positive` is the
|
|
312
|
+
* application's own dark-mode success colour, which reads on it (a live dot, a command that ran).
|
|
313
|
+
* - `status`: per `IndicatorVariant`, the soft fill and the ink of a chip of that status; the ink reads at 4.5:1.
|
|
314
|
+
* - `avatars`: fills that carry white initials at 4.5:1. `series`: chart colours, in order of emphasis.
|
|
315
|
+
*/
|
|
316
|
+
/** One status as a chip draws it: a soft fill and the ink on it. */
|
|
317
|
+
const _WebsiteProductStatusTokensSchema = z.object({
|
|
318
|
+
background: cssSafeValue('product status background'),
|
|
319
|
+
foreground: cssSafeValue('product status foreground'),
|
|
320
|
+
});
|
|
321
|
+
|
|
322
|
+
export type WebsiteProductStatusTokens = z.infer<typeof _WebsiteProductStatusTokensSchema>;
|
|
323
|
+
|
|
324
|
+
/**
|
|
325
|
+
* The status a drawn chip, row or toast shows, in the application's own indicator vocabulary (`IndicatorVariant`),
|
|
326
|
+
* under the website's name, as the personality axes are (`WebsiteDensity` is `ThemeDensity`).
|
|
327
|
+
*/
|
|
328
|
+
export const WebsiteProductStatus: typeof IndicatorVariant = IndicatorVariant;
|
|
329
|
+
export type WebsiteProductStatus = IndicatorVariant;
|
|
330
|
+
|
|
331
|
+
/** The avatar fills, in the order a drawing assigns them (`initials → slot`). Five: enough that a row of people rarely repeats one. */
|
|
332
|
+
export enum WebsiteProductAvatar {
|
|
333
|
+
FIRST = '1',
|
|
334
|
+
SECOND = '2',
|
|
335
|
+
THIRD = '3',
|
|
336
|
+
FOURTH = '4',
|
|
337
|
+
FIFTH = '5',
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/** The chart series, in order of emphasis: the first is the product's colour, the last the quietest. */
|
|
341
|
+
export enum WebsiteProductSeries {
|
|
342
|
+
FIRST = '1',
|
|
343
|
+
SECOND = '2',
|
|
344
|
+
THIRD = '3',
|
|
345
|
+
FOURTH = '4',
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
const productColor = (what: string) => cssSafeValue(`product ${what}`);
|
|
349
|
+
|
|
350
|
+
const _WebsiteProductTokensSchema = z.object({
|
|
351
|
+
window: productColor('window'),
|
|
352
|
+
surface: productColor('surface'),
|
|
353
|
+
sunken: productColor('sunken'),
|
|
354
|
+
line: productColor('line'),
|
|
355
|
+
ink: productColor('ink'),
|
|
356
|
+
muted: productColor('muted'),
|
|
357
|
+
primary: productColor('primary'),
|
|
358
|
+
primaryForeground: productColor('primaryForeground'),
|
|
359
|
+
primarySoft: productColor('primarySoft'),
|
|
360
|
+
shadow: productColor('shadow'),
|
|
361
|
+
selection: z.object({
|
|
362
|
+
background: productColor('selection background'),
|
|
363
|
+
foreground: productColor('selection foreground'),
|
|
364
|
+
}),
|
|
365
|
+
radius: cssSafeValue('product radius scale'),
|
|
366
|
+
pill: cssSafeValue('product pill radius'),
|
|
367
|
+
space: cssSafeValue('product space scale'),
|
|
368
|
+
night: z.object({
|
|
369
|
+
background: productColor('night background'),
|
|
370
|
+
surface: productColor('night surface'),
|
|
371
|
+
line: productColor('night line'),
|
|
372
|
+
ink: productColor('night ink'),
|
|
373
|
+
muted: productColor('night muted'),
|
|
374
|
+
accent: productColor('night accent'),
|
|
375
|
+
positive: productColor('night positive'),
|
|
376
|
+
}),
|
|
377
|
+
status: z.object({
|
|
378
|
+
[IndicatorVariant.INFO]: _WebsiteProductStatusTokensSchema,
|
|
379
|
+
[IndicatorVariant.SUCCESS]: _WebsiteProductStatusTokensSchema,
|
|
380
|
+
[IndicatorVariant.WARNING]: _WebsiteProductStatusTokensSchema,
|
|
381
|
+
[IndicatorVariant.ERROR]: _WebsiteProductStatusTokensSchema,
|
|
382
|
+
[IndicatorVariant.NEUTRAL]: _WebsiteProductStatusTokensSchema,
|
|
383
|
+
} satisfies Record<IndicatorVariant, unknown>),
|
|
384
|
+
avatars: z.object({
|
|
385
|
+
[WebsiteProductAvatar.FIRST]: productColor('avatar'),
|
|
386
|
+
[WebsiteProductAvatar.SECOND]: productColor('avatar'),
|
|
387
|
+
[WebsiteProductAvatar.THIRD]: productColor('avatar'),
|
|
388
|
+
[WebsiteProductAvatar.FOURTH]: productColor('avatar'),
|
|
389
|
+
[WebsiteProductAvatar.FIFTH]: productColor('avatar'),
|
|
390
|
+
} satisfies Record<WebsiteProductAvatar, unknown>),
|
|
391
|
+
series: z.object({
|
|
392
|
+
[WebsiteProductSeries.FIRST]: productColor('series'),
|
|
393
|
+
[WebsiteProductSeries.SECOND]: productColor('series'),
|
|
394
|
+
[WebsiteProductSeries.THIRD]: productColor('series'),
|
|
395
|
+
[WebsiteProductSeries.FOURTH]: productColor('series'),
|
|
396
|
+
} satisfies Record<WebsiteProductSeries, unknown>),
|
|
397
|
+
});
|
|
398
|
+
|
|
399
|
+
export const WebsiteProductTokensSchema: typeof _WebsiteProductTokensSchema = _WebsiteProductTokensSchema;
|
|
400
|
+
|
|
401
|
+
export type WebsiteProductTokens = z.infer<typeof _WebsiteProductTokensSchema>;
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
## Colours and corners
|
|
405
|
+
|
|
406
|
+
## Import Origins
|
|
407
|
+
|
|
408
|
+
- `@wildo-ai/saas-website`
|
|
409
|
+
|
|
410
|
+
## Source Excerpts
|
|
411
|
+
|
|
412
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
413
|
+
|
|
414
|
+
```typescript
|
|
415
|
+
*
|
|
416
|
+
* `WebsiteColorTokens` — minimal palette the marketing-site exposes as
|
|
417
|
+
* CSS custom properties (`--website-colors-<token>`, the key verbatim, so
|
|
418
|
+
* `surfaceForeground` → `--website-colors-surfaceForeground`) on `:root`.
|
|
419
|
+
* Reference one from code through `websiteDesignTokenCssVar('colors', …)`
|
|
420
|
+
* rather than spelling the name.
|
|
421
|
+
*
|
|
422
|
+
* **Why a dedicated marketing palette** (vs. reusing
|
|
423
|
+
* `presets-components-models/design-tokens-config`):
|
|
424
|
+
*
|
|
425
|
+
* - The SaaS app's design tokens carry many semantic states (`muted`,
|
|
426
|
+
* `destructive`, `ring`, `sidebar-*`, …) that have no marketing-site
|
|
427
|
+
* analogue. Forcing the website to consume the full palette would
|
|
428
|
+
* leak app-internal semantics into a public surface.
|
|
429
|
+
* - Marketing pages need *display-grade* colors (heavily branded
|
|
430
|
+
* accents, gradient stops, hero-overlay tints) that the SaaS app's
|
|
431
|
+
* functional palette deliberately avoids.
|
|
432
|
+
* - Designers overriding website tokens should not be able to break
|
|
433
|
+
* the SaaS app by editing one tailwind.config — the two surfaces
|
|
434
|
+
* stay decoupled.
|
|
435
|
+
*
|
|
436
|
+
* **Token format**: every value is a CSS color string. Shape validation
|
|
437
|
+
* is intentionally permissive (accepts hex, rgb/rgba, hsl/hsla, oklch,
|
|
438
|
+
* `currentColor`, named colors, CSS variable references) — a strict
|
|
439
|
+
* color-string regex would reject legitimate values (oklch grammar
|
|
440
|
+
* alone is ~80 lines) and a malformed-but-syntactically-valid color
|
|
441
|
+
* fails loudly at render time.
|
|
442
|
+
*
|
|
443
|
+
* **What IS strictly enforced**: every value passes `cssSafeValue`,
|
|
444
|
+
* which rejects what can break out of a CSS property declaration or
|
|
445
|
+
* the `<style>` element (`;`, `{`, `}`, `/*`, `*\/`, `<`, `>`, a newline,
|
|
446
|
+
* a backslash) and a quote left open. See the `cssSafeValue` JSDoc above
|
|
447
|
+
* for the full threat model.
|
|
448
|
+
*
|
|
449
|
+
* **Adding a token**: append the field here using `cssSafeValue(...)`,
|
|
450
|
+
* document its semantic intent in the JSDoc. `renderWebsiteDesignTokensCss`
|
|
451
|
+
* (from `@wildo-ai/saas-website/astro`) emits every key generically, so no
|
|
452
|
+
* emitter needs editing.
|
|
453
|
+
*/
|
|
454
|
+
const _WebsiteColorTokensSchema = z.object({
|
|
455
|
+
background: cssSafeValue('background color'),
|
|
456
|
+
foreground: cssSafeValue('foreground color'),
|
|
457
|
+
primary: cssSafeValue('primary color'),
|
|
458
|
+
primaryForeground: cssSafeValue('primaryForeground color'),
|
|
459
|
+
accent: cssSafeValue('accent color'),
|
|
460
|
+
accentForeground: cssSafeValue('accentForeground color'),
|
|
461
|
+
surface: cssSafeValue('surface color'),
|
|
462
|
+
surfaceForeground: cssSafeValue('surfaceForeground color'),
|
|
463
|
+
border: cssSafeValue('border color'),
|
|
464
|
+
muted: cssSafeValue('muted color'),
|
|
465
|
+
mutedForeground: cssSafeValue('mutedForeground color'),
|
|
466
|
+
});
|
|
467
|
+
|
|
468
|
+
export const WebsiteColorTokensSchema: typeof _WebsiteColorTokensSchema = _WebsiteColorTokensSchema;
|
|
469
|
+
|
|
470
|
+
export type WebsiteColorTokens = z.infer<typeof _WebsiteColorTokensSchema>;
|
|
471
|
+
```
|
|
472
|
+
|
|
473
|
+
## Import Origins
|
|
474
|
+
|
|
475
|
+
- `@wildo-ai/saas-website`
|
|
476
|
+
|
|
477
|
+
## Source Excerpts
|
|
478
|
+
|
|
479
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
480
|
+
|
|
481
|
+
```typescript
|
|
482
|
+
*
|
|
483
|
+
* `WebsiteRadiusTokens` — border-radius scale exposed as
|
|
484
|
+
* `--website-radii-<token>` CSS variables: a size scale (`none`…`full`) and four ROLES (`card`, `control`, `chip`,
|
|
485
|
+
* `media`) the engine's components read, set from the personality's `shape` by `composeWebsiteDesignTokens`.
|
|
486
|
+
*
|
|
487
|
+
* Marketing radii are intentionally a separate token set from the
|
|
488
|
+
* SaaS app's radii: the website typically wants larger pill / hero
|
|
489
|
+
* radii than the app's compact-UI radii. Keeping them separate lets
|
|
490
|
+
* either surface evolve without coupling.
|
|
491
|
+
*
|
|
492
|
+
* Values are CSS length strings (`'0.25rem'`, `'12px'`,
|
|
493
|
+
* `'9999px'`). Same permissive-shape + strict-CSS-injection
|
|
494
|
+
* rationale as `WebsiteColorTokens` (every value runs through
|
|
495
|
+
* `cssSafeValue`).
|
|
496
|
+
*/
|
|
497
|
+
const _WebsiteRadiusTokensSchema = z.object({
|
|
498
|
+
none: cssSafeValue('none radius'),
|
|
499
|
+
sm: cssSafeValue('sm radius'),
|
|
500
|
+
md: cssSafeValue('md radius'),
|
|
501
|
+
lg: cssSafeValue('lg radius'),
|
|
502
|
+
xl: cssSafeValue('xl radius'),
|
|
503
|
+
full: cssSafeValue('full radius'),
|
|
504
|
+
/** The corner of a card, a panel, a pricing plan: the radius a page shows most. Set by `shape`. */
|
|
505
|
+
card: cssSafeValue('card radius'),
|
|
506
|
+
/** The corner of a button and a segmented control. Set by `shape` (a pill on ROUND). */
|
|
507
|
+
control: cssSafeValue('control radius'),
|
|
508
|
+
/** The corner of a chip, a tag, an eyebrow pill, a badge. Set by `shape`. */
|
|
509
|
+
chip: cssSafeValue('chip radius'),
|
|
510
|
+
/** The corner of a framed image, a product drawing, a demo window. Set by `shape`. */
|
|
511
|
+
media: cssSafeValue('media radius'),
|
|
512
|
+
/** The corner of an icon tile (the square behind a glyph); a small tile takes two thirds of it. Set by `shape`. */
|
|
513
|
+
tile: cssSafeValue('tile radius'),
|
|
514
|
+
});
|
|
515
|
+
|
|
516
|
+
export const WebsiteRadiusTokensSchema: typeof _WebsiteRadiusTokensSchema = _WebsiteRadiusTokensSchema;
|
|
517
|
+
|
|
518
|
+
export type WebsiteRadiusTokens = z.infer<typeof _WebsiteRadiusTokensSchema>;
|
|
519
|
+
```
|
|
520
|
+
|
|
521
|
+
## Tones: the surface a band sits on
|
|
522
|
+
|
|
523
|
+
## Import Origins
|
|
524
|
+
|
|
525
|
+
- `@wildo-ai/saas-website`
|
|
526
|
+
|
|
527
|
+
## Source Excerpts
|
|
528
|
+
|
|
529
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
530
|
+
|
|
531
|
+
```typescript
|
|
532
|
+
*
|
|
533
|
+
* `WebsiteSurfaceTone` — the surface a section (a band) sits on (#2742). A component never names a colour: it reads
|
|
534
|
+
* the CURRENT tone (`--website-tone-background`, `--website-tone-foreground`, …), and `data-website-tone="<tone>"` on
|
|
535
|
+
* any element re-binds those variables for everything inside it, so a card, an eyebrow, a link or a secondary button
|
|
536
|
+
* is right on every band without a rule per band.
|
|
537
|
+
*/
|
|
538
|
+
export enum WebsiteSurfaceTone {
|
|
539
|
+
/** The page's own background and text. */
|
|
540
|
+
DEFAULT = 'default',
|
|
541
|
+
/** A quiet tint of the page: the alternating band. Cards on it lift to the raised surface. */
|
|
542
|
+
TINTED = 'tinted',
|
|
543
|
+
/** Dark on light (or light on dark): the page's turning points, the numbers, the closing call to action. */
|
|
544
|
+
INVERSE = 'inverse',
|
|
545
|
+
/** The brand's primary as the surface: the loudest band, used once at most. */
|
|
546
|
+
BRAND = 'brand',
|
|
547
|
+
}
|
|
548
|
+
|
|
549
|
+
/**
|
|
550
|
+
* The colour roles of ONE tone. Every engine component reads these, never `colors` directly, so it renders on any
|
|
551
|
+
* band. Values are CSS colours (any notation, `var()` and `color-mix()` included), checked by `cssSafeValue`.
|
|
552
|
+
*/
|
|
553
|
+
const _WebsiteToneTokensSchema = z.object({
|
|
554
|
+
/** The band's surface. */
|
|
555
|
+
background: cssSafeValue('tone background'),
|
|
556
|
+
/** Body and heading text on the band. */
|
|
557
|
+
foreground: cssSafeValue('tone foreground'),
|
|
558
|
+
/** Secondary text: ledes, captions, card bodies. */
|
|
559
|
+
mutedForeground: cssSafeValue('tone mutedForeground'),
|
|
560
|
+
/** Hairlines: card borders, table rules, secondary button borders. */
|
|
561
|
+
border: cssSafeValue('tone border'),
|
|
562
|
+
/** The surface a card or a panel lifts to ON this band (white on a tinted band, a step lighter on an inverse one). */
|
|
563
|
+
raised: cssSafeValue('tone raised'),
|
|
564
|
+
/** The brand colour as TEXT and marks on this band: links, eyebrows, icons. */
|
|
565
|
+
primary: cssSafeValue('tone primary'),
|
|
566
|
+
/** Text on `primary` used as a fill (a chip, a badge). */
|
|
567
|
+
primaryForeground: cssSafeValue('tone primaryForeground'),
|
|
568
|
+
/** A translucent wash of the brand on this band: the tile behind an icon, a selected row. */
|
|
569
|
+
primaryWash: cssSafeValue('tone primaryWash'),
|
|
570
|
+
/** The brand's one accent beat on this band. */
|
|
571
|
+
accent: cssSafeValue('tone accent'),
|
|
572
|
+
/** The fill of the primary call to action on this band (a white button on the brand band). */
|
|
573
|
+
action: cssSafeValue('tone action'),
|
|
574
|
+
/** The label on `action`. */
|
|
575
|
+
actionForeground: cssSafeValue('tone actionForeground'),
|
|
576
|
+
/** The surface a secondary control is drawn on (the page's colour, or transparent on a dark or brand band). */
|
|
577
|
+
control: cssSafeValue('tone control'),
|
|
578
|
+
});
|
|
579
|
+
|
|
580
|
+
export const WebsiteToneTokensSchema: typeof _WebsiteToneTokensSchema = _WebsiteToneTokensSchema;
|
|
581
|
+
|
|
582
|
+
export type WebsiteToneTokens = z.infer<typeof _WebsiteToneTokensSchema>;
|
|
583
|
+
|
|
584
|
+
/** One `WebsiteToneTokens` per `WebsiteSurfaceTone`, keyed by the tone's value. */
|
|
585
|
+
const _WebsiteTonesTokensSchema = z.object({
|
|
586
|
+
[WebsiteSurfaceTone.DEFAULT]: _WebsiteToneTokensSchema,
|
|
587
|
+
[WebsiteSurfaceTone.TINTED]: _WebsiteToneTokensSchema,
|
|
588
|
+
[WebsiteSurfaceTone.INVERSE]: _WebsiteToneTokensSchema,
|
|
589
|
+
[WebsiteSurfaceTone.BRAND]: _WebsiteToneTokensSchema,
|
|
590
|
+
});
|
|
591
|
+
|
|
592
|
+
export const WebsiteTonesTokensSchema: typeof _WebsiteTonesTokensSchema = _WebsiteTonesTokensSchema;
|
|
593
|
+
|
|
594
|
+
export type WebsiteTonesTokens = z.infer<typeof _WebsiteTonesTokensSchema>;
|
|
595
|
+
```
|
|
596
|
+
|
|
597
|
+
## Fonts and the type scale
|
|
598
|
+
|
|
599
|
+
## Import Origins
|
|
600
|
+
|
|
601
|
+
- `@wildo-ai/saas-website`
|
|
602
|
+
|
|
603
|
+
## Source Excerpts
|
|
604
|
+
|
|
605
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
606
|
+
|
|
607
|
+
```typescript
|
|
608
|
+
*
|
|
609
|
+
* `WebsiteFontTokens` — the site's font stacks (`--website-fonts-<role>`), and `WebsiteFontFace` — a font the site
|
|
610
|
+
* serves itself, rendered as an `@font-face` rule beside the tokens.
|
|
611
|
+
*/
|
|
612
|
+
const _WebsiteFontTokensSchema = z.object({
|
|
613
|
+
/** Body and interface text. */
|
|
614
|
+
sans: cssSafeValue('sans font stack'),
|
|
615
|
+
/** Display and section headings (the same stack as `sans` unless the type voice is editorial). */
|
|
616
|
+
display: cssSafeValue('display font stack'),
|
|
617
|
+
/** Code, figures in a technical voice. */
|
|
618
|
+
mono: cssSafeValue('mono font stack'),
|
|
619
|
+
/** `font-feature-settings` for the whole page (`normal`, or a font's stylistic sets: `'cv11', 'ss01'`). */
|
|
620
|
+
featureSettings: cssSafeValue('font feature settings'),
|
|
621
|
+
});
|
|
622
|
+
|
|
623
|
+
export const WebsiteFontTokensSchema: typeof _WebsiteFontTokensSchema = _WebsiteFontTokensSchema;
|
|
624
|
+
|
|
625
|
+
export type WebsiteFontTokens = z.infer<typeof _WebsiteFontTokensSchema>;
|
|
626
|
+
|
|
627
|
+
const _WebsiteFontFaceSchema = z.object({
|
|
628
|
+
/**
|
|
629
|
+
* The family name the stacks refer to, UNQUOTED (`Inter`, `Inter Display`): the renderer quotes it, so a name given
|
|
630
|
+
* quoted would become `"'Inter'"`, which no stack matches.
|
|
631
|
+
*/
|
|
632
|
+
family: cssSafeValue('font family').refine((value) => !/['"]/.test(value), { error: 'font family must be the bare name; the renderer quotes it' }),
|
|
633
|
+
/** The `src` descriptor: `url('/fonts/InterVariable.woff2') format('woff2')`. A path the site serves itself. */
|
|
634
|
+
src: cssSafeValue('font src'),
|
|
635
|
+
/** The weight range a variable font covers (`100 900`), or one weight. */
|
|
636
|
+
weight: cssSafeValue('font weight'),
|
|
637
|
+
style: cssSafeValue('font style'),
|
|
638
|
+
/** `swap`: text shows in the fallback until the font arrives, never invisible. */
|
|
639
|
+
display: cssSafeValue('font display'),
|
|
640
|
+
});
|
|
641
|
+
|
|
642
|
+
export const WebsiteFontFaceSchema: typeof _WebsiteFontFaceSchema = _WebsiteFontFaceSchema;
|
|
643
|
+
|
|
644
|
+
export type WebsiteFontFace = z.infer<typeof _WebsiteFontFaceSchema>;
|
|
645
|
+
|
|
646
|
+
/**
|
|
647
|
+
* `WebsiteTextCase` — whether a text role is set in capitals. Closed: the only two cases a role uses, the CSS
|
|
648
|
+
* `text-transform` value verbatim.
|
|
649
|
+
*/
|
|
650
|
+
export enum WebsiteTextCase {
|
|
651
|
+
NONE = 'none',
|
|
652
|
+
UPPERCASE = 'uppercase',
|
|
653
|
+
}
|
|
654
|
+
|
|
655
|
+
/** One role of the type scale, emitted as `--website-type-<role>-<property>`. */
|
|
656
|
+
const _WebsiteTypeRoleTokensSchema = z.object({
|
|
657
|
+
/** `font-family`: usually one of the stacks, `var(--website-fonts-display)`. */
|
|
658
|
+
family: cssSafeValue('type family'),
|
|
659
|
+
/** `font-size`: a length, or a fluid `clamp(min, preferred, max)`. */
|
|
660
|
+
size: cssSafeValue('type size'),
|
|
661
|
+
weight: cssSafeValue('type weight'),
|
|
662
|
+
/** `line-height`. */
|
|
663
|
+
leading: cssSafeValue('type leading'),
|
|
664
|
+
/** `letter-spacing`. */
|
|
665
|
+
tracking: cssSafeValue('type tracking'),
|
|
666
|
+
case: z.enum(WebsiteTextCase),
|
|
667
|
+
});
|
|
668
|
+
|
|
669
|
+
export const WebsiteTypeRoleTokensSchema: typeof _WebsiteTypeRoleTokensSchema = _WebsiteTypeRoleTokensSchema;
|
|
670
|
+
|
|
671
|
+
export type WebsiteTypeRoleTokens = z.infer<typeof _WebsiteTypeRoleTokensSchema>;
|
|
672
|
+
|
|
673
|
+
/**
|
|
674
|
+
* `WebsiteTypeTokens` — the type scale, by ROLE. A component asks for a role, never for a size, so the whole site
|
|
675
|
+
* changes scale from the personality (`displayScale`, `typeVoice`, `letterCase`) and stays consistent.
|
|
676
|
+
*/
|
|
677
|
+
const _WebsiteTypeTokensSchema = z.object({
|
|
678
|
+
/** The page's one H1 on a hero. */
|
|
679
|
+
display: _WebsiteTypeRoleTokensSchema,
|
|
680
|
+
/** The hero's H1 set beside a visual, where the full display size would crowd the copy column. */
|
|
681
|
+
displayCompact: _WebsiteTypeRoleTokensSchema,
|
|
682
|
+
/** A section heading (H2). */
|
|
683
|
+
headline: _WebsiteTypeRoleTokensSchema,
|
|
684
|
+
/** A heading inside a section that is more than a card title: a tab panel's heading, an article's H2. */
|
|
685
|
+
subhead: _WebsiteTypeRoleTokensSchema,
|
|
686
|
+
/** A step's, a plan's, a feature row's title. */
|
|
687
|
+
title: _WebsiteTypeRoleTokensSchema,
|
|
688
|
+
/** A card's title in a grid of cards: a step below `title`. */
|
|
689
|
+
titleSmall: _WebsiteTypeRoleTokensSchema,
|
|
690
|
+
/** The sentence under a heading. */
|
|
691
|
+
lead: _WebsiteTypeRoleTokensSchema,
|
|
692
|
+
/** Running text. */
|
|
693
|
+
body: _WebsiteTypeRoleTokensSchema,
|
|
694
|
+
/** A card's text, a footnote-sized paragraph. */
|
|
695
|
+
bodySmall: _WebsiteTypeRoleTokensSchema,
|
|
696
|
+
/** Small print: notes, dates, captions. */
|
|
697
|
+
caption: _WebsiteTypeRoleTokensSchema,
|
|
698
|
+
/** The label above a heading (an eyebrow), a table head, a tag. */
|
|
699
|
+
overline: _WebsiteTypeRoleTokensSchema,
|
|
700
|
+
/** A number shown as the point: a stat, a price. */
|
|
701
|
+
figure: _WebsiteTypeRoleTokensSchema,
|
|
702
|
+
/** The label of a button, a tab, a segmented control. */
|
|
703
|
+
control: _WebsiteTypeRoleTokensSchema,
|
|
704
|
+
/** A short word that marks a state: a tag, a plan's trial, a plan announced but not on sale, a cadence option. */
|
|
705
|
+
label: _WebsiteTypeRoleTokensSchema,
|
|
706
|
+
});
|
|
707
|
+
|
|
708
|
+
export const WebsiteTypeTokensSchema: typeof _WebsiteTypeTokensSchema = _WebsiteTypeTokensSchema;
|
|
709
|
+
|
|
710
|
+
export type WebsiteTypeTokens = z.infer<typeof _WebsiteTypeTokensSchema>;
|
|
711
|
+
```
|
|
712
|
+
|
|
713
|
+
## Spacing and rhythm
|
|
714
|
+
|
|
715
|
+
## Import Origins
|
|
716
|
+
|
|
717
|
+
- `@wildo-ai/saas-website`
|
|
718
|
+
|
|
719
|
+
## Source Excerpts
|
|
720
|
+
|
|
721
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
722
|
+
|
|
723
|
+
```typescript
|
|
724
|
+
*
|
|
725
|
+
* `WebsiteSpaceTokens` — the gap scale inside components (`--website-space-<step>`). `WebsiteRhythmTokens` — the
|
|
726
|
+
* page's larger rhythm (`--website-rhythm-<role>`): how far apart sections sit, how much room a card has. Both are
|
|
727
|
+
* set by the personality's `density`.
|
|
728
|
+
*/
|
|
729
|
+
const _WebsiteSpaceTokensSchema = z.object({
|
|
730
|
+
'2xs': cssSafeValue('space 2xs'),
|
|
731
|
+
xs: cssSafeValue('space xs'),
|
|
732
|
+
sm: cssSafeValue('space sm'),
|
|
733
|
+
md: cssSafeValue('space md'),
|
|
734
|
+
lg: cssSafeValue('space lg'),
|
|
735
|
+
xl: cssSafeValue('space xl'),
|
|
736
|
+
'2xl': cssSafeValue('space 2xl'),
|
|
737
|
+
});
|
|
738
|
+
|
|
739
|
+
export const WebsiteSpaceTokensSchema: typeof _WebsiteSpaceTokensSchema = _WebsiteSpaceTokensSchema;
|
|
740
|
+
|
|
741
|
+
export type WebsiteSpaceTokens = z.infer<typeof _WebsiteSpaceTokensSchema>;
|
|
742
|
+
|
|
743
|
+
const _WebsiteRhythmTokensSchema = z.object({
|
|
744
|
+
/** The block padding of a section band. */
|
|
745
|
+
section: cssSafeValue('section rhythm'),
|
|
746
|
+
/** The block padding of a compact band. */
|
|
747
|
+
sectionCompact: cssSafeValue('compact section rhythm'),
|
|
748
|
+
/** The block padding of a strip (a logo row, a marquee). */
|
|
749
|
+
strip: cssSafeValue('strip rhythm'),
|
|
750
|
+
/** The hero's top padding. */
|
|
751
|
+
heroTop: cssSafeValue('hero top rhythm'),
|
|
752
|
+
/** The hero's bottom padding. */
|
|
753
|
+
heroBottom: cssSafeValue('hero bottom rhythm'),
|
|
754
|
+
/** The bottom padding of a hero with no visual (a compact opening). */
|
|
755
|
+
heroCompact: cssSafeValue('compact hero rhythm'),
|
|
756
|
+
/** The space between a section's intro and its content. */
|
|
757
|
+
introGap: cssSafeValue('intro gap'),
|
|
758
|
+
/** The gap between the two halves of a split layout (copy beside a visual). */
|
|
759
|
+
splitGap: cssSafeValue('split gap'),
|
|
760
|
+
/** The inner padding of a card. */
|
|
761
|
+
cardPadding: cssSafeValue('card padding'),
|
|
762
|
+
/** The gap between the cards of a grid. */
|
|
763
|
+
gridGap: cssSafeValue('grid gap'),
|
|
764
|
+
/** The gap between the stacked parts of a block's copy (eyebrow, heading, body, list, link). */
|
|
765
|
+
copyGap: cssSafeValue('copy gap'),
|
|
766
|
+
/** The gap between the items of a list inside a block (a feature row's points). */
|
|
767
|
+
listGap: cssSafeValue('list gap'),
|
|
768
|
+
});
|
|
769
|
+
|
|
770
|
+
export const WebsiteRhythmTokensSchema: typeof _WebsiteRhythmTokensSchema = _WebsiteRhythmTokensSchema;
|
|
771
|
+
|
|
772
|
+
export type WebsiteRhythmTokens = z.infer<typeof _WebsiteRhythmTokensSchema>;
|
|
773
|
+
```
|
|
774
|
+
|
|
775
|
+
## Depth, lines and widths
|
|
776
|
+
|
|
777
|
+
## Import Origins
|
|
778
|
+
|
|
779
|
+
- `@wildo-ai/saas-website`
|
|
780
|
+
|
|
781
|
+
## Source Excerpts
|
|
782
|
+
|
|
783
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
784
|
+
|
|
785
|
+
```typescript
|
|
786
|
+
*
|
|
787
|
+
* `WebsiteElevationTokens` — the shadows a lifted surface casts (`--website-elevation-<level>`), set by the
|
|
788
|
+
* personality's `elevation`. `WebsiteEdgeTokens` — the weight of the site's lines (`--website-edges-<token>`), set by
|
|
789
|
+
* `edgeWeight`. `WebsiteLayoutTokens` — widths (`--website-layout-<token>`): the page container and the reading
|
|
790
|
+
* measures.
|
|
791
|
+
*/
|
|
792
|
+
const _WebsiteElevationTokensSchema = z.object({
|
|
793
|
+
/** A card at rest that wants a little depth, a framed visual. `none` on a flat personality. */
|
|
794
|
+
soft: cssSafeValue('soft elevation'),
|
|
795
|
+
/** The lifted surface: a hovered card, the hero's product window, a featured plan. */
|
|
796
|
+
lift: cssSafeValue('lift elevation'),
|
|
797
|
+
});
|
|
798
|
+
|
|
799
|
+
export const WebsiteElevationTokensSchema: typeof _WebsiteElevationTokensSchema = _WebsiteElevationTokensSchema;
|
|
800
|
+
|
|
801
|
+
export type WebsiteElevationTokens = z.infer<typeof _WebsiteElevationTokensSchema>;
|
|
802
|
+
|
|
803
|
+
const _WebsiteEdgeTokensSchema = z.object({
|
|
804
|
+
/** The width of a line: a card's border, a table rule, a secondary button's outline. */
|
|
805
|
+
width: cssSafeValue('edge width'),
|
|
806
|
+
});
|
|
807
|
+
|
|
808
|
+
export const WebsiteEdgeTokensSchema: typeof _WebsiteEdgeTokensSchema = _WebsiteEdgeTokensSchema;
|
|
809
|
+
|
|
810
|
+
export type WebsiteEdgeTokens = z.infer<typeof _WebsiteEdgeTokensSchema>;
|
|
811
|
+
|
|
812
|
+
const _WebsiteLayoutTokensSchema = z.object({
|
|
813
|
+
/** The widest a section's content runs. */
|
|
814
|
+
containerMax: cssSafeValue('container max width'),
|
|
815
|
+
/** The space kept between the content and the viewport's edge on a narrow screen (each side). */
|
|
816
|
+
gutter: cssSafeValue('gutter'),
|
|
817
|
+
/** A short centred block: a 404 message, a call to action. */
|
|
818
|
+
measureNarrow: cssSafeValue('narrow measure'),
|
|
819
|
+
/** The sentence under a heading. */
|
|
820
|
+
measureLede: cssSafeValue('lede measure'),
|
|
821
|
+
/** A section intro, an article's text column. */
|
|
822
|
+
measureProse: cssSafeValue('prose measure'),
|
|
823
|
+
/** A centred heading that stands alone: a closing call to action. */
|
|
824
|
+
measureHeading: cssSafeValue('heading measure'),
|
|
825
|
+
/** A wide intro that leads a dense section. */
|
|
826
|
+
measureWide: cssSafeValue('wide measure'),
|
|
827
|
+
/** The narrowest a card may be when a grid fits as many columns as it can (`WebsiteGridFit.AUTO`). */
|
|
828
|
+
cardMin: cssSafeValue('card minimum width'),
|
|
829
|
+
});
|
|
830
|
+
|
|
831
|
+
export const WebsiteLayoutTokensSchema: typeof _WebsiteLayoutTokensSchema = _WebsiteLayoutTokensSchema;
|
|
832
|
+
|
|
833
|
+
export type WebsiteLayoutTokens = z.infer<typeof _WebsiteLayoutTokensSchema>;
|
|
834
|
+
```
|
|
835
|
+
|
|
836
|
+
## Reading a token from code
|
|
837
|
+
|
|
838
|
+
## Import Origins
|
|
839
|
+
|
|
840
|
+
- `@wildo-ai/saas-website`
|
|
841
|
+
|
|
842
|
+
## Source Excerpts
|
|
843
|
+
|
|
844
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
845
|
+
|
|
846
|
+
```typescript
|
|
847
|
+
*
|
|
848
|
+
* The CURRENT tone's colour role, `var(--website-tone-<role>)`. What every engine component paints with: inside an
|
|
849
|
+
* element carrying `data-website-tone="inverse"` it is the inverse tone's value, everywhere else the page's.
|
|
850
|
+
*
|
|
851
|
+
* @example
|
|
852
|
+
* websiteToneCssVar('mutedForeground'); // → 'var(--website-tone-mutedForeground)'
|
|
853
|
+
*/
|
|
854
|
+
export function websiteToneCssVar(role: keyof WebsiteToneTokens & string): string {
|
|
855
|
+
return `var(--website-tone-${role})`;
|
|
856
|
+
}
|
|
857
|
+
|
|
858
|
+
/** The CSS property of the current tone's role, `--website-tone-<role>`: what `data-website-tone` re-binds. */
|
|
859
|
+
export function websiteToneCssProperty(role: keyof WebsiteToneTokens & string): string {
|
|
860
|
+
return `--website-tone-${role}`;
|
|
861
|
+
}
|
|
862
|
+
|
|
863
|
+
/**
|
|
864
|
+
* One property of one type role, `var(--website-type-<role>-<property>)`.
|
|
865
|
+
*
|
|
866
|
+
* @example
|
|
867
|
+
* websiteTypeCssVar('display', 'size'); // → 'var(--website-type-display-size)'
|
|
868
|
+
*/
|
|
869
|
+
export function websiteTypeCssVar(role: keyof WebsiteTypeTokens & string, property: keyof WebsiteTypeRoleTokens & string): string {
|
|
870
|
+
return `var(${websiteDesignTokenCssProperty('type', role, property)})`;
|
|
871
|
+
}
|
|
872
|
+
/**
|
|
873
|
+
* A product colour (#2742), `var(--website-product-<path>)`, typed against `WebsiteProductTokens` so a misspelt path
|
|
874
|
+
* does not compile. Only a drawn product reads these.
|
|
875
|
+
*
|
|
876
|
+
* @example
|
|
877
|
+
* websiteProductCssVar('ink'); // → 'var(--website-product-ink)'
|
|
878
|
+
* websiteProductCssVar('status', IndicatorVariant.SUCCESS, 'foreground'); // → 'var(--website-product-status-success-foreground)'
|
|
879
|
+
* websiteProductCssVar('night', 'background');
|
|
880
|
+
* websiteProductCssVar('avatars', WebsiteProductAvatar.SECOND);
|
|
881
|
+
*/
|
|
882
|
+
export function websiteProductCssVar(
|
|
883
|
+
...path:
|
|
884
|
+
| readonly [Exclude<keyof WebsiteProductTokens, 'night' | 'status' | 'avatars' | 'series' | 'selection'>]
|
|
885
|
+
| readonly ['selection', keyof WebsiteProductTokens['selection']]
|
|
886
|
+
| readonly ['night', keyof WebsiteProductTokens['night']]
|
|
887
|
+
| readonly ['status', IndicatorVariant, keyof WebsiteProductStatusTokens]
|
|
888
|
+
| readonly ['avatars', WebsiteProductAvatar]
|
|
889
|
+
| readonly ['series', WebsiteProductSeries]
|
|
890
|
+
): string {
|
|
891
|
+
return `var(${websiteDesignTokenCssProperty('product', ...path)})`;
|
|
892
|
+
}
|
|
893
|
+
```
|