@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
package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md
ADDED
|
@@ -0,0 +1,845 @@
|
|
|
1
|
+
# Field change — shared + operation UI contracts (source)
|
|
2
|
+
|
|
3
|
+
- After the shared schema edit, **operation-level** frontend config and **structural** param shapes must stay consistent.
|
|
4
|
+
|
|
5
|
+
## Import Origins
|
|
6
|
+
|
|
7
|
+
- `@wildo-ai/zod-decorators`
|
|
8
|
+
|
|
9
|
+
## Source Excerpts
|
|
10
|
+
|
|
11
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
*
|
|
15
|
+
* Structural FK params — backend/factory-relevant subset.
|
|
16
|
+
* Stays on `IS_FOREIGN_KEY`. UI-specific params (mode, linkable,
|
|
17
|
+
* displayPresetOverride) live on `ForeignKeyUIParams` via `.foreignKeyUI()`.
|
|
18
|
+
*/
|
|
19
|
+
export interface ForeignKeyStructuralParams {
|
|
20
|
+
/**
|
|
21
|
+
* Marks this FK as polymorphic over a set of scope branches.
|
|
22
|
+
*
|
|
23
|
+
* - On a resource that is itself polymorphically expanded, these drive the
|
|
24
|
+
* per-variant FK field RENAME (e.g. `billingAccountId` →
|
|
25
|
+
* `organizationBillingAccountId`).
|
|
26
|
+
* - On a FLAT resource that holds ONE shared FK to a polymorphic branch group
|
|
27
|
+
* (e.g. a referral's `referrerBillingAccountId` → user OR organization
|
|
28
|
+
* billing account), combine with {@link polymorphicDiscriminatorField}: each
|
|
29
|
+
* variant carries a `discriminatorValue`, and the concrete branch is
|
|
30
|
+
* resolved PER RECORD from the discriminator field. The single-valued
|
|
31
|
+
* registry FK→type map keeps a non-authoritative representative for these
|
|
32
|
+
* fields; the per-record resolver is authoritative for display/links.
|
|
33
|
+
*/
|
|
34
|
+
polymorphicVariants?: PolymorphicFkVariant[];
|
|
35
|
+
/**
|
|
36
|
+
* Sibling field name (on the SAME record) whose value selects which
|
|
37
|
+
* {@link polymorphicVariants} branch this record's FK points at. Required to
|
|
38
|
+
* turn `polymorphicVariants` into a per-record discriminated FK; pairs with
|
|
39
|
+
* each variant's `discriminatorValue`. The value is matched against the
|
|
40
|
+
* candidate branches' primary scope, so it typically holds a scope-type enum
|
|
41
|
+
* (e.g. `referrerScopeType`). Without it, `polymorphicVariants` is rename-only.
|
|
42
|
+
*/
|
|
43
|
+
polymorphicDiscriminatorField?: string;
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
48
|
+
|
|
49
|
+
```typescript
|
|
50
|
+
*
|
|
51
|
+
* Parameters for the isBackendOnly decorator.
|
|
52
|
+
* Marks fields that should only exist on the backend and be stripped from API responses.
|
|
53
|
+
*/
|
|
54
|
+
export interface BackendOnlyFieldParams {
|
|
55
|
+
/**
|
|
56
|
+
* If true, the field will be included in the response for CREATE operations only,
|
|
57
|
+
* then stripped from all subsequent READ operations.
|
|
58
|
+
* Useful for secrets, API keys, etc. that should only be returned once.
|
|
59
|
+
*
|
|
60
|
+
* This is also the framework's ONLY disclosure-audit trigger: a field that carries it emits one
|
|
61
|
+
* `FIELD_ACCESS` audit event at the moment it is first (and last) exposed. That pairing is not a
|
|
62
|
+
* coincidence — first exposure is the only point at which a backend-only field crosses the client
|
|
63
|
+
* boundary at all, so it is the only point at which "this value left the system" is a true claim.
|
|
64
|
+
*
|
|
65
|
+
* Scope limit worth knowing before relying on it: the audit event is raised from the TOP-LEVEL
|
|
66
|
+
* shape of the response DTO. A single `CREATE` is the reliably covered case; do not assume a
|
|
67
|
+
* bulk-create response gives you the same guarantee without checking.
|
|
68
|
+
*
|
|
69
|
+
* assurance-control: WILDO.SECRETS.DISCLOSURE_AUDIT — first disclosure of server-minted secret
|
|
70
|
+
* material is attributable.
|
|
71
|
+
*/
|
|
72
|
+
isReturnedAtCreation?: boolean;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Parameters for the isWriteOnlySecret decorator.
|
|
77
|
+
* Marks a user-provided secret that stays in CREATE/UPDATE request DTOs
|
|
78
|
+
* (client-writable) but is masked to a placeholder on every client-facing
|
|
79
|
+
* response DTO; the real value is retained for backend internal reads.
|
|
80
|
+
* Read-side masking and the write-back sentinel are enforced by the framework
|
|
81
|
+
* at the client-serialization boundary — no per-resource custom implementation
|
|
82
|
+
* needed.
|
|
83
|
+
*
|
|
84
|
+
* Pick the right secret posture by **who owns the value and which direction it
|
|
85
|
+
* flows** — the three are mutually exclusive on a field:
|
|
86
|
+
* - `.isWriteOnlySecret()` — the CLIENT supplies the secret and the server keeps
|
|
87
|
+
* it (e.g. a webhook signing key, an SSO client secret). Client-writable,
|
|
88
|
+
* masked on read, real value kept for backend use. Re-submitting the mask is
|
|
89
|
+
* a no-op (the stored value is preserved).
|
|
90
|
+
* - `.isEphemeral()` — the SERVER mints the secret and hands it to the client
|
|
91
|
+
* exactly once at creation (e.g. an API key shown in a one-time reveal). Not
|
|
92
|
+
* client-writable, not re-readable afterwards. A composite decorator (secret
|
|
93
|
+
* display + one-time reveal + not-editable).
|
|
94
|
+
* - `.isBackendOnly()` — the field never crosses the client boundary in EITHER
|
|
95
|
+
* direction. Do NOT use it for a client-provided secret: it strips the field
|
|
96
|
+
* from the write DTOs too, so the client could never set the value.
|
|
97
|
+
*/
|
|
98
|
+
export interface WriteOnlySecretFieldParams {
|
|
99
|
+
/**
|
|
100
|
+
* Intentionally empty.
|
|
101
|
+
*
|
|
102
|
+
* A write-only secret is masked on EVERY client-facing response, so there is no disclosure to
|
|
103
|
+
* audit — the real value never crosses the boundary. The parameter bag is kept so the decorator
|
|
104
|
+
* can gain options later without changing its call shape.
|
|
105
|
+
*/
|
|
106
|
+
readonly _reserved?: never;
|
|
107
|
+
}
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
111
|
+
|
|
112
|
+
```typescript
|
|
113
|
+
*
|
|
114
|
+
* Parameters for the isDiscriminator decorator.
|
|
115
|
+
* Marks a field as the discriminator for a discriminated union schema.
|
|
116
|
+
*/
|
|
117
|
+
export interface DiscriminatorFieldParams {
|
|
118
|
+
/**
|
|
119
|
+
* Values for which the base schema is used (no extended variant).
|
|
120
|
+
* If not provided, auto-detected from enum values not covered by variants.
|
|
121
|
+
*/
|
|
122
|
+
baseValues?: string[];
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
127
|
+
|
|
128
|
+
```typescript
|
|
129
|
+
*
|
|
130
|
+
* Scope for unique constraint enforcement.
|
|
131
|
+
* - 'global': Unique across the entire collection (default)
|
|
132
|
+
* - 'organization': Unique within an organization (compound index with organizationId)
|
|
133
|
+
* - 'user': Unique per user (compound index with createdByUserId)
|
|
134
|
+
*/
|
|
135
|
+
export const UniqueScope = {
|
|
136
|
+
GLOBAL: 'global',
|
|
137
|
+
ORGANIZATION: 'organization',
|
|
138
|
+
USER: 'user',
|
|
139
|
+
} as const;
|
|
140
|
+
export type UniqueScope = typeof UniqueScope[keyof typeof UniqueScope];
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* Parameters for the isUnique decorator.
|
|
144
|
+
* Marks a field as unique in the database with unique index.
|
|
145
|
+
* MongoDB will enforce uniqueness and throw E11000 duplicate key error on violations.
|
|
146
|
+
*/
|
|
147
|
+
export interface UniqueFieldParams {
|
|
148
|
+
/**
|
|
149
|
+
* Scope for uniqueness constraint.
|
|
150
|
+
* - 'global': Unique across the entire collection (default)
|
|
151
|
+
* - 'organization': Unique per organization (compound index with organizationId)
|
|
152
|
+
* - 'user': Unique per user (compound index with createdByUserId)
|
|
153
|
+
*/
|
|
154
|
+
scope?: UniqueScope;
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* Create a compound unique index with another field in the same schema.
|
|
158
|
+
* The referenced field name is resolved against the actual schema fields,
|
|
159
|
+
* handling polymorphic field renames automatically.
|
|
160
|
+
*
|
|
161
|
+
* @example poolKey: z.string().isUnique({ compoundWith: 'billingAccountId' })
|
|
162
|
+
* // Creates compound unique index: { billingAccountId: 1, poolKey: 1 }
|
|
163
|
+
* // For polymorphic variants, resolves e.g. to: { organizationBillingAccountId: 1, poolKey: 1 }
|
|
164
|
+
*/
|
|
165
|
+
compoundWith?: string;
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Whether to allow null values without triggering uniqueness.
|
|
169
|
+
* MongoDB unique indexes exclude null by default when sparse is true.
|
|
170
|
+
* @default true
|
|
171
|
+
*/
|
|
172
|
+
sparse?: boolean;
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Custom error message to show when uniqueness is violated.
|
|
176
|
+
* Supports placeholder {fieldName} which is replaced with the actual field name.
|
|
177
|
+
* @example "This {fieldName} is already taken"
|
|
178
|
+
*/
|
|
179
|
+
errorMessage?: string;
|
|
180
|
+
|
|
181
|
+
/**
|
|
182
|
+
* The custom message reference the API returns when THIS field's unique index is violated.
|
|
183
|
+
*
|
|
184
|
+
* Without it, every duplicate-key rejection collapses to one generic conflict code, so an
|
|
185
|
+
* integrator cannot tell "that slug is taken" from "that invoice number is taken" without
|
|
186
|
+
* parsing a message. Naming the reference here — next to the constraint that produces it —
|
|
187
|
+
* keeps one authority: the key and the error it raises cannot drift apart.
|
|
188
|
+
*
|
|
189
|
+
* Pass a member of the framework's error-reference vocabulary, never a bare literal.
|
|
190
|
+
*
|
|
191
|
+
* @example slug: z.string().isUnique({ conflictMessageReference: ErrorCustomMessageReference.ORGANIZATION_SLUG_EXISTS })
|
|
192
|
+
*/
|
|
193
|
+
conflictMessageReference?: string;
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
/**
|
|
197
|
+
* Parameters for the object-level `businessKeySet([...])` decorator.
|
|
198
|
+
*
|
|
199
|
+
* Declares a **composite business key**: the ordered list of `fields` is the stable identity of a
|
|
200
|
+
* row, used both by seeding upsert / upgrade / sync passes to find an existing row independently
|
|
201
|
+
* from its random `_id`, and by the storage adapter to materialize a compound UNIQUE index so the
|
|
202
|
+
* identity is enforced by the database rather than by a race-prone read-then-write.
|
|
203
|
+
*
|
|
204
|
+
* - `fields` must be non-empty and every entry must be a key declared on the
|
|
205
|
+
* underlying `ZodObject` shape (validated at decoration time).
|
|
206
|
+
* - This decorator is **mutually exclusive** with field-level `isBusinessKey()`
|
|
207
|
+
* on the same schema — pick one identity model.
|
|
208
|
+
*
|
|
209
|
+
* @example
|
|
210
|
+
* // "one membership per user per organization"
|
|
211
|
+
* z.object({ userId: z.string(), organizationId: z.string(), roles: z.array(z.string()) })
|
|
212
|
+
* .businessKeySet(['userId', 'organizationId'])
|
|
213
|
+
*/
|
|
214
|
+
export interface BusinessKeySetParams {
|
|
215
|
+
fields: string[];
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* Fields whose ABSENCE takes a row out of the uniqueness constraint entirely.
|
|
219
|
+
*
|
|
220
|
+
* By default a missing member counts as a real value, so two rows that both omit it COLLIDE.
|
|
221
|
+
* That is the correct default for an identity whose members are always meaningful — two rows
|
|
222
|
+
* that are "unscoped" in the same way really are the same row.
|
|
223
|
+
*
|
|
224
|
+
* It is wrong when a member is optional in the domain sense: "unit code, unique among siblings"
|
|
225
|
+
* must still allow any number of siblings that carry NO code. Listing that field here scopes the
|
|
226
|
+
* constraint to the rows that actually have it.
|
|
227
|
+
*
|
|
228
|
+
* Every entry must also appear in `fields`. List only the members whose absence means "this row
|
|
229
|
+
* has no key", never merely "this member happens to be optional" — a field left out of the list
|
|
230
|
+
* keeps the default null-collides behaviour, which is what most composite keys want.
|
|
231
|
+
*
|
|
232
|
+
* @example
|
|
233
|
+
* // many code-less siblings are fine; two siblings sharing a code are not
|
|
234
|
+
* .businessKeySet(['organizationId', 'parentUnitId', 'code'], { skipRowsMissing: ['code'] })
|
|
235
|
+
*/
|
|
236
|
+
skipRowsMissing?: string[];
|
|
237
|
+
|
|
238
|
+
/**
|
|
239
|
+
* The custom message reference the API returns when THIS key's unique index is violated.
|
|
240
|
+
*
|
|
241
|
+
* Without it, every duplicate-key rejection collapses to one generic conflict code, so an
|
|
242
|
+
* integrator cannot tell which identity was violated without parsing a message. Naming the
|
|
243
|
+
* reference here — next to the key that produces it — keeps one authority: the key and the error
|
|
244
|
+
* it raises cannot drift apart.
|
|
245
|
+
*
|
|
246
|
+
* Pass a member of the framework's error-reference vocabulary, never a bare literal.
|
|
247
|
+
*/
|
|
248
|
+
conflictMessageReference?: string;
|
|
249
|
+
}
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
253
|
+
|
|
254
|
+
```typescript
|
|
255
|
+
*
|
|
256
|
+
* Parameters for the ttl decorator.
|
|
257
|
+
* Marks a Date field for TTL (Time To Live) expiration in MongoDB.
|
|
258
|
+
* MongoDB will automatically delete documents when the TTL expires.
|
|
259
|
+
*
|
|
260
|
+
* @example
|
|
261
|
+
* createdAt: z.date().ttl({ expireAfterSeconds: 3600 }) // Expire 1 hour after createdAt
|
|
262
|
+
*
|
|
263
|
+
* @example
|
|
264
|
+
* expiresAt: z.date().ttl({ expireAfterSeconds: 0 }) // Expire at the exact date value
|
|
265
|
+
*/
|
|
266
|
+
export interface TtlFieldParams {
|
|
267
|
+
/**
|
|
268
|
+
* Number of seconds after the field's date value when the document should be deleted.
|
|
269
|
+
* - 0: Document expires at the exact date/time stored in the field
|
|
270
|
+
* - N > 0: Document expires N seconds after the date/time stored in the field
|
|
271
|
+
*
|
|
272
|
+
* @example
|
|
273
|
+
* // Expire documents 24 hours after createdAt
|
|
274
|
+
* createdAt: z.date().ttl({ expireAfterSeconds: 86400 })
|
|
275
|
+
*
|
|
276
|
+
* @example
|
|
277
|
+
* // Expire documents at the exact expiresAt date
|
|
278
|
+
* expiresAt: z.date().ttl({ expireAfterSeconds: 0 })
|
|
279
|
+
*/
|
|
280
|
+
expireAfterSeconds: number;
|
|
281
|
+
}
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
285
|
+
|
|
286
|
+
```typescript
|
|
287
|
+
*
|
|
288
|
+
* Parameters for the isSummaryField decorator.
|
|
289
|
+
* Controls how summary fields are handled, particularly for foreign key population.
|
|
290
|
+
*/
|
|
291
|
+
export interface SummaryFieldParams {
|
|
292
|
+
/**
|
|
293
|
+
* Whether to populate this foreign key field with the related resource's summary data.
|
|
294
|
+
* Only applicable when the field also has isForeignKey() decorator.
|
|
295
|
+
*
|
|
296
|
+
* When true:
|
|
297
|
+
* - The related resource will be fetched using the resourceIdentifier naming convention
|
|
298
|
+
* - Only the related resource's isSummaryField fields will be included
|
|
299
|
+
* - The populated data is optional (null if the related resource doesn't exist)
|
|
300
|
+
*
|
|
301
|
+
* @default false
|
|
302
|
+
*
|
|
303
|
+
* @example
|
|
304
|
+
* // Field definition:
|
|
305
|
+
* userId: z.string().isForeignKey().isSummaryField({ populate: true })
|
|
306
|
+
*
|
|
307
|
+
* // LIST/SEARCH response will include:
|
|
308
|
+
* {
|
|
309
|
+
* _id: "123",
|
|
310
|
+
* userId: "user-456",
|
|
311
|
+
* user: { _id: "user-456", email: "...", displayName: "..." } // populated summary
|
|
312
|
+
* }
|
|
313
|
+
*/
|
|
314
|
+
populate?: boolean;
|
|
315
|
+
}
|
|
316
|
+
```
|
|
317
|
+
## Import Origins
|
|
318
|
+
|
|
319
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
320
|
+
|
|
321
|
+
## Source Excerpts
|
|
322
|
+
|
|
323
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
324
|
+
|
|
325
|
+
```typescript
|
|
326
|
+
*
|
|
327
|
+
* How a resource collection renders its items (cards vs table). A FRONTEND
|
|
328
|
+
* presentation vocabulary — authored on a LIST/SEARCH operation's
|
|
329
|
+
* `collectionDisplayConfig` (below) in the resource UI behavior, NEVER on the
|
|
330
|
+
* shared resources-config operation: the backend has no notion of cards-vs-table.
|
|
331
|
+
* The string values are the persisted view-mode keys, so a stored user choice
|
|
332
|
+
* reads straight across.
|
|
333
|
+
*
|
|
334
|
+
* @example
|
|
335
|
+
* // resource UI behavior `views` entry:
|
|
336
|
+
* [Op.LIST, { collectionDisplayConfig: { displayMode: CollectionDisplayMode.TABLE, userSwitchableDisplayMode: true } }]
|
|
337
|
+
*/
|
|
338
|
+
export enum CollectionDisplayMode {
|
|
339
|
+
/** Stacked cards — one row per item via `ResourceListItemRenderer`. */
|
|
340
|
+
CARDS = 'cards',
|
|
341
|
+
/** Dense table — one column per summary field via the table body. */
|
|
342
|
+
TABLE = 'table',
|
|
343
|
+
}
|
|
344
|
+
|
|
345
|
+
/**
|
|
346
|
+
* How CARDS-mode items are arranged. Orthogonal to {@link CollectionDisplayMode}
|
|
347
|
+
* (this only shapes the CARDS body; TABLE ignores it). LIST and GRID are kept as
|
|
348
|
+
* DISTINCT layouts, not a `columns: 1` collapse — a list is bordered rows sharing
|
|
349
|
+
* one container (`divide-y`), a grid is separated card cells in N responsive
|
|
350
|
+
* columns.
|
|
351
|
+
*/
|
|
352
|
+
export enum CardLayoutStyle {
|
|
353
|
+
/** Bordered rows in a single shared container (the classic stacked list). */
|
|
354
|
+
LIST = 'list',
|
|
355
|
+
/** Separated card cells laid out in an N-column responsive grid. */
|
|
356
|
+
GRID = 'grid',
|
|
357
|
+
}
|
|
358
|
+
```
|
|
359
|
+
|
|
360
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
361
|
+
|
|
362
|
+
```typescript
|
|
363
|
+
*
|
|
364
|
+
* Frontend configuration for a single resource operation.
|
|
365
|
+
*
|
|
366
|
+
* Controls how the operation is surfaced in the frontend:
|
|
367
|
+
* - `surface` — the operation's frontend surface: `ADDRESSABLE` (routable page),
|
|
368
|
+
* `EMBEDDED` (non-addressable view rendered within a host: overlay, composite, or
|
|
369
|
+
* nested), or `API_ONLY` (headless — no interface, callable as an API). See
|
|
370
|
+
* `ResourceOperationFrontendSurface`.
|
|
371
|
+
* - `customView` — direct UIBehavior-owned React component override for authored custom operation views.
|
|
372
|
+
* Use the exported operation-family component types (`ResourceReadCustomViewComponent`,
|
|
373
|
+
* `ResourceListCustomViewComponent`, etc.) plus the matching
|
|
374
|
+
* `useReadOperationSurface()` / `useListOperationSurface()` helpers when you
|
|
375
|
+
* want a strongly truthful custom host for a specific layout family.
|
|
376
|
+
* - `displayPresetOverride` — layout preset override for the operation's UI
|
|
377
|
+
* - `navigationOverrides` — per-operation navigation transition overrides
|
|
378
|
+
* - `displayPriority` — visual ordering in ActionBar/operation lists (lower = higher priority)
|
|
379
|
+
* - `iconOverride` — per-operation icon ref (overrides resource-level icon in navigation items)
|
|
380
|
+
* - `collectionDisplayConfig` — for LIST/SEARCH collection operations: the default
|
|
381
|
+
* cards-vs-table body (`displayMode`) and whether the user may toggle it
|
|
382
|
+
* (`userSwitchableDisplayMode`, persisted per resource type); the CARDS
|
|
383
|
+
* arrangement (`cardLayout` — LIST vs N-column GRID); where each card's action
|
|
384
|
+
* buttons sit (`cardActionPlacement` — 2-axis anchor + orientation); and
|
|
385
|
+
* whether items are selectable for bulk actions (`selectable`). Pure frontend
|
|
386
|
+
* presentation; the backend never reads it.
|
|
387
|
+
*
|
|
388
|
+
* **Resource-owned inserted views are NOT configured here.** Composite, chart,
|
|
389
|
+
* and execution views declared on the resource UI behavior surface themselves
|
|
390
|
+
* into their targeted operation host directly, via their own canonical fields:
|
|
391
|
+
* `compositeViews[*].operationLike` / `chartViews[*].operationLike` (single)
|
|
392
|
+
* and `executionViews[*].surfaceInOperations` (list). The layout consumer
|
|
393
|
+
* (`ResourceLayout_InsertedViews`) reads those declarations and filters them
|
|
394
|
+
* by the current operation at render time — there is no operation-level
|
|
395
|
+
* view-ref list to author or compile.
|
|
396
|
+
*
|
|
397
|
+
* **Historical note (search hit):** earlier versions of this schema exposed an
|
|
398
|
+
* `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:
|
|
399
|
+
* string[]`) operation-level field that authored which resource-owned views
|
|
400
|
+
* surfaced in this operation. That field was removed in the
|
|
401
|
+
* `resource-owned-view-surfacing-contract.md` workstream because it duplicated
|
|
402
|
+
* the per-view declaration sites (`compositeViews`, `chartViews`,
|
|
403
|
+
* `executionViews`) and could silently disagree with them. If you are looking
|
|
404
|
+
* for `additionalViews` because a doc, comment, prompt, or downstream code
|
|
405
|
+
* still references it, the answer is: declare the surface on the view itself
|
|
406
|
+
* (use `operationLike` for composite/chart, `surfaceInOperations` for
|
|
407
|
+
* execution), do not re-introduce an operation-level seam.
|
|
408
|
+
*/
|
|
409
|
+
/**
|
|
410
|
+
* How an operation's ACTION (its action-bar button) is surfaced in this application.
|
|
411
|
+
*
|
|
412
|
+
* A per-app, **display-only** axis — backend authorization is unaffected, roles
|
|
413
|
+
* remain the only security authority, so this never makes an operation reachable
|
|
414
|
+
* that wasn't already; it only governs the button.
|
|
415
|
+
*/
|
|
416
|
+
export enum ActionVisibility {
|
|
417
|
+
/** Always shown; rendered DISABLED when its `enabledCondition` is unmet. The default. */
|
|
418
|
+
ALWAYS = 'always',
|
|
419
|
+
/**
|
|
420
|
+
* Never shown — this app declares the operation's action off for this surface.
|
|
421
|
+
*
|
|
422
|
+
* Invariant: do NOT pair with a visible (addressable) view for the same operation.
|
|
423
|
+
* The action is the entry point to the view, so a visible view whose action is
|
|
424
|
+
* hidden is contradictory — there is no way to reach it. Hiding the action removes
|
|
425
|
+
* the operation, and the path to any view it has, from this app's UI.
|
|
426
|
+
*/
|
|
427
|
+
HIDDEN = 'hidden',
|
|
428
|
+
/**
|
|
429
|
+
* Shown ONLY when its `enabledCondition` is met; HIDDEN (not disabled) otherwise.
|
|
430
|
+
*
|
|
431
|
+
* For state-conditional operations whose disabled state is just noise — e.g.
|
|
432
|
+
* organization `ACTIVATE` appears on a suspended org but vanishes on an active one,
|
|
433
|
+
* rather than sitting there greyed out.
|
|
434
|
+
*/
|
|
435
|
+
WHEN_AVAILABLE = 'when_available',
|
|
436
|
+
}
|
|
437
|
+
|
|
438
|
+
/**
|
|
439
|
+
* Where an operation's ACTION sits in the action bar for this application.
|
|
440
|
+
*
|
|
441
|
+
* A per-app, **display-only** layout axis, orthogonal to authorization. When
|
|
442
|
+
* omitted, placement is DERIVED from the operation's `riskLevel`: HIGH/CRITICAL
|
|
443
|
+
* operations default to `DANGER_ZONE`, everything else to `PRIMARY`. Set it
|
|
444
|
+
* explicitly to override that default — e.g. tuck a non-risky-but-rare action
|
|
445
|
+
* into the danger zone, or keep a CRITICAL action inline in a dedicated admin
|
|
446
|
+
* tool. The same axis drives the bulk action bar, since both are built from the
|
|
447
|
+
* same operation pipeline.
|
|
448
|
+
*/
|
|
449
|
+
export enum ActionPlacement {
|
|
450
|
+
/** Inline in the main action group. The default for low/medium-risk operations. */
|
|
451
|
+
PRIMARY = 'primary',
|
|
452
|
+
/**
|
|
453
|
+
* Segregated into a trailing "danger zone" group, fenced off by a separator,
|
|
454
|
+
* after every PRIMARY action. The default for HIGH/CRITICAL-risk operations
|
|
455
|
+
* (destructive deletes, lifecycle suspends).
|
|
456
|
+
*/
|
|
457
|
+
DANGER_ZONE = 'danger_zone',
|
|
458
|
+
}
|
|
459
|
+
|
|
460
|
+
/**
|
|
461
|
+
* HOW an operation's action collects its input and shows its result — the chrome the user meets
|
|
462
|
+
* when they click the button.
|
|
463
|
+
*
|
|
464
|
+
* ## Why this axis exists
|
|
465
|
+
*
|
|
466
|
+
* Until this axis, one rule decided the answer for every custom operation:
|
|
467
|
+
* *has a `requestDto` ⇒ navigate*. So an action asking for a single reason string got the same
|
|
468
|
+
* full-page treatment as a multi-step wizard, and the only way out was to author
|
|
469
|
+
* `navigationOverrides` — per operation, in terms of a zone, a transition verb and an appearance.
|
|
470
|
+
* Three concepts to answer one question.
|
|
471
|
+
*
|
|
472
|
+
* This is that one question. It is a **display-only** axis: backend authorization is untouched and
|
|
473
|
+
* `roles` remain the only security authority, exactly like its siblings {@link ActionVisibility},
|
|
474
|
+
* {@link ActionPlacement} and {@link ResourceOperationActionScope}.
|
|
475
|
+
*
|
|
476
|
+
* ## It is an ALIAS, not a parallel mechanism
|
|
477
|
+
*
|
|
478
|
+
* `MODAL` and `PAGE` do not render anything themselves — they resolve to the navigation transitions
|
|
479
|
+
* that already exist (`OVERLAY`, and the ordinary chain), so there is one runtime mechanism and one
|
|
480
|
+
* set of zone/appearance/URL semantics. `DIRECT`, `POPOVER` and `INLINE` never enter navigation at
|
|
481
|
+
* all, because none of them is a destination: nothing is pushed, no zone changes, and there is
|
|
482
|
+
* nothing for a back button to pop. `INLINE` is hosted by the collection the element belongs to —
|
|
483
|
+
* see `InPlaceOperationContext` for why that is not the navigation layer's job.
|
|
484
|
+
*
|
|
485
|
+
* Consequently an explicit `navigationOverrides` entry still WINS over a presentation authored here
|
|
486
|
+
* (it is the more specific instrument, and it is checked first in the resolution chain). Author this
|
|
487
|
+
* axis to say what KIND of chrome the action wants; author `navigationOverrides` when you need to
|
|
488
|
+
* name the zone, the appearance or the viewport yourself.
|
|
489
|
+
*
|
|
490
|
+
* ## When omitted
|
|
491
|
+
*
|
|
492
|
+
* It is DERIVED from the operation — see `resolveResourceOperationActionPresentation()`. An
|
|
493
|
+
* operation that asks for nothing executes directly; a small field set opens a modal; input the
|
|
494
|
+
* framework cannot fit in an overlay (files, nested writes, a large field set) keeps the page it
|
|
495
|
+
* has always had. An operation whose `surface` is `ADDRESSABLE` always keeps its page: the author
|
|
496
|
+
* has already said it is a deep-linkable destination.
|
|
497
|
+
*/
|
|
498
|
+
export enum ResourceOperationActionPresentation {
|
|
499
|
+
/**
|
|
500
|
+
* Execute on click, with no form at all — the confirmation dialog for a risky operation is the
|
|
501
|
+
* only thing between the click and the request.
|
|
502
|
+
*
|
|
503
|
+
* Only meaningful for an operation that needs no caller input. Declaring it on an operation that
|
|
504
|
+
* DOES have required request fields would send an empty body, so the resolver refuses to derive it
|
|
505
|
+
* there and an author who declares it anyway gets the operation's fields dropped — check
|
|
506
|
+
* `requestDto` before reaching for this.
|
|
507
|
+
*/
|
|
508
|
+
DIRECT = 'direct',
|
|
509
|
+
/**
|
|
510
|
+
* A small form anchored to the button that opened it, dismissed by clicking away.
|
|
511
|
+
*
|
|
512
|
+
* The single-input idiom ("assign to…", "snooze until…"). Transient by construction: no URL, no
|
|
513
|
+
* history entry, nothing to deep-link. Use it when the surrounding context is the point — the user
|
|
514
|
+
* is reading the row they are acting on and must not lose sight of it.
|
|
515
|
+
*/
|
|
516
|
+
POPOVER = 'popover',
|
|
517
|
+
/**
|
|
518
|
+
* The element being acted on transforms in place to collect the input, leaving its neighbours
|
|
519
|
+
* visible — the row becomes the form rather than being covered by one.
|
|
520
|
+
*
|
|
521
|
+
* Use it when the surrounding rows are the point: the user is comparing, and an overlay would hide
|
|
522
|
+
* the very thing that made them act on this row.
|
|
523
|
+
*
|
|
524
|
+
* **Transient, like {@link POPOVER}, and for the same reason.** Nothing is pushed, no URL changes,
|
|
525
|
+
* and a reload returns the list to rest. An inline row-edit is a momentary state of a listing, not
|
|
526
|
+
* a place — which is also why no admin framework deep-links one, and why anything that SHOULD be
|
|
527
|
+
* linkable, reloadable or reachable by a back button wants {@link PAGE}.
|
|
528
|
+
*
|
|
529
|
+
* **It requires a collection.** The host is provided by the list the element belongs to
|
|
530
|
+
* (`InPlaceOperationProvider`); the same action rendered on a detail page, in a danger zone or in a
|
|
531
|
+
* picker has no row to transform and degrades to an overlay rather than becoming a dead button.
|
|
532
|
+
*
|
|
533
|
+
* Note it does NOT resolve to `NavigationTransition.INPLACE`. Element-level hosting uses none of
|
|
534
|
+
* what the navigation layer offers — no zone, no stack entry, no appearance — and routing it there
|
|
535
|
+
* is exactly why that transition has never done what its own docstring promises. See
|
|
536
|
+
* `InPlaceOperationContext`.
|
|
537
|
+
*/
|
|
538
|
+
INLINE = 'inline',
|
|
539
|
+
/**
|
|
540
|
+
* An overlay above the layout — the workhorse for "a handful of fields", and the default the
|
|
541
|
+
* derivation reaches for.
|
|
542
|
+
*
|
|
543
|
+
* Resolves to {@link NavigationTransition.OVERLAY}. The concrete appearance (dialog / sheet /
|
|
544
|
+
* drawer / panel) stays the app's decision, resolved from its navigation layout exactly as any
|
|
545
|
+
* other overlay: this axis says "an overlay", not "a dialog specifically". Author
|
|
546
|
+
* `navigationOverrides` when you need to name one.
|
|
547
|
+
*/
|
|
548
|
+
MODAL = 'modal',
|
|
549
|
+
/**
|
|
550
|
+
* A routable page, resolved through the ordinary navigation chain (zone transitions, viewport
|
|
551
|
+
* overrides, the framework `PUSH` fallback) — i.e. exactly the behaviour every parameterised
|
|
552
|
+
* action had before this axis existed.
|
|
553
|
+
*
|
|
554
|
+
* The right answer for complex or multi-step input, and for anything a user should be able to
|
|
555
|
+
* link to, reload, or reach with a back button.
|
|
556
|
+
*/
|
|
557
|
+
PAGE = 'page',
|
|
558
|
+
}
|
|
559
|
+
|
|
560
|
+
/**
|
|
561
|
+
* Does an operation's action target a SINGLE resource instance, or the WHOLE
|
|
562
|
+
* collection in the current scope?
|
|
563
|
+
*
|
|
564
|
+
* A per-app **surfacing** axis, orthogonal to authorization. Most actions are
|
|
565
|
+
* `ITEM` (edit / delete / retry one row) and render in the per-row and detail
|
|
566
|
+
* action bars. A `COLLECTION` action operates on every row in scope at once
|
|
567
|
+
* (e.g. "retry all failed deliveries", "purge the queue"): it renders ONCE in
|
|
568
|
+
* the list's collection-action surface (the toolbar), never per row, and
|
|
569
|
+
* confirms + executes in place rather than opening a per-row form.
|
|
570
|
+
*
|
|
571
|
+
* For a `COLLECTION` action to have a callable route, its operation must borrow
|
|
572
|
+
* a COLLECTION verb via `resourceOperationLike` (`UPDATE_MANY` / `DELETE_MANY` /
|
|
573
|
+
* `CREATE_MANY`) — an entity verb (`UPDATE` / `DELETE`) generates a route with a
|
|
574
|
+
* `:id` segment the scope-level surface has no single row to fill.
|
|
575
|
+
*/
|
|
576
|
+
export enum ResourceOperationActionScope {
|
|
577
|
+
/** Targets one resource instance — the per-row / detail action bars. The default when omitted. */
|
|
578
|
+
ITEM = 'item',
|
|
579
|
+
/** Targets the whole collection in scope — rendered once in the list's collection-action surface. */
|
|
580
|
+
COLLECTION = 'collection',
|
|
581
|
+
}
|
|
582
|
+
|
|
583
|
+
/**
|
|
584
|
+
* What happens to an operation's action when its `enabledCondition` is currently
|
|
585
|
+
* unmet — the per-view default for actions that don't declare an explicit
|
|
586
|
+
* `actionVisibility`. An explicit per-operation `actionVisibility` always wins
|
|
587
|
+
* over this policy; feature-gated unavailability keeps its own
|
|
588
|
+
* `FeatureUnavailabilityBehavior` (upgrade/prompt) and is never hidden by this.
|
|
589
|
+
*
|
|
590
|
+
* - `HIDE` — drop the action entirely while unavailable (as if it declared
|
|
591
|
+
* `ActionVisibility.WHEN_AVAILABLE`). The framework default for BOTH views: a
|
|
592
|
+
* greyed, non-actionable button is noise wherever it sits, and hiding it also
|
|
593
|
+
* collapses mutually-exclusive state pairs (e.g. "Set as recurring" / "Set as
|
|
594
|
+
* one time") down to the one that currently applies.
|
|
595
|
+
* - `SHOW_DISABLED` — render the action greyed/disabled (the classic behavior).
|
|
596
|
+
* Opt in per view when the disabled action + its reason tooltip is genuinely
|
|
597
|
+
* informative and you want it always present.
|
|
598
|
+
*/
|
|
599
|
+
export enum DisabledActionHandling {
|
|
600
|
+
SHOW_DISABLED = 'show_disabled',
|
|
601
|
+
HIDE = 'hide',
|
|
602
|
+
}
|
|
603
|
+
|
|
604
|
+
/**
|
|
605
|
+
* Per-view action-surfacing (disclosure) policy — how many actions stay visible
|
|
606
|
+
* and how unavailable ones are treated, for ONE {@link ResourceOperationDisplayMode}.
|
|
607
|
+
*/
|
|
608
|
+
export interface ResourceActionDisclosureConfig {
|
|
609
|
+
/**
|
|
610
|
+
* How many PRIMARY actions render as direct buttons before the remainder
|
|
611
|
+
* collapse into the `…` overflow menu. Omitted inherits the framework default
|
|
612
|
+
* for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY, unlimited
|
|
613
|
+
* for DETAIL. `0` pushes every action into the menu.
|
|
614
|
+
*/
|
|
615
|
+
maxPrimaryActions?: number;
|
|
616
|
+
/**
|
|
617
|
+
* Default handling for actions disabled by an unmet `enabledCondition` — see
|
|
618
|
+
* {@link DisabledActionHandling}. Omitted inherits the framework default,
|
|
619
|
+
* which is `HIDE` for both views (set `SHOW_DISABLED` here to keep disabled
|
|
620
|
+
* actions greyed-but-present for a view).
|
|
621
|
+
*/
|
|
622
|
+
disabledActionHandling?: DisabledActionHandling;
|
|
623
|
+
}
|
|
624
|
+
|
|
625
|
+
/** Fully-resolved disclosure policy (no optional fields) for one view. */
|
|
626
|
+
export interface ResolvedActionDisclosure {
|
|
627
|
+
/** `undefined` = unlimited (no overflow cap). */
|
|
628
|
+
maxPrimaryActions: number | undefined;
|
|
629
|
+
disabledActionHandling: DisabledActionHandling;
|
|
630
|
+
}
|
|
631
|
+
|
|
632
|
+
/**
|
|
633
|
+
* Framework defaults per view. Both views HIDE actions disabled by an unmet
|
|
634
|
+
* `enabledCondition` — an inapplicable, greyed button is noise everywhere, so
|
|
635
|
+
* the bar only ever shows actions the user can actually take right now. They
|
|
636
|
+
* differ on the overflow cap: SUMMARY (dense list/table rows) shows at most 3
|
|
637
|
+
* direct actions before the `…` menu; DETAIL (roomy read view) is uncapped.
|
|
638
|
+
* A resource that WANTS the informative greyed-with-reason affordance opts into
|
|
639
|
+
* `SHOW_DISABLED` per view via `layout.actionDisclosure`.
|
|
640
|
+
*/
|
|
641
|
+
export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {
|
|
642
|
+
[ResourceOperationDisplayMode.SUMMARY]: {
|
|
643
|
+
maxPrimaryActions: 3,
|
|
644
|
+
disabledActionHandling: DisabledActionHandling.HIDE,
|
|
645
|
+
},
|
|
646
|
+
[ResourceOperationDisplayMode.DETAIL]: {
|
|
647
|
+
maxPrimaryActions: undefined,
|
|
648
|
+
disabledActionHandling: DisabledActionHandling.HIDE,
|
|
649
|
+
},
|
|
650
|
+
};
|
|
651
|
+
|
|
652
|
+
/**
|
|
653
|
+
* Resolve the effective disclosure policy for a view: per-resource override
|
|
654
|
+
* (`layout.actionDisclosure[view]`) layered over the framework default. Used by
|
|
655
|
+
* both the action-building hook (disabled handling) and the operations-items
|
|
656
|
+
* host (overflow cap).
|
|
657
|
+
*/
|
|
658
|
+
export function resolveActionDisclosure(
|
|
659
|
+
displayMode: ResourceOperationDisplayMode,
|
|
660
|
+
disclosure: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>> | undefined,
|
|
661
|
+
): ResolvedActionDisclosure {
|
|
662
|
+
const base = DEFAULT_ACTION_DISCLOSURE[displayMode] ?? DEFAULT_ACTION_DISCLOSURE[ResourceOperationDisplayMode.DETAIL];
|
|
663
|
+
const override = disclosure?.[displayMode];
|
|
664
|
+
return {
|
|
665
|
+
maxPrimaryActions: override?.maxPrimaryActions ?? base.maxPrimaryActions,
|
|
666
|
+
disabledActionHandling: override?.disabledActionHandling ?? base.disabledActionHandling,
|
|
667
|
+
};
|
|
668
|
+
}
|
|
669
|
+
|
|
670
|
+
/**
|
|
671
|
+
* 2-axis card action-button placement. Single source of truth for the config
|
|
672
|
+
* field AND the `card-action-placement.utils` resolver (which imports the
|
|
673
|
+
* `CardActionPlacement` type inferred from this schema, so the two can never
|
|
674
|
+
* drift). `MIDDLE × MIDDLE` is rejected — dead-center overlaps the card content.
|
|
675
|
+
*/
|
|
676
|
+
export const CardActionPlacementSchema = z.object({
|
|
677
|
+
vertical: z.enum(VerticalPlacement),
|
|
678
|
+
horizontal: z.enum(HorizontalPlacement),
|
|
679
|
+
orientation: z.enum(DisplayDirection).optional(),
|
|
680
|
+
}).refine(
|
|
681
|
+
(p) => !(p.vertical === VerticalPlacement.MIDDLE && p.horizontal === HorizontalPlacement.MIDDLE),
|
|
682
|
+
{ message: 'cardActionPlacement cannot be MIDDLE × MIDDLE (dead-center overlaps card content); choose an edge or corner.' },
|
|
683
|
+
);
|
|
684
|
+
|
|
685
|
+
/** Authored 2-axis card action placement — inferred from {@link CardActionPlacementSchema}. */
|
|
686
|
+
export type CardActionPlacement = z.infer<typeof CardActionPlacementSchema>;
|
|
687
|
+
|
|
688
|
+
export const ResourceOperationFrontendConfigSchema = z.object({
|
|
689
|
+
/**
|
|
690
|
+
* The operation's frontend **surface** — see {@link ResourceOperationFrontendSurface}.
|
|
691
|
+
* `ADDRESSABLE` (routable page) and `EMBEDDED` (non-addressable view rendered within
|
|
692
|
+
* a host — overlay/composite/nested) both have a view + action button; `API_ONLY` is
|
|
693
|
+
* headless (no view, no button). The view fields below (`actionVisibility`,
|
|
694
|
+
* `customView`, `iconOverride`, layout, …) apply only to `ADDRESSABLE`/`EMBEDDED`; a
|
|
695
|
+
* build-time check rejects them on `API_ONLY`.
|
|
696
|
+
* Replaces the former `isAddressable` boolean — read via `isOperationAddressable()`.
|
|
697
|
+
*/
|
|
698
|
+
surface: z.enum(ResourceOperationFrontendSurface),
|
|
699
|
+
/**
|
|
700
|
+
* How this operation's action is surfaced — see {@link ActionVisibility}. Omitted
|
|
701
|
+
* (the common case) behaves as `ALWAYS`.
|
|
702
|
+
*/
|
|
703
|
+
actionVisibility: z.enum(ActionVisibility).optional(),
|
|
704
|
+
/**
|
|
705
|
+
* Where this operation's action sits in the bar — see {@link ActionPlacement}.
|
|
706
|
+
* Omitted derives from `riskLevel` (HIGH/CRITICAL → danger zone, else primary).
|
|
707
|
+
*/
|
|
708
|
+
actionPlacement: z.enum(ActionPlacement).optional(),
|
|
709
|
+
/**
|
|
710
|
+
* Visual button variant (colour) for this operation's action — a
|
|
711
|
+
* `ButtonVariants_Variant` (e.g. `DESTRUCTIVE`, `GHOST`, `ACCENT`). Omitted
|
|
712
|
+
* derives from `riskLevel` (HIGH/CRITICAL → destructive/red, else ghost). Typed
|
|
713
|
+
* on the interface below; the Zod field stays `z.any()` because the enum lives
|
|
714
|
+
* in a component module a schema must not pull at runtime (same as `iconOverride`).
|
|
715
|
+
*/
|
|
716
|
+
actionVariant: z.any().optional(),
|
|
717
|
+
/**
|
|
718
|
+
* Does this action target one row or the whole collection — see
|
|
719
|
+
* {@link ResourceOperationActionScope}. Omitted behaves as `ITEM`. A
|
|
720
|
+
* `COLLECTION` action renders once in the list's collection-action surface
|
|
721
|
+
* (never per row) and confirms + executes in place; pair it with a COLLECTION
|
|
722
|
+
* `resourceOperationLike` (`*_MANY`) so its generated route carries no `:id`.
|
|
723
|
+
*/
|
|
724
|
+
actionScope: z.enum(ResourceOperationActionScope).optional(),
|
|
725
|
+
/**
|
|
726
|
+
* For an `ITEM` action whose backend addresses the target row by a field in
|
|
727
|
+
* the REQUEST BODY (not the URL id), the request-DTO field name to fill with
|
|
728
|
+
* the clicked row's id. When set, clicking the action executes IN PLACE —
|
|
729
|
+
* sending `{ [rowTargetRequestField]: <rowId> }` — instead of opening a form:
|
|
730
|
+
* e.g. a per-row "Retry" whose handler reads `{ entryId }` from the body. (The
|
|
731
|
+
* row id still rides the URL path too, which the handler may ignore.)
|
|
732
|
+
*/
|
|
733
|
+
rowTargetRequestField: z.string().optional(),
|
|
734
|
+
/**
|
|
735
|
+
* HOW this action collects its input — see {@link ResourceOperationActionPresentation}.
|
|
736
|
+
* Omitted derives from the operation (`resolveResourceOperationActionPresentation`): no input
|
|
737
|
+
* executes directly, a small field set opens a modal, complex input keeps its page.
|
|
738
|
+
*
|
|
739
|
+
* Display-only. An explicit `navigationOverrides` entry is the more specific instrument and wins
|
|
740
|
+
* over whatever this resolves to.
|
|
741
|
+
*/
|
|
742
|
+
actionPresentation: z.enum(ResourceOperationActionPresentation).optional(),
|
|
743
|
+
customView: z.any().optional(),
|
|
744
|
+
displayPresetOverride: z.object({
|
|
745
|
+
resourceLayoutPresetKey: z.string().optional(),
|
|
746
|
+
}).optional(),
|
|
747
|
+
navigationOverrides: z.array(NavigationOperationOverrideSchema).optional(),
|
|
748
|
+
displayPriority: z.number().optional(),
|
|
749
|
+
iconOverride: z.any().optional(),
|
|
750
|
+
collectionDisplayConfig: z.object({
|
|
751
|
+
displayMode: z.enum(CollectionDisplayMode).optional(),
|
|
752
|
+
userSwitchableDisplayMode: z.boolean().optional(),
|
|
753
|
+
/**
|
|
754
|
+
* Promote ONE enum filter field to a prominent quick-filter tab strip
|
|
755
|
+
* rendered above the collection toolbar ("All · <value> · <value> …" —
|
|
756
|
+
* the Stripe/Ignisign webhook-dashboard idiom, e.g. All/Delivered/Failed).
|
|
757
|
+
*
|
|
758
|
+
* The named field MUST be an enum member of the operation's backend
|
|
759
|
+
* `filterFields` — the tabs write into the SAME filter state as the
|
|
760
|
+
* filters panel (selecting a tab filters server-side), and the field is
|
|
761
|
+
* removed from the panel/chips so there is never a second competing
|
|
762
|
+
* control for it. Unknown / non-enum field names degrade gracefully
|
|
763
|
+
* (no tab strip, field stays in the panel). Tab labels reuse the enum
|
|
764
|
+
* value i18n (`tResourceFieldEnumValue`).
|
|
765
|
+
*/
|
|
766
|
+
quickFilterField: z.string().optional(),
|
|
767
|
+
/**
|
|
768
|
+
* Group CARDS-mode rows into day buckets by this date field, rendering a
|
|
769
|
+
* date heading between groups (activity-feed idiom for log-like
|
|
770
|
+
* collections, e.g. webhook deliveries by day). Purely presentational:
|
|
771
|
+
* grouping applies to the fetched page in its server order — pair it
|
|
772
|
+
* with a default sort on the same field so buckets are contiguous.
|
|
773
|
+
* Ignored in TABLE mode (column sorting owns the ordering there). Rows
|
|
774
|
+
* whose field value is missing/unparsable render in a trailing bucket
|
|
775
|
+
* without a date heading rather than being dropped.
|
|
776
|
+
*/
|
|
777
|
+
temporalGroupField: z.string().optional(),
|
|
778
|
+
/**
|
|
779
|
+
* CARDS-mode arrangement — a single-column bordered LIST (default) or an
|
|
780
|
+
* N-column responsive GRID. See {@link CardLayoutStyle}. `columns` (1–6) is
|
|
781
|
+
* the TARGET maximum; the grid steps DOWN to fewer columns as the grid's own
|
|
782
|
+
* available WIDTH narrows (an intrinsic `auto-fill minmax` track spec — so a
|
|
783
|
+
* grid embedded in a narrow pane collapses even on a wide viewport, with no
|
|
784
|
+
* media breakpoint). Authors give one N; the framework handles the rest.
|
|
785
|
+
* Ignored in TABLE mode.
|
|
786
|
+
*
|
|
787
|
+
* @example
|
|
788
|
+
* cardLayout: { style: CardLayoutStyle.GRID, columns: 3 }
|
|
789
|
+
*/
|
|
790
|
+
cardLayout: z.discriminatedUnion('style', [
|
|
791
|
+
z.object({ style: z.literal(CardLayoutStyle.LIST) }),
|
|
792
|
+
z.object({
|
|
793
|
+
style: z.literal(CardLayoutStyle.GRID),
|
|
794
|
+
columns: z.number().int().min(1).max(6),
|
|
795
|
+
}),
|
|
796
|
+
]).optional(),
|
|
797
|
+
/**
|
|
798
|
+
* Where each card's per-item action buttons sit, as a 2-axis anchor:
|
|
799
|
+
* `vertical` ({@link VerticalPlacement} TOP/MIDDLE/BOTTOM) × `horizontal`
|
|
800
|
+
* ({@link HorizontalPlacement} START/MIDDLE/END, RTL-aware). `orientation`
|
|
801
|
+
* ({@link DisplayDirection}) lays the button set out as a row (HORIZONTAL,
|
|
802
|
+
* default) or a vertical stack (VERTICAL). Omitted → the classic
|
|
803
|
+
* MIDDLE × END horizontal row.
|
|
804
|
+
*
|
|
805
|
+
* `MIDDLE × MIDDLE` is rejected (dead-center overlaps the card content and
|
|
806
|
+
* has no sensible meaning).
|
|
807
|
+
*
|
|
808
|
+
* @example
|
|
809
|
+
* cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END }
|
|
810
|
+
*/
|
|
811
|
+
cardActionPlacement: CardActionPlacementSchema.optional(),
|
|
812
|
+
/**
|
|
813
|
+
* Enable per-item SELECTION (checkboxes on cards / a select column in the
|
|
814
|
+
* table) and the resulting BULK ACTION bar. Explicit opt-in per view. The
|
|
815
|
+
* bar surfaces only operations declared `isBulkOperation` — a `selectable`
|
|
816
|
+
* view with no bulk operations shows checkboxes that drive an empty bar, so
|
|
817
|
+
* pair it with at least one bulk operation. Selection state is shared across
|
|
818
|
+
* the cards↔table toggle (it does not reset when switching modes).
|
|
819
|
+
*/
|
|
820
|
+
selectable: z.boolean().optional(),
|
|
821
|
+
}).optional(),
|
|
822
|
+
/**
|
|
823
|
+
* Opt this operation into a generated per-operation description label
|
|
824
|
+
* (`resources.{res}.operations.{op}.description`, read via `tResourceOperation`).
|
|
825
|
+
* Default off — most operations need no description (making it mandatory for
|
|
826
|
+
* every operation is far too verbose). Surfaces that show one (e.g. the danger
|
|
827
|
+
* zone) fall back to risk-based copy when this is unset. Mirrors how fields opt
|
|
828
|
+
* into a description via the `.describe()` decorator.
|
|
829
|
+
*/
|
|
830
|
+
hasDescription: z.boolean().optional(),
|
|
831
|
+
});
|
|
832
|
+
|
|
833
|
+
/**
|
|
834
|
+
* TypeScript interface for `ResourceOperationFrontendConfigSchema`.
|
|
835
|
+
* `iconOverride`, `customView`, and `actionVariant` are typed with their real
|
|
836
|
+
* React/enum values even though the Zod schema uses `z.any()` — Zod cannot
|
|
837
|
+
* validate function types, and `actionVariant`'s enum lives in a component
|
|
838
|
+
* module the schema must not import at runtime.
|
|
839
|
+
*/
|
|
840
|
+
export type ResourceOperationFrontendConfig = Omit<z.infer<typeof ResourceOperationFrontendConfigSchema>, 'iconOverride' | 'customView' | 'actionVariant'> & {
|
|
841
|
+
iconOverride?: IconLike;
|
|
842
|
+
customView?: React.ComponentType;
|
|
843
|
+
actionVariant?: ButtonVariants_Variant;
|
|
844
|
+
};
|
|
845
|
+
```
|