@wildo-ai/framework-knowledge 1.1.0
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/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,1212 @@
|
|
|
1
|
+
# Surface Policy API
|
|
2
|
+
|
|
3
|
+
Read this when editing `surfacePolicies` in `frontend/src/config/design-system.config.ts`
|
|
4
|
+
or adding a local `<Surface policyOverride={...}>`.
|
|
5
|
+
|
|
6
|
+
- Import `SurfaceVariant` and `DeepPartialSurfacePolicy` from
|
|
7
|
+
`@wildo-ai/presets-components-models`.
|
|
8
|
+
- Use the source contract below for accepted policy families and slot values.
|
|
9
|
+
- Prefer app-level `surfacePolicies` for app-wide behavior, and local
|
|
10
|
+
`policyOverride` for one component or one route.
|
|
11
|
+
- The defaults excerpt documents merge order and variant coverage. Do not copy
|
|
12
|
+
the default map into app code.
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/presets-components-models`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
21
|
+
|
|
22
|
+
```typescript
|
|
23
|
+
/**
|
|
24
|
+
* Semantic variants for SURFACE behavior.
|
|
25
|
+
*
|
|
26
|
+
* Import `SurfaceVariant` from `@wildo-ai/presets-components-models`.
|
|
27
|
+
* Use these enum values as keys for `theme.surface` recipe maps and
|
|
28
|
+
* `designSystemConfig.surfacePolicies`. Do not confuse this with `SurfaceLayer`,
|
|
29
|
+
* which is only the semantic background-color token family.
|
|
30
|
+
*
|
|
31
|
+
* Each variant maps to (a) a recipe of visual chrome classes (`theme.surface[variant]`)
|
|
32
|
+
* AND (b) a `SurfacePolicy` defining container-level behavior such as padding,
|
|
33
|
+
* overflow, frame ownership, landmark role, stacking, and overlay geometry.
|
|
34
|
+
*
|
|
35
|
+
* Every `ComponentStyleTheme.surface` map is strict: provide a recipe for each
|
|
36
|
+
* variant, even when the recipe is intentionally chromeless.
|
|
37
|
+
*/
|
|
38
|
+
export enum SurfaceVariant {
|
|
39
|
+
/** Default card-like surface */
|
|
40
|
+
BASE = 'base',
|
|
41
|
+
/**
|
|
42
|
+
* Content card — an explicitly-authored content grouping that ALWAYS paints
|
|
43
|
+
* its own elevated fill + border (distinct from the page background), so it
|
|
44
|
+
* reads as a card in every context, including inside a dialog or page. Unlike
|
|
45
|
+
* `BASE`/`RAISED`, a `CARD` does NOT de-duplicate its frame when nested in an
|
|
46
|
+
* already-framed ancestor: the author chose a card, so it stays a card. The
|
|
47
|
+
* fill comes from the theme's CARD recipe (the elevated `surface-raised`
|
|
48
|
+
* token by default). Material is an independent design-system axis: choosing
|
|
49
|
+
* the CARD semantic role must never implicitly force a glass material.
|
|
50
|
+
*/
|
|
51
|
+
CARD = 'card',
|
|
52
|
+
/** Higher elevation — popovers, dropdowns */
|
|
53
|
+
RAISED = 'raised',
|
|
54
|
+
/** Modal/dialog surfaces */
|
|
55
|
+
OVERLAY = 'overlay',
|
|
56
|
+
/** Recessed areas — input wells */
|
|
57
|
+
INSET = 'inset',
|
|
58
|
+
/** Navigation panels, sidebars */
|
|
59
|
+
SUNKEN = 'sunken',
|
|
60
|
+
/** Panel under a tab strip — joins seamlessly to the strip above (no top edge). */
|
|
61
|
+
TAB_PANEL = 'tab-panel',
|
|
62
|
+
/** Page content area / app surface — chromeless background; may own `<main>` semantics after app opt-in. */
|
|
63
|
+
SHELL = 'shell',
|
|
64
|
+
/** Toast, snackbar, ephemeral floating notification. */
|
|
65
|
+
TRANSIENT = 'transient',
|
|
66
|
+
}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Import Origins
|
|
70
|
+
|
|
71
|
+
- `@wildo-ai/presets-components-models`
|
|
72
|
+
|
|
73
|
+
## Source Excerpts
|
|
74
|
+
|
|
75
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
76
|
+
|
|
77
|
+
```typescript
|
|
78
|
+
/**
|
|
79
|
+
* Application-facing Surface Policy contract.
|
|
80
|
+
*
|
|
81
|
+
* Import policy types and `SurfaceVariant` from `@wildo-ai/presets-components-models`.
|
|
82
|
+
* Use `DeepPartialSurfacePolicy` for app-level `designSystemConfig.surfacePolicies`
|
|
83
|
+
* overrides and for local `<Surface policyOverride={...}>` overrides. A policy is
|
|
84
|
+
* grouped by families (`containment`, `nesting`, `a11y`, etc.) so app code can
|
|
85
|
+
* override one slot without replacing sibling behavior.
|
|
86
|
+
*
|
|
87
|
+
* `reset` means "return this slot to the framework default for the current
|
|
88
|
+
* `SurfaceVariant`". `inherit` is only available on selected slots whose
|
|
89
|
+
* behavior can safely walk up from a parent surface.
|
|
90
|
+
*/
|
|
91
|
+
/** Generic policy escape hatch for reset-capable slots. */
|
|
92
|
+
export type PolicyReset = 'reset';
|
|
93
|
+
|
|
94
|
+
// --- Family A: Containment ---------------------------------------------------
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Semantic padding tier mapping to `--sp-*` tokens.
|
|
98
|
+
*
|
|
99
|
+
* `'none'` → no padding (recipe / consumer owns it)
|
|
100
|
+
* `'field'`, `'card-sm'`, `'card'`, `'container'` → corresponding `--sp-*` token
|
|
101
|
+
*/
|
|
102
|
+
export type ContainmentPaddingTier = 'none' | 'field' | 'card-sm' | 'card' | 'container';
|
|
103
|
+
|
|
104
|
+
export type OverflowStrategy = 'visible' | 'clip' | 'auto' | 'scroll';
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Semantic gap tier — applies to flex/grid container of `Surface.Body`'s direct
|
|
108
|
+
* children. Maps to `--sp-*` tokens.
|
|
109
|
+
*/
|
|
110
|
+
export type GapTier = 'none' | 'item' | 'field' | 'section' | 'lane';
|
|
111
|
+
|
|
112
|
+
type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
|
|
113
|
+
type NonZeroDigit = Exclude<Digit, '0'>;
|
|
114
|
+
type CssLengthUnit =
|
|
115
|
+
| 'px'
|
|
116
|
+
| 'rem'
|
|
117
|
+
| 'em'
|
|
118
|
+
| 'ch'
|
|
119
|
+
| 'ex'
|
|
120
|
+
| 'lh'
|
|
121
|
+
| 'rlh'
|
|
122
|
+
| 'vw'
|
|
123
|
+
| 'vh'
|
|
124
|
+
| 'vmin'
|
|
125
|
+
| 'vmax'
|
|
126
|
+
| 'svw'
|
|
127
|
+
| 'svh'
|
|
128
|
+
| 'lvw'
|
|
129
|
+
| 'lvh'
|
|
130
|
+
| 'dvw'
|
|
131
|
+
| 'dvh'
|
|
132
|
+
| '%'
|
|
133
|
+
| 'cqw'
|
|
134
|
+
| 'cqh'
|
|
135
|
+
| 'cqi'
|
|
136
|
+
| 'cqb'
|
|
137
|
+
| 'cqmin'
|
|
138
|
+
| 'cqmax';
|
|
139
|
+
type CssMaxHeightKeyword =
|
|
140
|
+
| 'inherit'
|
|
141
|
+
| 'initial'
|
|
142
|
+
| 'revert'
|
|
143
|
+
| 'revert-layer'
|
|
144
|
+
| 'unset'
|
|
145
|
+
| 'min-content'
|
|
146
|
+
| 'max-content'
|
|
147
|
+
| 'fit-content';
|
|
148
|
+
type CssSizingFunction = 'var' | 'calc' | 'clamp' | 'min' | 'max' | 'fit-content';
|
|
149
|
+
type CssNonNegativeNumber = `${Digit}${string}` | `.${Digit}${string}`;
|
|
150
|
+
export type CssMaxHeightValue =
|
|
151
|
+
| 'none'
|
|
152
|
+
| CssMaxHeightKeyword
|
|
153
|
+
| '0'
|
|
154
|
+
| `${CssNonNegativeNumber}${CssLengthUnit}`
|
|
155
|
+
| `${CssSizingFunction}(${string})`;
|
|
156
|
+
type PositiveLineClamp =
|
|
157
|
+
| `${NonZeroDigit}`
|
|
158
|
+
| `${NonZeroDigit}${Digit}`
|
|
159
|
+
| `${NonZeroDigit}${Digit}${Digit}`
|
|
160
|
+
| `${NonZeroDigit}${Digit}${Digit}${Digit}`;
|
|
161
|
+
|
|
162
|
+
export interface ContainmentPolicy {
|
|
163
|
+
/** Inner Y-axis padding tier (semantic, maps to `--sp-*`). */
|
|
164
|
+
paddingBlock?: ContainmentPaddingTier | PolicyReset;
|
|
165
|
+
/**
|
|
166
|
+
* Inner X-axis padding tier — separate from Y because `Card` today uses
|
|
167
|
+
* `py-card` (Y) on root + `px-card` per slot, and `Surface.Header/Body/Footer`
|
|
168
|
+
* often need different inline padding from their parent.
|
|
169
|
+
*/
|
|
170
|
+
paddingInline?: ContainmentPaddingTier | PolicyReset;
|
|
171
|
+
/** Overflow strategy on the surface root. */
|
|
172
|
+
overflow?: OverflowStrategy | PolicyReset;
|
|
173
|
+
/** Max-height as a validated CSS sizing value (e.g. `'90vh'`, `'60vh'`) or `'none'`. */
|
|
174
|
+
maxHeight?: CssMaxHeightValue | PolicyReset;
|
|
175
|
+
/** Gap when surface body is a flex/stack container. */
|
|
176
|
+
gap?: GapTier | PolicyReset;
|
|
177
|
+
/**
|
|
178
|
+
* Per-slot override of `gap` for `Surface.Header` / `Surface.Body` /
|
|
179
|
+
* `Surface.Footer` (Dialog needs `gap-element` in Header but `gap-field` in
|
|
180
|
+
* root, etc.).
|
|
181
|
+
*/
|
|
182
|
+
slotGap?: Partial<{ header: GapTier | PolicyReset; body: GapTier | PolicyReset; footer: GapTier | PolicyReset }>;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
// --- Family B: Nesting -------------------------------------------------------
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* Whether this surface should render its visual frame (border/shadow).
|
|
189
|
+
*
|
|
190
|
+
* `'always'`: always render the frame.
|
|
191
|
+
* `'when-orphan'`: render the frame only when no ancestor surface is itself
|
|
192
|
+
* framed — replaces `last:border-b-0` patches and double-border bugs.
|
|
193
|
+
* Resolved from derived frame ancestry state.
|
|
194
|
+
* `'never'`: never render the frame (chromaless surfaces — SHELL, TAB_PANEL).
|
|
195
|
+
*/
|
|
196
|
+
export type FramingMode = 'always' | 'when-orphan' | 'never';
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* How nested surface corners scale relative to their parent's radius.
|
|
200
|
+
*
|
|
201
|
+
* `'inherit'`: child uses parent's resolved radius value.
|
|
202
|
+
* `'one-tier-tighter'`: child auto-shrinks one step on the radius scale (matches
|
|
203
|
+
* most material/shadcn conventions; concentric corners).
|
|
204
|
+
* `'fixed'`: child uses its own variant's radius regardless of parent
|
|
205
|
+
* (Brutalist/Trading where radius is constant or 0).
|
|
206
|
+
*/
|
|
207
|
+
export type NestedRadiusStrategy = 'inherit' | 'one-tier-tighter' | 'fixed';
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* When this surface sits at its parent's edge, drop the duplicate edge.
|
|
211
|
+
*
|
|
212
|
+
* `'collapse'`: remove the duplicate edge (e.g. child's top border collapses
|
|
213
|
+
* into parent's top border).
|
|
214
|
+
* `'preserve'`: keep both edges (gap/separator handles the visual).
|
|
215
|
+
*/
|
|
216
|
+
export type FirstChildEdgeStrategy = 'collapse' | 'preserve';
|
|
217
|
+
|
|
218
|
+
/**
|
|
219
|
+
* How repeated children of this surface visually separate themselves.
|
|
220
|
+
* Replaces ad-hoc `last:border-b-0` / `[&_tr:last-child]:border-0` patches.
|
|
221
|
+
*/
|
|
222
|
+
export type DividerStrategy = 'border' | 'gap' | 'rule' | 'none';
|
|
223
|
+
|
|
224
|
+
export interface NestingPolicy {
|
|
225
|
+
framingMode?: FramingMode | PolicyReset;
|
|
226
|
+
nestedRadiusStrategy?: NestedRadiusStrategy | PolicyReset;
|
|
227
|
+
firstChildEdgeStrategy?: FirstChildEdgeStrategy | PolicyReset;
|
|
228
|
+
dividerStrategy?: DividerStrategy | PolicyReset;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
// --- Family C: Content -------------------------------------------------------
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* How long text inside this surface should clip.
|
|
235
|
+
*
|
|
236
|
+
* `'ellipsis-multiline:N'` is parameterized — pick a positive integer from
|
|
237
|
+
* 1 through 9999 (e.g. `'ellipsis-multiline:2'` for 2-line truncate). The
|
|
238
|
+
* generated CSS / `<Text>` consumer maps the parameter to
|
|
239
|
+
* `-webkit-line-clamp: N`.
|
|
240
|
+
*/
|
|
241
|
+
export type TextTruncationStrategy =
|
|
242
|
+
| 'none'
|
|
243
|
+
| 'ellipsis-line'
|
|
244
|
+
| `ellipsis-multiline:${PositiveLineClamp}`
|
|
245
|
+
| 'fade'
|
|
246
|
+
| 'inherit';
|
|
247
|
+
|
|
248
|
+
/** CSS `text-wrap` strategy. */
|
|
249
|
+
export type WrapStrategy = 'wrap' | 'nowrap' | 'balance' | 'pretty' | 'inherit';
|
|
250
|
+
|
|
251
|
+
/** `font-variant-numeric` — for tables/dashboards of numbers. */
|
|
252
|
+
export type NumericAlignment = 'inherit' | 'tabular' | 'lining';
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* Behavior when an INDIVIDUAL TOKEN (a single word, URL, file path, hex
|
|
256
|
+
* hash, dev-time i18n key, …) is wider than the surface it lives in.
|
|
257
|
+
*
|
|
258
|
+
* This is a DIFFERENT problem from `textTruncation` / `wrapStrategy`:
|
|
259
|
+
*
|
|
260
|
+
* - `wrapStrategy: 'wrap'` (CSS `text-wrap: wrap`) breaks text ONLY at
|
|
261
|
+
* natural word boundaries (spaces, hyphens). An unbreakable token has
|
|
262
|
+
* no boundary, so the browser lets it overflow the container.
|
|
263
|
+
* - `textTruncation: 'ellipsis-line'` / `'ellipsis-multiline:N'` clip
|
|
264
|
+
* text that exceeds N lines — but they require `overflow: hidden` on
|
|
265
|
+
* the container and assume the line itself FITS. A token wider than
|
|
266
|
+
* the container can't even produce one valid line to truncate.
|
|
267
|
+
* - `overlongTokenStrategy` covers the residual case: what to do when
|
|
268
|
+
* a SINGLE TOKEN can't fit. Three real options:
|
|
269
|
+
* - `'break-word'` — CSS `overflow-wrap: break-word`. Lets the
|
|
270
|
+
* browser break at character boundaries ONLY when a token would
|
|
271
|
+
* otherwise overflow, exactly like `'break-anywhere'` at render
|
|
272
|
+
* time — but soft-wrap opportunities are NOT considered when
|
|
273
|
+
* computing intrinsic (min-content) sizes. This is the framework
|
|
274
|
+
* default: it protects against URLs, dev-time i18n keys, file
|
|
275
|
+
* paths and hex strings WITHOUT shrinking a flex/grid item's
|
|
276
|
+
* min-content width to a single character.
|
|
277
|
+
* - `'break-anywhere'` — CSS `overflow-wrap: anywhere`. Same
|
|
278
|
+
* emergency character-boundary breaking, but the break
|
|
279
|
+
* opportunities ALSO feed min-content sizing: any surface under
|
|
280
|
+
* this value reports a one-character min-content width, so
|
|
281
|
+
* intrinsically-sized layouts (stat tiles, grid `auto` tracks,
|
|
282
|
+
* `min-width: min-content` flex items) collapse and render one
|
|
283
|
+
* letter per line. An earlier revision made this the default on
|
|
284
|
+
* the reasoning that "normal text is unaffected" — true for
|
|
285
|
+
* OVERFLOW behavior, false for INTRINSIC SIZING, which is why
|
|
286
|
+
* the default moved to `'break-word'`. Opt in per-surface only
|
|
287
|
+
* when unbroken user-generated strings must never dictate the
|
|
288
|
+
* measured width of an intrinsically-sized container.
|
|
289
|
+
* - `'overflow'` — CSS `overflow-wrap: normal`. The browser-default
|
|
290
|
+
* behavior: long tokens visibly overflow the container. Useful
|
|
291
|
+
* when the surface intentionally allows horizontal overflow
|
|
292
|
+
* (e.g., a code block that scrolls) or when the design
|
|
293
|
+
* specifically calls for the overflow to be visible.
|
|
294
|
+
*
|
|
295
|
+
* Default is `'break-word'` for every variant — same wrapping outcome
|
|
296
|
+
* as `'break-anywhere'` where a token genuinely overflows, with no
|
|
297
|
+
* min-content collapse. Surfaces opt into the other behaviors
|
|
298
|
+
* explicitly via `policyOverride={{ content: { overlongTokenStrategy:
|
|
299
|
+
* 'break-anywhere' | 'overflow' } }}`.
|
|
300
|
+
*/
|
|
301
|
+
/**
|
|
302
|
+
* The named runtime source for the overlong-token vocabulary (see the JSDoc above for the full
|
|
303
|
+
* per-member semantics and the min-content-collapse history that fixed the default).
|
|
304
|
+
*
|
|
305
|
+
* A const object rather than a TypeScript enum, deliberately: surface authoring writes these as
|
|
306
|
+
* plain string literals throughout the preset layer (`policyOverride={{ content: {
|
|
307
|
+
* overlongTokenStrategy: 'break-anywhere' } }}`), and a nominal enum would refuse every one of
|
|
308
|
+
* those call sites. The derived type below keeps the union structural while this object gives the
|
|
309
|
+
* vocabulary one named home.
|
|
310
|
+
*/
|
|
311
|
+
export const OverlongTokenStrategy = {
|
|
312
|
+
/** CSS `overflow-wrap: break-word` — emergency breaking without min-content collapse. The default. */
|
|
313
|
+
BREAK_WORD: 'break-word',
|
|
314
|
+
/** CSS `overflow-wrap: anywhere` — also feeds min-content sizing; opt-in per surface only. */
|
|
315
|
+
BREAK_ANYWHERE: 'break-anywhere',
|
|
316
|
+
/** CSS `overflow-wrap: normal` — long tokens visibly overflow (scrolling code blocks etc.). */
|
|
317
|
+
OVERFLOW: 'overflow',
|
|
318
|
+
/** Inherit the surrounding surface's strategy. */
|
|
319
|
+
INHERIT: 'inherit',
|
|
320
|
+
} as const;
|
|
321
|
+
|
|
322
|
+
export type OverlongTokenStrategy = (typeof OverlongTokenStrategy)[keyof typeof OverlongTokenStrategy];
|
|
323
|
+
|
|
324
|
+
export interface ContentPolicy {
|
|
325
|
+
textTruncation?: TextTruncationStrategy | PolicyReset;
|
|
326
|
+
wrapStrategy?: WrapStrategy | PolicyReset;
|
|
327
|
+
numericAlignment?: NumericAlignment | PolicyReset;
|
|
328
|
+
/** Auto-wire `TruncatedText` semantics so truncated text shows full value on hover. */
|
|
329
|
+
tooltipOnTruncate?: boolean | PolicyReset;
|
|
330
|
+
/**
|
|
331
|
+
* Safety net for unbreakable tokens wider than the surface (URLs,
|
|
332
|
+
* dev-time i18n keys, file paths, hex strings). Default
|
|
333
|
+
* `'break-word'` (emergency breaking without min-content collapse).
|
|
334
|
+
* See `OverlongTokenStrategy` JSDoc for the relationship with
|
|
335
|
+
* `wrapStrategy` and `textTruncation`, and for when
|
|
336
|
+
* `'break-anywhere'` is the right opt-in.
|
|
337
|
+
*/
|
|
338
|
+
overlongTokenStrategy?: OverlongTokenStrategy | PolicyReset;
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
// --- Family D: Auto-render ---------------------------------------------------
|
|
342
|
+
|
|
343
|
+
export type AutoFieldChromeMode = 'stacked' | 'inline' | 'compact' | 'inherit';
|
|
344
|
+
/**
|
|
345
|
+
* Field label placement. `start` is logical inline-start and follows document
|
|
346
|
+
* direction.
|
|
347
|
+
*/
|
|
348
|
+
export type AutoLabelPlacement = 'top' | 'start' | 'inline' | 'hidden';
|
|
349
|
+
export type AutoEmptyValue = 'em-dash' | 'placeholder' | 'hidden' | 'skeleton';
|
|
350
|
+
/**
|
|
351
|
+
* How a `ContentSectionContainer` frames each authored section.
|
|
352
|
+
* - `grouped` (modern default): eyebrow-labelled groups inside ONE surface,
|
|
353
|
+
* separated by `divide-y` — no bordered card per section. Applies to the
|
|
354
|
+
* stacked (inline / single-section) composition; other container modes
|
|
355
|
+
* (grid / tabs / …) treat it as `card-each`.
|
|
356
|
+
* - `card-each`: a bordered card per section.
|
|
357
|
+
* - `flat`: bare sections, no frame.
|
|
358
|
+
* - `separator-only`: bare sections with a bottom divider between them.
|
|
359
|
+
*/
|
|
360
|
+
export type AutoSectionWrap = 'grouped' | 'card-each' | 'flat' | 'separator-only';
|
|
361
|
+
export type AutoFieldDensity = 'sm' | 'md' | 'inherit';
|
|
362
|
+
/** Where field validation errors render. */
|
|
363
|
+
export type AutoErrorPlacement =
|
|
364
|
+
| 'inline'
|
|
365
|
+
| 'summary-at-surface-top'
|
|
366
|
+
| 'inherit';
|
|
367
|
+
|
|
368
|
+
export interface AutoRenderPolicy {
|
|
369
|
+
autoFieldChrome?: AutoFieldChromeMode | PolicyReset;
|
|
370
|
+
autoLabelPlacement?: AutoLabelPlacement | PolicyReset;
|
|
371
|
+
autoEmptyValue?: AutoEmptyValue | PolicyReset;
|
|
372
|
+
autoSectionWrap?: AutoSectionWrap | PolicyReset;
|
|
373
|
+
autoFieldDensity?: AutoFieldDensity | PolicyReset;
|
|
374
|
+
autoErrorPlacement?: AutoErrorPlacement | PolicyReset;
|
|
375
|
+
}
|
|
376
|
+
|
|
377
|
+
// --- Family E: Interactive state --------------------------------------------
|
|
378
|
+
|
|
379
|
+
export type SelectableSemantics = 'wrap-children' | 'self-selectable' | 'forbidden';
|
|
380
|
+
export type GestureOptIn = 'self' | 'children' | 'none';
|
|
381
|
+
export type LoadingDisplayMode = 'overlay' | 'skeleton-children' | 'spinner-only' | 'inherit';
|
|
382
|
+
export type EmptyDisplayMode = 'collapse' | 'placeholder' | 'hide' | 'render-children';
|
|
383
|
+
export type ErrorBoundaryMode = 'self' | 'inherit';
|
|
384
|
+
|
|
385
|
+
export interface InteractiveStatePolicy {
|
|
386
|
+
selectableSemantics?: SelectableSemantics | PolicyReset;
|
|
387
|
+
gestureOptIn?: GestureOptIn | PolicyReset;
|
|
388
|
+
loadingDisplay?: LoadingDisplayMode | PolicyReset;
|
|
389
|
+
emptyDisplay?: EmptyDisplayMode | PolicyReset;
|
|
390
|
+
errorBoundary?: ErrorBoundaryMode | PolicyReset;
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
// --- Family F: A11y ----------------------------------------------------------
|
|
394
|
+
|
|
395
|
+
export type LandmarkRole =
|
|
396
|
+
| 'region'
|
|
397
|
+
| 'complementary'
|
|
398
|
+
| 'navigation'
|
|
399
|
+
| 'main'
|
|
400
|
+
| 'dialog'
|
|
401
|
+
| 'alertdialog'
|
|
402
|
+
| 'status'
|
|
403
|
+
| 'none';
|
|
404
|
+
|
|
405
|
+
export type LabelStrategy = 'from-header' | 'aria-label' | 'none';
|
|
406
|
+
export type FocusTrapMode = 'on-mount' | 'never' | 'when-modal';
|
|
407
|
+
export type ScrollContainmentMode = 'lock-body' | 'none';
|
|
408
|
+
|
|
409
|
+
export interface A11yPolicy {
|
|
410
|
+
/**
|
|
411
|
+
* Auto-applied `role` if no `role` prop supplied.
|
|
412
|
+
*
|
|
413
|
+
* `SurfaceVariant.SHELL` defaults to `'none'` so framework upgrades do not
|
|
414
|
+
* create duplicate page landmarks. Apps that want the shell to own the page
|
|
415
|
+
* landmark opt in with `surfacePolicies[SurfaceVariant.SHELL].a11y.landmarkRole = 'main'`.
|
|
416
|
+
*/
|
|
417
|
+
landmarkRole?: LandmarkRole | PolicyReset;
|
|
418
|
+
/**
|
|
419
|
+
* Surface auto-derives `aria-labelledby` from `<Surface.Header>` slot.
|
|
420
|
+
* Fallback when `'from-header'` and no Header is present: → use explicit
|
|
421
|
+
* `aria-label` prop if provided → no labelling at all + development warning.
|
|
422
|
+
*/
|
|
423
|
+
labelStrategy?: LabelStrategy | PolicyReset;
|
|
424
|
+
focusTrap?: FocusTrapMode | PolicyReset;
|
|
425
|
+
scrollContainment?: ScrollContainmentMode | PolicyReset;
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
// --- Family G: Geometry / responsive -----------------------------------------
|
|
429
|
+
|
|
430
|
+
/**
|
|
431
|
+
* Maximum inline-size a surface may occupy on viewports ≥ 640px (below that,
|
|
432
|
+
* surfaces are always full-width). Component-scale tiers (`sm`–`xl`) suit
|
|
433
|
+
* dialogs and forms; `centered-readable` (72ch) suits prose columns; `content`
|
|
434
|
+
* is the page-content cap for primary content areas (defaults to 80rem ≈ 1280px;
|
|
435
|
+
* retune by setting the `--content-max-width` CSS variable, or `full`/`none` to
|
|
436
|
+
* disable). When a finite tier is set the surface is also centered in its
|
|
437
|
+
* container (`margin-inline: auto`).
|
|
438
|
+
*/
|
|
439
|
+
export type ResponsiveMaxWidth =
|
|
440
|
+
| 'full'
|
|
441
|
+
| 'sm'
|
|
442
|
+
| 'md'
|
|
443
|
+
| 'lg'
|
|
444
|
+
| 'xl'
|
|
445
|
+
// Reading-measure cap (~42rem) for single-column FORM / field stacks (T4c),
|
|
446
|
+
// so detail/settings forms stop stretching edge-to-edge inside a wide content
|
|
447
|
+
// zone. Wider than the component tiers (`sm`–`xl`, dialog-scale) but far tighter
|
|
448
|
+
// than `content`/`centered-readable`. Retune via `--measure-max-width`.
|
|
449
|
+
| 'measure'
|
|
450
|
+
| 'centered-readable'
|
|
451
|
+
| 'content'
|
|
452
|
+
| 'none';
|
|
453
|
+
|
|
454
|
+
export type MobileShape = 'inline' | 'drawer' | 'sheet';
|
|
455
|
+
|
|
456
|
+
export type ActionAlignment = 'row' | 'column-reverse-on-mobile' | 'stack' | 'inherit';
|
|
457
|
+
|
|
458
|
+
export interface GeometryPolicy {
|
|
459
|
+
responsiveMaxWidth?: ResponsiveMaxWidth | PolicyReset;
|
|
460
|
+
mobileShape?: MobileShape | PolicyReset;
|
|
461
|
+
/** Apply iOS safe-area / Android nav-bar padding to fixed-edge surfaces. */
|
|
462
|
+
safeAreaPadding?: boolean | PolicyReset;
|
|
463
|
+
actionAlignment?: ActionAlignment | PolicyReset;
|
|
464
|
+
}
|
|
465
|
+
|
|
466
|
+
// --- Family H: Stacking / portal ---------------------------------------------
|
|
467
|
+
|
|
468
|
+
/**
|
|
469
|
+
* Maps to the public `--z-*` token ladder.
|
|
470
|
+
* Replaces `z-50` literals + `z-[10000]` magic numbers.
|
|
471
|
+
*
|
|
472
|
+
* `'content'` → `--z-content` (alias of `--z-base`)
|
|
473
|
+
* `'overlay'` → `--z-overlay`
|
|
474
|
+
* `'transient'` → `--z-transient` (alias of `--z-toast`)
|
|
475
|
+
* `'guidance'` → `--z-guidance` (sits above transient and below critical)
|
|
476
|
+
* `'critical'` → `--z-critical` (alias of `--z-tooltip`)
|
|
477
|
+
*
|
|
478
|
+
* Token ladder ordering: content < overlay < transient < guidance < critical.
|
|
479
|
+
*/
|
|
480
|
+
export type StackingTier = 'content' | 'overlay' | 'transient' | 'guidance' | 'critical';
|
|
481
|
+
|
|
482
|
+
/**
|
|
483
|
+
* Named portal target consumed by framework overlay primitives.
|
|
484
|
+
*
|
|
485
|
+
* `'inline'`: render in place (no portal).
|
|
486
|
+
* `'app-portal'`: the app's default portal target.
|
|
487
|
+
* `custom-id`: a lowercase kebab-case custom portal id that starts with a
|
|
488
|
+
* letter, such as `resource-overlay-root`. The runtime validator enforces the
|
|
489
|
+
* full `/^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/` shape.
|
|
490
|
+
*/
|
|
491
|
+
type LowercaseAsciiLetter =
|
|
492
|
+
| 'a'
|
|
493
|
+
| 'b'
|
|
494
|
+
| 'c'
|
|
495
|
+
| 'd'
|
|
496
|
+
| 'e'
|
|
497
|
+
| 'f'
|
|
498
|
+
| 'g'
|
|
499
|
+
| 'h'
|
|
500
|
+
| 'i'
|
|
501
|
+
| 'j'
|
|
502
|
+
| 'k'
|
|
503
|
+
| 'l'
|
|
504
|
+
| 'm'
|
|
505
|
+
| 'n'
|
|
506
|
+
| 'o'
|
|
507
|
+
| 'p'
|
|
508
|
+
| 'q'
|
|
509
|
+
| 'r'
|
|
510
|
+
| 's'
|
|
511
|
+
| 't'
|
|
512
|
+
| 'u'
|
|
513
|
+
| 'v'
|
|
514
|
+
| 'w'
|
|
515
|
+
| 'x'
|
|
516
|
+
| 'y'
|
|
517
|
+
| 'z';
|
|
518
|
+
// Keep the authoring type intentionally light: full kebab-case validation lives
|
|
519
|
+
// in `isPortalTargetValue`, where parsed app configs are checked at runtime.
|
|
520
|
+
export type CustomPortalTarget = `${LowercaseAsciiLetter}${string}-${string}`;
|
|
521
|
+
export type PortalTarget = 'inline' | 'app-portal' | CustomPortalTarget;
|
|
522
|
+
|
|
523
|
+
export interface StackingPolicy {
|
|
524
|
+
stackingTier?: StackingTier | PolicyReset;
|
|
525
|
+
portalTarget?: PortalTarget | PolicyReset;
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
// --- Family I: Skeleton / loading shape -------------------------------------
|
|
529
|
+
|
|
530
|
+
export type SkeletonTemplate = 'list' | 'detail' | 'table' | 'card' | 'inherit' | 'none';
|
|
531
|
+
export type SkeletonDensity = 'sm' | 'md' | 'lg' | 'inherit';
|
|
532
|
+
|
|
533
|
+
export interface SkeletonPolicy {
|
|
534
|
+
skeletonTemplate?: SkeletonTemplate | PolicyReset;
|
|
535
|
+
/** Skeleton row size — can inherit from the nearest parent surface. */
|
|
536
|
+
skeletonDensity?: SkeletonDensity | PolicyReset;
|
|
537
|
+
}
|
|
538
|
+
|
|
539
|
+
// --- Family J: Composition awareness -----------------------------------------
|
|
540
|
+
|
|
541
|
+
export type EmbeddedTablePadding = 'strip' | 'preserve';
|
|
542
|
+
|
|
543
|
+
export interface CompositionPolicy {
|
|
544
|
+
/** Surface auto-tightens spacing when it contains a Table or DataGrid. */
|
|
545
|
+
childAdaptiveDensity?: boolean | PolicyReset;
|
|
546
|
+
/**
|
|
547
|
+
* Card-with-Table drops its own padding-inline so table can go edge-to-edge.
|
|
548
|
+
*
|
|
549
|
+
* `'strip'`: drop the inline padding.
|
|
550
|
+
* `'preserve'`: keep the inline padding (table sits inside the card box).
|
|
551
|
+
*/
|
|
552
|
+
embeddedTablePadding?: EmbeddedTablePadding | PolicyReset;
|
|
553
|
+
/**
|
|
554
|
+
* Apply `[&:has([role=checkbox])]:pe-0` style behavior to first cell —
|
|
555
|
+
* declarative replacement for the `:has()` Tailwind utility currently
|
|
556
|
+
* used in `field.tsx`/`table.tsx`.
|
|
557
|
+
*
|
|
558
|
+
* `'inherit'`: nested tables share the "first cell is checkbox" assumption.
|
|
559
|
+
*/
|
|
560
|
+
selectionColumnAware?: boolean | 'inherit' | PolicyReset;
|
|
561
|
+
}
|
|
562
|
+
|
|
563
|
+
// =============================================================================
|
|
564
|
+
// SurfacePolicy + DeepPartial
|
|
565
|
+
// =============================================================================
|
|
566
|
+
|
|
567
|
+
/**
|
|
568
|
+
* Container-level policy for a `SurfaceVariant`. Ten sparse sub-objects
|
|
569
|
+
* ("families") separate concerns so an app can override one slot of one family
|
|
570
|
+
* without touching siblings.
|
|
571
|
+
*/
|
|
572
|
+
export interface SurfacePolicy {
|
|
573
|
+
containment?: ContainmentPolicy;
|
|
574
|
+
nesting?: NestingPolicy;
|
|
575
|
+
content?: ContentPolicy;
|
|
576
|
+
autoRender?: AutoRenderPolicy;
|
|
577
|
+
interactiveState?: InteractiveStatePolicy;
|
|
578
|
+
a11y?: A11yPolicy;
|
|
579
|
+
geometry?: GeometryPolicy;
|
|
580
|
+
stacking?: StackingPolicy;
|
|
581
|
+
skeleton?: SkeletonPolicy;
|
|
582
|
+
composition?: CompositionPolicy;
|
|
583
|
+
}
|
|
584
|
+
|
|
585
|
+
/**
|
|
586
|
+
* Per-family partial used for `designSystemConfig.surfacePolicies` overrides
|
|
587
|
+
* and for `<Surface policyOverride>`.
|
|
588
|
+
*
|
|
589
|
+
* Each policy family object is itself partial. Omitted families and omitted
|
|
590
|
+
* slots leave lower-precedence values in place. If a slot key is present with
|
|
591
|
+
* `undefined`, merge helpers treat that as an explicit clear for that leaf.
|
|
592
|
+
*/
|
|
593
|
+
export type DeepPartialSurfacePolicy = {
|
|
594
|
+
[K in keyof SurfacePolicy]?: SurfacePolicy[K] extends infer Sub
|
|
595
|
+
? Sub extends object
|
|
596
|
+
? { [P in keyof Sub]?: Sub[P] }
|
|
597
|
+
: Sub
|
|
598
|
+
: never;
|
|
599
|
+
};
|
|
600
|
+
```
|
|
601
|
+
|
|
602
|
+
## Import Origins
|
|
603
|
+
|
|
604
|
+
- `@wildo-ai/presets-components-models`
|
|
605
|
+
|
|
606
|
+
## Source Excerpts
|
|
607
|
+
|
|
608
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
609
|
+
|
|
610
|
+
```typescript
|
|
611
|
+
/**
|
|
612
|
+
* Framework default Surface Policy values and merge ladder.
|
|
613
|
+
*
|
|
614
|
+
* Import `FRAMEWORK_DEFAULT_SURFACE_POLICIES` from
|
|
615
|
+
* `@wildo-ai/presets-components-models` when tooling needs to inspect concrete
|
|
616
|
+
* per-variant defaults. App authors usually do not copy this map; they override
|
|
617
|
+
* specific slots via `designSystemConfig.surfacePolicies` or local
|
|
618
|
+
* `<Surface policyOverride={...}>`.
|
|
619
|
+
*
|
|
620
|
+
* Runtime merge order:
|
|
621
|
+
* 1. framework default,
|
|
622
|
+
* 2. theme recipe policy,
|
|
623
|
+
* 3. app design-system `surfacePolicies`,
|
|
624
|
+
* 4. local `<Surface policyOverride>`.
|
|
625
|
+
*/
|
|
626
|
+
const BASE_DEFAULT_POLICY: SurfacePolicy = {
|
|
627
|
+
containment: {
|
|
628
|
+
paddingBlock: 'card',
|
|
629
|
+
paddingInline: 'none',
|
|
630
|
+
overflow: 'visible',
|
|
631
|
+
maxHeight: 'none',
|
|
632
|
+
gap: 'section',
|
|
633
|
+
},
|
|
634
|
+
nesting: {
|
|
635
|
+
framingMode: 'always',
|
|
636
|
+
nestedRadiusStrategy: 'one-tier-tighter',
|
|
637
|
+
firstChildEdgeStrategy: 'collapse',
|
|
638
|
+
dividerStrategy: 'gap',
|
|
639
|
+
},
|
|
640
|
+
content: {
|
|
641
|
+
textTruncation: 'none',
|
|
642
|
+
wrapStrategy: 'wrap',
|
|
643
|
+
numericAlignment: 'inherit',
|
|
644
|
+
tooltipOnTruncate: false,
|
|
645
|
+
overlongTokenStrategy: 'break-word',
|
|
646
|
+
},
|
|
647
|
+
autoRender: {
|
|
648
|
+
autoFieldChrome: 'stacked',
|
|
649
|
+
autoLabelPlacement: 'top',
|
|
650
|
+
autoEmptyValue: 'em-dash',
|
|
651
|
+
// Modern default (T3): authored sections render as eyebrow-labelled groups
|
|
652
|
+
// inside ONE surface with divide-y separators, instead of a bordered card
|
|
653
|
+
// per section (`card-each`). Surfaces that genuinely want a card per section
|
|
654
|
+
// opt back in via `surfacePolicies[variant].autoRender.autoSectionWrap`.
|
|
655
|
+
autoSectionWrap: 'grouped',
|
|
656
|
+
autoFieldDensity: 'md',
|
|
657
|
+
autoErrorPlacement: 'inline',
|
|
658
|
+
},
|
|
659
|
+
interactiveState: {
|
|
660
|
+
selectableSemantics: 'wrap-children',
|
|
661
|
+
gestureOptIn: 'self',
|
|
662
|
+
loadingDisplay: 'skeleton-children',
|
|
663
|
+
emptyDisplay: 'placeholder',
|
|
664
|
+
errorBoundary: 'inherit',
|
|
665
|
+
},
|
|
666
|
+
a11y: {
|
|
667
|
+
// BASE `landmarkRole` defaults to `'none'`. BASE is the engine's generic
|
|
668
|
+
// visual container — used by Card, ContentSectionContainer, Accordion,
|
|
669
|
+
// Alert, danger-zone, file-upload panels, AI artifact viewers, and many
|
|
670
|
+
// other compositions. The vast majority of these are presentational
|
|
671
|
+
// chrome, not semantic content regions, and the framework should not
|
|
672
|
+
// auto-promote them to landmarks.
|
|
673
|
+
//
|
|
674
|
+
// Per WAI-ARIA best practice and the engine's "keep landmark ownership
|
|
675
|
+
// explicit" design rule, authors opt INTO a region landmark when the
|
|
676
|
+
// surface actually represents a meaningful navigable content section,
|
|
677
|
+
// and they also provide a header (or `aria-label`) so the landmark
|
|
678
|
+
// resolves a label:
|
|
679
|
+
//
|
|
680
|
+
// <Card policyOverride={{ a11y: { landmarkRole: 'region' } }}>
|
|
681
|
+
// <CardHeader><CardTitle>...</CardTitle></CardHeader>
|
|
682
|
+
// ...
|
|
683
|
+
// </Card>
|
|
684
|
+
//
|
|
685
|
+
// Before this change, BASE defaulted to `'region'` + `labelStrategy:
|
|
686
|
+
// 'from-header'`, which produced an unlabelled `role="region"` (a real
|
|
687
|
+
// a11y bug — regions MUST have a label per ARIA) on every Card without
|
|
688
|
+
// an explicit `<CardHeader>`. The framework dev warning surfaced this
|
|
689
|
+
// but did not auto-correct, so the broken landmark shipped to prod.
|
|
690
|
+
landmarkRole: 'none',
|
|
691
|
+
labelStrategy: 'from-header',
|
|
692
|
+
focusTrap: 'never',
|
|
693
|
+
scrollContainment: 'none',
|
|
694
|
+
},
|
|
695
|
+
geometry: {
|
|
696
|
+
responsiveMaxWidth: 'none',
|
|
697
|
+
mobileShape: 'inline',
|
|
698
|
+
safeAreaPadding: false,
|
|
699
|
+
actionAlignment: 'row',
|
|
700
|
+
},
|
|
701
|
+
stacking: {
|
|
702
|
+
stackingTier: 'content',
|
|
703
|
+
portalTarget: 'inline',
|
|
704
|
+
},
|
|
705
|
+
skeleton: {
|
|
706
|
+
skeletonTemplate: 'card',
|
|
707
|
+
skeletonDensity: 'md',
|
|
708
|
+
},
|
|
709
|
+
composition: {
|
|
710
|
+
childAdaptiveDensity: true,
|
|
711
|
+
embeddedTablePadding: 'strip',
|
|
712
|
+
// BASE cards host arbitrary content; keep selection-column heuristics off
|
|
713
|
+
// unless a table-oriented surface explicitly opts in.
|
|
714
|
+
selectionColumnAware: false,
|
|
715
|
+
},
|
|
716
|
+
};
|
|
717
|
+
|
|
718
|
+
/**
|
|
719
|
+
* CARD shares BASE's policy surface: both are card-like content containers that
|
|
720
|
+
* always paint their own frame (`framingMode: 'always'`), carry `card` padding,
|
|
721
|
+
* and stay presentational (`landmarkRole: 'none'`). A content card differs from
|
|
722
|
+
* BASE only at the RECIPE layer (an explicit elevated fill + border), not in
|
|
723
|
+
* policy — so it binds the same defaults. Kept as a distinct name so the two
|
|
724
|
+
* can diverge later without touching the map or its consumers.
|
|
725
|
+
*/
|
|
726
|
+
const CARD_DEFAULT_POLICY: SurfacePolicy = BASE_DEFAULT_POLICY;
|
|
727
|
+
|
|
728
|
+
const RAISED_DEFAULT_POLICY: SurfacePolicy = {
|
|
729
|
+
containment: {
|
|
730
|
+
paddingBlock: 'none',
|
|
731
|
+
paddingInline: 'none',
|
|
732
|
+
overflow: 'visible',
|
|
733
|
+
maxHeight: 'none',
|
|
734
|
+
gap: 'none',
|
|
735
|
+
},
|
|
736
|
+
nesting: {
|
|
737
|
+
framingMode: 'always',
|
|
738
|
+
nestedRadiusStrategy: 'one-tier-tighter',
|
|
739
|
+
firstChildEdgeStrategy: 'collapse',
|
|
740
|
+
dividerStrategy: 'gap',
|
|
741
|
+
},
|
|
742
|
+
content: {
|
|
743
|
+
textTruncation: 'none',
|
|
744
|
+
wrapStrategy: 'wrap',
|
|
745
|
+
numericAlignment: 'inherit',
|
|
746
|
+
tooltipOnTruncate: false,
|
|
747
|
+
overlongTokenStrategy: 'break-word',
|
|
748
|
+
},
|
|
749
|
+
autoRender: {
|
|
750
|
+
autoFieldChrome: 'stacked',
|
|
751
|
+
autoLabelPlacement: 'top',
|
|
752
|
+
autoEmptyValue: 'em-dash',
|
|
753
|
+
// Modern default (T3) — see BASE_DEFAULT_POLICY. Elevated card/dialog content
|
|
754
|
+
// groups sections inside one surface with divide-y instead of card-each.
|
|
755
|
+
autoSectionWrap: 'grouped',
|
|
756
|
+
autoFieldDensity: 'md',
|
|
757
|
+
autoErrorPlacement: 'inline',
|
|
758
|
+
},
|
|
759
|
+
interactiveState: {
|
|
760
|
+
selectableSemantics: 'wrap-children',
|
|
761
|
+
gestureOptIn: 'self',
|
|
762
|
+
loadingDisplay: 'skeleton-children',
|
|
763
|
+
emptyDisplay: 'placeholder',
|
|
764
|
+
errorBoundary: 'inherit',
|
|
765
|
+
},
|
|
766
|
+
a11y: {
|
|
767
|
+
landmarkRole: 'none',
|
|
768
|
+
labelStrategy: 'aria-label',
|
|
769
|
+
focusTrap: 'never',
|
|
770
|
+
scrollContainment: 'none',
|
|
771
|
+
},
|
|
772
|
+
geometry: {
|
|
773
|
+
responsiveMaxWidth: 'none',
|
|
774
|
+
mobileShape: 'inline',
|
|
775
|
+
safeAreaPadding: false,
|
|
776
|
+
actionAlignment: 'row',
|
|
777
|
+
},
|
|
778
|
+
stacking: {
|
|
779
|
+
stackingTier: 'overlay',
|
|
780
|
+
portalTarget: 'app-portal',
|
|
781
|
+
},
|
|
782
|
+
skeleton: {
|
|
783
|
+
skeletonTemplate: 'card',
|
|
784
|
+
skeletonDensity: 'md',
|
|
785
|
+
},
|
|
786
|
+
composition: {
|
|
787
|
+
childAdaptiveDensity: false,
|
|
788
|
+
embeddedTablePadding: 'preserve',
|
|
789
|
+
selectionColumnAware: false,
|
|
790
|
+
},
|
|
791
|
+
};
|
|
792
|
+
|
|
793
|
+
const OVERLAY_DEFAULT_POLICY: SurfacePolicy = {
|
|
794
|
+
containment: {
|
|
795
|
+
paddingBlock: 'container',
|
|
796
|
+
paddingInline: 'container',
|
|
797
|
+
// OVERLAY surfaces scroll internally once they exceed the viewport-safe
|
|
798
|
+
// modal height.
|
|
799
|
+
overflow: 'auto',
|
|
800
|
+
maxHeight: '90vh',
|
|
801
|
+
gap: 'field',
|
|
802
|
+
slotGap: { header: 'item' },
|
|
803
|
+
},
|
|
804
|
+
nesting: {
|
|
805
|
+
framingMode: 'always',
|
|
806
|
+
nestedRadiusStrategy: 'one-tier-tighter',
|
|
807
|
+
firstChildEdgeStrategy: 'collapse',
|
|
808
|
+
dividerStrategy: 'gap',
|
|
809
|
+
},
|
|
810
|
+
content: {
|
|
811
|
+
textTruncation: 'none',
|
|
812
|
+
wrapStrategy: 'wrap',
|
|
813
|
+
numericAlignment: 'inherit',
|
|
814
|
+
tooltipOnTruncate: false,
|
|
815
|
+
overlongTokenStrategy: 'break-word',
|
|
816
|
+
},
|
|
817
|
+
autoRender: {
|
|
818
|
+
autoFieldChrome: 'stacked',
|
|
819
|
+
autoLabelPlacement: 'top',
|
|
820
|
+
autoEmptyValue: 'em-dash',
|
|
821
|
+
// Overlay forms render generated sections flat inside the modal panel
|
|
822
|
+
// instead of nesting card panels in another overlay panel.
|
|
823
|
+
autoSectionWrap: 'flat',
|
|
824
|
+
autoFieldDensity: 'md',
|
|
825
|
+
autoErrorPlacement: 'inline',
|
|
826
|
+
},
|
|
827
|
+
interactiveState: {
|
|
828
|
+
selectableSemantics: 'forbidden',
|
|
829
|
+
gestureOptIn: 'none',
|
|
830
|
+
loadingDisplay: 'overlay',
|
|
831
|
+
emptyDisplay: 'placeholder',
|
|
832
|
+
errorBoundary: 'self',
|
|
833
|
+
},
|
|
834
|
+
a11y: {
|
|
835
|
+
landmarkRole: 'dialog',
|
|
836
|
+
labelStrategy: 'from-header',
|
|
837
|
+
focusTrap: 'when-modal',
|
|
838
|
+
scrollContainment: 'lock-body',
|
|
839
|
+
},
|
|
840
|
+
geometry: {
|
|
841
|
+
responsiveMaxWidth: 'lg',
|
|
842
|
+
// OverlayContainer resolves dialog overlays to Vaul Drawer on mobile and
|
|
843
|
+
// freezes the primitive for the current open session.
|
|
844
|
+
mobileShape: 'drawer',
|
|
845
|
+
safeAreaPadding: true,
|
|
846
|
+
actionAlignment: 'column-reverse-on-mobile',
|
|
847
|
+
},
|
|
848
|
+
stacking: {
|
|
849
|
+
stackingTier: 'overlay',
|
|
850
|
+
portalTarget: 'app-portal',
|
|
851
|
+
},
|
|
852
|
+
skeleton: {
|
|
853
|
+
skeletonTemplate: 'detail',
|
|
854
|
+
skeletonDensity: 'md',
|
|
855
|
+
},
|
|
856
|
+
composition: {
|
|
857
|
+
childAdaptiveDensity: false,
|
|
858
|
+
embeddedTablePadding: 'strip',
|
|
859
|
+
selectionColumnAware: true,
|
|
860
|
+
},
|
|
861
|
+
};
|
|
862
|
+
|
|
863
|
+
const INSET_DEFAULT_POLICY: SurfacePolicy = {
|
|
864
|
+
containment: {
|
|
865
|
+
paddingBlock: 'none',
|
|
866
|
+
paddingInline: 'none',
|
|
867
|
+
overflow: 'clip',
|
|
868
|
+
maxHeight: 'none',
|
|
869
|
+
gap: 'field',
|
|
870
|
+
},
|
|
871
|
+
nesting: {
|
|
872
|
+
framingMode: 'always',
|
|
873
|
+
nestedRadiusStrategy: 'one-tier-tighter',
|
|
874
|
+
firstChildEdgeStrategy: 'collapse',
|
|
875
|
+
dividerStrategy: 'border',
|
|
876
|
+
},
|
|
877
|
+
content: {
|
|
878
|
+
// INSET tables keep nowrap-compatible behavior until table rendering is
|
|
879
|
+
// migrated to policy-owned truncation.
|
|
880
|
+
textTruncation: 'none',
|
|
881
|
+
tooltipOnTruncate: false,
|
|
882
|
+
wrapStrategy: 'wrap',
|
|
883
|
+
numericAlignment: 'inherit',
|
|
884
|
+
},
|
|
885
|
+
autoRender: {
|
|
886
|
+
autoFieldChrome: 'stacked',
|
|
887
|
+
autoLabelPlacement: 'top',
|
|
888
|
+
autoEmptyValue: 'em-dash',
|
|
889
|
+
autoSectionWrap: 'card-each',
|
|
890
|
+
autoFieldDensity: 'md',
|
|
891
|
+
autoErrorPlacement: 'inline',
|
|
892
|
+
},
|
|
893
|
+
interactiveState: {
|
|
894
|
+
selectableSemantics: 'wrap-children',
|
|
895
|
+
gestureOptIn: 'self',
|
|
896
|
+
loadingDisplay: 'skeleton-children',
|
|
897
|
+
emptyDisplay: 'placeholder',
|
|
898
|
+
errorBoundary: 'inherit',
|
|
899
|
+
},
|
|
900
|
+
a11y: {
|
|
901
|
+
landmarkRole: 'none',
|
|
902
|
+
labelStrategy: 'aria-label',
|
|
903
|
+
focusTrap: 'never',
|
|
904
|
+
scrollContainment: 'none',
|
|
905
|
+
},
|
|
906
|
+
geometry: {
|
|
907
|
+
responsiveMaxWidth: 'none',
|
|
908
|
+
mobileShape: 'inline',
|
|
909
|
+
safeAreaPadding: false,
|
|
910
|
+
actionAlignment: 'row',
|
|
911
|
+
},
|
|
912
|
+
stacking: {
|
|
913
|
+
stackingTier: 'content',
|
|
914
|
+
portalTarget: 'inline',
|
|
915
|
+
},
|
|
916
|
+
skeleton: {
|
|
917
|
+
skeletonTemplate: 'card',
|
|
918
|
+
skeletonDensity: 'md',
|
|
919
|
+
},
|
|
920
|
+
composition: {
|
|
921
|
+
childAdaptiveDensity: true,
|
|
922
|
+
embeddedTablePadding: 'preserve',
|
|
923
|
+
selectionColumnAware: true,
|
|
924
|
+
},
|
|
925
|
+
};
|
|
926
|
+
|
|
927
|
+
const SUNKEN_DEFAULT_POLICY: SurfacePolicy = {
|
|
928
|
+
containment: {
|
|
929
|
+
paddingBlock: 'none',
|
|
930
|
+
paddingInline: 'none',
|
|
931
|
+
overflow: 'visible',
|
|
932
|
+
maxHeight: 'none',
|
|
933
|
+
gap: 'item',
|
|
934
|
+
},
|
|
935
|
+
nesting: {
|
|
936
|
+
framingMode: 'always',
|
|
937
|
+
nestedRadiusStrategy: 'one-tier-tighter',
|
|
938
|
+
firstChildEdgeStrategy: 'collapse',
|
|
939
|
+
dividerStrategy: 'gap',
|
|
940
|
+
},
|
|
941
|
+
content: {
|
|
942
|
+
textTruncation: 'none',
|
|
943
|
+
wrapStrategy: 'wrap',
|
|
944
|
+
numericAlignment: 'inherit',
|
|
945
|
+
tooltipOnTruncate: false,
|
|
946
|
+
overlongTokenStrategy: 'break-word',
|
|
947
|
+
},
|
|
948
|
+
autoRender: {
|
|
949
|
+
autoFieldChrome: 'compact',
|
|
950
|
+
autoLabelPlacement: 'top',
|
|
951
|
+
autoEmptyValue: 'hidden',
|
|
952
|
+
autoSectionWrap: 'card-each',
|
|
953
|
+
// Sunken/sidebar contexts compact auto-rendered fields by default.
|
|
954
|
+
autoFieldDensity: 'sm',
|
|
955
|
+
autoErrorPlacement: 'inline',
|
|
956
|
+
},
|
|
957
|
+
interactiveState: {
|
|
958
|
+
selectableSemantics: 'wrap-children',
|
|
959
|
+
gestureOptIn: 'self',
|
|
960
|
+
loadingDisplay: 'skeleton-children',
|
|
961
|
+
emptyDisplay: 'placeholder',
|
|
962
|
+
errorBoundary: 'inherit',
|
|
963
|
+
},
|
|
964
|
+
a11y: {
|
|
965
|
+
landmarkRole: 'complementary',
|
|
966
|
+
labelStrategy: 'aria-label',
|
|
967
|
+
focusTrap: 'never',
|
|
968
|
+
scrollContainment: 'none',
|
|
969
|
+
},
|
|
970
|
+
geometry: {
|
|
971
|
+
responsiveMaxWidth: 'none',
|
|
972
|
+
mobileShape: 'inline',
|
|
973
|
+
safeAreaPadding: false,
|
|
974
|
+
actionAlignment: 'row',
|
|
975
|
+
},
|
|
976
|
+
stacking: {
|
|
977
|
+
stackingTier: 'content',
|
|
978
|
+
portalTarget: 'inline',
|
|
979
|
+
},
|
|
980
|
+
skeleton: {
|
|
981
|
+
skeletonTemplate: 'list',
|
|
982
|
+
skeletonDensity: 'sm',
|
|
983
|
+
},
|
|
984
|
+
composition: {
|
|
985
|
+
childAdaptiveDensity: true,
|
|
986
|
+
embeddedTablePadding: 'preserve',
|
|
987
|
+
selectionColumnAware: true,
|
|
988
|
+
},
|
|
989
|
+
};
|
|
990
|
+
|
|
991
|
+
const TAB_PANEL_DEFAULT_POLICY: SurfacePolicy = {
|
|
992
|
+
containment: {
|
|
993
|
+
paddingBlock: 'card',
|
|
994
|
+
paddingInline: 'none',
|
|
995
|
+
overflow: 'visible',
|
|
996
|
+
maxHeight: 'none',
|
|
997
|
+
gap: 'section',
|
|
998
|
+
},
|
|
999
|
+
nesting: {
|
|
1000
|
+
// Tab panel joins seamlessly to the strip above; never renders its own frame.
|
|
1001
|
+
framingMode: 'never',
|
|
1002
|
+
nestedRadiusStrategy: 'inherit',
|
|
1003
|
+
firstChildEdgeStrategy: 'preserve',
|
|
1004
|
+
dividerStrategy: 'gap',
|
|
1005
|
+
},
|
|
1006
|
+
content: {
|
|
1007
|
+
textTruncation: 'none',
|
|
1008
|
+
wrapStrategy: 'wrap',
|
|
1009
|
+
numericAlignment: 'inherit',
|
|
1010
|
+
tooltipOnTruncate: false,
|
|
1011
|
+
overlongTokenStrategy: 'break-word',
|
|
1012
|
+
},
|
|
1013
|
+
autoRender: {
|
|
1014
|
+
autoFieldChrome: 'stacked',
|
|
1015
|
+
autoLabelPlacement: 'top',
|
|
1016
|
+
autoEmptyValue: 'em-dash',
|
|
1017
|
+
autoSectionWrap: 'separator-only',
|
|
1018
|
+
autoFieldDensity: 'md',
|
|
1019
|
+
autoErrorPlacement: 'inline',
|
|
1020
|
+
},
|
|
1021
|
+
interactiveState: {
|
|
1022
|
+
selectableSemantics: 'wrap-children',
|
|
1023
|
+
gestureOptIn: 'self',
|
|
1024
|
+
loadingDisplay: 'skeleton-children',
|
|
1025
|
+
emptyDisplay: 'placeholder',
|
|
1026
|
+
errorBoundary: 'inherit',
|
|
1027
|
+
},
|
|
1028
|
+
a11y: {
|
|
1029
|
+
landmarkRole: 'none',
|
|
1030
|
+
labelStrategy: 'from-header',
|
|
1031
|
+
focusTrap: 'never',
|
|
1032
|
+
scrollContainment: 'none',
|
|
1033
|
+
},
|
|
1034
|
+
geometry: {
|
|
1035
|
+
responsiveMaxWidth: 'none',
|
|
1036
|
+
mobileShape: 'inline',
|
|
1037
|
+
safeAreaPadding: false,
|
|
1038
|
+
actionAlignment: 'row',
|
|
1039
|
+
},
|
|
1040
|
+
stacking: {
|
|
1041
|
+
stackingTier: 'content',
|
|
1042
|
+
portalTarget: 'inline',
|
|
1043
|
+
},
|
|
1044
|
+
skeleton: {
|
|
1045
|
+
skeletonTemplate: 'card',
|
|
1046
|
+
skeletonDensity: 'md',
|
|
1047
|
+
},
|
|
1048
|
+
composition: {
|
|
1049
|
+
childAdaptiveDensity: true,
|
|
1050
|
+
embeddedTablePadding: 'strip',
|
|
1051
|
+
selectionColumnAware: true,
|
|
1052
|
+
},
|
|
1053
|
+
};
|
|
1054
|
+
|
|
1055
|
+
const SHELL_DEFAULT_POLICY: SurfacePolicy = {
|
|
1056
|
+
containment: {
|
|
1057
|
+
paddingBlock: 'none',
|
|
1058
|
+
paddingInline: 'none',
|
|
1059
|
+
overflow: 'visible',
|
|
1060
|
+
maxHeight: 'none',
|
|
1061
|
+
gap: 'lane',
|
|
1062
|
+
},
|
|
1063
|
+
nesting: {
|
|
1064
|
+
framingMode: 'never',
|
|
1065
|
+
nestedRadiusStrategy: 'inherit',
|
|
1066
|
+
firstChildEdgeStrategy: 'preserve',
|
|
1067
|
+
dividerStrategy: 'none',
|
|
1068
|
+
},
|
|
1069
|
+
content: {
|
|
1070
|
+
textTruncation: 'none',
|
|
1071
|
+
wrapStrategy: 'wrap',
|
|
1072
|
+
numericAlignment: 'inherit',
|
|
1073
|
+
tooltipOnTruncate: false,
|
|
1074
|
+
overlongTokenStrategy: 'break-word',
|
|
1075
|
+
},
|
|
1076
|
+
autoRender: {
|
|
1077
|
+
autoFieldChrome: 'stacked',
|
|
1078
|
+
autoLabelPlacement: 'top',
|
|
1079
|
+
autoEmptyValue: 'em-dash',
|
|
1080
|
+
autoSectionWrap: 'card-each',
|
|
1081
|
+
autoFieldDensity: 'md',
|
|
1082
|
+
autoErrorPlacement: 'inline',
|
|
1083
|
+
},
|
|
1084
|
+
interactiveState: {
|
|
1085
|
+
selectableSemantics: 'wrap-children',
|
|
1086
|
+
gestureOptIn: 'none',
|
|
1087
|
+
loadingDisplay: 'skeleton-children',
|
|
1088
|
+
emptyDisplay: 'placeholder',
|
|
1089
|
+
errorBoundary: 'self',
|
|
1090
|
+
},
|
|
1091
|
+
a11y: {
|
|
1092
|
+
// SHELL `landmarkRole` defaults to `'none'`. Apps opt in to a single
|
|
1093
|
+
// canonical main landmark so framework upgrades do not create duplicate
|
|
1094
|
+
// page landmarks. Per-app opt-in:
|
|
1095
|
+
// `surfacePolicies[SurfaceVariant.SHELL].a11y.landmarkRole = 'main'`
|
|
1096
|
+
landmarkRole: 'none',
|
|
1097
|
+
labelStrategy: 'from-header',
|
|
1098
|
+
focusTrap: 'never',
|
|
1099
|
+
scrollContainment: 'none',
|
|
1100
|
+
},
|
|
1101
|
+
geometry: {
|
|
1102
|
+
responsiveMaxWidth: 'centered-readable',
|
|
1103
|
+
mobileShape: 'inline',
|
|
1104
|
+
safeAreaPadding: true,
|
|
1105
|
+
actionAlignment: 'row',
|
|
1106
|
+
},
|
|
1107
|
+
stacking: {
|
|
1108
|
+
stackingTier: 'content',
|
|
1109
|
+
portalTarget: 'inline',
|
|
1110
|
+
},
|
|
1111
|
+
skeleton: {
|
|
1112
|
+
skeletonTemplate: 'card',
|
|
1113
|
+
skeletonDensity: 'md',
|
|
1114
|
+
},
|
|
1115
|
+
composition: {
|
|
1116
|
+
childAdaptiveDensity: true,
|
|
1117
|
+
embeddedTablePadding: 'strip',
|
|
1118
|
+
selectionColumnAware: true,
|
|
1119
|
+
},
|
|
1120
|
+
};
|
|
1121
|
+
|
|
1122
|
+
const TRANSIENT_DEFAULT_POLICY: SurfacePolicy = {
|
|
1123
|
+
containment: {
|
|
1124
|
+
paddingBlock: 'card-sm',
|
|
1125
|
+
paddingInline: 'card-sm',
|
|
1126
|
+
overflow: 'visible',
|
|
1127
|
+
maxHeight: 'none',
|
|
1128
|
+
gap: 'item',
|
|
1129
|
+
},
|
|
1130
|
+
nesting: {
|
|
1131
|
+
framingMode: 'always',
|
|
1132
|
+
nestedRadiusStrategy: 'fixed',
|
|
1133
|
+
firstChildEdgeStrategy: 'preserve',
|
|
1134
|
+
dividerStrategy: 'gap',
|
|
1135
|
+
},
|
|
1136
|
+
content: {
|
|
1137
|
+
textTruncation: 'ellipsis-multiline:2',
|
|
1138
|
+
wrapStrategy: 'wrap',
|
|
1139
|
+
numericAlignment: 'inherit',
|
|
1140
|
+
tooltipOnTruncate: true,
|
|
1141
|
+
overlongTokenStrategy: 'break-word',
|
|
1142
|
+
},
|
|
1143
|
+
autoRender: {
|
|
1144
|
+
autoFieldChrome: 'compact',
|
|
1145
|
+
autoLabelPlacement: 'inline',
|
|
1146
|
+
autoEmptyValue: 'hidden',
|
|
1147
|
+
autoSectionWrap: 'flat',
|
|
1148
|
+
autoFieldDensity: 'sm',
|
|
1149
|
+
autoErrorPlacement: 'summary-at-surface-top',
|
|
1150
|
+
},
|
|
1151
|
+
interactiveState: {
|
|
1152
|
+
selectableSemantics: 'forbidden',
|
|
1153
|
+
gestureOptIn: 'none',
|
|
1154
|
+
loadingDisplay: 'spinner-only',
|
|
1155
|
+
emptyDisplay: 'hide',
|
|
1156
|
+
errorBoundary: 'inherit',
|
|
1157
|
+
},
|
|
1158
|
+
a11y: {
|
|
1159
|
+
landmarkRole: 'status',
|
|
1160
|
+
labelStrategy: 'aria-label',
|
|
1161
|
+
focusTrap: 'never',
|
|
1162
|
+
scrollContainment: 'none',
|
|
1163
|
+
},
|
|
1164
|
+
geometry: {
|
|
1165
|
+
responsiveMaxWidth: 'sm',
|
|
1166
|
+
mobileShape: 'inline',
|
|
1167
|
+
safeAreaPadding: true,
|
|
1168
|
+
actionAlignment: 'row',
|
|
1169
|
+
},
|
|
1170
|
+
stacking: {
|
|
1171
|
+
stackingTier: 'transient',
|
|
1172
|
+
portalTarget: 'app-portal',
|
|
1173
|
+
},
|
|
1174
|
+
skeleton: {
|
|
1175
|
+
skeletonTemplate: 'none',
|
|
1176
|
+
skeletonDensity: 'sm',
|
|
1177
|
+
},
|
|
1178
|
+
composition: {
|
|
1179
|
+
childAdaptiveDensity: false,
|
|
1180
|
+
embeddedTablePadding: 'preserve',
|
|
1181
|
+
selectionColumnAware: false,
|
|
1182
|
+
},
|
|
1183
|
+
};
|
|
1184
|
+
|
|
1185
|
+
/**
|
|
1186
|
+
* Per-variant framework default policy. Theme-provided `policy` and app-config
|
|
1187
|
+
* overrides merge on top of these via the cascade ladder:
|
|
1188
|
+
*
|
|
1189
|
+
* 1. Framework default (this constant)
|
|
1190
|
+
* 2. Theme default `theme.surface[variant].policy`
|
|
1191
|
+
* 3. App configuration `designSystemConfig.surfacePolicies?.[variant]`
|
|
1192
|
+
* 4. Call-site override `<Surface policyOverride={...}>`
|
|
1193
|
+
*
|
|
1194
|
+
* Every policy family for every variant has a framework baseline. Some nested
|
|
1195
|
+
* optional fields remain sparse by design; `reset` returns to the framework
|
|
1196
|
+
* value where that slot exists.
|
|
1197
|
+
*/
|
|
1198
|
+
export const FRAMEWORK_DEFAULT_SURFACE_POLICIES: Record<SurfaceVariant, SurfacePolicy> = {
|
|
1199
|
+
// Keys are the literal string values of the `SurfaceVariant` enum
|
|
1200
|
+
// (kept in sync via `Record<SurfaceVariant, …>` exhaustiveness — TS errors
|
|
1201
|
+
// here are the canary that the enum changed and this map must follow).
|
|
1202
|
+
base: BASE_DEFAULT_POLICY,
|
|
1203
|
+
card: CARD_DEFAULT_POLICY,
|
|
1204
|
+
raised: RAISED_DEFAULT_POLICY,
|
|
1205
|
+
overlay: OVERLAY_DEFAULT_POLICY,
|
|
1206
|
+
inset: INSET_DEFAULT_POLICY,
|
|
1207
|
+
sunken: SUNKEN_DEFAULT_POLICY,
|
|
1208
|
+
'tab-panel': TAB_PANEL_DEFAULT_POLICY,
|
|
1209
|
+
shell: SHELL_DEFAULT_POLICY,
|
|
1210
|
+
transient: TRANSIENT_DEFAULT_POLICY,
|
|
1211
|
+
};
|
|
1212
|
+
```
|