@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,839 @@
1
+ # Framework — frontend resource UI contracts (saas-frontend-lib)
2
+
3
+ Source-backed excerpts for `OperationKey` / typed keys, per-operation frontend config, full `ResourceUIBehaviorConfig`, and the `ResourceUIBehavior` preset map.
4
+
5
+ ## Import Origins
6
+
7
+ - `@wildo-ai/saas-frontend-lib`
8
+
9
+ ## Source Excerpts
10
+
11
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
12
+
13
+ ```typescript
14
+ *
15
+ * Key identifying a resource operation in the frontend preset.
16
+ *
17
+ * - `string` — default operation (e.g., `CoreResourceOperation.READ`)
18
+ * - `readonly [string, string]` — non-default variant: `[operationIdentifier, variantKey]`
19
+ * (e.g., `[CoreResourceOperation.READ, 'admin']`)
20
+ *
21
+ * The same extracted span also includes `FRONTEND_SCHEMA_KEY`, `ObjectShape`,
22
+ * `ResourceConfigLike`, and `TypedOperationKey` — the schema bridge and typed
23
+ * operation keys used by `resourceUIBehavior()` inference.
24
+ */
25
+ export type OperationKey = string | readonly [string, string];
26
+
27
+
28
+ // ── Schema bridge key ───────────────────────────────────────────────
29
+
30
+ /**
31
+ * Symbol key used internally by `resourceUIBehavior()` to attach the schema
32
+ * reference to the config object, and by `buildFrontendResourceConfigurations()`
33
+ * to extract it. Using a Symbol prevents collision with user-defined properties
34
+ * and is invisible in Object.keys()/JSON serialization.
35
+ */
36
+ export const FRONTEND_SCHEMA_KEY: unique symbol = Symbol('frontendSchema');
37
+
38
+
39
+ // ── Typed helper types ──────────────────────────────────────────────
40
+
41
+ /** Extracts the typed shape from a ZodObject, falls back to Record for non-objects. */
42
+ export type ObjectShape<T extends z.ZodTypeAny> =
43
+ T extends z.ZodObject<infer S> ? S : Record<string, z.ZodTypeAny>;
44
+
45
+ /**
46
+ * Accepts both factory functions and configuration instances for type inference.
47
+ * Used by `resourceUIBehavior()` to infer generics from either form.
48
+ */
49
+ export type ResourceConfigLike<
50
+ TCustomOp extends EnumLikeType | undefined,
51
+ TCoreOp extends Partial<CoreResourceOperation> | undefined,
52
+ TSchema extends z.ZodTypeAny,
53
+ > = ResourceConfiguration<TCustomOp, TCoreOp, TSchema>
54
+ | ResourceConfiguration_InitializationFactory<TCustomOp, TCoreOp, TSchema>;
55
+
56
+ /**
57
+ * Typed operation key — extends `ValidOperationKeys` with variant tuple support.
58
+ * When both generics default to `any`, collapses to `any` — backward compatible
59
+ * with untyped `OperationKey` usage.
60
+ */
61
+ export type TypedOperationKey<
62
+ TCustomOp extends EnumLikeType | undefined = any,
63
+ TCoreOp extends Partial<CoreResourceOperation> | undefined = any,
64
+ > = ValidOperationKeys<TCustomOp, TCoreOp> | readonly [ValidOperationKeys<TCustomOp, TCoreOp>, string];
65
+ ```
66
+ ## Import Origins
67
+
68
+ - `@wildo-ai/saas-frontend-lib`
69
+
70
+ ## Source Excerpts
71
+
72
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
73
+
74
+ ```typescript
75
+ *
76
+ * How a resource collection renders its items (cards vs table). A FRONTEND
77
+ * presentation vocabulary — authored on a LIST/SEARCH operation's
78
+ * `collectionDisplayConfig` (below) in the resource UI behavior, NEVER on the
79
+ * shared resources-config operation: the backend has no notion of cards-vs-table.
80
+ * The string values are the persisted view-mode keys, so a stored user choice
81
+ * reads straight across.
82
+ *
83
+ * @example
84
+ * // resource UI behavior `views` entry:
85
+ * [Op.LIST, { collectionDisplayConfig: { displayMode: CollectionDisplayMode.TABLE, userSwitchableDisplayMode: true } }]
86
+ */
87
+ export enum CollectionDisplayMode {
88
+ /** Stacked cards — one row per item via `ResourceListItemRenderer`. */
89
+ CARDS = 'cards',
90
+ /** Dense table — one column per summary field via the table body. */
91
+ TABLE = 'table',
92
+ }
93
+
94
+ /**
95
+ * How CARDS-mode items are arranged. Orthogonal to {@link CollectionDisplayMode}
96
+ * (this only shapes the CARDS body; TABLE ignores it). LIST and GRID are kept as
97
+ * DISTINCT layouts, not a `columns: 1` collapse — a list is bordered rows sharing
98
+ * one container (`divide-y`), a grid is separated card cells in N responsive
99
+ * columns.
100
+ */
101
+ export enum CardLayoutStyle {
102
+ /** Bordered rows in a single shared container (the classic stacked list). */
103
+ LIST = 'list',
104
+ /** Separated card cells laid out in an N-column responsive grid. */
105
+ GRID = 'grid',
106
+ }
107
+ ```
108
+
109
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
110
+
111
+ ```typescript
112
+ *
113
+ * Frontend configuration for a single resource operation.
114
+ *
115
+ * Controls how the operation is surfaced in the frontend:
116
+ * - `surface` — the operation's frontend surface: `ADDRESSABLE` (routable page),
117
+ * `EMBEDDED` (non-addressable view rendered within a host: overlay, composite, or
118
+ * nested), or `API_ONLY` (headless — no interface, callable as an API). See
119
+ * `ResourceOperationFrontendSurface`.
120
+ * - `customView` — direct UIBehavior-owned React component override for authored custom operation views.
121
+ * Use the exported operation-family component types (`ResourceReadCustomViewComponent`,
122
+ * `ResourceListCustomViewComponent`, etc.) plus the matching
123
+ * `useReadOperationSurface()` / `useListOperationSurface()` helpers when you
124
+ * want a strongly truthful custom host for a specific layout family.
125
+ * - `displayPresetOverride` — layout preset override for the operation's UI
126
+ * - `navigationOverrides` — per-operation navigation transition overrides
127
+ * - `displayPriority` — visual ordering in ActionBar/operation lists (lower = higher priority)
128
+ * - `iconOverride` — per-operation icon ref (overrides resource-level icon in navigation items)
129
+ * - `collectionDisplayConfig` — for LIST/SEARCH collection operations: the default
130
+ * cards-vs-table body (`displayMode`) and whether the user may toggle it
131
+ * (`userSwitchableDisplayMode`, persisted per resource type); the CARDS
132
+ * arrangement (`cardLayout` — LIST vs N-column GRID); where each card's action
133
+ * buttons sit (`cardActionPlacement` — 2-axis anchor + orientation); and
134
+ * whether items are selectable for bulk actions (`selectable`). Pure frontend
135
+ * presentation; the backend never reads it.
136
+ *
137
+ * **Resource-owned inserted views are NOT configured here.** Composite, chart,
138
+ * and execution views declared on the resource UI behavior surface themselves
139
+ * into their targeted operation host directly, via their own canonical fields:
140
+ * `compositeViews[*].operationLike` / `chartViews[*].operationLike` (single)
141
+ * and `executionViews[*].surfaceInOperations` (list). The layout consumer
142
+ * (`ResourceLayout_InsertedViews`) reads those declarations and filters them
143
+ * by the current operation at render time — there is no operation-level
144
+ * view-ref list to author or compile.
145
+ *
146
+ * **Historical note (search hit):** earlier versions of this schema exposed an
147
+ * `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:
148
+ * string[]`) operation-level field that authored which resource-owned views
149
+ * surfaced in this operation. That field was removed in the
150
+ * `resource-owned-view-surfacing-contract.md` workstream because it duplicated
151
+ * the per-view declaration sites (`compositeViews`, `chartViews`,
152
+ * `executionViews`) and could silently disagree with them. If you are looking
153
+ * for `additionalViews` because a doc, comment, prompt, or downstream code
154
+ * still references it, the answer is: declare the surface on the view itself
155
+ * (use `operationLike` for composite/chart, `surfaceInOperations` for
156
+ * execution), do not re-introduce an operation-level seam.
157
+ */
158
+ /**
159
+ * How an operation's ACTION (its action-bar button) is surfaced in this application.
160
+ *
161
+ * A per-app, **display-only** axis — backend authorization is unaffected, roles
162
+ * remain the only security authority, so this never makes an operation reachable
163
+ * that wasn't already; it only governs the button.
164
+ */
165
+ export enum ActionVisibility {
166
+ /** Always shown; rendered DISABLED when its `enabledCondition` is unmet. The default. */
167
+ ALWAYS = 'always',
168
+ /**
169
+ * Never shown — this app declares the operation's action off for this surface.
170
+ *
171
+ * Invariant: do NOT pair with a visible (addressable) view for the same operation.
172
+ * The action is the entry point to the view, so a visible view whose action is
173
+ * hidden is contradictory — there is no way to reach it. Hiding the action removes
174
+ * the operation, and the path to any view it has, from this app's UI.
175
+ */
176
+ HIDDEN = 'hidden',
177
+ /**
178
+ * Shown ONLY when its `enabledCondition` is met; HIDDEN (not disabled) otherwise.
179
+ *
180
+ * For state-conditional operations whose disabled state is just noise — e.g.
181
+ * organization `ACTIVATE` appears on a suspended org but vanishes on an active one,
182
+ * rather than sitting there greyed out.
183
+ */
184
+ WHEN_AVAILABLE = 'when_available',
185
+ }
186
+
187
+ /**
188
+ * Where an operation's ACTION sits in the action bar for this application.
189
+ *
190
+ * A per-app, **display-only** layout axis, orthogonal to authorization. When
191
+ * omitted, placement is DERIVED from the operation's `riskLevel`: HIGH/CRITICAL
192
+ * operations default to `DANGER_ZONE`, everything else to `PRIMARY`. Set it
193
+ * explicitly to override that default — e.g. tuck a non-risky-but-rare action
194
+ * into the danger zone, or keep a CRITICAL action inline in a dedicated admin
195
+ * tool. The same axis drives the bulk action bar, since both are built from the
196
+ * same operation pipeline.
197
+ */
198
+ export enum ActionPlacement {
199
+ /** Inline in the main action group. The default for low/medium-risk operations. */
200
+ PRIMARY = 'primary',
201
+ /**
202
+ * Segregated into a trailing "danger zone" group, fenced off by a separator,
203
+ * after every PRIMARY action. The default for HIGH/CRITICAL-risk operations
204
+ * (destructive deletes, lifecycle suspends).
205
+ */
206
+ DANGER_ZONE = 'danger_zone',
207
+ }
208
+
209
+ /**
210
+ * HOW an operation's action collects its input and shows its result — the chrome the user meets
211
+ * when they click the button.
212
+ *
213
+ * ## Why this axis exists
214
+ *
215
+ * Until this axis, one rule decided the answer for every custom operation:
216
+ * *has a `requestDto` ⇒ navigate*. So an action asking for a single reason string got the same
217
+ * full-page treatment as a multi-step wizard, and the only way out was to author
218
+ * `navigationOverrides` — per operation, in terms of a zone, a transition verb and an appearance.
219
+ * Three concepts to answer one question.
220
+ *
221
+ * This is that one question. It is a **display-only** axis: backend authorization is untouched and
222
+ * `roles` remain the only security authority, exactly like its siblings {@link ActionVisibility},
223
+ * {@link ActionPlacement} and {@link ResourceOperationActionScope}.
224
+ *
225
+ * ## It is an ALIAS, not a parallel mechanism
226
+ *
227
+ * `MODAL` and `PAGE` do not render anything themselves — they resolve to the navigation transitions
228
+ * that already exist (`OVERLAY`, and the ordinary chain), so there is one runtime mechanism and one
229
+ * set of zone/appearance/URL semantics. `DIRECT`, `POPOVER` and `INLINE` never enter navigation at
230
+ * all, because none of them is a destination: nothing is pushed, no zone changes, and there is
231
+ * nothing for a back button to pop. `INLINE` is hosted by the collection the element belongs to —
232
+ * see `InPlaceOperationContext` for why that is not the navigation layer's job.
233
+ *
234
+ * Consequently an explicit `navigationOverrides` entry still WINS over a presentation authored here
235
+ * (it is the more specific instrument, and it is checked first in the resolution chain). Author this
236
+ * axis to say what KIND of chrome the action wants; author `navigationOverrides` when you need to
237
+ * name the zone, the appearance or the viewport yourself.
238
+ *
239
+ * ## When omitted
240
+ *
241
+ * It is DERIVED from the operation — see `resolveResourceOperationActionPresentation()`. An
242
+ * operation that asks for nothing executes directly; a small field set opens a modal; input the
243
+ * framework cannot fit in an overlay (files, nested writes, a large field set) keeps the page it
244
+ * has always had. An operation whose `surface` is `ADDRESSABLE` always keeps its page: the author
245
+ * has already said it is a deep-linkable destination.
246
+ */
247
+ export enum ResourceOperationActionPresentation {
248
+ /**
249
+ * Execute on click, with no form at all — the confirmation dialog for a risky operation is the
250
+ * only thing between the click and the request.
251
+ *
252
+ * Only meaningful for an operation that needs no caller input. Declaring it on an operation that
253
+ * DOES have required request fields would send an empty body, so the resolver refuses to derive it
254
+ * there and an author who declares it anyway gets the operation's fields dropped — check
255
+ * `requestDto` before reaching for this.
256
+ */
257
+ DIRECT = 'direct',
258
+ /**
259
+ * A small form anchored to the button that opened it, dismissed by clicking away.
260
+ *
261
+ * The single-input idiom ("assign to…", "snooze until…"). Transient by construction: no URL, no
262
+ * history entry, nothing to deep-link. Use it when the surrounding context is the point — the user
263
+ * is reading the row they are acting on and must not lose sight of it.
264
+ */
265
+ POPOVER = 'popover',
266
+ /**
267
+ * The element being acted on transforms in place to collect the input, leaving its neighbours
268
+ * visible — the row becomes the form rather than being covered by one.
269
+ *
270
+ * Use it when the surrounding rows are the point: the user is comparing, and an overlay would hide
271
+ * the very thing that made them act on this row.
272
+ *
273
+ * **Transient, like {@link POPOVER}, and for the same reason.** Nothing is pushed, no URL changes,
274
+ * and a reload returns the list to rest. An inline row-edit is a momentary state of a listing, not
275
+ * a place — which is also why no admin framework deep-links one, and why anything that SHOULD be
276
+ * linkable, reloadable or reachable by a back button wants {@link PAGE}.
277
+ *
278
+ * **It requires a collection.** The host is provided by the list the element belongs to
279
+ * (`InPlaceOperationProvider`); the same action rendered on a detail page, in a danger zone or in a
280
+ * picker has no row to transform and degrades to an overlay rather than becoming a dead button.
281
+ *
282
+ * Note it does NOT resolve to `NavigationTransition.INPLACE`. Element-level hosting uses none of
283
+ * what the navigation layer offers — no zone, no stack entry, no appearance — and routing it there
284
+ * is exactly why that transition has never done what its own docstring promises. See
285
+ * `InPlaceOperationContext`.
286
+ */
287
+ INLINE = 'inline',
288
+ /**
289
+ * An overlay above the layout — the workhorse for "a handful of fields", and the default the
290
+ * derivation reaches for.
291
+ *
292
+ * Resolves to {@link NavigationTransition.OVERLAY}. The concrete appearance (dialog / sheet /
293
+ * drawer / panel) stays the app's decision, resolved from its navigation layout exactly as any
294
+ * other overlay: this axis says "an overlay", not "a dialog specifically". Author
295
+ * `navigationOverrides` when you need to name one.
296
+ */
297
+ MODAL = 'modal',
298
+ /**
299
+ * A routable page, resolved through the ordinary navigation chain (zone transitions, viewport
300
+ * overrides, the framework `PUSH` fallback) — i.e. exactly the behaviour every parameterised
301
+ * action had before this axis existed.
302
+ *
303
+ * The right answer for complex or multi-step input, and for anything a user should be able to
304
+ * link to, reload, or reach with a back button.
305
+ */
306
+ PAGE = 'page',
307
+ }
308
+
309
+ /**
310
+ * Does an operation's action target a SINGLE resource instance, or the WHOLE
311
+ * collection in the current scope?
312
+ *
313
+ * A per-app **surfacing** axis, orthogonal to authorization. Most actions are
314
+ * `ITEM` (edit / delete / retry one row) and render in the per-row and detail
315
+ * action bars. A `COLLECTION` action operates on every row in scope at once
316
+ * (e.g. "retry all failed deliveries", "purge the queue"): it renders ONCE in
317
+ * the list's collection-action surface (the toolbar), never per row, and
318
+ * confirms + executes in place rather than opening a per-row form.
319
+ *
320
+ * For a `COLLECTION` action to have a callable route, its operation must borrow
321
+ * a COLLECTION verb via `resourceOperationLike` (`UPDATE_MANY` / `DELETE_MANY` /
322
+ * `CREATE_MANY`) — an entity verb (`UPDATE` / `DELETE`) generates a route with a
323
+ * `:id` segment the scope-level surface has no single row to fill.
324
+ */
325
+ export enum ResourceOperationActionScope {
326
+ /** Targets one resource instance — the per-row / detail action bars. The default when omitted. */
327
+ ITEM = 'item',
328
+ /** Targets the whole collection in scope — rendered once in the list's collection-action surface. */
329
+ COLLECTION = 'collection',
330
+ }
331
+
332
+ /**
333
+ * What happens to an operation's action when its `enabledCondition` is currently
334
+ * unmet — the per-view default for actions that don't declare an explicit
335
+ * `actionVisibility`. An explicit per-operation `actionVisibility` always wins
336
+ * over this policy; feature-gated unavailability keeps its own
337
+ * `FeatureUnavailabilityBehavior` (upgrade/prompt) and is never hidden by this.
338
+ *
339
+ * - `HIDE` — drop the action entirely while unavailable (as if it declared
340
+ * `ActionVisibility.WHEN_AVAILABLE`). The framework default for BOTH views: a
341
+ * greyed, non-actionable button is noise wherever it sits, and hiding it also
342
+ * collapses mutually-exclusive state pairs (e.g. "Set as recurring" / "Set as
343
+ * one time") down to the one that currently applies.
344
+ * - `SHOW_DISABLED` — render the action greyed/disabled (the classic behavior).
345
+ * Opt in per view when the disabled action + its reason tooltip is genuinely
346
+ * informative and you want it always present.
347
+ */
348
+ export enum DisabledActionHandling {
349
+ SHOW_DISABLED = 'show_disabled',
350
+ HIDE = 'hide',
351
+ }
352
+
353
+ /**
354
+ * Per-view action-surfacing (disclosure) policy — how many actions stay visible
355
+ * and how unavailable ones are treated, for ONE {@link ResourceOperationDisplayMode}.
356
+ */
357
+ export interface ResourceActionDisclosureConfig {
358
+ /**
359
+ * How many PRIMARY actions render as direct buttons before the remainder
360
+ * collapse into the `…` overflow menu. Omitted inherits the framework default
361
+ * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY, unlimited
362
+ * for DETAIL. `0` pushes every action into the menu.
363
+ */
364
+ maxPrimaryActions?: number;
365
+ /**
366
+ * Default handling for actions disabled by an unmet `enabledCondition` — see
367
+ * {@link DisabledActionHandling}. Omitted inherits the framework default,
368
+ * which is `HIDE` for both views (set `SHOW_DISABLED` here to keep disabled
369
+ * actions greyed-but-present for a view).
370
+ */
371
+ disabledActionHandling?: DisabledActionHandling;
372
+ }
373
+
374
+ /** Fully-resolved disclosure policy (no optional fields) for one view. */
375
+ export interface ResolvedActionDisclosure {
376
+ /** `undefined` = unlimited (no overflow cap). */
377
+ maxPrimaryActions: number | undefined;
378
+ disabledActionHandling: DisabledActionHandling;
379
+ }
380
+
381
+ /**
382
+ * Framework defaults per view. Both views HIDE actions disabled by an unmet
383
+ * `enabledCondition` — an inapplicable, greyed button is noise everywhere, so
384
+ * the bar only ever shows actions the user can actually take right now. They
385
+ * differ on the overflow cap: SUMMARY (dense list/table rows) shows at most 3
386
+ * direct actions before the `…` menu; DETAIL (roomy read view) is uncapped.
387
+ * A resource that WANTS the informative greyed-with-reason affordance opts into
388
+ * `SHOW_DISABLED` per view via `layout.actionDisclosure`.
389
+ */
390
+ export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {
391
+ [ResourceOperationDisplayMode.SUMMARY]: {
392
+ maxPrimaryActions: 3,
393
+ disabledActionHandling: DisabledActionHandling.HIDE,
394
+ },
395
+ [ResourceOperationDisplayMode.DETAIL]: {
396
+ maxPrimaryActions: undefined,
397
+ disabledActionHandling: DisabledActionHandling.HIDE,
398
+ },
399
+ };
400
+
401
+ /**
402
+ * Resolve the effective disclosure policy for a view: per-resource override
403
+ * (`layout.actionDisclosure[view]`) layered over the framework default. Used by
404
+ * both the action-building hook (disabled handling) and the operations-items
405
+ * host (overflow cap).
406
+ */
407
+ export function resolveActionDisclosure(
408
+ displayMode: ResourceOperationDisplayMode,
409
+ disclosure: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>> | undefined,
410
+ ): ResolvedActionDisclosure {
411
+ const base = DEFAULT_ACTION_DISCLOSURE[displayMode] ?? DEFAULT_ACTION_DISCLOSURE[ResourceOperationDisplayMode.DETAIL];
412
+ const override = disclosure?.[displayMode];
413
+ return {
414
+ maxPrimaryActions: override?.maxPrimaryActions ?? base.maxPrimaryActions,
415
+ disabledActionHandling: override?.disabledActionHandling ?? base.disabledActionHandling,
416
+ };
417
+ }
418
+
419
+ /**
420
+ * 2-axis card action-button placement. Single source of truth for the config
421
+ * field AND the `card-action-placement.utils` resolver (which imports the
422
+ * `CardActionPlacement` type inferred from this schema, so the two can never
423
+ * drift). `MIDDLE × MIDDLE` is rejected — dead-center overlaps the card content.
424
+ */
425
+ export const CardActionPlacementSchema = z.object({
426
+ vertical: z.enum(VerticalPlacement),
427
+ horizontal: z.enum(HorizontalPlacement),
428
+ orientation: z.enum(DisplayDirection).optional(),
429
+ }).refine(
430
+ (p) => !(p.vertical === VerticalPlacement.MIDDLE && p.horizontal === HorizontalPlacement.MIDDLE),
431
+ { message: 'cardActionPlacement cannot be MIDDLE × MIDDLE (dead-center overlaps card content); choose an edge or corner.' },
432
+ );
433
+
434
+ /** Authored 2-axis card action placement — inferred from {@link CardActionPlacementSchema}. */
435
+ export type CardActionPlacement = z.infer<typeof CardActionPlacementSchema>;
436
+
437
+ export const ResourceOperationFrontendConfigSchema = z.object({
438
+ /**
439
+ * The operation's frontend **surface** — see {@link ResourceOperationFrontendSurface}.
440
+ * `ADDRESSABLE` (routable page) and `EMBEDDED` (non-addressable view rendered within
441
+ * a host — overlay/composite/nested) both have a view + action button; `API_ONLY` is
442
+ * headless (no view, no button). The view fields below (`actionVisibility`,
443
+ * `customView`, `iconOverride`, layout, …) apply only to `ADDRESSABLE`/`EMBEDDED`; a
444
+ * build-time check rejects them on `API_ONLY`.
445
+ * Replaces the former `isAddressable` boolean — read via `isOperationAddressable()`.
446
+ */
447
+ surface: z.enum(ResourceOperationFrontendSurface),
448
+ /**
449
+ * How this operation's action is surfaced — see {@link ActionVisibility}. Omitted
450
+ * (the common case) behaves as `ALWAYS`.
451
+ */
452
+ actionVisibility: z.enum(ActionVisibility).optional(),
453
+ /**
454
+ * Where this operation's action sits in the bar — see {@link ActionPlacement}.
455
+ * Omitted derives from `riskLevel` (HIGH/CRITICAL → danger zone, else primary).
456
+ */
457
+ actionPlacement: z.enum(ActionPlacement).optional(),
458
+ /**
459
+ * Visual button variant (colour) for this operation's action — a
460
+ * `ButtonVariants_Variant` (e.g. `DESTRUCTIVE`, `GHOST`, `ACCENT`). Omitted
461
+ * derives from `riskLevel` (HIGH/CRITICAL → destructive/red, else ghost). Typed
462
+ * on the interface below; the Zod field stays `z.any()` because the enum lives
463
+ * in a component module a schema must not pull at runtime (same as `iconOverride`).
464
+ */
465
+ actionVariant: z.any().optional(),
466
+ /**
467
+ * Does this action target one row or the whole collection — see
468
+ * {@link ResourceOperationActionScope}. Omitted behaves as `ITEM`. A
469
+ * `COLLECTION` action renders once in the list's collection-action surface
470
+ * (never per row) and confirms + executes in place; pair it with a COLLECTION
471
+ * `resourceOperationLike` (`*_MANY`) so its generated route carries no `:id`.
472
+ */
473
+ actionScope: z.enum(ResourceOperationActionScope).optional(),
474
+ /**
475
+ * For an `ITEM` action whose backend addresses the target row by a field in
476
+ * the REQUEST BODY (not the URL id), the request-DTO field name to fill with
477
+ * the clicked row's id. When set, clicking the action executes IN PLACE —
478
+ * sending `{ [rowTargetRequestField]: <rowId> }` — instead of opening a form:
479
+ * e.g. a per-row "Retry" whose handler reads `{ entryId }` from the body. (The
480
+ * row id still rides the URL path too, which the handler may ignore.)
481
+ */
482
+ rowTargetRequestField: z.string().optional(),
483
+ /**
484
+ * HOW this action collects its input — see {@link ResourceOperationActionPresentation}.
485
+ * Omitted derives from the operation (`resolveResourceOperationActionPresentation`): no input
486
+ * executes directly, a small field set opens a modal, complex input keeps its page.
487
+ *
488
+ * Display-only. An explicit `navigationOverrides` entry is the more specific instrument and wins
489
+ * over whatever this resolves to.
490
+ */
491
+ actionPresentation: z.enum(ResourceOperationActionPresentation).optional(),
492
+ customView: z.any().optional(),
493
+ displayPresetOverride: z.object({
494
+ resourceLayoutPresetKey: z.string().optional(),
495
+ }).optional(),
496
+ navigationOverrides: z.array(NavigationOperationOverrideSchema).optional(),
497
+ displayPriority: z.number().optional(),
498
+ iconOverride: z.any().optional(),
499
+ collectionDisplayConfig: z.object({
500
+ displayMode: z.enum(CollectionDisplayMode).optional(),
501
+ userSwitchableDisplayMode: z.boolean().optional(),
502
+ /**
503
+ * Promote ONE enum filter field to a prominent quick-filter tab strip
504
+ * rendered above the collection toolbar ("All · <value> · <value> …" —
505
+ * the Stripe/Ignisign webhook-dashboard idiom, e.g. All/Delivered/Failed).
506
+ *
507
+ * The named field MUST be an enum member of the operation's backend
508
+ * `filterFields` — the tabs write into the SAME filter state as the
509
+ * filters panel (selecting a tab filters server-side), and the field is
510
+ * removed from the panel/chips so there is never a second competing
511
+ * control for it. Unknown / non-enum field names degrade gracefully
512
+ * (no tab strip, field stays in the panel). Tab labels reuse the enum
513
+ * value i18n (`tResourceFieldEnumValue`).
514
+ */
515
+ quickFilterField: z.string().optional(),
516
+ /**
517
+ * Group CARDS-mode rows into day buckets by this date field, rendering a
518
+ * date heading between groups (activity-feed idiom for log-like
519
+ * collections, e.g. webhook deliveries by day). Purely presentational:
520
+ * grouping applies to the fetched page in its server order — pair it
521
+ * with a default sort on the same field so buckets are contiguous.
522
+ * Ignored in TABLE mode (column sorting owns the ordering there). Rows
523
+ * whose field value is missing/unparsable render in a trailing bucket
524
+ * without a date heading rather than being dropped.
525
+ */
526
+ temporalGroupField: z.string().optional(),
527
+ /**
528
+ * CARDS-mode arrangement — a single-column bordered LIST (default) or an
529
+ * N-column responsive GRID. See {@link CardLayoutStyle}. `columns` (1–6) is
530
+ * the TARGET maximum; the grid steps DOWN to fewer columns as the grid's own
531
+ * available WIDTH narrows (an intrinsic `auto-fill minmax` track spec — so a
532
+ * grid embedded in a narrow pane collapses even on a wide viewport, with no
533
+ * media breakpoint). Authors give one N; the framework handles the rest.
534
+ * Ignored in TABLE mode.
535
+ *
536
+ * @example
537
+ * cardLayout: { style: CardLayoutStyle.GRID, columns: 3 }
538
+ */
539
+ cardLayout: z.discriminatedUnion('style', [
540
+ z.object({ style: z.literal(CardLayoutStyle.LIST) }),
541
+ z.object({
542
+ style: z.literal(CardLayoutStyle.GRID),
543
+ columns: z.number().int().min(1).max(6),
544
+ }),
545
+ ]).optional(),
546
+ /**
547
+ * Where each card's per-item action buttons sit, as a 2-axis anchor:
548
+ * `vertical` ({@link VerticalPlacement} TOP/MIDDLE/BOTTOM) × `horizontal`
549
+ * ({@link HorizontalPlacement} START/MIDDLE/END, RTL-aware). `orientation`
550
+ * ({@link DisplayDirection}) lays the button set out as a row (HORIZONTAL,
551
+ * default) or a vertical stack (VERTICAL). Omitted → the classic
552
+ * MIDDLE × END horizontal row.
553
+ *
554
+ * `MIDDLE × MIDDLE` is rejected (dead-center overlaps the card content and
555
+ * has no sensible meaning).
556
+ *
557
+ * @example
558
+ * cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END }
559
+ */
560
+ cardActionPlacement: CardActionPlacementSchema.optional(),
561
+ /**
562
+ * Enable per-item SELECTION (checkboxes on cards / a select column in the
563
+ * table) and the resulting BULK ACTION bar. Explicit opt-in per view. The
564
+ * bar surfaces only operations declared `isBulkOperation` — a `selectable`
565
+ * view with no bulk operations shows checkboxes that drive an empty bar, so
566
+ * pair it with at least one bulk operation. Selection state is shared across
567
+ * the cards↔table toggle (it does not reset when switching modes).
568
+ */
569
+ selectable: z.boolean().optional(),
570
+ }).optional(),
571
+ /**
572
+ * Opt this operation into a generated per-operation description label
573
+ * (`resources.{res}.operations.{op}.description`, read via `tResourceOperation`).
574
+ * Default off — most operations need no description (making it mandatory for
575
+ * every operation is far too verbose). Surfaces that show one (e.g. the danger
576
+ * zone) fall back to risk-based copy when this is unset. Mirrors how fields opt
577
+ * into a description via the `.describe()` decorator.
578
+ */
579
+ hasDescription: z.boolean().optional(),
580
+ });
581
+
582
+ /**
583
+ * TypeScript interface for `ResourceOperationFrontendConfigSchema`.
584
+ * `iconOverride`, `customView`, and `actionVariant` are typed with their real
585
+ * React/enum values even though the Zod schema uses `z.any()` — Zod cannot
586
+ * validate function types, and `actionVariant`'s enum lives in a component
587
+ * module the schema must not import at runtime.
588
+ */
589
+ export type ResourceOperationFrontendConfig = Omit<z.infer<typeof ResourceOperationFrontendConfigSchema>, 'iconOverride' | 'customView' | 'actionVariant'> & {
590
+ iconOverride?: IconLike;
591
+ customView?: React.ComponentType;
592
+ actionVariant?: ButtonVariants_Variant;
593
+ };
594
+ ```
595
+ ## Import Origins
596
+
597
+ - `@wildo-ai/saas-frontend-lib`
598
+
599
+ ## Source Excerpts
600
+
601
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
602
+
603
+ ```typescript
604
+ *
605
+ * Complete frontend configuration for a single resource within an application.
606
+ *
607
+ * Canonical frontend resource configuration type. Contains resource-level settings
608
+ * (labels, sections, views, empty state, guidance) plus per-operation frontend config.
609
+ *
610
+ * Generic `TMainSchema` defaults to `z.ZodAny`. Presets and `ResourceUIBehavior`
611
+ * records use the default; app-level configs can narrow it to a concrete schema
612
+ * for type-safe `getFrontendResourceLabel` callbacks.
613
+ *
614
+ * This is the canonical frontend type — it is self-contained and does not
615
+ * reference or depend on backend resource configuration factories.
616
+ *
617
+ * UI views use a `Map` keyed by `OperationKey`:
618
+ * - `string` key for default operations
619
+ * - `[operationId, variantKey]` tuple for non-default variants
620
+ *
621
+ * @example
622
+ * ```
623
+ * const orgConfig: ResourceUIBehaviorConfig<any, any, typeof OrgSchema> = {
624
+ * getFrontendResourceLabel: ({ currentObject }) => currentObject.name, // type-safe
625
+ * views: new Map([
626
+ * [CoreResourceOperation.CREATE, notAddressable()],
627
+ * [CoreResourceOperation.LIST, addressable()],
628
+ * ]),
629
+ * };
630
+ *
631
+ * // Input form (via resourceUIBehavior callback) uses array-of-tuples:
632
+ * // views: [
633
+ * // [CoreResourceOperation.CREATE, notAddressable()],
634
+ * // [CoreResourceOperation.LIST, addressable()],
635
+ * // ],
636
+ * ```
637
+ */
638
+ export type ResourceUIBehaviorConfig<
639
+ TCustomOp extends EnumLikeType | undefined = any,
640
+ TCoreOp extends Partial<CoreResourceOperation> | undefined = any,
641
+ TMainSchema extends z.ZodTypeAny = z.ZodAny,
642
+ > = {
643
+
644
+ // ── Resource Icon ──────────────────────────────────────────────
645
+
646
+ /**
647
+ * Resource-level icon — React component (e.g., Lucide) or string
648
+ * (StandardIconReference). Registered into `IconRegistry.resources`
649
+ * during `buildFrontendResourceConfigurations()`.
650
+ */
651
+ icon?: IconLike;
652
+
653
+
654
+ // ── Field Addons ───────────────────────────────────────────────
655
+
656
+ /**
657
+ * Per-field decorator overrides for the resource's `mainSchema`.
658
+ *
659
+ * Keys are field names of `TMainSchema`; values are decorated Zod schemas
660
+ * from the same shape (e.g., `shape.status.enumUI({ ... })`).
661
+ *
662
+ * The merge happens at **module evaluation time** — calling `.enumUI()`
663
+ * on a shape field mutates its metadata in place via `applySingleDecorator`
664
+ * merge semantics. Schema-level decorators are preserved, addon decorators
665
+ * overlay. No explicit runtime consumption is needed; the `fields`
666
+ * field exists primarily for type safety (`keyof z.infer<TMainSchema>`)
667
+ * and as a declaration container.
668
+ *
669
+ * @example
670
+ * ```ts
671
+ * fields: {
672
+ * status: shape.status.enumUI({
673
+ * values: { pending: { color: 'secondary' }, completed: { color: 'success' } },
674
+ * }),
675
+ * }
676
+ * ```
677
+ */
678
+ fields?: {
679
+ [K in keyof ObjectShape<TMainSchema>]?: ObjectShape<TMainSchema>[K];
680
+ };
681
+
682
+
683
+ // ── Form Defaults ──────────────────────────────────────────────
684
+
685
+ /**
686
+ * Resource-level default validation mode for form fields.
687
+ * Individual fields can override via `{primitive}UI({ edit: { validationMode } })`.
688
+ * Falls back to framework default (`ON_BLUR`) when not set.
689
+ */
690
+ defaultValidationMode?: ValidationMode;
691
+
692
+ /**
693
+ * Resource-level default autosave config for form fields.
694
+ * Individual fields can override via `{primitive}UI({ edit: { autosave } })`.
695
+ * When not set, autosave is disabled unless explicitly configured per-field.
696
+ */
697
+ defaultAutosave?: AutosaveFieldParams | true;
698
+
699
+
700
+ // ── Draft Mode ─────────────────────────────────────────────────
701
+
702
+ /**
703
+ * Resource-level draft mode configuration.
704
+ * Defines how draft/publish discrimination works — which field acts as
705
+ * discriminator, what values mean "draft" vs "published", and whether
706
+ * publishing requires confirmation.
707
+ *
708
+ * Consumed by `ResourceAutomatedForm` to enable Save-as-Draft / Publish
709
+ * buttons and relaxed validation for draft saves.
710
+ */
711
+ draftableConfig?: DraftableConfigParams;
712
+
713
+
714
+ // ── Layout ──────────────────────────────────────────────────────
715
+
716
+ /**
717
+ * Template-based layout configuration. Resources needing sections, wizard steps,
718
+ * or custom layouts provide explicit JSX templates using skeleton components
719
+ * (`<Section>`, `<FormField>`, `<WizardLayout>`, etc.).
720
+ *
721
+ * @see ResourceLayoutConfig
722
+ */
723
+ layout?: ResourceLayoutConfig;
724
+
725
+
726
+ // ── Label ──────────────────────────────────────────────────────
727
+
728
+ /**
729
+ * Label generation for resource instances in the frontend.
730
+ *
731
+ * Can be either:
732
+ * - `string[]` — array of field paths to concatenate (each entry is a field
733
+ * name on the summary record, including any server-resolved virtual field
734
+ * such as a `forwardedLabel`, e.g. `['instanceLabel']`).
735
+ * - `(params: ResourceUIBehaviorLabelParams) => string` — a function
736
+ *
737
+ * Used by `ResourceListItemRenderer` (rows) and `ResourceLayout_Header` (titles).
738
+ */
739
+ getFrontendResourceLabel?: string[] | ((params: ResourceUIBehaviorLabelParams<TMainSchema>) => string);
740
+
741
+
742
+ // ── Views ──────────────────────────────────────────────────────
743
+
744
+ /** Resource-owned composite templates declared inline on the resource UI behavior. */
745
+ compositeViews?: ResourceCompositeViewsConfig;
746
+
747
+ /** Resource-owned execution surfaces declared inline on the resource UI behavior. */
748
+ executionViews?: ResourceExecutionViewsConfig;
749
+
750
+ /** Resource-owned inserted chart declarations for this resource. */
751
+ chartViews?: InsertedChartDeclaration[];
752
+
753
+
754
+ // ── Empty State ────────────────────────────────────────────────
755
+
756
+ /**
757
+ * Empty state configuration for list/table views when no items exist.
758
+ * Labels (title, description, primaryActionLabel) come from i18n.
759
+ */
760
+ emptyState?: ResourceUIBehavior_EmptyState;
761
+
762
+
763
+ // ── Guidance ───────────────────────────────────────────────────
764
+
765
+ /**
766
+ * Resource-level guidance flow declarations.
767
+ * Compiled into standard `GuidanceFlowDefinition` objects by the guidance compiler.
768
+ */
769
+ guidance?: ResourceUIBehavior_GuidanceFlow[];
770
+
771
+
772
+ // ── Relationship Display Overrides ───────────────────────────────
773
+
774
+ /**
775
+ * Per-relationship display overrides for this resource.
776
+ *
777
+ * Allows the frontend preset to override how relationships are displayed
778
+ * without modifying the shared `display` config on the relationship itself.
779
+ * Consumed at build time by `resolveRelationshipDisplayOverrides()` and
780
+ * stripped from `frontendConfiguration` before storage.
781
+ *
782
+ * @see RelationshipDisplayOverride
783
+ */
784
+ relationshipOverrides?: RelationshipDisplayOverride[];
785
+
786
+
787
+ // ── UI Views ───────────────────────────────────────────────────
788
+
789
+ /**
790
+ * Per-operation frontend configuration — which operations have a UI view
791
+ * and how they appear (addressability, launchers, overrides).
792
+ *
793
+ * Keyed by `TypedOperationKey`:
794
+ * - `string` — default operation (e.g., `CoreResourceOperation.READ`)
795
+ * - `[operationId, variantKey]` — non-default variant
796
+ *
797
+ * When typed via `resourceUIBehavior()`, operation keys are validated
798
+ * at compile time against the resource's valid operations.
799
+ */
800
+ views: Map<TypedOperationKey<TCustomOp, TCoreOp>, ResourceOperationFrontendConfig>;
801
+ };
802
+ ```
803
+ ## Import Origins
804
+
805
+ - `@wildo-ai/saas-frontend-lib`
806
+
807
+ ## Source Excerpts
808
+
809
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
810
+
811
+ ```typescript
812
+ *
813
+ * Complete frontend resource configuration preset for an application.
814
+ *
815
+ * Maps resource types to their full frontend configuration — including
816
+ * resource-level settings (labels, sections, views, empty state, guidance)
817
+ * and operation-level settings (addressability, launchers, overrides).
818
+ *
819
+ * Each application provides its own preset defining exactly which resources
820
+ * and operations it exposes and how they appear in the UI.
821
+ *
822
+ * When authoring presets, use `resourceUIBehavior()` which accepts views
823
+ * as an array of tuples (for contextual typing) and converts to Map internally.
824
+ *
825
+ * @example
826
+ * ```
827
+ * const preset: ResourceUIBehavior = {
828
+ * [CoreResourceType.ORGANIZATIONS]: resourceUIBehavior(factory, Schema, ({ schema, schemaShape, opsVariantResolver }) => ({
829
+ * getFrontendResourceLabel: ({ currentObject }) => currentObject.name,
830
+ * views: [
831
+ * [CoreResourceOperation.CREATE, notAddressable()],
832
+ * [CoreResourceOperation.READ, notAddressable()],
833
+ * ],
834
+ * })),
835
+ * };
836
+ * ```
837
+ */
838
+ export type ResourceUIBehavior = Record<string, ResourceUIBehaviorConfig>;
839
+ ```