@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,396 @@
|
|
|
1
|
+
# saas.website.blog.bridge
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-website`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
*
|
|
13
|
+
* `createWebsiteBlogPostBridgeIsland(deps)` — factory that returns the
|
|
14
|
+
* React island a consumer's per-locale `*.bridge.tsx` module exports for
|
|
15
|
+
* mounting blog post pages. **Sibling** of `createWebsitePageBridgeIsland`
|
|
16
|
+
* but adapted to the dynamic-routing constraint of the marketing-blog
|
|
17
|
+
* adapter (Phase 7, D-6 = Option A).
|
|
18
|
+
*
|
|
19
|
+
* # Why blog posts cannot reuse the page bridge factory
|
|
20
|
+
*
|
|
21
|
+
* Three structural differences between marketing pages and blog posts
|
|
22
|
+
* forced this dedicated factory shape:
|
|
23
|
+
*
|
|
24
|
+
* 1. **Per-slug body resolution.** A marketing page (`landing`,
|
|
25
|
+
* `pricing`, etc.) has ONE `PageComponent` known at bridge-module
|
|
26
|
+
* load time — the page bridge closes over it. A blog post's body
|
|
27
|
+
* is the compiled MDX module, which varies per slug. Closing the
|
|
28
|
+
* MDX body inside the factory at module load time would force one
|
|
29
|
+
* bridge file per post (defeats Q16=B "one MDX file per post").
|
|
30
|
+
* Instead, the factory closes over a `slugToMdxBody: Record<string,
|
|
31
|
+
* ComponentType>` map — typically built from
|
|
32
|
+
* `import.meta.glob('./content/blog/<locale>/*.mdx', { eager: true })`
|
|
33
|
+
* on the consumer side — and the island accepts the active `slug`
|
|
34
|
+
* as a primitive (JSON-serializable) prop.
|
|
35
|
+
*
|
|
36
|
+
* 2. **Layout already wrapped by `<BlogPost>`.** The page bridge wraps
|
|
37
|
+
* its `PageComponent` in `<WebsitePageLayout pageRef={…}>`. The
|
|
38
|
+
* `<BlogPost>` renderer ALREADY wraps its tree in
|
|
39
|
+
* `<WebsitePageLayout pageRef={BLOG_POST_PAGE_REF}>` (the framework
|
|
40
|
+
* reserves the page ref for the entire blog surface — see
|
|
41
|
+
* `BLOG_POST_PAGE_REF` JSDoc in `BlogPost.tsx`). Reusing the page
|
|
42
|
+
* bridge would double-wrap the layout. This factory instead
|
|
43
|
+
* provides the runtime context and yields directly to `<BlogPost>`,
|
|
44
|
+
* which owns the layout boundary itself.
|
|
45
|
+
*
|
|
46
|
+
* 3. **Astro's React-children context-propagation gap.** Astro
|
|
47
|
+
* renders React component children INDEPENDENTLY of the parent
|
|
48
|
+
* component when the boundary is `.astro` ↔ `.tsx`, even on the
|
|
49
|
+
* server side. This means
|
|
50
|
+
* `<BlogPost client:load><Content /></BlogPost>` written in an
|
|
51
|
+
* `.astro` file would NOT propagate the `<WebsiteMdxProvider>`
|
|
52
|
+
* context to the React components embedded inside `<Content />`
|
|
53
|
+
* (the embedded `<CTASection />` would render WITHOUT the engine's
|
|
54
|
+
* MDX provider scope; the `mdxComponents` map would be ignored).
|
|
55
|
+
* Confirmed via the Astro docs, `@astrojs/react` integration
|
|
56
|
+
* readme, and the documented "Bridging two JSX runtimes" gotcha.
|
|
57
|
+
*
|
|
58
|
+
* The fix: the entire blog post tree (BlogPost + MDX body +
|
|
59
|
+
* embedded section components) lives inside ONE React island. The
|
|
60
|
+
* MDX module is imported as a React component via Astro's
|
|
61
|
+
* `import.meta.glob`, and the bridge renders it as JSX children
|
|
62
|
+
* of `<BlogPost>` from INSIDE the island — no `.astro` ↔ `.tsx`
|
|
63
|
+
* boundary is crossed during the body render.
|
|
64
|
+
*
|
|
65
|
+
* # Why hydration is required (vs. pure SSR)
|
|
66
|
+
*
|
|
67
|
+
* The `WebsiteRuntimeContextProvider` + `<BlogPost>` tree could in
|
|
68
|
+
* theory render on the server only (no `client:*` directive). But:
|
|
69
|
+
*
|
|
70
|
+
* - Embedded sections (`<CTASection />`) typically have their own
|
|
71
|
+
* interactivity (analytics handlers, A/B variant flippers, etc.)
|
|
72
|
+
* that need React event listeners to attach client-side.
|
|
73
|
+
* - The framework's `useWebsiteLabel(...)` hook chain assumes a live
|
|
74
|
+
* React render tree — a pure-SSR tree would freeze label resolution
|
|
75
|
+
* at build time, but any future client-driven label override (e.g.
|
|
76
|
+
* a debug-mode label inspector) would silently break.
|
|
77
|
+
*
|
|
78
|
+
* The factory therefore returns an island that the consumer's `.astro`
|
|
79
|
+
* mounts with `client:load` (or `client:idle` for posts known to be
|
|
80
|
+
* non-interactive). The hydration cost is bounded by the per-locale MDX
|
|
81
|
+
* glob — see "Bundle scaling cliff" below.
|
|
82
|
+
*
|
|
83
|
+
* # Bundle scaling cliff (deferred trade-off)
|
|
84
|
+
*
|
|
85
|
+
* `import.meta.glob({ eager: true })` materializes EVERY post's
|
|
86
|
+
* compiled JS into the per-locale React-island bundle (~5–20 KB per
|
|
87
|
+
* post depending on length and embedded section count). For the
|
|
88
|
+
* Phase 7 dogfood (≤10 posts) this is fine and matches the documented
|
|
89
|
+
* Astro+MDX pattern. Past ~50 posts this becomes a real budget concern.
|
|
90
|
+
* The factory's API is forward-compatible with `{ eager: false }`
|
|
91
|
+
* (lazy loaders): swap the consumer's glob to lazy mode and the
|
|
92
|
+
* `slugToMdxBody[slug]` lookup returns a `() => Promise<{ default:
|
|
93
|
+
* ComponentType }>`; wrap in `React.lazy()` + `<Suspense>` and the
|
|
94
|
+
* factory call site stays unchanged. The migration is a consumer-side
|
|
95
|
+
* change, not an engine API break.
|
|
96
|
+
*
|
|
97
|
+
* # Authoring pattern
|
|
98
|
+
*
|
|
99
|
+
* **Per-locale bridge file** (consumer side, ONE per locale):
|
|
100
|
+
*
|
|
101
|
+
* ```tsx
|
|
102
|
+
* // examples/<app>/website/src/pages-impl/blog-post-en.bridge.tsx
|
|
103
|
+
* import type { ComponentType } from 'react';
|
|
104
|
+
*
|
|
105
|
+
* import { createWebsiteBlogPostBridgeIsland }
|
|
106
|
+
* from '@wildo-ai/saas-website/mdx';
|
|
107
|
+
* import { BLOG_POST_MDX_COMPONENTS }
|
|
108
|
+
* from './blog-post.mdx-components';
|
|
109
|
+
* import { WEBSITE_ROOT_CONFIG } from '../website-root.config';
|
|
110
|
+
*
|
|
111
|
+
* // Static analyzable glob — Vite resolves at build time. The glob
|
|
112
|
+
* // pattern MUST be a single string literal (no concatenation, no
|
|
113
|
+
* // variable interpolation); Vite parses it AST-side. The `as` cast
|
|
114
|
+
* // narrows the unknown record to the per-MDX-file shape Astro's mdx
|
|
115
|
+
* // integration emits (default export = the compiled React component).
|
|
116
|
+
* const rawModules = import.meta.glob('./content/blog/en/*.mdx', {
|
|
117
|
+
* eager: true,
|
|
118
|
+
* }) as Record<string, { default: ComponentType }>;
|
|
119
|
+
*
|
|
120
|
+
* const slugToMdxBody: Record<string, ComponentType> = {};
|
|
121
|
+
* for (const [path, mod] of Object.entries(rawModules)) {
|
|
122
|
+
* // './content/blog/en/why-context.mdx' -> 'why-context'
|
|
123
|
+
* const slug = path.split('/').pop()!.replace(/\.mdx$/, '');
|
|
124
|
+
* slugToMdxBody[slug] = mod.default;
|
|
125
|
+
* }
|
|
126
|
+
*
|
|
127
|
+
* export const BlogPostEnBridgeIsland =
|
|
128
|
+
* createWebsiteBlogPostBridgeIsland({
|
|
129
|
+
* slugToMdxBody,
|
|
130
|
+
* navigation: WEBSITE_ROOT_CONFIG.navigation,
|
|
131
|
+
* mdxComponents: BLOG_POST_MDX_COMPONENTS,
|
|
132
|
+
* });
|
|
133
|
+
* ```
|
|
134
|
+
*
|
|
135
|
+
* **Per-locale `[slug].astro` shell** (consumer side):
|
|
136
|
+
*
|
|
137
|
+
* ```astro
|
|
138
|
+
* ---
|
|
139
|
+
* import { getCollection } from 'astro:content';
|
|
140
|
+
* import {
|
|
141
|
+
* loadWebsitePageRuntime,
|
|
142
|
+
* renderBlogPostHeadHtml,
|
|
143
|
+
* renderWebsiteDesignTokensCss,
|
|
144
|
+
* } from '@wildo-ai/saas-website/astro';
|
|
145
|
+
* import { parseBlogPostFrontmatter } from '@wildo-ai/saas-website/mdx';
|
|
146
|
+
* import { BlogPostEnBridgeIsland } from '@/pages-impl/blog-post-en.bridge';
|
|
147
|
+
* import { BLOG_POST_PAGE_MANIFEST } from '@/pages-impl/blog-post.page';
|
|
148
|
+
* import { WEBSITE_SITE_CONTEXT } from '@/website-site-context';
|
|
149
|
+
*
|
|
150
|
+
* export async function getStaticPaths() {
|
|
151
|
+
* const posts = await getCollection('blog');
|
|
152
|
+
* const defaultLocale = WEBSITE_SITE_CONTEXT.websiteConfig.defaultLocale;
|
|
153
|
+
* return posts
|
|
154
|
+
* .filter((p) => p.data.locale === defaultLocale)
|
|
155
|
+
* .map((p) => ({ params: { slug: p.data.slug }, props: { entry: p } }));
|
|
156
|
+
* }
|
|
157
|
+
* const { entry } = Astro.props;
|
|
158
|
+
*
|
|
159
|
+
* const runtime = loadWebsitePageRuntime({
|
|
160
|
+
* manifest: BLOG_POST_PAGE_MANIFEST,
|
|
161
|
+
* siteContext: WEBSITE_SITE_CONTEXT,
|
|
162
|
+
* labelPacksDir: './src/i18n',
|
|
163
|
+
* astroLocale: Astro.currentLocale,
|
|
164
|
+
* });
|
|
165
|
+
* const frontmatter = parseBlogPostFrontmatter(entry.data, { source: entry.id });
|
|
166
|
+
* const headHtml = renderBlogPostHeadHtml({
|
|
167
|
+
* siteContext: WEBSITE_SITE_CONTEXT,
|
|
168
|
+
* locale: runtime.locale,
|
|
169
|
+
* routePath: `/blog/${frontmatter.slug}`,
|
|
170
|
+
* frontmatter,
|
|
171
|
+
* });
|
|
172
|
+
* const designTokensCss = renderWebsiteDesignTokensCss(
|
|
173
|
+
* WEBSITE_SITE_CONTEXT.rootConfig.designTokens,
|
|
174
|
+
* );
|
|
175
|
+
* ---
|
|
176
|
+
* <!doctype html>
|
|
177
|
+
* <html lang={runtime.locale}>
|
|
178
|
+
* <head>
|
|
179
|
+
* <meta charset="UTF-8" />
|
|
180
|
+
* <meta name="viewport" content="width=device-width,initial-scale=1.0" />
|
|
181
|
+
* <Fragment set:html={headHtml} />
|
|
182
|
+
* <style set:html={designTokensCss}></style>
|
|
183
|
+
* </head>
|
|
184
|
+
* <body>
|
|
185
|
+
* <BlogPostEnBridgeIsland
|
|
186
|
+
* client:load
|
|
187
|
+
* slug={frontmatter.slug}
|
|
188
|
+
* rawFrontmatter={entry.data}
|
|
189
|
+
* source={entry.id}
|
|
190
|
+
* locale={runtime.locale}
|
|
191
|
+
* defaultLocale={runtime.defaultLocale}
|
|
192
|
+
* labelPack={runtime.labelPack}
|
|
193
|
+
* designTokens={WEBSITE_SITE_CONTEXT.rootConfig.designTokens}
|
|
194
|
+
* skipToMainContentLabelKey={
|
|
195
|
+
* WEBSITE_SITE_CONTEXT.rootConfig.skipToMainContentLabelKey
|
|
196
|
+
* }
|
|
197
|
+
* />
|
|
198
|
+
* </body>
|
|
199
|
+
* </html>
|
|
200
|
+
* ```
|
|
201
|
+
*
|
|
202
|
+
* # Boundary
|
|
203
|
+
*
|
|
204
|
+
* Strictly client-bundle-safe (re-exported from `mdx.ts` — NOT from
|
|
205
|
+
* `astro-island.ts`, because this module hard-imports the MDX adapter
|
|
206
|
+
* whose `@mdx-js/react` peer is optional; walked by the
|
|
207
|
+
* bundle-isolation test). MUST stay clear of `node:*` and SSR-tier
|
|
208
|
+
* specifiers.
|
|
209
|
+
*/
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* Module-load-time dependencies — closed over inside the returned
|
|
213
|
+
* island. NEVER cross the hydration boundary as serialized props.
|
|
214
|
+
*/
|
|
215
|
+
export interface CreateWebsiteBlogPostBridgeIslandDeps {
|
|
216
|
+
/**
|
|
217
|
+
* Per-slug map of compiled MDX bodies (each entry is a React
|
|
218
|
+
* component — the `.default` export of the MDX module). Typically
|
|
219
|
+
* built from `import.meta.glob('./content/blog/<locale>/*.mdx',
|
|
220
|
+
* { eager: true })` with the path-key normalized to the slug. Closed
|
|
221
|
+
* over at module-load time so the entire MDX body graph for the
|
|
222
|
+
* locale lands inside ONE React island bundle (D-6 Option A) — this
|
|
223
|
+
* is the structural fix for Astro's React-children context-propagation
|
|
224
|
+
* gap (see file preamble).
|
|
225
|
+
*
|
|
226
|
+
* The map is read by `slugToMdxBody[props.slug]` at island render
|
|
227
|
+
* time. A missing slug throws a clear framework-owned error (rather than
|
|
228
|
+
* rendering an empty body silently); the consumer's `getStaticPaths`
|
|
229
|
+
* is responsible for not emitting routes for slugs absent from the
|
|
230
|
+
* map.
|
|
231
|
+
*
|
|
232
|
+
* **Why `ComponentType<any>` and not a stricter generic**: matches
|
|
233
|
+
* the upstream `@mdx-js/react` convention (`MDXContent` from
|
|
234
|
+
* `mdx/types` is parameterized over an open `MDXProps` shape). MDX
|
|
235
|
+
* compilation hands the body a compiler-managed props object that
|
|
236
|
+
* the type system cannot narrow at the framework boundary; using
|
|
237
|
+
* `<any>` here keeps the consumer's
|
|
238
|
+
* `import.meta.glob(...) as Record<string, { default: ComponentType }>`
|
|
239
|
+
* cast assignable without an additional wrap/unwrap. Same posture
|
|
240
|
+
* as `WebsiteMdxComponentsMap` (intentional symmetry).
|
|
241
|
+
*/
|
|
242
|
+
slugToMdxBody: Readonly<Record<string, ComponentType<any>>>;
|
|
243
|
+
/**
|
|
244
|
+
* Site-wide navigation slot bindings (header / footer components).
|
|
245
|
+
* Closed over here for the same reason as the page bridge: both
|
|
246
|
+
* fields are `ComponentType` refs that cannot survive Astro's
|
|
247
|
+
* serialization boundary.
|
|
248
|
+
*/
|
|
249
|
+
navigation: WebsiteNavigationConfig;
|
|
250
|
+
/**
|
|
251
|
+
* MDX-tag → React-component map forwarded into `<BlogPost>` and
|
|
252
|
+
* scoped via `<WebsiteMdxProvider>`. Typically a small object
|
|
253
|
+
* literal exporting the consumer-authored business sections that
|
|
254
|
+
* blog posts can embed (`<CTASection />`, etc.). Closed over here
|
|
255
|
+
* (rather than passed as an island prop) because the values are
|
|
256
|
+
* `ComponentType` refs.
|
|
257
|
+
*/
|
|
258
|
+
mdxComponents?: WebsiteMdxComponentsMap;
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/**
|
|
262
|
+
* Hydration-boundary props — what the consumer's `.astro` page passes
|
|
263
|
+
* to `<BlogPostEnBridgeIsland client:load ...{primitiveProps}/>`.
|
|
264
|
+
* Every field is JSON-serializable.
|
|
265
|
+
*/
|
|
266
|
+
export interface WebsiteBlogPostBridgeIslandProps {
|
|
267
|
+
/**
|
|
268
|
+
* Slug of the post being rendered. Used by the island to look up
|
|
269
|
+
* the matching MDX body in `deps.slugToMdxBody`. Carried as a plain
|
|
270
|
+
* string (not the branded `BlogPostSlug`) because Astro's
|
|
271
|
+
* serialization boundary unwraps brands.
|
|
272
|
+
*/
|
|
273
|
+
slug: string;
|
|
274
|
+
/**
|
|
275
|
+
* Raw frontmatter object Astro hands the page from `entry.data`.
|
|
276
|
+
* Forwarded straight to `<BlogPost>` for strict Zod-4 validation.
|
|
277
|
+
* The bridge does NOT re-validate (single validation surface, owned
|
|
278
|
+
* by the renderer).
|
|
279
|
+
*/
|
|
280
|
+
rawFrontmatter: unknown;
|
|
281
|
+
/**
|
|
282
|
+
* Diagnostic source identifier echoed into validation errors —
|
|
283
|
+
* typically `entry.id` from Astro's content collection. Optional
|
|
284
|
+
* but recommended for actionable error messages.
|
|
285
|
+
*/
|
|
286
|
+
source?: string;
|
|
287
|
+
/** The locale Astro resolved (with default-locale fallback). */
|
|
288
|
+
locale: AvailableLanguage;
|
|
289
|
+
/**
|
|
290
|
+
* The site's default locale. Required for `WebsiteInternalLink`
|
|
291
|
+
* locale-prefix logic (mirrors the page bridge's `defaultLocale`
|
|
292
|
+
* island prop).
|
|
293
|
+
*/
|
|
294
|
+
defaultLocale: AvailableLanguage;
|
|
295
|
+
/** Already-loaded + already-shape-validated label pack. */
|
|
296
|
+
labelPack: LabelPack;
|
|
297
|
+
/** Design-token bundle from `WebsiteRootConfig.designTokens`. */
|
|
298
|
+
designTokens: WebsiteDesignTokens;
|
|
299
|
+
/**
|
|
300
|
+
* Fully-composed label key the framework reads to render the
|
|
301
|
+
* "Skip to main content" affordance. Mirrors
|
|
302
|
+
* `WebsiteRootConfig.skipToMainContentLabelKey`. Carried as a
|
|
303
|
+
* primitive island prop for the same reason as the page bridge.
|
|
304
|
+
*/
|
|
305
|
+
skipToMainContentLabelKey: WebsiteLabelKey;
|
|
306
|
+
/** Optional website-facing public providers materialized at build time. */
|
|
307
|
+
frontendProviders?: FrontendProvidersBlock;
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
const EMPTY_MDX_COMPONENTS: WebsiteMdxComponentsMap = Object.freeze({});
|
|
311
|
+
|
|
312
|
+
/**
|
|
313
|
+
* Returns a FUNCTION component, not the wider `ComponentType` union. The island IS a function
|
|
314
|
+
* component — Astro hydrates nothing else here — and the union is not callable, so declaring it
|
|
315
|
+
* cost callers the ability to invoke the island directly (which the bridge suites do, to observe
|
|
316
|
+
* the synchronous throw for an unregistered slug without routing it through React's reconciler
|
|
317
|
+
* error path). `FunctionComponent` is assignable to `ComponentType`, so no consumer narrows.
|
|
318
|
+
*/
|
|
319
|
+
export function createWebsiteBlogPostBridgeIsland(
|
|
320
|
+
deps: CreateWebsiteBlogPostBridgeIslandDeps,
|
|
321
|
+
): FunctionComponent<WebsiteBlogPostBridgeIslandProps> {
|
|
322
|
+
const {
|
|
323
|
+
slugToMdxBody,
|
|
324
|
+
navigation,
|
|
325
|
+
mdxComponents = EMPTY_MDX_COMPONENTS,
|
|
326
|
+
} = deps;
|
|
327
|
+
|
|
328
|
+
function WebsiteBlogPostBridgeIsland({
|
|
329
|
+
slug,
|
|
330
|
+
rawFrontmatter,
|
|
331
|
+
source,
|
|
332
|
+
locale,
|
|
333
|
+
defaultLocale,
|
|
334
|
+
labelPack,
|
|
335
|
+
designTokens,
|
|
336
|
+
skipToMainContentLabelKey,
|
|
337
|
+
frontendProviders,
|
|
338
|
+
}: WebsiteBlogPostBridgeIslandProps): ReactNode {
|
|
339
|
+
const MdxBody = slugToMdxBody[slug];
|
|
340
|
+
if (MdxBody === undefined) {
|
|
341
|
+
/**
|
|
342
|
+
* Loud failure — the consumer's `getStaticPaths` is supposed to
|
|
343
|
+
* only emit routes for slugs present in the MDX glob. A missing
|
|
344
|
+
* lookup means the glob and the collection are out of sync; the
|
|
345
|
+
* operator needs an actionable error string with the offending
|
|
346
|
+
* slug + the keys that ARE present (truncated to keep the build
|
|
347
|
+
* log readable).
|
|
348
|
+
*/
|
|
349
|
+
const knownKeys = Object.keys(slugToMdxBody);
|
|
350
|
+
const known =
|
|
351
|
+
knownKeys.length <= 5
|
|
352
|
+
? knownKeys.join(', ')
|
|
353
|
+
: `${knownKeys.slice(0, 5).join(', ')}, … (${knownKeys.length} total)`;
|
|
354
|
+
throw new Error(
|
|
355
|
+
`[blog-post-bridge] No MDX body registered for slug="${slug}". ` +
|
|
356
|
+
`The bridge factory's slugToMdxBody map only knows: ${known}. ` +
|
|
357
|
+
`Verify the consumer's import.meta.glob('...content/blog/<locale>/*.mdx') ` +
|
|
358
|
+
`pattern matches the source file naming.`,
|
|
359
|
+
);
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
const runtimeValue: WebsiteRuntimeContextValue = {
|
|
363
|
+
locale,
|
|
364
|
+
defaultLocale,
|
|
365
|
+
labelPack,
|
|
366
|
+
designTokens,
|
|
367
|
+
navigation,
|
|
368
|
+
skipToMainContentLabelKey,
|
|
369
|
+
frontendProviderRegistry: createFrontendWebsiteProviderRegistry(frontendProviders),
|
|
370
|
+
};
|
|
371
|
+
return (
|
|
372
|
+
<WebsiteRuntimeContextProvider value={runtimeValue}>
|
|
373
|
+
<BlogPost
|
|
374
|
+
rawFrontmatter={rawFrontmatter}
|
|
375
|
+
source={source}
|
|
376
|
+
mdxComponents={mdxComponents}
|
|
377
|
+
>
|
|
378
|
+
<MdxBody />
|
|
379
|
+
</BlogPost>
|
|
380
|
+
</WebsiteRuntimeContextProvider>
|
|
381
|
+
);
|
|
382
|
+
}
|
|
383
|
+
WebsiteBlogPostBridgeIsland.displayName = 'WebsiteBlogPostBridgeIsland';
|
|
384
|
+
|
|
385
|
+
return WebsiteBlogPostBridgeIsland;
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
/**
|
|
389
|
+
* Re-export of the framework-reserved blog-post page ref. Consumers
|
|
390
|
+
* authoring `BLOG_POST_PAGE_MANIFEST` need this constant to satisfy
|
|
391
|
+
* the manifest's `ref` field; re-exporting it from the bridge module
|
|
392
|
+
* means the consumer's per-locale bridge file can grab both symbols
|
|
393
|
+
* from the one `@wildo-ai/saas-website/mdx` import it already has.
|
|
394
|
+
*/
|
|
395
|
+
export { BLOG_POST_PAGE_REF };
|
|
396
|
+
```
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
# saas.website.blog.collection-config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-website`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Astro content-collection bridge for blog posts (Phase 7 D-3 = Path Z).
|
|
14
|
+
*
|
|
15
|
+
* # The Zod-version bridge problem
|
|
16
|
+
*
|
|
17
|
+
* Astro's `astro:content` ships its own bundled Zod (currently 3.x).
|
|
18
|
+
* Our `BlogPostFrontmatterSchema` is Zod 4 and uses Zod-4-only APIs
|
|
19
|
+
* (`z.iso.datetime`, `z.url(...)`, `.brand<>()`). The two cannot share
|
|
20
|
+
* a schema instance directly across the version boundary, and shimming
|
|
21
|
+
* a Zod 4 schema down to a Zod 3 schema would create either:
|
|
22
|
+
*
|
|
23
|
+
* - a hand-mirrored copy (Path X) — maintained in `src/content/config.ts`
|
|
24
|
+
* using Astro's `z`, with silent-drift risk every time a field is
|
|
25
|
+
* added/removed/refined; or
|
|
26
|
+
* - a runtime bridge package (Path C) — a non-trivial maintenance
|
|
27
|
+
* surface for a marginal gain.
|
|
28
|
+
*
|
|
29
|
+
* Path Z (this file) sidesteps the bridge entirely: the consumer's
|
|
30
|
+
* `src/content/config.ts` declares a `passthrough` collection schema
|
|
31
|
+
* that lets Astro accept any frontmatter shape; the engine then
|
|
32
|
+
* validates with the canonical Zod 4 schema at render time inside
|
|
33
|
+
* `<BlogPost>`. Astro's static site generator runs the page render
|
|
34
|
+
* during the build, so a malformed frontmatter still surfaces as a
|
|
35
|
+
* BUILD-TIME error (the `.parse()` call throws synchronously and Astro
|
|
36
|
+
* reports it with the page URL) — the only practical difference vs.
|
|
37
|
+
* Path X is the error-message stack location.
|
|
38
|
+
*
|
|
39
|
+
* # Why the engine ships an opaque shape (rather than the consumer
|
|
40
|
+
* importing the Astro `z` directly)
|
|
41
|
+
*
|
|
42
|
+
* Astro's content-collection API has churned across Astro 4 → 5
|
|
43
|
+
* (loaders moved from string-keyed `type` to a callable `loader`
|
|
44
|
+
* factory; the `glob()` loader's signature changed). Every consumer
|
|
45
|
+
* touching `defineCollection` directly inherits that churn; centralizing
|
|
46
|
+
* the wiring in the engine means the framework absorbs the upgrade
|
|
47
|
+
* cost in ONE place when Astro bumps a major.
|
|
48
|
+
*
|
|
49
|
+
* The shape returned here is `{ schema: <passthrough record> }`. The
|
|
50
|
+
* consumer spreads it into their `defineCollection` call:
|
|
51
|
+
*
|
|
52
|
+
* ```ts
|
|
53
|
+
* // examples/<app>/website/src/content/config.ts
|
|
54
|
+
* import { defineCollection, z } from 'astro:content';
|
|
55
|
+
* import { buildBlogPostCollectionConfig } from '@wildo-ai/saas-website/mdx';
|
|
56
|
+
*
|
|
57
|
+
* export const collections = {
|
|
58
|
+
* blog: defineCollection({
|
|
59
|
+
* type: 'content',
|
|
60
|
+
* ...buildBlogPostCollectionConfig({ astroZ: z }),
|
|
61
|
+
* }),
|
|
62
|
+
* };
|
|
63
|
+
* ```
|
|
64
|
+
*
|
|
65
|
+
* The consumer passes Astro's own `z` in (because the engine cannot
|
|
66
|
+
* import `astro:content` — that virtual module only exists inside
|
|
67
|
+
* the Astro build context, never at the engine package's compile
|
|
68
|
+
* time, and importing it would also pull `astro` into the engine's
|
|
69
|
+
* walked closure which the bundle-isolation test forbids). The engine
|
|
70
|
+
* builds a passthrough `z.object({}).passthrough()` from the supplied
|
|
71
|
+
* factory and returns the schema slot.
|
|
72
|
+
*
|
|
73
|
+
* # `parseBlogPostFrontmatter`
|
|
74
|
+
*
|
|
75
|
+
* Companion render-time validator. Called at the top of `<BlogPost>`
|
|
76
|
+
* with the raw `entry.data` Astro hands the page; returns the
|
|
77
|
+
* branded, validated `BlogPostFrontmatter` (Zod 4) or throws with
|
|
78
|
+
* the standard Zod-4 issue formatting + a `[blog-post]` prefix that
|
|
79
|
+
* tells the SSG operator which file to fix.
|
|
80
|
+
*
|
|
81
|
+
* # Boundary
|
|
82
|
+
*
|
|
83
|
+
* This file is React-runtime-safe: it only imports the (also
|
|
84
|
+
* React-safe) `BlogPostFrontmatterSchema` from `schemas/blog/`. It
|
|
85
|
+
* ships into the React-island bundle via the `mdx.ts` barrel, which
|
|
86
|
+
* the bundle-isolation test walks as a dedicated entry. Helpers that
|
|
87
|
+
* parse raw MDX source live in `blog-post-frontmatter-source.ts` so the
|
|
88
|
+
* `yaml` package stays on the build-time/Node side of the boundary.
|
|
89
|
+
*/
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* Minimal contract for the Astro-side Zod factory we accept. Typed
|
|
93
|
+
* structurally (rather than imported from `astro:content`) so the
|
|
94
|
+
* engine package can compile/test without an Astro install. Astro's
|
|
95
|
+
* actual `z.object` returns a much richer Zod-3 schema; we narrow to
|
|
96
|
+
* just the `.passthrough()` call we make below.
|
|
97
|
+
*/
|
|
98
|
+
export interface AstroZodFactoryShape {
|
|
99
|
+
object: (shape: Record<string, never>) => {
|
|
100
|
+
passthrough: () => unknown;
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
export interface BuildBlogPostCollectionConfigOptions {
|
|
105
|
+
/**
|
|
106
|
+
* Astro's bundled `z` object — pass `import { z } from 'astro:content'`
|
|
107
|
+
* from the consumer-side `src/content/config.ts`. The engine cannot
|
|
108
|
+
* import `astro:content` itself (virtual module, only present inside
|
|
109
|
+
* the Astro build pipeline; would also bloat the bundle-isolation
|
|
110
|
+
* walked closure with the `astro` runtime).
|
|
111
|
+
*/
|
|
112
|
+
astroZ: AstroZodFactoryShape;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
export interface BlogPostCollectionConfigShape {
|
|
116
|
+
/**
|
|
117
|
+
* The schema slot consumed by Astro's `defineCollection({...})`.
|
|
118
|
+
* A `passthrough` record (no field constraints at this layer) so
|
|
119
|
+
* Astro accepts any frontmatter; the strict Zod-4 validation runs
|
|
120
|
+
* at render time inside `<BlogPost>` via
|
|
121
|
+
* `parseBlogPostFrontmatter(...)`.
|
|
122
|
+
*/
|
|
123
|
+
schema: unknown;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export function buildBlogPostCollectionConfig(
|
|
127
|
+
opts: BuildBlogPostCollectionConfigOptions,
|
|
128
|
+
): BlogPostCollectionConfigShape {
|
|
129
|
+
const { astroZ } = opts;
|
|
130
|
+
return {
|
|
131
|
+
schema: astroZ.object({}).passthrough(),
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Strict Zod-4 validator for blog-post frontmatter. Called at the top
|
|
137
|
+
* of `<BlogPost>` rendering against `entry.data` (whatever Astro's
|
|
138
|
+
* passthrough collection schema accepted). Throws on validation
|
|
139
|
+
* failure with a `[blog-post]`-prefixed message that points to the
|
|
140
|
+
* offending file via the surrounding render call site.
|
|
141
|
+
*
|
|
142
|
+
* @param raw — the unvalidated frontmatter object Astro supplies
|
|
143
|
+
* (`entry.data` from `getEntry('blog', slug)` or `getCollection('blog')`).
|
|
144
|
+
* @param ctx — diagnostic context appended to the error message so
|
|
145
|
+
* the consumer can find the failing source file when SSG halts.
|
|
146
|
+
* Optional but recommended.
|
|
147
|
+
*/
|
|
148
|
+
export interface ParseBlogPostFrontmatterContext {
|
|
149
|
+
/**
|
|
150
|
+
* The MDX file's path or slug. Echoed into the error message when
|
|
151
|
+
* validation fails so the operator can grep for it. Astro typically
|
|
152
|
+
* gives consumers `entry.id` (the slug + extension) — passing it
|
|
153
|
+
* through here is enough for an actionable error.
|
|
154
|
+
*/
|
|
155
|
+
readonly source?: string;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
export function parseBlogPostFrontmatter(
|
|
159
|
+
raw: unknown,
|
|
160
|
+
ctx: ParseBlogPostFrontmatterContext = {},
|
|
161
|
+
): BlogPostFrontmatter {
|
|
162
|
+
const result = BlogPostFrontmatterSchema.safeParse(raw);
|
|
163
|
+
if (result.success) {
|
|
164
|
+
return result.data;
|
|
165
|
+
}
|
|
166
|
+
const sourceSuffix = ctx.source !== undefined ? ` (source="${ctx.source}")` : '';
|
|
167
|
+
/**
|
|
168
|
+
* Zod 4's `result.error.message` is the JSON-stringified `issues[]` array —
|
|
169
|
+
* long-form, it floods the Astro build log, and the path is what an operator
|
|
170
|
+
* needs to find the broken frontmatter field. `formatZodIssues` is the
|
|
171
|
+
* framework-canonical rendering (one `path: message` per entry); we only own
|
|
172
|
+
* the bullet prefix. Unbounded on purpose: every bad field in a post should
|
|
173
|
+
* be fixable from one build run.
|
|
174
|
+
*/
|
|
175
|
+
const issueLines = formatZodIssues(result.error.issues).map((entry) => ` - ${entry}`);
|
|
176
|
+
throw new Error(
|
|
177
|
+
`[blog-post] Frontmatter failed BlogPostFrontmatterSchema validation${sourceSuffix}:\n${issueLines.join('\n')}`,
|
|
178
|
+
);
|
|
179
|
+
}
|
|
180
|
+
```
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
# saas.website.blog.frontmatter
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-website`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* `BlogPostFrontmatter` — the YAML frontmatter contract every blog
|
|
14
|
+
* post MDX file under `examples/<app>/website/src/content/blog/<locale>/`
|
|
15
|
+
* MUST satisfy.
|
|
16
|
+
*
|
|
17
|
+
* **Q16=B context**: blogs are authored as full per-locale MDX files
|
|
18
|
+
* (one MDX per (slug, locale) pair), NOT as label-pack-keyed content.
|
|
19
|
+
* The frontmatter therefore carries strings directly (`title`,
|
|
20
|
+
* `summary`) rather than label keys — there is no shared
|
|
21
|
+
* label-pack-driven authoring surface for blog content. This is
|
|
22
|
+
* intentional: blog copy is long-form and locale-divergent; forcing
|
|
23
|
+
* it through a structural label-pack would either inflate the pack
|
|
24
|
+
* or fragment the prose.
|
|
25
|
+
*
|
|
26
|
+
* **Field rationale**:
|
|
27
|
+
*
|
|
28
|
+
* - `title` — REQUIRED. Renders into `<title>`, `og:title`, and the
|
|
29
|
+
* in-page H1. Authored as a direct string, deliberately.
|
|
30
|
+
* - `summary` — REQUIRED. Renders into `<meta name="description">`,
|
|
31
|
+
* `og:description`, and listing-card descriptions. Direct string.
|
|
32
|
+
* - `slug` — REQUIRED. URL slug (lowercase kebab-case). Brand prevents
|
|
33
|
+
* accidental swap with `WebsitePageRef` (same shape, different role).
|
|
34
|
+
* - `locale` — REQUIRED. The post's locale. Drives the URL prefix
|
|
35
|
+
* (`/<locale>/blog/<slug>`) and `<html lang>`. Cross-locale
|
|
36
|
+
* correspondence is established by sharing the `slug` across
|
|
37
|
+
* per-locale MDX files (e.g. `en/why-context.md` and
|
|
38
|
+
* `fr/why-context.md` are the same post in two locales).
|
|
39
|
+
* - `publishedAt` — REQUIRED. ISO-8601 date-time string. Renders into
|
|
40
|
+
* `og:article:published_time` and the listing-card date label.
|
|
41
|
+
* Stored as string (not `z.coerce.date`) because YAML frontmatter
|
|
42
|
+
* parsers preserve the original string and the SEO emitters need
|
|
43
|
+
* the original ISO formatting (no Date.toISOString() round-trip
|
|
44
|
+
* loss).
|
|
45
|
+
* - `authorRef` — REQUIRED. Identifier of the author resolved by the
|
|
46
|
+
* consumer's author registry (typically a `src/content/authors/<ref>.ts`
|
|
47
|
+
* file). Brand keeps it distinct from page/section refs.
|
|
48
|
+
* - `tags` — REQUIRED, possibly empty. Lowercase kebab-case tag
|
|
49
|
+
* identifiers. Drives `og:article:tag` and the listing-page facets.
|
|
50
|
+
* - `coverImageUrl` — OPTIONAL. CDN URL for the blog post hero image
|
|
51
|
+
* and `og:image`.
|
|
52
|
+
*
|
|
53
|
+
* **Why a separate file from the page-manifest**: a blog post is NOT
|
|
54
|
+
* a `WebsitePageManifest` (no React `pageComponent` to mount — the
|
|
55
|
+
* MDX file IS the content). The Astro adapter emits one MDX route
|
|
56
|
+
* per post via `content collections`, with `BlogPostFrontmatter`
|
|
57
|
+
* driving the route generation and the SEO emission.
|
|
58
|
+
*/
|
|
59
|
+
const _BlogPostSlugSchema = z
|
|
60
|
+
.string()
|
|
61
|
+
.min(1, { error: 'BlogPostSlug must not be empty' })
|
|
62
|
+
.max(96, { error: 'BlogPostSlug must be at most 96 characters' })
|
|
63
|
+
.regex(
|
|
64
|
+
/^[a-z][a-z0-9-]*$/,
|
|
65
|
+
{ error: 'BlogPostSlug must be lowercase kebab-case starting with a letter' },
|
|
66
|
+
)
|
|
67
|
+
.brand<'BlogPostSlug'>();
|
|
68
|
+
|
|
69
|
+
export const BlogPostSlugSchema: typeof _BlogPostSlugSchema = _BlogPostSlugSchema;
|
|
70
|
+
|
|
71
|
+
export type BlogPostSlug = z.infer<typeof _BlogPostSlugSchema>;
|
|
72
|
+
|
|
73
|
+
const _BlogAuthorRefSchema = z
|
|
74
|
+
.string()
|
|
75
|
+
.min(1, { error: 'BlogAuthorRef must not be empty' })
|
|
76
|
+
.max(64, { error: 'BlogAuthorRef must be at most 64 characters' })
|
|
77
|
+
.regex(
|
|
78
|
+
/^[a-z][a-z0-9-]*$/,
|
|
79
|
+
{ error: 'BlogAuthorRef must be lowercase kebab-case starting with a letter' },
|
|
80
|
+
)
|
|
81
|
+
.brand<'BlogAuthorRef'>();
|
|
82
|
+
|
|
83
|
+
export const BlogAuthorRefSchema: typeof _BlogAuthorRefSchema = _BlogAuthorRefSchema;
|
|
84
|
+
|
|
85
|
+
export type BlogAuthorRef = z.infer<typeof _BlogAuthorRefSchema>;
|
|
86
|
+
|
|
87
|
+
const _BlogPostTagSchema = z
|
|
88
|
+
.string()
|
|
89
|
+
.min(1, { error: 'BlogPostTag must not be empty' })
|
|
90
|
+
.max(48, { error: 'BlogPostTag must be at most 48 characters' })
|
|
91
|
+
.regex(
|
|
92
|
+
/^[a-z][a-z0-9-]*$/,
|
|
93
|
+
{ error: 'BlogPostTag must be lowercase kebab-case starting with a letter' },
|
|
94
|
+
)
|
|
95
|
+
.brand<'BlogPostTag'>();
|
|
96
|
+
|
|
97
|
+
export const BlogPostTagSchema: typeof _BlogPostTagSchema = _BlogPostTagSchema;
|
|
98
|
+
|
|
99
|
+
export type BlogPostTag = z.infer<typeof _BlogPostTagSchema>;
|
|
100
|
+
|
|
101
|
+
const _BlogPostFrontmatterSchema = z.object({
|
|
102
|
+
title: z.string().min(1, { error: 'title must not be empty' }).max(200, { error: 'title must be at most 200 characters' }),
|
|
103
|
+
summary: z.string().min(1, { error: 'summary must not be empty' }).max(400, { error: 'summary must be at most 400 characters' }),
|
|
104
|
+
slug: _BlogPostSlugSchema,
|
|
105
|
+
locale: z.enum(AvailableLanguage),
|
|
106
|
+
publishedAt: z.iso.datetime({ error: 'publishedAt must be an ISO-8601 datetime string' }),
|
|
107
|
+
authorRef: _BlogAuthorRefSchema,
|
|
108
|
+
tags: z.array(_BlogPostTagSchema),
|
|
109
|
+
coverImageUrl: z.url({ error: 'coverImageUrl must be a valid URL' }).optional(),
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
export const BlogPostFrontmatterSchema: typeof _BlogPostFrontmatterSchema =
|
|
113
|
+
_BlogPostFrontmatterSchema;
|
|
114
|
+
|
|
115
|
+
export type BlogPostFrontmatter = z.infer<typeof _BlogPostFrontmatterSchema>;
|
|
116
|
+
```
|