@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,550 @@
|
|
|
1
|
+
# zod.decorators.chainable-runtime
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/zod-decorators`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Deep-merge mergeable decorator params with special handling for the `values` key.
|
|
14
|
+
*
|
|
15
|
+
* - Nested plain objects are merged recursively so later decorator calls can
|
|
16
|
+
* augment `display`, `edit`, and similar buckets without dropping earlier data.
|
|
17
|
+
* - `values` is merged per key, preserving existing enum/spec entries while still
|
|
18
|
+
* letting later calls override a nested property of the same entry.
|
|
19
|
+
* - Arrays and non-object values remain atomic and are replaced by the incoming value.
|
|
20
|
+
* - Additive only — to clear a nested property, set it to `undefined` explicitly.
|
|
21
|
+
*/
|
|
22
|
+
function deepMergeDecoratorParams(
|
|
23
|
+
existing: Record<string, unknown>,
|
|
24
|
+
incoming: Record<string, unknown>,
|
|
25
|
+
): Record<string, unknown> {
|
|
26
|
+
const result = { ...existing };
|
|
27
|
+
for (const [key, value] of Object.entries(incoming)) {
|
|
28
|
+
const existingValue = result[key];
|
|
29
|
+
|
|
30
|
+
if (key === 'values' && isPlainObject(value) && isPlainObject(existingValue)) {
|
|
31
|
+
const existingValues = existingValue as Record<string, Record<string, unknown>>;
|
|
32
|
+
const incomingValues = value as Record<string, Record<string, unknown>>;
|
|
33
|
+
result[key] = { ...existingValues };
|
|
34
|
+
for (const [enumValue, enumConfig] of Object.entries(incomingValues)) {
|
|
35
|
+
const existingEnumConfig = existingValues[enumValue];
|
|
36
|
+
(result[key] as Record<string, unknown>)[enumValue] =
|
|
37
|
+
isPlainObject(existingEnumConfig) && isPlainObject(enumConfig)
|
|
38
|
+
? deepMergeDecoratorParams(existingEnumConfig, enumConfig)
|
|
39
|
+
: enumConfig;
|
|
40
|
+
}
|
|
41
|
+
} else if (isPlainObject(value) && isPlainObject(existingValue)) {
|
|
42
|
+
result[key] = deepMergeDecoratorParams(existingValue, value);
|
|
43
|
+
} else {
|
|
44
|
+
result[key] = value;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
return result;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Decorators that can never share a field with {@link ZodDecorator.RAG_SOURCE}, each with the one
|
|
53
|
+
* sentence that justifies refusing it. ONE table, keyed by the companion, consulted in BOTH
|
|
54
|
+
* application orders by `assertRagSourceCompanionAdmissible` below — the alternative (a check
|
|
55
|
+
* inside each of the five companion methods plus one inside `ragSource`) is six hand-applied
|
|
56
|
+
* copies of one invariant — the failure shape where a fix lands at one of an invariant's N call
|
|
57
|
+
* sites and the other N-1 drift. Because the check lives in
|
|
58
|
+
* `applySingleDecorator`, it also covers every escape hatch (`addRagSource`, `addDecorators`,
|
|
59
|
+
* `z_file({ ragSource })`) for free: there is no door into decorator metadata that bypasses it.
|
|
60
|
+
*
|
|
61
|
+
* ## `TTL` is the one entry this table cannot actually enforce — do not read it as closing DL3
|
|
62
|
+
*
|
|
63
|
+
* Corrected 2026-08-27. `.ttl()`'s applicable types are `['ZodDate','ZodOptional']` and
|
|
64
|
+
* `.ragSource()`'s are `['ZodString','ZodOptional','ZodNullable','ZodDefault']`, so the two
|
|
65
|
+
* essentially cannot land on the SAME field — this row defends a type-impossible pair. The
|
|
66
|
+
* REACHABLE configuration is `expiresAt: z.date().ttl(...)` beside `notes: z.string().ragSource()`:
|
|
67
|
+
* two fields, one resource, one row that MongoDB's TTL monitor deletes whole with no application
|
|
68
|
+
* code running. That is a RESOURCE-level fact and is refused at resource level, at boot, by
|
|
69
|
+
* `ApplicationStartupConfigValidatorService.collectRagSourceRetentionRefusal` (which reads both
|
|
70
|
+
* existing authorities — the RAG field walker and `collectResourceRetentionPolicies` — rather than
|
|
71
|
+
* re-deriving either). The row below is KEPT because it is cheap, correct, and reports the
|
|
72
|
+
* single-field case at authoring time instead of at boot; it is not the control.
|
|
73
|
+
*/
|
|
74
|
+
const RAG_SOURCE_REFUSED_COMPANIONS: ReadonlyMap<ZodDecorator, string> = new Map([
|
|
75
|
+
[ZodDecorator.IS_PASSWORD, 'a password must never enter a retrieval corpus.'],
|
|
76
|
+
[ZodDecorator.IS_OTP, 'a one-time code must never enter a retrieval corpus.'],
|
|
77
|
+
[ZodDecorator.IS_WRITE_ONLY_SECRET, 'a write-only secret must never enter a retrieval corpus.'],
|
|
78
|
+
[ZodDecorator.IS_EPHEMERAL, 'an ephemeral shown-once value must never enter a retrieval corpus.'],
|
|
79
|
+
[
|
|
80
|
+
ZodDecorator.TTL,
|
|
81
|
+
'MongoDB honours .ttl() natively — rows vanish with no application code running, so derived chunks could never be erased with their parent (resource-rag-capability DL3). ' +
|
|
82
|
+
'The pair is normally declared on two DIFFERENT fields of one resource, which this field-level check cannot see: that case is refused at boot, per resource, by the startup RAG capability probe. ' +
|
|
83
|
+
'Both refusals lift when a sweep-cascade reconciles chunk rows against vanished parents.',
|
|
84
|
+
],
|
|
85
|
+
]);
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* Enforce the RAG-source refusal pairs in BOTH orders at the single decorator chokepoint:
|
|
89
|
+
* applying `RAG_SOURCE` to a schema already carrying a refused companion throws, and applying a
|
|
90
|
+
* refused companion to a schema already carrying `RAG_SOURCE` throws the same sentence. Reading
|
|
91
|
+
* `currentMetadata` (the bag this very application is about to write into) is what makes the check
|
|
92
|
+
* order-symmetric: wrapper chains carry their inner metadata forward (`wrapInstanceMethod` copies
|
|
93
|
+
* `SCHEMA_METADATA` across `.optional()` / `.nullable()` / `.default()`), so the earlier
|
|
94
|
+
* declaration is visible from wherever the later one lands.
|
|
95
|
+
*/
|
|
96
|
+
function assertRagSourceCompanionAdmissible(decorator: ZodDecorator, currentMetadata: CustomFieldMetadata): void {
|
|
97
|
+
if (decorator === ZodDecorator.RAG_SOURCE) {
|
|
98
|
+
for (const [companion, reason] of RAG_SOURCE_REFUSED_COMPANIONS) {
|
|
99
|
+
if (currentMetadata[companion] !== undefined) {
|
|
100
|
+
throw new Error(`ragSource() cannot be combined with ${companion}(): ${reason}`);
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
const reason = RAG_SOURCE_REFUSED_COMPANIONS.get(decorator);
|
|
107
|
+
if (reason !== undefined && currentMetadata[ZodDecorator.RAG_SOURCE] !== undefined) {
|
|
108
|
+
throw new Error(`${decorator}() cannot be combined with ragSource(): ${reason}`);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
113
|
+
schema: T,
|
|
114
|
+
decorator: ZodDecorator,
|
|
115
|
+
params?: ZodDecorator_ParamsType[ZodDecorator]
|
|
116
|
+
): T {
|
|
117
|
+
// Ensure schema exists before accessing Symbol property
|
|
118
|
+
if (!schema) {
|
|
119
|
+
throw new Error('Invalid schema provided to applySingleDecorator');
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
// Get existing metadata from Symbol property with proper type casting
|
|
123
|
+
const currentMetadata: CustomFieldMetadata = (schema as any)[SCHEMA_METADATA] || {};
|
|
124
|
+
|
|
125
|
+
// Refused RAG-source companions, both orders, before any metadata is written — a refusal that
|
|
126
|
+
// fired after a partial write would leave the schema carrying half of a rejected combination.
|
|
127
|
+
assertRagSourceCompanionAdmissible(decorator, currentMetadata);
|
|
128
|
+
|
|
129
|
+
// Generic updater function resolution: if params is a function, call it with
|
|
130
|
+
// the current metadata value and use the result. Works for any decorator.
|
|
131
|
+
let resolvedFromUpdater = false;
|
|
132
|
+
if (typeof params === 'function') {
|
|
133
|
+
const existing = currentMetadata[decorator];
|
|
134
|
+
const currentValue = (existing && typeof existing === 'object') ? existing : undefined;
|
|
135
|
+
params = (params as (current: unknown) => unknown)(currentValue) as typeof params;
|
|
136
|
+
resolvedFromUpdater = true;
|
|
137
|
+
}
|
|
138
|
+
// After function resolution, params is a concrete value (never a function).
|
|
139
|
+
// TypeScript can't narrow this from control flow. Use `rp<D>()` for typed
|
|
140
|
+
// access in cases that read properties; use `p` for simple assignments.
|
|
141
|
+
const p = params as any;
|
|
142
|
+
function rp<D extends ZodDecorator>(): Exclude<ZodDecorator_ParamsType[D], Function> {
|
|
143
|
+
return params as Exclude<ZodDecorator_ParamsType[D], Function>;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
// Handle each decorator explicitly.
|
|
147
|
+
// `p` is used instead of `params` for assignments — it's the same value
|
|
148
|
+
// but typed as `any` since TypeScript can't narrow the function union away
|
|
149
|
+
// after the generic resolution above.
|
|
150
|
+
switch (decorator) {
|
|
151
|
+
case ZodDecorator.IS_DB_INDEXED:
|
|
152
|
+
currentMetadata[ZodDecorator.IS_DB_INDEXED] = true;
|
|
153
|
+
break;
|
|
154
|
+
case ZodDecorator.IS_FOREIGN_KEY:
|
|
155
|
+
currentMetadata[ZodDecorator.IS_FOREIGN_KEY] = p ?? true;
|
|
156
|
+
break;
|
|
157
|
+
case ZodDecorator.IS_HIDDEN:
|
|
158
|
+
currentMetadata[ZodDecorator.IS_HIDDEN] = p ?? true;
|
|
159
|
+
break;
|
|
160
|
+
case ZodDecorator.IS_NOT_EDITABLE:
|
|
161
|
+
currentMetadata[ZodDecorator.IS_NOT_EDITABLE] = p ?? true;
|
|
162
|
+
break;
|
|
163
|
+
case ZodDecorator.IS_SUMMARY_FIELD:
|
|
164
|
+
currentMetadata[ZodDecorator.IS_SUMMARY_FIELD] = p ?? true;
|
|
165
|
+
break;
|
|
166
|
+
case ZodDecorator.IS_BACKEND_ONLY:
|
|
167
|
+
currentMetadata[ZodDecorator.IS_BACKEND_ONLY] = p ?? true;
|
|
168
|
+
break;
|
|
169
|
+
case ZodDecorator.IS_WRITE_ONLY_SECRET:
|
|
170
|
+
currentMetadata[ZodDecorator.IS_WRITE_ONLY_SECRET] = p ?? true;
|
|
171
|
+
break;
|
|
172
|
+
case ZodDecorator.IMPERSONALIZE_WITH: {
|
|
173
|
+
// Fail LOUD on a missing / blank treatment. This is the single chokepoint shared by the fluent
|
|
174
|
+
// `.impersonalizeWith(t)` method and the `addImpersonalizeWith(schema, t)` helper, so both doors
|
|
175
|
+
// reject the same inputs. Without it a bare `.impersonalizeWith()` (JS caller, or a TS caller
|
|
176
|
+
// whose value widened to undefined) would store `undefined`, `getImpersonalizeTreatment` would
|
|
177
|
+
// return `undefined`, and the field would read as UNTREATED — a silently unscrubbed personal
|
|
178
|
+
// field, i.e. exactly the PII-leak class this decorator exists to prevent.
|
|
179
|
+
//
|
|
180
|
+
// NORMALIZE HERE, not in the doors. Both authoring forms — the bare `RedactionType` string
|
|
181
|
+
// (the common case) and the `{ treatment, maskValue }` object (a MASK needing a field-specific
|
|
182
|
+
// value) — collapse to the params object before storage, so every reader sees ONE shape and
|
|
183
|
+
// the doors stay dumb pass-throughs. A raw `addDecorators()` caller lands here too.
|
|
184
|
+
const raw = p as unknown;
|
|
185
|
+
const normalized: ImpersonalizeFieldParams | undefined =
|
|
186
|
+
typeof raw === 'string'
|
|
187
|
+
? { treatment: raw }
|
|
188
|
+
: (raw !== null && typeof raw === 'object' && !Array.isArray(raw))
|
|
189
|
+
? { ...(raw as ImpersonalizeFieldParams) }
|
|
190
|
+
: undefined;
|
|
191
|
+
if (normalized === undefined || typeof normalized.treatment !== 'string' || normalized.treatment.trim().length === 0) {
|
|
192
|
+
throw new Error(
|
|
193
|
+
`impersonalizeWith(treatment) requires a non-empty RedactionType value (received ${JSON.stringify(raw)}). ` +
|
|
194
|
+
`An untreated field is left intact by the impersonalize writer — declare a treatment or omit the decorator.`,
|
|
195
|
+
);
|
|
196
|
+
}
|
|
197
|
+
// A blank override would write an empty string and erase the distinction between "masked" and
|
|
198
|
+
// "never had a value" — the same class of silent lie the treatment check above prevents.
|
|
199
|
+
// WHETHER a maskValue is legal for this treatment (MASK only) and whether the field's schema
|
|
200
|
+
// ACCEPTS it are both checked by the saas-models boot guard: this layer knows neither
|
|
201
|
+
// `RedactionType` nor the resource's mainSchema.
|
|
202
|
+
if (normalized.maskValue !== undefined && (typeof normalized.maskValue !== 'string' || normalized.maskValue.length === 0)) {
|
|
203
|
+
throw new Error(
|
|
204
|
+
`impersonalizeWith({ maskValue }) requires a non-empty string (received ${JSON.stringify(normalized.maskValue)}). ` +
|
|
205
|
+
`The mask value is written verbatim in place of the field — omit it to use the framework mask constant.`,
|
|
206
|
+
);
|
|
207
|
+
}
|
|
208
|
+
currentMetadata[ZodDecorator.IMPERSONALIZE_WITH] = normalized;
|
|
209
|
+
break;
|
|
210
|
+
}
|
|
211
|
+
case ZodDecorator.PORTABILITY_PROVENANCE: {
|
|
212
|
+
// Fail LOUD on a missing / blank provenance — the single chokepoint shared by the fluent
|
|
213
|
+
// `.portabilityProvenance(p)` method and the `addPortabilityProvenance(schema, p)` helper.
|
|
214
|
+
//
|
|
215
|
+
// Storing a blank would be worse here than for most decorators. An Art. 20 export treats an
|
|
216
|
+
// UNDECLARED field as a REFUSAL precisely because neither guess is safe (excluding
|
|
217
|
+
// under-delivers a legal right, including over-shares controller-derived data). A silently
|
|
218
|
+
// stored empty string would read back as declared-but-meaningless, converting that deliberate
|
|
219
|
+
// refusal into a fabricated answer about a disclosure boundary.
|
|
220
|
+
//
|
|
221
|
+
// WHETHER the value is a real `DataPortabilityProvenance` member is checked by the saas-models
|
|
222
|
+
// layer, which owns the enum — this layer knows only that a non-empty string was declared.
|
|
223
|
+
const raw = p as unknown;
|
|
224
|
+
if (typeof raw !== 'string' || raw.trim().length === 0) {
|
|
225
|
+
throw new Error(
|
|
226
|
+
`portabilityProvenance(provenance) requires a non-empty DataPortabilityProvenance value (received ${JSON.stringify(raw)}). ` +
|
|
227
|
+
`An undeclared field makes an Art. 20 export refuse rather than guess — declare a provenance or omit the decorator ` +
|
|
228
|
+
`to inherit the resource's portabilityPolicy.defaultProvenance.`,
|
|
229
|
+
);
|
|
230
|
+
}
|
|
231
|
+
currentMetadata[ZodDecorator.PORTABILITY_PROVENANCE] = raw;
|
|
232
|
+
break;
|
|
233
|
+
}
|
|
234
|
+
case ZodDecorator.DATA_CATEGORIES: {
|
|
235
|
+
// NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A single value (the
|
|
236
|
+
// common case) and an array both store a deduped ARRAY, so every reader sees one shape and
|
|
237
|
+
// `getDataCategories` answers "is this field categorized?" by presence alone.
|
|
238
|
+
//
|
|
239
|
+
// Fail LOUD on an empty declaration. An UNCATEGORIZED field is a legitimate, common state —
|
|
240
|
+
// most fields are not personal data — and the gap report is built on ABSENCE. A stored empty
|
|
241
|
+
// array would read back as declared-with-no-categories, which is invisible to a report
|
|
242
|
+
// looking for absence: the field would be silently excluded from the notice while looking
|
|
243
|
+
// annotated to anyone reading the schema.
|
|
244
|
+
//
|
|
245
|
+
// WHETHER each value is a real `PersonalDataCategory` member is checked by the resource
|
|
246
|
+
// factory's boot guard, which owns the enum — this layer knows only that non-empty strings
|
|
247
|
+
// were declared.
|
|
248
|
+
const raw = p as unknown;
|
|
249
|
+
const authored: readonly unknown[] = Array.isArray(raw) ? raw : [raw];
|
|
250
|
+
if (authored.length === 0 || authored.some((value) => typeof value !== 'string' || value.trim().length === 0)) {
|
|
251
|
+
throw new Error(
|
|
252
|
+
`dataCategories(categories) requires at least one non-empty PersonalDataCategory value (received ${JSON.stringify(raw)}). ` +
|
|
253
|
+
`A field that holds no personal data carries NO declaration — absence is what a category gap report reads. ` +
|
|
254
|
+
`An empty declaration looks annotated and discloses nothing.`,
|
|
255
|
+
);
|
|
256
|
+
}
|
|
257
|
+
currentMetadata[ZodDecorator.DATA_CATEGORIES] = [...new Set(authored as readonly string[])];
|
|
258
|
+
break;
|
|
259
|
+
}
|
|
260
|
+
case ZodDecorator.IS_AUDIT_EVIDENCE:
|
|
261
|
+
currentMetadata[ZodDecorator.IS_AUDIT_EVIDENCE] = true;
|
|
262
|
+
break;
|
|
263
|
+
case ZodDecorator.RAG_SOURCE: {
|
|
264
|
+
// NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A bare `.ragSource()`
|
|
265
|
+
// (the common case) stores `{}` rather than `true`/`undefined`, so every reader sees ONE
|
|
266
|
+
// shape and `getRagSourceConfig` answers "is this field a source?" by presence alone. The
|
|
267
|
+
// knobs are validated at decoration time because every one of them is otherwise a SILENT
|
|
268
|
+
// runtime misconfiguration: a zero chunkSize or an overlap >= size does not fail — it chunks
|
|
269
|
+
// pathologically (empty chunks, or every chunk repeating its predecessor), which surfaces
|
|
270
|
+
// as bad retrieval quality nobody traces back to the schema.
|
|
271
|
+
const raw = p as unknown;
|
|
272
|
+
if (raw !== undefined && (raw === null || typeof raw !== 'object' || Array.isArray(raw))) {
|
|
273
|
+
throw new Error(`ragSource(config?) accepts an optional RagSourceConfiguration object (received ${JSON.stringify(raw)}).`);
|
|
274
|
+
}
|
|
275
|
+
const normalized: RagSourceConfiguration = raw === undefined ? {} : { ...(raw as RagSourceConfiguration) };
|
|
276
|
+
const { chunkingStrategy, chunkSize, chunkOverlap } = normalized;
|
|
277
|
+
const knownStrategies = Object.values(RAGChunkingStrategy) as string[];
|
|
278
|
+
if (chunkingStrategy !== undefined && !knownStrategies.includes(chunkingStrategy)) {
|
|
279
|
+
throw new Error(
|
|
280
|
+
`ragSource({ chunkingStrategy }) must be a RAGChunkingStrategy member (received ${JSON.stringify(chunkingStrategy)}; known: ${knownStrategies.join(', ')}).`,
|
|
281
|
+
);
|
|
282
|
+
}
|
|
283
|
+
if (chunkSize !== undefined && (!Number.isInteger(chunkSize) || chunkSize <= 0)) {
|
|
284
|
+
throw new Error(`ragSource({ chunkSize }) must be a positive integer (received ${JSON.stringify(chunkSize)}).`);
|
|
285
|
+
}
|
|
286
|
+
if (chunkOverlap !== undefined && (!Number.isInteger(chunkOverlap) || chunkOverlap < 0)) {
|
|
287
|
+
throw new Error(`ragSource({ chunkOverlap }) must be a non-negative integer (received ${JSON.stringify(chunkOverlap)}).`);
|
|
288
|
+
}
|
|
289
|
+
if (chunkSize !== undefined && chunkOverlap !== undefined && chunkOverlap >= chunkSize) {
|
|
290
|
+
throw new Error(
|
|
291
|
+
`ragSource({ chunkSize, chunkOverlap }) requires chunkOverlap < chunkSize (received overlap ${chunkOverlap} >= size ${chunkSize}) — ` +
|
|
292
|
+
`an overlap that reaches the chunk size makes every chunk repeat its predecessor.`,
|
|
293
|
+
);
|
|
294
|
+
}
|
|
295
|
+
currentMetadata[ZodDecorator.RAG_SOURCE] = normalized;
|
|
296
|
+
break;
|
|
297
|
+
}
|
|
298
|
+
case ZodDecorator.IS_VIRTUAL: {
|
|
299
|
+
const vp = rp<ZodDecorator.IS_VIRTUAL>();
|
|
300
|
+
if (!vp?.calculate) {
|
|
301
|
+
throw new Error('isVirtual decorator requires a calculate function');
|
|
302
|
+
}
|
|
303
|
+
currentMetadata[ZodDecorator.IS_VIRTUAL] = vp;
|
|
304
|
+
break;
|
|
305
|
+
}
|
|
306
|
+
case ZodDecorator.IS_DISCRIMINATOR:
|
|
307
|
+
currentMetadata[ZodDecorator.IS_DISCRIMINATOR] = p ?? true;
|
|
308
|
+
break;
|
|
309
|
+
case ZodDecorator.EXCLUDE_FROM_CREATE:
|
|
310
|
+
currentMetadata[ZodDecorator.EXCLUDE_FROM_CREATE] = true;
|
|
311
|
+
break;
|
|
312
|
+
case ZodDecorator.EXCLUDE_FROM_UPDATE:
|
|
313
|
+
currentMetadata[ZodDecorator.EXCLUDE_FROM_UPDATE] = true;
|
|
314
|
+
break;
|
|
315
|
+
case ZodDecorator.IS_UNIQUE:
|
|
316
|
+
currentMetadata[ZodDecorator.IS_UNIQUE] = p ?? true;
|
|
317
|
+
break;
|
|
318
|
+
case ZodDecorator.IS_PRIMARY_KEY:
|
|
319
|
+
currentMetadata[ZodDecorator.IS_PRIMARY_KEY] = true;
|
|
320
|
+
break;
|
|
321
|
+
case ZodDecorator.IS_BUSINESS_KEY:
|
|
322
|
+
currentMetadata[ZodDecorator.IS_BUSINESS_KEY] = true;
|
|
323
|
+
break;
|
|
324
|
+
case ZodDecorator.OBJECT_BUSINESS_KEY_SET:
|
|
325
|
+
currentMetadata[ZodDecorator.OBJECT_BUSINESS_KEY_SET] = p;
|
|
326
|
+
break;
|
|
327
|
+
case ZodDecorator.TTL:
|
|
328
|
+
currentMetadata[ZodDecorator.TTL] = p;
|
|
329
|
+
break;
|
|
330
|
+
case ZodDecorator.IS_PASSWORD:
|
|
331
|
+
currentMetadata[ZodDecorator.IS_PASSWORD] = true;
|
|
332
|
+
break;
|
|
333
|
+
case ZodDecorator.IS_OTP:
|
|
334
|
+
currentMetadata[ZodDecorator.IS_OTP] = p ?? true;
|
|
335
|
+
break;
|
|
336
|
+
case ZodDecorator.IS_COLOR:
|
|
337
|
+
currentMetadata[ZodDecorator.IS_COLOR] = true;
|
|
338
|
+
break;
|
|
339
|
+
case ZodDecorator.IS_DRAFT_RELAXED:
|
|
340
|
+
currentMetadata[ZodDecorator.IS_DRAFT_RELAXED] = true;
|
|
341
|
+
break;
|
|
342
|
+
case ZodDecorator.SHOW_WHEN:
|
|
343
|
+
currentMetadata[ZodDecorator.SHOW_WHEN] = p;
|
|
344
|
+
break;
|
|
345
|
+
case ZodDecorator.SYSTEM_ENUM:
|
|
346
|
+
currentMetadata[ZodDecorator.SYSTEM_ENUM] = p;
|
|
347
|
+
break;
|
|
348
|
+
case ZodDecorator.IS_EPHEMERAL:
|
|
349
|
+
currentMetadata[ZodDecorator.IS_EPHEMERAL] = true;
|
|
350
|
+
break;
|
|
351
|
+
case ZodDecorator.IS_CRDT:
|
|
352
|
+
currentMetadata[ZodDecorator.IS_CRDT] = true;
|
|
353
|
+
break;
|
|
354
|
+
// Mergeable decorator buckets: primitive UI/spec decorators deep-merge
|
|
355
|
+
// plain-object params by default, while updater functions still replace
|
|
356
|
+
// exactly with what they return.
|
|
357
|
+
case ZodDecorator.ENUM_UI: {
|
|
358
|
+
const existing = currentMetadata[decorator];
|
|
359
|
+
if (p === undefined) {
|
|
360
|
+
(currentMetadata as Record<string, unknown>)[decorator] = existing ?? true;
|
|
361
|
+
} else if (resolvedFromUpdater) {
|
|
362
|
+
(currentMetadata as Record<string, unknown>)[decorator] = p;
|
|
363
|
+
} else {
|
|
364
|
+
(currentMetadata as Record<string, unknown>)[decorator] =
|
|
365
|
+
isPlainObject(existing) && isPlainObject(p)
|
|
366
|
+
? deepMergeDecoratorParams(existing, p)
|
|
367
|
+
: p;
|
|
368
|
+
}
|
|
369
|
+
break;
|
|
370
|
+
}
|
|
371
|
+
case ZodDecorator.BOOLEAN_UI:
|
|
372
|
+
case ZodDecorator.STRING_UI:
|
|
373
|
+
case ZodDecorator.NUMBER_UI:
|
|
374
|
+
case ZodDecorator.DATE_UI:
|
|
375
|
+
case ZodDecorator.DATETIME_UI:
|
|
376
|
+
case ZodDecorator.TIME_UI:
|
|
377
|
+
case ZodDecorator.MONEY_UI:
|
|
378
|
+
case ZodDecorator.CODE_UI:
|
|
379
|
+
case ZodDecorator.FILE_UI:
|
|
380
|
+
case ZodDecorator.DURATION_UI:
|
|
381
|
+
case ZodDecorator.PHONE_UI:
|
|
382
|
+
case ZodDecorator.BIGDECIMAL_UI:
|
|
383
|
+
case ZodDecorator.FOREIGN_KEY_UI:
|
|
384
|
+
case ZodDecorator.ARRAY_UI:
|
|
385
|
+
case ZodDecorator.OBJECT_UI:
|
|
386
|
+
case ZodDecorator.STRING_SPEC:
|
|
387
|
+
case ZodDecorator.NUMBER_SPEC:
|
|
388
|
+
case ZodDecorator.BOOLEAN_SPEC:
|
|
389
|
+
case ZodDecorator.DATE_SPEC:
|
|
390
|
+
case ZodDecorator.DATETIME_SPEC:
|
|
391
|
+
case ZodDecorator.TIME_SPEC:
|
|
392
|
+
case ZodDecorator.ENUM_SPEC:
|
|
393
|
+
case ZodDecorator.MONEY_SPEC:
|
|
394
|
+
case ZodDecorator.CODE_SPEC:
|
|
395
|
+
case ZodDecorator.FILE_SPEC:
|
|
396
|
+
case ZodDecorator.DURATION_SPEC:
|
|
397
|
+
case ZodDecorator.PHONE_SPEC:
|
|
398
|
+
case ZodDecorator.BIGDECIMAL_SPEC:
|
|
399
|
+
case ZodDecorator.FOREIGN_KEY_SPEC:
|
|
400
|
+
case ZodDecorator.ARRAY_SPEC:
|
|
401
|
+
case ZodDecorator.OBJECT_SPEC: {
|
|
402
|
+
const existing = currentMetadata[decorator];
|
|
403
|
+
if (p === undefined) {
|
|
404
|
+
(currentMetadata as Record<string, unknown>)[decorator] = existing ?? true;
|
|
405
|
+
} else if (resolvedFromUpdater) {
|
|
406
|
+
(currentMetadata as Record<string, unknown>)[decorator] = p;
|
|
407
|
+
} else {
|
|
408
|
+
(currentMetadata as Record<string, unknown>)[decorator] =
|
|
409
|
+
isPlainObject(existing) && isPlainObject(p)
|
|
410
|
+
? deepMergeDecoratorParams(existing, p)
|
|
411
|
+
: p;
|
|
412
|
+
}
|
|
413
|
+
break;
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
// Store updated metadata using Symbol
|
|
418
|
+
(schema as any)[SCHEMA_METADATA] = currentMetadata;
|
|
419
|
+
propagateWrapperDecoratorMetadataToInnerSchema(schema, currentMetadata);
|
|
420
|
+
|
|
421
|
+
return addChainableMethods(schema) as T;
|
|
422
|
+
}
|
|
423
|
+
```
|
|
424
|
+
|
|
425
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
426
|
+
|
|
427
|
+
```typescript
|
|
428
|
+
*
|
|
429
|
+
* Wraps an instance method to preserve SCHEMA_METADATA when it returns a new instance.
|
|
430
|
+
* In Zod v4, methods are on instances not prototypes, so we wrap them individually.
|
|
431
|
+
* Also wraps the result's methods to ensure metadata persists through the entire chain.
|
|
432
|
+
*/
|
|
433
|
+
function wrapInstanceMethod(instance: any, methodName: string): void {
|
|
434
|
+
const originalMethod = instance[methodName];
|
|
435
|
+
if (typeof originalMethod !== 'function') return;
|
|
436
|
+
|
|
437
|
+
// Skip if already wrapped
|
|
438
|
+
if ((originalMethod as any).__metadataWrapped) return;
|
|
439
|
+
|
|
440
|
+
// Use special wrapper for field-transform methods on ZodObject
|
|
441
|
+
const isObjectFieldTransform = OBJECT_FIELD_TRANSFORM_METHODS_SET.has(methodName) &&
|
|
442
|
+
instance.constructor?.name === 'ZodObject';
|
|
443
|
+
|
|
444
|
+
const wrappedMethod = function(this: any, ...args: any[]) {
|
|
445
|
+
// Get original shape before transformation (for field-transform methods)
|
|
446
|
+
const originalShape = isObjectFieldTransform ? this.shape : null;
|
|
447
|
+
const originalSchemaMetadata = (this as any)[SCHEMA_METADATA];
|
|
448
|
+
|
|
449
|
+
const result = originalMethod.apply(this, args);
|
|
450
|
+
|
|
451
|
+
// Copy metadata from original to result if it exists and result is different
|
|
452
|
+
if (result && result !== this) {
|
|
453
|
+
// Preserve all decorator metadata (including rangeConfig and currencyConfig)
|
|
454
|
+
if (originalSchemaMetadata && Object.keys(originalSchemaMetadata).length > 0) {
|
|
455
|
+
(result as any)[SCHEMA_METADATA] = { ...originalSchemaMetadata };
|
|
456
|
+
}
|
|
457
|
+
|
|
458
|
+
// For field-transform methods, copy field-level metadata to new wrapped fields
|
|
459
|
+
if (isObjectFieldTransform && originalShape && result.shape) {
|
|
460
|
+
copyFieldMetadata(originalShape, result.shape);
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
// Also wrap the result's methods so metadata persists through subsequent chains
|
|
464
|
+
wrapInstanceMethodsForMetadata(result);
|
|
465
|
+
}
|
|
466
|
+
return result;
|
|
467
|
+
};
|
|
468
|
+
|
|
469
|
+
// Mark as wrapped to avoid double-wrapping
|
|
470
|
+
(wrappedMethod as any).__metadataWrapped = true;
|
|
471
|
+
|
|
472
|
+
instance[methodName] = wrappedMethod;
|
|
473
|
+
}
|
|
474
|
+
|
|
475
|
+
/**
|
|
476
|
+
* Copy field-level metadata from original shape to new shape.
|
|
477
|
+
* Used for methods like .partial() that wrap fields in new types.
|
|
478
|
+
*/
|
|
479
|
+
function copyFieldMetadata(originalShape: Record<string, any>, newShape: Record<string, any>): void {
|
|
480
|
+
for (const fieldName of Object.keys(originalShape)) {
|
|
481
|
+
const originalField = originalShape[fieldName];
|
|
482
|
+
const newField = newShape[fieldName];
|
|
483
|
+
|
|
484
|
+
if (originalField && newField && originalField !== newField) {
|
|
485
|
+
const fieldMetadata = (originalField as any)[SCHEMA_METADATA];
|
|
486
|
+
|
|
487
|
+
if (fieldMetadata && Object.keys(fieldMetadata).length > 0) {
|
|
488
|
+
(newField as any)[SCHEMA_METADATA] = deepCloneValue(fieldMetadata);
|
|
489
|
+
|
|
490
|
+
// Also wrap the new field's methods for future chaining
|
|
491
|
+
wrapInstanceMethodsForMetadata(newField);
|
|
492
|
+
}
|
|
493
|
+
}
|
|
494
|
+
}
|
|
495
|
+
}
|
|
496
|
+
|
|
497
|
+
/**
|
|
498
|
+
* Wrap only the instance methods (not decorator methods) for metadata preservation.
|
|
499
|
+
* Used when copying metadata to a new schema instance.
|
|
500
|
+
*/
|
|
501
|
+
function wrapInstanceMethodsForMetadata(schema: any): void {
|
|
502
|
+
for (const methodName of ZOD_INSTANCE_METHODS_TO_WRAP) {
|
|
503
|
+
if (typeof schema[methodName] === 'function') {
|
|
504
|
+
wrapInstanceMethod(schema, methodName);
|
|
505
|
+
}
|
|
506
|
+
}
|
|
507
|
+
}
|
|
508
|
+
|
|
509
|
+
|
|
510
|
+
|
|
511
|
+
export function addChainableMethods<T extends z.ZodTypeAny>(schema: T): T {
|
|
512
|
+
const decoratedSchema = schema as DecoratedPrimitiveZodType<T>;
|
|
513
|
+
|
|
514
|
+
// CRITICAL: Wrap instance methods that return new instances to preserve metadata
|
|
515
|
+
// In Zod v4, methods are on instances not prototypes
|
|
516
|
+
for (const methodName of ZOD_INSTANCE_METHODS_TO_WRAP) {
|
|
517
|
+
if (typeof (decoratedSchema as any)[methodName] === 'function') {
|
|
518
|
+
wrapInstanceMethod(decoratedSchema, methodName);
|
|
519
|
+
}
|
|
520
|
+
}
|
|
521
|
+
|
|
522
|
+
const ctorName = (decoratedSchema as any)?.constructor?.name as string | undefined;
|
|
523
|
+
|
|
524
|
+
for (const decorator of Object.values(ZodDecorator)) {
|
|
525
|
+
const applyable = ZodDecorator_ApplyableType[decorator];
|
|
526
|
+
if (!applyable || !ctorName) continue;
|
|
527
|
+
if (!applyable.includes(ctorName)) continue;
|
|
528
|
+
if (Object.prototype.hasOwnProperty.call(decoratedSchema, decorator)) continue;
|
|
529
|
+
|
|
530
|
+
// Use the actual function from ZodDecorator_FunctionType to preserve composite
|
|
531
|
+
// decorator behavior (e.g., isPrimaryKey sets 5 decorators, isPassword sets 2).
|
|
532
|
+
// Falling back to a generic wrapper should never happen if the table is complete.
|
|
533
|
+
const registeredFn = ZodDecorator_FunctionType[decorator];
|
|
534
|
+
const value = registeredFn
|
|
535
|
+
? (...args: any[]) => registeredFn.apply(decoratedSchema, args)
|
|
536
|
+
: (params: any) => addDecorators(decoratedSchema, [{ ref: decorator, params }]);
|
|
537
|
+
|
|
538
|
+
Object.defineProperty(decoratedSchema, decorator, { value, ...defaultZodDecoSchemaProperties});
|
|
539
|
+
}
|
|
540
|
+
|
|
541
|
+
if (!decoratedSchema.hasOwnProperty('addDecorators')) {
|
|
542
|
+
Object.defineProperty(decoratedSchema, 'addDecorators', {
|
|
543
|
+
value: (decorators: DecoratorInput[]) => addDecorators(decoratedSchema, decorators),
|
|
544
|
+
...defaultZodDecoSchemaProperties
|
|
545
|
+
});
|
|
546
|
+
}
|
|
547
|
+
|
|
548
|
+
return decoratedSchema as T;
|
|
549
|
+
}
|
|
550
|
+
```
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# zod.decorators.conditional-visibility
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/zod-decorators`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* FIX-P5-H1: Operator for showWhen condition comparison.
|
|
14
|
+
* - EQUALS: Field value equals the specified value
|
|
15
|
+
* - NOT_EQUALS: Field value does not equal the specified value
|
|
16
|
+
* - IN: Field value is in the specified array
|
|
17
|
+
* - NOT_IN: Field value is not in the specified array
|
|
18
|
+
* - EXISTS: Field value exists (is defined and not null)
|
|
19
|
+
* - NOT_EXISTS: Field value does not exist (undefined or null)
|
|
20
|
+
*/
|
|
21
|
+
export enum ShowWhenOperator {
|
|
22
|
+
EQUALS = 'equals',
|
|
23
|
+
NOT_EQUALS = 'notEquals',
|
|
24
|
+
IN = 'in',
|
|
25
|
+
NOT_IN = 'notIn',
|
|
26
|
+
EXISTS = 'exists',
|
|
27
|
+
NOT_EXISTS = 'notExists',
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* FIX-P5-H1: A single condition for showWhen decorator.
|
|
32
|
+
* The field is visible when this condition is satisfied.
|
|
33
|
+
*/
|
|
34
|
+
export interface ShowWhenCondition {
|
|
35
|
+
/** Field name to watch for changes */
|
|
36
|
+
field: string;
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Value(s) that satisfy the condition.
|
|
40
|
+
* For EQUALS/NOT_EQUALS: single value or array
|
|
41
|
+
* For IN/NOT_IN: array of values
|
|
42
|
+
* For EXISTS/NOT_EXISTS: ignored
|
|
43
|
+
*/
|
|
44
|
+
value?: unknown | unknown[];
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Comparison operator.
|
|
48
|
+
* @default ShowWhenOperator.EQUALS
|
|
49
|
+
*/
|
|
50
|
+
operator?: ShowWhenOperator;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* FIX-P5-H1: Parameters for the showWhen decorator.
|
|
55
|
+
* Configures conditional visibility for form fields.
|
|
56
|
+
*
|
|
57
|
+
* Available on every form-field type — each primitive, plus object and array, plus the `optional` /
|
|
58
|
+
* `default` / `nullable` wrappers — matching `ZodDecorator_ApplyableType[SHOW_WHEN]`. The bare form
|
|
59
|
+
* below is the documented one and works as written; before 2026-08-12 it threw, because the
|
|
60
|
+
* decorator was installed on the wrapper prototypes only.
|
|
61
|
+
*
|
|
62
|
+
* @example
|
|
63
|
+
* ```ts
|
|
64
|
+
* // Show when 'type' field equals 'advanced'
|
|
65
|
+
* advancedOption: z.string().showWhen({
|
|
66
|
+
* conditions: { field: 'type', value: 'advanced' }
|
|
67
|
+
* })
|
|
68
|
+
*
|
|
69
|
+
* // Show when 'type' is one of multiple values
|
|
70
|
+
* featureOption: z.string().showWhen({
|
|
71
|
+
* conditions: { field: 'type', value: ['pro', 'enterprise'], operator: ShowWhenOperator.IN }
|
|
72
|
+
* })
|
|
73
|
+
*
|
|
74
|
+
* // On a defaulted field — the shape used by Your Application' `reminder.leadTimeMinutes`
|
|
75
|
+
* leadTimeMinutes: z.number().int().default(30).showWhen({
|
|
76
|
+
* conditions: { field: 'enabled', value: true }
|
|
77
|
+
* })
|
|
78
|
+
*
|
|
79
|
+
* // Show when both conditions are met
|
|
80
|
+
* premiumFeature: z.string().showWhen({
|
|
81
|
+
* conditions: [
|
|
82
|
+
* { field: 'type', value: 'enterprise' },
|
|
83
|
+
* { field: 'hasPremium', value: true }
|
|
84
|
+
* ],
|
|
85
|
+
* combineWith: 'and'
|
|
86
|
+
* })
|
|
87
|
+
* ```
|
|
88
|
+
*/
|
|
89
|
+
export interface ShowWhenParams {
|
|
90
|
+
/**
|
|
91
|
+
* Condition(s) that control visibility.
|
|
92
|
+
* Can be a single condition or array of conditions.
|
|
93
|
+
*/
|
|
94
|
+
conditions: ShowWhenCondition | ShowWhenCondition[];
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* How to combine multiple conditions.
|
|
98
|
+
* - 'and': All conditions must be true (default)
|
|
99
|
+
* - 'or': Any condition must be true
|
|
100
|
+
* @default 'and'
|
|
101
|
+
*/
|
|
102
|
+
combineWith?: 'and' | 'or';
|
|
103
|
+
}
|
|
104
|
+
```
|