@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,424 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: config-design-system
|
|
3
|
+
description: Author or update the design system config (colors, surfaces, surfacePolicies, sidebar, theme materials) and trigger CSS regeneration. Use when the user says "rebrand to <color>", "tweak primary color", "add a new surface token", "configure glass materials", "set the refraction budget", "change SHELL main landmark behavior", "configure surface policy", "switch to a darker sidebar", "regenerate CSS variables", or any change to visual identity / container behavior at the app level rather than a single component.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Config Design System
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Edits the **design system configuration** (`frontend/src/config/design-system.config.ts`).
|
|
23
|
+
The exported value is the result of `defineDesignSystemConfig({...})`,
|
|
24
|
+
spread over `DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG` to inherit framework
|
|
25
|
+
defaults and override the keys this app cares about. The CSS pipeline
|
|
26
|
+
reads this file to materialize CSS variables consumed by every styled
|
|
27
|
+
component.
|
|
28
|
+
|
|
29
|
+
Tokens live in **typed nested maps**: `colors`, `surfaces`, `sidebar`,
|
|
30
|
+
each split between `light` and `dark`. The override pattern (spread
|
|
31
|
+
default → override per-token) is the only sanctioned shape — inventing
|
|
32
|
+
new top-level keys breaks the CSS generator.
|
|
33
|
+
|
|
34
|
+
## App Paths
|
|
35
|
+
|
|
36
|
+
| Surface | Glob (relative to app root) |
|
|
37
|
+
|---------------------|------------------------------------------------------------------------------------------|
|
|
38
|
+
| Design system config | `frontend/src/config/design-system.config.ts` |
|
|
39
|
+
| First-paint theme behavior | `frontend/index.html`, `frontend/src/browser-bootstrap/**/*theme*` |
|
|
40
|
+
| Generated CSS | App-specific (typically `frontend/src/styles/design-tokens.css` or auto-injected) |
|
|
41
|
+
| Component theme consumption | `frontend/src/components/**/*.tsx` (via Tailwind / CSS variables) |
|
|
42
|
+
| Companion design-system snapshot | Re-extracted via `wildo dev design-tokens generate` / app's equivalent CLI |
|
|
43
|
+
|
|
44
|
+
## When to Use
|
|
45
|
+
|
|
46
|
+
- Brand color / accent / primary token changes
|
|
47
|
+
- New surface variant (raised / inset / overlay) needed by components
|
|
48
|
+
- App-wide `surfacePolicies` changes, including `SHELL` main landmark opt-in
|
|
49
|
+
- Sidebar-specific token overrides
|
|
50
|
+
- Switching the `theme` variant
|
|
51
|
+
- Authoring semantic material profiles or the document-wide refractive budget
|
|
52
|
+
- Regenerating CSS variables after token edits
|
|
53
|
+
|
|
54
|
+
## When NOT to Use
|
|
55
|
+
|
|
56
|
+
- Single component prop tweak -> component code + maybe `spec-component-update`
|
|
57
|
+
- Layout / spacing primitives -> belong to component code, not design tokens
|
|
58
|
+
- Email-template branding -> Email templates read `brand` from `EmailTemplateProps` (separate pipeline)
|
|
59
|
+
|
|
60
|
+
## Workflow
|
|
61
|
+
|
|
62
|
+
### Step 1: Open config
|
|
63
|
+
|
|
64
|
+
`references/design-system-file.md` for the typical path. Cross-check
|
|
65
|
+
`references/framework-design-system-configuration-api.md` for the
|
|
66
|
+
framework-provided `DesignSystemSourceConfigSchema` and `defineDesignSystemConfig`
|
|
67
|
+
entrypoint to confirm which app-authored keys are first-class.
|
|
68
|
+
|
|
69
|
+
### Step 2: Mirror the override pattern
|
|
70
|
+
|
|
71
|
+
Always **spread the default first**, then override per-token:
|
|
72
|
+
|
|
73
|
+
<!-- TIER C WAIVER: minimal spread-then-override pattern with a placeholder token value ('oklch(...)'); a full application token set would bury the one-line lesson, and no stable application anchor honestly isolates this shape. -->
|
|
74
|
+
```ts
|
|
75
|
+
colors: {
|
|
76
|
+
light: {
|
|
77
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.colors.light,
|
|
78
|
+
primary: 'oklch(...)',
|
|
79
|
+
},
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Inventing new top-level keys (e.g. `colors.brand`) is forbidden — the
|
|
84
|
+
CSS generator only consumes the framework-declared shape.
|
|
85
|
+
|
|
86
|
+
### Step 3: Surface policy, if behavior changes
|
|
87
|
+
|
|
88
|
+
If the request changes container behavior rather than visual tokens, read
|
|
89
|
+
`references/surface-policy-authoring.md` and cross-check
|
|
90
|
+
`references/framework-surface-policy-api.md`.
|
|
91
|
+
|
|
92
|
+
Use `surfacePolicies[SurfaceVariant.SHELL].a11y.landmarkRole = 'main'`
|
|
93
|
+
for one app-wide canonical shell landmark. Use local
|
|
94
|
+
`<Surface emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={{ a11y: { landmarkRole: 'none' } }}>`
|
|
95
|
+
for one non-canonical `SHELL` wrapper that provides context but must not become
|
|
96
|
+
the page's `main` landmark.
|
|
97
|
+
|
|
98
|
+
### Step 4: Keep first-paint behavior semantic
|
|
99
|
+
|
|
100
|
+
Treat the document-head theme bootstrap as **app behavior determination**:
|
|
101
|
+
it resolves `LIGHT`, `DARK`, or `AUTO` before the app renders, but it does not
|
|
102
|
+
own the palette. In `frontend/index.html`, use
|
|
103
|
+
`background-color: var(--background, Canvas)` and change only `color-scheme`
|
|
104
|
+
for the resolved mode. Never copy `oklch`, hex, or RGB token values into HTML
|
|
105
|
+
or bootstrap TypeScript; duplicated tints drift when the design system changes.
|
|
106
|
+
|
|
107
|
+
### Step 5: Configure material cost at the theme boundary
|
|
108
|
+
|
|
109
|
+
When a theme uses structured materials, read
|
|
110
|
+
`references/framework-material-profile-api.md` and
|
|
111
|
+
`references/framework-material-runtime-policy-api.md`.
|
|
112
|
+
|
|
113
|
+
Recipes choose stable `MaterialProfileRole` values. The theme owns the optical
|
|
114
|
+
profile behind each role through `theme.materials`; components must not copy
|
|
115
|
+
blur, tint, border, or refraction constants. Set
|
|
116
|
+
`theme.materialRuntimePolicy` once for the whole UI tree. Per-profile
|
|
117
|
+
`performance.maxRefractiveAreaPx` protects one surface, while the runtime
|
|
118
|
+
policy protects the document by count and aggregate CSS-pixel area. Budgeted-
|
|
119
|
+
out surfaces degrade to backdrop/fallback instead of disappearing.
|
|
120
|
+
|
|
121
|
+
Priority is semantic rather than geometric: overlays outrank operated controls,
|
|
122
|
+
controls outrank navigation, and passive decoration yields first. Do not use
|
|
123
|
+
z-index or mount timing as a substitute for `GlassMaterialPriority`.
|
|
124
|
+
|
|
125
|
+
### Step 6: Regenerate artifacts
|
|
126
|
+
|
|
127
|
+
Run the project's design-token generation command (typically
|
|
128
|
+
`wildo dev design-tokens generate` or app equivalent). The CSS file
|
|
129
|
+
must be regenerated and committed; runtime reads the generated CSS,
|
|
130
|
+
not the TS config directly.
|
|
131
|
+
|
|
132
|
+
### Step 7: Spec
|
|
133
|
+
|
|
134
|
+
If specs capture design constraints (component palettes, surface
|
|
135
|
+
contracts), use `spec-update-after-change` to keep the companion
|
|
136
|
+
snapshot aligned.
|
|
137
|
+
|
|
138
|
+
## Worked Example
|
|
139
|
+
|
|
140
|
+
The reference block below is an excerpt from a reference application's
|
|
141
|
+
`designSystemConfig`. It shows the canonical override-pattern shape — every
|
|
142
|
+
supported token bucket exercised across `light` and `dark`. Use
|
|
143
|
+
`references/design-system-file.md` for the file path/import context.
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
## Usage Example
|
|
147
|
+
|
|
148
|
+
```typescript
|
|
149
|
+
const designSystemConfig = defineDesignSystemConfig({
|
|
150
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG,
|
|
151
|
+
colors: {
|
|
152
|
+
light: {
|
|
153
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.colors.light,
|
|
154
|
+
background: 'oklch(0.984 0.003 247)',
|
|
155
|
+
foreground: 'oklch(0.208 0.042 265)',
|
|
156
|
+
// Light primary L 0.588 → 0.50 (hue/chroma unchanged): 0.588 measured
|
|
157
|
+
// ~4.0:1 with the white primary-foreground (below WCAG AA 4.5:1 for
|
|
158
|
+
// button/badge text); 0.50 measures ~5.7:1. Mirrors the engine preset
|
|
159
|
+
// (`preset-design-system.ts`) — keep the two in sync.
|
|
160
|
+
primary: 'oklch(0.50 0.158 241)',
|
|
161
|
+
'primary-foreground': 'oklch(1 0 0)',
|
|
162
|
+
secondary: 'oklch(0.929 0.013 255)',
|
|
163
|
+
'secondary-foreground': 'oklch(0.208 0.042 265)',
|
|
164
|
+
muted: 'oklch(0.968 0.007 247)',
|
|
165
|
+
// L 0.554 → 0.46: 12px uppercase muted labels sat at the AA borderline
|
|
166
|
+
// (≈4.3:1 on `muted`); 0.46 measures ≈6.5:1. Mirrors the engine preset.
|
|
167
|
+
'muted-foreground': 'oklch(0.46 0.046 257)',
|
|
168
|
+
// `accent` is the INTERACTION TINT — the framework recipes paint it on
|
|
169
|
+
// hovered/selected/highlighted surfaces (list rows, dropdown options, menu
|
|
170
|
+
// items, toggles). It must stay a SUBTLE wash of the page palette, not a
|
|
171
|
+
// brand color: a saturated value here turns every hover/selection in the
|
|
172
|
+
// app into a loud color block with unreadable foregrounds. (This config
|
|
173
|
+
// previously authored a saturated violet — that was the source of the
|
|
174
|
+
// purple selected rows/options everywhere.)
|
|
175
|
+
accent: 'oklch(0.929 0.013 255)',
|
|
176
|
+
'accent-foreground': 'oklch(0.208 0.042 265)',
|
|
177
|
+
border: 'oklch(0.929 0.013 255)',
|
|
178
|
+
input: 'oklch(0.929 0.013 255)',
|
|
179
|
+
// Tracks the darkened light primary (focus ring is the brand color).
|
|
180
|
+
ring: 'oklch(0.50 0.158 241)',
|
|
181
|
+
},
|
|
182
|
+
dark: {
|
|
183
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.colors.dark,
|
|
184
|
+
background: 'oklch(0.129 0.042 264)',
|
|
185
|
+
foreground: 'oklch(0.968 0.007 247)',
|
|
186
|
+
primary: 'oklch(0.746 0.16 232)',
|
|
187
|
+
'primary-foreground': 'oklch(0.129 0.042 264)',
|
|
188
|
+
secondary: 'oklch(0.279 0.041 260)',
|
|
189
|
+
'secondary-foreground': 'oklch(0.968 0.007 247)',
|
|
190
|
+
muted: 'oklch(0.279 0.041 260)',
|
|
191
|
+
'muted-foreground': 'oklch(0.704 0.04 256)',
|
|
192
|
+
// Subtle interaction tint (see the light-mode note): a slate one step
|
|
193
|
+
// lighter than `muted`, with the page foreground for readable content.
|
|
194
|
+
accent: 'oklch(0.279 0.041 260)',
|
|
195
|
+
'accent-foreground': 'oklch(0.968 0.007 247)',
|
|
196
|
+
border: 'oklch(0.279 0.041 260)',
|
|
197
|
+
input: 'oklch(0.279 0.041 260)',
|
|
198
|
+
ring: 'oklch(0.746 0.16 232)',
|
|
199
|
+
},
|
|
200
|
+
},
|
|
201
|
+
surfaces: {
|
|
202
|
+
light: {
|
|
203
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.surfaces.light,
|
|
204
|
+
default: 'oklch(1 0 0)',
|
|
205
|
+
'default-foreground': 'oklch(0.208 0.042 265)',
|
|
206
|
+
sunken: 'oklch(0.968 0.007 247)',
|
|
207
|
+
'sunken-foreground': 'oklch(0.208 0.042 265)',
|
|
208
|
+
// Tracks the darkened light primary (selected-item border accent on sunken surfaces).
|
|
209
|
+
'sunken-primary': 'oklch(0.50 0.158 241)',
|
|
210
|
+
// ALPHA overlay (not an opaque slab): sidebar/selectable hover + active
|
|
211
|
+
// washes must sit naturally on ANY stop of the continuous shell gradient
|
|
212
|
+
// (see `shell-background` below). ~9% page-ink wash.
|
|
213
|
+
'sunken-accent': 'oklch(0.35 0.045 259 / 0.09)',
|
|
214
|
+
'sunken-border': 'oklch(0.929 0.013 255)',
|
|
215
|
+
raised: 'oklch(1 0 0)',
|
|
216
|
+
'raised-foreground': 'oklch(0.208 0.042 265)',
|
|
217
|
+
overlay: 'oklch(1 0 0)',
|
|
218
|
+
'overlay-foreground': 'oklch(0.208 0.042 265)',
|
|
219
|
+
inset: 'oklch(0.968 0.007 247)',
|
|
220
|
+
'inset-foreground': 'oklch(0.208 0.042 265)',
|
|
221
|
+
},
|
|
222
|
+
dark: {
|
|
223
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.surfaces.dark,
|
|
224
|
+
default: 'oklch(0.208 0.042 265)',
|
|
225
|
+
'default-foreground': 'oklch(0.968 0.007 247)',
|
|
226
|
+
sunken: 'oklch(0.15 0.03 260)',
|
|
227
|
+
'sunken-foreground': 'oklch(0.968 0.007 247)',
|
|
228
|
+
'sunken-primary': 'oklch(0.746 0.16 232)',
|
|
229
|
+
// ALPHA overlay (see the light-mode note): ~11% white wash reads as the
|
|
230
|
+
// Revolut-style selected/hover pill on the dark navy gradient.
|
|
231
|
+
'sunken-accent': 'oklch(0.97 0.01 250 / 0.11)',
|
|
232
|
+
'sunken-border': 'oklch(0.279 0.041 260)',
|
|
233
|
+
raised: 'oklch(0.208 0.042 265)',
|
|
234
|
+
'raised-foreground': 'oklch(0.968 0.007 247)',
|
|
235
|
+
overlay: 'oklch(0.208 0.042 265)',
|
|
236
|
+
'overlay-foreground': 'oklch(0.968 0.007 247)',
|
|
237
|
+
inset: 'oklch(0.15 0.03 260)',
|
|
238
|
+
'inset-foreground': 'oklch(0.968 0.007 247)',
|
|
239
|
+
},
|
|
240
|
+
},
|
|
241
|
+
sidebar: {
|
|
242
|
+
light: {
|
|
243
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.sidebar.light,
|
|
244
|
+
'primary-foreground': 'oklch(1 0 0)',
|
|
245
|
+
'accent-foreground': 'oklch(0.208 0.042 265)',
|
|
246
|
+
// Tracks the darkened light primary (sidebar focus ring).
|
|
247
|
+
ring: 'oklch(0.50 0.158 241)',
|
|
248
|
+
},
|
|
249
|
+
dark: {
|
|
250
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.sidebar.dark,
|
|
251
|
+
'primary-foreground': 'oklch(0.129 0.042 264)',
|
|
252
|
+
'accent-foreground': 'oklch(0.968 0.007 247)',
|
|
253
|
+
ring: 'oklch(0.746 0.16 232)',
|
|
254
|
+
},
|
|
255
|
+
},
|
|
256
|
+
opacity: {
|
|
257
|
+
...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.opacity,
|
|
258
|
+
// Lighter modal/popup scrim. The framework default (0.75) reads too opaque
|
|
259
|
+
// over this dark theme; the backdrop recipe already pairs the scrim with
|
|
260
|
+
// `backdrop-blur-sm`, so 0.5 still separates the dialog from the page.
|
|
261
|
+
overlay: '0.5',
|
|
262
|
+
},
|
|
263
|
+
theme: {
|
|
264
|
+
// Quick theme switch: uncomment Glass below and its import (plus its
|
|
265
|
+
// requiredCustomTokens spread), then comment the Default spread and import.
|
|
266
|
+
...defaultTheme,
|
|
267
|
+
// ...glassTheme,
|
|
268
|
+
// ── Continuous shell chrome ("one canvas", Revolut-style) ──
|
|
269
|
+
// Sidebar / menubar / toolbar / status bar / content zones render as
|
|
270
|
+
// TRANSPARENT regions with no separating borders; the fixed
|
|
271
|
+
// `backgroundLayer` below is the single background that flows under the
|
|
272
|
+
// whole app. Selection/hover structure comes from the alpha
|
|
273
|
+
// `surfaces.sunken-accent` washes above, not from opaque slabs.
|
|
274
|
+
shellAppearance: ShellAppearance.CONTINUOUS,
|
|
275
|
+
// Compact rail shows a small centered label under each icon (labels wrap
|
|
276
|
+
// when long) instead of icon-only + tooltip.
|
|
277
|
+
sidebarCompactLabelMode: SidebarCompactLabelMode.ICON_AND_LABEL,
|
|
278
|
+
backgroundLayer: {
|
|
279
|
+
// Mode-aware via the theme-owned custom token declared just below.
|
|
280
|
+
background: 'var(--shell-background)',
|
|
281
|
+
},
|
|
282
|
+
requiredCustomTokens: {
|
|
283
|
+
// ...glassTheme.requiredCustomTokens,
|
|
284
|
+
// The continuous app canvas. A soft luminous glow at the top-start
|
|
285
|
+
// corner settling into the page background — light mode is a whisper,
|
|
286
|
+
// dark mode is the deep-navy Revolut-like gradient.
|
|
287
|
+
'shell-background': {
|
|
288
|
+
type: DesignTokenValueType.STRING,
|
|
289
|
+
modeStrategy: DesignTokenModeStrategy.LIGHT_DARK,
|
|
290
|
+
lightValue: 'radial-gradient(140% 100% at 20% 0%, oklch(0.968 0.012 250) 0%, oklch(0.982 0.005 247) 45%, oklch(0.988 0.002 247) 100%)',
|
|
291
|
+
darkValue: 'radial-gradient(140% 100% at 20% 0%, oklch(0.27 0.06 258) 0%, oklch(0.18 0.05 261) 42%, oklch(0.122 0.042 264) 100%)',
|
|
292
|
+
description: 'Continuous app-shell canvas painted by the theme backgroundLayer',
|
|
293
|
+
},
|
|
294
|
+
},
|
|
295
|
+
},
|
|
296
|
+
surfacePolicies: {
|
|
297
|
+
[SurfaceVariant.SHELL]: {
|
|
298
|
+
a11y: {
|
|
299
|
+
landmarkRole: 'main',
|
|
300
|
+
},
|
|
301
|
+
},
|
|
302
|
+
},
|
|
303
|
+
});
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
What earns its place:
|
|
307
|
+
|
|
308
|
+
- `defineDesignSystemConfig({...})` — the **typed factory entrypoint**.
|
|
309
|
+
Pass the raw object to a typed wrapper so the schema validates at
|
|
310
|
+
declaration time. Avoid asserting to `DesignSystemSourceConfig` or the
|
|
311
|
+
merged runtime `DesignSystemConfiguration` — let the factory type-check.
|
|
312
|
+
- `...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG` is spread at every
|
|
313
|
+
nested level (`colors.light`, `colors.dark`, `surfaces.light`, …).
|
|
314
|
+
This is the **only** mechanism that inherits new tokens added in
|
|
315
|
+
framework upgrades — replacing the spread with a literal object
|
|
316
|
+
freezes the app on the framework version that authored it.
|
|
317
|
+
- `oklch(...)` color format — the framework uses `oklch` for hue-stable
|
|
318
|
+
contrast across themes. Project policy forbids new hex / RGB literals in
|
|
319
|
+
source config, even if a lower-level parser would accept some CSS strings.
|
|
320
|
+
- `colors` covers semantic role tokens (`primary`, `secondary`,
|
|
321
|
+
`muted`, `accent`, `border`, `input`, `ring`) and their `-foreground`
|
|
322
|
+
pairs. Foregrounds are required wherever a background is overridden
|
|
323
|
+
— pairs are never auto-derived.
|
|
324
|
+
- `surfaces` covers structural rendering layers (`default`, `sunken`,
|
|
325
|
+
`raised`, `overlay`, `inset`) plus their `-foreground` pairs. These
|
|
326
|
+
are used by container components for layered backgrounds; they are
|
|
327
|
+
**not** re-purposed brand colors.
|
|
328
|
+
- `surfacePolicies` covers behavior, not paint. Use it for container
|
|
329
|
+
semantics such as `SHELL` landmark ownership, overlay geometry,
|
|
330
|
+
nesting/frame behavior, stacking/portal behavior, and generated
|
|
331
|
+
form/display defaults.
|
|
332
|
+
- `customTokens` belongs to the merged runtime `DesignSystemConfiguration`
|
|
333
|
+
shape. In source config, prefer the first-class buckets (`colors`, `sidebar`,
|
|
334
|
+
`zIndex`, etc.); if code ever populates `customTokens` directly, keys must be
|
|
335
|
+
lowercase kebab-case because they emit as CSS custom properties.
|
|
336
|
+
- `sidebar` is a **separate token bucket** — sidebar tokens override
|
|
337
|
+
the global palette specifically for the sidebar surface, so a
|
|
338
|
+
branded sidebar does not require re-painting the whole shell.
|
|
339
|
+
- `theme: defaultTheme` declares the variant family (typography
|
|
340
|
+
scale, motion timings, radii). It is **always** declared, even
|
|
341
|
+
when using the framework default.
|
|
342
|
+
|
|
343
|
+
What is **not** in this block (and shouldn't be):
|
|
344
|
+
|
|
345
|
+
- No spacing / radius / typography primitives — those are in the
|
|
346
|
+
`theme` value, not in `colors` / `surfaces`.
|
|
347
|
+
- No component-specific styles — components consume tokens, they
|
|
348
|
+
don't declare them.
|
|
349
|
+
- No environment-specific overrides — design system is a single
|
|
350
|
+
declaration; staging / production cannot diverge.
|
|
351
|
+
|
|
352
|
+
## References
|
|
353
|
+
|
|
354
|
+
- `references/design-system-file.md` — typical authoring path
|
|
355
|
+
- `references/framework-design-system-configuration-api.md` — source config schema / `defineDesignSystemConfig`
|
|
356
|
+
- `references/framework-material-profile-api.md` — source-backed semantic material roles, optical profiles, fallbacks, interaction, and per-surface performance contract
|
|
357
|
+
- `references/framework-material-runtime-policy-api.md` — source-backed priority and aggregate document-budget contract
|
|
358
|
+
- `references/surface-policy-authoring.md` — app-facing `surfacePolicies`, `SHELL` landmark opt-in/opt-out, active slot and selector-channel status
|
|
359
|
+
- `references/framework-surface-policy-api.md` — source-backed Surface Policy family and default contracts
|
|
360
|
+
|
|
361
|
+
## Verification
|
|
362
|
+
|
|
363
|
+
- [ ] App loads without theme errors / missing-token warnings
|
|
364
|
+
- [ ] Components resolve new tokens (visually verify)
|
|
365
|
+
- [ ] Companion design-system snapshot updated if used
|
|
366
|
+
- [ ] CSS regeneration command run and the resulting CSS file committed
|
|
367
|
+
- [ ] Every overridden background has a matching `-foreground` pair
|
|
368
|
+
- [ ] First-paint bootstrap determines mode without duplicating palette values
|
|
369
|
+
- [ ] No new top-level keys outside the schema
|
|
370
|
+
- [ ] Structured material constants live in `theme.materials`, not component CSS
|
|
371
|
+
- [ ] A glass theme defines one `theme.materialRuntimePolicy` and every glass profile declares semantic `performance.priority`
|
|
372
|
+
- [ ] If `SHELL` opts into `main`, every non-canonical `SHELL` wrapper opts out locally
|
|
373
|
+
- [ ] If a policy slot is selector-channel-only, no broad child behavior was assumed without a component consumer
|
|
374
|
+
|
|
375
|
+
### Grep invariants
|
|
376
|
+
|
|
377
|
+
Run from the app root:
|
|
378
|
+
|
|
379
|
+
| Invariant | Command |
|
|
380
|
+
|--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
381
|
+
| Default config is spread at each nested layer | `rg -n "\.\.\.DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG\." frontend/src/config/design-system.config.ts` |
|
|
382
|
+
| Theme is declared | `rg -n "theme:\s+" frontend/src/config/design-system.config.ts` |
|
|
383
|
+
| Every background token has a foreground pair (sample) | `rg -oN "'\K[a-z-]+(?=':)" frontend/src/config/design-system.config.ts \| rg -v "foreground" \| sort -u` |
|
|
384
|
+
| **No string-literal hex / rgb in the config** (must return empty) | `rg -n "'#[0-9a-fA-F]{3,8}'" frontend/src/config/design-system.config.ts` |
|
|
385
|
+
| **No duplicated first-paint palette literals** (must return empty) | `rg -n "oklch\\(|#[0-9a-fA-F]{3,8}|rgba?\\(" frontend/index.html frontend/src/browser-bootstrap` |
|
|
386
|
+
| Generated CSS exists | `ls -1 frontend/src/styles/design-tokens.css 2>/dev/null \|\| ls -1 frontend/dist/design-tokens.css 2>/dev/null` |
|
|
387
|
+
| Material profiles and aggregate policy stay theme-owned | `rg -n "materials:|materialRuntimePolicy:|priority:" frontend/src/config/design-system.config.ts` |
|
|
388
|
+
| Candidate app-wide SHELL main opt-in lines for manual inspection | `rg -n "SurfaceVariant\\.SHELL|landmarkRole:\\s*'main'" frontend/src/config/design-system.config.ts` |
|
|
389
|
+
| Candidate local SHELL wrappers and opt-outs for manual comparison | `rg -n "variant=\\{SurfaceVariant\\.SHELL\\}|landmarkRole:\\s*'none'" frontend/src` |
|
|
390
|
+
|
|
391
|
+
The first invariant (defaults spread at every layer) is the high-signal
|
|
392
|
+
one — without it, the app freezes on the framework version that authored
|
|
393
|
+
the file and silently loses tokens added in upgrades.
|
|
394
|
+
|
|
395
|
+
## Common Rationalizations
|
|
396
|
+
|
|
397
|
+
| Rationalization | Reality |
|
|
398
|
+
|-----------------|---------|
|
|
399
|
+
| "Tweak the hex in one component" | Tokens centralize change; per-component hex re-introduces drift the design system is built to prevent. |
|
|
400
|
+
| "Skip the spread — I know all tokens" | The spread is what carries forward tokens added in framework upgrades. Without it, your config silently misses new tokens. |
|
|
401
|
+
| "Hex / RGB is fine instead of oklch" | Source config should use `oklch`; hex/RGB literals are treated as policy violations even if a CSS parser could understand them. |
|
|
402
|
+
| "Foreground is auto-derived" | Foregrounds are never auto-derived — every overridden background requires an explicit `-foreground` companion or contrast breaks. |
|
|
403
|
+
| "Copy the background colors into index.html to prevent a flash" | First paint determines mode, not tint. Use `var(--background, Canvas)` so generated tokens remain the only palette source. |
|
|
404
|
+
| "SHELL should just be main everywhere" | `SHELL` is ambient app-shell context by default. Apps opt into one canonical `main`; non-canonical wrappers opt out locally. |
|
|
405
|
+
| "dividerStrategy will clean up all child borders globally" | Some nesting slots are selector channels. Child structures migrate per component family so hidden global selectors do not surprise app layouts. |
|
|
406
|
+
| "Raise the z-index so the popup keeps refraction" | Refractive admission is a semantic cost decision, not stacking. Give the overlay profile `OVERLAY` priority and let the document policy preempt passive glass. |
|
|
407
|
+
| "Disable the material when the GPU budget is full" | The budget only gates the refractive tier. Portable backdrop/fallback material remains visible and interactive. |
|
|
408
|
+
|
|
409
|
+
## Red Flags
|
|
410
|
+
|
|
411
|
+
- Token referenced in JSX but not defined in config (catch by inspecting failing component renders + comparing to schema).
|
|
412
|
+
- Missing `...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.<bucket>.<mode>` spread (catch with the **Default config is spread at each nested layer** grep — must match every nested `light` / `dark` block).
|
|
413
|
+
- Hex / RGB color literal where `oklch` is expected (catch with the **No string-literal hex / rgb** grep — must return empty).
|
|
414
|
+
- Concrete palette literals in `frontend/index.html` or the head bootstrap (catch with the **No duplicated first-paint palette literals** grep — must return empty).
|
|
415
|
+
- New top-level key (`brand`, `extras`, etc.) outside the schema (catch by typecheck — `defineDesignSystemConfig` will reject).
|
|
416
|
+
- Optical constants repeated in components instead of `theme.materials` (catch with the **Material profiles and aggregate policy stay theme-owned** grep and inspect any component-local hits).
|
|
417
|
+
- Glass profiles without a semantic priority or a glass theme without one aggregate runtime policy (catch with the same material-policy grep and schema validation).
|
|
418
|
+
- Duplicate `main` landmarks after setting `[SurfaceVariant.SHELL].a11y.landmarkRole = 'main'` (inspect every candidate local `SHELL` wrapper and verify non-canonical wrappers have a local `landmarkRole: 'none'` override).
|
|
419
|
+
- Treating active selector channels as already-migrated broad behavior, especially `nesting.dividerStrategy`, `nesting.firstChildEdgeStrategy`, `interactiveState.selectableSemantics`, and `interactiveState.gestureOptIn`.
|
|
420
|
+
|
|
421
|
+
## Related Skills
|
|
422
|
+
|
|
423
|
+
- `spec-component-update` — when component contracts depend on token shape
|
|
424
|
+
- `spec-update-after-change` — for spec drift after token changes
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Design System Config
|
|
2
|
+
|
|
3
|
+
**Typical:** `./frontend/src/config/design-system.config.ts`
|
|
4
|
+
|
|
5
|
+
- Tokens, colors, typography, and component presets flow from this file in many apps.
|
|
6
|
+
- The document-head bootstrap is app behavior determination only: it selects
|
|
7
|
+
the semantic theme mode and uses `var(--background, Canvas)` until these
|
|
8
|
+
generated tokens load. It must not duplicate concrete palette values.
|
|
9
|
+
- After changes, CSS token generation or companion design-system introspection may need rerun.
|
|
10
|
+
- Align with `spec-component-update` when component specs describe design tokens.
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Design system source configuration
|
|
2
|
+
|
|
3
|
+
- **`defineDesignSystemConfig`** / **`DesignSystemSourceConfigSchema`** — the app-authored shape for `frontend/src/config/design-system.config.ts`.
|
|
4
|
+
- Import from `@wildo-ai/presets-components-models`.
|
|
5
|
+
- Author nested buckets such as `colors`, `surfaces`, `sidebar`, `zIndex`, `typography`, `theme`, and `surfacePolicies`.
|
|
6
|
+
- Do not copy the merged runtime `DesignSystemConfiguration` shape (`tokens`, `customTokens`, etc.) into source config files.
|
|
7
|
+
|
|
8
|
+
## Import Origins
|
|
9
|
+
|
|
10
|
+
- `@wildo-ai/presets-components-models`
|
|
11
|
+
|
|
12
|
+
## Source Excerpts
|
|
13
|
+
|
|
14
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
/**
|
|
18
|
+
* App-authored design-system source configuration.
|
|
19
|
+
*
|
|
20
|
+
* Import `defineDesignSystemConfig`, `DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG`,
|
|
21
|
+
* and `SurfaceVariant` from `@wildo-ai/presets-components-models` when editing
|
|
22
|
+
* an application's `frontend/src/config/design-system.config.ts`.
|
|
23
|
+
*
|
|
24
|
+
* This source shape is intentionally different from the merged runtime
|
|
25
|
+
* `DesignSystemConfiguration`: apps author nested semantic buckets such as
|
|
26
|
+
* `colors`, `surfaces`, `sidebar`, `zIndex`, `typography`, `theme`, and
|
|
27
|
+
* `surfacePolicies`; the framework then converts those buckets into runtime
|
|
28
|
+
* tokens and generated CSS variables.
|
|
29
|
+
*/
|
|
30
|
+
export const DesignSystemSourceConfigSchema = z.object({
|
|
31
|
+
colors: DesignTokensThemeSectionSchema(DesignTokensCoreColorsSchema),
|
|
32
|
+
statusColors: DesignTokensThemeSectionSchema(DesignTokensStatusColorsSchema),
|
|
33
|
+
surfaces: DesignTokensThemeSectionSchema(DesignTokensSurfacesSchema),
|
|
34
|
+
accentGradient: DesignTokensThemeSectionSchema(DesignTokensAccentGradientSchema).optional(),
|
|
35
|
+
sidebar: z.object({
|
|
36
|
+
light: DesignTokensSidebarLightSchema,
|
|
37
|
+
dark: DesignTokensSidebarDarkSchema,
|
|
38
|
+
}),
|
|
39
|
+
radius: z.string(),
|
|
40
|
+
chartPalette: z.string().refine(
|
|
41
|
+
(value) => isValidChartPaletteSourceValue(value),
|
|
42
|
+
'chartPalette must be a comma-separated list of known Tailwind color names',
|
|
43
|
+
),
|
|
44
|
+
motion: DesignTokensMotionSchema,
|
|
45
|
+
shadows: DesignTokensThemeSectionSchema(DesignTokensShadowsSchema),
|
|
46
|
+
spacing: DesignTokensSpacingSchema,
|
|
47
|
+
opacity: DesignTokensOpacitySchema,
|
|
48
|
+
borderWidth: DesignTokensBorderWidthSchema,
|
|
49
|
+
zIndex: DesignTokensZIndexSchema,
|
|
50
|
+
typography: z.object({
|
|
51
|
+
[TypographyRole.BODY]: DesignSystemSourceTypographyRoleSchema,
|
|
52
|
+
[TypographyRole.HEADING]: DesignSystemSourceTypographyRoleSchema,
|
|
53
|
+
[TypographyRole.MONO]: DesignSystemSourceTypographyRoleSchema,
|
|
54
|
+
[TypographyRole.UI]: DesignSystemSourceTypographyRoleSchema,
|
|
55
|
+
[TypographyRole.DISPLAY]: DesignSystemSourceTypographyRoleSchema,
|
|
56
|
+
}),
|
|
57
|
+
theme: DesignSystemSourceThemeSchema.optional(),
|
|
58
|
+
surfacePolicies: SurfacePolicyOverrideMapSchema.optional(),
|
|
59
|
+
});
|
|
60
|
+
|
|
61
|
+
export type DesignSystemSourceConfig = z.infer<typeof DesignSystemSourceConfigSchema>;
|
|
62
|
+
export type DesignSystemSourceConfigInput = z.input<typeof DesignSystemSourceConfigSchema>;
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Strongly typed app-level design-system declaration.
|
|
66
|
+
*
|
|
67
|
+
* The returned object is the canonical source for:
|
|
68
|
+
* - generated CSS token blocks
|
|
69
|
+
* - frontend runtime design-system configuration
|
|
70
|
+
* - any future companion/static inspection artifacts
|
|
71
|
+
*/
|
|
72
|
+
export function defineDesignSystemConfig(
|
|
73
|
+
config: DesignSystemSourceConfigInput,
|
|
74
|
+
): DesignSystemSourceConfig {
|
|
75
|
+
return DesignSystemSourceConfigSchema.parse(config);
|
|
76
|
+
}
|
|
77
|
+
```
|