@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,1212 @@
1
+ # Surface Policy API
2
+
3
+ Read this when editing `surfacePolicies` in `frontend/src/config/design-system.config.ts`
4
+ or adding a local `<Surface policyOverride={...}>`.
5
+
6
+ - Import `SurfaceVariant` and `DeepPartialSurfacePolicy` from
7
+ `@wildo-ai/presets-components-models`.
8
+ - Use the source contract below for accepted policy families and slot values.
9
+ - Prefer app-level `surfacePolicies` for app-wide behavior, and local
10
+ `policyOverride` for one component or one route.
11
+ - The defaults excerpt documents merge order and variant coverage. Do not copy
12
+ the default map into app code.
13
+
14
+ ## Import Origins
15
+
16
+ - `@wildo-ai/presets-components-models`
17
+
18
+ ## Source Excerpts
19
+
20
+ ### Origin Package: `@wildo-ai/presets-components-models`
21
+
22
+ ```typescript
23
+ /**
24
+ * Semantic variants for SURFACE behavior.
25
+ *
26
+ * Import `SurfaceVariant` from `@wildo-ai/presets-components-models`.
27
+ * Use these enum values as keys for `theme.surface` recipe maps and
28
+ * `designSystemConfig.surfacePolicies`. Do not confuse this with `SurfaceLayer`,
29
+ * which is only the semantic background-color token family.
30
+ *
31
+ * Each variant maps to (a) a recipe of visual chrome classes (`theme.surface[variant]`)
32
+ * AND (b) a `SurfacePolicy` defining container-level behavior such as padding,
33
+ * overflow, frame ownership, landmark role, stacking, and overlay geometry.
34
+ *
35
+ * Every `ComponentStyleTheme.surface` map is strict: provide a recipe for each
36
+ * variant, even when the recipe is intentionally chromeless.
37
+ */
38
+ export enum SurfaceVariant {
39
+ /** Default card-like surface */
40
+ BASE = 'base',
41
+ /**
42
+ * Content card — an explicitly-authored content grouping that ALWAYS paints
43
+ * its own elevated fill + border (distinct from the page background), so it
44
+ * reads as a card in every context, including inside a dialog or page. Unlike
45
+ * `BASE`/`RAISED`, a `CARD` does NOT de-duplicate its frame when nested in an
46
+ * already-framed ancestor: the author chose a card, so it stays a card. The
47
+ * fill comes from the theme's CARD recipe (the elevated `surface-raised`
48
+ * token by default). Material is an independent design-system axis: choosing
49
+ * the CARD semantic role must never implicitly force a glass material.
50
+ */
51
+ CARD = 'card',
52
+ /** Higher elevation — popovers, dropdowns */
53
+ RAISED = 'raised',
54
+ /** Modal/dialog surfaces */
55
+ OVERLAY = 'overlay',
56
+ /** Recessed areas — input wells */
57
+ INSET = 'inset',
58
+ /** Navigation panels, sidebars */
59
+ SUNKEN = 'sunken',
60
+ /** Panel under a tab strip — joins seamlessly to the strip above (no top edge). */
61
+ TAB_PANEL = 'tab-panel',
62
+ /** Page content area / app surface — chromeless background; may own `<main>` semantics after app opt-in. */
63
+ SHELL = 'shell',
64
+ /** Toast, snackbar, ephemeral floating notification. */
65
+ TRANSIENT = 'transient',
66
+ }
67
+ ```
68
+
69
+ ## Import Origins
70
+
71
+ - `@wildo-ai/presets-components-models`
72
+
73
+ ## Source Excerpts
74
+
75
+ ### Origin Package: `@wildo-ai/presets-components-models`
76
+
77
+ ```typescript
78
+ /**
79
+ * Application-facing Surface Policy contract.
80
+ *
81
+ * Import policy types and `SurfaceVariant` from `@wildo-ai/presets-components-models`.
82
+ * Use `DeepPartialSurfacePolicy` for app-level `designSystemConfig.surfacePolicies`
83
+ * overrides and for local `<Surface policyOverride={...}>` overrides. A policy is
84
+ * grouped by families (`containment`, `nesting`, `a11y`, etc.) so app code can
85
+ * override one slot without replacing sibling behavior.
86
+ *
87
+ * `reset` means "return this slot to the framework default for the current
88
+ * `SurfaceVariant`". `inherit` is only available on selected slots whose
89
+ * behavior can safely walk up from a parent surface.
90
+ */
91
+ /** Generic policy escape hatch for reset-capable slots. */
92
+ export type PolicyReset = 'reset';
93
+
94
+ // --- Family A: Containment ---------------------------------------------------
95
+
96
+ /**
97
+ * Semantic padding tier mapping to `--sp-*` tokens.
98
+ *
99
+ * `'none'` → no padding (recipe / consumer owns it)
100
+ * `'field'`, `'card-sm'`, `'card'`, `'container'` → corresponding `--sp-*` token
101
+ */
102
+ export type ContainmentPaddingTier = 'none' | 'field' | 'card-sm' | 'card' | 'container';
103
+
104
+ export type OverflowStrategy = 'visible' | 'clip' | 'auto' | 'scroll';
105
+
106
+ /**
107
+ * Semantic gap tier — applies to flex/grid container of `Surface.Body`'s direct
108
+ * children. Maps to `--sp-*` tokens.
109
+ */
110
+ export type GapTier = 'none' | 'item' | 'field' | 'section' | 'lane';
111
+
112
+ type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
113
+ type NonZeroDigit = Exclude<Digit, '0'>;
114
+ type CssLengthUnit =
115
+ | 'px'
116
+ | 'rem'
117
+ | 'em'
118
+ | 'ch'
119
+ | 'ex'
120
+ | 'lh'
121
+ | 'rlh'
122
+ | 'vw'
123
+ | 'vh'
124
+ | 'vmin'
125
+ | 'vmax'
126
+ | 'svw'
127
+ | 'svh'
128
+ | 'lvw'
129
+ | 'lvh'
130
+ | 'dvw'
131
+ | 'dvh'
132
+ | '%'
133
+ | 'cqw'
134
+ | 'cqh'
135
+ | 'cqi'
136
+ | 'cqb'
137
+ | 'cqmin'
138
+ | 'cqmax';
139
+ type CssMaxHeightKeyword =
140
+ | 'inherit'
141
+ | 'initial'
142
+ | 'revert'
143
+ | 'revert-layer'
144
+ | 'unset'
145
+ | 'min-content'
146
+ | 'max-content'
147
+ | 'fit-content';
148
+ type CssSizingFunction = 'var' | 'calc' | 'clamp' | 'min' | 'max' | 'fit-content';
149
+ type CssNonNegativeNumber = `${Digit}${string}` | `.${Digit}${string}`;
150
+ export type CssMaxHeightValue =
151
+ | 'none'
152
+ | CssMaxHeightKeyword
153
+ | '0'
154
+ | `${CssNonNegativeNumber}${CssLengthUnit}`
155
+ | `${CssSizingFunction}(${string})`;
156
+ type PositiveLineClamp =
157
+ | `${NonZeroDigit}`
158
+ | `${NonZeroDigit}${Digit}`
159
+ | `${NonZeroDigit}${Digit}${Digit}`
160
+ | `${NonZeroDigit}${Digit}${Digit}${Digit}`;
161
+
162
+ export interface ContainmentPolicy {
163
+ /** Inner Y-axis padding tier (semantic, maps to `--sp-*`). */
164
+ paddingBlock?: ContainmentPaddingTier | PolicyReset;
165
+ /**
166
+ * Inner X-axis padding tier — separate from Y because `Card` today uses
167
+ * `py-card` (Y) on root + `px-card` per slot, and `Surface.Header/Body/Footer`
168
+ * often need different inline padding from their parent.
169
+ */
170
+ paddingInline?: ContainmentPaddingTier | PolicyReset;
171
+ /** Overflow strategy on the surface root. */
172
+ overflow?: OverflowStrategy | PolicyReset;
173
+ /** Max-height as a validated CSS sizing value (e.g. `'90vh'`, `'60vh'`) or `'none'`. */
174
+ maxHeight?: CssMaxHeightValue | PolicyReset;
175
+ /** Gap when surface body is a flex/stack container. */
176
+ gap?: GapTier | PolicyReset;
177
+ /**
178
+ * Per-slot override of `gap` for `Surface.Header` / `Surface.Body` /
179
+ * `Surface.Footer` (Dialog needs `gap-element` in Header but `gap-field` in
180
+ * root, etc.).
181
+ */
182
+ slotGap?: Partial<{ header: GapTier | PolicyReset; body: GapTier | PolicyReset; footer: GapTier | PolicyReset }>;
183
+ }
184
+
185
+ // --- Family B: Nesting -------------------------------------------------------
186
+
187
+ /**
188
+ * Whether this surface should render its visual frame (border/shadow).
189
+ *
190
+ * `'always'`: always render the frame.
191
+ * `'when-orphan'`: render the frame only when no ancestor surface is itself
192
+ * framed — replaces `last:border-b-0` patches and double-border bugs.
193
+ * Resolved from derived frame ancestry state.
194
+ * `'never'`: never render the frame (chromaless surfaces — SHELL, TAB_PANEL).
195
+ */
196
+ export type FramingMode = 'always' | 'when-orphan' | 'never';
197
+
198
+ /**
199
+ * How nested surface corners scale relative to their parent's radius.
200
+ *
201
+ * `'inherit'`: child uses parent's resolved radius value.
202
+ * `'one-tier-tighter'`: child auto-shrinks one step on the radius scale (matches
203
+ * most material/shadcn conventions; concentric corners).
204
+ * `'fixed'`: child uses its own variant's radius regardless of parent
205
+ * (Brutalist/Trading where radius is constant or 0).
206
+ */
207
+ export type NestedRadiusStrategy = 'inherit' | 'one-tier-tighter' | 'fixed';
208
+
209
+ /**
210
+ * When this surface sits at its parent's edge, drop the duplicate edge.
211
+ *
212
+ * `'collapse'`: remove the duplicate edge (e.g. child's top border collapses
213
+ * into parent's top border).
214
+ * `'preserve'`: keep both edges (gap/separator handles the visual).
215
+ */
216
+ export type FirstChildEdgeStrategy = 'collapse' | 'preserve';
217
+
218
+ /**
219
+ * How repeated children of this surface visually separate themselves.
220
+ * Replaces ad-hoc `last:border-b-0` / `[&_tr:last-child]:border-0` patches.
221
+ */
222
+ export type DividerStrategy = 'border' | 'gap' | 'rule' | 'none';
223
+
224
+ export interface NestingPolicy {
225
+ framingMode?: FramingMode | PolicyReset;
226
+ nestedRadiusStrategy?: NestedRadiusStrategy | PolicyReset;
227
+ firstChildEdgeStrategy?: FirstChildEdgeStrategy | PolicyReset;
228
+ dividerStrategy?: DividerStrategy | PolicyReset;
229
+ }
230
+
231
+ // --- Family C: Content -------------------------------------------------------
232
+
233
+ /**
234
+ * How long text inside this surface should clip.
235
+ *
236
+ * `'ellipsis-multiline:N'` is parameterized — pick a positive integer from
237
+ * 1 through 9999 (e.g. `'ellipsis-multiline:2'` for 2-line truncate). The
238
+ * generated CSS / `<Text>` consumer maps the parameter to
239
+ * `-webkit-line-clamp: N`.
240
+ */
241
+ export type TextTruncationStrategy =
242
+ | 'none'
243
+ | 'ellipsis-line'
244
+ | `ellipsis-multiline:${PositiveLineClamp}`
245
+ | 'fade'
246
+ | 'inherit';
247
+
248
+ /** CSS `text-wrap` strategy. */
249
+ export type WrapStrategy = 'wrap' | 'nowrap' | 'balance' | 'pretty' | 'inherit';
250
+
251
+ /** `font-variant-numeric` — for tables/dashboards of numbers. */
252
+ export type NumericAlignment = 'inherit' | 'tabular' | 'lining';
253
+
254
+ /**
255
+ * Behavior when an INDIVIDUAL TOKEN (a single word, URL, file path, hex
256
+ * hash, dev-time i18n key, …) is wider than the surface it lives in.
257
+ *
258
+ * This is a DIFFERENT problem from `textTruncation` / `wrapStrategy`:
259
+ *
260
+ * - `wrapStrategy: 'wrap'` (CSS `text-wrap: wrap`) breaks text ONLY at
261
+ * natural word boundaries (spaces, hyphens). An unbreakable token has
262
+ * no boundary, so the browser lets it overflow the container.
263
+ * - `textTruncation: 'ellipsis-line'` / `'ellipsis-multiline:N'` clip
264
+ * text that exceeds N lines — but they require `overflow: hidden` on
265
+ * the container and assume the line itself FITS. A token wider than
266
+ * the container can't even produce one valid line to truncate.
267
+ * - `overlongTokenStrategy` covers the residual case: what to do when
268
+ * a SINGLE TOKEN can't fit. Three real options:
269
+ * - `'break-word'` — CSS `overflow-wrap: break-word`. Lets the
270
+ * browser break at character boundaries ONLY when a token would
271
+ * otherwise overflow, exactly like `'break-anywhere'` at render
272
+ * time — but soft-wrap opportunities are NOT considered when
273
+ * computing intrinsic (min-content) sizes. This is the framework
274
+ * default: it protects against URLs, dev-time i18n keys, file
275
+ * paths and hex strings WITHOUT shrinking a flex/grid item's
276
+ * min-content width to a single character.
277
+ * - `'break-anywhere'` — CSS `overflow-wrap: anywhere`. Same
278
+ * emergency character-boundary breaking, but the break
279
+ * opportunities ALSO feed min-content sizing: any surface under
280
+ * this value reports a one-character min-content width, so
281
+ * intrinsically-sized layouts (stat tiles, grid `auto` tracks,
282
+ * `min-width: min-content` flex items) collapse and render one
283
+ * letter per line. An earlier revision made this the default on
284
+ * the reasoning that "normal text is unaffected" — true for
285
+ * OVERFLOW behavior, false for INTRINSIC SIZING, which is why
286
+ * the default moved to `'break-word'`. Opt in per-surface only
287
+ * when unbroken user-generated strings must never dictate the
288
+ * measured width of an intrinsically-sized container.
289
+ * - `'overflow'` — CSS `overflow-wrap: normal`. The browser-default
290
+ * behavior: long tokens visibly overflow the container. Useful
291
+ * when the surface intentionally allows horizontal overflow
292
+ * (e.g., a code block that scrolls) or when the design
293
+ * specifically calls for the overflow to be visible.
294
+ *
295
+ * Default is `'break-word'` for every variant — same wrapping outcome
296
+ * as `'break-anywhere'` where a token genuinely overflows, with no
297
+ * min-content collapse. Surfaces opt into the other behaviors
298
+ * explicitly via `policyOverride={{ content: { overlongTokenStrategy:
299
+ * 'break-anywhere' | 'overflow' } }}`.
300
+ */
301
+ /**
302
+ * The named runtime source for the overlong-token vocabulary (see the JSDoc above for the full
303
+ * per-member semantics and the min-content-collapse history that fixed the default).
304
+ *
305
+ * A const object rather than a TypeScript enum, deliberately: surface authoring writes these as
306
+ * plain string literals throughout the preset layer (`policyOverride={{ content: {
307
+ * overlongTokenStrategy: 'break-anywhere' } }}`), and a nominal enum would refuse every one of
308
+ * those call sites. The derived type below keeps the union structural while this object gives the
309
+ * vocabulary one named home.
310
+ */
311
+ export const OverlongTokenStrategy = {
312
+ /** CSS `overflow-wrap: break-word` — emergency breaking without min-content collapse. The default. */
313
+ BREAK_WORD: 'break-word',
314
+ /** CSS `overflow-wrap: anywhere` — also feeds min-content sizing; opt-in per surface only. */
315
+ BREAK_ANYWHERE: 'break-anywhere',
316
+ /** CSS `overflow-wrap: normal` — long tokens visibly overflow (scrolling code blocks etc.). */
317
+ OVERFLOW: 'overflow',
318
+ /** Inherit the surrounding surface's strategy. */
319
+ INHERIT: 'inherit',
320
+ } as const;
321
+
322
+ export type OverlongTokenStrategy = (typeof OverlongTokenStrategy)[keyof typeof OverlongTokenStrategy];
323
+
324
+ export interface ContentPolicy {
325
+ textTruncation?: TextTruncationStrategy | PolicyReset;
326
+ wrapStrategy?: WrapStrategy | PolicyReset;
327
+ numericAlignment?: NumericAlignment | PolicyReset;
328
+ /** Auto-wire `TruncatedText` semantics so truncated text shows full value on hover. */
329
+ tooltipOnTruncate?: boolean | PolicyReset;
330
+ /**
331
+ * Safety net for unbreakable tokens wider than the surface (URLs,
332
+ * dev-time i18n keys, file paths, hex strings). Default
333
+ * `'break-word'` (emergency breaking without min-content collapse).
334
+ * See `OverlongTokenStrategy` JSDoc for the relationship with
335
+ * `wrapStrategy` and `textTruncation`, and for when
336
+ * `'break-anywhere'` is the right opt-in.
337
+ */
338
+ overlongTokenStrategy?: OverlongTokenStrategy | PolicyReset;
339
+ }
340
+
341
+ // --- Family D: Auto-render ---------------------------------------------------
342
+
343
+ export type AutoFieldChromeMode = 'stacked' | 'inline' | 'compact' | 'inherit';
344
+ /**
345
+ * Field label placement. `start` is logical inline-start and follows document
346
+ * direction.
347
+ */
348
+ export type AutoLabelPlacement = 'top' | 'start' | 'inline' | 'hidden';
349
+ export type AutoEmptyValue = 'em-dash' | 'placeholder' | 'hidden' | 'skeleton';
350
+ /**
351
+ * How a `ContentSectionContainer` frames each authored section.
352
+ * - `grouped` (modern default): eyebrow-labelled groups inside ONE surface,
353
+ * separated by `divide-y` — no bordered card per section. Applies to the
354
+ * stacked (inline / single-section) composition; other container modes
355
+ * (grid / tabs / …) treat it as `card-each`.
356
+ * - `card-each`: a bordered card per section.
357
+ * - `flat`: bare sections, no frame.
358
+ * - `separator-only`: bare sections with a bottom divider between them.
359
+ */
360
+ export type AutoSectionWrap = 'grouped' | 'card-each' | 'flat' | 'separator-only';
361
+ export type AutoFieldDensity = 'sm' | 'md' | 'inherit';
362
+ /** Where field validation errors render. */
363
+ export type AutoErrorPlacement =
364
+ | 'inline'
365
+ | 'summary-at-surface-top'
366
+ | 'inherit';
367
+
368
+ export interface AutoRenderPolicy {
369
+ autoFieldChrome?: AutoFieldChromeMode | PolicyReset;
370
+ autoLabelPlacement?: AutoLabelPlacement | PolicyReset;
371
+ autoEmptyValue?: AutoEmptyValue | PolicyReset;
372
+ autoSectionWrap?: AutoSectionWrap | PolicyReset;
373
+ autoFieldDensity?: AutoFieldDensity | PolicyReset;
374
+ autoErrorPlacement?: AutoErrorPlacement | PolicyReset;
375
+ }
376
+
377
+ // --- Family E: Interactive state --------------------------------------------
378
+
379
+ export type SelectableSemantics = 'wrap-children' | 'self-selectable' | 'forbidden';
380
+ export type GestureOptIn = 'self' | 'children' | 'none';
381
+ export type LoadingDisplayMode = 'overlay' | 'skeleton-children' | 'spinner-only' | 'inherit';
382
+ export type EmptyDisplayMode = 'collapse' | 'placeholder' | 'hide' | 'render-children';
383
+ export type ErrorBoundaryMode = 'self' | 'inherit';
384
+
385
+ export interface InteractiveStatePolicy {
386
+ selectableSemantics?: SelectableSemantics | PolicyReset;
387
+ gestureOptIn?: GestureOptIn | PolicyReset;
388
+ loadingDisplay?: LoadingDisplayMode | PolicyReset;
389
+ emptyDisplay?: EmptyDisplayMode | PolicyReset;
390
+ errorBoundary?: ErrorBoundaryMode | PolicyReset;
391
+ }
392
+
393
+ // --- Family F: A11y ----------------------------------------------------------
394
+
395
+ export type LandmarkRole =
396
+ | 'region'
397
+ | 'complementary'
398
+ | 'navigation'
399
+ | 'main'
400
+ | 'dialog'
401
+ | 'alertdialog'
402
+ | 'status'
403
+ | 'none';
404
+
405
+ export type LabelStrategy = 'from-header' | 'aria-label' | 'none';
406
+ export type FocusTrapMode = 'on-mount' | 'never' | 'when-modal';
407
+ export type ScrollContainmentMode = 'lock-body' | 'none';
408
+
409
+ export interface A11yPolicy {
410
+ /**
411
+ * Auto-applied `role` if no `role` prop supplied.
412
+ *
413
+ * `SurfaceVariant.SHELL` defaults to `'none'` so framework upgrades do not
414
+ * create duplicate page landmarks. Apps that want the shell to own the page
415
+ * landmark opt in with `surfacePolicies[SurfaceVariant.SHELL].a11y.landmarkRole = 'main'`.
416
+ */
417
+ landmarkRole?: LandmarkRole | PolicyReset;
418
+ /**
419
+ * Surface auto-derives `aria-labelledby` from `<Surface.Header>` slot.
420
+ * Fallback when `'from-header'` and no Header is present: → use explicit
421
+ * `aria-label` prop if provided → no labelling at all + development warning.
422
+ */
423
+ labelStrategy?: LabelStrategy | PolicyReset;
424
+ focusTrap?: FocusTrapMode | PolicyReset;
425
+ scrollContainment?: ScrollContainmentMode | PolicyReset;
426
+ }
427
+
428
+ // --- Family G: Geometry / responsive -----------------------------------------
429
+
430
+ /**
431
+ * Maximum inline-size a surface may occupy on viewports ≥ 640px (below that,
432
+ * surfaces are always full-width). Component-scale tiers (`sm`–`xl`) suit
433
+ * dialogs and forms; `centered-readable` (72ch) suits prose columns; `content`
434
+ * is the page-content cap for primary content areas (defaults to 80rem ≈ 1280px;
435
+ * retune by setting the `--content-max-width` CSS variable, or `full`/`none` to
436
+ * disable). When a finite tier is set the surface is also centered in its
437
+ * container (`margin-inline: auto`).
438
+ */
439
+ export type ResponsiveMaxWidth =
440
+ | 'full'
441
+ | 'sm'
442
+ | 'md'
443
+ | 'lg'
444
+ | 'xl'
445
+ // Reading-measure cap (~42rem) for single-column FORM / field stacks (T4c),
446
+ // so detail/settings forms stop stretching edge-to-edge inside a wide content
447
+ // zone. Wider than the component tiers (`sm`–`xl`, dialog-scale) but far tighter
448
+ // than `content`/`centered-readable`. Retune via `--measure-max-width`.
449
+ | 'measure'
450
+ | 'centered-readable'
451
+ | 'content'
452
+ | 'none';
453
+
454
+ export type MobileShape = 'inline' | 'drawer' | 'sheet';
455
+
456
+ export type ActionAlignment = 'row' | 'column-reverse-on-mobile' | 'stack' | 'inherit';
457
+
458
+ export interface GeometryPolicy {
459
+ responsiveMaxWidth?: ResponsiveMaxWidth | PolicyReset;
460
+ mobileShape?: MobileShape | PolicyReset;
461
+ /** Apply iOS safe-area / Android nav-bar padding to fixed-edge surfaces. */
462
+ safeAreaPadding?: boolean | PolicyReset;
463
+ actionAlignment?: ActionAlignment | PolicyReset;
464
+ }
465
+
466
+ // --- Family H: Stacking / portal ---------------------------------------------
467
+
468
+ /**
469
+ * Maps to the public `--z-*` token ladder.
470
+ * Replaces `z-50` literals + `z-[10000]` magic numbers.
471
+ *
472
+ * `'content'` → `--z-content` (alias of `--z-base`)
473
+ * `'overlay'` → `--z-overlay`
474
+ * `'transient'` → `--z-transient` (alias of `--z-toast`)
475
+ * `'guidance'` → `--z-guidance` (sits above transient and below critical)
476
+ * `'critical'` → `--z-critical` (alias of `--z-tooltip`)
477
+ *
478
+ * Token ladder ordering: content < overlay < transient < guidance < critical.
479
+ */
480
+ export type StackingTier = 'content' | 'overlay' | 'transient' | 'guidance' | 'critical';
481
+
482
+ /**
483
+ * Named portal target consumed by framework overlay primitives.
484
+ *
485
+ * `'inline'`: render in place (no portal).
486
+ * `'app-portal'`: the app's default portal target.
487
+ * `custom-id`: a lowercase kebab-case custom portal id that starts with a
488
+ * letter, such as `resource-overlay-root`. The runtime validator enforces the
489
+ * full `/^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/` shape.
490
+ */
491
+ type LowercaseAsciiLetter =
492
+ | 'a'
493
+ | 'b'
494
+ | 'c'
495
+ | 'd'
496
+ | 'e'
497
+ | 'f'
498
+ | 'g'
499
+ | 'h'
500
+ | 'i'
501
+ | 'j'
502
+ | 'k'
503
+ | 'l'
504
+ | 'm'
505
+ | 'n'
506
+ | 'o'
507
+ | 'p'
508
+ | 'q'
509
+ | 'r'
510
+ | 's'
511
+ | 't'
512
+ | 'u'
513
+ | 'v'
514
+ | 'w'
515
+ | 'x'
516
+ | 'y'
517
+ | 'z';
518
+ // Keep the authoring type intentionally light: full kebab-case validation lives
519
+ // in `isPortalTargetValue`, where parsed app configs are checked at runtime.
520
+ export type CustomPortalTarget = `${LowercaseAsciiLetter}${string}-${string}`;
521
+ export type PortalTarget = 'inline' | 'app-portal' | CustomPortalTarget;
522
+
523
+ export interface StackingPolicy {
524
+ stackingTier?: StackingTier | PolicyReset;
525
+ portalTarget?: PortalTarget | PolicyReset;
526
+ }
527
+
528
+ // --- Family I: Skeleton / loading shape -------------------------------------
529
+
530
+ export type SkeletonTemplate = 'list' | 'detail' | 'table' | 'card' | 'inherit' | 'none';
531
+ export type SkeletonDensity = 'sm' | 'md' | 'lg' | 'inherit';
532
+
533
+ export interface SkeletonPolicy {
534
+ skeletonTemplate?: SkeletonTemplate | PolicyReset;
535
+ /** Skeleton row size — can inherit from the nearest parent surface. */
536
+ skeletonDensity?: SkeletonDensity | PolicyReset;
537
+ }
538
+
539
+ // --- Family J: Composition awareness -----------------------------------------
540
+
541
+ export type EmbeddedTablePadding = 'strip' | 'preserve';
542
+
543
+ export interface CompositionPolicy {
544
+ /** Surface auto-tightens spacing when it contains a Table or DataGrid. */
545
+ childAdaptiveDensity?: boolean | PolicyReset;
546
+ /**
547
+ * Card-with-Table drops its own padding-inline so table can go edge-to-edge.
548
+ *
549
+ * `'strip'`: drop the inline padding.
550
+ * `'preserve'`: keep the inline padding (table sits inside the card box).
551
+ */
552
+ embeddedTablePadding?: EmbeddedTablePadding | PolicyReset;
553
+ /**
554
+ * Apply `[&:has([role=checkbox])]:pe-0` style behavior to first cell —
555
+ * declarative replacement for the `:has()` Tailwind utility currently
556
+ * used in `field.tsx`/`table.tsx`.
557
+ *
558
+ * `'inherit'`: nested tables share the "first cell is checkbox" assumption.
559
+ */
560
+ selectionColumnAware?: boolean | 'inherit' | PolicyReset;
561
+ }
562
+
563
+ // =============================================================================
564
+ // SurfacePolicy + DeepPartial
565
+ // =============================================================================
566
+
567
+ /**
568
+ * Container-level policy for a `SurfaceVariant`. Ten sparse sub-objects
569
+ * ("families") separate concerns so an app can override one slot of one family
570
+ * without touching siblings.
571
+ */
572
+ export interface SurfacePolicy {
573
+ containment?: ContainmentPolicy;
574
+ nesting?: NestingPolicy;
575
+ content?: ContentPolicy;
576
+ autoRender?: AutoRenderPolicy;
577
+ interactiveState?: InteractiveStatePolicy;
578
+ a11y?: A11yPolicy;
579
+ geometry?: GeometryPolicy;
580
+ stacking?: StackingPolicy;
581
+ skeleton?: SkeletonPolicy;
582
+ composition?: CompositionPolicy;
583
+ }
584
+
585
+ /**
586
+ * Per-family partial used for `designSystemConfig.surfacePolicies` overrides
587
+ * and for `<Surface policyOverride>`.
588
+ *
589
+ * Each policy family object is itself partial. Omitted families and omitted
590
+ * slots leave lower-precedence values in place. If a slot key is present with
591
+ * `undefined`, merge helpers treat that as an explicit clear for that leaf.
592
+ */
593
+ export type DeepPartialSurfacePolicy = {
594
+ [K in keyof SurfacePolicy]?: SurfacePolicy[K] extends infer Sub
595
+ ? Sub extends object
596
+ ? { [P in keyof Sub]?: Sub[P] }
597
+ : Sub
598
+ : never;
599
+ };
600
+ ```
601
+
602
+ ## Import Origins
603
+
604
+ - `@wildo-ai/presets-components-models`
605
+
606
+ ## Source Excerpts
607
+
608
+ ### Origin Package: `@wildo-ai/presets-components-models`
609
+
610
+ ```typescript
611
+ /**
612
+ * Framework default Surface Policy values and merge ladder.
613
+ *
614
+ * Import `FRAMEWORK_DEFAULT_SURFACE_POLICIES` from
615
+ * `@wildo-ai/presets-components-models` when tooling needs to inspect concrete
616
+ * per-variant defaults. App authors usually do not copy this map; they override
617
+ * specific slots via `designSystemConfig.surfacePolicies` or local
618
+ * `<Surface policyOverride={...}>`.
619
+ *
620
+ * Runtime merge order:
621
+ * 1. framework default,
622
+ * 2. theme recipe policy,
623
+ * 3. app design-system `surfacePolicies`,
624
+ * 4. local `<Surface policyOverride>`.
625
+ */
626
+ const BASE_DEFAULT_POLICY: SurfacePolicy = {
627
+ containment: {
628
+ paddingBlock: 'card',
629
+ paddingInline: 'none',
630
+ overflow: 'visible',
631
+ maxHeight: 'none',
632
+ gap: 'section',
633
+ },
634
+ nesting: {
635
+ framingMode: 'always',
636
+ nestedRadiusStrategy: 'one-tier-tighter',
637
+ firstChildEdgeStrategy: 'collapse',
638
+ dividerStrategy: 'gap',
639
+ },
640
+ content: {
641
+ textTruncation: 'none',
642
+ wrapStrategy: 'wrap',
643
+ numericAlignment: 'inherit',
644
+ tooltipOnTruncate: false,
645
+ overlongTokenStrategy: 'break-word',
646
+ },
647
+ autoRender: {
648
+ autoFieldChrome: 'stacked',
649
+ autoLabelPlacement: 'top',
650
+ autoEmptyValue: 'em-dash',
651
+ // Modern default (T3): authored sections render as eyebrow-labelled groups
652
+ // inside ONE surface with divide-y separators, instead of a bordered card
653
+ // per section (`card-each`). Surfaces that genuinely want a card per section
654
+ // opt back in via `surfacePolicies[variant].autoRender.autoSectionWrap`.
655
+ autoSectionWrap: 'grouped',
656
+ autoFieldDensity: 'md',
657
+ autoErrorPlacement: 'inline',
658
+ },
659
+ interactiveState: {
660
+ selectableSemantics: 'wrap-children',
661
+ gestureOptIn: 'self',
662
+ loadingDisplay: 'skeleton-children',
663
+ emptyDisplay: 'placeholder',
664
+ errorBoundary: 'inherit',
665
+ },
666
+ a11y: {
667
+ // BASE `landmarkRole` defaults to `'none'`. BASE is the engine's generic
668
+ // visual container — used by Card, ContentSectionContainer, Accordion,
669
+ // Alert, danger-zone, file-upload panels, AI artifact viewers, and many
670
+ // other compositions. The vast majority of these are presentational
671
+ // chrome, not semantic content regions, and the framework should not
672
+ // auto-promote them to landmarks.
673
+ //
674
+ // Per WAI-ARIA best practice and the engine's "keep landmark ownership
675
+ // explicit" design rule, authors opt INTO a region landmark when the
676
+ // surface actually represents a meaningful navigable content section,
677
+ // and they also provide a header (or `aria-label`) so the landmark
678
+ // resolves a label:
679
+ //
680
+ // <Card policyOverride={{ a11y: { landmarkRole: 'region' } }}>
681
+ // <CardHeader><CardTitle>...</CardTitle></CardHeader>
682
+ // ...
683
+ // </Card>
684
+ //
685
+ // Before this change, BASE defaulted to `'region'` + `labelStrategy:
686
+ // 'from-header'`, which produced an unlabelled `role="region"` (a real
687
+ // a11y bug — regions MUST have a label per ARIA) on every Card without
688
+ // an explicit `<CardHeader>`. The framework dev warning surfaced this
689
+ // but did not auto-correct, so the broken landmark shipped to prod.
690
+ landmarkRole: 'none',
691
+ labelStrategy: 'from-header',
692
+ focusTrap: 'never',
693
+ scrollContainment: 'none',
694
+ },
695
+ geometry: {
696
+ responsiveMaxWidth: 'none',
697
+ mobileShape: 'inline',
698
+ safeAreaPadding: false,
699
+ actionAlignment: 'row',
700
+ },
701
+ stacking: {
702
+ stackingTier: 'content',
703
+ portalTarget: 'inline',
704
+ },
705
+ skeleton: {
706
+ skeletonTemplate: 'card',
707
+ skeletonDensity: 'md',
708
+ },
709
+ composition: {
710
+ childAdaptiveDensity: true,
711
+ embeddedTablePadding: 'strip',
712
+ // BASE cards host arbitrary content; keep selection-column heuristics off
713
+ // unless a table-oriented surface explicitly opts in.
714
+ selectionColumnAware: false,
715
+ },
716
+ };
717
+
718
+ /**
719
+ * CARD shares BASE's policy surface: both are card-like content containers that
720
+ * always paint their own frame (`framingMode: 'always'`), carry `card` padding,
721
+ * and stay presentational (`landmarkRole: 'none'`). A content card differs from
722
+ * BASE only at the RECIPE layer (an explicit elevated fill + border), not in
723
+ * policy — so it binds the same defaults. Kept as a distinct name so the two
724
+ * can diverge later without touching the map or its consumers.
725
+ */
726
+ const CARD_DEFAULT_POLICY: SurfacePolicy = BASE_DEFAULT_POLICY;
727
+
728
+ const RAISED_DEFAULT_POLICY: SurfacePolicy = {
729
+ containment: {
730
+ paddingBlock: 'none',
731
+ paddingInline: 'none',
732
+ overflow: 'visible',
733
+ maxHeight: 'none',
734
+ gap: 'none',
735
+ },
736
+ nesting: {
737
+ framingMode: 'always',
738
+ nestedRadiusStrategy: 'one-tier-tighter',
739
+ firstChildEdgeStrategy: 'collapse',
740
+ dividerStrategy: 'gap',
741
+ },
742
+ content: {
743
+ textTruncation: 'none',
744
+ wrapStrategy: 'wrap',
745
+ numericAlignment: 'inherit',
746
+ tooltipOnTruncate: false,
747
+ overlongTokenStrategy: 'break-word',
748
+ },
749
+ autoRender: {
750
+ autoFieldChrome: 'stacked',
751
+ autoLabelPlacement: 'top',
752
+ autoEmptyValue: 'em-dash',
753
+ // Modern default (T3) — see BASE_DEFAULT_POLICY. Elevated card/dialog content
754
+ // groups sections inside one surface with divide-y instead of card-each.
755
+ autoSectionWrap: 'grouped',
756
+ autoFieldDensity: 'md',
757
+ autoErrorPlacement: 'inline',
758
+ },
759
+ interactiveState: {
760
+ selectableSemantics: 'wrap-children',
761
+ gestureOptIn: 'self',
762
+ loadingDisplay: 'skeleton-children',
763
+ emptyDisplay: 'placeholder',
764
+ errorBoundary: 'inherit',
765
+ },
766
+ a11y: {
767
+ landmarkRole: 'none',
768
+ labelStrategy: 'aria-label',
769
+ focusTrap: 'never',
770
+ scrollContainment: 'none',
771
+ },
772
+ geometry: {
773
+ responsiveMaxWidth: 'none',
774
+ mobileShape: 'inline',
775
+ safeAreaPadding: false,
776
+ actionAlignment: 'row',
777
+ },
778
+ stacking: {
779
+ stackingTier: 'overlay',
780
+ portalTarget: 'app-portal',
781
+ },
782
+ skeleton: {
783
+ skeletonTemplate: 'card',
784
+ skeletonDensity: 'md',
785
+ },
786
+ composition: {
787
+ childAdaptiveDensity: false,
788
+ embeddedTablePadding: 'preserve',
789
+ selectionColumnAware: false,
790
+ },
791
+ };
792
+
793
+ const OVERLAY_DEFAULT_POLICY: SurfacePolicy = {
794
+ containment: {
795
+ paddingBlock: 'container',
796
+ paddingInline: 'container',
797
+ // OVERLAY surfaces scroll internally once they exceed the viewport-safe
798
+ // modal height.
799
+ overflow: 'auto',
800
+ maxHeight: '90vh',
801
+ gap: 'field',
802
+ slotGap: { header: 'item' },
803
+ },
804
+ nesting: {
805
+ framingMode: 'always',
806
+ nestedRadiusStrategy: 'one-tier-tighter',
807
+ firstChildEdgeStrategy: 'collapse',
808
+ dividerStrategy: 'gap',
809
+ },
810
+ content: {
811
+ textTruncation: 'none',
812
+ wrapStrategy: 'wrap',
813
+ numericAlignment: 'inherit',
814
+ tooltipOnTruncate: false,
815
+ overlongTokenStrategy: 'break-word',
816
+ },
817
+ autoRender: {
818
+ autoFieldChrome: 'stacked',
819
+ autoLabelPlacement: 'top',
820
+ autoEmptyValue: 'em-dash',
821
+ // Overlay forms render generated sections flat inside the modal panel
822
+ // instead of nesting card panels in another overlay panel.
823
+ autoSectionWrap: 'flat',
824
+ autoFieldDensity: 'md',
825
+ autoErrorPlacement: 'inline',
826
+ },
827
+ interactiveState: {
828
+ selectableSemantics: 'forbidden',
829
+ gestureOptIn: 'none',
830
+ loadingDisplay: 'overlay',
831
+ emptyDisplay: 'placeholder',
832
+ errorBoundary: 'self',
833
+ },
834
+ a11y: {
835
+ landmarkRole: 'dialog',
836
+ labelStrategy: 'from-header',
837
+ focusTrap: 'when-modal',
838
+ scrollContainment: 'lock-body',
839
+ },
840
+ geometry: {
841
+ responsiveMaxWidth: 'lg',
842
+ // OverlayContainer resolves dialog overlays to Vaul Drawer on mobile and
843
+ // freezes the primitive for the current open session.
844
+ mobileShape: 'drawer',
845
+ safeAreaPadding: true,
846
+ actionAlignment: 'column-reverse-on-mobile',
847
+ },
848
+ stacking: {
849
+ stackingTier: 'overlay',
850
+ portalTarget: 'app-portal',
851
+ },
852
+ skeleton: {
853
+ skeletonTemplate: 'detail',
854
+ skeletonDensity: 'md',
855
+ },
856
+ composition: {
857
+ childAdaptiveDensity: false,
858
+ embeddedTablePadding: 'strip',
859
+ selectionColumnAware: true,
860
+ },
861
+ };
862
+
863
+ const INSET_DEFAULT_POLICY: SurfacePolicy = {
864
+ containment: {
865
+ paddingBlock: 'none',
866
+ paddingInline: 'none',
867
+ overflow: 'clip',
868
+ maxHeight: 'none',
869
+ gap: 'field',
870
+ },
871
+ nesting: {
872
+ framingMode: 'always',
873
+ nestedRadiusStrategy: 'one-tier-tighter',
874
+ firstChildEdgeStrategy: 'collapse',
875
+ dividerStrategy: 'border',
876
+ },
877
+ content: {
878
+ // INSET tables keep nowrap-compatible behavior until table rendering is
879
+ // migrated to policy-owned truncation.
880
+ textTruncation: 'none',
881
+ tooltipOnTruncate: false,
882
+ wrapStrategy: 'wrap',
883
+ numericAlignment: 'inherit',
884
+ },
885
+ autoRender: {
886
+ autoFieldChrome: 'stacked',
887
+ autoLabelPlacement: 'top',
888
+ autoEmptyValue: 'em-dash',
889
+ autoSectionWrap: 'card-each',
890
+ autoFieldDensity: 'md',
891
+ autoErrorPlacement: 'inline',
892
+ },
893
+ interactiveState: {
894
+ selectableSemantics: 'wrap-children',
895
+ gestureOptIn: 'self',
896
+ loadingDisplay: 'skeleton-children',
897
+ emptyDisplay: 'placeholder',
898
+ errorBoundary: 'inherit',
899
+ },
900
+ a11y: {
901
+ landmarkRole: 'none',
902
+ labelStrategy: 'aria-label',
903
+ focusTrap: 'never',
904
+ scrollContainment: 'none',
905
+ },
906
+ geometry: {
907
+ responsiveMaxWidth: 'none',
908
+ mobileShape: 'inline',
909
+ safeAreaPadding: false,
910
+ actionAlignment: 'row',
911
+ },
912
+ stacking: {
913
+ stackingTier: 'content',
914
+ portalTarget: 'inline',
915
+ },
916
+ skeleton: {
917
+ skeletonTemplate: 'card',
918
+ skeletonDensity: 'md',
919
+ },
920
+ composition: {
921
+ childAdaptiveDensity: true,
922
+ embeddedTablePadding: 'preserve',
923
+ selectionColumnAware: true,
924
+ },
925
+ };
926
+
927
+ const SUNKEN_DEFAULT_POLICY: SurfacePolicy = {
928
+ containment: {
929
+ paddingBlock: 'none',
930
+ paddingInline: 'none',
931
+ overflow: 'visible',
932
+ maxHeight: 'none',
933
+ gap: 'item',
934
+ },
935
+ nesting: {
936
+ framingMode: 'always',
937
+ nestedRadiusStrategy: 'one-tier-tighter',
938
+ firstChildEdgeStrategy: 'collapse',
939
+ dividerStrategy: 'gap',
940
+ },
941
+ content: {
942
+ textTruncation: 'none',
943
+ wrapStrategy: 'wrap',
944
+ numericAlignment: 'inherit',
945
+ tooltipOnTruncate: false,
946
+ overlongTokenStrategy: 'break-word',
947
+ },
948
+ autoRender: {
949
+ autoFieldChrome: 'compact',
950
+ autoLabelPlacement: 'top',
951
+ autoEmptyValue: 'hidden',
952
+ autoSectionWrap: 'card-each',
953
+ // Sunken/sidebar contexts compact auto-rendered fields by default.
954
+ autoFieldDensity: 'sm',
955
+ autoErrorPlacement: 'inline',
956
+ },
957
+ interactiveState: {
958
+ selectableSemantics: 'wrap-children',
959
+ gestureOptIn: 'self',
960
+ loadingDisplay: 'skeleton-children',
961
+ emptyDisplay: 'placeholder',
962
+ errorBoundary: 'inherit',
963
+ },
964
+ a11y: {
965
+ landmarkRole: 'complementary',
966
+ labelStrategy: 'aria-label',
967
+ focusTrap: 'never',
968
+ scrollContainment: 'none',
969
+ },
970
+ geometry: {
971
+ responsiveMaxWidth: 'none',
972
+ mobileShape: 'inline',
973
+ safeAreaPadding: false,
974
+ actionAlignment: 'row',
975
+ },
976
+ stacking: {
977
+ stackingTier: 'content',
978
+ portalTarget: 'inline',
979
+ },
980
+ skeleton: {
981
+ skeletonTemplate: 'list',
982
+ skeletonDensity: 'sm',
983
+ },
984
+ composition: {
985
+ childAdaptiveDensity: true,
986
+ embeddedTablePadding: 'preserve',
987
+ selectionColumnAware: true,
988
+ },
989
+ };
990
+
991
+ const TAB_PANEL_DEFAULT_POLICY: SurfacePolicy = {
992
+ containment: {
993
+ paddingBlock: 'card',
994
+ paddingInline: 'none',
995
+ overflow: 'visible',
996
+ maxHeight: 'none',
997
+ gap: 'section',
998
+ },
999
+ nesting: {
1000
+ // Tab panel joins seamlessly to the strip above; never renders its own frame.
1001
+ framingMode: 'never',
1002
+ nestedRadiusStrategy: 'inherit',
1003
+ firstChildEdgeStrategy: 'preserve',
1004
+ dividerStrategy: 'gap',
1005
+ },
1006
+ content: {
1007
+ textTruncation: 'none',
1008
+ wrapStrategy: 'wrap',
1009
+ numericAlignment: 'inherit',
1010
+ tooltipOnTruncate: false,
1011
+ overlongTokenStrategy: 'break-word',
1012
+ },
1013
+ autoRender: {
1014
+ autoFieldChrome: 'stacked',
1015
+ autoLabelPlacement: 'top',
1016
+ autoEmptyValue: 'em-dash',
1017
+ autoSectionWrap: 'separator-only',
1018
+ autoFieldDensity: 'md',
1019
+ autoErrorPlacement: 'inline',
1020
+ },
1021
+ interactiveState: {
1022
+ selectableSemantics: 'wrap-children',
1023
+ gestureOptIn: 'self',
1024
+ loadingDisplay: 'skeleton-children',
1025
+ emptyDisplay: 'placeholder',
1026
+ errorBoundary: 'inherit',
1027
+ },
1028
+ a11y: {
1029
+ landmarkRole: 'none',
1030
+ labelStrategy: 'from-header',
1031
+ focusTrap: 'never',
1032
+ scrollContainment: 'none',
1033
+ },
1034
+ geometry: {
1035
+ responsiveMaxWidth: 'none',
1036
+ mobileShape: 'inline',
1037
+ safeAreaPadding: false,
1038
+ actionAlignment: 'row',
1039
+ },
1040
+ stacking: {
1041
+ stackingTier: 'content',
1042
+ portalTarget: 'inline',
1043
+ },
1044
+ skeleton: {
1045
+ skeletonTemplate: 'card',
1046
+ skeletonDensity: 'md',
1047
+ },
1048
+ composition: {
1049
+ childAdaptiveDensity: true,
1050
+ embeddedTablePadding: 'strip',
1051
+ selectionColumnAware: true,
1052
+ },
1053
+ };
1054
+
1055
+ const SHELL_DEFAULT_POLICY: SurfacePolicy = {
1056
+ containment: {
1057
+ paddingBlock: 'none',
1058
+ paddingInline: 'none',
1059
+ overflow: 'visible',
1060
+ maxHeight: 'none',
1061
+ gap: 'lane',
1062
+ },
1063
+ nesting: {
1064
+ framingMode: 'never',
1065
+ nestedRadiusStrategy: 'inherit',
1066
+ firstChildEdgeStrategy: 'preserve',
1067
+ dividerStrategy: 'none',
1068
+ },
1069
+ content: {
1070
+ textTruncation: 'none',
1071
+ wrapStrategy: 'wrap',
1072
+ numericAlignment: 'inherit',
1073
+ tooltipOnTruncate: false,
1074
+ overlongTokenStrategy: 'break-word',
1075
+ },
1076
+ autoRender: {
1077
+ autoFieldChrome: 'stacked',
1078
+ autoLabelPlacement: 'top',
1079
+ autoEmptyValue: 'em-dash',
1080
+ autoSectionWrap: 'card-each',
1081
+ autoFieldDensity: 'md',
1082
+ autoErrorPlacement: 'inline',
1083
+ },
1084
+ interactiveState: {
1085
+ selectableSemantics: 'wrap-children',
1086
+ gestureOptIn: 'none',
1087
+ loadingDisplay: 'skeleton-children',
1088
+ emptyDisplay: 'placeholder',
1089
+ errorBoundary: 'self',
1090
+ },
1091
+ a11y: {
1092
+ // SHELL `landmarkRole` defaults to `'none'`. Apps opt in to a single
1093
+ // canonical main landmark so framework upgrades do not create duplicate
1094
+ // page landmarks. Per-app opt-in:
1095
+ // `surfacePolicies[SurfaceVariant.SHELL].a11y.landmarkRole = 'main'`
1096
+ landmarkRole: 'none',
1097
+ labelStrategy: 'from-header',
1098
+ focusTrap: 'never',
1099
+ scrollContainment: 'none',
1100
+ },
1101
+ geometry: {
1102
+ responsiveMaxWidth: 'centered-readable',
1103
+ mobileShape: 'inline',
1104
+ safeAreaPadding: true,
1105
+ actionAlignment: 'row',
1106
+ },
1107
+ stacking: {
1108
+ stackingTier: 'content',
1109
+ portalTarget: 'inline',
1110
+ },
1111
+ skeleton: {
1112
+ skeletonTemplate: 'card',
1113
+ skeletonDensity: 'md',
1114
+ },
1115
+ composition: {
1116
+ childAdaptiveDensity: true,
1117
+ embeddedTablePadding: 'strip',
1118
+ selectionColumnAware: true,
1119
+ },
1120
+ };
1121
+
1122
+ const TRANSIENT_DEFAULT_POLICY: SurfacePolicy = {
1123
+ containment: {
1124
+ paddingBlock: 'card-sm',
1125
+ paddingInline: 'card-sm',
1126
+ overflow: 'visible',
1127
+ maxHeight: 'none',
1128
+ gap: 'item',
1129
+ },
1130
+ nesting: {
1131
+ framingMode: 'always',
1132
+ nestedRadiusStrategy: 'fixed',
1133
+ firstChildEdgeStrategy: 'preserve',
1134
+ dividerStrategy: 'gap',
1135
+ },
1136
+ content: {
1137
+ textTruncation: 'ellipsis-multiline:2',
1138
+ wrapStrategy: 'wrap',
1139
+ numericAlignment: 'inherit',
1140
+ tooltipOnTruncate: true,
1141
+ overlongTokenStrategy: 'break-word',
1142
+ },
1143
+ autoRender: {
1144
+ autoFieldChrome: 'compact',
1145
+ autoLabelPlacement: 'inline',
1146
+ autoEmptyValue: 'hidden',
1147
+ autoSectionWrap: 'flat',
1148
+ autoFieldDensity: 'sm',
1149
+ autoErrorPlacement: 'summary-at-surface-top',
1150
+ },
1151
+ interactiveState: {
1152
+ selectableSemantics: 'forbidden',
1153
+ gestureOptIn: 'none',
1154
+ loadingDisplay: 'spinner-only',
1155
+ emptyDisplay: 'hide',
1156
+ errorBoundary: 'inherit',
1157
+ },
1158
+ a11y: {
1159
+ landmarkRole: 'status',
1160
+ labelStrategy: 'aria-label',
1161
+ focusTrap: 'never',
1162
+ scrollContainment: 'none',
1163
+ },
1164
+ geometry: {
1165
+ responsiveMaxWidth: 'sm',
1166
+ mobileShape: 'inline',
1167
+ safeAreaPadding: true,
1168
+ actionAlignment: 'row',
1169
+ },
1170
+ stacking: {
1171
+ stackingTier: 'transient',
1172
+ portalTarget: 'app-portal',
1173
+ },
1174
+ skeleton: {
1175
+ skeletonTemplate: 'none',
1176
+ skeletonDensity: 'sm',
1177
+ },
1178
+ composition: {
1179
+ childAdaptiveDensity: false,
1180
+ embeddedTablePadding: 'preserve',
1181
+ selectionColumnAware: false,
1182
+ },
1183
+ };
1184
+
1185
+ /**
1186
+ * Per-variant framework default policy. Theme-provided `policy` and app-config
1187
+ * overrides merge on top of these via the cascade ladder:
1188
+ *
1189
+ * 1. Framework default (this constant)
1190
+ * 2. Theme default `theme.surface[variant].policy`
1191
+ * 3. App configuration `designSystemConfig.surfacePolicies?.[variant]`
1192
+ * 4. Call-site override `<Surface policyOverride={...}>`
1193
+ *
1194
+ * Every policy family for every variant has a framework baseline. Some nested
1195
+ * optional fields remain sparse by design; `reset` returns to the framework
1196
+ * value where that slot exists.
1197
+ */
1198
+ export const FRAMEWORK_DEFAULT_SURFACE_POLICIES: Record<SurfaceVariant, SurfacePolicy> = {
1199
+ // Keys are the literal string values of the `SurfaceVariant` enum
1200
+ // (kept in sync via `Record<SurfaceVariant, …>` exhaustiveness — TS errors
1201
+ // here are the canary that the enum changed and this map must follow).
1202
+ base: BASE_DEFAULT_POLICY,
1203
+ card: CARD_DEFAULT_POLICY,
1204
+ raised: RAISED_DEFAULT_POLICY,
1205
+ overlay: OVERLAY_DEFAULT_POLICY,
1206
+ inset: INSET_DEFAULT_POLICY,
1207
+ sunken: SUNKEN_DEFAULT_POLICY,
1208
+ 'tab-panel': TAB_PANEL_DEFAULT_POLICY,
1209
+ shell: SHELL_DEFAULT_POLICY,
1210
+ transient: TRANSIENT_DEFAULT_POLICY,
1211
+ };
1212
+ ```