@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,698 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: config-app-shell
|
|
3
|
+
description: Configure app shell components — menubar, sidebar, command menu, toolbar, notification center, user dropdown, status bar — and the components hosted inside them. Use when the user says "add a global command palette entry", "enable the Cmd+K command menu", "add record search to the command palette", "make Cmd+K search todos", "turn on omnibox search", "rearrange the sidebar sections", "put the notification center on the right", "put the command menu trigger in the sidebar", "host the search trigger in the sidebar and menubar", "set the command bar trigger width", "show the user avatar without the name", "add a workspace/list scope switcher", "let users pick which list they are working in", "show the switcher options as summary cards", "put an icon on the scope switcher", "disable the activity bar", or any change to global chrome that is not tied to a single resource screen.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Config App Shell
|
|
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 **global frontend shell** (`frontend/src/config/app-shell.config.ts`).
|
|
23
|
+
The exported `appShellConfig` is keyed by `ApplicationLevelComponentType.*`
|
|
24
|
+
and decides which structural surfaces are active, where they sit, and
|
|
25
|
+
which sub-components they host.
|
|
26
|
+
|
|
27
|
+
The file is the **only authoring point** for shell-level component
|
|
28
|
+
arrangement. Resource screens, single-page chrome, and per-route widgets
|
|
29
|
+
all sit **inside** the slots this file declares — they do not redeclare
|
|
30
|
+
them.
|
|
31
|
+
|
|
32
|
+
## App Paths
|
|
33
|
+
|
|
34
|
+
| Surface | Glob (relative to app root) |
|
|
35
|
+
|---------------------|------------------------------------------------------------------------------------------|
|
|
36
|
+
| Shell config | `frontend/src/config/app-shell.config.ts` |
|
|
37
|
+
| Module command items| `frontend/src/modules/<module>/app-shell.module.frontend.ts` (`commandMenuItems` contribution)|
|
|
38
|
+
| Module scope fields | `frontend/src/modules/<module>/app-shell.module.frontend.ts` (`quickSwitcherFields` contribution)|
|
|
39
|
+
| Other app config | `frontend/src/config/*.config.ts` (navigation, design-system, global-views) |
|
|
40
|
+
| Translation labels | `frontend/src/i18n/`, `frontend/src/labels/` (depending on app convention) |
|
|
41
|
+
| Hotkey bindings | Resolved by the engine from `[ApplicationLevelComponentType.HOTKEY]` + per-component `openShortcut` |
|
|
42
|
+
|
|
43
|
+
## When to Use
|
|
44
|
+
|
|
45
|
+
- Enabling the Cmd+K command menu and populating it with static "main action"
|
|
46
|
+
commands and/or live **omnibox record search** (`policy: OMNIBOX` +
|
|
47
|
+
`searchResources`)
|
|
48
|
+
- Adding a global command palette entry, hotkey, or quick action
|
|
49
|
+
- Changing sidebar organization (sections, ordering, behavior)
|
|
50
|
+
- Updating menubar `hostedComponents` placement
|
|
51
|
+
- Declaring a **scope switcher** (`quickSwitcherFields`) — which resource scopes the
|
|
52
|
+
app, and how its control + dropdown present
|
|
53
|
+
- Adjusting user dropdown sections / avatar display
|
|
54
|
+
- Toggling deferred shell surfaces (activity bar, utility panel, control panel)
|
|
55
|
+
- Changing responsive policy (sidebar burger threshold, etc.)
|
|
56
|
+
|
|
57
|
+
## When NOT to Use
|
|
58
|
+
|
|
59
|
+
- Resource-specific operation layout -> `resource-ui-behavior`
|
|
60
|
+
- Navigation transitions / zone routing -> `config-navigation`
|
|
61
|
+
- Design tokens / brand colors -> `config-design-system`
|
|
62
|
+
|
|
63
|
+
## Workflow
|
|
64
|
+
|
|
65
|
+
### Step 1: Read surfaces
|
|
66
|
+
|
|
67
|
+
`references/app-shell-surfaces.md`
|
|
68
|
+
`references/framework-app-shell-api.md`
|
|
69
|
+
|
|
70
|
+
### Step 2: Edit `appShellConfig`
|
|
71
|
+
|
|
72
|
+
Open `frontend/src/config/app-shell.config.ts`. Every key MUST be a
|
|
73
|
+
`ApplicationLevelComponentType.*` enum member — no string literals,
|
|
74
|
+
no implicit defaults. Set a key to `false` to **explicitly disable**
|
|
75
|
+
the surface; omit a key only if the framework documents an implicit
|
|
76
|
+
fallback (rare).
|
|
77
|
+
|
|
78
|
+
### Step 3: Command menu — static commands and/or omnibox search
|
|
79
|
+
|
|
80
|
+
If the change touches the Cmd+K palette, decide the palette **policy** on
|
|
81
|
+
`[ApplicationLevelComponentType.COMMAND_MENU]`:
|
|
82
|
+
|
|
83
|
+
- `CommandBarPolicy.COMMAND_ONLY` (default) — static commands only. Contribute
|
|
84
|
+
"main action" commands from a module's `commandMenuItems` (semantic
|
|
85
|
+
ownership; `frontend/src/modules/<module>/app-shell.module.frontend.ts`), and/or
|
|
86
|
+
the config's own `commands` array for app-global entries.
|
|
87
|
+
- `CommandBarPolicy.OMNIBOX` — static commands **plus** live record search.
|
|
88
|
+
Also declare `searchResources: CommandMenuSearchResource[]` naming which
|
|
89
|
+
resources the omnibox queries. Omitting `searchResources` makes `OMNIBOX`
|
|
90
|
+
behave like `COMMAND_ONLY` (nothing to search).
|
|
91
|
+
|
|
92
|
+
Read `references/framework-command-menu-omnibox-api.md` for the policy +
|
|
93
|
+
search-resource contract.
|
|
94
|
+
|
|
95
|
+
### Step 3b: Host a component in the menubar and/or sidebar
|
|
96
|
+
|
|
97
|
+
To place an app-level component (the Cmd+K trigger, a quick-action button, the
|
|
98
|
+
notification center, …) inside a shell surface, add an entry to that surface's
|
|
99
|
+
`hostedComponents` array:
|
|
100
|
+
|
|
101
|
+
- `[ApplicationLevelComponentType.MENUBAR].hostedComponents` — each entry is a
|
|
102
|
+
`MenubarHostedComponent`; `placement` is a `HorizontalPlacement`
|
|
103
|
+
(`START`/`MIDDLE`/`END`).
|
|
104
|
+
- `[ApplicationLevelComponentType.SIDEBAR].hostedComponents` — each entry is a
|
|
105
|
+
`SidebarHostedComponent`, the vertical mirror; `placement` is a
|
|
106
|
+
`VerticalPlacement` (`TOP`/`BOTTOM`).
|
|
107
|
+
|
|
108
|
+
Set `triggerWidth` on a hosted input-like trigger (today the command-menu "false
|
|
109
|
+
button") to size it: a number is pixels (`240`), a string is any CSS width
|
|
110
|
+
(`'100%'`, `'16rem'`). Hosting the **same** component in both surfaces is
|
|
111
|
+
supported and gives two triggers over ONE shared dialog / hotkey — do not try to
|
|
112
|
+
coordinate that yourself.
|
|
113
|
+
|
|
114
|
+
Read `references/framework-app-shell-hosted-components-api.md` for the
|
|
115
|
+
menubar/sidebar hosted-component contract.
|
|
116
|
+
|
|
117
|
+
### Step 3c: Declare a scope switcher
|
|
118
|
+
|
|
119
|
+
A scope control ("which todo list am I in") is NOT a hosted-component setting —
|
|
120
|
+
hosting decides WHERE the switcher renders, `quickSwitcherFields` decides WHAT it
|
|
121
|
+
scopes. Both are needed: host `ApplicationLevelComponentType.QUICK_SWITCHER` in
|
|
122
|
+
the menubar and/or sidebar (Step 3b), then contribute the field from the module
|
|
123
|
+
that owns the resource:
|
|
124
|
+
|
|
125
|
+
```ts
|
|
126
|
+
// frontend/src/modules/<module>/app-shell.module.frontend.ts
|
|
127
|
+
export const moduleQuickSwitcherFields: QuickSwitcherScopeField[] = [
|
|
128
|
+
{ resourceType: <Module>_ResourceType.TODO_LISTS, fieldIdentifier: 'todoListId', position: 0 },
|
|
129
|
+
];
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Then pick the two INDEPENDENT presentation axes — `optionDisplayMode` for the
|
|
133
|
+
dropdown rows, `presentation` for the closed control. Read
|
|
134
|
+
`references/framework-quick-switcher-scope-field-api.md` for the contract and
|
|
135
|
+
for what the declaration wires for free (ambient scope, URL promotion,
|
|
136
|
+
bi-directional mirroring, deselection).
|
|
137
|
+
|
|
138
|
+
### Step 4: Labels
|
|
139
|
+
|
|
140
|
+
Any new user-visible chrome string (command names, section titles,
|
|
141
|
+
button labels) flows through `i18n-label-generation`. Inline strings
|
|
142
|
+
in this config are forbidden by the chrome i18n pipeline. Command and
|
|
143
|
+
search-result labels auto-derive from each resource's own config — do not
|
|
144
|
+
hard-code them here.
|
|
145
|
+
|
|
146
|
+
### Step 5: Verify and hand off
|
|
147
|
+
|
|
148
|
+
Run the **Verification** checklist and **Grep invariants** below
|
|
149
|
+
against `frontend/src/config/app-shell.config.ts`. **Stop** when (a)
|
|
150
|
+
every invariant returns the expected result (the unique-`ref:`
|
|
151
|
+
invariant must return empty; the typed-enum + `EnginePageRef`
|
|
152
|
+
invariants must return ≥1) AND (b) the shell renders in dev
|
|
153
|
+
without boot warnings. If a chrome label appears as the raw key
|
|
154
|
+
string at runtime, **delegate to `i18n-label-generation`** —
|
|
155
|
+
chrome strings live there, never inline. If `EnginePageRef.*`
|
|
156
|
+
fails to typecheck, **return to Step 2**: a deleted engine page
|
|
157
|
+
was still referenced; remove the entry or restore the page.
|
|
158
|
+
|
|
159
|
+
## Worked Example
|
|
160
|
+
|
|
161
|
+
An application `appShellConfig` can exercise the canonical full-shell shape —
|
|
162
|
+
every supported surface is explicit:
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
## Usage Example
|
|
166
|
+
|
|
167
|
+
```typescript
|
|
168
|
+
export const appShellConfig : AppConfiguration_Frontend['appComponentsConfiguration'] = {
|
|
169
|
+
|
|
170
|
+
// ─── Top bar ───────────────────────────────────────────────────────────────
|
|
171
|
+
/**
|
|
172
|
+
* Menubar display mode:
|
|
173
|
+
* "FIXED" — always visible at the top (standard desktop behavior)
|
|
174
|
+
* "OVERLAY" — overlays content, auto-hides (saves vertical space on small screens)
|
|
175
|
+
* array — responsive rules: different policy per viewport breakpoint
|
|
176
|
+
* false — no menubar at all
|
|
177
|
+
*/
|
|
178
|
+
[ApplicationLevelComponentType.MENUBAR]: {
|
|
179
|
+
displayPolicy: "FIXED",
|
|
180
|
+
// MENUBAR hostedComponents — each entry is a `MenubarHostedComponent`:
|
|
181
|
+
// an app-level component placed at a HorizontalPlacement zone
|
|
182
|
+
// (START / MIDDLE / END; omitted placement defaults to START).
|
|
183
|
+
// Everything sits in the TRAILING cluster, in declaration order:
|
|
184
|
+
// scope switcher → search → notifications → user menu. Order within a zone
|
|
185
|
+
// IS array order, so this list is the visual order.
|
|
186
|
+
hostedComponents: [
|
|
187
|
+
// Still hosted, but whether it RENDERS is the navigation layout's
|
|
188
|
+
// `backAffordanceOwner` policy (default SURFACE → the page header's own
|
|
189
|
+
// back control owns it, and this one draws nothing). Flip the policy to
|
|
190
|
+
// SHELL to move the affordance up here; keeping the host declared is what
|
|
191
|
+
// makes that a one-line policy change rather than a config archaeology.
|
|
192
|
+
{ componentType: ApplicationLevelComponentType.NAVIGATION_CONTROL, placement: HorizontalPlacement.START },
|
|
193
|
+
{ componentType: ApplicationLevelComponentType.QUICK_SWITCHER, placement: HorizontalPlacement.END },
|
|
194
|
+
// Command-menu "false button" trigger — a compact search-input-like control
|
|
195
|
+
// in the menubar, given an explicit 240px width via `triggerWidth`. The same
|
|
196
|
+
// palette is ALSO hosted in the sidebar below; the shell-level interaction
|
|
197
|
+
// owner keeps ONE dialog + ONE Cmd+K registration across both triggers.
|
|
198
|
+
// COMPACT here: in the menubar cluster the palette trigger is an icon
|
|
199
|
+
// button sized like the bell and the avatar. The SIDEBAR copy below keeps
|
|
200
|
+
// the EXPANDED input-like control that fills the rail — same component,
|
|
201
|
+
// per-placement appearance.
|
|
202
|
+
{ componentType: ApplicationLevelComponentType.COMMAND_MENU, placement: HorizontalPlacement.END, triggerAppearance: HostedTriggerAppearance.COMPACT },
|
|
203
|
+
{ componentType: ApplicationLevelComponentType.QUICK_ACTION_BUTTON, placement: HorizontalPlacement.END, breakpoint: ViewportBreakpoint.DESKTOP },
|
|
204
|
+
{ componentType: ApplicationLevelComponentType.NOTIFICATION_CENTER, placement: HorizontalPlacement.END },
|
|
205
|
+
{ componentType: ApplicationLevelComponentType.USER_DROPDOWN, placement: HorizontalPlacement.END },
|
|
206
|
+
],
|
|
207
|
+
items: [],
|
|
208
|
+
},
|
|
209
|
+
|
|
210
|
+
/** Global toolbar below the menubar. Houses contextual actions for the current view. */
|
|
211
|
+
[ApplicationLevelComponentType.TOOLBAR]: true,
|
|
212
|
+
|
|
213
|
+
/** Enable hotkey system. Cmd+K is registered by the command menu surface via `openShortcut`. */
|
|
214
|
+
[ApplicationLevelComponentType.HOTKEY]: true,
|
|
215
|
+
|
|
216
|
+
// ─── Notification center ───────────────────────────────────────────────────
|
|
217
|
+
[ApplicationLevelComponentType.NOTIFICATION_CENTER]: true,
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
|
|
221
|
+
// ─── Sidebar ───────────────────────────────────────────────────────────────
|
|
222
|
+
[ApplicationLevelComponentType.SIDEBAR]: {
|
|
223
|
+
placement: HorizontalPlacement.START,
|
|
224
|
+
collapsible: true,
|
|
225
|
+
responsiveBreakpoint: ViewportBreakpoint.MOBILE,
|
|
226
|
+
responsivePolicy: SidebarResponsivePolicy.BURGER,
|
|
227
|
+
defaultSection: 'main',
|
|
228
|
+
showUncategorized: true,
|
|
229
|
+
// HOME as the app's BRAND HEADER: the generated Your Application symbol + the
|
|
230
|
+
// application display name, pinned above the search trigger and doubling as
|
|
231
|
+
// the home button (so no separate "Home" row renders). The alternatives are
|
|
232
|
+
// `NAVIGATION_ITEM` (a Home row at the top of the primary group — the
|
|
233
|
+
// framework default) and `HIDDEN`.
|
|
234
|
+
homeDisplayMode: SidebarHomeDisplayMode.BRAND_HEADER,
|
|
235
|
+
// The single-colour mark, held across light and dark. Omit this line for the
|
|
236
|
+
// adaptive colour mark (which follows the active theme), or pin
|
|
237
|
+
// `DEFAULT`/`DARK`/`LIGHT` to hold one colour variant.
|
|
238
|
+
brandMarkTheme: BrandAssetTheme.MONOCHROME,
|
|
239
|
+
contentSections: sidebarSections,
|
|
240
|
+
// ALSO host the command-menu trigger at the top of the sidebar (wider —
|
|
241
|
+
// fills the rail). Exercises the generalized hostedComponents mechanism on
|
|
242
|
+
// the sidebar; the trigger opens the SAME palette as the menubar copy.
|
|
243
|
+
// SIDEBAR hostedComponents — each entry is a `SidebarHostedComponent`, the
|
|
244
|
+
// vertical mirror: placement is a VerticalPlacement (TOP/BOTTOM) and here
|
|
245
|
+
// `triggerWidth: '100%'` (a CSS width string) makes the trigger fill the rail.
|
|
246
|
+
hostedComponents: [
|
|
247
|
+
{ componentType: ApplicationLevelComponentType.COMMAND_MENU, placement: VerticalPlacement.TOP, triggerWidth: '100%' },
|
|
248
|
+
],
|
|
249
|
+
},
|
|
250
|
+
|
|
251
|
+
// ─── Command menu ──────────────────────────────────────────────────────────
|
|
252
|
+
// OMNIBOX policy: the palette SEARCHES EVERYTHING — live records over the
|
|
253
|
+
// resources in `searchResources` AND static "main action" commands (contributed
|
|
254
|
+
// by the tasks-manager module's `commandMenuItems`). Typing ≥2 chars queries
|
|
255
|
+
// each resource's SEARCH operation; the todo/task record groups render ABOVE
|
|
256
|
+
// the static command categories (the default single-axis ordering — record
|
|
257
|
+
// groups sit on the low `order` band; tune per group via `searchResources[].order`).
|
|
258
|
+
// The overlay is responsive: a width-capped centered dialog on desktop, a bottom
|
|
259
|
+
// drawer on mobile; the trigger collapses to a search icon on mobile / a
|
|
260
|
+
// collapsed sidebar rail so it stays reachable without the Cmd+K hotkey.
|
|
261
|
+
[ApplicationLevelComponentType.COMMAND_MENU]: {
|
|
262
|
+
policy: CommandBarPolicy.OMNIBOX,
|
|
263
|
+
showRecent: true,
|
|
264
|
+
maxRecentItems: 5,
|
|
265
|
+
showShortcuts: true,
|
|
266
|
+
openShortcut: 'Cmd+K',
|
|
267
|
+
// Cap the desktop palette so it is not full-width; mobile stays near-full
|
|
268
|
+
// (the `sm:` prefix only engages from the sm breakpoint up).
|
|
269
|
+
dialogWidth: 'sm:max-w-2xl',
|
|
270
|
+
commands: [],
|
|
271
|
+
searchResources: [
|
|
272
|
+
{ resourceType: TasksManager_ResourceType.TODOS, category: 'todos', maxResults: 5 },
|
|
273
|
+
{ resourceType: TasksManager_ResourceType.TASKS, category: 'tasks', maxResults: 5 },
|
|
274
|
+
],
|
|
275
|
+
},
|
|
276
|
+
|
|
277
|
+
// ─── Quick action button ───────────────────────────────────────────────────
|
|
278
|
+
[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: true,
|
|
279
|
+
|
|
280
|
+
[ApplicationLevelComponentType.QUICK_SWITCHER]: true,
|
|
281
|
+
[ApplicationLevelComponentType.CONTROL_PANEL]: false,
|
|
282
|
+
[ApplicationLevelComponentType.STATUS_BAR]: {
|
|
283
|
+
showMemoryUsage: false,
|
|
284
|
+
showNotificationCount: true,
|
|
285
|
+
showConnectionStatus: true,
|
|
286
|
+
},
|
|
287
|
+
|
|
288
|
+
// ─── User & settings dropdowns ─────────────────────────────────────────────
|
|
289
|
+
[ApplicationLevelComponentType.USER_DROPDOWN]: {
|
|
290
|
+
avatarDisplay: UserDropdownAvatarDisplay.AVATAR_ONLY,
|
|
291
|
+
sections: [
|
|
292
|
+
UserDropdownSection.USER_INFO,
|
|
293
|
+
UserDropdownSection.ORG_SWITCHER,
|
|
294
|
+
UserDropdownSection.SETTINGS,
|
|
295
|
+
UserDropdownSection.LOGOUT,
|
|
296
|
+
],
|
|
297
|
+
showOrgSwitcher: true,
|
|
298
|
+
showLogout: true,
|
|
299
|
+
},
|
|
300
|
+
|
|
301
|
+
|
|
302
|
+
[ApplicationLevelComponentType.NAVIGATION_CONTROL]: true,
|
|
303
|
+
|
|
304
|
+
// ─── Deferred shell surfaces ───────────────────────────────────────────────
|
|
305
|
+
[ApplicationLevelComponentType.ACTIVITY_BAR]: false,
|
|
306
|
+
[ApplicationLevelComponentType.UTILITY_PANEL]: false,
|
|
307
|
+
};
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
What earns its place:
|
|
311
|
+
|
|
312
|
+
- Every key is `ApplicationLevelComponentType.*` (typed enum). Keys
|
|
313
|
+
evaluate to one of: `boolean` (simple toggle), an object (full
|
|
314
|
+
config), or `false` (explicit disable). Implicit defaults are
|
|
315
|
+
forbidden — declare every supported surface.
|
|
316
|
+
- `MENUBAR.displayPolicy: "FIXED"` — the menubar mode is explicit.
|
|
317
|
+
Other modes (`OVERLAY`, responsive arrays) follow the same shape.
|
|
318
|
+
- `MENUBAR.hostedComponents: [...]` — each entry is
|
|
319
|
+
`{ componentType, placement }` (and optional `breakpoint`). This
|
|
320
|
+
is the **only** place to choose where global controls sit; resource
|
|
321
|
+
pages cannot move them.
|
|
322
|
+
- `SIDEBAR.contentSections` is a `SidebarSection[]`. Each section
|
|
323
|
+
declares `contentKind` (typed), `ref` (stable id used by spec /
|
|
324
|
+
navigation), `behavior` (e.g. `FAVORITES`), `collapsible`, and an
|
|
325
|
+
optional `children` array of `LauncherItemTarget`s. Engine pages
|
|
326
|
+
are referenced by `EnginePageRef.*` (typed) — never by string path.
|
|
327
|
+
- `SIDEBAR.homeDisplayMode` picks how HOME is surfaced, and the three values are
|
|
328
|
+
mutually exclusive presentations of one concept:
|
|
329
|
+
`NAVIGATION_ITEM` (default — a "Home" row atop the primary group),
|
|
330
|
+
`BRAND_HEADER` (your app's symbol + display name pinned above the sidebar's
|
|
331
|
+
hosted search trigger, doubling as the home button — the Slack/Linear/Notion
|
|
332
|
+
shell), or `HIDDEN`. `BRAND_HEADER` draws its mark from the app's generated
|
|
333
|
+
`brandAssets` for the active light/dark theme; with no brand generated (or an
|
|
334
|
+
asset URL your app does not actually serve) it degrades to the name alone, so
|
|
335
|
+
the mode is safe to author before the brand exists.
|
|
336
|
+
- `SIDEBAR.brandMarkTheme` picks WHICH mark variant that header shows, using the
|
|
337
|
+
same `BrandAssetTheme` vocabulary your brand assets are generated under:
|
|
338
|
+
omit it for the adaptive colour mark (it follows light/dark), set
|
|
339
|
+
`MONOCHROME` for the single-colour mark, or pin `DEFAULT`/`DARK`/`LIGHT` to
|
|
340
|
+
hold one variant regardless of theme. A pinned variant your brand never
|
|
341
|
+
generated falls back rather than blanking.
|
|
342
|
+
- Section ORDER in the rendered sidebar is engine policy, not declaration
|
|
343
|
+
order: a navigation-list section marked `isPrimary: true` renders first
|
|
344
|
+
(no header, never collapsible — the app's top-level destinations belong
|
|
345
|
+
there, joined by the framework Home row when `homeDisplayMode` is
|
|
346
|
+
`NAVIGATION_ITEM`); a
|
|
347
|
+
`behavior: SidebarSectionBehavior.FAVORITES` section renders next, and
|
|
348
|
+
everything else follows declaration order. Declare exactly one primary
|
|
349
|
+
section (typically the module contributing the app's core resources).
|
|
350
|
+
- `FAVORITES` sections need NO `children`: the engine populates them from
|
|
351
|
+
the user's starred items (a hover star on every sidebar row; persisted
|
|
352
|
+
per machine) and hides the section entirely while it is empty. Declaring
|
|
353
|
+
the section is what enables the star affordance.
|
|
354
|
+
- `COMMAND_MENU.policy: CommandBarPolicy.OMNIBOX` — the **command palette
|
|
355
|
+
policy**. Here it is `OMNIBOX`, so `searchResources` also declares which
|
|
356
|
+
resources feed live record search (see the dedicated omnibox worked example
|
|
357
|
+
below); `COMMAND_ONLY` would make it static-commands-only. `openShortcut:
|
|
358
|
+
'Cmd+K'` is the declarative hotkey; the engine wires
|
|
359
|
+
`[ApplicationLevelComponentType.HOTKEY]: true` to the platform hotkey
|
|
360
|
+
provider, which is what makes `Cmd+K` reachable.
|
|
361
|
+
- `USER_DROPDOWN.sections: [UserDropdownSection.*, ...]` orders the
|
|
362
|
+
dropdown contents. `settingsEntries: ['profile', 'security']` surfaces
|
|
363
|
+
those Settings Hub sections inline in the dropdown, in that order; omit
|
|
364
|
+
it (or leave it empty) to render the single "Settings" button that opens
|
|
365
|
+
the hub at its default section. The refs name **settings-hub sections**,
|
|
366
|
+
the same vocabulary `settings-hub.config.ts` places — never sidebar
|
|
367
|
+
section refs. There is no separate enable flag: the list is the intent.
|
|
368
|
+
- Deferred surfaces (`ACTIVITY_BAR`, `UTILITY_PANEL`,
|
|
369
|
+
`CONTROL_PANEL`) are explicitly set to `false`. This is **not**
|
|
370
|
+
optional — explicit disable signals "we know this exists, we chose
|
|
371
|
+
off". An omitted key produces a framework warning at boot.
|
|
372
|
+
|
|
373
|
+
What is **not** in this block (and shouldn't be):
|
|
374
|
+
|
|
375
|
+
- No navigation transitions — those live in `navigation.config.ts`.
|
|
376
|
+
- No resource-specific commands — global commands here, per-resource
|
|
377
|
+
actions in `*.ui-behavior.tsx`.
|
|
378
|
+
- No literal user-facing strings — labels go through i18n.
|
|
379
|
+
|
|
380
|
+
### Worked Example — Cmd+K with omnibox record search
|
|
381
|
+
|
|
382
|
+
The command menu has two halves. The **config** half turns the palette on and
|
|
383
|
+
declares the policy + the searchable resource set. In the `appShellConfig`
|
|
384
|
+
block above, the `[COMMAND_MENU]` key sets `policy: CommandBarPolicy.OMNIBOX`,
|
|
385
|
+
`openShortcut: 'Cmd+K'`, and:
|
|
386
|
+
|
|
387
|
+
```ts
|
|
388
|
+
searchResources: [
|
|
389
|
+
{ resourceType: TasksManager_ResourceType.TODOS, category: 'todos', maxResults: 5 },
|
|
390
|
+
{ resourceType: TasksManager_ResourceType.TASKS, category: 'tasks', maxResults: 5 },
|
|
391
|
+
]
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
Each `CommandMenuSearchResource` opts one resource into live, debounced
|
|
395
|
+
(≥2 chars) search over its `SEARCH` operation; a selected result navigates to
|
|
396
|
+
that record's `READ` view. Drop `policy` to `COMMAND_ONLY` (or omit
|
|
397
|
+
`searchResources`) and the palette is static-commands-only.
|
|
398
|
+
|
|
399
|
+
The **static-commands** half is contributed per module, not centrally — this
|
|
400
|
+
is the semantic-ownership idiom (the tasks-manager module owns its own palette
|
|
401
|
+
actions):
|
|
402
|
+
|
|
403
|
+
|
|
404
|
+
## Usage Example
|
|
405
|
+
|
|
406
|
+
```typescript
|
|
407
|
+
*
|
|
408
|
+
* Static "main action" commands surfaced in the Cmd+K palette. LIST targets go
|
|
409
|
+
* under the `navigation` category, CREATE targets under `actions` — matching the
|
|
410
|
+
* default `categoryOrder`. Labels + icons auto-derive from each resource config.
|
|
411
|
+
*
|
|
412
|
+
* We deliberately DO NOT author generic verb/noun `searchKeywords` here: the
|
|
413
|
+
* framework folds in the LOCALIZED operation-verb synonyms (create/list/…) keyed
|
|
414
|
+
* off each command's core operation semantic, and the noun is covered by the
|
|
415
|
+
* command's already-localized label — so a French user finds "Create Todo" by
|
|
416
|
+
* typing "nouveau"/"créer" without any literal. `searchKeywords` is reserved for
|
|
417
|
+
* app-specific jargon a localized label/synonym can't cover (e.g. `"boards"`,
|
|
418
|
+
* `"scratch"`); those literals are intentionally NOT translated.
|
|
419
|
+
* (Live todo/task RECORD search is separate — see `searchResources` in
|
|
420
|
+
* `app-shell.config.ts`.)
|
|
421
|
+
*/
|
|
422
|
+
export const moduleCommandMenuItems: CommandMenuCommand[] = [
|
|
423
|
+
{
|
|
424
|
+
kind: LauncherItemTargetKind.RESOURCE_OPERATION,
|
|
425
|
+
resourceType: TasksManager_ResourceType.TODOS,
|
|
426
|
+
operation: CoreResourceOperation.CREATE,
|
|
427
|
+
category: 'actions',
|
|
428
|
+
},
|
|
429
|
+
{
|
|
430
|
+
kind: LauncherItemTargetKind.RESOURCE_OPERATION,
|
|
431
|
+
resourceType: TasksManager_ResourceType.TASKS,
|
|
432
|
+
operation: CoreResourceOperation.CREATE,
|
|
433
|
+
category: 'actions',
|
|
434
|
+
},
|
|
435
|
+
{
|
|
436
|
+
kind: LauncherItemTargetKind.RESOURCE_OPERATION,
|
|
437
|
+
resourceType: TasksManager_ResourceType.TODOS,
|
|
438
|
+
operation: CoreResourceOperation.LIST,
|
|
439
|
+
category: 'navigation',
|
|
440
|
+
},
|
|
441
|
+
{
|
|
442
|
+
kind: LauncherItemTargetKind.RESOURCE_OPERATION,
|
|
443
|
+
resourceType: TasksManager_ResourceType.TASKS,
|
|
444
|
+
operation: CoreResourceOperation.LIST,
|
|
445
|
+
category: 'navigation',
|
|
446
|
+
},
|
|
447
|
+
{
|
|
448
|
+
kind: LauncherItemTargetKind.RESOURCE_OPERATION,
|
|
449
|
+
resourceType: TasksManager_ResourceType.TODO_LISTS,
|
|
450
|
+
operation: CoreResourceOperation.LIST,
|
|
451
|
+
category: 'navigation',
|
|
452
|
+
// App-specific jargon not covered by the localized label or verb synonyms.
|
|
453
|
+
searchKeywords: ['boards'],
|
|
454
|
+
},
|
|
455
|
+
{
|
|
456
|
+
kind: LauncherItemTargetKind.RESOURCE_OPERATION,
|
|
457
|
+
resourceType: TasksManager_ResourceType.DRAFT_NOTES,
|
|
458
|
+
operation: CoreResourceOperation.LIST,
|
|
459
|
+
category: 'navigation',
|
|
460
|
+
searchKeywords: ['scratch'],
|
|
461
|
+
},
|
|
462
|
+
];
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
What earns its place:
|
|
466
|
+
|
|
467
|
+
- `commandMenuItems` lives on the module's `ShellModuleContributions`
|
|
468
|
+
(`frontend/src/modules/<module>/app-shell.module.frontend.ts`), not in the central
|
|
469
|
+
`app-shell.config.ts`. The engine merges every module's contributions into
|
|
470
|
+
the palette.
|
|
471
|
+
- Each entry is a `RESOURCE_OPERATION` `LauncherItemTargetKind` — labels and
|
|
472
|
+
icons auto-derive from the resource config, so nothing is hard-coded.
|
|
473
|
+
- `category` (`'actions'` / `'navigation'`) groups the entries.
|
|
474
|
+
- **Do not author generic verb/noun `searchKeywords`.** The framework already
|
|
475
|
+
folds in the *localized* operation-verb synonyms (create/list/…) keyed off
|
|
476
|
+
each command's core operation, and the noun is covered by the command's
|
|
477
|
+
already-localized label — so a French user finds "Create Todo" by typing
|
|
478
|
+
`"créer"` with no literal. Reserve `searchKeywords` for app-specific jargon a
|
|
479
|
+
localized label/synonym can't cover (e.g. `"boards"`, `"scratch"`); those
|
|
480
|
+
literals are intentionally **not** translated.
|
|
481
|
+
- This is orthogonal to `searchResources`: static commands are declared
|
|
482
|
+
navigation targets; omnibox results are live records. `OMNIBOX` shows both.
|
|
483
|
+
|
|
484
|
+
### Worked Example — hosting one component in menubar AND sidebar
|
|
485
|
+
|
|
486
|
+
The command-menu trigger may be placed in BOTH shell surfaces at once. This
|
|
487
|
+
pattern hosts it in the menubar (narrow, fixed px) and in the sidebar (fills the rail):
|
|
488
|
+
|
|
489
|
+
|
|
490
|
+
## Usage Example
|
|
491
|
+
|
|
492
|
+
```typescript
|
|
493
|
+
// MENUBAR hostedComponents — each entry is a `MenubarHostedComponent`:
|
|
494
|
+
// an app-level component placed at a HorizontalPlacement zone
|
|
495
|
+
// (START / MIDDLE / END; omitted placement defaults to START).
|
|
496
|
+
// Everything sits in the TRAILING cluster, in declaration order:
|
|
497
|
+
// scope switcher → search → notifications → user menu. Order within a zone
|
|
498
|
+
// IS array order, so this list is the visual order.
|
|
499
|
+
hostedComponents: [
|
|
500
|
+
// Still hosted, but whether it RENDERS is the navigation layout's
|
|
501
|
+
// `backAffordanceOwner` policy (default SURFACE → the page header's own
|
|
502
|
+
// back control owns it, and this one draws nothing). Flip the policy to
|
|
503
|
+
// SHELL to move the affordance up here; keeping the host declared is what
|
|
504
|
+
// makes that a one-line policy change rather than a config archaeology.
|
|
505
|
+
{ componentType: ApplicationLevelComponentType.NAVIGATION_CONTROL, placement: HorizontalPlacement.START },
|
|
506
|
+
{ componentType: ApplicationLevelComponentType.QUICK_SWITCHER, placement: HorizontalPlacement.END },
|
|
507
|
+
// Command-menu "false button" trigger — a compact search-input-like control
|
|
508
|
+
// in the menubar, given an explicit 240px width via `triggerWidth`. The same
|
|
509
|
+
// palette is ALSO hosted in the sidebar below; the shell-level interaction
|
|
510
|
+
// owner keeps ONE dialog + ONE Cmd+K registration across both triggers.
|
|
511
|
+
// COMPACT here: in the menubar cluster the palette trigger is an icon
|
|
512
|
+
// button sized like the bell and the avatar. The SIDEBAR copy below keeps
|
|
513
|
+
// the EXPANDED input-like control that fills the rail — same component,
|
|
514
|
+
// per-placement appearance.
|
|
515
|
+
{ componentType: ApplicationLevelComponentType.COMMAND_MENU, placement: HorizontalPlacement.END, triggerAppearance: HostedTriggerAppearance.COMPACT },
|
|
516
|
+
{ componentType: ApplicationLevelComponentType.QUICK_ACTION_BUTTON, placement: HorizontalPlacement.END, breakpoint: ViewportBreakpoint.DESKTOP },
|
|
517
|
+
{ componentType: ApplicationLevelComponentType.NOTIFICATION_CENTER, placement: HorizontalPlacement.END },
|
|
518
|
+
{ componentType: ApplicationLevelComponentType.USER_DROPDOWN, placement: HorizontalPlacement.END },
|
|
519
|
+
],
|
|
520
|
+
```
|
|
521
|
+
|
|
522
|
+
## Usage Example
|
|
523
|
+
|
|
524
|
+
```typescript
|
|
525
|
+
// SIDEBAR hostedComponents — each entry is a `SidebarHostedComponent`, the
|
|
526
|
+
// vertical mirror: placement is a VerticalPlacement (TOP/BOTTOM) and here
|
|
527
|
+
// `triggerWidth: '100%'` (a CSS width string) makes the trigger fill the rail.
|
|
528
|
+
hostedComponents: [
|
|
529
|
+
{ componentType: ApplicationLevelComponentType.COMMAND_MENU, placement: VerticalPlacement.TOP, triggerWidth: '100%' },
|
|
530
|
+
],
|
|
531
|
+
```
|
|
532
|
+
|
|
533
|
+
What earns its place:
|
|
534
|
+
|
|
535
|
+
- The menubar entry is a `MenubarHostedComponent` (`placement` is a
|
|
536
|
+
`HorizontalPlacement`); the sidebar entry is a `SidebarHostedComponent`
|
|
537
|
+
(`placement` is a `VerticalPlacement`). Same component, two placement axes.
|
|
538
|
+
- `triggerWidth: 240` (a number → 240px) sizes the menubar trigger; the sidebar
|
|
539
|
+
uses `triggerWidth: '100%'` (a CSS width string) to fill the rail. There is no
|
|
540
|
+
width utility to pass here — width is an inline style, so this field is the
|
|
541
|
+
only way to size a hosted trigger.
|
|
542
|
+
- Hosting the SAME `COMMAND_MENU` in both surfaces is intentional and safe: the
|
|
543
|
+
shell-level interaction owner keeps ONE dialog and ONE `Cmd+K` registration
|
|
544
|
+
across both triggers. Do not add a second dialog or a second hotkey.
|
|
545
|
+
- `componentType` is always an `ApplicationLevelComponentType.*` member — never
|
|
546
|
+
a string literal.
|
|
547
|
+
|
|
548
|
+
### Worked Example — a scope switcher with both presentation axes
|
|
549
|
+
|
|
550
|
+
The tasks-manager module scopes the app by todo list. The control is hosted in
|
|
551
|
+
the menubar (Step 3b); this declares what it scopes and how it presents:
|
|
552
|
+
|
|
553
|
+
|
|
554
|
+
## Usage Example
|
|
555
|
+
|
|
556
|
+
```typescript
|
|
557
|
+
*
|
|
558
|
+
* The module's SCOPE controls. A quick-switcher field puts a scope picker into
|
|
559
|
+
* the shell (menubar and/or sidebar) and makes the chosen value ambient: the
|
|
560
|
+
* URL is promoted to the scoped route, and every scope-aware listing filters by
|
|
561
|
+
* it. One field per scope; `position` orders them.
|
|
562
|
+
*/
|
|
563
|
+
export const moduleQuickSwitcherFields: QuickSwitcherScopeField[] = [
|
|
564
|
+
{
|
|
565
|
+
resourceType: TasksManager_ResourceType.TODO_LISTS,
|
|
566
|
+
fieldIdentifier: 'todoListId',
|
|
567
|
+
position: 0,
|
|
568
|
+
persist: true,
|
|
569
|
+
// SUMMARY renders each dropdown option as the list's SUMMARY CARD (its
|
|
570
|
+
// summary-DTO fields) rather than a single label line, so the picker shows
|
|
571
|
+
// what distinguishes one list from another — a name alone does not. The
|
|
572
|
+
// closed trigger keeps showing the plain label either way: a card is an
|
|
573
|
+
// option-row shape, not a control-face shape. `ForeignKeyDisplayMode.LABEL`
|
|
574
|
+
// is the compact alternative.
|
|
575
|
+
optionDisplayMode: ForeignKeyDisplayMode.SUMMARY,
|
|
576
|
+
// ICON_LED: in the menubar the switcher sits in a cluster of icon-only
|
|
577
|
+
// chrome buttons (search, notifications, avatar) with its own text label
|
|
578
|
+
// hidden — so without an icon it is the one control there with no visual
|
|
579
|
+
// identity, reading as a generic input. Leading it with the TODO_LISTS
|
|
580
|
+
// resource icon names what it scopes at a glance and costs no extra row
|
|
581
|
+
// height (the icon renders inside the 36px trigger, so the menubar row
|
|
582
|
+
// stays aligned with its siblings). `LABEL_ABOVE` is the alternative when
|
|
583
|
+
// an app prefers a stacked visible label and accepts a taller bar.
|
|
584
|
+
presentation: QuickSwitcherFieldPresentation.ICON_LED,
|
|
585
|
+
},
|
|
586
|
+
];
|
|
587
|
+
```
|
|
588
|
+
|
|
589
|
+
What earns its place:
|
|
590
|
+
|
|
591
|
+
- `quickSwitcherFields` lives on the MODULE's `ShellModuleContributions`, beside
|
|
592
|
+
`commandMenuItems` — same semantic-ownership idiom: the module that owns the
|
|
593
|
+
resource owns the scope declaration. The central `app-shell.config.ts` only
|
|
594
|
+
decides where the switcher is HOSTED.
|
|
595
|
+
- `fieldIdentifier: 'todoListId'` does not have to exist on a schema. When it
|
|
596
|
+
does not, the framework falls back to the target resource's primary key —
|
|
597
|
+
which is exactly why the option-rendering mode is declared here and cannot be
|
|
598
|
+
read off a `.foreignKeyUI(...)` decorator.
|
|
599
|
+
- `optionDisplayMode: SUMMARY` renders each DROPDOWN ROW as the list's summary
|
|
600
|
+
card, because two lists' names alone do not tell them apart. The closed
|
|
601
|
+
control still shows the plain label — a card is an option-row shape.
|
|
602
|
+
- `presentation: ICON_LED` puts the TODO_LISTS icon at the head of the CLOSED
|
|
603
|
+
control. In the menubar the switcher sits among icon-only chrome buttons with
|
|
604
|
+
its own label hidden, so without an icon it is the one control there with no
|
|
605
|
+
identity. It costs no row height.
|
|
606
|
+
- `persist: true` keeps the choice across sessions, per organization.
|
|
607
|
+
- Nothing here wires filtering, URL promotion, or a clear button. Declaring the
|
|
608
|
+
field is what makes the selection ambient, promotes the URL to the scoped
|
|
609
|
+
route, mirrors ambient scope back into the control, and renders the deselect
|
|
610
|
+
affordance inside it.
|
|
611
|
+
|
|
612
|
+
## References
|
|
613
|
+
|
|
614
|
+
- `references/app-shell-surfaces.md` — author-facing surface list
|
|
615
|
+
- `references/framework-app-shell-api.md` — engine app-level component vocabulary + configuration schema
|
|
616
|
+
- `references/framework-command-menu-omnibox-api.md` — command-menu policy (`CommandBarPolicy`) + omnibox `searchResources` (`CommandMenuSearchResource`) contract
|
|
617
|
+
- `references/framework-app-shell-hosted-components-api.md` — menubar/sidebar `hostedComponents` entry shape (`MenubarHostedComponent` / `SidebarHostedComponent`) + per-placement `triggerWidth`
|
|
618
|
+
- `references/framework-quick-switcher-scope-field-api.md` — `quickSwitcherFields` entry shape (`QuickSwitcherScopeField`), the two independent presentation axes (`optionDisplayMode` / `presentation`), and what a scope declaration wires for free
|
|
619
|
+
|
|
620
|
+
## Verification
|
|
621
|
+
|
|
622
|
+
- [ ] Shell renders without runtime errors
|
|
623
|
+
- [ ] New `hostedComponents` entries route to valid component types
|
|
624
|
+
- [ ] Each `SidebarSection.ref` is unique and stable (used by spec)
|
|
625
|
+
- [ ] `EnginePageRef.*` references resolve at typecheck time
|
|
626
|
+
- [ ] `openShortcut` strings do not collide with existing hotkeys
|
|
627
|
+
- [ ] No surface key omitted (every `ApplicationLevelComponentType.*` declared)
|
|
628
|
+
- [ ] `searchResources` is only set when `policy: CommandBarPolicy.OMNIBOX` (otherwise it is inert)
|
|
629
|
+
- [ ] Every `CommandMenuSearchResource.resourceType` is a registered resource with a `SEARCH` (or `LIST`) operation
|
|
630
|
+
- [ ] Every `hostedComponents` `placement` uses the typed enum for its surface (`HorizontalPlacement.*` for menubar, `VerticalPlacement.*` for sidebar)
|
|
631
|
+
- [ ] Every `quickSwitcherFields` entry names a REGISTERED `resourceType` (a typed `*_ResourceType.*` member, never a string literal)
|
|
632
|
+
- [ ] A declared scope switcher is also HOSTED — `QUICK_SWITCHER` appears in some surface's `hostedComponents`, or the field renders nowhere
|
|
633
|
+
- [ ] `optionDisplayMode` / `presentation` use their typed enums (`ForeignKeyDisplayMode.*`, `QuickSwitcherFieldPresentation.*`)
|
|
634
|
+
- [ ] No hand-rolled "clear scope" button beside the switcher — the control renders its own
|
|
635
|
+
|
|
636
|
+
### Grep invariants
|
|
637
|
+
|
|
638
|
+
Run from the app root:
|
|
639
|
+
|
|
640
|
+
| Invariant | Command |
|
|
641
|
+
|--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
642
|
+
| Every key uses the typed enum | `rg -oN "\[ApplicationLevelComponentType\.[A-Z_]+\]" frontend/src/config/app-shell.config.ts \| sort -u` |
|
|
643
|
+
| No string-literal placement / breakpoint | `rg -n "placement:\s+'[a-z]" frontend/src/config/app-shell.config.ts` (must return empty) |
|
|
644
|
+
| Each `EnginePageRef` reference is typed | `rg -n "pageRef:\s+EnginePageRef\." frontend/src/config/app-shell.config.ts` |
|
|
645
|
+
| Sidebar section refs are unique | `rg -oN "ref:\s+'\K[a-z-]+" frontend/src/config/app-shell.config.ts \| sort \| uniq -d` (must return empty) |
|
|
646
|
+
| Command menu has an `openShortcut` | `rg -n "openShortcut:" frontend/src/config/app-shell.config.ts` |
|
|
647
|
+
| Every `commands: []` entry resolves to a registered `commandId` | `rg -oN "commandId:\s+'\K[A-Z_.]+" frontend/src/config/app-shell.config.ts \| sort -u` then verify each appears in `frontend/src/commands/**/*.ts` (or the engine command registry) |
|
|
648
|
+
| `searchResources` implies `policy: OMNIBOX` | `rg -n "searchResources:" frontend/src/config/app-shell.config.ts` — if it matches, `rg -n "CommandBarPolicy.OMNIBOX" frontend/src/config/app-shell.config.ts` must also match |
|
|
649
|
+
| Module command items are typed launcher refs | `rg -n "kind:\s+LauncherItemTargetKind\." frontend/src/modules/*/app-shell.module.frontend.ts` (each `commandMenuItems` entry must be a typed `LauncherItemTargetKind`, never a string) |
|
|
650
|
+
| Hosted-component placement uses the typed enum | `rg -n "placement:\s+(Horizontal\|Vertical)Placement\." frontend/src/config/app-shell.config.ts` (every `hostedComponents` entry that sets `placement` must use `HorizontalPlacement.*` in the menubar / `VerticalPlacement.*` in the sidebar) |
|
|
651
|
+
| Hosted `triggerWidth` is a number or a literal CSS width | `rg -n "triggerWidth:" frontend/src/config/app-shell.config.ts` (each value is a px number like `240` or a CSS width string like `'100%'`/`'16rem'` — never a bare Tailwind class) |
|
|
652
|
+
| Scope-field resource types are typed | `rg -n "resourceType:\s+'" frontend/src/modules/*/app-shell.module.frontend.ts` (must return empty — every `quickSwitcherFields` entry names a typed `*_ResourceType.*` member) |
|
|
653
|
+
| A declared scope field is actually hosted | `rg -qn "quickSwitcherFields" frontend/src/modules/*/app-shell.module.frontend.ts && rg -n "ApplicationLevelComponentType.QUICK_SWITCHER" frontend/src/config/app-shell.config.ts` (if the first matches, the second must too) |
|
|
654
|
+
| Presentation axes use their typed enums | `rg -n "optionDisplayMode:\|presentation:" frontend/src/modules/*/app-shell.module.frontend.ts` (each value is `ForeignKeyDisplayMode.*` / `QuickSwitcherFieldPresentation.*`, never a quoted string) |
|
|
655
|
+
|
|
656
|
+
The fourth invariant (unique `ref:`) is the high-signal one — duplicate
|
|
657
|
+
section refs collapse silently in the rendered sidebar and break any
|
|
658
|
+
spec or navigation that targets the section.
|
|
659
|
+
|
|
660
|
+
## Common Rationalizations
|
|
661
|
+
|
|
662
|
+
| Rationalization | Reality |
|
|
663
|
+
|-----------------|---------|
|
|
664
|
+
| "Hard-code a shell label" | Shell strings flow through i18n; an inline string is invisible to the translation pipeline. |
|
|
665
|
+
| "Skip a surface key — the default is fine" | Defaults are framework-version-dependent. Explicit `false` (or full config) is the contract; omission produces a boot warning. |
|
|
666
|
+
| "Use a string for `placement` / `breakpoint`" | These are typed enums (`HorizontalPlacement.*`, `ViewportBreakpoint.*`). Strings bypass typecheck and break refactors. |
|
|
667
|
+
| "Two sidebar sections can share a `ref`" | Section refs are stable identifiers used by spec layers and navigation; duplicates silently collapse. |
|
|
668
|
+
| "Set `searchResources` to get record search — policy is irrelevant" | `searchResources` is only consulted when `policy: CommandBarPolicy.OMNIBOX`. Under the default `COMMAND_ONLY` it is dead config; the omnibox never queries. |
|
|
669
|
+
| "Put the main-action commands in `app-shell.config.ts`'s `commands`" | Main actions belong to the module that owns the resource — contribute them via that module's `commandMenuItems`. The central `commands` array is only for app-global entries owned by no module. |
|
|
670
|
+
| "Hard-code the record-search result labels" | Omnibox result labels derive from the searched resource's own frontend label config. There is no label field on `CommandMenuSearchResource` — a hand-typed label would bypass i18n. |
|
|
671
|
+
| "Set `triggerWidth` to a Tailwind width class like `w-60`" | `triggerWidth` is an inline `style.width` — a number (px) or a CSS width string (`'100%'`, `'16rem'`). A Tailwind class is ignored (tailwind-merge cannot override the trigger's default width utility, which is exactly why this field exists). |
|
|
672
|
+
| "Host the command menu in both surfaces, so add a second dialog / Cmd+K binding" | The shared hosting pipeline keeps ONE dialog and ONE hotkey registration across every hosted instance of a component. Two triggers, one dialog — a second dialog or binding double-registers. |
|
|
673
|
+
| "Hosting `QUICK_SWITCHER` in the menubar gives the app a scope switcher" | Hosting decides WHERE it renders; `quickSwitcherFields` decides WHAT it scopes. Host it with no field declared and the component renders nothing at all. |
|
|
674
|
+
| "`optionDisplayMode: SUMMARY` will show the summary card in the closed control too" | It governs DROPDOWN ROWS only. The closed control always shows the plain label — a card is an option-row shape, not a control-face shape. Use `presentation` for the control. |
|
|
675
|
+
| "Add a clear button next to the switcher so users can deselect" | The control already renders a clear affordance inside its trigger whenever a value is selected. A sibling button reads as one more chrome icon in the cluster and names no owner. |
|
|
676
|
+
| "The scope field must exist on the resource schema" | It need not. With no matching schema field the framework falls back to the target resource's primary key — which is why the option-rendering mode is declared on the FIELD and cannot come from a `.foreignKeyUI(...)` decorator. |
|
|
677
|
+
| "`presentation: LABEL_ABOVE` will break the menubar's alignment" | The bar has no fixed height and centre-aligns its row: it grows to fit the tallest hosted control and shorter siblings re-centre. Pick `LABEL_ABOVE` when you want the label and accept a taller bar; `ICON_LED` when you want identity at one row height. |
|
|
678
|
+
|
|
679
|
+
## Red Flags
|
|
680
|
+
|
|
681
|
+
- Command palette entry with no handler / `commandId` — catch with the **Every `commands: []` entry resolves to a registered `commandId`** grep above (every extracted id must appear in the command registry; an orphan id silently no-ops the palette entry).
|
|
682
|
+
- Sidebar `EnginePageRef` referencing a deleted engine page (catch with the **Each `EnginePageRef` reference is typed** grep — TypeScript will already block missing enum members).
|
|
683
|
+
- Duplicate sidebar section `ref` (catch with the **Sidebar section refs are unique** grep — must return empty).
|
|
684
|
+
- String-literal `placement` / `breakpoint` (catch with the **No string-literal placement / breakpoint** grep — must return empty).
|
|
685
|
+
- `searchResources` declared but `policy` left at the default `COMMAND_ONLY` — the omnibox silently never queries (catch with the **`searchResources` implies `policy: OMNIBOX`** grep — both must match together).
|
|
686
|
+
- `CommandMenuSearchResource.resourceType` naming a resource with no `SEARCH`/`LIST` operation — the omnibox fires a query that 404s / no-ops (verify each `resourceType` against the resource registry).
|
|
687
|
+
- `hostedComponents` `placement` given a string literal, or the wrong axis for the surface (a `HorizontalPlacement` in the sidebar, or vice-versa) — catch with the **Hosted-component placement uses the typed enum** grep (menubar → `HorizontalPlacement.*`, sidebar → `VerticalPlacement.*`).
|
|
688
|
+
- `triggerWidth` set to a Tailwind class instead of a px number / CSS width string — the class is silently ignored and the trigger falls back to its default width (catch with the **Hosted `triggerWidth` is a number or a literal CSS width** grep).
|
|
689
|
+
- `quickSwitcherFields` declared but `QUICK_SWITCHER` never hosted — the scope exists in config and renders nowhere (catch with the **A declared scope field is actually hosted** grep — if the first half matches, the second must too).
|
|
690
|
+
- A scope field's `resourceType` given as a string literal — it bypasses typecheck and silently names no registered resource, so the picker loads no options (catch with the **Scope-field resource types are typed** grep — must return empty).
|
|
691
|
+
- `optionDisplayMode` / `presentation` given quoted strings instead of their enums (catch with the **Presentation axes use their typed enums** grep — every extracted value must be an enum member).
|
|
692
|
+
- A hand-rolled "clear scope" button authored beside the switcher — duplicates the affordance the control already renders inside its trigger (catch with the **No hand-rolled clear button** verification item; grep the app for a scope-clear handler).
|
|
693
|
+
|
|
694
|
+
## Related Skills
|
|
695
|
+
|
|
696
|
+
- `config-navigation` — zone-first navigation rules
|
|
697
|
+
- `config-saas` — module / capability composition
|
|
698
|
+
- `i18n-label-generation` — chrome label keys
|