@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,292 @@
|
|
|
1
|
+
# saas.website.blog.head-renderer
|
|
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
|
+
* `renderBlogPostHeadHtml(opts)` — sibling of `renderWebsitePageHeadHtml`
|
|
14
|
+
* that emits the SEO `<head>` block for an individual blog post,
|
|
15
|
+
* sourcing per-render copy from a validated `BlogPostFrontmatter`
|
|
16
|
+
* instead of the page manifest's `metaLabelKeys`.
|
|
17
|
+
*
|
|
18
|
+
* # Why a separate renderer (not an overload of the page-head renderer)
|
|
19
|
+
*
|
|
20
|
+
* The framework-mindset rule "every type / bucket / field must carry
|
|
21
|
+
* its semantic weight" pushes against overloading
|
|
22
|
+
* `renderWebsitePageHeadHtml` with a "blog-post mode" flag:
|
|
23
|
+
*
|
|
24
|
+
* - The two renderers have STRUCTURALLY different inputs.
|
|
25
|
+
* `renderWebsitePageHeadHtml` reads `manifest.metaLabelKeys.{titleKey,
|
|
26
|
+
* descriptionKey, ogImageUrl}` + the matching `labelPack` lookup;
|
|
27
|
+
* this renderer reads `frontmatter.{title, summary, coverImageUrl,
|
|
28
|
+
* publishedAt, authorRef, tags}` directly — no label-pack
|
|
29
|
+
* dependency at all (blog body copy is per-post, not
|
|
30
|
+
* per-locale-pack, by design).
|
|
31
|
+
* - The two renderers emit DIFFERENT meta surfaces.
|
|
32
|
+
* `og:type=website` vs. `og:type=article`; the article variant
|
|
33
|
+
* additionally emits `article:published_time`,
|
|
34
|
+
* `article:author`, and `article:tag` (one per `frontmatter.tags`
|
|
35
|
+
* entry). Folding both into one helper would require an
|
|
36
|
+
* `articleMeta?: { ... }` discriminated branch that carries no
|
|
37
|
+
* value when called from a non-blog page — exactly the kind of
|
|
38
|
+
* "convenience union" the framework rules forbid.
|
|
39
|
+
* - The blog-post route itself uses a parameterized `routePath`
|
|
40
|
+
* (`/blog/[slug]`) that needs the SLUG substituted at render time
|
|
41
|
+
* to produce the absolute canonical/hreflang URLs. Page-level
|
|
42
|
+
* routes are always literal — keeping the substitution in this
|
|
43
|
+
* renderer (rather than at the manifest layer) means the page
|
|
44
|
+
* manifest stays free of per-render concerns.
|
|
45
|
+
*
|
|
46
|
+
* Both renderers share the exact same hreflang/canonical/OG locale
|
|
47
|
+
* composition logic — duplicating ~30 lines of stable URL composition
|
|
48
|
+
* is the lesser evil compared to threading a generic options bag
|
|
49
|
+
* through both. If a third renderer ever lands (a "campaign-page" or
|
|
50
|
+
* "tag-page" head emitter, say), the right move is to extract a
|
|
51
|
+
* shared `composeHreflangAndCanonical(...)` helper at that point;
|
|
52
|
+
* doing it now would be premature against the YAGNI line.
|
|
53
|
+
*
|
|
54
|
+
* # The `routePath` argument
|
|
55
|
+
*
|
|
56
|
+
* The blog-post page manifest's `routePath` is `/blog/[slug]` (Astro
|
|
57
|
+
* route-parameter syntax). At render time the consumer's `[slug].astro`
|
|
58
|
+
* has already resolved the slug, so we accept the FULLY-SUBSTITUTED
|
|
59
|
+
* locale-neutral path (e.g. `/blog/why-context-beats-content`) here.
|
|
60
|
+
* `buildLocalizedRoutePath` then handles the locale-prefix decision,
|
|
61
|
+
* mirroring how `WebsiteInternalLink` and `renderWebsitePageHeadHtml`
|
|
62
|
+
* handle their own routes — the locale-prefix rule never lives in two
|
|
63
|
+
* places.
|
|
64
|
+
*
|
|
65
|
+
* # Failure modes
|
|
66
|
+
*
|
|
67
|
+
* Throws nothing — all required frontmatter fields are guaranteed by
|
|
68
|
+
* `parseBlogPostFrontmatter` upstream (same Zod 4 schema). The
|
|
69
|
+
* optional `coverImageUrl` is the only branch: when absent, the
|
|
70
|
+
* Twitter card kind degrades to `summary` (text-only) and `og:image`
|
|
71
|
+
* is omitted entirely.
|
|
72
|
+
*/
|
|
73
|
+
|
|
74
|
+
export interface RenderBlogPostHeadHtmlOptions {
|
|
75
|
+
/**
|
|
76
|
+
* Composed `WebsiteSiteContext` — the renderer reads
|
|
77
|
+
* `websiteConfig.{defaultLocale, locales, publicOrigin}` for the
|
|
78
|
+
* URL/locale surface and `rootConfig.seo.{siteName}` for the
|
|
79
|
+
* brand fallback. `seo.defaultOgImageUrl` is intentionally NOT
|
|
80
|
+
* consulted: blog posts that ship without a `coverImageUrl` get a
|
|
81
|
+
* smaller-card degradation rather than a generic site-wide image
|
|
82
|
+
* (the default OG image is meaningful for marketing pages but
|
|
83
|
+
* misleading for blog posts).
|
|
84
|
+
*/
|
|
85
|
+
siteContext: WebsiteSiteContext;
|
|
86
|
+
/**
|
|
87
|
+
* The locale Astro resolved (with default-locale fallback) for the
|
|
88
|
+
* current request. Drives the `<html lang>` value upstream + the
|
|
89
|
+
* `og:locale` line and the canonical URL's locale-prefix decision.
|
|
90
|
+
*/
|
|
91
|
+
locale: AvailableLanguage;
|
|
92
|
+
/**
|
|
93
|
+
* The fully-substituted locale-neutral route path for the post —
|
|
94
|
+
* typically `/blog/<slug>` with `<slug>` already resolved by the
|
|
95
|
+
* consumer's `[slug].astro` `getStaticPaths()`. Passing the
|
|
96
|
+
* substituted path (rather than the parameterized one) keeps the
|
|
97
|
+
* renderer agnostic of the consumer's route-parameter naming.
|
|
98
|
+
*/
|
|
99
|
+
routePath: string;
|
|
100
|
+
/**
|
|
101
|
+
* Validated frontmatter — the result of `parseBlogPostFrontmatter`.
|
|
102
|
+
* Carrying the parsed (branded) shape here means an unvalidated
|
|
103
|
+
* `entry.data` cannot reach this renderer accidentally (the
|
|
104
|
+
* branded-type signature would reject a raw `unknown`).
|
|
105
|
+
*/
|
|
106
|
+
frontmatter: BlogPostFrontmatter;
|
|
107
|
+
/**
|
|
108
|
+
* AI-training opt-out (D-AG3) — when `true`, the renderer emits
|
|
109
|
+
* `<meta name="robots" content="noai, noimageai">`. The sibling
|
|
110
|
+
* `_headers` entry is produced by `renderBlogPostNoaiHeaders()`
|
|
111
|
+
* (one knob, two channels — see the page-head renderer's
|
|
112
|
+
* companion).
|
|
113
|
+
*
|
|
114
|
+
* **Why a renderer-level option, not a frontmatter field**: the
|
|
115
|
+
* blog-post frontmatter schema (`BlogPostFrontmatterSchema`)
|
|
116
|
+
* doesn't yet expose a per-post AI-opt-out knob — when it does,
|
|
117
|
+
* the consumer's `[slug].astro` will read it from the parsed
|
|
118
|
+
* frontmatter and pass it through here. Keeping the option at
|
|
119
|
+
* the renderer surface NOW means a third-party blog-post catalog
|
|
120
|
+
* (campaigns, customer stories) can opt out without authoring a
|
|
121
|
+
* new frontmatter schema first.
|
|
122
|
+
*/
|
|
123
|
+
noaiOptOut?: boolean;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export interface BuildBlogPostStructuredDataPayloadOptions {
|
|
127
|
+
frontmatter: BlogPostFrontmatter;
|
|
128
|
+
canonicalUrl: string;
|
|
129
|
+
siteOrigin: string;
|
|
130
|
+
siteName: string;
|
|
131
|
+
locale: AvailableLanguage;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
export function buildBlogPostStructuredDataPayload(
|
|
135
|
+
opts: BuildBlogPostStructuredDataPayloadOptions,
|
|
136
|
+
): WebsiteStructuredDataPayload {
|
|
137
|
+
const { frontmatter, canonicalUrl, siteOrigin, siteName, locale } = opts;
|
|
138
|
+
return {
|
|
139
|
+
'@type': 'BlogPosting',
|
|
140
|
+
'@id': `${canonicalUrl}#blog-post`,
|
|
141
|
+
headline: frontmatter.title,
|
|
142
|
+
description: frontmatter.summary,
|
|
143
|
+
datePublished: frontmatter.publishedAt,
|
|
144
|
+
author: {
|
|
145
|
+
'@type': 'Person',
|
|
146
|
+
name: String(frontmatter.authorRef),
|
|
147
|
+
},
|
|
148
|
+
publisher: {
|
|
149
|
+
'@type': 'Organization',
|
|
150
|
+
name: siteName,
|
|
151
|
+
url: siteOrigin,
|
|
152
|
+
},
|
|
153
|
+
mainEntityOfPage: canonicalUrl,
|
|
154
|
+
url: canonicalUrl,
|
|
155
|
+
inLanguage: String(locale),
|
|
156
|
+
...(frontmatter.coverImageUrl ? { image: frontmatter.coverImageUrl } : {}),
|
|
157
|
+
...(frontmatter.tags.length > 0 ? { keywords: frontmatter.tags.join(', ') } : {}),
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
export function renderBlogPostHeadHtml(opts: RenderBlogPostHeadHtmlOptions): string {
|
|
162
|
+
const { siteContext, locale, routePath, frontmatter, noaiOptOut } = opts;
|
|
163
|
+
const { rootConfig, websiteConfig } = siteContext;
|
|
164
|
+
|
|
165
|
+
const title = frontmatter.title;
|
|
166
|
+
const description = frontmatter.summary;
|
|
167
|
+
const ogImageUrl = frontmatter.coverImageUrl;
|
|
168
|
+
const titleAttr = escapeHtmlAttribute(title);
|
|
169
|
+
const descriptionAttr = escapeHtmlAttribute(description);
|
|
170
|
+
const titleText = escapeHtmlText(title);
|
|
171
|
+
|
|
172
|
+
const siteOrigin = websiteConfig.publicOrigin;
|
|
173
|
+
const defaultLocale = websiteConfig.defaultLocale;
|
|
174
|
+
const currentLocaleStr = String(locale);
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* Same locale-prefix composition rule as `renderWebsitePageHeadHtml`
|
|
178
|
+
* — delegated to the shared `buildLocalizedRoutePath` helper so a
|
|
179
|
+
* future change to the prefix policy lands in ONE place and propagates
|
|
180
|
+
* consistently to internal links + page heads + blog-post heads.
|
|
181
|
+
*/
|
|
182
|
+
function buildAbsoluteUrl(forLocale: AvailableLanguage): string {
|
|
183
|
+
const path = buildLocalizedRoutePath({
|
|
184
|
+
locale: forLocale,
|
|
185
|
+
defaultLocale,
|
|
186
|
+
routePath,
|
|
187
|
+
});
|
|
188
|
+
return `${siteOrigin}${path}`;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
const canonicalUrl = buildAbsoluteUrl(locale);
|
|
192
|
+
|
|
193
|
+
const hreflangLines: string[] = [];
|
|
194
|
+
for (const entry of websiteConfig.locales) {
|
|
195
|
+
const localeStr = String(entry.locale);
|
|
196
|
+
hreflangLines.push(
|
|
197
|
+
`<link rel="alternate" hreflang="${escapeHtmlAttribute(localeStr)}" href="${escapeHtmlAttribute(buildAbsoluteUrl(entry.locale))}" />`,
|
|
198
|
+
);
|
|
199
|
+
}
|
|
200
|
+
hreflangLines.push(
|
|
201
|
+
`<link rel="alternate" hreflang="x-default" href="${escapeHtmlAttribute(buildAbsoluteUrl(defaultLocale))}" />`,
|
|
202
|
+
);
|
|
203
|
+
|
|
204
|
+
const ogImageLines: string[] = [];
|
|
205
|
+
if (ogImageUrl !== undefined) {
|
|
206
|
+
const ogImageAttr = escapeHtmlAttribute(ogImageUrl);
|
|
207
|
+
ogImageLines.push(
|
|
208
|
+
`<meta property="og:image" content="${ogImageAttr}" />`,
|
|
209
|
+
`<meta name="twitter:image" content="${ogImageAttr}" />`,
|
|
210
|
+
);
|
|
211
|
+
}
|
|
212
|
+
const twitterCardKind = ogImageUrl !== undefined ? 'summary_large_image' : 'summary';
|
|
213
|
+
|
|
214
|
+
const ogLocaleAlternateLines: string[] = [];
|
|
215
|
+
for (const entry of websiteConfig.locales) {
|
|
216
|
+
const localeStr = String(entry.locale);
|
|
217
|
+
if (localeStr === currentLocaleStr) continue;
|
|
218
|
+
ogLocaleAlternateLines.push(
|
|
219
|
+
`<meta property="og:locale:alternate" content="${escapeHtmlAttribute(localeStr)}" />`,
|
|
220
|
+
);
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
/**
|
|
224
|
+
* `og:article:*` block — the per-post metadata that distinguishes
|
|
225
|
+
* the blog-post head from the page head. The Open Graph "article"
|
|
226
|
+
* vertical defines:
|
|
227
|
+
* - `article:published_time` (ISO-8601 — already validated by
|
|
228
|
+
* the frontmatter schema's `z.iso.datetime`).
|
|
229
|
+
* - `article:author` (free text or URL — we emit the author
|
|
230
|
+
* ref as a free-text string; a future author-registry
|
|
231
|
+
* resolution would emit the author's profile URL instead).
|
|
232
|
+
* - `article:tag` (one tag per emission; the OG spec uses
|
|
233
|
+
* repeated `<meta property="article:tag">` lines, NOT a
|
|
234
|
+
* comma-joined list).
|
|
235
|
+
*
|
|
236
|
+
* `article:section` (the OG "section" field, e.g. "Engineering" /
|
|
237
|
+
* "Product") is intentionally NOT emitted — Your Application has no
|
|
238
|
+
* blog-section taxonomy yet, and emitting an empty section would
|
|
239
|
+
* be worse than omission.
|
|
240
|
+
*/
|
|
241
|
+
const articleMetaLines: string[] = [
|
|
242
|
+
`<meta property="article:published_time" content="${escapeHtmlAttribute(frontmatter.publishedAt)}" />`,
|
|
243
|
+
`<meta property="article:author" content="${escapeHtmlAttribute(frontmatter.authorRef as unknown as string)}" />`,
|
|
244
|
+
];
|
|
245
|
+
for (const tag of frontmatter.tags) {
|
|
246
|
+
articleMetaLines.push(
|
|
247
|
+
`<meta property="article:tag" content="${escapeHtmlAttribute(tag as unknown as string)}" />`,
|
|
248
|
+
);
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
const siteNameAttr = escapeHtmlAttribute(rootConfig.seo.siteName);
|
|
252
|
+
const canonicalAttr = escapeHtmlAttribute(canonicalUrl);
|
|
253
|
+
const ogLocaleAttr = escapeHtmlAttribute(currentLocaleStr);
|
|
254
|
+
const noaiMetaLines: string[] = [];
|
|
255
|
+
if (noaiOptOut === true) {
|
|
256
|
+
noaiMetaLines.push(`<meta name="robots" content="noai, noimageai" />`);
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
const structuredDataHtml = renderPageStructuredData({
|
|
260
|
+
pagePayloads: [
|
|
261
|
+
buildBlogPostStructuredDataPayload({
|
|
262
|
+
frontmatter,
|
|
263
|
+
canonicalUrl,
|
|
264
|
+
siteOrigin,
|
|
265
|
+
siteName: rootConfig.seo.siteName,
|
|
266
|
+
locale,
|
|
267
|
+
}),
|
|
268
|
+
],
|
|
269
|
+
});
|
|
270
|
+
|
|
271
|
+
return [
|
|
272
|
+
`<title>${titleText}</title>`,
|
|
273
|
+
`<meta name="description" content="${descriptionAttr}" />`,
|
|
274
|
+
`<link rel="canonical" href="${canonicalAttr}" />`,
|
|
275
|
+
`<meta property="og:title" content="${titleAttr}" />`,
|
|
276
|
+
`<meta property="og:description" content="${descriptionAttr}" />`,
|
|
277
|
+
`<meta property="og:type" content="article" />`,
|
|
278
|
+
`<meta property="og:url" content="${canonicalAttr}" />`,
|
|
279
|
+
`<meta property="og:site_name" content="${siteNameAttr}" />`,
|
|
280
|
+
`<meta property="og:locale" content="${ogLocaleAttr}" />`,
|
|
281
|
+
...ogLocaleAlternateLines,
|
|
282
|
+
...ogImageLines,
|
|
283
|
+
`<meta name="twitter:card" content="${twitterCardKind}" />`,
|
|
284
|
+
`<meta name="twitter:title" content="${titleAttr}" />`,
|
|
285
|
+
`<meta name="twitter:description" content="${descriptionAttr}" />`,
|
|
286
|
+
...articleMetaLines,
|
|
287
|
+
...noaiMetaLines,
|
|
288
|
+
structuredDataHtml,
|
|
289
|
+
...hreflangLines,
|
|
290
|
+
].join('\n');
|
|
291
|
+
}
|
|
292
|
+
```
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# saas.website.blog.mdx-provider
|
|
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
|
+
* `WebsiteMdxProvider` — thin wrapper around `@mdx-js/react`'s
|
|
14
|
+
* `MDXProvider` that scopes a consumer-supplied `components` map for
|
|
15
|
+
* the entire MDX subtree it wraps.
|
|
16
|
+
*
|
|
17
|
+
* # Why a framework wrapper at all (vs. consumers using `MDXProvider` directly)
|
|
18
|
+
*
|
|
19
|
+
* Three application-facing reasons:
|
|
20
|
+
*
|
|
21
|
+
* 1. **Single API surface for embedded business sections.** The framework
|
|
22
|
+
* owns the provider boundary so consumers
|
|
23
|
+
* never directly import from `@mdx-js/react` — they ship a single
|
|
24
|
+
* `mdxComponents` object literal and the framework picks the
|
|
25
|
+
* provider implementation. If `@mdx-js/react` ever splits its
|
|
26
|
+
* package or changes its provider semantics (it has shipped
|
|
27
|
+
* breaking changes between major versions before), the swap
|
|
28
|
+
* lands in this file with zero consumer churn.
|
|
29
|
+
* 2. **Bundle-isolation discipline.** `@mdx-js/react` is browser-safe
|
|
30
|
+
* but heavy (`mdx/types.js`, `react-context` propagation). Walling
|
|
31
|
+
* it behind a single re-export keeps the import surface auditable
|
|
32
|
+
* through the package's client-bundle boundary: the `mdx` public entry is
|
|
33
|
+
* checked separately and lists `@mdx-js/react` exactly once.
|
|
34
|
+
* 3. **`disableParentContext: false` (default) is the right default.**
|
|
35
|
+
* MDX 3 lets a nested `MDXProvider` inherit components from the
|
|
36
|
+
* parent provider, which is what we want when the per-blog-post
|
|
37
|
+
* provider sits inside a site-wide MDX provider used by landing-page
|
|
38
|
+
* islands.
|
|
39
|
+
* Pinning the option here makes the framework's posture explicit;
|
|
40
|
+
* a future change documents itself as a breaking framework decision
|
|
41
|
+
* rather than a silent `@mdx-js/react` default flip.
|
|
42
|
+
*
|
|
43
|
+
* # The `components` map shape
|
|
44
|
+
*
|
|
45
|
+
* The map is `Record<string, ComponentType<any>>` — every key is the
|
|
46
|
+
* tag name an MDX file uses (`<CTASection ref="post-cta" />` resolves
|
|
47
|
+
* via the `CTASection` key). Values are React components the consumer
|
|
48
|
+
* authored under their own `src/sections/blog.sections.tsx` and
|
|
49
|
+
* wrapped in `<WebsiteSection sectionRef={…} category={…}>` so the
|
|
50
|
+
* label-key context is established before the section's
|
|
51
|
+
* `useWebsiteLabel(slot)` calls fire. The framework does NOT inspect
|
|
52
|
+
* the shape — discipline lives in the consumer's section registry
|
|
53
|
+
* + the label-pack validation boundary (which proves the locale pack covers
|
|
54
|
+
* each section's expected keys).
|
|
55
|
+
*
|
|
56
|
+
* # Why a `ComponentType<any>` value type and not a stricter generic
|
|
57
|
+
*
|
|
58
|
+
* MDX components receive their own props (children, plus whatever the
|
|
59
|
+
* MDX author writes inline as JSX attributes). The type system cannot
|
|
60
|
+
* narrow this through the provider boundary because the MDX compiler
|
|
61
|
+
* does the routing at compile time. `ComponentType<any>` is the
|
|
62
|
+
* convention `@mdx-js/react` itself uses (`MDXComponents` in
|
|
63
|
+
* `mdx/types.js`) — staying compatible with the upstream type avoids
|
|
64
|
+
* a wrap/unwrap dance at every consumer call site.
|
|
65
|
+
*
|
|
66
|
+
* # Bundle boundary
|
|
67
|
+
*
|
|
68
|
+
* Ships into the React-island bundle (consumed transitively from
|
|
69
|
+
* `BlogPost.tsx` which itself sits behind the consumer's per-page
|
|
70
|
+
* bridge file). MUST stay clear of `node:*` and SSR-tier specifiers
|
|
71
|
+
* — the bundle-isolation test walks `mdx.ts` as one of its entries.
|
|
72
|
+
*/
|
|
73
|
+
export interface WebsiteMdxComponentsMap {
|
|
74
|
+
/**
|
|
75
|
+
* Tag-name → component map. The MDX compiler resolves each
|
|
76
|
+
* `<TagName />` in a blog post's body against this object.
|
|
77
|
+
*/
|
|
78
|
+
readonly [tagName: string]: ComponentType<any>;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
export interface WebsiteMdxProviderProps {
|
|
82
|
+
/**
|
|
83
|
+
* Consumer-supplied component overrides. Keys are MDX tag names;
|
|
84
|
+
* values are the React components those tags resolve to.
|
|
85
|
+
*/
|
|
86
|
+
components: WebsiteMdxComponentsMap;
|
|
87
|
+
/**
|
|
88
|
+
* MDX subtree (typically the compiled `<MdxBody/>` from a content
|
|
89
|
+
* collection entry). May render any number of provider-scoped
|
|
90
|
+
* components.
|
|
91
|
+
*/
|
|
92
|
+
children: ReactNode;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
export function WebsiteMdxProvider(props: WebsiteMdxProviderProps): ReactNode {
|
|
96
|
+
const { components, children } = props;
|
|
97
|
+
return <MDXProvider components={components}>{children}</MDXProvider>;
|
|
98
|
+
}
|
|
99
|
+
WebsiteMdxProvider.displayName = 'WebsiteMdxProvider';
|
|
100
|
+
```
|
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
# saas.website.blog.post-renderer
|
|
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
|
+
* `<BlogPost>` — engine-owned per-post page renderer for the marketing
|
|
14
|
+
* blog adapter.
|
|
15
|
+
*
|
|
16
|
+
* # What it does, end-to-end
|
|
17
|
+
*
|
|
18
|
+
* 1. **Strict frontmatter parse.** Reads the raw `entry.data` Astro
|
|
19
|
+
* hands the page (passthrough at the content-collection layer per
|
|
20
|
+
* Path Z, see `blog-post-collection.config.ts`) and runs it
|
|
21
|
+
* through `BlogPostFrontmatterSchema` (Zod 4) — branded `slug` /
|
|
22
|
+
* `authorRef` / `tags`, ISO-8601 `publishedAt`, optional
|
|
23
|
+
* `coverImageUrl`. A failure throws synchronously with a
|
|
24
|
+
* `[blog-post] (source="…")` message; Astro halts the build and
|
|
25
|
+
* points the operator to the offending MDX file.
|
|
26
|
+
* 2. **Renders `<WebsitePageLayout>` with a stable blog-post page
|
|
27
|
+
* ref.** The framework reserves `'blog-post'` as the
|
|
28
|
+
* `WebsitePageRef` for every blog post (see `BLOG_POST_PAGE_REF`
|
|
29
|
+
* below for the rationale). All blog posts share one page ref
|
|
30
|
+
* because the SECTION ref under that page is what's
|
|
31
|
+
* blog-author-controlled (see point 3) — the page-level chrome,
|
|
32
|
+
* label scope, and analytics signal are the same across the entire
|
|
33
|
+
* blog surface.
|
|
34
|
+
* 3. **Wraps the MDX body in `<WebsiteMdxProvider>`.** The consumer
|
|
35
|
+
* passes a `mdxComponents` map (typically containing one or two
|
|
36
|
+
* business-section refs they want available inside post bodies —
|
|
37
|
+
* `<CTASection ref="post-cta" />`, etc.). The provider scopes the
|
|
38
|
+
* map for the duration of the render and ONLY the duration of the
|
|
39
|
+
* render, so two blog posts on the same site can ship different
|
|
40
|
+
* provider configs without leaking.
|
|
41
|
+
* 4. **Emits a hero block (title / summary / publish date / author
|
|
42
|
+
* handle / cover image)** from the parsed frontmatter, then yields
|
|
43
|
+
* to the MDX body. Hero markup is intentionally minimal — the
|
|
44
|
+
* consumer styles it via `WebsiteDesignTokens` custom properties.
|
|
45
|
+
* No CSS file ships from this component; everything is inline
|
|
46
|
+
* style + design-token references.
|
|
47
|
+
*
|
|
48
|
+
* # Why a blog-specific page renderer (vs. the generic page bridge)
|
|
49
|
+
*
|
|
50
|
+
* The `createWebsitePageBridgeIsland` factory takes a `PageComponent`
|
|
51
|
+
* — a React component the page author writes. A blog post has NO React
|
|
52
|
+
* component; the MDX file IS the component (compiled by `@astrojs/mdx`
|
|
53
|
+
* to a default-export React tree). Reusing the page-bridge factory
|
|
54
|
+
* would force the consumer to write a ten-line wrapper per post that
|
|
55
|
+
* imports the MDX module, calls `<MdxBody />`, and re-passes the
|
|
56
|
+
* frontmatter — a cold violation of the "every blog post is one MDX
|
|
57
|
+
* file, period" principle. `<BlogPost>` is the framework's
|
|
58
|
+
* single ten-line wrapper, written once.
|
|
59
|
+
*
|
|
60
|
+
* # Why no per-post `pageRef` / per-section `sectionRef` knobs
|
|
61
|
+
*
|
|
62
|
+
* Two reasons:
|
|
63
|
+
*
|
|
64
|
+
* - **Label-key scope semantics.** A blog post's body has no
|
|
65
|
+
* framework-routed labels (the prose IS in the MDX). The section
|
|
66
|
+
* refs that DO need labels are those an MDX file embeds via the
|
|
67
|
+
* `mdxComponents` map — and those sections were already registered
|
|
68
|
+
* in the consumer's `WEBSITE_SECTIONS` registry with their
|
|
69
|
+
* own `expectedLabelKeys`. Letting blog authors pass arbitrary
|
|
70
|
+
* `sectionRef`s would create unbounded label-key surface area that
|
|
71
|
+
* `assertLabelPacksValid` cannot validate at build start.
|
|
72
|
+
* - **Analytics + chrome consistency.** Marketing teams treat "the
|
|
73
|
+
* blog" as one funnel. A single `pageRef='blog-post'` keeps the
|
|
74
|
+
* `data-website-page-ref` attribute on the layout root constant
|
|
75
|
+
* across every post, so the analytics ingest sees one blog-post
|
|
76
|
+
* page event regardless of slug. Per-post overrides would fragment
|
|
77
|
+
* this without buying any operator value.
|
|
78
|
+
*
|
|
79
|
+
* # Hydration + bundle boundary
|
|
80
|
+
*
|
|
81
|
+
* This component is NOT itself a Bridge factory — it's plain React
|
|
82
|
+
* meant to be rendered inside an Astro `.astro` page. The consumer's
|
|
83
|
+
* per-post Astro template (typically `src/pages/[locale]/blog/[slug].astro`)
|
|
84
|
+
* imports `<BlogPost>` directly and renders it; the surrounding
|
|
85
|
+
* `<WebsitePageBridgeIsland>` provides the runtime context. The MDX
|
|
86
|
+
* runtime (`@mdx-js/react`) is React-only and pulls into the React
|
|
87
|
+
* island bundle — bundle-isolation tests walk `mdx.ts` as their own
|
|
88
|
+
* entry to keep the browser-facing closure auditable.
|
|
89
|
+
*
|
|
90
|
+
* Authoring example:
|
|
91
|
+
*
|
|
92
|
+
* ```astro
|
|
93
|
+
* ---
|
|
94
|
+
* // src/pages/blog/[slug].astro
|
|
95
|
+
* import { getCollection, getEntry } from 'astro:content';
|
|
96
|
+
* import { BlogPost } from '@wildo-ai/saas-website/mdx';
|
|
97
|
+
* import { BLOG_POST_MDX_COMPONENTS } from '@/blog/mdx-components';
|
|
98
|
+
*
|
|
99
|
+
* export async function getStaticPaths() {
|
|
100
|
+
* const posts = await getCollection('blog');
|
|
101
|
+
* return posts
|
|
102
|
+
* .filter((p) => p.data.locale === 'en')
|
|
103
|
+
* .map((p) => ({ params: { slug: p.data.slug }, props: { entry: p } }));
|
|
104
|
+
* }
|
|
105
|
+
*
|
|
106
|
+
* const { entry } = Astro.props;
|
|
107
|
+
* const { Content } = await entry.render();
|
|
108
|
+
* ---
|
|
109
|
+
* <BlogPost
|
|
110
|
+
* rawFrontmatter={entry.data}
|
|
111
|
+
* source={entry.id}
|
|
112
|
+
* mdxComponents={BLOG_POST_MDX_COMPONENTS}
|
|
113
|
+
* client:load
|
|
114
|
+
* >
|
|
115
|
+
* <Content />
|
|
116
|
+
* </BlogPost>
|
|
117
|
+
* ```
|
|
118
|
+
*/
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* Reserved `WebsitePageRef` for every blog post page. Exported so
|
|
122
|
+
* consumers can register a matching `BLOG_POST_PAGE_MANIFEST` in
|
|
123
|
+
* their site root config (the page manifest carries the navigation
|
|
124
|
+
* + label-pack scope; the renderer carries the structural layout).
|
|
125
|
+
*
|
|
126
|
+
* Branded as a plain string literal (cast through `unknown`) because:
|
|
127
|
+
* - The `WebsitePageRef` brand is enforced via Zod's `.brand<>()`,
|
|
128
|
+
* and parsing a string literal at module load time would require
|
|
129
|
+
* dragging the Zod runtime into module init — gratuitous when the
|
|
130
|
+
* ref is a compile-time constant.
|
|
131
|
+
* - `WebsitePageLayout` re-parses any incoming `pageRef` string
|
|
132
|
+
* defensively (see `WebsitePageLayoutProps.pageRef` JSDoc), so the
|
|
133
|
+
* brand is re-asserted at render time anyway.
|
|
134
|
+
*/
|
|
135
|
+
export const BLOG_POST_PAGE_REF: WebsitePageRef = 'blog-post' as unknown as WebsitePageRef;
|
|
136
|
+
|
|
137
|
+
export interface BlogPostProps {
|
|
138
|
+
/**
|
|
139
|
+
* Raw frontmatter object Astro hands the page from `entry.data` (or
|
|
140
|
+
* equivalent). The renderer validates this through
|
|
141
|
+
* `BlogPostFrontmatterSchema` synchronously — invalid shapes throw
|
|
142
|
+
* with a `[blog-post]`-prefixed message. Pass `entry.data` directly;
|
|
143
|
+
* do NOT pre-parse on the consumer side (the framework owns the
|
|
144
|
+
* validation surface so a future schema change lands in ONE place).
|
|
145
|
+
*/
|
|
146
|
+
rawFrontmatter: unknown;
|
|
147
|
+
/**
|
|
148
|
+
* Diagnostic source identifier echoed into validation errors —
|
|
149
|
+
* typically `entry.id` from Astro's content collection (`'en/why-context.mdx'`
|
|
150
|
+
* or similar). Optional but strongly recommended; without it,
|
|
151
|
+
* `parseBlogPostFrontmatter` throws with a generic
|
|
152
|
+
* `[blog-post] Frontmatter failed …` message that does not name the
|
|
153
|
+
* offending file.
|
|
154
|
+
*/
|
|
155
|
+
source?: string;
|
|
156
|
+
/**
|
|
157
|
+
* MDX-tag → React-component map made available inside the post
|
|
158
|
+
* body via `<WebsiteMdxProvider>`. Typically a small object literal
|
|
159
|
+
* exporting one or two business sections the consumer wants
|
|
160
|
+
* available everywhere in the blog surface
|
|
161
|
+
* (`<CTASection ref="post-cta" />`, `<NewsletterSignup />`, etc.).
|
|
162
|
+
*
|
|
163
|
+
* Empty maps are valid — a post body using only standard markdown
|
|
164
|
+
* (no embedded React) needs no overrides.
|
|
165
|
+
*/
|
|
166
|
+
mdxComponents?: WebsiteMdxComponentsMap;
|
|
167
|
+
/**
|
|
168
|
+
* Per-page chrome overrides forwarded straight into
|
|
169
|
+
* `<WebsitePageLayout>`. `null` suppresses the slot entirely;
|
|
170
|
+
* `undefined` (the default) inherits the runtime navigation
|
|
171
|
+
* config's header/footer components. Most blog posts leave both
|
|
172
|
+
* unset to inherit the site-wide chrome.
|
|
173
|
+
*/
|
|
174
|
+
header?: ReactNode | null;
|
|
175
|
+
footer?: ReactNode | null;
|
|
176
|
+
/**
|
|
177
|
+
* The compiled MDX body — typically `<Content />` from Astro's
|
|
178
|
+
* `await entry.render()` call. Rendered inside the
|
|
179
|
+
* `<WebsiteMdxProvider>` boundary so its inline `<TagName />`
|
|
180
|
+
* references resolve against `mdxComponents`.
|
|
181
|
+
*/
|
|
182
|
+
children: ReactNode;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
/**
|
|
186
|
+
* Empty default for `mdxComponents` — defined at module scope (NOT
|
|
187
|
+
* inline in the destructure default) so the object identity is
|
|
188
|
+
* stable across re-renders. Stable identity matters here because
|
|
189
|
+
* `<MDXProvider>`'s internal context value is `useMemo`-derived from
|
|
190
|
+
* the `components` prop; inline `{}` would invalidate every render.
|
|
191
|
+
*/
|
|
192
|
+
const EMPTY_MDX_COMPONENTS: WebsiteMdxComponentsMap = Object.freeze({});
|
|
193
|
+
|
|
194
|
+
export function BlogPost(props: BlogPostProps): ReactNode {
|
|
195
|
+
const {
|
|
196
|
+
rawFrontmatter,
|
|
197
|
+
source,
|
|
198
|
+
mdxComponents = EMPTY_MDX_COMPONENTS,
|
|
199
|
+
header,
|
|
200
|
+
footer,
|
|
201
|
+
children,
|
|
202
|
+
} = props;
|
|
203
|
+
|
|
204
|
+
/**
|
|
205
|
+
* Build the diagnostic context once per render. We do not memoize
|
|
206
|
+
* (one object literal per render is cheaper than the `useMemo`
|
|
207
|
+
* accounting), but we also do not pass `source: undefined`
|
|
208
|
+
* unconditionally because `parseBlogPostFrontmatter` switches on
|
|
209
|
+
* `ctx.source !== undefined` for the error-suffix; passing `{}`
|
|
210
|
+
* when undefined keeps the suffix absent in that case.
|
|
211
|
+
*/
|
|
212
|
+
const parseCtx: ParseBlogPostFrontmatterContext =
|
|
213
|
+
source !== undefined ? { source } : {};
|
|
214
|
+
const frontmatter = parseBlogPostFrontmatter(rawFrontmatter, parseCtx);
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* The hero markup intentionally uses semantic HTML5 elements
|
|
218
|
+
* (`<header>`, `<h1>`, `<time>`, `<address>`) rather than raw
|
|
219
|
+
* `<div>`s so screen readers and crawlers see the post structure
|
|
220
|
+
* without consumer styling intervention. The styling story is:
|
|
221
|
+
* design tokens via the surrounding `WebsiteRuntimeContext` +
|
|
222
|
+
* the consumer's stylesheet — NO CSS ships from this file.
|
|
223
|
+
*/
|
|
224
|
+
return (
|
|
225
|
+
<WebsitePageLayout
|
|
226
|
+
pageRef={BLOG_POST_PAGE_REF}
|
|
227
|
+
header={header}
|
|
228
|
+
footer={footer}
|
|
229
|
+
>
|
|
230
|
+
<article data-website-blog-post-slug={frontmatter.slug as unknown as string}>
|
|
231
|
+
<header>
|
|
232
|
+
{frontmatter.coverImageUrl !== undefined ? (
|
|
233
|
+
<img
|
|
234
|
+
src={frontmatter.coverImageUrl}
|
|
235
|
+
alt=""
|
|
236
|
+
loading="eager"
|
|
237
|
+
data-website-blog-post-cover
|
|
238
|
+
/>
|
|
239
|
+
) : null}
|
|
240
|
+
<h1>{frontmatter.title}</h1>
|
|
241
|
+
<p data-website-blog-post-summary>{frontmatter.summary}</p>
|
|
242
|
+
{/*
|
|
243
|
+
* Meta line is a `<div>`, not a `<p>` — `<address>` is a flow-
|
|
244
|
+
* content element and cannot be a descendant of `<p>` per HTML5
|
|
245
|
+
* (browsers auto-close the `<p>` on `<address>`, which produces
|
|
246
|
+
* a hydration mismatch in React 19). The `<div>` keeps the
|
|
247
|
+
* semantic `<time>` + `<address>` landmarks intact for screen
|
|
248
|
+
* readers + crawlers without violating the parsing rules.
|
|
249
|
+
*/}
|
|
250
|
+
<div data-website-blog-post-meta>
|
|
251
|
+
<time dateTime={frontmatter.publishedAt}>
|
|
252
|
+
{frontmatter.publishedAt}
|
|
253
|
+
</time>
|
|
254
|
+
{' · '}
|
|
255
|
+
<address data-website-blog-post-author>
|
|
256
|
+
{frontmatter.authorRef as unknown as string}
|
|
257
|
+
</address>
|
|
258
|
+
</div>
|
|
259
|
+
{frontmatter.tags.length > 0 ? (
|
|
260
|
+
<ul data-website-blog-post-tags>
|
|
261
|
+
{frontmatter.tags.map((tag) => (
|
|
262
|
+
<li key={tag as unknown as string}>
|
|
263
|
+
{tag as unknown as string}
|
|
264
|
+
</li>
|
|
265
|
+
))}
|
|
266
|
+
</ul>
|
|
267
|
+
) : null}
|
|
268
|
+
</header>
|
|
269
|
+
<WebsiteMdxProvider components={mdxComponents}>
|
|
270
|
+
{children}
|
|
271
|
+
</WebsiteMdxProvider>
|
|
272
|
+
</article>
|
|
273
|
+
</WebsitePageLayout>
|
|
274
|
+
);
|
|
275
|
+
}
|
|
276
|
+
BlogPost.displayName = 'BlogPost';
|
|
277
|
+
|
|
278
|
+
/**
|
|
279
|
+
* Type alias re-export so consumers writing `BLOG_POST_MDX_COMPONENTS:
|
|
280
|
+
* BlogPostMdxComponents = { … }` have a stable name (the underlying
|
|
281
|
+
* type is the same `WebsiteMdxComponentsMap` from the provider).
|
|
282
|
+
*/
|
|
283
|
+
export type BlogPostMdxComponents = WebsiteMdxComponentsMap;
|
|
284
|
+
|
|
285
|
+
/**
|
|
286
|
+
* Convenience type — the Astro `ComponentType` consumers write inline
|
|
287
|
+
* inside a `mdxComponents` map. Re-exported so consumer authoring
|
|
288
|
+
* doesn't need to import from `react` directly.
|
|
289
|
+
*/
|
|
290
|
+
export type BlogPostMdxComponent = ComponentType<any>;
|
|
291
|
+
```
|