@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,1286 @@
|
|
|
1
|
+
# Framework Special Factories API
|
|
2
|
+
|
|
3
|
+
This file exposes the source-backed factory helpers used when a shared schema
|
|
4
|
+
field should keep richer domain semantics than a plain primitive.
|
|
5
|
+
|
|
6
|
+
## Money
|
|
7
|
+
|
|
8
|
+
## Import Origins
|
|
9
|
+
|
|
10
|
+
- `@wildo-ai/zod-decorators`
|
|
11
|
+
|
|
12
|
+
## Source Excerpts
|
|
13
|
+
|
|
14
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
*
|
|
18
|
+
* z_money() - Creates money schemas for financial amounts.
|
|
19
|
+
*
|
|
20
|
+
* Money values are stored as integers to avoid floating-point precision issues.
|
|
21
|
+
* The schema creates an object with: { amount, currency, decimals }
|
|
22
|
+
*
|
|
23
|
+
* @example
|
|
24
|
+
* ```typescript
|
|
25
|
+
* import { z_money } from '@wildo-ai/zod-decorators';
|
|
26
|
+
*
|
|
27
|
+
* const price = z_money();
|
|
28
|
+
* const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });
|
|
29
|
+
* const usdPrice = z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } });
|
|
30
|
+
*
|
|
31
|
+
* // With decorators (chainable)
|
|
32
|
+
* z_money().moneyUI({ edit: { defaultCurrency: 'EUR' } })
|
|
33
|
+
* z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR] }).isHidden({ edit: true })
|
|
34
|
+
* ```
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Creates a money schema with metadata for detection and form component rendering.
|
|
39
|
+
*
|
|
40
|
+
* @param options - Configuration options for money field
|
|
41
|
+
* @returns A Zod object schema with metadata for money detection
|
|
42
|
+
*
|
|
43
|
+
* @example
|
|
44
|
+
* ```typescript
|
|
45
|
+
* // Simple money (all currencies)
|
|
46
|
+
* const price = z_money();
|
|
47
|
+
* // Infers: { amount: bigint, currency: string, decimals: number }
|
|
48
|
+
*
|
|
49
|
+
* // Fiat only (no crypto)
|
|
50
|
+
* const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });
|
|
51
|
+
*
|
|
52
|
+
* // Fixed currency with amount constraints
|
|
53
|
+
* const usdPrice = z_money({
|
|
54
|
+
* allowCurrencyChange: false,
|
|
55
|
+
* minAmount: 0n,
|
|
56
|
+
* maxAmount: 100000000n // $1,000,000.00 in cents
|
|
57
|
+
* }).moneyUI({ edit: { defaultCurrency: 'USD' } });
|
|
58
|
+
* ```
|
|
59
|
+
*/
|
|
60
|
+
export function createMoneySchema(
|
|
61
|
+
options: MoneySchemaOptions = {}
|
|
62
|
+
): DecoratedMoneySchema {
|
|
63
|
+
const {
|
|
64
|
+
currenciesAllowed,
|
|
65
|
+
appEnabledOnly = true,
|
|
66
|
+
allowCurrencyChange = true,
|
|
67
|
+
minAmount,
|
|
68
|
+
maxAmount,
|
|
69
|
+
} = options;
|
|
70
|
+
|
|
71
|
+
// Create the amount schema with optional min/max constraints
|
|
72
|
+
// Using bigint for amount to avoid precision issues with large financial amounts
|
|
73
|
+
let amountSchema = z.bigint();
|
|
74
|
+
if (minAmount !== undefined) {
|
|
75
|
+
amountSchema = amountSchema.min(minAmount);
|
|
76
|
+
}
|
|
77
|
+
if (maxAmount !== undefined) {
|
|
78
|
+
amountSchema = amountSchema.max(maxAmount);
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
// Create the money object schema
|
|
82
|
+
const moneySchema = z.object({
|
|
83
|
+
amount: amountSchema,
|
|
84
|
+
currency: CurrencySchema,
|
|
85
|
+
decimals: z.number().int().min(0).max(18),
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
const moneyMetadata: MoneySchemaMetadata = {
|
|
89
|
+
isMoney: true,
|
|
90
|
+
...(currenciesAllowed && currenciesAllowed.length > 0 && { currenciesAllowed }),
|
|
91
|
+
appEnabledOnly,
|
|
92
|
+
allowCurrencyChange,
|
|
93
|
+
...(minAmount !== undefined && { minAmount }),
|
|
94
|
+
...(maxAmount !== undefined && { maxAmount }),
|
|
95
|
+
};
|
|
96
|
+
|
|
97
|
+
// Initialize or extend SCHEMA_METADATA with money config
|
|
98
|
+
const existingMetadata: CustomFieldMetadata = (moneySchema as any)[SCHEMA_METADATA] || {};
|
|
99
|
+
(moneySchema as any)[SCHEMA_METADATA] = {
|
|
100
|
+
...existingMetadata,
|
|
101
|
+
moneyConfig: moneyMetadata,
|
|
102
|
+
};
|
|
103
|
+
|
|
104
|
+
// Add chainable decorator methods to the money schema instance
|
|
105
|
+
// This allows: z_money().moneyUI({ edit: { defaultCurrency: 'EUR' } }).isHidden()
|
|
106
|
+
addChainableMethods(moneySchema);
|
|
107
|
+
|
|
108
|
+
return moneySchema as DecoratedMoneySchema;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* Return type for money schemas - includes decorator methods.
|
|
113
|
+
* Note: IS_FOREIGN_KEY is not applicable to money objects.
|
|
114
|
+
* IS_DB_INDEXED will index internal fields (amount, currency) for query optimization.
|
|
115
|
+
*
|
|
116
|
+
* This type must list all decorators applicable to ZodObject (per ApplyableTypeAllTypes).
|
|
117
|
+
* Missing entries here cause TS errors when chaining decorators on z_money() fields.
|
|
118
|
+
*/
|
|
119
|
+
export type DecoratedMoneySchema = z.ZodObject<{
|
|
120
|
+
amount: z.ZodBigInt;
|
|
121
|
+
currency: typeof CurrencySchema;
|
|
122
|
+
decimals: z.ZodNumber;
|
|
123
|
+
}> & {
|
|
124
|
+
[ZodDecorator.IS_DB_INDEXED](): DecoratedMoneySchema;
|
|
125
|
+
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedMoneySchema;
|
|
126
|
+
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedMoneySchema;
|
|
127
|
+
// Resource-level decorators (applicable to all types including ZodObject)
|
|
128
|
+
[ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedMoneySchema;
|
|
129
|
+
[ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedMoneySchema;
|
|
130
|
+
[ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedMoneySchema;
|
|
131
|
+
[ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedMoneySchema;
|
|
132
|
+
[ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedMoneySchema;
|
|
133
|
+
addDecorators(decorators: DecoratorInput[]): DecoratedMoneySchema;
|
|
134
|
+
};
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* Creates a money schema for financial amounts with integer storage.
|
|
138
|
+
* Named z_money to indicate it's a Zod helper function exported standalone.
|
|
139
|
+
*
|
|
140
|
+
* Money values are stored as: { amount: int, currency: string, decimals: int }
|
|
141
|
+
* - amount: Value in smallest unit (e.g., cents for USD, satoshis for BTC)
|
|
142
|
+
* - currency: ISO 4217 code (e.g., 'USD', 'EUR', 'BTC')
|
|
143
|
+
* - decimals: Decimal places for display conversion (e.g., 2 for USD, 8 for BTC)
|
|
144
|
+
*
|
|
145
|
+
* @example
|
|
146
|
+
* ```typescript
|
|
147
|
+
* import { z_money } from '@wildo-ai/zod-decorators';
|
|
148
|
+
*
|
|
149
|
+
* // Simple usage
|
|
150
|
+
* z_money() // All currencies
|
|
151
|
+
*
|
|
152
|
+
* // With options
|
|
153
|
+
* z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] })
|
|
154
|
+
* z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } })
|
|
155
|
+
* z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR], minAmount: 0n })
|
|
156
|
+
*
|
|
157
|
+
* // With decorators (chainable)
|
|
158
|
+
* z_money().moneyUI({ edit: { defaultCurrency: 'USD' } })
|
|
159
|
+
* z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }).isHidden({ edit: true })
|
|
160
|
+
*
|
|
161
|
+
* // Usage example
|
|
162
|
+
* const price: MoneyValue = { amount: 1999n, currency: 'USD', decimals: 2 };
|
|
163
|
+
* // Represents $19.99
|
|
164
|
+
* ```
|
|
165
|
+
*/
|
|
166
|
+
export function z_money(
|
|
167
|
+
options?: MoneySchemaOptions
|
|
168
|
+
): DecoratedMoneySchema {
|
|
169
|
+
return createMoneySchema(options) as DecoratedMoneySchema;
|
|
170
|
+
}
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## Range
|
|
174
|
+
|
|
175
|
+
## Import Origins
|
|
176
|
+
|
|
177
|
+
- `@wildo-ai/zod-decorators`
|
|
178
|
+
|
|
179
|
+
## Source Excerpts
|
|
180
|
+
|
|
181
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
182
|
+
|
|
183
|
+
```typescript
|
|
184
|
+
*
|
|
185
|
+
* z_range() - Creates range schemas for number, date, datetime, or time ranges.
|
|
186
|
+
*
|
|
187
|
+
* This is a standalone Zod helper function (cannot be added to frozen Zod module at runtime).
|
|
188
|
+
*
|
|
189
|
+
* @example
|
|
190
|
+
* ```typescript
|
|
191
|
+
* import { z_range } from '@wildo-ai/saas-models';
|
|
192
|
+
*
|
|
193
|
+
* const priceRange = z_range('number', { min: 0, max: 1000 });
|
|
194
|
+
* const dateRange = z_range('date');
|
|
195
|
+
* const timeRange = z_range('time');
|
|
196
|
+
*
|
|
197
|
+
* // With decorators (chainable)
|
|
198
|
+
* z_range('number').numberUI({ edit: { editMode: 'SLIDER' } })
|
|
199
|
+
* z_range('date', { min: new Date() }).isHidden({ edit: true })
|
|
200
|
+
* ```
|
|
201
|
+
*/
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* Creates a range object schema with `from` and `to` fields.
|
|
205
|
+
* Stores metadata for easy detection and form component rendering.
|
|
206
|
+
*
|
|
207
|
+
* @param type - The type of values in the range
|
|
208
|
+
* @param options - Configuration options for optionality and constraints
|
|
209
|
+
* @returns A Zod object schema with metadata for range detection
|
|
210
|
+
*
|
|
211
|
+
* @example
|
|
212
|
+
* ```typescript
|
|
213
|
+
* // Simple number range (both optional)
|
|
214
|
+
* const priceRange = z.range('number');
|
|
215
|
+
* // Infers: { from?: number; to?: number }
|
|
216
|
+
*
|
|
217
|
+
* // Date range with required 'from'
|
|
218
|
+
* const eventRange = z.range('date', { fromOptional: false });
|
|
219
|
+
* // Infers: { from: Date; to?: Date }
|
|
220
|
+
*
|
|
221
|
+
* // Number range with min/max constraints
|
|
222
|
+
* const ageRange = z.range('number', { min: 0, max: 120 });
|
|
223
|
+
* // Infers: { from?: number; to?: number }
|
|
224
|
+
* // Metadata includes min: 0, max: 120 for UI hints
|
|
225
|
+
*
|
|
226
|
+
* // Both required with constraints
|
|
227
|
+
* const salaryRange = z.range('number', {
|
|
228
|
+
* fromOptional: false,
|
|
229
|
+
* toOptional: false,
|
|
230
|
+
* min: 0,
|
|
231
|
+
* });
|
|
232
|
+
* // Infers: { from: number; to: number }
|
|
233
|
+
* ```
|
|
234
|
+
*/
|
|
235
|
+
export function createRangeSchema<T extends RangeType>(
|
|
236
|
+
type: T,
|
|
237
|
+
options: RangeSchemaOptions = {}
|
|
238
|
+
): DecoratedRangeSchema {
|
|
239
|
+
const {
|
|
240
|
+
fromOptional = true,
|
|
241
|
+
toOptional = true,
|
|
242
|
+
min,
|
|
243
|
+
max,
|
|
244
|
+
} = options;
|
|
245
|
+
|
|
246
|
+
// Create the base schema for the value type
|
|
247
|
+
let baseSchema: z.ZodTypeAny;
|
|
248
|
+
|
|
249
|
+
switch (type) {
|
|
250
|
+
case RangeType.NUMBER:
|
|
251
|
+
baseSchema = z.number();
|
|
252
|
+
break;
|
|
253
|
+
case RangeType.DATE:
|
|
254
|
+
baseSchema = z.date();
|
|
255
|
+
break;
|
|
256
|
+
case RangeType.DATETIME:
|
|
257
|
+
baseSchema = z.iso.datetime();
|
|
258
|
+
break;
|
|
259
|
+
case RangeType.TIME:
|
|
260
|
+
baseSchema = z.iso.time();
|
|
261
|
+
break;
|
|
262
|
+
case RangeType.BIGDECIMAL:
|
|
263
|
+
baseSchema = BigDecimalValueSchema;
|
|
264
|
+
break;
|
|
265
|
+
case RangeType.MONEY:
|
|
266
|
+
baseSchema = MoneyValueSchema;
|
|
267
|
+
break;
|
|
268
|
+
default:
|
|
269
|
+
throw new Error(`Unknown range type: ${type}`);
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
// Create from/to schemas based on optionality
|
|
273
|
+
const fromSchema = fromOptional ? baseSchema.optional() : baseSchema;
|
|
274
|
+
const toSchema = toOptional ? baseSchema.optional() : baseSchema;
|
|
275
|
+
|
|
276
|
+
// Create the object schema
|
|
277
|
+
const rangeSchema = z.object({
|
|
278
|
+
from: fromSchema,
|
|
279
|
+
to: toSchema,
|
|
280
|
+
});
|
|
281
|
+
|
|
282
|
+
// Store range metadata in SCHEMA_METADATA.rangeConfig
|
|
283
|
+
const rangeMetadata: RangeSchemaMetadata = {
|
|
284
|
+
isRange: true,
|
|
285
|
+
type,
|
|
286
|
+
fromOptional,
|
|
287
|
+
toOptional,
|
|
288
|
+
...(min !== undefined && { min }),
|
|
289
|
+
...(max !== undefined && { max }),
|
|
290
|
+
};
|
|
291
|
+
|
|
292
|
+
// Initialize or extend SCHEMA_METADATA with range config
|
|
293
|
+
const existingMetadata: CustomFieldMetadata = (rangeSchema as any)[SCHEMA_METADATA] || {};
|
|
294
|
+
(rangeSchema as any)[SCHEMA_METADATA] = {
|
|
295
|
+
...existingMetadata,
|
|
296
|
+
rangeType: type,
|
|
297
|
+
rangeConfig: rangeMetadata,
|
|
298
|
+
};
|
|
299
|
+
|
|
300
|
+
// Add chainable decorator methods to the range schema instance
|
|
301
|
+
// This allows: z_range('number').numberUI({ edit: { editMode: 'SLIDER' } }).isHidden()
|
|
302
|
+
addChainableMethods(rangeSchema);
|
|
303
|
+
|
|
304
|
+
return rangeSchema as DecoratedRangeSchema;
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
/**
|
|
308
|
+
* Return type for range schemas - includes decorator methods.
|
|
309
|
+
* Note: IS_FOREIGN_KEY is not applicable to range objects.
|
|
310
|
+
* IS_DB_INDEXED will index internal fields (from, to) for range query optimization.
|
|
311
|
+
*/
|
|
312
|
+
export type DecoratedRangeSchema = z.ZodObject<any> & {
|
|
313
|
+
[ZodDecorator.IS_DB_INDEXED](): DecoratedRangeSchema;
|
|
314
|
+
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedRangeSchema;
|
|
315
|
+
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedRangeSchema;
|
|
316
|
+
addDecorators(decorators: DecoratorInput[]): DecoratedRangeSchema;
|
|
317
|
+
};
|
|
318
|
+
|
|
319
|
+
/**
|
|
320
|
+
* Creates a range object schema with `from` and `to` fields.
|
|
321
|
+
* Named z_range to indicate it's a Zod helper function exported standalone.
|
|
322
|
+
*
|
|
323
|
+
* @example
|
|
324
|
+
* ```typescript
|
|
325
|
+
* import { z_range } from '@wildo-ai/saas-models';
|
|
326
|
+
*
|
|
327
|
+
* // Simple usage
|
|
328
|
+
* z_range('number') // { from?: number; to?: number }
|
|
329
|
+
* z_range('date') // { from?: Date; to?: Date }
|
|
330
|
+
*
|
|
331
|
+
* // With options
|
|
332
|
+
* z_range('number', { fromOptional: false, min: 0 })
|
|
333
|
+
* z_range('datetime', { toOptional: false })
|
|
334
|
+
*
|
|
335
|
+
* // With decorators (chainable)
|
|
336
|
+
* z_range('number').numberUI({ edit: { editMode: 'SLIDER' } })
|
|
337
|
+
* z_range('date', { min: new Date() }).isHidden({ edit: true })
|
|
338
|
+
* ```
|
|
339
|
+
*/
|
|
340
|
+
export function z_range<T extends RangeType | `${RangeType}`>(
|
|
341
|
+
type: T,
|
|
342
|
+
options?: RangeSchemaOptions
|
|
343
|
+
): DecoratedRangeSchema {
|
|
344
|
+
return createRangeSchema(type as RangeType, options) as DecoratedRangeSchema;
|
|
345
|
+
}
|
|
346
|
+
```
|
|
347
|
+
|
|
348
|
+
## Duration
|
|
349
|
+
|
|
350
|
+
## Import Origins
|
|
351
|
+
|
|
352
|
+
- `@wildo-ai/zod-decorators`
|
|
353
|
+
|
|
354
|
+
## Source Excerpts
|
|
355
|
+
|
|
356
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
357
|
+
|
|
358
|
+
```typescript
|
|
359
|
+
*
|
|
360
|
+
* Duration value type — represents a time span with value and unit.
|
|
361
|
+
*
|
|
362
|
+
* Stored as { value: number, unit: DurationUnit } for clarity and flexibility.
|
|
363
|
+
* Use durationToSeconds() for canonical conversion when needed (e.g., TTL, expiry).
|
|
364
|
+
*
|
|
365
|
+
* @example
|
|
366
|
+
* { value: 5, unit: DurationUnit.MINUTES } // 5 minutes
|
|
367
|
+
* { value: 1, unit: DurationUnit.HOURS } // 1 hour
|
|
368
|
+
*/
|
|
369
|
+
export interface DurationValue {
|
|
370
|
+
/** Numeric quantity (must be non-negative for typical use) */
|
|
371
|
+
value: number;
|
|
372
|
+
/** Unit of time */
|
|
373
|
+
unit: DurationUnit;
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
/**
|
|
377
|
+
* Options for creating a duration schema via z_duration().
|
|
378
|
+
* Uses the DurationUnit enum for type-safe configuration.
|
|
379
|
+
*/
|
|
380
|
+
export interface DurationSchemaOptions {
|
|
381
|
+
/** Allowed units (if empty/undefined, all units are allowed) */
|
|
382
|
+
allowedUnits?: DurationUnit[];
|
|
383
|
+
/** Minimum value (for the numeric part) */
|
|
384
|
+
minValue?: number;
|
|
385
|
+
/** Maximum value (for the numeric part) */
|
|
386
|
+
maxValue?: number;
|
|
387
|
+
}
|
|
388
|
+
|
|
389
|
+
/** Seconds multiplier for each duration unit */
|
|
390
|
+
const DURATION_MULTIPLIERS: Record<DurationUnit, number> = {
|
|
391
|
+
[DurationUnit.MILLISECONDS]: 0.001,
|
|
392
|
+
[DurationUnit.SECONDS]: 1,
|
|
393
|
+
[DurationUnit.MINUTES]: 60,
|
|
394
|
+
[DurationUnit.HOURS]: 3600,
|
|
395
|
+
[DurationUnit.DAYS]: 86400,
|
|
396
|
+
[DurationUnit.WEEKS]: 604800,
|
|
397
|
+
[DurationUnit.MONTHS]: 30 * 86400,
|
|
398
|
+
[DurationUnit.YEARS]: 365.25 * 86400,
|
|
399
|
+
[DurationUnit.CENTURIES]: 100 * 365.25 * 86400,
|
|
400
|
+
};
|
|
401
|
+
|
|
402
|
+
/** Canonical Zod schema for DurationUnit. Clone via `z_clone()` for independent metadata. */
|
|
403
|
+
export const DurationUnitSchema = z.enum(DurationUnit).systemEnum('DurationUnit');
|
|
404
|
+
|
|
405
|
+
/**
|
|
406
|
+
* Zod schema for DurationValue.
|
|
407
|
+
*/
|
|
408
|
+
export const DurationValueSchema = z.object({
|
|
409
|
+
value: z.number().int().min(0),
|
|
410
|
+
unit: DurationUnitSchema,
|
|
411
|
+
});
|
|
412
|
+
|
|
413
|
+
/**
|
|
414
|
+
* Convert a duration to total seconds for canonical storage/comparison.
|
|
415
|
+
* Use when setting TTL, expiry, or comparing durations.
|
|
416
|
+
*
|
|
417
|
+
* @param d - Duration value
|
|
418
|
+
* @returns Total seconds
|
|
419
|
+
*/
|
|
420
|
+
export function durationToSeconds(d: DurationValue): number {
|
|
421
|
+
return d.value * DURATION_MULTIPLIERS[d.unit];
|
|
422
|
+
}
|
|
423
|
+
|
|
424
|
+
/**
|
|
425
|
+
* Create a duration from total seconds, using the most appropriate unit.
|
|
426
|
+
* Prefers larger units when the value divides evenly.
|
|
427
|
+
*
|
|
428
|
+
* @param totalSeconds - Total seconds
|
|
429
|
+
* @returns DurationValue
|
|
430
|
+
*/
|
|
431
|
+
export function secondsToDuration(totalSeconds: number): DurationValue {
|
|
432
|
+
if (totalSeconds <= 0) {
|
|
433
|
+
return { value: 0, unit: DurationUnit.SECONDS };
|
|
434
|
+
}
|
|
435
|
+
const units: DurationUnit[] = [
|
|
436
|
+
DurationUnit.CENTURIES,
|
|
437
|
+
DurationUnit.YEARS,
|
|
438
|
+
DurationUnit.MONTHS,
|
|
439
|
+
DurationUnit.WEEKS,
|
|
440
|
+
DurationUnit.DAYS,
|
|
441
|
+
DurationUnit.HOURS,
|
|
442
|
+
DurationUnit.MINUTES,
|
|
443
|
+
DurationUnit.SECONDS,
|
|
444
|
+
DurationUnit.MILLISECONDS,
|
|
445
|
+
];
|
|
446
|
+
for (const unit of units) {
|
|
447
|
+
const m = DURATION_MULTIPLIERS[unit];
|
|
448
|
+
if (totalSeconds % m === 0 && totalSeconds >= m) {
|
|
449
|
+
return { value: totalSeconds / m, unit };
|
|
450
|
+
}
|
|
451
|
+
}
|
|
452
|
+
return { value: totalSeconds, unit: DurationUnit.SECONDS };
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
/** Singular form for each duration unit (when value is 1) */
|
|
456
|
+
const DURATION_UNIT_SINGULAR: Record<DurationUnit, string> = {
|
|
457
|
+
[DurationUnit.MILLISECONDS]: 'millisecond',
|
|
458
|
+
[DurationUnit.SECONDS]: 'second',
|
|
459
|
+
[DurationUnit.MINUTES]: 'minute',
|
|
460
|
+
[DurationUnit.HOURS]: 'hour',
|
|
461
|
+
[DurationUnit.DAYS]: 'day',
|
|
462
|
+
[DurationUnit.WEEKS]: 'week',
|
|
463
|
+
[DurationUnit.MONTHS]: 'month',
|
|
464
|
+
[DurationUnit.YEARS]: 'year',
|
|
465
|
+
[DurationUnit.CENTURIES]: 'century',
|
|
466
|
+
};
|
|
467
|
+
|
|
468
|
+
/**
|
|
469
|
+
* Format a duration for display.
|
|
470
|
+
*
|
|
471
|
+
* @param d - Duration value
|
|
472
|
+
* @param options - Format options
|
|
473
|
+
* @returns Formatted string (e.g., "5 minutes", "1 hour")
|
|
474
|
+
*/
|
|
475
|
+
export function formatDuration(
|
|
476
|
+
d: DurationValue,
|
|
477
|
+
options: { pluralize?: boolean } = {}
|
|
478
|
+
): string {
|
|
479
|
+
const { pluralize = true } = options;
|
|
480
|
+
const label =
|
|
481
|
+
pluralize && d.value === 1
|
|
482
|
+
? DURATION_UNIT_SINGULAR[d.unit] ?? d.unit
|
|
483
|
+
: d.unit;
|
|
484
|
+
return `${d.value} ${label}`;
|
|
485
|
+
}
|
|
486
|
+
|
|
487
|
+
/**
|
|
488
|
+
* z_duration() - Creates duration schemas for time spans.
|
|
489
|
+
*
|
|
490
|
+
* Duration values are stored as { value, unit }.
|
|
491
|
+
* Use durationToSeconds() when you need canonical seconds (e.g., TTL).
|
|
492
|
+
*
|
|
493
|
+
* @example
|
|
494
|
+
* ```typescript
|
|
495
|
+
* import { z_duration, DurationUnit } from '@wildo-ai/zod-decorators';
|
|
496
|
+
*
|
|
497
|
+
* const sessionTtl = z_duration();
|
|
498
|
+
* const allowedUnits = z_duration({ allowedUnits: [DurationUnit.MINUTES, DurationUnit.HOURS] });
|
|
499
|
+
*
|
|
500
|
+
* // UI props via .durationUI()
|
|
501
|
+
* z_duration().durationUI({ edit: { defaultUnit: DurationUnit.MINUTES } })
|
|
502
|
+
* z_duration({ allowedUnits: [DurationUnit.HOURS, DurationUnit.DAYS] }).durationUI({ edit: { defaultUnit: DurationUnit.HOURS } })
|
|
503
|
+
* ```
|
|
504
|
+
*/
|
|
505
|
+
|
|
506
|
+
/**
|
|
507
|
+
* Creates a duration schema with metadata for detection and form component rendering.
|
|
508
|
+
*
|
|
509
|
+
* @param options - Configuration options for duration field
|
|
510
|
+
* @returns A Zod object schema with metadata for duration detection
|
|
511
|
+
*/
|
|
512
|
+
export function createDurationSchema(
|
|
513
|
+
options: DurationSchemaOptions = {}
|
|
514
|
+
): DecoratedDurationSchema {
|
|
515
|
+
const {
|
|
516
|
+
allowedUnits,
|
|
517
|
+
minValue,
|
|
518
|
+
maxValue,
|
|
519
|
+
} = options;
|
|
520
|
+
|
|
521
|
+
let valueSchema = z.number().int().min(0);
|
|
522
|
+
if (minValue !== undefined) {
|
|
523
|
+
valueSchema = valueSchema.min(minValue);
|
|
524
|
+
}
|
|
525
|
+
if (maxValue !== undefined) {
|
|
526
|
+
valueSchema = valueSchema.max(maxValue);
|
|
527
|
+
}
|
|
528
|
+
|
|
529
|
+
const unitSchema =
|
|
530
|
+
allowedUnits && allowedUnits.length > 0
|
|
531
|
+
? z.enum([allowedUnits[0], ...allowedUnits.slice(1)] as [string, ...string[]])
|
|
532
|
+
: DurationUnitSchema;
|
|
533
|
+
|
|
534
|
+
const durationSchema = z.object({
|
|
535
|
+
value: valueSchema,
|
|
536
|
+
unit: unitSchema,
|
|
537
|
+
});
|
|
538
|
+
|
|
539
|
+
const durationMetadata: DurationSchemaMetadata = {
|
|
540
|
+
isDuration: true,
|
|
541
|
+
...(allowedUnits && allowedUnits.length > 0 && { allowedUnits }),
|
|
542
|
+
...(minValue !== undefined && { minValue }),
|
|
543
|
+
...(maxValue !== undefined && { maxValue }),
|
|
544
|
+
};
|
|
545
|
+
|
|
546
|
+
const existingMetadata: CustomFieldMetadata = (durationSchema as any)[SCHEMA_METADATA] || {};
|
|
547
|
+
(durationSchema as any)[SCHEMA_METADATA] = {
|
|
548
|
+
...existingMetadata,
|
|
549
|
+
durationConfig: durationMetadata,
|
|
550
|
+
};
|
|
551
|
+
|
|
552
|
+
addChainableMethods(durationSchema);
|
|
553
|
+
|
|
554
|
+
return durationSchema as unknown as DecoratedDurationSchema;
|
|
555
|
+
}
|
|
556
|
+
|
|
557
|
+
/**
|
|
558
|
+
* Return type for duration schemas - includes decorator methods.
|
|
559
|
+
*/
|
|
560
|
+
export type DecoratedDurationSchema = z.ZodObject<{
|
|
561
|
+
value: z.ZodNumber;
|
|
562
|
+
unit: z.ZodTypeAny;
|
|
563
|
+
}> & {
|
|
564
|
+
[ZodDecorator.IS_DB_INDEXED](): DecoratedDurationSchema;
|
|
565
|
+
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedDurationSchema;
|
|
566
|
+
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedDurationSchema;
|
|
567
|
+
[ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedDurationSchema;
|
|
568
|
+
[ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedDurationSchema;
|
|
569
|
+
[ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedDurationSchema;
|
|
570
|
+
[ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedDurationSchema;
|
|
571
|
+
[ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedDurationSchema;
|
|
572
|
+
addDecorators(decorators: DecoratorInput[]): DecoratedDurationSchema;
|
|
573
|
+
};
|
|
574
|
+
|
|
575
|
+
/**
|
|
576
|
+
* Creates a duration schema for time spans.
|
|
577
|
+
*
|
|
578
|
+
* @example
|
|
579
|
+
* ```typescript
|
|
580
|
+
* import { z_duration, DurationUnit } from '@wildo-ai/zod-decorators';
|
|
581
|
+
*
|
|
582
|
+
* z_duration()
|
|
583
|
+
* z_duration({ allowedUnits: [DurationUnit.MINUTES, DurationUnit.HOURS, DurationUnit.DAYS] })
|
|
584
|
+
* z_duration({ minValue: 1, maxValue: 1440 }) // 1–1440 minutes
|
|
585
|
+
*
|
|
586
|
+
* // UI props via .durationUI()
|
|
587
|
+
* z_duration().durationUI({ edit: { defaultUnit: DurationUnit.HOURS } })
|
|
588
|
+
* ```
|
|
589
|
+
*/
|
|
590
|
+
export function z_duration(options?: DurationSchemaOptions): DecoratedDurationSchema {
|
|
591
|
+
return createDurationSchema(options);
|
|
592
|
+
}
|
|
593
|
+
```
|
|
594
|
+
|
|
595
|
+
## Phone
|
|
596
|
+
|
|
597
|
+
## Import Origins
|
|
598
|
+
|
|
599
|
+
- `@wildo-ai/zod-decorators`
|
|
600
|
+
|
|
601
|
+
## Source Excerpts
|
|
602
|
+
|
|
603
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
604
|
+
|
|
605
|
+
```typescript
|
|
606
|
+
*
|
|
607
|
+
* Creates a phone schema with metadata for detection and form component rendering.
|
|
608
|
+
* Values are stored as E.164 strings. Empty string passes validation.
|
|
609
|
+
*
|
|
610
|
+
* @param options - Configuration options for phone field
|
|
611
|
+
* @returns A Zod string schema with metadata for phone detection
|
|
612
|
+
*/
|
|
613
|
+
export function createPhoneSchema(options: PhoneSchemaOptions = {}): DecoratedPhoneSchema {
|
|
614
|
+
const { defaultCountry = DEFAULT_COUNTRY } = options;
|
|
615
|
+
|
|
616
|
+
const phoneMetadata: PhoneSchemaMetadata = {
|
|
617
|
+
isPhone: true,
|
|
618
|
+
defaultCountry,
|
|
619
|
+
};
|
|
620
|
+
|
|
621
|
+
// PhoneCountryCode is libphonenumber's CountryCode union, so no cast needed.
|
|
622
|
+
const country: CountryCode = defaultCountry;
|
|
623
|
+
const phoneSchema = z
|
|
624
|
+
.string()
|
|
625
|
+
.trim()
|
|
626
|
+
.refine((val) => val === '' || isValidPhone(val, country), {
|
|
627
|
+
message: 'Invalid phone number',
|
|
628
|
+
})
|
|
629
|
+
// E.164 normalization is string -> string, so model it as a Zod 4
|
|
630
|
+
// overwrite rather than a transform. The runtime result is identical, but
|
|
631
|
+
// the schema remains truthfully introspectable as a string by JSON Schema /
|
|
632
|
+
// OpenAPI generators instead of degrading to an unrepresentable transform.
|
|
633
|
+
.overwrite((val) => {
|
|
634
|
+
if (val === '') return '';
|
|
635
|
+
const parsed = parsePhone(val, country);
|
|
636
|
+
return parsed?.format('E.164') ?? val;
|
|
637
|
+
})
|
|
638
|
+
// Preserve the established ZodPipe surface used by decorator metadata and
|
|
639
|
+
// boundary walkers; the terminal string adds no value conversion.
|
|
640
|
+
.pipe(z.string()) as unknown as z.ZodString;
|
|
641
|
+
|
|
642
|
+
const existingMetadata: CustomFieldMetadata = (phoneSchema as any)[SCHEMA_METADATA] || {};
|
|
643
|
+
(phoneSchema as any)[SCHEMA_METADATA] = {
|
|
644
|
+
...existingMetadata,
|
|
645
|
+
phoneConfig: phoneMetadata,
|
|
646
|
+
};
|
|
647
|
+
|
|
648
|
+
addChainableMethods(phoneSchema);
|
|
649
|
+
|
|
650
|
+
return phoneSchema as unknown as DecoratedPhoneSchema;
|
|
651
|
+
}
|
|
652
|
+
|
|
653
|
+
/**
|
|
654
|
+
* Return type for phone schemas - includes decorator methods.
|
|
655
|
+
*/
|
|
656
|
+
export type DecoratedPhoneSchema = z.ZodString & {
|
|
657
|
+
[ZodDecorator.IS_DB_INDEXED](): DecoratedPhoneSchema;
|
|
658
|
+
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedPhoneSchema;
|
|
659
|
+
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedPhoneSchema;
|
|
660
|
+
[ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedPhoneSchema;
|
|
661
|
+
[ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedPhoneSchema;
|
|
662
|
+
[ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedPhoneSchema;
|
|
663
|
+
[ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedPhoneSchema;
|
|
664
|
+
[ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedPhoneSchema;
|
|
665
|
+
addDecorators(decorators: DecoratorInput[]): DecoratedPhoneSchema;
|
|
666
|
+
};
|
|
667
|
+
|
|
668
|
+
/**
|
|
669
|
+
* Creates a phone schema for E.164 phone numbers.
|
|
670
|
+
*
|
|
671
|
+
* @example
|
|
672
|
+
* ```typescript
|
|
673
|
+
* import { z_phone } from '@wildo-ai/zod-decorators';
|
|
674
|
+
*
|
|
675
|
+
* z_phone()
|
|
676
|
+
* z_phone({ defaultCountry: 'FR' })
|
|
677
|
+
* ```
|
|
678
|
+
*/
|
|
679
|
+
export function z_phone(options?: PhoneSchemaOptions): DecoratedPhoneSchema {
|
|
680
|
+
return createPhoneSchema(options);
|
|
681
|
+
}
|
|
682
|
+
```
|
|
683
|
+
|
|
684
|
+
## Code
|
|
685
|
+
|
|
686
|
+
## Import Origins
|
|
687
|
+
|
|
688
|
+
- `@wildo-ai/zod-decorators`
|
|
689
|
+
|
|
690
|
+
## Source Excerpts
|
|
691
|
+
|
|
692
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
693
|
+
|
|
694
|
+
```typescript
|
|
695
|
+
*
|
|
696
|
+
* z_code() - Creates code schemas for code snippets with language.
|
|
697
|
+
*
|
|
698
|
+
* @example
|
|
699
|
+
* ```typescript
|
|
700
|
+
* import { z_code } from '@wildo-ai/zod-decorators';
|
|
701
|
+
*
|
|
702
|
+
* const snippet = z_code();
|
|
703
|
+
* const restrictedCode = z_code({
|
|
704
|
+
* allowedLanguages: ['javascript', 'typescript', 'python'],
|
|
705
|
+
* maxLength: 10000
|
|
706
|
+
* });
|
|
707
|
+
*
|
|
708
|
+
* // UI props are now set via .codeUI():
|
|
709
|
+
* z_code().codeUI({ defaultLanguage: 'javascript', syntaxHighlighting: true })
|
|
710
|
+
* z_code().codeUI({ display: { showLineNumbers: true }, edit: { showLineNumbers: false } })
|
|
711
|
+
* ```
|
|
712
|
+
*/
|
|
713
|
+
|
|
714
|
+
/**
|
|
715
|
+
* Creates a code schema with metadata for detection and form component rendering.
|
|
716
|
+
*
|
|
717
|
+
* @param options - Configuration options for code field
|
|
718
|
+
* @returns A Zod object schema with metadata for code detection
|
|
719
|
+
*/
|
|
720
|
+
export function createCodeSchema(
|
|
721
|
+
options: CodeSchemaOptions = {}
|
|
722
|
+
): DecoratedCodeSchema {
|
|
723
|
+
const {
|
|
724
|
+
allowedLanguages,
|
|
725
|
+
maxLength,
|
|
726
|
+
minLength,
|
|
727
|
+
} = options;
|
|
728
|
+
|
|
729
|
+
// Create the content schema with optional length constraints
|
|
730
|
+
let contentSchema = z.string();
|
|
731
|
+
if (minLength !== undefined) {
|
|
732
|
+
contentSchema = contentSchema.min(minLength);
|
|
733
|
+
}
|
|
734
|
+
if (maxLength !== undefined) {
|
|
735
|
+
contentSchema = contentSchema.max(maxLength);
|
|
736
|
+
}
|
|
737
|
+
|
|
738
|
+
// Language is stored as a string. Allowed languages restriction is enforced
|
|
739
|
+
// through codeConfig.allowedLanguages metadata - UI components read this
|
|
740
|
+
// to filter available options, same pattern as money currencies.
|
|
741
|
+
const languageSchema = z.string();
|
|
742
|
+
|
|
743
|
+
// Create the code object schema
|
|
744
|
+
const codeSchema = z.object({
|
|
745
|
+
content: contentSchema,
|
|
746
|
+
language: languageSchema,
|
|
747
|
+
});
|
|
748
|
+
|
|
749
|
+
const codeMetadata: CodeSchemaMetadata = {
|
|
750
|
+
isCode: true,
|
|
751
|
+
...(allowedLanguages !== undefined && { allowedLanguages }),
|
|
752
|
+
...(maxLength !== undefined && { maxLength }),
|
|
753
|
+
...(minLength !== undefined && { minLength }),
|
|
754
|
+
};
|
|
755
|
+
|
|
756
|
+
// Initialize or extend SCHEMA_METADATA with code config
|
|
757
|
+
const existingMetadata: CustomFieldMetadata = (codeSchema as any)[SCHEMA_METADATA] || {};
|
|
758
|
+
(codeSchema as any)[SCHEMA_METADATA] = {
|
|
759
|
+
...existingMetadata,
|
|
760
|
+
codeConfig: codeMetadata,
|
|
761
|
+
};
|
|
762
|
+
|
|
763
|
+
// Add chainable decorator methods to the code schema instance
|
|
764
|
+
addChainableMethods(codeSchema);
|
|
765
|
+
|
|
766
|
+
return codeSchema as unknown as DecoratedCodeSchema;
|
|
767
|
+
}
|
|
768
|
+
|
|
769
|
+
/**
|
|
770
|
+
* Return type for code schemas - includes decorator methods.
|
|
771
|
+
* IS_DB_INDEXED will index internal fields (content, language) for query optimization.
|
|
772
|
+
*/
|
|
773
|
+
export type DecoratedCodeSchema = z.ZodObject<{
|
|
774
|
+
content: z.ZodString;
|
|
775
|
+
language: z.ZodString;
|
|
776
|
+
}> & {
|
|
777
|
+
[ZodDecorator.IS_DB_INDEXED](): DecoratedCodeSchema;
|
|
778
|
+
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedCodeSchema;
|
|
779
|
+
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedCodeSchema;
|
|
780
|
+
addDecorators(decorators: DecoratorInput[]): DecoratedCodeSchema;
|
|
781
|
+
};
|
|
782
|
+
|
|
783
|
+
/**
|
|
784
|
+
* Creates a code schema for code snippets with language information.
|
|
785
|
+
* Named z_code to indicate it's a Zod helper function exported standalone.
|
|
786
|
+
*
|
|
787
|
+
* Code values are stored as: { content: string, language: string }
|
|
788
|
+
* - content: The actual code text
|
|
789
|
+
* - language: Programming language identifier for syntax highlighting
|
|
790
|
+
*
|
|
791
|
+
* @example
|
|
792
|
+
* ```typescript
|
|
793
|
+
* import { z_code } from '@wildo-ai/zod-decorators';
|
|
794
|
+
*
|
|
795
|
+
* // Simple usage
|
|
796
|
+
* z_code() // All languages, default 'plaintext'
|
|
797
|
+
*
|
|
798
|
+
* // With options (structural only)
|
|
799
|
+
* z_code({ allowedLanguages: ['javascript', 'typescript'] })
|
|
800
|
+
* z_code({ maxLength: 5000 })
|
|
801
|
+
*
|
|
802
|
+
* // UI props via .codeUI()
|
|
803
|
+
* z_code().codeUI({ defaultLanguage: 'typescript' })
|
|
804
|
+
* z_code().codeUI({ display: { showLineNumbers: false } })
|
|
805
|
+
* ```
|
|
806
|
+
*/
|
|
807
|
+
export function z_code(options?: CodeSchemaOptions): DecoratedCodeSchema {
|
|
808
|
+
return createCodeSchema(options);
|
|
809
|
+
}
|
|
810
|
+
```
|
|
811
|
+
|
|
812
|
+
## Big Decimal
|
|
813
|
+
|
|
814
|
+
## Import Origins
|
|
815
|
+
|
|
816
|
+
- `@wildo-ai/zod-decorators`
|
|
817
|
+
|
|
818
|
+
## Source Excerpts
|
|
819
|
+
|
|
820
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
821
|
+
|
|
822
|
+
```typescript
|
|
823
|
+
*
|
|
824
|
+
* Creates a bigdecimal schema with metadata for detection and form component rendering.
|
|
825
|
+
*
|
|
826
|
+
* @param options - Configuration options for bigdecimal field
|
|
827
|
+
* @returns A Zod string schema with metadata for bigdecimal detection
|
|
828
|
+
*
|
|
829
|
+
* @example
|
|
830
|
+
* ```typescript
|
|
831
|
+
* // Simple bigdecimal
|
|
832
|
+
* const price = z_bigdecimal();
|
|
833
|
+
* // Infers: string
|
|
834
|
+
*
|
|
835
|
+
* // With precision constraint
|
|
836
|
+
* const btcAmount = z_bigdecimal({ precision: 8 });
|
|
837
|
+
*
|
|
838
|
+
* // With min/max constraints
|
|
839
|
+
* const percentage = z_bigdecimal({
|
|
840
|
+
* min: '0',
|
|
841
|
+
* max: '100',
|
|
842
|
+
* precision: 2
|
|
843
|
+
* });
|
|
844
|
+
* ```
|
|
845
|
+
*/
|
|
846
|
+
export function createBigDecimalSchema(
|
|
847
|
+
options: BigDecimalSchemaOptions = {}
|
|
848
|
+
): DecoratedBigDecimalSchema {
|
|
849
|
+
const {
|
|
850
|
+
precision,
|
|
851
|
+
min,
|
|
852
|
+
max,
|
|
853
|
+
} = options;
|
|
854
|
+
|
|
855
|
+
// Create the base schema with validation
|
|
856
|
+
let bigDecimalSchema = z.string().refine(
|
|
857
|
+
(value) => {
|
|
858
|
+
if (!isValidBigDecimal(value)) return false;
|
|
859
|
+
|
|
860
|
+
try {
|
|
861
|
+
const bigValue = new Big(value);
|
|
862
|
+
|
|
863
|
+
// Check precision (decimal places)
|
|
864
|
+
if (precision !== undefined) {
|
|
865
|
+
const decimalPlaces = value.includes('.')
|
|
866
|
+
? value.split('.')[1]?.length ?? 0
|
|
867
|
+
: 0;
|
|
868
|
+
if (decimalPlaces > precision) return false;
|
|
869
|
+
}
|
|
870
|
+
|
|
871
|
+
// Check min
|
|
872
|
+
if (min !== undefined) {
|
|
873
|
+
const minValue = new Big(min);
|
|
874
|
+
if (bigValue.lt(minValue)) return false;
|
|
875
|
+
}
|
|
876
|
+
|
|
877
|
+
// Check max
|
|
878
|
+
if (max !== undefined) {
|
|
879
|
+
const maxValue = new Big(max);
|
|
880
|
+
if (bigValue.gt(maxValue)) return false;
|
|
881
|
+
}
|
|
882
|
+
|
|
883
|
+
return true;
|
|
884
|
+
} catch {
|
|
885
|
+
return false;
|
|
886
|
+
}
|
|
887
|
+
},
|
|
888
|
+
{
|
|
889
|
+
message: precision !== undefined
|
|
890
|
+
? `Invalid decimal number (max ${precision} decimal places${min !== undefined ? `, min: ${min}` : ''}${max !== undefined ? `, max: ${max}` : ''})`
|
|
891
|
+
: `Invalid decimal number${min !== undefined ? ` (min: ${min}` : ''}${max !== undefined ? `${min !== undefined ? ', ' : ' ('}max: ${max})` : min !== undefined ? ')' : ''}`
|
|
892
|
+
}
|
|
893
|
+
);
|
|
894
|
+
|
|
895
|
+
const bigDecimalMetadata: BigDecimalSchemaMetadata = {
|
|
896
|
+
isBigDecimal: true,
|
|
897
|
+
...(precision !== undefined && { precision }),
|
|
898
|
+
...(min !== undefined && { min }),
|
|
899
|
+
...(max !== undefined && { max }),
|
|
900
|
+
};
|
|
901
|
+
|
|
902
|
+
// Initialize or extend SCHEMA_METADATA with bigdecimal config
|
|
903
|
+
const existingMetadata: CustomFieldMetadata = (bigDecimalSchema as any)[SCHEMA_METADATA] || {};
|
|
904
|
+
(bigDecimalSchema as any)[SCHEMA_METADATA] = {
|
|
905
|
+
...existingMetadata,
|
|
906
|
+
bigDecimalConfig: bigDecimalMetadata,
|
|
907
|
+
};
|
|
908
|
+
|
|
909
|
+
// Add chainable decorator methods to the bigdecimal schema instance
|
|
910
|
+
// This allows: z_bigdecimal().bigDecimalUI({ display: { decimalPlaces: 4 } }).isHidden()
|
|
911
|
+
addChainableMethods(bigDecimalSchema);
|
|
912
|
+
|
|
913
|
+
return bigDecimalSchema as unknown as DecoratedBigDecimalSchema;
|
|
914
|
+
}
|
|
915
|
+
|
|
916
|
+
/**
|
|
917
|
+
* Return type for bigdecimal schemas - includes decorator methods.
|
|
918
|
+
* Note: IS_FOREIGN_KEY is not applicable to bigdecimal values.
|
|
919
|
+
* IS_DB_INDEXED indexes the string value directly for query optimization.
|
|
920
|
+
*/
|
|
921
|
+
export type DecoratedBigDecimalSchema = z.ZodString & {
|
|
922
|
+
[ZodDecorator.IS_DB_INDEXED](): DecoratedBigDecimalSchema;
|
|
923
|
+
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedBigDecimalSchema;
|
|
924
|
+
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedBigDecimalSchema;
|
|
925
|
+
[ZodDecorator.BIGDECIMAL_UI](params?: ZodDecorator_ParamsType[ZodDecorator.BIGDECIMAL_UI]): DecoratedBigDecimalSchema;
|
|
926
|
+
addDecorators(decorators: DecoratorInput[]): DecoratedBigDecimalSchema;
|
|
927
|
+
};
|
|
928
|
+
|
|
929
|
+
/**
|
|
930
|
+
* Creates a bigdecimal schema for precise decimal numbers stored as strings.
|
|
931
|
+
* Named z_bigdecimal to indicate it's a Zod helper function exported standalone.
|
|
932
|
+
*
|
|
933
|
+
* BigDecimal values are stored as strings to avoid floating-point precision issues.
|
|
934
|
+
* Use big.js for arithmetic operations on these values.
|
|
935
|
+
*
|
|
936
|
+
* @example
|
|
937
|
+
* ```typescript
|
|
938
|
+
* import { z_bigdecimal } from '@wildo-ai/zod-decorators';
|
|
939
|
+
*
|
|
940
|
+
* // Simple usage
|
|
941
|
+
* z_bigdecimal() // Any valid decimal number as string
|
|
942
|
+
*
|
|
943
|
+
* // With options
|
|
944
|
+
* z_bigdecimal({ precision: 2 }) // Max 2 decimal places
|
|
945
|
+
* z_bigdecimal({ min: '0', max: '100' }) // Range constraint
|
|
946
|
+
* z_bigdecimal({ precision: 8, min: '0' }) // Crypto amount
|
|
947
|
+
*
|
|
948
|
+
* // With decorators (chainable)
|
|
949
|
+
* z_bigdecimal().bigDecimalUI({ display: { decimalPlaces: 4 } })
|
|
950
|
+
* z_bigdecimal({ precision: 2 }).isHidden({ edit: true })
|
|
951
|
+
*
|
|
952
|
+
* // Usage example
|
|
953
|
+
* const price: BigDecimalValue = "19.99";
|
|
954
|
+
* const btcAmount: BigDecimalValue = "0.00000001";
|
|
955
|
+
*
|
|
956
|
+
* // Arithmetic with big.js
|
|
957
|
+
* import Big from 'big.js';
|
|
958
|
+
* const total = new Big(price).plus("10.01").toString(); // "30.00"
|
|
959
|
+
* ```
|
|
960
|
+
*/
|
|
961
|
+
export function z_bigdecimal(
|
|
962
|
+
options?: BigDecimalSchemaOptions
|
|
963
|
+
): DecoratedBigDecimalSchema {
|
|
964
|
+
return createBigDecimalSchema(options) as DecoratedBigDecimalSchema;
|
|
965
|
+
}
|
|
966
|
+
```
|
|
967
|
+
|
|
968
|
+
## File Schema
|
|
969
|
+
|
|
970
|
+
## Import Origins
|
|
971
|
+
|
|
972
|
+
- `@wildo-ai/zod-decorators`
|
|
973
|
+
|
|
974
|
+
## Source Excerpts
|
|
975
|
+
|
|
976
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
977
|
+
|
|
978
|
+
```typescript
|
|
979
|
+
*
|
|
980
|
+
* Metadata stored on file schemas for detection and configuration.
|
|
981
|
+
* File schemas represent file references with upload capabilities.
|
|
982
|
+
* Structure (single): { fileId: string, updatedAt: Date }
|
|
983
|
+
* Structure (multiple): { fileIds: string[], updatedAt: Date }
|
|
984
|
+
*/
|
|
985
|
+
export interface FileSchemaMetadata {
|
|
986
|
+
/** Marker for detecting file schemas */
|
|
987
|
+
isFile: true;
|
|
988
|
+
/** Whether existing files can be replaced/overridden (default: true) */
|
|
989
|
+
overridable?: boolean;
|
|
990
|
+
/** Allowed MIME types (if empty, all types are allowed) */
|
|
991
|
+
allowedMimeTypes?: string[];
|
|
992
|
+
/** Maximum file size in bytes */
|
|
993
|
+
maxSize?: number;
|
|
994
|
+
/** Minimum file size in bytes */
|
|
995
|
+
minSize?: number;
|
|
996
|
+
/** Whether multiple files can be uploaded (default: false) */
|
|
997
|
+
multiple?: boolean;
|
|
998
|
+
/** Maximum number of files (when multiple is true) */
|
|
999
|
+
maxFiles?: number;
|
|
1000
|
+
/** File nature classification */
|
|
1001
|
+
nature?: FileNature;
|
|
1002
|
+
/** Storage providers accepted for file uploads */
|
|
1003
|
+
storageAccepted?: FileStorageAccepted[];
|
|
1004
|
+
/** File path binding for structured storage organization */
|
|
1005
|
+
filePathBinding?: FilePathBinding;
|
|
1006
|
+
/**
|
|
1007
|
+
* Generation metadata for files materialized by framework operations instead
|
|
1008
|
+
* of user uploads. Generated file fields are readable but omitted from write
|
|
1009
|
+
* DTOs by downstream resource tooling.
|
|
1010
|
+
*/
|
|
1011
|
+
generation?: FileGenerationConfig;
|
|
1012
|
+
/** Image-specific constraints */
|
|
1013
|
+
imageConstraints?: FileNatureConstraints_Image;
|
|
1014
|
+
/** Video-specific constraints */
|
|
1015
|
+
videoConstraints?: FileNatureConstraints_Video;
|
|
1016
|
+
/** Audio-specific constraints */
|
|
1017
|
+
audioConstraints?: FileNatureConstraints_Audio;
|
|
1018
|
+
/** Document-specific constraints */
|
|
1019
|
+
documentConstraints?: FileNatureConstraints_Document;
|
|
1020
|
+
/**
|
|
1021
|
+
* Text-provider configuration for this file field — HOW text is obtained from the file's bytes
|
|
1022
|
+
* when something needs it (today: RAG chunking of a `ragSource` file field; the standalone
|
|
1023
|
+
* text-extraction operation reads it too).
|
|
1024
|
+
*
|
|
1025
|
+
* Deliberately file-side and separate from {@link RagSourceConfiguration}: extraction is a
|
|
1026
|
+
* property of the FILE FIELD (its bytes need decoding — PDF parsing, OCR), while chunking is the
|
|
1027
|
+
* shared RAG-source concern a plain string field carries identically. The former `extractText`
|
|
1028
|
+
* boolean is gone with `z_file({ rag })`: for a `ragSource` file field extraction is implied
|
|
1029
|
+
* (a corpus source whose text is never extracted would be a silent no-op), so the only honest
|
|
1030
|
+
* remaining knobs are the ones that change HOW extraction runs.
|
|
1031
|
+
*/
|
|
1032
|
+
textExtraction?: FileTextExtractionOptions;
|
|
1033
|
+
/**
|
|
1034
|
+
* Antivirus scan policy for this file field.
|
|
1035
|
+
* - 'required': always scan after upload, regardless of global config
|
|
1036
|
+
* - 'skip': never scan this field, even if global scanning is enabled
|
|
1037
|
+
* - undefined: inherit from `appConfig.files.scanning.enabled`
|
|
1038
|
+
*/
|
|
1039
|
+
scanPolicy?: 'required' | 'skip';
|
|
1040
|
+
/** Behavior when parent resource is deleted (default: CASCADE) */
|
|
1041
|
+
onParentDelete?: FileOnParentDelete;
|
|
1042
|
+
/**
|
|
1043
|
+
* Whether this file field supports public sharing via consumable tokens.
|
|
1044
|
+
* When true, the `POST /files/:fileId/share` endpoint will generate a
|
|
1045
|
+
* `FILE_PUBLIC_ACCESS` consumable token for this file.
|
|
1046
|
+
* @default false
|
|
1047
|
+
*/
|
|
1048
|
+
sharable?: boolean;
|
|
1049
|
+
/**
|
|
1050
|
+
* Default sharing configuration when `sharable` is true.
|
|
1051
|
+
* Controls token duration and max uses for shared links.
|
|
1052
|
+
*/
|
|
1053
|
+
sharableDefaults?: {
|
|
1054
|
+
/** Default expiration for share tokens */
|
|
1055
|
+
expiresIn?: ExpiresInDuration;
|
|
1056
|
+
/** Default max uses for share tokens (BOUNDED_REUSE) */
|
|
1057
|
+
maxUses?: number;
|
|
1058
|
+
/** Default consumption mode. Defaults to BOUNDED_REUSE if not specified. */
|
|
1059
|
+
consumptionMode?: 'SINGLE_USE' | 'BOUNDED_REUSE';
|
|
1060
|
+
};
|
|
1061
|
+
}
|
|
1062
|
+
```
|
|
1063
|
+
|
|
1064
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1065
|
+
|
|
1066
|
+
```typescript
|
|
1067
|
+
*
|
|
1068
|
+
* Creates a file schema with metadata for detection and form component rendering.
|
|
1069
|
+
*
|
|
1070
|
+
* @param options - Configuration options for file field
|
|
1071
|
+
* @returns A Zod object schema with metadata for file detection
|
|
1072
|
+
*/
|
|
1073
|
+
export function createFileSchema(
|
|
1074
|
+
options: FileSchemaOptions = {}
|
|
1075
|
+
): DecoratedFileSchema | DecoratedMultipleFileSchema {
|
|
1076
|
+
const {
|
|
1077
|
+
overridable = true,
|
|
1078
|
+
allowedMimeTypes,
|
|
1079
|
+
maxSize,
|
|
1080
|
+
minSize,
|
|
1081
|
+
multiple = false,
|
|
1082
|
+
maxFiles,
|
|
1083
|
+
nature,
|
|
1084
|
+
storageAccepted,
|
|
1085
|
+
filePathBinding,
|
|
1086
|
+
generation,
|
|
1087
|
+
imageConstraints,
|
|
1088
|
+
videoConstraints,
|
|
1089
|
+
audioConstraints,
|
|
1090
|
+
documentConstraints,
|
|
1091
|
+
ragSource,
|
|
1092
|
+
textExtraction,
|
|
1093
|
+
scanPolicy,
|
|
1094
|
+
onParentDelete = 'cascade',
|
|
1095
|
+
sharable,
|
|
1096
|
+
sharableDefaults,
|
|
1097
|
+
} = options;
|
|
1098
|
+
|
|
1099
|
+
// Warn at schema creation if non-WILDO_MANAGED storage providers are configured (not yet supported)
|
|
1100
|
+
// Uses deduplication to avoid console spam during tests or HMR
|
|
1101
|
+
if (storageAccepted && storageAccepted.some(s => !_supportedProviders.has(s))) {
|
|
1102
|
+
const unsupported = storageAccepted.filter(s => !_supportedProviders.has(s));
|
|
1103
|
+
const warnKey = unsupported.sort().join(',');
|
|
1104
|
+
if (!_warnedStorageProviders.has(warnKey)) {
|
|
1105
|
+
_warnedStorageProviders.add(warnKey);
|
|
1106
|
+
console.warn(
|
|
1107
|
+
`[z_file] storageAccepted contains unsupported providers: ${unsupported.join(', ')}. ` +
|
|
1108
|
+
`Only '${FileStorageAccepted.WILDO_MANAGED}' and '${FileStorageAccepted.LOCAL_DIRECTORY}' are currently implemented. ` +
|
|
1109
|
+
`External storage providers (OneDrive, Google Drive, Dropbox) will be ignored until their integrations are available.`
|
|
1110
|
+
);
|
|
1111
|
+
}
|
|
1112
|
+
}
|
|
1113
|
+
|
|
1114
|
+
if (filePathBinding) {
|
|
1115
|
+
if (filePathBinding.multipleFilePolicy && !multiple) {
|
|
1116
|
+
console.warn(
|
|
1117
|
+
'[z_file] filePathBinding.multipleFilePolicy is set but multiple is false — multipleFilePolicy will be ignored. ' +
|
|
1118
|
+
'Either set multiple: true or remove multipleFilePolicy.'
|
|
1119
|
+
);
|
|
1120
|
+
}
|
|
1121
|
+
if (filePathBinding.fileName && multiple) {
|
|
1122
|
+
console.warn(
|
|
1123
|
+
'[z_file] filePathBinding.fileName is set on a multiple file field — fileName is ignored for multiple uploads. ' +
|
|
1124
|
+
'Use filePathBinding.multipleFilePolicy.fileNameTemplate instead.'
|
|
1125
|
+
);
|
|
1126
|
+
}
|
|
1127
|
+
const implicitOrExplicitS3 = !storageAccepted || storageAccepted.includes(FileStorageAccepted.WILDO_MANAGED);
|
|
1128
|
+
const localIncluded = storageAccepted?.includes(FileStorageAccepted.LOCAL_DIRECTORY);
|
|
1129
|
+
if (filePathBinding.includeApplicationId === false && implicitOrExplicitS3 && !localIncluded) {
|
|
1130
|
+
console.warn(
|
|
1131
|
+
'[z_file] filePathBinding.includeApplicationId is false with WILDO_MANAGED storage. ' +
|
|
1132
|
+
'S3 keys will not be scoped by applicationId — ensure cross-app collision is acceptable.'
|
|
1133
|
+
);
|
|
1134
|
+
}
|
|
1135
|
+
}
|
|
1136
|
+
|
|
1137
|
+
// Resolve MIME type groups to actual MIME types
|
|
1138
|
+
const resolvedMimeTypes = resolveMimeTypes(allowedMimeTypes);
|
|
1139
|
+
assertGeneratedPdfFileOptions({ generation, multiple, resolvedMimeTypes, overridable, ragSource, scanPolicy });
|
|
1140
|
+
const effectiveMimeTypes = generation ? [...GENERATED_PDF_MIME_TYPES] : resolvedMimeTypes;
|
|
1141
|
+
|
|
1142
|
+
// Create the file object schema based on single/multiple
|
|
1143
|
+
const fileSchema = multiple
|
|
1144
|
+
? z.object({
|
|
1145
|
+
fileIds: z.array(z.string().min(1)),
|
|
1146
|
+
updatedAt: z.date(),
|
|
1147
|
+
})
|
|
1148
|
+
: z.object({
|
|
1149
|
+
fileId: z.string().min(1),
|
|
1150
|
+
updatedAt: z.date(),
|
|
1151
|
+
});
|
|
1152
|
+
|
|
1153
|
+
// No longer stored in metadata — consumers derive accept from allowedMimeTypes via buildAcceptAttribute()
|
|
1154
|
+
|
|
1155
|
+
// Store file metadata in SCHEMA_METADATA.fileConfig
|
|
1156
|
+
const fileMetadata: FileSchemaMetadata = {
|
|
1157
|
+
isFile: true,
|
|
1158
|
+
overridable,
|
|
1159
|
+
...(effectiveMimeTypes !== undefined && { allowedMimeTypes: effectiveMimeTypes }),
|
|
1160
|
+
...(maxSize !== undefined && { maxSize }),
|
|
1161
|
+
...(minSize !== undefined && { minSize }),
|
|
1162
|
+
multiple,
|
|
1163
|
+
...(maxFiles !== undefined && { maxFiles }),
|
|
1164
|
+
...(nature !== undefined && { nature }),
|
|
1165
|
+
...(storageAccepted !== undefined && { storageAccepted }),
|
|
1166
|
+
...(filePathBinding !== undefined && { filePathBinding }),
|
|
1167
|
+
...(generation !== undefined && { generation }),
|
|
1168
|
+
...(imageConstraints !== undefined && { imageConstraints }),
|
|
1169
|
+
...(videoConstraints !== undefined && { videoConstraints }),
|
|
1170
|
+
...(audioConstraints !== undefined && { audioConstraints }),
|
|
1171
|
+
...(documentConstraints !== undefined && { documentConstraints }),
|
|
1172
|
+
// Text-provider config only — the RAG declaration itself is NOT stored here (single source of
|
|
1173
|
+
// truth is the RAG_SOURCE decorator registered below; read it with `getRagSourceConfig`).
|
|
1174
|
+
...(textExtraction !== undefined && { textExtraction }),
|
|
1175
|
+
...(scanPolicy !== undefined && { scanPolicy }),
|
|
1176
|
+
onParentDelete,
|
|
1177
|
+
...(sharable !== undefined && { sharable }),
|
|
1178
|
+
...(sharableDefaults !== undefined && { sharableDefaults }),
|
|
1179
|
+
};
|
|
1180
|
+
|
|
1181
|
+
// Initialize or extend SCHEMA_METADATA with file config
|
|
1182
|
+
const existingMetadata: CustomFieldMetadata = (fileSchema as any)[SCHEMA_METADATA] || {};
|
|
1183
|
+
(fileSchema as any)[SCHEMA_METADATA] = {
|
|
1184
|
+
...existingMetadata,
|
|
1185
|
+
fileConfig: fileMetadata,
|
|
1186
|
+
};
|
|
1187
|
+
|
|
1188
|
+
// Add chainable decorator methods to the file schema instance
|
|
1189
|
+
addChainableMethods(fileSchema);
|
|
1190
|
+
|
|
1191
|
+
// Map the file-side `ragSource` option onto the SHARED RAG_SOURCE decorator — the same one
|
|
1192
|
+
// `z.string().ragSource()` registers — so `RagSourceFieldDetection` sees one uniform declaration
|
|
1193
|
+
// regardless of text provider. Registered through `addDecorators` (the escape-hatch door) because
|
|
1194
|
+
// the fluent `.ragSource()` is deliberately not installed on ZodObject; the shared chokepoint
|
|
1195
|
+
// still validates the config and enforces the refused companions identically.
|
|
1196
|
+
if (ragSource !== undefined) {
|
|
1197
|
+
addDecorators(fileSchema, [{ ref: ZodDecorator.RAG_SOURCE, params: ragSource }]);
|
|
1198
|
+
}
|
|
1199
|
+
|
|
1200
|
+
if (multiple) {
|
|
1201
|
+
return fileSchema as unknown as DecoratedMultipleFileSchema;
|
|
1202
|
+
}
|
|
1203
|
+
return fileSchema as unknown as DecoratedFileSchema;
|
|
1204
|
+
}
|
|
1205
|
+
|
|
1206
|
+
/**
|
|
1207
|
+
* File schemas declare NO decorator surface of their own.
|
|
1208
|
+
*
|
|
1209
|
+
* They used to, via a `FileSchemaDecoratorMethods<TSelf>` mixin that re-declared `isDBIndexed`,
|
|
1210
|
+
* `isHidden`, `isNotEditable` and `showWhen` with the return narrowed to the file schema — necessary
|
|
1211
|
+
* only because the `ZodObject` module augmentation did not carry them. It now does (2026-08-12), and
|
|
1212
|
+
* re-declaring them made both interfaces below fail TS2320: an interface may not extend two types
|
|
1213
|
+
* whose same-named member differs, and `TSelf` is not `DecoratedPrimitiveZodType<this>`.
|
|
1214
|
+
*
|
|
1215
|
+
* Removing the mixin costs nothing, because `DecoratedPrimitiveZodType<T>` is `T & { … }` — an
|
|
1216
|
+
* INTERSECTION. `z_file().isHidden()` still returns something assignable to `DecoratedFileSchema`,
|
|
1217
|
+
* and the full decorator surface is now available rather than the four this mixin listed.
|
|
1218
|
+
*/
|
|
1219
|
+
|
|
1220
|
+
/**
|
|
1221
|
+
* Return type for single file schemas - includes decorator methods.
|
|
1222
|
+
* IS_DB_INDEXED will index the fileId field for query optimization.
|
|
1223
|
+
*
|
|
1224
|
+
* Uses `interface` instead of `type` to allow self-referencing without circular alias errors.
|
|
1225
|
+
*/
|
|
1226
|
+
export interface DecoratedFileSchema extends z.ZodObject<{
|
|
1227
|
+
fileId: z.ZodString;
|
|
1228
|
+
updatedAt: z.ZodDate;
|
|
1229
|
+
}> {}
|
|
1230
|
+
|
|
1231
|
+
/**
|
|
1232
|
+
* Return type for multiple file schemas - includes decorator methods.
|
|
1233
|
+
* IS_DB_INDEXED will index the fileIds array for query optimization.
|
|
1234
|
+
*
|
|
1235
|
+
* Uses `interface` instead of `type` to allow self-referencing without circular alias errors.
|
|
1236
|
+
*/
|
|
1237
|
+
export interface DecoratedMultipleFileSchema extends z.ZodObject<{
|
|
1238
|
+
fileIds: z.ZodArray<z.ZodString>;
|
|
1239
|
+
updatedAt: z.ZodDate;
|
|
1240
|
+
}> {}
|
|
1241
|
+
|
|
1242
|
+
/**
|
|
1243
|
+
* Creates a file schema for file uploads with reference storage.
|
|
1244
|
+
* Named z_file to indicate it's a Zod helper function exported standalone.
|
|
1245
|
+
*
|
|
1246
|
+
* Single file values are stored as: { fileId: string, updatedAt: Date }
|
|
1247
|
+
* Multiple file values are stored as: { fileIds: string[], updatedAt: Date }
|
|
1248
|
+
*
|
|
1249
|
+
* @example
|
|
1250
|
+
* ```typescript
|
|
1251
|
+
* import { z_file } from '@wildo-ai/zod-decorators';
|
|
1252
|
+
*
|
|
1253
|
+
* // Simple usage - single file, any type
|
|
1254
|
+
* z_file()
|
|
1255
|
+
*
|
|
1256
|
+
* // With MIME type groups (shortcuts)
|
|
1257
|
+
* z_file({ allowedMimeTypes: 'Images' })
|
|
1258
|
+
* z_file({ allowedMimeTypes: 'PDF' })
|
|
1259
|
+
* z_file({ allowedMimeTypes: ['Images', 'Video'] })
|
|
1260
|
+
* z_file({ allowedMimeTypes: 'Documents' }) // PDF + Office
|
|
1261
|
+
*
|
|
1262
|
+
* // With specific MIME types
|
|
1263
|
+
* z_file({ allowedMimeTypes: ['image/png', 'image/jpeg'] })
|
|
1264
|
+
*
|
|
1265
|
+
* // With size constraints
|
|
1266
|
+
* z_file({ maxSize: 10 * 1024 * 1024 }) // 10MB max
|
|
1267
|
+
*
|
|
1268
|
+
* // Multiple files (uses fileIds instead of fileId)
|
|
1269
|
+
* z_file({ multiple: true, maxFiles: 5 })
|
|
1270
|
+
*
|
|
1271
|
+
* // Non-overridable (append-only)
|
|
1272
|
+
* z_file({ overridable: false })
|
|
1273
|
+
*
|
|
1274
|
+
* // RAG corpus source — registers the shared RAG_SOURCE decorator on the returned schema
|
|
1275
|
+
* // (chunking config), with the file-side text-provider knobs beside it (OCR opt-in).
|
|
1276
|
+
* z_file({ allowedMimeTypes: 'Documents', ragSource: {}, textExtraction: { ocr: true } })
|
|
1277
|
+
*
|
|
1278
|
+
* // With decorators
|
|
1279
|
+
* z_file().fileUI({ edit: { editMode: FileEditMode.DROPZONE } })
|
|
1280
|
+
* z_file().isHidden({ display: true })
|
|
1281
|
+
* ```
|
|
1282
|
+
*/
|
|
1283
|
+
export function z_file(options?: FileSchemaOptions): DecoratedFileSchema | DecoratedMultipleFileSchema {
|
|
1284
|
+
return createFileSchema(options);
|
|
1285
|
+
}
|
|
1286
|
+
```
|