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