@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,950 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: website-section-contact
|
|
3
|
+
description: Author a Contact section that wires its form into the `InboundContact CREATE` flow via `useSubmitInboundContact()`. Use `defineWebsiteSection({ category: WebsiteSectionCategory.CONTACT, … })`. Use when the user says "add a contact section", "wire a contact form to inbound contacts", "compose a contact-us section with email + topic", or "build a sales-contact landing form".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Website Section: Contact
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
# Website Section — Authoring API (source-backed)
|
|
21
|
+
|
|
22
|
+
Shared API excerpts for every `website_section_<category>` skill. The
|
|
23
|
+
contract is identical across categories; the per-category guidance lives
|
|
24
|
+
in each skill's own `SKILL.md`.
|
|
25
|
+
|
|
26
|
+
## Category vocabulary (closed enum)
|
|
27
|
+
|
|
28
|
+
The `category` field on `defineWebsiteSection` is a closed enum, not a
|
|
29
|
+
free string. Adding a new value requires seeding a matching
|
|
30
|
+
`website_section_<value>` skill folder (1:1 invariant).
|
|
31
|
+
|
|
32
|
+
## Import Origins
|
|
33
|
+
|
|
34
|
+
- `@wildo-ai/saas-website`
|
|
35
|
+
|
|
36
|
+
## Source Excerpts
|
|
37
|
+
|
|
38
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
39
|
+
|
|
40
|
+
```typescript
|
|
41
|
+
*
|
|
42
|
+
* `WebsiteSectionCategory` — closed vocabulary tagging the **structural
|
|
43
|
+
* intent** of a section.
|
|
44
|
+
*
|
|
45
|
+
* The category is NOT a layout-shape constraint and NOT a CSS class; the
|
|
46
|
+
* framework ships zero concrete sections and never inspects
|
|
47
|
+
* the category at render time. The category exists for three orthogonal
|
|
48
|
+
* non-render concerns:
|
|
49
|
+
*
|
|
50
|
+
* 1. **Structured-data dispatch**: the
|
|
51
|
+
* SEO library reads `WebsiteSectionDefinition.category` to decide
|
|
52
|
+
* which JSON-LD vocabulary the section's `getStructuredData()` hook
|
|
53
|
+
* is allowed to emit. e.g. `PRICING` may emit `Product` /
|
|
54
|
+
* `AggregateOffer`; `FAQ` may emit `FAQPage`; `HERO` may emit
|
|
55
|
+
* `Organization` / `WebSite`. Mismatches are surfaced as build-time
|
|
56
|
+
* warnings.
|
|
57
|
+
* 2. **Authoring guidance**: each value has matching application-builder
|
|
58
|
+
* guidance. When introducing a new category, provide its public authoring
|
|
59
|
+
* method before asking an application to use it.
|
|
60
|
+
* 3. **Analytics labelling**: the runtime emits
|
|
61
|
+
* `data-section-category="…"` on the `<WebsiteSection>` wrapper so
|
|
62
|
+
* analytics tooling can group section impressions
|
|
63
|
+
* without parsing className conventions.
|
|
64
|
+
*
|
|
65
|
+
* **Closed vocabulary on purpose**: a free-string `category` would
|
|
66
|
+
* defeat the skill-mapping and SEO-dispatch contracts. Consumers who
|
|
67
|
+
* need a wholly-novel section shape use the `RAW` advanced path
|
|
68
|
+
* (`website-factory-advanced` skill) which bypasses the category
|
|
69
|
+
* vocabulary entirely.
|
|
70
|
+
*
|
|
71
|
+
* **Adding a value**: requires (a) a new entry here, (b) a matching
|
|
72
|
+
* `website_section_<value>` skill stub, (c) (optionally) a
|
|
73
|
+
* structured-data dispatch entry in the SEO library. Removing a value
|
|
74
|
+
* is a labelled rename — every consumer's
|
|
75
|
+
* `defineWebsiteSection({ category: … })` declaration breaks at compile
|
|
76
|
+
* time, which is the desired loud failure.
|
|
77
|
+
*/
|
|
78
|
+
export enum WebsiteSectionCategory {
|
|
79
|
+
HERO = 'hero',
|
|
80
|
+
CTA = 'cta',
|
|
81
|
+
FEATURE_BENEFIT_SUMMARY = 'feature-benefit-summary',
|
|
82
|
+
FEATURE_DETAIL = 'feature-detail',
|
|
83
|
+
PRICING = 'pricing',
|
|
84
|
+
CONTACT = 'contact',
|
|
85
|
+
SOCIAL_PROOF = 'social-proof',
|
|
86
|
+
FAQ = 'faq',
|
|
87
|
+
FOOTER_CTA = 'footer-cta',
|
|
88
|
+
/**
|
|
89
|
+
* Escape hatch for sections that don't fit any standard category
|
|
90
|
+
* (third-party widgets, custom one-off marketing pieces). Skips the
|
|
91
|
+
* SEO-dispatch contract — the section's `getStructuredData()` may
|
|
92
|
+
* return any vocabulary, no validation. Authors should prefer a
|
|
93
|
+
* concrete category whenever possible; using `RAW` opts the section
|
|
94
|
+
* out of the framework's structured-data safety net.
|
|
95
|
+
*/
|
|
96
|
+
RAW = 'raw',
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCategory> =
|
|
100
|
+
z.enum(WebsiteSectionCategory);
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Section definition (the contract `defineWebsiteSection` produces)
|
|
104
|
+
|
|
105
|
+
The schema declares the **observable contract** the page-manifest
|
|
106
|
+
registration, label-pack validator, and SEO dispatcher depend on. The
|
|
107
|
+
factory layer adds type-preserving generics on top so JSX usage keeps
|
|
108
|
+
compile-time prop checking.
|
|
109
|
+
|
|
110
|
+
## Import Origins
|
|
111
|
+
|
|
112
|
+
- `@wildo-ai/saas-website`
|
|
113
|
+
|
|
114
|
+
## Source Excerpts
|
|
115
|
+
|
|
116
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
117
|
+
|
|
118
|
+
```typescript
|
|
119
|
+
*
|
|
120
|
+
* `WebsiteSectionDefinition` — the runtime contract returned by the
|
|
121
|
+
* `defineWebsiteSection({ … })` factory (authored as a separate
|
|
122
|
+
* `core/define-website-section.tsx` module in Phase 2 because it carries
|
|
123
|
+
* React types in its inputs). The shape is declared in `schemas/`
|
|
124
|
+
* because it is the **observable contract** the page-manifest
|
|
125
|
+
* registration, label-pack validator, and SEO dispatcher depend on.
|
|
126
|
+
*
|
|
127
|
+
* **Shape rationale** (each field carries semantic weight — see
|
|
128
|
+
* `design-philosophy.mdc`):
|
|
129
|
+
*
|
|
130
|
+
* - `sectionRef` — the section's identity inside its hosting page.
|
|
131
|
+
* Uniqueness is enforced **per page** at manifest registration time
|
|
132
|
+
* (a section can be reused with the same `sectionRef` across pages
|
|
133
|
+
* when its label-key root is intentionally shared).
|
|
134
|
+
* - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
|
|
135
|
+
* for SEO-dispatch, skill-mapping, and analytics labelling.
|
|
136
|
+
* - `expectedLabelKeys` — the **fully-composed** label keys the section
|
|
137
|
+
* commits to consuming. The plan originally proposed leaf-relative
|
|
138
|
+
* keys (`'headline'`) resolved at runtime against the
|
|
139
|
+
* page+section context, but storing the fully-composed key on the
|
|
140
|
+
* definition has three concrete benefits:
|
|
141
|
+
* 1. The label-pack validator (`validateLabelPackAgainstManifest`)
|
|
142
|
+
* runs as a pure function with no need to walk the JSX tree at
|
|
143
|
+
* build time to discover the leaf-to-key resolution.
|
|
144
|
+
* 2. The contract is auditable from outside the React render
|
|
145
|
+
* graph — `wildo website audit` can list a page's required keys
|
|
146
|
+
* without booting React.
|
|
147
|
+
* 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
|
|
148
|
+
* survive in Phase 2 — the hook composes the leaf with the
|
|
149
|
+
* page+section context and validates the result against
|
|
150
|
+
* `expectedLabelKeys`.
|
|
151
|
+
* - `Component` — the React component that renders the section. Typed
|
|
152
|
+
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
153
|
+
* the component's prop shape (props vary per section). The factory
|
|
154
|
+
* function (`defineWebsiteSection<TProps>(…)`) preserves the precise
|
|
155
|
+
* prop type at the consumer call site via generics; this schema only
|
|
156
|
+
* guards the runtime shape of "is callable as a React component".
|
|
157
|
+
* - `getStructuredData?` — optional pure function the SEO/AEO/GEO
|
|
158
|
+
* builder library invokes at static-build time to materialize JSON-LD
|
|
159
|
+
* for the section. The return type is intentionally `unknown` here;
|
|
160
|
+
* the SEO library narrows by `category` (e.g. `PRICING` →
|
|
161
|
+
* `Product | AggregateOffer`).
|
|
162
|
+
*
|
|
163
|
+
* **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
|
|
164
|
+
* cannot meaningfully validate "is a React component" beyond
|
|
165
|
+
* `typeof === 'function'`, and the false-positive cost (any function
|
|
166
|
+
* passes) is too high for the value (none — the consumer either
|
|
167
|
+
* imports a real component or fails at JSX render time with a clearer
|
|
168
|
+
* error). Using `z.unknown()` + a TS-side type cast keeps the runtime
|
|
169
|
+
* cost zero and the type-safety contract entirely on the TS side
|
|
170
|
+
* (where it actually has teeth via the factory's generic).
|
|
171
|
+
*/
|
|
172
|
+
const _WebsiteSectionDefinitionSchema = z.object({
|
|
173
|
+
sectionRef: WebsiteSectionRefSchema,
|
|
174
|
+
category: WebsiteSectionCategorySchema,
|
|
175
|
+
expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
|
|
176
|
+
Component: z.unknown(),
|
|
177
|
+
getStructuredData: z.unknown().optional(),
|
|
178
|
+
});
|
|
179
|
+
|
|
180
|
+
export const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSchema =
|
|
181
|
+
_WebsiteSectionDefinitionSchema;
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and
|
|
185
|
+
* `getStructuredData` are typed precisely on the factory return type
|
|
186
|
+
* (`defineWebsiteSection<TProps>` in Phase 2); the schema-inferred
|
|
187
|
+
* type is the lowest common denominator used at the persistence /
|
|
188
|
+
* validation boundary only.
|
|
189
|
+
*
|
|
190
|
+
* **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:
|
|
191
|
+
* React component props are CONTRAVARIANT in `ComponentType<T>` —
|
|
192
|
+
* a narrower `ComponentType<{ foo: string }>` is NOT assignable to
|
|
193
|
+
* `ComponentType<unknown>` (because a caller could pass an `unknown`
|
|
194
|
+
* the narrower component cannot accept). This made every consumer
|
|
195
|
+
* who built sections via `defineWebsiteSection<TProps>(…)` unable
|
|
196
|
+
* to feed the resulting `TypedWebsiteSectionDefinition<TProps>` to
|
|
197
|
+
* helpers typed against the bare `WebsiteSectionDefinition` —
|
|
198
|
+
* collectors, validators, and registries. Using `any` here is the
|
|
199
|
+
* exact escape hatch the React typings themselves use for
|
|
200
|
+
* heterogeneous component containers (`React.forwardRef`,
|
|
201
|
+
* `React.lazy`'s internal component slot, etc.) and matches the
|
|
202
|
+
* runtime contract: the framework NEVER instantiates these
|
|
203
|
+
* components directly with arbitrary props — the consumer's JSX
|
|
204
|
+
* supplies the right props at the call site.
|
|
205
|
+
*/
|
|
206
|
+
export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {
|
|
207
|
+
Component: ComponentType<any>;
|
|
208
|
+
/**
|
|
209
|
+
* Optional pure function the SEO/AEO/GEO renderer invokes at
|
|
210
|
+
* static-build time to materialize JSON-LD for the section.
|
|
211
|
+
*
|
|
212
|
+
* **Why typed as `WebsiteStructuredDataReturn` (not `unknown`)** —
|
|
213
|
+
* a typed return shape gives section authors autocomplete on
|
|
214
|
+
* `@type` / `@id` / `@context` (the framework-owned fields) while
|
|
215
|
+
* keeping all other fields free-form (Schema.org has hundreds of
|
|
216
|
+
* optional fields per entity; locking them in TS would be both
|
|
217
|
+
* impractical and brittle as Schema.org evolves). The companion
|
|
218
|
+
* catalog reconciliation surface catches missing-required and
|
|
219
|
+
* deprecated-field-used at the SEMANTIC layer (warning-only per
|
|
220
|
+
* D-AG4), so the runtime type stays loose.
|
|
221
|
+
*
|
|
222
|
+
* Returns `null`, `undefined`, or `[]` when the section has no
|
|
223
|
+
* structured-data contribution for the current state — the
|
|
224
|
+
* renderer short-circuits all three.
|
|
225
|
+
*/
|
|
226
|
+
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
227
|
+
}
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
## `defineWebsiteSection<TProps>` factory
|
|
231
|
+
|
|
232
|
+
Always use the factory — never build a `WebsiteSectionDefinition`
|
|
233
|
+
literal by hand. The factory parses inputs through the schema (single
|
|
234
|
+
audited validation chokepoint) AND preserves the caller's `TProps` so
|
|
235
|
+
JSX composition stays strongly typed.
|
|
236
|
+
|
|
237
|
+
## Import Origins
|
|
238
|
+
|
|
239
|
+
- `@wildo-ai/saas-website`
|
|
240
|
+
|
|
241
|
+
## Source Excerpts
|
|
242
|
+
|
|
243
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
244
|
+
|
|
245
|
+
```typescript
|
|
246
|
+
*
|
|
247
|
+
* Input shape consumed by `defineWebsiteSection<TProps>`. Mirrors
|
|
248
|
+
* `WebsiteSectionDefinition` but keeps `Component` typed against the
|
|
249
|
+
* caller-supplied generic so the precise prop shape survives end-to-end
|
|
250
|
+
* (the consumer's `<HeroSection />` JSX can keep its strongly-typed
|
|
251
|
+
* props after going through the factory).
|
|
252
|
+
*
|
|
253
|
+
* **String inputs vs. branded inputs**: `sectionRef` and
|
|
254
|
+
* `expectedLabelKeys` accept raw strings as well as already-branded
|
|
255
|
+
* values. The factory parses them through the underlying schemas, so
|
|
256
|
+
* either path is safe — accepting strings directly removes the
|
|
257
|
+
* ergonomic drag of forcing every section author to remember to call
|
|
258
|
+
* `WebsiteSectionRefSchema.parse(...)` in their definition.
|
|
259
|
+
*/
|
|
260
|
+
export interface DefineWebsiteSectionInput<TProps> {
|
|
261
|
+
sectionRef: WebsiteSectionRef | string;
|
|
262
|
+
category: WebsiteSectionCategory;
|
|
263
|
+
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
264
|
+
Component: ComponentType<TProps>;
|
|
265
|
+
/**
|
|
266
|
+
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
267
|
+
* full authoring contract. The factory passes the function through
|
|
268
|
+
* unchanged; the framework invokes it at static-build time and
|
|
269
|
+
* forwards the return value to `renderPageStructuredData()`.
|
|
270
|
+
*/
|
|
271
|
+
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Return shape of `defineWebsiteSection<TProps>`. Identical to
|
|
276
|
+
* `WebsiteSectionDefinition` except `Component` retains the
|
|
277
|
+
* caller-supplied generic prop shape rather than the schema's
|
|
278
|
+
* lowest-common-denominator `ComponentType<unknown>`.
|
|
279
|
+
*
|
|
280
|
+
* **Why this matters**: a consumer's `pageComponent` JSX composes
|
|
281
|
+
* sections like `<HERO_SECTION.Component {...heroProps} />`. Without
|
|
282
|
+
* preserving `TProps`, the spread would be untyped and a renamed prop
|
|
283
|
+
* would silently miss the type system. With `TProps` preserved, the
|
|
284
|
+
* call site fails to compile the moment the prop contract drifts.
|
|
285
|
+
*/
|
|
286
|
+
export interface TypedWebsiteSectionDefinition<TProps>
|
|
287
|
+
extends Omit<WebsiteSectionDefinition, 'Component' | 'getStructuredData'> {
|
|
288
|
+
Component: ComponentType<TProps>;
|
|
289
|
+
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
290
|
+
}
|
|
291
|
+
|
|
292
|
+
/**
|
|
293
|
+
* `defineWebsiteSection<TProps>` — factory that materializes a
|
|
294
|
+
* `WebsiteSectionDefinition` from authored input.
|
|
295
|
+
*
|
|
296
|
+
* **Two responsibilities**, one entry point:
|
|
297
|
+
* 1. Runtime validation — parses the input through
|
|
298
|
+
* `WebsiteSectionDefinitionSchema` so brand checks, regex
|
|
299
|
+
* validations, and array refinements run at module load time
|
|
300
|
+
* (not at render time, not at build-output time).
|
|
301
|
+
* 2. Type preservation — returns an object whose `Component` field
|
|
302
|
+
* keeps the caller-supplied `TProps`, so JSX usage of the
|
|
303
|
+
* returned section retains compile-time prop checking.
|
|
304
|
+
*
|
|
305
|
+
* **Why a factory instead of constructing the literal directly**:
|
|
306
|
+
* - Consumers don't have to remember to parse refs / keys
|
|
307
|
+
* themselves before assembling the literal.
|
|
308
|
+
* - The schema parse provides a single audited validation chokepoint
|
|
309
|
+
* so `wildo website audit` (Phase 7) can re-validate definitions
|
|
310
|
+
* without re-entering the React graph.
|
|
311
|
+
* - The factory is the documented authoring API the
|
|
312
|
+
* `website_factory_authoring` skill targets — keeping the
|
|
313
|
+
* authoring surface narrow lets the framework evolve the
|
|
314
|
+
* internal schema (add fields, refinements) without churning
|
|
315
|
+
* every section definition in every consumer app.
|
|
316
|
+
*
|
|
317
|
+
* @param input section authoring input (see `DefineWebsiteSectionInput`).
|
|
318
|
+
* @returns a `TypedWebsiteSectionDefinition<TProps>` with `Component`
|
|
319
|
+
* preserved at the precise prop type.
|
|
320
|
+
*
|
|
321
|
+
* @example
|
|
322
|
+
* interface HeroProps {
|
|
323
|
+
* headlineKey: WebsiteLabelKey;
|
|
324
|
+
* subheadlineKey: WebsiteLabelKey;
|
|
325
|
+
* }
|
|
326
|
+
* function HeroSection({ headlineKey, subheadlineKey }: HeroProps) {
|
|
327
|
+
* // …
|
|
328
|
+
* }
|
|
329
|
+
* export const HERO_SECTION = defineWebsiteSection<HeroProps>({
|
|
330
|
+
* sectionRef: 'hero',
|
|
331
|
+
* category: WebsiteSectionCategory.HERO,
|
|
332
|
+
* expectedLabelKeys: [
|
|
333
|
+
* 'website.landing.hero.headline',
|
|
334
|
+
* 'website.landing.hero.subheadline',
|
|
335
|
+
* ],
|
|
336
|
+
* Component: HeroSection,
|
|
337
|
+
* });
|
|
338
|
+
*/
|
|
339
|
+
export function defineWebsiteSection<TProps>(
|
|
340
|
+
input: DefineWebsiteSectionInput<TProps>,
|
|
341
|
+
): TypedWebsiteSectionDefinition<TProps> {
|
|
342
|
+
const parsed = WebsiteSectionDefinitionSchema.parse({
|
|
343
|
+
sectionRef: input.sectionRef,
|
|
344
|
+
category: input.category,
|
|
345
|
+
expectedLabelKeys: input.expectedLabelKeys,
|
|
346
|
+
Component: input.Component,
|
|
347
|
+
getStructuredData: input.getStructuredData,
|
|
348
|
+
});
|
|
349
|
+
/**
|
|
350
|
+
* Re-attach `Component` and `getStructuredData` from the original
|
|
351
|
+
* input so the precise generic types survive — `parsed.Component`
|
|
352
|
+
* is `unknown` per the schema's `z.unknown()` contract.
|
|
353
|
+
*/
|
|
354
|
+
return {
|
|
355
|
+
sectionRef: parsed.sectionRef,
|
|
356
|
+
category: parsed.category,
|
|
357
|
+
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
358
|
+
Component: input.Component,
|
|
359
|
+
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
360
|
+
};
|
|
361
|
+
}
|
|
362
|
+
```
|
|
363
|
+
|
|
364
|
+
## Runtime label hook (leaf-relative; resolved against page+section context)
|
|
365
|
+
|
|
366
|
+
Inside the section's React component, always read labels via
|
|
367
|
+
`useWebsiteLabel('<leaf>')`. The hook composes the leaf with the
|
|
368
|
+
ambient page+section context to produce the fully-qualified
|
|
369
|
+
`WebsiteLabelKey` and validates it against the section's
|
|
370
|
+
`expectedLabelKeys` declaration.
|
|
371
|
+
|
|
372
|
+
## Import Origins
|
|
373
|
+
|
|
374
|
+
- `@wildo-ai/saas-website`
|
|
375
|
+
|
|
376
|
+
## Source Excerpts
|
|
377
|
+
|
|
378
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
379
|
+
|
|
380
|
+
```typescript
|
|
381
|
+
*
|
|
382
|
+
* `useWebsiteLabel(slotPath)` — leaf-relative label resolution.
|
|
383
|
+
*
|
|
384
|
+
* Composes the slot leaf with the active page+section context to
|
|
385
|
+
* derive the full `WebsiteLabelKey` (`website.{pageRef}.{sectionRef}.{slotPath}`),
|
|
386
|
+
* looks it up in the active locale's label pack, and returns the
|
|
387
|
+
* resolved string.
|
|
388
|
+
*
|
|
389
|
+
* **Author ergonomics**: section authors call
|
|
390
|
+
* `useWebsiteLabel('headline')` from inside their section component
|
|
391
|
+
* without ever typing the page or section ref — the hook reads them
|
|
392
|
+
* from context. This keeps section components portable across pages
|
|
393
|
+
* (the same `<HeroSection />` can be reused on `landing` and on a
|
|
394
|
+
* dedicated `/about` page; only the surrounding `<WebsiteSection
|
|
395
|
+
* sectionRef="hero">` differs, and the label keys re-root accordingly).
|
|
396
|
+
*
|
|
397
|
+
* **Fail-loud diagnostics** for missing keys: returns the composed key
|
|
398
|
+
* itself (visible in the rendered DOM as e.g. `website.landing.hero.headline`)
|
|
399
|
+
* AND emits a `console.warn`. The visible-key fallback is preferred
|
|
400
|
+
* over an empty string or a thrown error because:
|
|
401
|
+
* - empty string silently breaks layout (zero-height heading) and
|
|
402
|
+
* leaks past visual review,
|
|
403
|
+
* - throwing would crash the entire page on a single missing label
|
|
404
|
+
* while the SEO crawler indexes a 500 page,
|
|
405
|
+
* - the rendered key is a clear authoring signal ("ship the missing
|
|
406
|
+
* pack entry") that designers and copywriters can spot without
|
|
407
|
+
* opening DevTools.
|
|
408
|
+
*
|
|
409
|
+
* **Hard guards** (each enforced by the underlying context hooks):
|
|
410
|
+
* - MUST be called inside `<WebsiteRuntimeContextProvider>`,
|
|
411
|
+
* - MUST be called inside `<WebsitePageLayout>`,
|
|
412
|
+
* - MUST be called inside `<WebsiteSection>`.
|
|
413
|
+
*
|
|
414
|
+
* @param slotPath leaf identifier (eg. `'headline'`, `'cta.primary'`,
|
|
415
|
+
* `'tiers[0].name'`). Anything that survives the slot
|
|
416
|
+
* portion of `WebsiteLabelKeySchema`'s regex.
|
|
417
|
+
* @returns the resolved label string, or the composed key itself when
|
|
418
|
+
* the pack lacks an entry (with a `console.warn`).
|
|
419
|
+
*/
|
|
420
|
+
export function useWebsiteLabel(slotPath: string): string {
|
|
421
|
+
const { labelPack } = useWebsiteRuntime();
|
|
422
|
+
const { pageRef } = useWebsitePage();
|
|
423
|
+
const { sectionRef } = useWebsiteSection();
|
|
424
|
+
|
|
425
|
+
/**
|
|
426
|
+
* Compose + parse memoized on the three identity inputs. The parse
|
|
427
|
+
* itself is cheap (regex + brand) but executing it on every render
|
|
428
|
+
* of every label-bound primitive in a section adds up across a
|
|
429
|
+
* 12-section landing page.
|
|
430
|
+
*/
|
|
431
|
+
const fullKey = useMemo<WebsiteLabelKey>(
|
|
432
|
+
() =>
|
|
433
|
+
composeWebsiteLabelKey({
|
|
434
|
+
pageRef: pageRef as unknown as string,
|
|
435
|
+
sectionRef: sectionRef as unknown as string,
|
|
436
|
+
slotPath,
|
|
437
|
+
}),
|
|
438
|
+
[pageRef, sectionRef, slotPath],
|
|
439
|
+
);
|
|
440
|
+
|
|
441
|
+
const resolved = labelPack[fullKey as unknown as string];
|
|
442
|
+
if (resolved === undefined) {
|
|
443
|
+
console.warn(
|
|
444
|
+
`[useWebsiteLabel] Missing label for key "${fullKey as unknown as string}". ` +
|
|
445
|
+
`Add it to the active locale's pack (or remove the section's claim on this slot).`,
|
|
446
|
+
);
|
|
447
|
+
return fullKey as unknown as string;
|
|
448
|
+
}
|
|
449
|
+
return resolved;
|
|
450
|
+
}
|
|
451
|
+
```
|
|
452
|
+
|
|
453
|
+
## Section wrapper (provides section context, emits semantic landmark + analytics attrs)
|
|
454
|
+
|
|
455
|
+
The framework's `<WebsiteSection>` wrapper is what the page composition
|
|
456
|
+
mounts to host a section's component. It provides
|
|
457
|
+
`WebsiteSectionContext`, renders a semantic `<section>` with
|
|
458
|
+
`data-section-ref` and `data-section-category`, and forwards a11y
|
|
459
|
+
pass-throughs (`aria-labelledby`, `role`, etc.).
|
|
460
|
+
|
|
461
|
+
## Import Origins
|
|
462
|
+
|
|
463
|
+
- `@wildo-ai/saas-website`
|
|
464
|
+
|
|
465
|
+
## Source Excerpts
|
|
466
|
+
|
|
467
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
468
|
+
|
|
469
|
+
```tsx
|
|
470
|
+
*
|
|
471
|
+
* `WebsiteSection` — the per-section structural primitive.
|
|
472
|
+
*
|
|
473
|
+
* **Three responsibilities** (semantic-weight discipline):
|
|
474
|
+
*
|
|
475
|
+
* 1. **Provides `WebsiteSectionContext`** — registers the active
|
|
476
|
+
* sectionRef + category so leaf primitives (`useWebsiteLabel`,
|
|
477
|
+
* analytics overlays, structured-data emitters) can derive
|
|
478
|
+
* keys / metadata without re-typing the section's identity.
|
|
479
|
+
* 2. **Renders a semantic `<section>` landmark** — emits
|
|
480
|
+
* `data-section-ref` and `data-section-category` attributes so
|
|
481
|
+
* analytics tooling and SEO crawlers can identify and group
|
|
482
|
+
* sections without parsing className conventions. Optional
|
|
483
|
+
* `id` prop wires up anchor-link navigation
|
|
484
|
+
* (`<a href="#pricing">`).
|
|
485
|
+
* 3. **Provides a styling seam** — `className` is forwarded to the
|
|
486
|
+
* `<section>` element so designers can apply utility-class
|
|
487
|
+
* decorations (background, padding, max-width container) without
|
|
488
|
+
* having to compose multiple wrappers.
|
|
489
|
+
*
|
|
490
|
+
* **Why NOT render a `<div>` instead of `<section>`**: marketing
|
|
491
|
+
* pages benefit from semantic landmarks for SEO scoring and
|
|
492
|
+
* accessibility (screen-reader section navigation). A `<section>`
|
|
493
|
+
* with `data-section-category="hero"` is structurally meaningful;
|
|
494
|
+
* a `<div>` with the same data-attribute carries the same metadata
|
|
495
|
+
* but loses the landmark benefit.
|
|
496
|
+
*
|
|
497
|
+
* **Why expose `as` is NOT a prop**: switching the rendered tag
|
|
498
|
+
* (`<article>` for blog post bodies, `<aside>` for sidebar widgets)
|
|
499
|
+
* is legitimate but rare enough to be worth a separate primitive
|
|
500
|
+
* (Phase 4: `<WebsiteAside>`, `<WebsiteArticle>`). Keeping
|
|
501
|
+
* `WebsiteSection` rendered as a literal `<section>` removes a
|
|
502
|
+
* rarely-used prop from the section-author API and keeps the SEO
|
|
503
|
+
* landmark contract guaranteed at the type level.
|
|
504
|
+
*/
|
|
505
|
+
export interface WebsiteSectionProps {
|
|
506
|
+
/**
|
|
507
|
+
* The section's ref. Accepts an already-branded `WebsiteSectionRef`
|
|
508
|
+
* or a raw string — the layout parses through
|
|
509
|
+
* `WebsiteSectionRefSchema` so a malformed ref fails loud at
|
|
510
|
+
* render. Typically sourced from the page manifest's
|
|
511
|
+
* `sectionRefs[]` (eg. `<WebsiteSection sectionRef="hero" …>`).
|
|
512
|
+
*/
|
|
513
|
+
sectionRef: WebsiteSectionRef | string;
|
|
514
|
+
/**
|
|
515
|
+
* The section's structural intent (see `WebsiteSectionCategory`).
|
|
516
|
+
* Required at the wrapper level (rather than only on the section
|
|
517
|
+
* definition) because the wrapper emits `data-section-category`
|
|
518
|
+
* for analytics, and asking the wrapper to look up the category
|
|
519
|
+
* on a separate manifest registry would re-introduce the runtime
|
|
520
|
+
* coupling the per-section context exists to avoid.
|
|
521
|
+
*/
|
|
522
|
+
category: WebsiteSectionCategory;
|
|
523
|
+
/**
|
|
524
|
+
* Optional DOM id. Wires anchor-link navigation
|
|
525
|
+
* (`<a href="#pricing">`). When omitted, the section has no DOM
|
|
526
|
+
* id — by design; not every section is an anchor target.
|
|
527
|
+
*/
|
|
528
|
+
id?: string;
|
|
529
|
+
/**
|
|
530
|
+
* Optional className applied to the `<section>` element. Used by
|
|
531
|
+
* designers for layout / spacing utilities. Section components
|
|
532
|
+
* themselves should NOT pass className through to this wrapper —
|
|
533
|
+
* keep the styling responsibility at the page-composition level.
|
|
534
|
+
*/
|
|
535
|
+
className?: string;
|
|
536
|
+
/**
|
|
537
|
+
* The section's body. Typically a single section component
|
|
538
|
+
* (`<HeroSection {…heroProps} />`). May be plain JSX for one-off
|
|
539
|
+
* sections that don't justify a `defineWebsiteSection` factory call.
|
|
540
|
+
*/
|
|
541
|
+
children: ReactNode;
|
|
542
|
+
/**
|
|
543
|
+
* Pass-through `aria-*` / `role` attributes for sections that need
|
|
544
|
+
* to refine their landmark semantics (eg. `aria-label="Featured
|
|
545
|
+
* customer logos"` on a logo wall).
|
|
546
|
+
*/
|
|
547
|
+
ariaLabel?: string;
|
|
548
|
+
ariaLabelledBy?: string;
|
|
549
|
+
}
|
|
550
|
+
|
|
551
|
+
export function WebsiteSection({
|
|
552
|
+
sectionRef,
|
|
553
|
+
category,
|
|
554
|
+
id,
|
|
555
|
+
className,
|
|
556
|
+
children,
|
|
557
|
+
ariaLabel,
|
|
558
|
+
ariaLabelledBy,
|
|
559
|
+
}: WebsiteSectionProps): ReactNode {
|
|
560
|
+
const safeSectionRef = useMemo<WebsiteSectionRef>(
|
|
561
|
+
() => WebsiteSectionRefSchema.parse(sectionRef),
|
|
562
|
+
[sectionRef],
|
|
563
|
+
);
|
|
564
|
+
|
|
565
|
+
const sectionContextValue = useMemo<WebsiteSectionContextValue>(
|
|
566
|
+
() => ({ sectionRef: safeSectionRef, category }),
|
|
567
|
+
[safeSectionRef, category],
|
|
568
|
+
);
|
|
569
|
+
|
|
570
|
+
/**
|
|
571
|
+
* Build the `<section>` attribute set imperatively to keep
|
|
572
|
+
* `aria-*` props off the element when omitted (rendering
|
|
573
|
+
* `aria-label={undefined}` still emits the attribute in some
|
|
574
|
+
* React versions — explicit absence is cleaner).
|
|
575
|
+
*/
|
|
576
|
+
const sectionAttrs: HTMLAttributes<HTMLElement> = {
|
|
577
|
+
className,
|
|
578
|
+
};
|
|
579
|
+
if (id !== undefined) sectionAttrs.id = id;
|
|
580
|
+
if (ariaLabel !== undefined) sectionAttrs['aria-label'] = ariaLabel;
|
|
581
|
+
if (ariaLabelledBy !== undefined) sectionAttrs['aria-labelledby'] = ariaLabelledBy;
|
|
582
|
+
|
|
583
|
+
return (
|
|
584
|
+
<WebsiteSectionContextProvider value={sectionContextValue}>
|
|
585
|
+
<section
|
|
586
|
+
data-section-ref={safeSectionRef as unknown as string}
|
|
587
|
+
data-section-category={category}
|
|
588
|
+
{...sectionAttrs}
|
|
589
|
+
>
|
|
590
|
+
{children}
|
|
591
|
+
</section>
|
|
592
|
+
</WebsiteSectionContextProvider>
|
|
593
|
+
);
|
|
594
|
+
}
|
|
595
|
+
WebsiteSection.displayName = 'WebsiteSection';
|
|
596
|
+
```
|
|
597
|
+
|
|
598
|
+
|
|
599
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no concrete
|
|
600
|
+
> Contact component**. This skill documents the
|
|
601
|
+
> `defineWebsiteSection<TProps>` authoring pattern for a contact /
|
|
602
|
+
> lead-capture form that feeds the `InboundContact` CREATE flow with
|
|
603
|
+
> full marketing-metadata propagation.
|
|
604
|
+
|
|
605
|
+
## Overview
|
|
606
|
+
|
|
607
|
+
A Contact section is the canonical lead-capture surface: name +
|
|
608
|
+
email + topic + free-form message → `InboundContact` CREATE call. The
|
|
609
|
+
section is **interactive** (a React island under the Astro adapter)
|
|
610
|
+
and depends on:
|
|
611
|
+
|
|
612
|
+
- `useSubmitInboundContact()` — public-runtime hook from
|
|
613
|
+
`@wildo-ai/saas-website` that POSTs to the public anonymous CREATE
|
|
614
|
+
endpoint and folds the parent-domain anonymous-session UUID +
|
|
615
|
+
marketing metadata into the request.
|
|
616
|
+
- `<WebsiteConsentGate>` — the consent placeholder that wraps any
|
|
617
|
+
visible-form mount per `website-consent-gate-overrides`. The
|
|
618
|
+
default placeholder always allows submission; brand-specific
|
|
619
|
+
overrides may gate it behind a banner accept.
|
|
620
|
+
|
|
621
|
+
The category drives:
|
|
622
|
+
|
|
623
|
+
1. **SEO/AEO/GEO dispatch** — `category: CONTACT` does not own a
|
|
624
|
+
dedicated JSON-LD vocabulary in the framework. (`ContactPoint`
|
|
625
|
+
under page-level `Organization` is the standard placement.)
|
|
626
|
+
2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.CONTACT`.
|
|
627
|
+
3. **Analytics labelling** — `data-section-category="contact"` is
|
|
628
|
+
the standard funnel-step grouping.
|
|
629
|
+
|
|
630
|
+
## App Paths
|
|
631
|
+
|
|
632
|
+
| Surface | Glob (relative to app root) |
|
|
633
|
+
|---|---|
|
|
634
|
+
| Section component + factory call | `website/src/sections/contact.section.tsx` |
|
|
635
|
+
| Page composition | `website/src/pages-impl/contact.page.tsx` |
|
|
636
|
+
| Label pack (per locale) | `website/src/i18n/<locale>.json` |
|
|
637
|
+
|
|
638
|
+
## When to Use
|
|
639
|
+
|
|
640
|
+
- Visitor lead capture (name, email, topic, message).
|
|
641
|
+
- Form posts directly into `InboundContact` (no third-party form
|
|
642
|
+
service, no manual email forwarding).
|
|
643
|
+
- The marketing site needs the cross-app anonymous-session UUID +
|
|
644
|
+
first-touch attribution to land on the resulting `InboundContact`
|
|
645
|
+
row (per Phase 0.5 D-Q=β).
|
|
646
|
+
|
|
647
|
+
## When NOT to Use
|
|
648
|
+
|
|
649
|
+
- Newsletter signup (single email field) →
|
|
650
|
+
`website-inbound-contact-forms` (the lower-level skill the contact
|
|
651
|
+
section composes on top of) for a smaller form footprint.
|
|
652
|
+
- A "contact us" CTA that just opens a `mailto:` →
|
|
653
|
+
`website-section-cta`.
|
|
654
|
+
- Admin-only support intake forms — those belong in the SaaS app,
|
|
655
|
+
not the marketing website.
|
|
656
|
+
|
|
657
|
+
## Workflow
|
|
658
|
+
|
|
659
|
+
### Step 1: Decide the form's typed shape
|
|
660
|
+
|
|
661
|
+
Beyond the standard `name` / `email` / `topic` / `message` fields,
|
|
662
|
+
you may extend `marketingMetadata.extra` with ICP-specific fields
|
|
663
|
+
(company size, industry, etc.) — see
|
|
664
|
+
`website-marketing-metadata-extension`.
|
|
665
|
+
|
|
666
|
+
### Step 2: Wire `useSubmitInboundContact()`
|
|
667
|
+
|
|
668
|
+
The hook returns `{ submit, status, error }`. `submit(payload)`
|
|
669
|
+
attaches the current parent-domain anonymous-session UUID and the
|
|
670
|
+
first-touch marketing metadata to the request automatically — never
|
|
671
|
+
read those values yourself in the section.
|
|
672
|
+
|
|
673
|
+
### Step 3: Wrap the rendered form in `<WebsiteConsentGate>`
|
|
674
|
+
|
|
675
|
+
The default placeholder is permissive; brand overrides gate
|
|
676
|
+
submission behind a consent banner accept. Per `D16` the section
|
|
677
|
+
should NOT implement its own consent UI.
|
|
678
|
+
|
|
679
|
+
### Step 4: Wrap with `defineWebsiteSection<TProps>` + compose into page
|
|
680
|
+
|
|
681
|
+
The page lives at `/contact` (typically) with this section as the
|
|
682
|
+
sole or primary band.
|
|
683
|
+
|
|
684
|
+
**Stop** after the contact form mounts in dev and submits a
|
|
685
|
+
schema-shaped payload to its `submitEndpoint`; if the
|
|
686
|
+
`expectedLabelKeys` audit fails (label-pack validator), **return
|
|
687
|
+
to Step 3** — every form field's label, placeholder, and helper
|
|
688
|
+
string is a leaf and missing leaves render as the key string.
|
|
689
|
+
|
|
690
|
+
## Structured data (AEO)
|
|
691
|
+
|
|
692
|
+
Contact sections do not own a first-class standalone entity in the
|
|
693
|
+
current engine catalog. If contact metadata needs structured-data
|
|
694
|
+
representation, model it under the page's `Organization.contactPoint`
|
|
695
|
+
instead of inventing a section-local payload.
|
|
696
|
+
|
|
697
|
+
- **What earns its place**: visible public contact paths and sanctioned
|
|
698
|
+
contact channels.
|
|
699
|
+
- **What is NOT in this block**: backend endpoint details, private
|
|
700
|
+
routing metadata, or speculative `ContactPoint` payloads not backed by
|
|
701
|
+
the current catalog.
|
|
702
|
+
- **Verification grep**:
|
|
703
|
+
`rg -n "getStructuredData|contactPoint" website/src/sections/contact.section.tsx`
|
|
704
|
+
(should usually return 0 today unless the page-level entity explicitly
|
|
705
|
+
owns the contact data).
|
|
706
|
+
|
|
707
|
+
## Contribution to `llms.txt`
|
|
708
|
+
|
|
709
|
+
Contact-section authoring contributes the engagement-routing sentence in
|
|
710
|
+
`website/src/content/llms.txt`.
|
|
711
|
+
|
|
712
|
+
- Point to the canonical contact page and describe what kinds of
|
|
713
|
+
conversations the form is for.
|
|
714
|
+
- Keep the description user-facing; mention outcomes, not backend
|
|
715
|
+
transport details.
|
|
716
|
+
- Do not enumerate form fields or paste privacy/legal helper copy into
|
|
717
|
+
`llms.txt`.
|
|
718
|
+
|
|
719
|
+
## Worked Example
|
|
720
|
+
|
|
721
|
+
<!-- TIER C WAIVER: This block IS the canonical Contact contract — it shows all four pillars Workflow Steps 1–4 enumerate (typed `topicOptions` prop, `useSubmitInboundContact()` hook with auto-attached anonymous-session UUID, `<WebsiteConsentGate>` wrapper, and `defineWebsiteSection<TProps>` with the 8 `expectedLabelKeys` rooted at `website.contact.form.<leaf>`). The Verification grep invariants below (`useSubmitInboundContact`, no-bare-fetch, `<WebsiteConsentGate`) all reference its specific shape. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
|
|
722
|
+
```tsx
|
|
723
|
+
// website/src/sections/contact.section.tsx
|
|
724
|
+
import { useState } from 'react';
|
|
725
|
+
import {
|
|
726
|
+
defineWebsiteSection,
|
|
727
|
+
useSubmitInboundContact,
|
|
728
|
+
useWebsiteLabel,
|
|
729
|
+
WebsiteButton,
|
|
730
|
+
WebsiteConsentGate,
|
|
731
|
+
WebsiteHeading,
|
|
732
|
+
WebsiteSectionCategory,
|
|
733
|
+
WebsiteText,
|
|
734
|
+
} from '@wildo-ai/saas-website';
|
|
735
|
+
|
|
736
|
+
interface ContactSectionProps {
|
|
737
|
+
/** Topic options shown in the topic dropdown. */
|
|
738
|
+
topicOptions: readonly { value: string; labelKey: string }[];
|
|
739
|
+
}
|
|
740
|
+
|
|
741
|
+
function ContactSectionComponent({ topicOptions }: ContactSectionProps) {
|
|
742
|
+
const title = useWebsiteLabel('title');
|
|
743
|
+
const subtitle = useWebsiteLabel('subtitle');
|
|
744
|
+
const namePlaceholder = useWebsiteLabel('name-placeholder');
|
|
745
|
+
const emailPlaceholder = useWebsiteLabel('email-placeholder');
|
|
746
|
+
const topicPlaceholder = useWebsiteLabel('topic-placeholder');
|
|
747
|
+
const messagePlaceholder = useWebsiteLabel('message-placeholder');
|
|
748
|
+
const submitCta = useWebsiteLabel('submit-cta');
|
|
749
|
+
const successMessage = useWebsiteLabel('success-message');
|
|
750
|
+
|
|
751
|
+
const { submit, status } = useSubmitInboundContact();
|
|
752
|
+
const [name, setName] = useState('');
|
|
753
|
+
const [email, setEmail] = useState('');
|
|
754
|
+
const [topic, setTopic] = useState('');
|
|
755
|
+
const [message, setMessage] = useState('');
|
|
756
|
+
|
|
757
|
+
if (status === 'success') {
|
|
758
|
+
return (
|
|
759
|
+
<div className="contact contact--success">
|
|
760
|
+
<WebsiteText variant="lead">{successMessage}</WebsiteText>
|
|
761
|
+
</div>
|
|
762
|
+
);
|
|
763
|
+
}
|
|
764
|
+
|
|
765
|
+
return (
|
|
766
|
+
<WebsiteConsentGate>
|
|
767
|
+
<form
|
|
768
|
+
className="contact"
|
|
769
|
+
onSubmit={(e) => {
|
|
770
|
+
e.preventDefault();
|
|
771
|
+
void submit({ name, email, topic, message });
|
|
772
|
+
}}
|
|
773
|
+
>
|
|
774
|
+
<WebsiteHeading level={2} variant="title">{title}</WebsiteHeading>
|
|
775
|
+
<WebsiteText variant="lead">{subtitle}</WebsiteText>
|
|
776
|
+
<input
|
|
777
|
+
type="text"
|
|
778
|
+
required
|
|
779
|
+
value={name}
|
|
780
|
+
onChange={(e) => setName(e.target.value)}
|
|
781
|
+
placeholder={namePlaceholder}
|
|
782
|
+
/>
|
|
783
|
+
<input
|
|
784
|
+
type="email"
|
|
785
|
+
required
|
|
786
|
+
value={email}
|
|
787
|
+
onChange={(e) => setEmail(e.target.value)}
|
|
788
|
+
placeholder={emailPlaceholder}
|
|
789
|
+
/>
|
|
790
|
+
<select
|
|
791
|
+
required
|
|
792
|
+
value={topic}
|
|
793
|
+
onChange={(e) => setTopic(e.target.value)}
|
|
794
|
+
>
|
|
795
|
+
<option value="" disabled>{topicPlaceholder}</option>
|
|
796
|
+
{topicOptions.map((opt) => (
|
|
797
|
+
<ContactTopicOption key={opt.value} value={opt.value} labelKey={opt.labelKey} />
|
|
798
|
+
))}
|
|
799
|
+
</select>
|
|
800
|
+
<textarea
|
|
801
|
+
required
|
|
802
|
+
value={message}
|
|
803
|
+
onChange={(e) => setMessage(e.target.value)}
|
|
804
|
+
placeholder={messagePlaceholder}
|
|
805
|
+
/>
|
|
806
|
+
<WebsiteButton type="submit" variant="primary">{submitCta}</WebsiteButton>
|
|
807
|
+
</form>
|
|
808
|
+
</WebsiteConsentGate>
|
|
809
|
+
);
|
|
810
|
+
}
|
|
811
|
+
|
|
812
|
+
function ContactTopicOption({ value, labelKey }: { value: string; labelKey: string }) {
|
|
813
|
+
// Topic option labels live under their own section root (typically
|
|
814
|
+
// 'website.contact.form.topic.<value>') so they can be reused across
|
|
815
|
+
// multiple sections that need the same vocabulary.
|
|
816
|
+
return <option value={value}>{labelKey}</option>;
|
|
817
|
+
}
|
|
818
|
+
|
|
819
|
+
export const CONTACT_SECTION = defineWebsiteSection<ContactSectionProps>({
|
|
820
|
+
sectionRef: 'form',
|
|
821
|
+
category: WebsiteSectionCategory.CONTACT,
|
|
822
|
+
expectedLabelKeys: [
|
|
823
|
+
'website.contact.form.title',
|
|
824
|
+
'website.contact.form.subtitle',
|
|
825
|
+
'website.contact.form.name-placeholder',
|
|
826
|
+
'website.contact.form.email-placeholder',
|
|
827
|
+
'website.contact.form.topic-placeholder',
|
|
828
|
+
'website.contact.form.message-placeholder',
|
|
829
|
+
'website.contact.form.submit-cta',
|
|
830
|
+
'website.contact.form.success-message',
|
|
831
|
+
],
|
|
832
|
+
Component: ContactSectionComponent,
|
|
833
|
+
});
|
|
834
|
+
```
|
|
835
|
+
|
|
836
|
+
## Structured-data contract
|
|
837
|
+
|
|
838
|
+
`CONTACT` does not own a dedicated JSON-LD vocabulary at the section
|
|
839
|
+
level. Page-level emission of `Organization.contactPoint` (with
|
|
840
|
+
`contactType`, `email`, `availableLanguage`) is the standard
|
|
841
|
+
companion — declare it on the page manifest's `getStructuredData()`,
|
|
842
|
+
not here.
|
|
843
|
+
|
|
844
|
+
Leave the section's `getStructuredData` undefined — emit
|
|
845
|
+
`Organization.contactPoint` from the page manifest instead (see
|
|
846
|
+
"Catalog integration" below).
|
|
847
|
+
|
|
848
|
+
## Catalog integration (AEO)
|
|
849
|
+
|
|
850
|
+
`CONTACT` deliberately does NOT have a section-level catalog entry.
|
|
851
|
+
The contact data (email, phone, contact type, supported languages)
|
|
852
|
+
is a property of the brand `Organization` entity — emitting a
|
|
853
|
+
separate `ContactPoint` payload from this section would split the
|
|
854
|
+
identity that the AI assistant tries to consolidate.
|
|
855
|
+
|
|
856
|
+
The right pattern: the page manifest's `pagePayloads`
|
|
857
|
+
The installed structured-data contract emits
|
|
858
|
+
`Organization` once with a `contactPoint[]` field aggregating every
|
|
859
|
+
contact channel the page surfaces. The contact section's JSX renders
|
|
860
|
+
the same data; the JSON-LD lives at the page-manifest level so
|
|
861
|
+
`@id` deduplication folds duplicate contact info into a single
|
|
862
|
+
canonical block.
|
|
863
|
+
|
|
864
|
+
The installed `ORGANIZATION_CATALOG_ENTRY` contract hosts `contactPoint`
|
|
865
|
+
and lists it in
|
|
866
|
+
`optionalFields`; `recommendOptionals: true` so the companion warns
|
|
867
|
+
when the field is missing on contact-bearing pages).
|
|
868
|
+
|
|
869
|
+
**What earns its place in this section's emission**:
|
|
870
|
+
|
|
871
|
+
- Nothing — leave `getStructuredData` undefined.
|
|
872
|
+
- The contact data informs the page manifest's `Organization`
|
|
873
|
+
payload via `contactPoint[]`, NOT a separate section-level
|
|
874
|
+
emission.
|
|
875
|
+
|
|
876
|
+
**What is NOT in this emission**:
|
|
877
|
+
|
|
878
|
+
- A standalone `ContactPoint` payload — Schema.org `ContactPoint`
|
|
879
|
+
is meaningful only as a property of `Organization` /
|
|
880
|
+
`LocalBusiness` / `Person`; a top-level emission is invalid.
|
|
881
|
+
- A duplicate `Organization` re-emit — the hero / page-shell emits
|
|
882
|
+
it once; a duplicate would either dedupe (last-wins) or generate
|
|
883
|
+
drift if the two emissions disagree.
|
|
884
|
+
- App overrides — those live in the app's
|
|
885
|
+
`_catalogs/schema-org/organization.catalog-spec.ts`.
|
|
886
|
+
|
|
887
|
+
**Verification grep** (run from the app root):
|
|
888
|
+
|
|
889
|
+
| Invariant | Command |
|
|
890
|
+
|---|---|
|
|
891
|
+
| Section does NOT emit standalone ContactPoint | `rg -n "'ContactPoint'" website/src/sections/contact.section.tsx` (must return 0) |
|
|
892
|
+
| Page manifest emits Organization with contactPoint | `rg -n "contactPoint" website/src/pages-impl/*.page.tsx` (must return ≥1 on contact-bearing pages) |
|
|
893
|
+
|
|
894
|
+
## References
|
|
895
|
+
|
|
896
|
+
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
|
|
897
|
+
|
|
898
|
+
## Verification
|
|
899
|
+
|
|
900
|
+
- [ ] `category: WebsiteSectionCategory.CONTACT` (typed enum).
|
|
901
|
+
- [ ] Form submission goes through `useSubmitInboundContact()` —
|
|
902
|
+
never an ad-hoc `fetch('/api/inbound-contacts')`.
|
|
903
|
+
- [ ] No manual reading of the anonymous-session UUID; the hook
|
|
904
|
+
attaches it automatically.
|
|
905
|
+
- [ ] Form is wrapped in `<WebsiteConsentGate>`.
|
|
906
|
+
- [ ] All visible strings via `useWebsiteLabel`.
|
|
907
|
+
- [ ] Topic options reference label keys (the option `labelKey` is
|
|
908
|
+
itself a `WebsiteLabelKey`); never inline option strings.
|
|
909
|
+
|
|
910
|
+
### Grep invariants
|
|
911
|
+
|
|
912
|
+
| Invariant | Command |
|
|
913
|
+
|---|---|
|
|
914
|
+
| Hook used (no ad-hoc fetch) | `rg -n "useSubmitInboundContact\\(\\)" website/src/sections/contact.section.tsx` (must return ≥1) |
|
|
915
|
+
| No bare fetch | `rg -n "fetch\\('/api/inbound-contacts" website/src/sections/contact.section.tsx` (must return empty) |
|
|
916
|
+
| Consent gate present | `rg -n "<WebsiteConsentGate" website/src/sections/contact.section.tsx` (must return ≥1) |
|
|
917
|
+
|
|
918
|
+
## Common Rationalizations
|
|
919
|
+
|
|
920
|
+
| Rationalization | Reality |
|
|
921
|
+
|---|---|
|
|
922
|
+
| "I'll call `fetch('/api/inbound-contacts')` directly" | Bypasses anonymous-session UUID + first-touch metadata propagation; the resulting `InboundContact` row is orphaned from the visitor's session. |
|
|
923
|
+
| "Consent gating can wait" | Consent gating is jurisdiction-specific. Wrap with the placeholder from day one; the override skill teaches when to swap it for a real banner. |
|
|
924
|
+
| "Topic strings can be inline" | Locale-dependent; topic enum values must remain stable across locales while their display labels translate. |
|
|
925
|
+
| "I'll hard-redirect to `/thank-you` on success" | The `status === 'success'` branch renders in-place so the same `<WebsiteSection>` wrapper records the funnel-completion analytics impression; a redirect drops the impression AND severs the cross-frontend handoff context any post-submit nurture flow needs. |
|
|
926
|
+
|
|
927
|
+
## Red Flags
|
|
928
|
+
|
|
929
|
+
- A direct call to the InboundContact REST endpoint that hand-rolls
|
|
930
|
+
the headers — fragile and breaks the marketing-metadata contract.
|
|
931
|
+
Always use `useSubmitInboundContact`.
|
|
932
|
+
- `marketingMetadata` reading inside the section component — that
|
|
933
|
+
data lives on the anonymous session, not in component state.
|
|
934
|
+
- A "contact form" section that POSTs into a third-party service
|
|
935
|
+
(Mailchimp, Hubspot) — out of scope for this category. Build a
|
|
936
|
+
bespoke section using `website-factory-advanced`, or extend
|
|
937
|
+
`useSubmitInboundContact` semantics in a follow-up plan.
|
|
938
|
+
|
|
939
|
+
## Related Skills
|
|
940
|
+
|
|
941
|
+
- `website-inbound-contact-forms` — the lower-level skill (reusable
|
|
942
|
+
for newsletter / single-field / footer-newsletter forms).
|
|
943
|
+
- `website-consent-gate-overrides` — overriding the default
|
|
944
|
+
consent placeholder.
|
|
945
|
+
- `website-marketing-metadata-extension` — adding ICP-specific
|
|
946
|
+
fields to `marketingMetadata.extra`.
|
|
947
|
+
- `website-anonymous-session` — the parent-domain cookie carrier
|
|
948
|
+
the form's session UUID rides on.
|
|
949
|
+
- `website-page-authoring` — composing the contact section into
|
|
950
|
+
`/contact`.
|