@wildo-ai/framework-knowledge 1.1.4 → 1.1.6

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 (1167) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  21. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  22. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  23. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  24. package/dist/esm/framework-knowledge.definitions.js +547 -17
  25. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  26. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  27. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  28. package/dist/esm/framework-knowledge.loader.js +47 -1
  29. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  30. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  31. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  32. package/dist/esm/index.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  34. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
  36. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +135 -0
  38. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
  40. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
  42. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +374 -11
  44. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +6 -4
  46. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
  48. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  52. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  54. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  55. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
  56. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  57. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  58. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  59. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
  60. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
  62. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  63. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
  64. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  65. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  66. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +18 -8
  68. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  70. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  71. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
  72. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  73. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
  74. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
  76. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +68 -0
  78. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  79. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
  80. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  81. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  82. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
  84. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  86. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  88. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -0
  90. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
  94. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
  96. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  98. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  99. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  100. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  101. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  102. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  103. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  104. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  105. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  106. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  107. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  108. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  109. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  110. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  111. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  112. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
  114. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  115. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
  116. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  118. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  120. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  122. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  123. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  124. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  125. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
  126. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  127. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
  128. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
  130. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
  132. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  134. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  135. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
  136. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +6 -4
  138. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
  140. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +193 -28
  142. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
  144. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +3 -2
  146. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
  148. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +183 -6
  150. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
  152. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  153. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
  154. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  155. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
  156. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +173 -0
  158. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  159. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
  160. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  161. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  162. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  163. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  164. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  165. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  166. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  167. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  168. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  169. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  170. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  171. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
  172. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  173. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  174. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  175. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
  176. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  177. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  178. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  179. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
  180. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  181. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  182. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  183. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
  184. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  185. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +33 -5
  186. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  187. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
  188. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  189. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
  190. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  191. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
  192. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  193. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  194. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  195. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  196. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  197. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
  198. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  199. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
  200. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  201. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
  202. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  203. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -5
  204. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  205. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +7 -6
  206. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  207. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +28 -19
  208. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  209. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  210. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  211. package/dist/knowledge/manifest.json +9 -8
  212. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  213. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
  214. package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
  215. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
  216. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
  219. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
  220. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  221. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  222. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
  223. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
  224. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
  225. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
  226. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
  227. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
  228. package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
  229. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
  230. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
  231. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
  232. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
  233. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
  234. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
  235. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
  236. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
  237. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
  238. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
  239. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  240. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  241. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
  242. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  243. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
  244. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
  245. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
  246. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  247. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
  248. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  249. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
  250. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  251. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  252. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  253. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  254. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  255. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  256. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
  257. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  258. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  259. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  260. package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
  261. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
  262. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  263. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  264. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
  267. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  268. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  269. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  270. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
  271. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
  272. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
  273. package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
  274. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
  275. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  276. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
  277. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  278. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  279. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
  280. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
  281. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  282. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
  283. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  284. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  285. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
  286. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
  287. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  288. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
  289. package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
  290. package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
  291. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  292. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
  293. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  294. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  295. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  296. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
  297. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  298. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
  299. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  300. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
  301. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  302. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  303. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
  304. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
  305. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  306. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  307. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  308. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
  309. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
  310. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
  311. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  312. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  313. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  314. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
  315. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
  316. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
  317. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  318. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  319. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
  320. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
  321. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
  322. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
  323. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  324. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  325. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  326. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  327. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  328. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  329. package/dist/knowledge/references/application-maturity.config.md +319 -0
  330. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  331. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  332. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  333. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  334. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  335. package/dist/knowledge/references/brand.asset.config.md +8 -16
  336. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  337. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  338. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  339. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  340. package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
  341. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  342. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  343. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/capability-composition.config.md +174 -0
  345. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  346. package/dist/knowledge/references/cli.market.utils.md +1 -0
  347. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  348. package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
  349. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  350. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  351. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  352. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  353. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  354. package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
  355. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  356. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  357. package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
  358. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  359. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  360. package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
  361. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  362. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  363. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  364. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  365. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  366. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  367. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  368. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  369. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  370. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  371. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
  372. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
  373. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  374. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  375. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  376. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  377. package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
  378. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  379. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  380. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  381. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  382. package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
  383. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  384. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  385. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  386. package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
  387. package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
  388. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  389. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
  390. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
  391. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  392. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
  393. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
  394. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  395. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  396. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
  397. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
  398. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  399. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  400. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  401. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  402. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  403. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  404. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  405. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  406. package/dist/knowledge/references/experience-plan.config.md +318 -0
  407. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
  408. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  409. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  410. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  411. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  412. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  413. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  414. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  415. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  416. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
  417. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  418. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  419. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  420. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  421. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  422. package/dist/knowledge/references/integration-plan.config.md +217 -0
  423. package/dist/knowledge/references/market.alternative.config.md +2 -2
  424. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  425. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  426. package/dist/knowledge/references/market.category.config.md +1 -1
  427. package/dist/knowledge/references/market.channel.config.md +4 -4
  428. package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
  429. package/dist/knowledge/references/market.gain.config.md +2 -2
  430. package/dist/knowledge/references/market.icp.config.md +3 -3
  431. package/dist/knowledge/references/market.job.config.md +2 -2
  432. package/dist/knowledge/references/market.message-template.config.md +3 -3
  433. package/dist/knowledge/references/market.objection.config.md +2 -2
  434. package/dist/knowledge/references/market.pain.config.md +2 -2
  435. package/dist/knowledge/references/market.persona.config.md +3 -3
  436. package/dist/knowledge/references/market.positioning.config.md +1 -1
  437. package/dist/knowledge/references/market.proof.config.md +2 -2
  438. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  439. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  440. package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
  441. package/dist/knowledge/references/market.trigger.config.md +2 -2
  442. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  443. package/dist/knowledge/references/placement-plan.config.md +375 -0
  444. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  445. package/dist/knowledge/references/platform.config.backing-services.md +15 -36
  446. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  447. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  448. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  449. package/dist/knowledge/references/platform.config.saas.md +261 -9
  450. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  451. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  452. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  453. package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
  454. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  455. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  456. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  457. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  458. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  459. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  460. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  461. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  462. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  463. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  464. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  465. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  466. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
  467. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  468. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  469. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  470. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
  471. package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
  472. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  473. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  479. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  480. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  481. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
  482. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  483. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  484. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  485. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  486. package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
  487. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  488. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  489. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  490. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  491. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  492. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  493. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  494. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  495. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  496. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  497. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  498. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  499. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
  500. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  501. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  502. package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
  503. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  504. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  505. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  506. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  507. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  508. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  509. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  510. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  511. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  513. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  514. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  515. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  516. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  517. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
  518. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  519. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  520. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
  521. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  522. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  523. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  524. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  525. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
  526. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
  527. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  528. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
  529. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  530. package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
  531. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  532. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  533. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  534. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  535. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  536. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  537. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  538. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  539. package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
  540. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  541. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  542. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
  543. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
  544. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  545. package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
  546. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  547. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
  548. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  549. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  550. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  551. package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
  552. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
  553. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  554. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  555. package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
  556. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  557. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  558. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  559. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  560. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  561. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  562. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  563. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  564. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  565. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  566. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  567. package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
  568. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  569. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  570. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  571. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  572. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  573. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  574. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  575. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  576. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  577. package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
  578. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
  579. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
  580. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
  581. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
  582. package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
  583. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
  584. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  585. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  586. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
  587. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  588. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  589. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  590. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  591. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  592. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  593. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  594. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  595. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  596. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  597. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  598. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  599. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  600. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  601. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  602. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  603. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  604. package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
  605. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  606. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  607. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
  608. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  609. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  610. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
  611. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  612. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  613. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  614. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  615. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
  616. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  617. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  618. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  619. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  620. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  621. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  622. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  623. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  624. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  625. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  626. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  627. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  628. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  629. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  630. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  631. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
  632. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
  633. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  634. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  635. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  636. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  637. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  638. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  639. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  640. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  641. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  642. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  643. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  644. package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
  645. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  646. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  647. package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
  648. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  649. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  650. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  651. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  652. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  653. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  654. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  655. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
  656. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
  657. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  658. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  659. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  660. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  661. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  662. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
  663. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  664. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  665. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
  666. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  667. package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
  668. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  669. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  670. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
  671. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
  672. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  673. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  674. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  675. package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
  676. package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
  677. package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
  678. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
  679. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  680. package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
  681. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  682. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  683. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  684. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  685. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  686. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  687. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  688. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  689. package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
  690. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  691. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  692. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  693. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  694. package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
  695. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  696. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  697. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  698. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  699. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  700. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  701. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  702. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  703. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  704. package/dist/knowledge/references/website-plan.config.md +238 -0
  705. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  706. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  707. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  708. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
  709. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
  710. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
  711. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  712. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  713. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  714. package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
  715. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
  716. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
  717. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  718. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  719. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  720. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  721. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
  722. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
  723. package/dist/knowledge/references/zod.factories.address.md +118 -0
  724. package/dist/knowledge/references/zod.factories.code.md +4 -2
  725. package/dist/knowledge/references/zod.factories.duration.md +6 -4
  726. package/dist/knowledge/references/zod.factories.money.md +5 -3
  727. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  728. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  729. package/dist/knowledge/registries/framework-topics.json +2602 -214
  730. package/dist/knowledge/registries/playbooks.json +468 -92
  731. package/dist/knowledge/registries/source-tags.json +6171 -1996
  732. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  733. package/dist/knowledge/rules/live-context-door.md +137 -0
  734. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  735. package/dist/knowledge/skills/INDEX.md +67 -29
  736. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  737. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  738. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  739. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  740. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  741. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  742. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  743. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  744. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  745. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
  746. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  747. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  748. package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
  749. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  750. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  751. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
  752. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
  753. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
  754. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
  755. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  756. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
  757. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  758. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  759. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  760. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
  761. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
  762. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  763. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  764. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
  765. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  766. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
  767. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  768. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  769. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  770. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
  771. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
  772. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
  773. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
  774. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  775. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  776. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  777. package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
  778. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
  779. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  780. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  781. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  782. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  783. package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
  784. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  785. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  786. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  787. package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
  788. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  789. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  790. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
  791. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
  792. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
  793. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
  794. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
  795. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  796. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  797. package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
  798. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
  799. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
  800. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  801. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
  802. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
  803. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  804. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
  805. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
  806. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  807. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  808. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  809. package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
  810. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  811. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  812. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  813. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  814. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
  815. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  816. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
  817. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  818. package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
  819. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
  820. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
  821. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
  822. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  823. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
  824. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  825. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
  826. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  827. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
  828. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
  829. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
  830. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  831. package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
  832. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  833. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
  834. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  835. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  836. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  837. package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
  838. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
  839. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  840. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  841. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  842. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  843. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
  844. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  845. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  846. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  847. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  848. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  849. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  850. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  851. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
  852. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
  853. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  854. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  855. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
  856. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
  857. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
  858. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
  859. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  860. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  861. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  862. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
  863. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  864. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
  865. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
  866. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  867. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  868. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  869. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  870. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
  871. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
  872. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  873. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
  874. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
  875. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
  876. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  877. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  878. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  879. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  880. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  881. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  882. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  883. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  884. package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
  885. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  886. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
  887. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  888. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  889. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  890. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  891. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  892. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  893. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  894. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  895. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  896. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  897. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
  898. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  899. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  900. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  901. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
  902. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
  903. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
  904. package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
  905. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  906. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  907. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  908. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  909. package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
  910. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
  911. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
  912. package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
  913. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
  914. package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
  915. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
  916. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
  917. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
  918. package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
  919. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  920. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  921. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
  922. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  923. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
  924. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  925. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
  926. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
  927. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
  928. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  929. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  930. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  931. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  932. package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
  933. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  934. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  935. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  936. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  937. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  938. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  939. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  940. package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
  941. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
  942. package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
  943. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
  944. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
  945. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  946. package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
  947. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  948. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  949. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  950. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  951. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  952. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  953. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  954. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  955. package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
  956. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  957. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  958. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  959. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  960. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  961. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  962. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  963. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  964. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  965. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
  966. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  967. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  968. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
  969. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  970. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  971. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  972. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  973. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  974. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
  975. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  976. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
  977. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  978. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
  979. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
  980. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  981. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
  982. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
  983. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  984. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  985. package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
  986. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  987. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
  988. package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
  989. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
  990. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  991. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  992. package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
  993. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
  994. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
  995. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
  996. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
  997. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
  998. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  999. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  1000. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  1001. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
  1002. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  1003. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
  1004. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  1005. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
  1006. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  1007. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
  1008. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
  1009. package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
  1010. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
  1011. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  1012. package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
  1013. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  1014. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  1015. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  1016. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
  1017. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
  1018. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
  1019. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  1020. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  1021. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  1022. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  1023. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  1024. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  1025. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  1026. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  1027. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  1028. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  1029. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
  1030. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  1031. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  1032. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  1033. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
  1034. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
  1035. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  1036. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  1037. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  1038. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  1039. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  1040. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  1041. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  1042. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  1043. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  1044. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
  1045. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  1046. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  1047. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  1048. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  1049. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
  1050. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
  1051. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  1052. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  1053. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
  1054. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
  1055. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  1056. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
  1057. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  1058. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  1059. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  1060. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  1061. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
  1062. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
  1063. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
  1064. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
  1065. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
  1066. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  1067. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  1068. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
  1069. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
  1070. package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
  1071. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  1072. package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
  1073. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  1074. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  1075. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  1076. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  1077. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  1078. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  1079. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  1080. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  1081. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  1082. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
  1083. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
  1084. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  1085. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  1086. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  1087. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
  1088. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
  1089. package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
  1090. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  1091. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  1092. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  1093. package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
  1094. package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
  1095. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  1096. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
  1097. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  1098. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  1099. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  1100. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
  1101. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  1102. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1103. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  1104. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
  1105. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  1106. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
  1107. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  1108. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  1109. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
  1110. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  1111. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  1112. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
  1113. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  1114. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
  1115. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
  1116. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
  1117. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
  1118. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  1119. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
  1120. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  1121. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  1122. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
  1123. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
  1124. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
  1125. package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
  1126. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  1127. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  1128. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  1129. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  1130. package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
  1131. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
  1132. package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
  1133. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
  1134. package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
  1135. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
  1136. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
  1137. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
  1138. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
  1139. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
  1140. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
  1141. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
  1142. package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
  1143. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
  1144. package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
  1145. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
  1146. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  1147. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
  1148. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
  1149. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  1150. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  1151. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
  1152. package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
  1153. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  1154. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  1155. package/dist/knowledge/topic-index.json +12659 -4142
  1156. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1157. package/dist/tsconfig.tsbuildinfo +1 -1
  1158. package/package.json +4 -4
  1159. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  1160. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  1161. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
  1162. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
  1163. package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
  1164. package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
  1165. package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
  1166. package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
  1167. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -0,0 +1,3988 @@
1
+ # Framework component usage — props, composition, snippets
2
+
3
+ The authoring detail for the components in `framework-component-catalog.md`.
4
+ Only a component that has something beyond its catalog row appears here: a prop
5
+ worth naming, a composition rule, or a worked snippet.
6
+
7
+ Two things hold for every entry and are therefore stated once, here, rather than
8
+ repeated on each component:
9
+
10
+ - **A prop marked `**Enum**` does not take a string.** Most of the enumerated
11
+ props below are backed by a TypeScript enum, so `variant="destructive"` is a
12
+ type error while the enum member is not. Import the named enum from the
13
+ package the bullet gives and pass a member; the compiler will pick it for you
14
+ once the enum is in scope. Only a prop whose values are listed WITHOUT an
15
+ `**Enum**` marker accepts the literal.
16
+ - **`preset`** — every component takes it, and you almost never pass it. It
17
+ selects which registered preset renders, and omitting it gives you the
18
+ application's configured default. Pass it only when a named alternative is
19
+ registered and this call site needs that one — the framework itself ships a
20
+ few, and an application may add its own (`engine-component-registration`).
21
+ - **`className`** — where a component accepts it, use it for a narrow local
22
+ tweak (a width, a gap). It is not the place to restate colour, elevation,
23
+ radius or typography: those come from the design system, and a component that
24
+ looks wrong with its own styling is a design-token change
25
+ (`config-design-system`), not a utility-class override.
26
+
27
+ ## `Accordion`
28
+
29
+ Expand/collapse sections with one or many open items (FAQ, settings groups, nested forms).
30
+
31
+ **Props**
32
+
33
+ - `type` **(required)** — Whether one section or many may be open at once (discriminant for `AccordionProps` union). **Enum** `ToggleGroupType` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `single` · `multiple`.
34
+ - `type` values note: A TypeScript enum, so the literal `"single"` is not assignable — pass `ToggleGroupType.SINGLE`.
35
+ - `single` — At most one item open; optional `collapsible` to allow all closed.
36
+ - `multiple` — Independent open state per item.
37
+ - `orientation` — Layout axis for the accordion stack. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `vertical` · `horizontal`.
38
+ - `vertical` — Default stacked sections.
39
+ - `horizontal` — Horizontal accordion when supported by implementation.
40
+
41
+ **Composition**
42
+
43
+ - `AccordionItem`, `AccordionTrigger`, and `AccordionContent` resolve through the same preset as the root.
44
+ - `AccordionProps` is a discriminated union on `type: ToggleGroupType` (single vs multiple selection).
45
+
46
+ **Single-open FAQ**
47
+
48
+ ```tsx
49
+ import { Accordion, AccordionItem, AccordionTrigger, AccordionContent, ToggleGroupType } from '@wildo-ai/saas-frontend-lib';
50
+
51
+ <Accordion type={ToggleGroupType.SINGLE} collapsible defaultValue="item-1">
52
+ <AccordionItem value="item-1">
53
+ <AccordionTrigger>Question</AccordionTrigger>
54
+ <AccordionContent>Answer</AccordionContent>
55
+ </AccordionItem>
56
+ </Accordion>
57
+ ```
58
+
59
+ ## `ActionBar`
60
+
61
+ Group multiple row- or toolbar-level actions with overflow handling, separators, and optional sub-menus.
62
+
63
+ **Props**
64
+
65
+ - `items` **(required)** — Declarative list of buttons, separators, and sub-groups that make up the toolbar. Array of `ActionBarItem`.
66
+ - `maxDisplayed` — Maximum directly visible actions before remaining items move to the overflow menu. Type: `number`.
67
+ - `maxDisplayed` note: When omitted, all items render inline (no overflow) unless the caller passes an explicit limit.
68
+ - `size` — Icon button size for action entries in the bar. **Enum** `ButtonSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `icon-sm` · `icon`.
69
+ - `icon-sm` — Default compact toolbar buttons.
70
+ - `icon` — Larger hit targets when density allows.
71
+ - `labelDisplayMode` — How the bar renders action labels. When omitted, falls back to the app-wide default (`ComponentStyleTheme.actionLabelDisplayMode` via `useUI()`). `INLINE` renders label text inside each button; `TOOLTIP` keeps buttons icon-only with tooltip labels; `DROPDOWN` collapses every action into the overflow `…` menu (icon + label per row). **Enum** `ActionLabelDisplayMode` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `TOOLTIP` · `INLINE` · `DROPDOWN`.
72
+ - `labelDisplayMode` values note: Omitting the prop inherits the app policy; resource views may override it via `layout.actionLabelDisplayMode`.
73
+ - `TOOLTIP` — Icon-only buttons with tooltip labels.
74
+ - `INLINE` — Label text rendered inside each button.
75
+ - `DROPDOWN` — All actions collapse into the overflow menu (icon + label rows).
76
+ - `orientation` — Lays the actions out as a horizontal row (default) or a vertical stack. Drives the toolbar flex direction, `aria-orientation`, the inter-item separator axis, and the arrow-key navigation axis. Used e.g. by a resource card whose `cardActionPlacement.orientation` is VERTICAL. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `HORIZONTAL` · `VERTICAL`.
77
+ - `HORIZONTAL` — Buttons in a row (default).
78
+ - `VERTICAL` — Buttons stacked vertically.
79
+ - `aria-label` — Accessible name for the toolbar region. Type: `string`.
80
+
81
+ **Composition**
82
+
83
+ - Composes `ActionButton`, dropdown primitives, and separators; overflow items reuse the same action metadata as visible items.
84
+ - Provide a meaningful `aria-label` on the toolbar when the visible actions do not fully describe the toolbar purpose.
85
+
86
+ **Row actions with overflow**
87
+
88
+ Limit visible icons and push the rest into the overflow menu.
89
+
90
+ ```tsx
91
+ import { ActionBar } from '@wildo-ai/saas-frontend-lib';
92
+
93
+ <ActionBar
94
+ aria-label="Row actions"
95
+ maxDisplayed={3}
96
+ items={rowActionItems}
97
+ />
98
+ ```
99
+
100
+ ## `ActionButton`
101
+
102
+ Provide a compact, icon-first action affordance whose label renders inline or as a tooltip (per `labelDisplayMode`) for dense UI surfaces.
103
+
104
+ **Props**
105
+
106
+ - `icon` — Primary visual affordance for the action (required).
107
+ - `label` — Accessible name and optional inline label text (required). Type: `string`.
108
+ - `variant` — Semantic visual treatment while preserving the action role. **Enum** `ButtonVariants_Variant` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `ghost` · `default` · `destructive` · `outline` · `secondary` · `link` · `accent`.
109
+ - `ghost` — Default for dense toolbars — minimal chrome.
110
+ - `default` — Standard filled emphasis when the action should read as primary in-context.
111
+ - `destructive` — Dangerous or irreversible actions.
112
+ - `outline` — Secondary bordered emphasis.
113
+ - `secondary` — Lower-emphasis standard action.
114
+ - `link` — Text-link styling while retaining button semantics.
115
+ - `accent` — Strong accent emphasis for highlighted actions.
116
+ - `size` — Footprint for icon-only vs slightly larger hit targets. **Enum** `ButtonSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `icon-sm` · `icon`.
117
+ - `icon-sm` — Default compact icon button.
118
+ - `icon` — Larger square icon button.
119
+ - `labelDisplayMode` — How the label renders: `INLINE` shows it as text beside the icon; otherwise (default) the button is icon-only with the label in a tooltip. `DROPDOWN` is resolved by `ActionBar` (not this button), so here it behaves like `TOOLTIP`. **Enum** `ActionLabelDisplayMode` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `TOOLTIP` · `INLINE` · `DROPDOWN`. Default `TOOLTIP`.
120
+ - `TOOLTIP` — Icon-only button; label shown in a hover/focus tooltip (default).
121
+ - `INLINE` — Label rendered as text next to the icon inside the button.
122
+ - `DROPDOWN` — App-policy handled by ActionBar; at the button level degrades to TOOLTIP.
123
+ - `stopPropagation` — When true, stops click propagation (safe inside clickable containers). Type: `boolean`. Default `true`.
124
+ - `disabled` — Disables interaction and dims the control. Type: `boolean`. Default `false`.
125
+ - `operationIdentifier` — Optional operation id stamped as `data-operation-id` on the rendered button — the i18n-independent automation hook for tests and tooling (labels are runtime-translated). Attribute only; never drives behavior. Type: `string`.
126
+
127
+ **Composition**
128
+
129
+ - Wraps `Button`, `Tooltip`, and related primitives from `@wildo-ai/saas-frontend-lib`; resolved through the default-presets registry.
130
+ - Event propagation is stopped by default (`stopPropagation`); this is intentional for use inside clickable rows.
131
+
132
+ **Icon-only row action**
133
+
134
+ Typical table row affordance with tooltip from label.
135
+
136
+ ```tsx
137
+ import { ActionButton } from '@wildo-ai/saas-frontend-lib';
138
+ import { ButtonVariants_Variant } from '@wildo-ai/saas-frontend-lib';
139
+
140
+ <ActionButton
141
+ icon={<TrashIcon />}
142
+ label="Delete row"
143
+ variant={ButtonVariants_Variant.GHOST}
144
+ onClick={handleDelete}
145
+ />
146
+ ```
147
+
148
+ ## `AI_AgentCapabilities`
149
+
150
+ Enumerates tools, data access, and guardrails for an agent.
151
+
152
+ **Composition**
153
+
154
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
155
+
156
+ ## `AI_AgentCard`
157
+
158
+ Card summarizing one agent’s role, model, and capabilities.
159
+
160
+ **Composition**
161
+
162
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
163
+
164
+ ## `AI_AgentList`
165
+
166
+ Lists configured agents with selection and status metadata.
167
+
168
+ **Composition**
169
+
170
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
171
+
172
+ ## `AI_AgentPromptSpec`
173
+
174
+ Displays and edits the system/developer prompt spec for an agent.
175
+
176
+ **Composition**
177
+
178
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
179
+
180
+ ## `AI_ApprovalQueue`
181
+
182
+ Queue of pending approvals with per-item metadata; each item may offer the argument editor (`allowArgumentModification`) and a reason picker (`reasonCodeOptions`) for a reviewer correcting the proposal.
183
+
184
+ **Composition**
185
+
186
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
187
+
188
+ ## `AI_ApprovalRequest`
189
+
190
+ Single approval card prompting approve/deny, with an optional argument editor and, when `reasonCodeOptions` are given, an optional reason picker offered only while the approver corrects the proposal (edits it or rejects it).
191
+
192
+ **Composition**
193
+
194
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
195
+
196
+ ## `AI_Artifact`
197
+
198
+ Rich artifact shell (header, body, actions) for model-produced files and previews.
199
+
200
+ **Composition**
201
+
202
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
203
+
204
+ ## `AI_ArtifactList`
205
+
206
+ Browseable list of artifacts with typed previews (text, file, structured).
207
+
208
+ **Composition**
209
+
210
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
211
+
212
+ ## `AI_Canvas`
213
+
214
+ React Flow canvas hosting agent graphs with project defaults.
215
+
216
+ **Composition**
217
+
218
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
219
+
220
+ ## `AI_ChainOfThought`
221
+
222
+ Collapsible chain-of-thought disclosure with steps and optional media.
223
+
224
+ **Composition**
225
+
226
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
227
+
228
+ ## `AI_Checkpoint`
229
+
230
+ Timeline checkpoint marker with tooltip trigger.
231
+
232
+ **Composition**
233
+
234
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
235
+
236
+ ## `AI_CodeBlock`
237
+
238
+ Syntax-highlighted code block with optional line numbers and copy affordance.
239
+
240
+ **Composition**
241
+
242
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
243
+
244
+ ## `AI_Confirmation`
245
+
246
+ Tool-call confirmation surface extending alert styling with approval state.
247
+
248
+ **Composition**
249
+
250
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
251
+
252
+ ## `AI_Connection`
253
+
254
+ Straight connector line between ports with optional status styling.
255
+
256
+ **Composition**
257
+
258
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
259
+
260
+ ## `AI_Context`
261
+
262
+ Token usage and model context hover card for assistant runs.
263
+
264
+ **Composition**
265
+
266
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
267
+
268
+ ## `AI_Controls`
269
+
270
+ Zoom/fit/minimap controls for React Flow canvases.
271
+
272
+ **Composition**
273
+
274
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
275
+
276
+ ## `AI_Conversation`
277
+
278
+ Scroll-managed conversation viewport with empty state and scroll-to-latest control.
279
+
280
+ **Composition**
281
+
282
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
283
+
284
+ ## `AI_DecisionRequest`
285
+
286
+ Presents discrete decision options for the user to pick from.
287
+
288
+ **Composition**
289
+
290
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
291
+
292
+ ## `AI_DiffBlock`
293
+
294
+ A change viewer: takes the unified diff a producer already emits, one text per file, and renders files on one side, hunks on the other, line numbers on both sides, added and removed lines tinted through the theme, syntax colour from the file's extension, a copy of the whole diff and a slot for the consumer's action.
295
+
296
+ **Composition**
297
+
298
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
299
+
300
+ ## `AI_Edge`
301
+
302
+ Bezier edge representation with source/target handles for React Flow.
303
+
304
+ **Composition**
305
+
306
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
307
+
308
+ ## `AI_HumanInputRequest`
309
+
310
+ Collects open-ended human input required to continue a run.
311
+
312
+ **Composition**
313
+
314
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
315
+
316
+ ## `AI_Image`
317
+
318
+ Renders AI SDK generated images with alt text and layout hooks.
319
+
320
+ **Composition**
321
+
322
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
323
+
324
+ ## `AI_InlineCitation`
325
+
326
+ Inline citation badge opening a hover card with quotes and sources.
327
+
328
+ **Composition**
329
+
330
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
331
+
332
+ ## `AI_Loader`
333
+
334
+ Lightweight spinner/loader for AI streaming gaps.
335
+
336
+ **Composition**
337
+
338
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
339
+
340
+ ## `AI_Message`
341
+
342
+ Chat message bubble with branches, attachments, toolbar actions, and streamed markdown body.
343
+
344
+ **Composition**
345
+
346
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
347
+
348
+ ## `AI_ModelSelector`
349
+
350
+ Command-dialog model picker with search and keyboard selection.
351
+
352
+ **Composition**
353
+
354
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
355
+
356
+ ## `AI_Node`
357
+
358
+ Card-styled graph node with handle visibility for inputs/outputs.
359
+
360
+ **Composition**
361
+
362
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
363
+
364
+ ## `AI_OpenInChat`
365
+
366
+ Dropdown of external assistants to open the current query.
367
+
368
+ **Composition**
369
+
370
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
371
+ - Default preset implementation export is `AI_OpenInChatGPT` while the consumer wrapper is `AI_OpenInChat` — both align to `FrontendComponentType.LOW_LEVEL_AI_OPEN_IN_CHAT` (D1).
372
+
373
+ ## `AI_Panel`
374
+
375
+ Auxiliary graph panel host for inspectors or palettes.
376
+
377
+ **Composition**
378
+
379
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
380
+
381
+ ## `AI_Plan`
382
+
383
+ Collapsible plan card summarizing steps and progress.
384
+
385
+ **Composition**
386
+
387
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
388
+
389
+ ## `AI_PromptInput`
390
+
391
+ Full composer: attachments, model tabs, speech, slash commands, and submit.
392
+
393
+ **Composition**
394
+
395
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
396
+
397
+ ## `AI_Queue`
398
+
399
+ Todo and message queue with collapsible sections and per-item actions.
400
+
401
+ **Composition**
402
+
403
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
404
+
405
+ ## `AI_Reasoning`
406
+
407
+ Collapsible reasoning block for extended model rationale.
408
+
409
+ **Composition**
410
+
411
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
412
+
413
+ ## `AI_Shimmer`
414
+
415
+ Text shimmer animation for placeholders and progressive disclosure.
416
+
417
+ **Composition**
418
+
419
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
420
+
421
+ ## `AI_Sources`
422
+
423
+ Collapsible sources tray listing citations backing a reply.
424
+
425
+ **Composition**
426
+
427
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
428
+
429
+ ## `AI_Suggestion`
430
+
431
+ Single suggested follow-up prompt as a button.
432
+
433
+ **Composition**
434
+
435
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
436
+
437
+ ## `AI_Suggestions`
438
+
439
+ Scrollable list container for multiple `AI_Suggestion` chips.
440
+
441
+ **Composition**
442
+
443
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
444
+
445
+ ## `AI_Task`
446
+
447
+ Collapsible task unit with items and file attachments.
448
+
449
+ **Composition**
450
+
451
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
452
+
453
+ ## `AI_Tool`
454
+
455
+ Tool invocation inspector with input/output streaming states.
456
+
457
+ **Composition**
458
+
459
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
460
+
461
+ ## `AI_Toolbar`
462
+
463
+ Horizontal toolbar strip for graph editing actions.
464
+
465
+ **Composition**
466
+
467
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
468
+
469
+ ## `AI_WebPreview`
470
+
471
+ Mini browser chrome with URL bar, navigation, and iframe preview.
472
+
473
+ **Composition**
474
+
475
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
476
+
477
+ ## `Alert`
478
+
479
+ Inline status callout with title and description slots for non-blocking messages.
480
+
481
+ **Composition**
482
+
483
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
484
+
485
+ ## `AlertDialog`
486
+
487
+ Modal dialog that traps focus for destructive or irreversible confirmations.
488
+
489
+ **Composition**
490
+
491
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
492
+
493
+ ## `AppCelebrationOverlay`
494
+
495
+ Celebration surface for successful flows — confetti, overlay messaging, and optional next-step CTA.
496
+
497
+ **Props**
498
+
499
+ - `isActive` **(required)** — Controls visibility of the celebration treatment. Type: `boolean`.
500
+ - `heading` — Visible heading above the message and the dialog's accessible name. For a milestone it is the milestone's own title; when absent, `ariaLabel` names the dialog for assistive technology only. Type: `string`.
501
+ - `message` — The celebration text, shown under the heading and wired as the dialog description. Type: `string`.
502
+
503
+ **Composition**
504
+
505
+ - Application shells typically mount `AppCelebrationOverlay`, which wires notification state into `CelebrationOverlayProps`. Direct use of the preset expects those props explicitly.
506
+ - A milestone celebration takes its words from the milestone's own labels — `milestones.<ref>.title` as the heading and `milestones.<ref>.reward.message` as the message — which the labelling pipeline generates for every declared milestone. Author a milestone's wording there; there is no separate notification label for it.
507
+
508
+ **Shell integration**
509
+
510
+ ```tsx
511
+ import { AppCelebrationOverlay } from '@wildo-ai/saas-frontend-lib';
512
+
513
+ <AppCelebrationOverlay />
514
+ ```
515
+
516
+ ## `AppLayout_ConsentGate`
517
+
518
+ Where a signed-in person grants consent purposes: enforces `compliance.serviceConsentRequirement` before any signed-in route renders, and asks once about the optional purposes the application processes on consent.
519
+
520
+ **Composition**
521
+
522
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
523
+
524
+ ## `AppLayout_DocumentAcceptanceGate`
525
+
526
+ Where a signed-in person accepts the governed documents the application requires — when they never have (a sign-up through a form that accepted nothing) or when a release changed a document materially since they did.
527
+
528
+ **Composition**
529
+
530
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
531
+
532
+ ## `AppLayout_ErrorBoundary`
533
+
534
+ Full-screen error fallback for React error boundaries with recovery actions and optional dev diagnostics.
535
+
536
+ **Composition**
537
+
538
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
539
+
540
+ ## `AppLayout_Home`
541
+
542
+ Signed-in home surface that switches lifecycle stages (activation progress, welcome-back, dashboard).
543
+
544
+ **Composition**
545
+
546
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
547
+
548
+ ## `AppLayout_MainContainer`
549
+
550
+ Authenticated application shell main container composing app-level chrome, portal targets, and outlet content.
551
+
552
+ **Composition**
553
+
554
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
555
+
556
+ ## `AppLayout_RouterErrorBoundary`
557
+
558
+ Route-aware and JS error surface with HTTP status messaging, configurable error-page actions, and dev stacks.
559
+
560
+ **Composition**
561
+
562
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
563
+
564
+ ## `ApplicationLevel_ActivityBar`
565
+
566
+ Vertical or horizontal mode selector that lists configured app modes as icon tiles.
567
+
568
+ **Composition**
569
+
570
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
571
+
572
+ ## `ApplicationLevel_CommandMenu`
573
+
574
+ Global SEARCH palette (records AND commands) with hotkey support, placement relative to shell regions, and open-state wiring. User-facing copy is broad search framing ("Search…"), not command-only, because the palette also searches live records. When hosted (menubar and/or sidebar via `hostedComponents`), it renders an input-like TRIGGER ("false button" with a search placeholder + `⌘K` hint) whose width is set per placement via `triggerWidth`, collapsing to a compact icon-only trigger on a mobile viewport or a collapsed sidebar rail; a single shell-level interaction owner keeps ONE dialog + ONE hotkey registration even when the trigger appears in both surfaces. The overlay is RESPONSIVE: a width-capped centered dialog on desktop (`dialogWidth`, a `sm:`-prefixed max-width class, default `sm:max-w-2xl`) and a bottom DRAWER ("bottom drop-down") on mobile, resolved through the shared overlay mode-resolution seam. Under `CommandBarPolicy.OMNIBOX` it runs live, debounced record search over the app-declared `searchResources`, rendering each match as the resource's summary card (per-resource `resultDisplay`, default SUMMARY) and letting users jump directly to its READ view. Record and command groups render as ONE ordered list sorted by a single numeric `order` weight — record results default ABOVE the static command categories while searching (overridable per record group via `searchResources[].order`; command categories sequence among themselves via `categoryOrder`).
575
+
576
+ **Composition**
577
+
578
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
579
+
580
+ ## `ApplicationLevel_ControlPanel`
581
+
582
+ Collapsible utility rail hosting filters, inspectors, or contextual tools.
583
+
584
+ **Composition**
585
+
586
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
587
+
588
+ ## `ApplicationLevel_MenuBar`
589
+
590
+ Application shell menubar with fixed vs overlay presentation modes.
591
+
592
+ **Composition**
593
+
594
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
595
+
596
+ ## `ApplicationLevel_MenuUserOrg`
597
+
598
+ User + organization account menu with profile, billing, and sign-out affordances.
599
+
600
+ **Composition**
601
+
602
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
603
+ - D1 alignment: enum `APPLICATION_LEVEL_USER_DROPDOWN` pairs with the `ApplicationLevel_MenuUserOrg` consumer export and `ApplicationLevelPreset_MenuUserOrg_Default` preset implementation.
604
+
605
+ ## `ApplicationLevel_NavigationBack`
606
+
607
+ Header back affordance that navigates to the parent resource or route; in an adjacent zone (a hosted pane) holding a single entry it closes the pane, since walking back from nothing beneath is how the controller closes a zone.
608
+
609
+ **Composition**
610
+
611
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
612
+
613
+ ## `ApplicationLevel_NotificationCenter`
614
+
615
+ Shell notification hub with placement, optional hotkeys, and controlled open state.
616
+
617
+ **Composition**
618
+
619
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
620
+ - Runtime registry maps `APPLICATION_LEVEL_NOTIFICATION_CENTER` to the app-level preset; the older low-level feedback component is no longer registered on this enum (see `register-default-presets.ts` comment).
621
+
622
+ ## `ApplicationLevel_QuickActionButton`
623
+
624
+ Floating or docked primary action entry point for create / assist workflows.
625
+
626
+ **Composition**
627
+
628
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
629
+
630
+ ## `ApplicationLevel_QuickSwitcher`
631
+
632
+ Fast org/workspace switching UI integrated with session and routing state.
633
+
634
+ **Composition**
635
+
636
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
637
+ - A scope field whose `fieldIdentifier` matches the resource's `resourceFieldIdentifier` resolves through the primary-key fallback (`_id`/`id`) and renders as a resource-reference combobox targeting that resource type — never a raw id text input. Every control carries a non-empty label (config label → resource title → humanized field id) and a placeholder from the resource title.
638
+
639
+ ## `ApplicationLevel_Sidebar`
640
+
641
+ Application shell sidebar that composes resource navigation, mode hints, and collapse behavior.
642
+
643
+ **Composition**
644
+
645
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
646
+ - Distinct from `LOW_LEVEL_SIDEBAR`, which is the generic compound; this enum targets the application shell preset implementation.
647
+ - Honors two theme design policies from `useUI()`: `ShellAppearance` (CONTINUOUS renders the sidebar as a transparent, borderless region of the shared shell canvas) and `SidebarCompactLabelMode` (ICON_AND_LABEL renders wrapping labels under icons in the collapsed rail, with a wider default collapsed width).
648
+ - Active/hover item states consume the theme SELECTABLE/FILLED recipe via `data-active` (overlay + font-medium — never a primary tint); the collapse toggle sits at the sidebar bottom and reveals on region hover / focus-within (always visible for coarse pointers).
649
+ - Responsive: with `responsivePolicy: BURGER` at/below the configured `responsiveBreakpoint` (default MOBILE) nothing renders inline — the sidebar opens as a Sheet overlay drawer (backdrop click / Escape close, focus trapped) toggled by the menubar burger or `HOTKEY_SIDEBAR_TOGGLE`; `DRAWER` policy keeps the inline column and auto-expands above the threshold. Whole-rail collapse state persists in localStorage and hydrates synchronously on mount; active-item highlight is keyed on item identity (one winner among duplicate url paths).
650
+ - Section placement is engine policy rather than declaration order: a navigation-list section declaring `isPrimary` heads the column as one unlabeled, non-collapsible group, a `SidebarSectionBehavior.FAVORITES` section follows it and is omitted entirely while the user has starred nothing, and every other section keeps its declared order. Favorites are user-curated through a hover-revealed star affordance on each row (filled while starred) and persist machine-locally.
651
+ - The application HOME affordance is exactly one of three authored presentations (`SIDEBAR.homeDisplayMode`): a navigation row heading the primary group (default), a brand header pinned above the scroll region — the application brand mark for the active light/dark theme plus its display name, doubling as the home button and degrading to the name alone when no brand asset resolves — or no home affordance at all. The brand header is presented as product identity rather than a navigation row — it takes the hover wash but never the selected fill, and sets its own type register — and the mark variant it shows (adaptive colour, monochrome, or a pinned light/dark side) is authored separately from the mode.
652
+
653
+ ## `ApplicationLevel_StatusBar`
654
+
655
+ Bottom or top status strip for sync state, selection counts, and background tasks.
656
+
657
+ **Composition**
658
+
659
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
660
+
661
+ ## `ApplicationLevel_Toolbar`
662
+
663
+ Primary action toolbar aligned with the current route or resource context.
664
+
665
+ **Composition**
666
+
667
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
668
+
669
+ ## `ApplicationLevel_UtilityPanel`
670
+
671
+ Secondary utility column for assistants, logs, or contextual helpers opposite the sidebar.
672
+
673
+ **Composition**
674
+
675
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
676
+
677
+ ## `AspectRatio`
678
+
679
+ Lock child media to a fixed width/height ratio (videos, avatars, thumbnails) without hardcoding pixel dimensions.
680
+
681
+ **Props**
682
+
683
+ - `ratio` — Numeric width/height ratio (e.g. 16/9). Type: `number`.
684
+
685
+ **16:9 media frame**
686
+
687
+ ```tsx
688
+ import { AspectRatio } from '@wildo-ai/saas-frontend-lib';
689
+
690
+ <AspectRatio ratio={16 / 9}>
691
+ <img src={src} alt="" className="h-full w-full object-cover" />
692
+ </AspectRatio>
693
+ ```
694
+
695
+ ## `Auth_AuthCallback`
696
+
697
+ OAuth/OIDC and SAML callback handler surface that exchanges the one-time code and surfaces provider errors. An account the backend parked because it still owes its organization is routed to `PUBLIC_LAYOUTS_ORGANIZATION_ONBOARDING` instead of being signed in.
698
+
699
+ **Composition**
700
+
701
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
702
+
703
+ ## `Auth_ConfirmEmail`
704
+
705
+ Email confirmation token validation and success/failure messaging.
706
+
707
+ **Composition**
708
+
709
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
710
+
711
+ ## `Auth_EnrollmentRequired`
712
+
713
+ Enrolls the second factor a mandatory MFA policy requires, on the session that owes it; a registration or invitation session is completed by the enrollment itself.
714
+
715
+ **Composition**
716
+
717
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
718
+
719
+ ## `Auth_Invitation`
720
+
721
+ Accept or decline organization invitations with context on the inviter.
722
+
723
+ **Composition**
724
+
725
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
726
+
727
+ ## `Auth_MagicLinkVerify`
728
+
729
+ Consumes magic-link token query params, completes the passwordless session, and forwards to the same-origin `redirect` deep link the link carries (through any MFA detour).
730
+
731
+ **Composition**
732
+
733
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
734
+
735
+ ## `Auth_Main`
736
+
737
+ Primary sign-in orchestration with method-specific templates and OAuth section; signup surfacing is gated by the resolved public-registration policy.
738
+
739
+ **Composition**
740
+
741
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
742
+
743
+ ## `Auth_MfaChallenge`
744
+
745
+ Second-factor verification challenge (TOTP, SMS, WebAuthn) during login.
746
+
747
+ **Composition**
748
+
749
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
750
+
751
+ ## `Auth_OAuthConsent`
752
+
753
+ Renders the OIDC interactive-consent screen for a `requiresConsent` OAuth client: surfaces the requesting client, the requested scopes, and the delegated agent resource, and records the user's approve/deny decision.
754
+
755
+ **Composition**
756
+
757
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
758
+
759
+ ## `Auth_OAuthLoggedOut`
760
+
761
+ Renders the OIDC RP-Initiated Logout landing screen: a static "you have been signed out" confirmation shown after /oauth/end-session terminates the End-User's OP session when the request carried no valid post_logout_redirect_uri.
762
+
763
+ **Composition**
764
+
765
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
766
+
767
+ ## `Auth_OAuthLogoutConfirm`
768
+
769
+ Renders the OIDC RP-Initiated Logout §6 confirmation prompt: a "sign out?" interstitial shown before /oauth/end-session terminates the End-User's OP session for a non-trusted logout, mitigating logout CSRF/DoS. Confirm POSTs the single-use token to /oauth/end-session/confirm (which ends the session); Cancel returns to the app.
770
+
771
+ **Composition**
772
+
773
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
774
+
775
+ ## `Auth_OneOffSession`
776
+
777
+ Limited-purpose session elevation or scoped login for one-off operations.
778
+
779
+ **Composition**
780
+
781
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
782
+
783
+ ## `Auth_OrganizationOnboarding`
784
+
785
+ The onboarding screen: asks, in order, for whatever an account parked at onboarding still owes — the person's first and last name when its user type asks them after the address is confirmed, then the organization it will own — and signs the account in once nothing is owed.
786
+
787
+ **Composition**
788
+
789
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
790
+
791
+ ## `Auth_PasswordLost`
792
+
793
+ Password reset request and confirmation UI.
794
+
795
+ **Composition**
796
+
797
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
798
+
799
+ ## `Auth_Register`
800
+
801
+ Account registration with method selection and policy-aware fields, and the point at which a registrant ACCEPTS the governed documents the application requires; the native `Auth_Register` wrapper enforces public availability before resolving any overridable preset.
802
+
803
+ **Composition**
804
+
805
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
806
+
807
+ ## `AutosaveIndicator`
808
+
809
+ Inline save-state indicator (saving, saved, error/retry) for autosave-enabled fields.
810
+
811
+ **Composition**
812
+
813
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
814
+
815
+ ## `Avatar`
816
+
817
+ Compound avatar primitive (root, image, fallback) for user or entity identity chips across the UI.
818
+
819
+ **Composition**
820
+
821
+ - Consumer helpers `Avatar`, `AvatarImage`, and `AvatarFallback` in `@wildo-ai/saas-frontend-lib` share the same `FrontendComponentType.LOW_LEVEL_AVATAR` resolver.
822
+
823
+ **Avatar with image and fallback**
824
+
825
+ ```tsx
826
+ import { Avatar, AvatarFallback, AvatarImage } from '@wildo-ai/saas-frontend-lib';
827
+
828
+ <Avatar>
829
+ <AvatarImage alt="Ada Lovelace" src={photoUrl} />
830
+ <AvatarFallback>AL</AvatarFallback>
831
+ </Avatar>
832
+ ```
833
+
834
+ ## `Badge`
835
+
836
+ Compact status or metadata chip with semantic colour variants.
837
+
838
+ **Props**
839
+
840
+ - `variant` — Semantic colour treatment for the badge surface. Values (`BadgeVariants_Variant` from `@wildo-ai/saas-frontend-lib`): `default` · `secondary` · `destructive` · `outline` · `info` · `success` · `warning`.
841
+ - `default` — Neutral primary badge styling.
842
+ - `secondary` — Lower-emphasis neutral badge.
843
+ - `destructive` — Error or dangerous state emphasis.
844
+ - `outline` — Bordered minimal badge.
845
+ - `info` — Informational emphasis.
846
+ - `success` — Positive completion state.
847
+ - `warning` — Caution or attention-needed state.
848
+ - `asChild` — Compose badge styling onto an existing child element. Type: `boolean`. Default `false`.
849
+
850
+ **Status badge**
851
+
852
+ ```tsx
853
+ import { Badge } from '@wildo-ai/saas-frontend-lib';
854
+
855
+ <Badge variant="success">Published</Badge>
856
+ ```
857
+
858
+ ## `BillingPortalLink`
859
+
860
+ Deep link or button that opens the billing provider customer portal.
861
+
862
+ **Composition**
863
+
864
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
865
+
866
+ ## `Breadcrumb`
867
+
868
+ Hierarchical location trail with links to ancestor routes and a current-page segment.
869
+
870
+ **Composition**
871
+
872
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
873
+
874
+ ## `Button`
875
+
876
+ Provide the canonical framework button component contract used for ordinary click-triggered actions across the UI.
877
+
878
+ **Props**
879
+
880
+ - `variant` — Controls the semantic visual treatment of the button while keeping the same underlying action role. **Enum** `ButtonVariants_Variant` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `default` · `destructive` · `outline` · `secondary` · `ghost` · `link` · `accent`. Default `default`.
881
+ - `default` — Primary/default framework action emphasis.
882
+ - `destructive` — Dangerous action styling for delete or irreversible flows.
883
+ - `outline` — Secondary emphasized action with bordered styling.
884
+ - `secondary` — Lower-emphasis standard action style.
885
+ - `ghost` — Minimal chrome for toolbar or lightweight contextual actions.
886
+ - `link` — Text-link style action that still behaves like a button.
887
+ - `accent` — Accent-colored call-to-action variant when the product wants stronger visual focus.
888
+ - `size` — Controls the overall footprint of the button so the same action can fit dense, standard, or icon-first layouts. **Enum** `ButtonSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `sm` · `md` · `lg` · `icon` · `icon-sm`.
889
+ - `sm` — Compact button for dense UI areas.
890
+ - `md` — Default button footprint for standard actions.
891
+ - `lg` — Larger footprint for prominent calls to action.
892
+ - `icon` — Square icon-only button size.
893
+ - `icon-sm` — Compact square icon-only button size.
894
+ - `loading` — Marks the action as in-progress so the button can communicate temporary busy state. Type: `boolean`. Default `false`.
895
+ - `asChild` — Lets the button styling/behavior decorate another rendered child while preserving button semantics at the wrapper level. Type: `boolean`. Default `false`.
896
+ - `labelOverflow` — Decides whether a label longer than one line is kept on one line or wraps, so choices with translated labels are never cut. **Enum** `ButtonLabelOverflow` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `nowrap` · `wrap`. Default `nowrap`.
897
+ - `nowrap` — One line at the theme size height.
898
+ - `wrap` — The label wraps and the button grows; the theme size height becomes a minimum.
899
+
900
+ **Composition**
901
+
902
+ - The default button implementation ships from `@wildo-ai/presets-components`, but runtime lookup and override behavior still flow through the component registry owned by `@wildo-ai/saas-frontend-lib`.
903
+ - Downstream UI authoring should prefer the registered slot identity over importing the raw component directly unless a deliberate preset override or custom composition is required.
904
+ - This specification is component-level; preset-specific implementation details live under `presetSpecifications` so default-only and multi-preset components share the same contract shape.
905
+
906
+ **Primary submit action**
907
+
908
+ Default button usage through the consumer-facing registry-aware wrapper.
909
+
910
+ ```tsx
911
+ import { Button, ButtonVariants_Variant } from '@wildo-ai/saas-frontend-lib';
912
+
913
+ <Button
914
+ variant={ButtonVariants_Variant.DEFAULT}
915
+ type="submit"
916
+ >
917
+ Save changes
918
+ </Button>
919
+ ```
920
+
921
+ **Destructive action with explicit size**
922
+
923
+ Use enum-backed size and variant props instead of raw literal strings when authoring framework-facing code.
924
+
925
+ ```tsx
926
+ import { Button, ButtonVariants_Variant } from '@wildo-ai/saas-frontend-lib';
927
+ import { ButtonSize } from '@wildo-ai/presets-components-models';
928
+
929
+ <Button
930
+ variant={ButtonVariants_Variant.DESTRUCTIVE}
931
+ size={ButtonSize.SM}
932
+ loading={isDeleting}
933
+ onClick={handleDelete}
934
+ >
935
+ Delete project
936
+ </Button>
937
+ ```
938
+
939
+ - This goes through the wrapper contract, so any app-registered override for the targeted slot/preset can still participate.
940
+
941
+ ## `ButtonGroup`
942
+
943
+ Provide a flex container that visually merges multiple controls (buttons, inputs, selects) into one segmented control.
944
+
945
+ **Props**
946
+
947
+ - `orientation` — Stack direction for the grouped controls. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `horizontal` · `vertical`.
948
+ - `horizontal` — Default row layout for segmented controls.
949
+ - `vertical` — Column layout for stacked clusters.
950
+
951
+ **Composition**
952
+
953
+ - Children are arbitrary React nodes; the group only provides layout and focus z-index stacking.
954
+ - Pair with `ButtonGroupText` and `ButtonGroupSeparator` for chrome that matches the grouped visual language.
955
+ - Source `button-group.tsx` does not yet call `registerComponentLabels` for this slot; verify D1 if labels are added later.
956
+
957
+ **Horizontal button group**
958
+
959
+ ```tsx
960
+ import { ButtonGroup, Button } from '@wildo-ai/saas-frontend-lib';
961
+ import { ButtonSize } from '@wildo-ai/presets-components-models';
962
+
963
+ <ButtonGroup>
964
+ <Button size={ButtonSize.SM}>Left</Button>
965
+ <Button size={ButtonSize.SM}>Right</Button>
966
+ </ButtonGroup>
967
+ ```
968
+
969
+ ## `ButtonGroupSeparator`
970
+
971
+ Insert a slim separator between logical segments of a button group without breaking the merged border treatment.
972
+
973
+ **Props**
974
+
975
+ - `orientation` — Line orientation for the separator within the group. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `vertical` · `horizontal`. Default `vertical`.
976
+ - `vertical` — Default for horizontal button groups.
977
+ - `horizontal` — For vertical button groups.
978
+ - `decorative` — When true, hides the separator from assistive technology. Type: `boolean`.
979
+
980
+ **Composition**
981
+
982
+ - Default orientation is vertical for horizontal groups.
983
+ - Source `button-group.tsx` does not yet call `registerComponentLabels` for this sub-slot.
984
+
985
+ **Separate action clusters**
986
+
987
+ ```tsx
988
+ import { ButtonGroup, ButtonGroupSeparator, Button, ButtonVariants_Variant } from '@wildo-ai/saas-frontend-lib';
989
+
990
+ <ButtonGroup>
991
+ <Button variant={ButtonVariants_Variant.OUTLINE}>Edit</Button>
992
+ <ButtonGroupSeparator />
993
+ <Button variant={ButtonVariants_Variant.DESTRUCTIVE}>Delete</Button>
994
+ </ButtonGroup>
995
+ ```
996
+
997
+ ## `ButtonGroupText`
998
+
999
+ Render non-interactive label or prefix/suffix copy inside a button group with matching inset surface styling.
1000
+
1001
+ **Props**
1002
+
1003
+ - `asChild` — When true, merges props onto the child element instead of rendering a `div`. Type: `boolean`. Default `false`.
1004
+
1005
+ **Composition**
1006
+
1007
+ - Supports `asChild` to merge styles onto a custom element via Radix `Slot`.
1008
+ - Source `button-group.tsx` does not yet call `registerComponentLabels` for this sub-slot.
1009
+
1010
+ **Prefix label in a group**
1011
+
1012
+ ```tsx
1013
+ import { ButtonGroup, ButtonGroupText, Button } from '@wildo-ai/saas-frontend-lib';
1014
+
1015
+ <ButtonGroup>
1016
+ <ButtonGroupText>USD</ButtonGroupText>
1017
+ <Button>Buy</Button>
1018
+ </ButtonGroup>
1019
+ ```
1020
+
1021
+ ## `Calendar`
1022
+
1023
+ Day-picker calendar grid (react-day-picker) registered for theming overrides.
1024
+
1025
+ **Composition**
1026
+
1027
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1028
+
1029
+ ## `CalendarDayButton`
1030
+
1031
+ Day cell button inside the calendar grid, independently overridable in the registry.
1032
+
1033
+ **Composition**
1034
+
1035
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1036
+
1037
+ ## `Card`
1038
+
1039
+ Group related content with header, title, description, actions, and body regions in a surfaced container.
1040
+
1041
+ **Props**
1042
+
1043
+ - `statusEdge` — A coloured start edge naming the state of what the card holds, in a theme tone — or ABSENT (dashed, no fill) for a card that stands for something not yet there. A prop rather than a surface variant: local chrome children must not inherit. **Enum** `IndicatorVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `success` · `warning` · `error` · `info` · `neutral` · `absent`.
1044
+ - `success` — Landed and valid; done.
1045
+ - `warning` — Landed but its inputs moved since; needs a look.
1046
+ - `error` — Landed and refused by its validator.
1047
+ - `info` — In progress.
1048
+ - `neutral` — Quiet: nothing wrong and nothing owed.
1049
+ - `absent` — CardStatusEdge.ABSENT — not there yet; dashed with no edge fill.
1050
+ - `selected` — The card is the selected one of its list: the FILLED selectable tint plus a ring, and aria-selected when it is a pickable item (an option or a grid row). Type: `boolean`.
1051
+ - `option` — Makes the card one pickable item of a CardListbox: focusable, selects on click / Enter / Space, arrows move focus between sibling items, and a gesture that starts on a control inside the card is that control's and never selects. `option.semantics` (SelectableItemSemantics, from @wildo-ai/presets-components-models) says what the card HOLDS: OPTION (the default) is listbox > option and is valid only for a card with nothing operable inside, because an option's children are presentational to a screen reader; ROW is grid > row > gridcell and is what a card carrying its own button or link must declare. The CardListbox around it takes the SAME value in its own `semantics` prop — the container's role and the item's are one decision.
1052
+
1053
+ **Composition**
1054
+
1055
+ - Sub-components are separate exports that share the same registry preset.
1056
+
1057
+ **Summary card**
1058
+
1059
+ ```tsx
1060
+ import { Card, CardHeader, CardTitle, CardDescription, CardContent } from '@wildo-ai/saas-frontend-lib';
1061
+
1062
+ <Card>
1063
+ <CardHeader>
1064
+ <CardTitle>Usage</CardTitle>
1065
+ <CardDescription>Last 30 days</CardDescription>
1066
+ </CardHeader>
1067
+ <CardContent>{metrics}</CardContent>
1068
+ </Card>
1069
+ ```
1070
+
1071
+ ## `Carousel`
1072
+
1073
+ Present a swipeable/keyboardable sequence of items (hero banners, image galleries, onboarding steps).
1074
+
1075
+ **Props**
1076
+
1077
+ - `orientation` — Scroll axis for the carousel track. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `horizontal` · `vertical`.
1078
+ - `horizontal` — Default row carousel.
1079
+ - `vertical` — Column carousel.
1080
+ - `setApi` — Callback receiving the Embla API instance for imperative control. Signature: `(api: CarouselApi) => void`.
1081
+
1082
+ **Composition**
1083
+
1084
+ - Sub-components (`CarouselContent`, `CarouselItem`, `CarouselPrevious`, `CarouselNext`) resolve through the same preset via `createCompoundComponentResolver`.
1085
+
1086
+ **Basic carousel**
1087
+
1088
+ ```tsx
1089
+ import { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext } from '@wildo-ai/saas-frontend-lib';
1090
+
1091
+ <Carousel>
1092
+ <CarouselContent>
1093
+ {slides.map((s) => (
1094
+ <CarouselItem key={s.id}>{s.node}</CarouselItem>
1095
+ ))}
1096
+ </CarouselContent>
1097
+ <CarouselPrevious />
1098
+ <CarouselNext />
1099
+ </Carousel>
1100
+ ```
1101
+
1102
+ ## `ChartView`
1103
+
1104
+ Lazy-loaded ECharts surface registered for full-page or inserted chart views.
1105
+
1106
+ **Composition**
1107
+
1108
+ - Registered in `registerFrameworkLayouts` as a `React.lazy` import; the public barrel export is the suspense-wrapped `ChartView` from `ChartView.lazy`.
1109
+
1110
+ ## `ChartWidget`
1111
+
1112
+ Lazy-loaded chart widget with error boundary and feature gating for composite dashboards.
1113
+
1114
+ **Composition**
1115
+
1116
+ - Registered in `registerFrameworkLayouts` behind `React.lazy`; implementation lives in `components/views/chart-view/ChartWidget`.
1117
+
1118
+ ## `Checkbox`
1119
+
1120
+ Boolean checkbox with optional indeterminate support inside compound API.
1121
+
1122
+ **Composition**
1123
+
1124
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1125
+ - Compound component with `Checkbox.Root` for advanced layouts.
1126
+
1127
+ ## `Code`
1128
+
1129
+ Render inline monospace snippets (API identifiers, shell commands, short literals) with design-system code styling.
1130
+
1131
+ **Inline API field**
1132
+
1133
+ ```tsx
1134
+ import { Text, Code } from '@wildo-ai/saas-frontend-lib';
1135
+
1136
+ <Text>
1137
+ Send a POST to <Code>/api/v1/tasks</Code>.
1138
+ </Text>
1139
+ ```
1140
+
1141
+ ## `Collapsible`
1142
+
1143
+ Toggle visibility of a single content region (simpler than multi-item `Accordion`).
1144
+
1145
+ **Props**
1146
+
1147
+ - `open` — Controlled open state. Type: `boolean`.
1148
+ - `defaultOpen` — Initial open state when uncontrolled. Type: `boolean`.
1149
+ - `onOpenChange` — Fires when open state changes. Signature: `(open: boolean) => void`.
1150
+
1151
+ **Composition**
1152
+
1153
+ - `CollapsibleTrigger` and `CollapsibleContent` share the root preset.
1154
+
1155
+ **Advanced options**
1156
+
1157
+ ```tsx
1158
+ import { Collapsible, CollapsibleTrigger, CollapsibleContent, Button, ButtonVariants_Variant } from '@wildo-ai/saas-frontend-lib';
1159
+
1160
+ <Collapsible>
1161
+ <CollapsibleTrigger asChild>
1162
+ <Button variant={ButtonVariants_Variant.GHOST}>Show details</Button>
1163
+ </CollapsibleTrigger>
1164
+ <CollapsibleContent>{details}</CollapsibleContent>
1165
+ </Collapsible>
1166
+ ```
1167
+
1168
+ ## `ColorInput`
1169
+
1170
+ Color picker control integrated with form recipes: swatch trigger opening a framework-rendered picking surface (saturation/brightness plane + hue slider) above a theme-derived preset palette, beside a free-form CSS color text input. Renders no browser-native color element, so the entire surface obeys theme recipes and surface policy.
1171
+
1172
+ **Composition**
1173
+
1174
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1175
+
1176
+ ## `Combobox`
1177
+
1178
+ Searchable single-select control with keyboard navigation and optional async filtering.
1179
+
1180
+ **Composition**
1181
+
1182
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1183
+
1184
+ ## `ComboboxMultiple`
1185
+
1186
+ Searchable multi-select with badge chips, async options, and the same command palette UX as single combobox.
1187
+
1188
+ **Composition**
1189
+
1190
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1191
+ - Implementation lives in `@wildo-ai/presets-components` `combobox.tsx`; wrapper + props in `@wildo-ai/saas-frontend-lib` `combobox.tsx`.
1192
+
1193
+ ## `Command`
1194
+
1195
+ Keyboard-first command surface (inline or dialog) with filterable grouped items.
1196
+
1197
+ **Composition**
1198
+
1199
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1200
+
1201
+ ## `ContentSection`
1202
+
1203
+ Low-level section primitive: a native <fieldset> (DEFAULT/CARD), flat <div> (GHOST), or collapsible toggle (COLLAPSIBLE) that groups fields, carries the native disabled cascade, and owns when-orphan frame de-duplication. The registry-resolved replacement for the removed FieldSet.
1204
+
1205
+ **Composition**
1206
+
1207
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1208
+
1209
+ ## `ContentSectionGroup`
1210
+
1211
+ Child-grouping container inside a ContentSection, and the named container-query / group anchor (`@container/field-group`, `group/field-group`) that responsive Field orientation and FieldSeparator key off.
1212
+
1213
+ **Composition**
1214
+
1215
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1216
+
1217
+ ## `ContentSectionLegend`
1218
+
1219
+ Section heading element (native <legend>, two-size `variant`) for a ContentSection. Usually supplied via the ContentSection `legend` prop rather than rendered directly.
1220
+
1221
+ **Composition**
1222
+
1223
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1224
+
1225
+ ## `ContextMenu`
1226
+
1227
+ Right-click (or long-press) menu with grouped actions, checkboxes, and nested submenus.
1228
+
1229
+ **Composition**
1230
+
1231
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1232
+
1233
+ ## `DatePicker`
1234
+
1235
+ Date-only picker combining popover and calendar.
1236
+
1237
+ **Composition**
1238
+
1239
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1240
+
1241
+ ## `DateRangePicker`
1242
+
1243
+ Picker for inclusive date ranges.
1244
+
1245
+ **Composition**
1246
+
1247
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1248
+
1249
+ ## `DateTimePicker`
1250
+
1251
+ Picker for combined date and time values.
1252
+
1253
+ **Composition**
1254
+
1255
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1256
+
1257
+ ## `DateTimeRangePicker`
1258
+
1259
+ Picker for timestamp intervals.
1260
+
1261
+ **Composition**
1262
+
1263
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1264
+
1265
+ ## `DescriptionList`
1266
+
1267
+ Semantic description list (`<dl>`) wrapper for term/detail pairs.
1268
+
1269
+ **Props**
1270
+
1271
+ - `layout` — How the term/detail pairs lay out: hairline-divided ROWS (the document shape), or a fixed narrow term column with details beside it (KEY_VALUE, the operator shape). **Enum** `DescriptionListLayout` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `rows` · `key-value`. Default `rows`.
1272
+ - `rows` — Each pair a divided row; the term column half the width.
1273
+ - `key-value` — A fixed narrow muted term column, details wrapping beside it, no rules.
1274
+
1275
+ **Simple definition list**
1276
+
1277
+ ```tsx
1278
+ import { DescriptionDetails, DescriptionList, DescriptionTerm } from '@wildo-ai/saas-frontend-lib';
1279
+
1280
+ <DescriptionList>
1281
+ <DescriptionTerm>Plan</DescriptionTerm>
1282
+ <DescriptionDetails>Pro</DescriptionDetails>
1283
+ </DescriptionList>
1284
+ ```
1285
+
1286
+ ## `Dialog`
1287
+
1288
+ Modal or non-modal dialog for forms, detail views, and reversible workflows.
1289
+
1290
+ **Composition**
1291
+
1292
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1293
+
1294
+ ## `DisplayFieldAddress`
1295
+
1296
+ Renders a structured address as an address block, one part per line, with the country shown by its localized name.
1297
+
1298
+ **Props**
1299
+
1300
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1301
+ - `value` — Structured address value. One of: `string` | `number` | `boolean` | `object`.
1302
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1303
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1304
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1305
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1306
+
1307
+ **Composition**
1308
+
1309
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1310
+
1311
+ **Through the consumer wrapper**
1312
+
1313
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1314
+
1315
+ ```tsx
1316
+ import { DisplayFieldAddress } from '@wildo-ai/saas-frontend-lib';
1317
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1318
+
1319
+ <DisplayFieldAddress
1320
+ preset={CorePresetNames.DEFAULT}
1321
+ schema={schema}
1322
+ value={value}
1323
+ />
1324
+ ```
1325
+
1326
+ ## `DisplayFieldBigDecimal`
1327
+
1328
+ Formats fixed-precision decimal values for read-only resource and automatic displayer surfaces.
1329
+
1330
+ **Props**
1331
+
1332
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1333
+ - `value` — The scalar or structured decimal value produced by the schema (see props interface). One of: `string` | `number` | `boolean` | `object`.
1334
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1335
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1336
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1337
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1338
+
1339
+ **Composition**
1340
+
1341
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1342
+
1343
+ **Through the consumer wrapper**
1344
+
1345
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1346
+
1347
+ ```tsx
1348
+ import { DisplayFieldBigDecimal } from '@wildo-ai/saas-frontend-lib';
1349
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1350
+
1351
+ <DisplayFieldBigDecimal
1352
+ preset={CorePresetNames.DEFAULT}
1353
+ schema={schema}
1354
+ value={value}
1355
+ />
1356
+ ```
1357
+
1358
+ ## `DisplayFieldBoolean`
1359
+
1360
+ Renders boolean field values with consistent yes/no or iconography treatment.
1361
+
1362
+ **Props**
1363
+
1364
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1365
+ - `value` — Boolean or tri-state value as declared on the slot props. One of: `string` | `number` | `boolean` | `object`.
1366
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1367
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1368
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1369
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1370
+
1371
+ **Composition**
1372
+
1373
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1374
+
1375
+ **Through the consumer wrapper**
1376
+
1377
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1378
+
1379
+ ```tsx
1380
+ import { DisplayFieldBoolean } from '@wildo-ai/saas-frontend-lib';
1381
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1382
+
1383
+ <DisplayFieldBoolean
1384
+ preset={CorePresetNames.DEFAULT}
1385
+ schema={schema}
1386
+ value={value}
1387
+ />
1388
+ ```
1389
+
1390
+ ## `DisplayFieldCode`
1391
+
1392
+ Shows short code or monospace snippets with accessible formatting.
1393
+
1394
+ **Props**
1395
+
1396
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1397
+ - `value` — String or structured code value to present verbatim. One of: `string` | `number` | `boolean` | `object`.
1398
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1399
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1400
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1401
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1402
+
1403
+ **Composition**
1404
+
1405
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1406
+
1407
+ **Through the consumer wrapper**
1408
+
1409
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1410
+
1411
+ ```tsx
1412
+ import { DisplayFieldCode } from '@wildo-ai/saas-frontend-lib';
1413
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1414
+
1415
+ <DisplayFieldCode
1416
+ preset={CorePresetNames.DEFAULT}
1417
+ schema={schema}
1418
+ value={value}
1419
+ />
1420
+ ```
1421
+
1422
+ ## `DisplayFieldDate`
1423
+
1424
+ Formats calendar dates without time-of-day noise.
1425
+
1426
+ **Props**
1427
+
1428
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1429
+ - `value` — Date or ISO string accepted by the slot. One of: `string` | `number` | `boolean` | `object`.
1430
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1431
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1432
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1433
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1434
+
1435
+ **Composition**
1436
+
1437
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1438
+
1439
+ **Through the consumer wrapper**
1440
+
1441
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1442
+
1443
+ ```tsx
1444
+ import { DisplayFieldDate } from '@wildo-ai/saas-frontend-lib';
1445
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1446
+
1447
+ <DisplayFieldDate
1448
+ preset={CorePresetNames.DEFAULT}
1449
+ schema={schema}
1450
+ value={value}
1451
+ />
1452
+ ```
1453
+
1454
+ ## `DisplayFieldDateTime`
1455
+
1456
+ Formats instants with date and time in the active locale/time zone policy.
1457
+
1458
+ **Props**
1459
+
1460
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1461
+ - `value` — Datetime or ISO string accepted by the slot. One of: `string` | `number` | `boolean` | `object`.
1462
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1463
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1464
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1465
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1466
+
1467
+ **Composition**
1468
+
1469
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1470
+
1471
+ **Through the consumer wrapper**
1472
+
1473
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1474
+
1475
+ ```tsx
1476
+ import { DisplayFieldDateTime } from '@wildo-ai/saas-frontend-lib';
1477
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1478
+
1479
+ <DisplayFieldDateTime
1480
+ preset={CorePresetNames.DEFAULT}
1481
+ schema={schema}
1482
+ value={value}
1483
+ />
1484
+ ```
1485
+
1486
+ ## `DisplayFieldDuration`
1487
+
1488
+ Humanizes duration intervals (elapsed time, SLA timers) for read surfaces.
1489
+
1490
+ **Props**
1491
+
1492
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1493
+ - `value` — Duration payload from the schema. One of: `string` | `number` | `boolean` | `object`.
1494
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1495
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1496
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1497
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1498
+
1499
+ **Composition**
1500
+
1501
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1502
+
1503
+ **Through the consumer wrapper**
1504
+
1505
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1506
+
1507
+ ```tsx
1508
+ import { DisplayFieldDuration } from '@wildo-ai/saas-frontend-lib';
1509
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1510
+
1511
+ <DisplayFieldDuration
1512
+ preset={CorePresetNames.DEFAULT}
1513
+ schema={schema}
1514
+ value={value}
1515
+ />
1516
+ ```
1517
+
1518
+ ## `DisplayFieldEnum`
1519
+
1520
+ Maps enum values to human-readable labels using schema and registry metadata.
1521
+
1522
+ **Props**
1523
+
1524
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1525
+ - `value` — Enum token or label-ready value inferred from the schema. One of: `string` | `number` | `boolean` | `object`.
1526
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1527
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1528
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1529
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1530
+
1531
+ **Composition**
1532
+
1533
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1534
+
1535
+ **Through the consumer wrapper**
1536
+
1537
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1538
+
1539
+ ```tsx
1540
+ import { DisplayFieldEnum } from '@wildo-ai/saas-frontend-lib';
1541
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1542
+
1543
+ <DisplayFieldEnum
1544
+ preset={CorePresetNames.DEFAULT}
1545
+ schema={schema}
1546
+ value={value}
1547
+ />
1548
+ ```
1549
+
1550
+ ## `DisplayFieldFile`
1551
+
1552
+ Renders generic file metadata and download affordances for file fields.
1553
+
1554
+ **Props**
1555
+
1556
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1557
+ - `value` — File descriptor or URL payload from the schema. One of: `string` | `number` | `boolean` | `object`.
1558
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1559
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1560
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1561
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1562
+
1563
+ **Composition**
1564
+
1565
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1566
+
1567
+ **Through the consumer wrapper**
1568
+
1569
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1570
+
1571
+ ```tsx
1572
+ import { DisplayFieldFile } from '@wildo-ai/saas-frontend-lib';
1573
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1574
+
1575
+ <DisplayFieldFile
1576
+ preset={CorePresetNames.DEFAULT}
1577
+ schema={schema}
1578
+ value={value}
1579
+ />
1580
+ ```
1581
+
1582
+ ## `DisplayFieldFileAudio`
1583
+
1584
+ Audio file display with lightweight player chrome.
1585
+
1586
+ **Props**
1587
+
1588
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1589
+ - `value` — Audio file reference or URL. One of: `string` | `number` | `boolean` | `object`.
1590
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1591
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1592
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1593
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1594
+
1595
+ **Composition**
1596
+
1597
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1598
+
1599
+ **Through the consumer wrapper**
1600
+
1601
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1602
+
1603
+ ```tsx
1604
+ import { DisplayFieldFileAudio } from '@wildo-ai/saas-frontend-lib';
1605
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1606
+
1607
+ <DisplayFieldFileAudio
1608
+ preset={CorePresetNames.DEFAULT}
1609
+ schema={schema}
1610
+ value={value}
1611
+ />
1612
+ ```
1613
+
1614
+ ## `DisplayFieldFileDocument`
1615
+
1616
+ Document file display tuned for PDFs and office attachments. A PDF (THUMBNAIL: first page; FULL: up to a bounded number of pages, with a notice when the document is longer) is rendered with PDF.js into the design system's own canvas, behind a lazy door so the PDF.js payload downloads only when a PDF is shown; PDF.js parses on a same-origin worker file emitted by Vite (`?worker`), so the SaaS app baseline CSP needs no worker exception. The bytes are fetched over the authenticated file serve route. When they cannot be fetched, or the viewer chunk cannot be loaded, it falls back to the downloadable file card used for office documents; a document PDF.js cannot parse shows a labelled failure message inside the preview frame.
1617
+
1618
+ **Props**
1619
+
1620
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1621
+ - `value` — Document file reference or URL. One of: `string` | `number` | `boolean` | `object`.
1622
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1623
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1624
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1625
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1626
+
1627
+ **Composition**
1628
+
1629
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1630
+
1631
+ **Through the consumer wrapper**
1632
+
1633
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1634
+
1635
+ ```tsx
1636
+ import { DisplayFieldFileDocument } from '@wildo-ai/saas-frontend-lib';
1637
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1638
+
1639
+ <DisplayFieldFileDocument
1640
+ preset={CorePresetNames.DEFAULT}
1641
+ schema={schema}
1642
+ value={value}
1643
+ />
1644
+ ```
1645
+
1646
+ ## `DisplayFieldFileGallery`
1647
+
1648
+ Multi-file gallery display for image collections.
1649
+
1650
+ **Props**
1651
+
1652
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1653
+ - `value` — Collection of image file references. One of: `string` | `number` | `boolean` | `object`.
1654
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1655
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1656
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1657
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1658
+
1659
+ **Composition**
1660
+
1661
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1662
+
1663
+ **Through the consumer wrapper**
1664
+
1665
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1666
+
1667
+ ```tsx
1668
+ import { DisplayFieldFileGallery } from '@wildo-ai/saas-frontend-lib';
1669
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1670
+
1671
+ <DisplayFieldFileGallery
1672
+ preset={CorePresetNames.DEFAULT}
1673
+ schema={schema}
1674
+ value={value}
1675
+ />
1676
+ ```
1677
+
1678
+ ## `DisplayFieldFileImage`
1679
+
1680
+ Image-oriented file display with thumbnail or preview treatment.
1681
+
1682
+ **Props**
1683
+
1684
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1685
+ - `value` — Image file reference or URL. One of: `string` | `number` | `boolean` | `object`.
1686
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1687
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1688
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1689
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1690
+
1691
+ **Composition**
1692
+
1693
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1694
+
1695
+ **Through the consumer wrapper**
1696
+
1697
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1698
+
1699
+ ```tsx
1700
+ import { DisplayFieldFileImage } from '@wildo-ai/saas-frontend-lib';
1701
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1702
+
1703
+ <DisplayFieldFileImage
1704
+ preset={CorePresetNames.DEFAULT}
1705
+ schema={schema}
1706
+ value={value}
1707
+ />
1708
+ ```
1709
+
1710
+ ## `DisplayFieldFileVideo`
1711
+
1712
+ Video file display with player or poster affordances as implemented by the preset.
1713
+
1714
+ **Props**
1715
+
1716
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1717
+ - `value` — Video file reference or URL. One of: `string` | `number` | `boolean` | `object`.
1718
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1719
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1720
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1721
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1722
+
1723
+ **Composition**
1724
+
1725
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1726
+
1727
+ **Through the consumer wrapper**
1728
+
1729
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1730
+
1731
+ ```tsx
1732
+ import { DisplayFieldFileVideo } from '@wildo-ai/saas-frontend-lib';
1733
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1734
+
1735
+ <DisplayFieldFileVideo
1736
+ preset={CorePresetNames.DEFAULT}
1737
+ schema={schema}
1738
+ value={value}
1739
+ />
1740
+ ```
1741
+
1742
+ ## `DisplayFieldMoney`
1743
+
1744
+ Formats currency amounts with locale, symbol, and optional ISO code display.
1745
+
1746
+ **Props**
1747
+
1748
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1749
+ - `value` — Money value tuple or object as defined on the props interface. One of: `string` | `number` | `boolean` | `object`.
1750
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1751
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1752
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1753
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1754
+ - `symbolPosition` — Places the currency symbol before or after the amount. Values: `before` · `after`.
1755
+ - `before` — Symbol precedes the numeric amount.
1756
+ - `after` — Symbol follows the numeric amount.
1757
+ - `showSymbol` — Toggles rendering of the currency symbol. Type: `boolean`.
1758
+ - `showCurrencyCode` — Toggles rendering of the ISO currency code alongside the amount. Type: `boolean`.
1759
+ - `locale` — Overrides the default Intl locale used for formatting. Type: `string`.
1760
+
1761
+ **Composition**
1762
+
1763
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1764
+
1765
+ **Through the consumer wrapper**
1766
+
1767
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1768
+
1769
+ ```tsx
1770
+ import { DisplayFieldMoney } from '@wildo-ai/saas-frontend-lib';
1771
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1772
+
1773
+ <DisplayFieldMoney
1774
+ preset={CorePresetNames.DEFAULT}
1775
+ schema={schema}
1776
+ value={value}
1777
+ />
1778
+ ```
1779
+
1780
+ ## `DisplayFieldNumber`
1781
+
1782
+ Formats scalar numeric values with locale-aware grouping and fraction rules.
1783
+
1784
+ **Props**
1785
+
1786
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1787
+ - `value` — Numeric value accepted by the slot props. One of: `string` | `number` | `boolean` | `object`.
1788
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1789
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1790
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1791
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1792
+
1793
+ **Composition**
1794
+
1795
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1796
+
1797
+ **Through the consumer wrapper**
1798
+
1799
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1800
+
1801
+ ```tsx
1802
+ import { DisplayFieldNumber } from '@wildo-ai/saas-frontend-lib';
1803
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1804
+
1805
+ <DisplayFieldNumber
1806
+ preset={CorePresetNames.DEFAULT}
1807
+ schema={schema}
1808
+ value={value}
1809
+ />
1810
+ ```
1811
+
1812
+ ## `DisplayFieldPhone`
1813
+
1814
+ Formats phone numbers with regional grouping and masking rules from the preset.
1815
+
1816
+ **Props**
1817
+
1818
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1819
+ - `value` — Phone string or structured number. One of: `string` | `number` | `boolean` | `object`.
1820
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1821
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1822
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1823
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1824
+
1825
+ **Composition**
1826
+
1827
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1828
+
1829
+ **Through the consumer wrapper**
1830
+
1831
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1832
+
1833
+ ```tsx
1834
+ import { DisplayFieldPhone } from '@wildo-ai/saas-frontend-lib';
1835
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1836
+
1837
+ <DisplayFieldPhone
1838
+ preset={CorePresetNames.DEFAULT}
1839
+ schema={schema}
1840
+ value={value}
1841
+ />
1842
+ ```
1843
+
1844
+ ## `DisplayFieldRangeBigDecimal`
1845
+
1846
+ Displays inclusive or exclusive decimal ranges.
1847
+
1848
+ **Props**
1849
+
1850
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1851
+ - `value` — Min/max pair or range structure from the schema. One of: `string` | `number` | `boolean` | `object`.
1852
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1853
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1854
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1855
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1856
+
1857
+ **Composition**
1858
+
1859
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1860
+
1861
+ **Through the consumer wrapper**
1862
+
1863
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1864
+
1865
+ ```tsx
1866
+ import { DisplayFieldRangeBigDecimal } from '@wildo-ai/saas-frontend-lib';
1867
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1868
+
1869
+ <DisplayFieldRangeBigDecimal
1870
+ preset={CorePresetNames.DEFAULT}
1871
+ schema={schema}
1872
+ value={value}
1873
+ />
1874
+ ```
1875
+
1876
+ ## `DisplayFieldRangeDate`
1877
+
1878
+ Displays a calendar-date interval.
1879
+
1880
+ **Props**
1881
+
1882
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1883
+ - `value` — Date range payload from the schema. One of: `string` | `number` | `boolean` | `object`.
1884
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1885
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1886
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1887
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1888
+
1889
+ **Composition**
1890
+
1891
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1892
+
1893
+ **Through the consumer wrapper**
1894
+
1895
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1896
+
1897
+ ```tsx
1898
+ import { DisplayFieldRangeDate } from '@wildo-ai/saas-frontend-lib';
1899
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1900
+
1901
+ <DisplayFieldRangeDate
1902
+ preset={CorePresetNames.DEFAULT}
1903
+ schema={schema}
1904
+ value={value}
1905
+ />
1906
+ ```
1907
+
1908
+ ## `DisplayFieldRangeDateTime`
1909
+
1910
+ Displays an interval between two timestamps.
1911
+
1912
+ **Props**
1913
+
1914
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1915
+ - `value` — Datetime range payload from the schema. One of: `string` | `number` | `boolean` | `object`.
1916
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1917
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1918
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1919
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1920
+
1921
+ **Composition**
1922
+
1923
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1924
+
1925
+ **Through the consumer wrapper**
1926
+
1927
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1928
+
1929
+ ```tsx
1930
+ import { DisplayFieldRangeDateTime } from '@wildo-ai/saas-frontend-lib';
1931
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1932
+
1933
+ <DisplayFieldRangeDateTime
1934
+ preset={CorePresetNames.DEFAULT}
1935
+ schema={schema}
1936
+ value={value}
1937
+ />
1938
+ ```
1939
+
1940
+ ## `DisplayFieldRangeMoney`
1941
+
1942
+ Displays a monetary interval with per-end currency formatting.
1943
+
1944
+ **Props**
1945
+
1946
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1947
+ - `value` — Money range payload from the props interface. One of: `string` | `number` | `boolean` | `object`.
1948
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1949
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1950
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1951
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1952
+
1953
+ **Composition**
1954
+
1955
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1956
+
1957
+ **Through the consumer wrapper**
1958
+
1959
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1960
+
1961
+ ```tsx
1962
+ import { DisplayFieldRangeMoney } from '@wildo-ai/saas-frontend-lib';
1963
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1964
+
1965
+ <DisplayFieldRangeMoney
1966
+ preset={CorePresetNames.DEFAULT}
1967
+ schema={schema}
1968
+ value={value}
1969
+ />
1970
+ ```
1971
+
1972
+ ## `DisplayFieldRangeNumber`
1973
+
1974
+ Displays numeric min/max ranges for scalar number fields.
1975
+
1976
+ **Props**
1977
+
1978
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
1979
+ - `value` — Numeric range structure from the schema. One of: `string` | `number` | `boolean` | `object`.
1980
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
1981
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
1982
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
1983
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
1984
+
1985
+ **Composition**
1986
+
1987
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
1988
+
1989
+ **Through the consumer wrapper**
1990
+
1991
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
1992
+
1993
+ ```tsx
1994
+ import { DisplayFieldRangeNumber } from '@wildo-ai/saas-frontend-lib';
1995
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
1996
+
1997
+ <DisplayFieldRangeNumber
1998
+ preset={CorePresetNames.DEFAULT}
1999
+ schema={schema}
2000
+ value={value}
2001
+ />
2002
+ ```
2003
+
2004
+ ## `DisplayFieldRangeTime`
2005
+
2006
+ Displays a time-of-day interval.
2007
+
2008
+ **Props**
2009
+
2010
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
2011
+ - `value` — Time range payload from the schema. One of: `string` | `number` | `boolean` | `object`.
2012
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
2013
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
2014
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
2015
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
2016
+
2017
+ **Composition**
2018
+
2019
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
2020
+
2021
+ **Through the consumer wrapper**
2022
+
2023
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
2024
+
2025
+ ```tsx
2026
+ import { DisplayFieldRangeTime } from '@wildo-ai/saas-frontend-lib';
2027
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2028
+
2029
+ <DisplayFieldRangeTime
2030
+ preset={CorePresetNames.DEFAULT}
2031
+ schema={schema}
2032
+ value={value}
2033
+ />
2034
+ ```
2035
+
2036
+ ## `DisplayFieldString`
2037
+
2038
+ Default read-only string display for automatic displayer and resource templates. `StringDisplayMode.ORGANIZATION_ROLE` shows a role key as the role's word from the `roles` labels (the key itself when unworded).
2039
+
2040
+ **Props**
2041
+
2042
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
2043
+ - `value` — Plain string content for the field. One of: `string` | `number` | `boolean` | `object`.
2044
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
2045
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
2046
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
2047
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
2048
+
2049
+ **Composition**
2050
+
2051
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
2052
+
2053
+ **Through the consumer wrapper**
2054
+
2055
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
2056
+
2057
+ ```tsx
2058
+ import { DisplayFieldString } from '@wildo-ai/saas-frontend-lib';
2059
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2060
+
2061
+ <DisplayFieldString
2062
+ preset={CorePresetNames.DEFAULT}
2063
+ schema={schema}
2064
+ value={value}
2065
+ />
2066
+ ```
2067
+
2068
+ ## `DisplayFieldTime`
2069
+
2070
+ Formats time-of-day values independent of calendar date when appropriate.
2071
+
2072
+ **Props**
2073
+
2074
+ - `schema` **(required)** — Zod schema describing the field; drives inferred typing for `value` and formatter behavior. Type: `ZodTypeAny` from `zod`.
2075
+ - `value` — Time or string accepted by the slot. One of: `string` | `number` | `boolean` | `object`.
2076
+ - `value` note: The slot-specific props interface narrows this union (money tuples, ranges, files, enums, …).
2077
+ - `value` note: Callers may pass null or undefined when the underlying field has no value.
2078
+ - `label` — Optional caption shown with the formatted value when not hidden by layout or force flags. Type: `string`.
2079
+ - `description` — Optional supporting text rendered near the value for extra context. Type: `string`.
2080
+
2081
+ **Composition**
2082
+
2083
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution flows through the component registry in `@wildo-ai/saas-frontend-lib`.
2084
+
2085
+ **Through the consumer wrapper**
2086
+
2087
+ Use the registry-aware wrapper so app-registered presets can override the default formatter.
2088
+
2089
+ ```tsx
2090
+ import { DisplayFieldTime } from '@wildo-ai/saas-frontend-lib';
2091
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2092
+
2093
+ <DisplayFieldTime
2094
+ preset={CorePresetNames.DEFAULT}
2095
+ schema={schema}
2096
+ value={value}
2097
+ />
2098
+ ```
2099
+
2100
+ ## `Divider`
2101
+
2102
+ Provide a thematic break (`<hr>`) between sections with optional soft styling.
2103
+
2104
+ **Props**
2105
+
2106
+ - `soft` — When true, uses a lower-contrast border treatment. Type: `boolean`.
2107
+
2108
+ **Section break**
2109
+
2110
+ ```tsx
2111
+ import { Divider } from '@wildo-ai/saas-frontend-lib';
2112
+
2113
+ <Divider />
2114
+ ```
2115
+
2116
+ ## `Drawer`
2117
+
2118
+ Bottom/side sheet built on vaul-style drawer mechanics with snap points and gestures.
2119
+
2120
+ **Composition**
2121
+
2122
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2123
+
2124
+ ## `DropdownMenu`
2125
+
2126
+ Trigger-anchored menu for commands, toggles, and nested submenus.
2127
+
2128
+ **Composition**
2129
+
2130
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2131
+
2132
+ ## `Duration`
2133
+
2134
+ The elapsed span between two instants, ticking while the second one is unknown.
2135
+
2136
+ **Props**
2137
+
2138
+ - `since` — ISO instant the span starts at. Unparseable renders nothing rather than a number that reads as a measurement. Type: `string`.
2139
+ - `until` — ISO instant it ended. ABSENT means still running, which is what turns the one-second tick on. Type: `string`.
2140
+ - `size` — Type scale, reusing the framework text scale rather than declaring one of its own. **Enum** `TextSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `xxs` · `xs` · `sm` · `base` · `lg`.
2141
+ - `xxs` — A dense row where the clock is the least of several facts.
2142
+ - `xs` — A secondary clock beside a smaller identifier.
2143
+ - `sm` — The default — inline beside a row subject.
2144
+ - `base` — Body size; inherits whatever the body recipe defines.
2145
+ - `lg` — A page-level clock, e.g. the run a whole screen is about.
2146
+ - `variant` — Colour. INHERIT withholds a colour so an enclosing element keeps its own. **Enum** `TextVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `default` · `muted` · `contrast` · `destructive` · `success` · `inherit`.
2147
+ - `default` — Full-strength: the elapsed time IS the point of the row.
2148
+ - `muted` — The default — a fact beside the record, not the record.
2149
+ - `contrast` — Full-strength, chosen deliberately over the muted default.
2150
+ - `destructive` — A span that ended badly, or one that has run too long.
2151
+ - `success` — A span that completed as intended.
2152
+ - `inherit` — No colour of its own — inside an element that owns its colour.
2153
+ - `className` — Merged LAST, so a surface can override the preset treatment. Type: `string`.
2154
+
2155
+ **A dispatch that is still running, and one that settled**
2156
+
2157
+ ```tsx
2158
+ import { Duration } from '@wildo-ai/saas-frontend-lib';
2159
+
2160
+ // Ticks once a second while the dispatch is unsettled.
2161
+ <Duration since={dispatch.startedAt} />
2162
+
2163
+ // Frozen: the number can never change again, so no timer runs behind it.
2164
+ <Duration since={dispatch.startedAt} until={dispatch.settledAt} />
2165
+ ```
2166
+
2167
+ ## `EmptyState`
2168
+
2169
+ Generic empty state with title, description, icon, and optional actions.
2170
+
2171
+ **Props**
2172
+
2173
+ - `title` **(required)** — Primary heading for the empty state. Type: `string`.
2174
+
2175
+ **Composition**
2176
+
2177
+ - The same preset implementation is also registered under `FrontendComponentType.RESOURCES_LAYOUTS_EMPTY_STATE` for resource layouts.
2178
+
2179
+ ## `ErrorDisplay`
2180
+
2181
+ Rich error panel with title, message, optional actions, dev details, and guidance blocks.
2182
+
2183
+ **Props**
2184
+
2185
+ - `title` **(required)** — Primary error heading. Type: `string`.
2186
+ - `message` **(required)** — Human-readable explanation of what went wrong. Type: `string`.
2187
+
2188
+ ## `FeatureLimitIndicator`
2189
+
2190
+ Shows current usage against a gated feature limit using live feature service data.
2191
+
2192
+ **Props**
2193
+
2194
+ - `featureId` **(required)** — Identifier of the feature whose quota should be displayed. Type: `string`.
2195
+
2196
+ ## `FeatureUnavailableDialog`
2197
+
2198
+ Modal dialog explaining unavailable features with upgrade or dismiss actions.
2199
+
2200
+ **Props**
2201
+
2202
+ - `open` **(required)** — Controls dialog visibility. Type: `boolean`.
2203
+ - `onOpenChange` **(required)** — Called when the dialog requests open state changes (including overlay dismiss). Signature: `(open: boolean) => void`.
2204
+ - `behavior` **(required)** — String token describing why the feature is unavailable (drives preset messaging). Type: `string`.
2205
+
2206
+ ## `FeatureUnavailablePrompt`
2207
+
2208
+ Inline prompt describing missing features, limits, or upgrade paths.
2209
+
2210
+ **Props**
2211
+
2212
+ - `behavior` **(required)** — String token describing why the feature is unavailable. Type: `string`.
2213
+
2214
+ ## `Field`
2215
+
2216
+ Legacy field chrome root with orientation controls for grouping labels and controls.
2217
+
2218
+ **Composition**
2219
+
2220
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2221
+
2222
+ ## `FieldContent`
2223
+
2224
+ Content slot inside legacy `Field` rows.
2225
+
2226
+ **Composition**
2227
+
2228
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2229
+
2230
+ ## `FieldDescription`
2231
+
2232
+ Helper copy for legacy field chrome.
2233
+
2234
+ **Composition**
2235
+
2236
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2237
+
2238
+ ## `FieldError`
2239
+
2240
+ Aggregates error messages for legacy field chrome.
2241
+
2242
+ **Composition**
2243
+
2244
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2245
+
2246
+ ## `FieldLabel`
2247
+
2248
+ Native label styling for legacy `Field` layouts.
2249
+
2250
+ **Composition**
2251
+
2252
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2253
+
2254
+ ## `FieldSeparator`
2255
+
2256
+ Visual divider between legacy field groups.
2257
+
2258
+ **Composition**
2259
+
2260
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2261
+
2262
+ ## `FieldTitle`
2263
+
2264
+ Title row for grouped legacy field content.
2265
+
2266
+ **Composition**
2267
+
2268
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2269
+
2270
+ ## `Files_UploadGrantDrop`
2271
+
2272
+ Public drop page that redeems a single-use file-upload grant: the visitor chooses one file and the page sends it to the granted upload route with the grant as its only credential.
2273
+
2274
+ **Composition**
2275
+
2276
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2277
+
2278
+ ## `FileUpload`
2279
+
2280
+ Drag/drop and picker UI for attaching files to forms.
2281
+
2282
+ **Composition**
2283
+
2284
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2285
+
2286
+ ## `FormControl`
2287
+
2288
+ Radix `Slot` bridge that connects labels, descriptions, and inputs inside `FormItem`.
2289
+
2290
+ **Composition**
2291
+
2292
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2293
+
2294
+ ## `FormDescription`
2295
+
2296
+ Muted helper text associated with a form item.
2297
+
2298
+ **Composition**
2299
+
2300
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2301
+
2302
+ ## `FormFieldAddress`
2303
+
2304
+ Structured postal address input: one labelled control per address part, a country selector, optional coordinates, and a `renderLookup` slot where an address lookup (a vendor autocomplete) can fill every part without the field depending on any provider.
2305
+
2306
+ **Composition**
2307
+
2308
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2309
+
2310
+ **Through the consumer wrapper**
2311
+
2312
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2313
+
2314
+ ```tsx
2315
+ import { FormFieldAddress } from '@wildo-ai/saas-frontend-lib';
2316
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2317
+
2318
+ <FormFieldAddress
2319
+ preset={CorePresetNames.DEFAULT}
2320
+ schema={schema}
2321
+ name={name}
2322
+ />
2323
+ ```
2324
+
2325
+ ## `FormFieldBigDecimal`
2326
+
2327
+ High-precision decimal input driven by schema metadata.
2328
+
2329
+ **Composition**
2330
+
2331
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2332
+
2333
+ **Through the consumer wrapper**
2334
+
2335
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2336
+
2337
+ ```tsx
2338
+ import { FormFieldBigDecimal } from '@wildo-ai/saas-frontend-lib';
2339
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2340
+
2341
+ <FormFieldBigDecimal
2342
+ preset={CorePresetNames.DEFAULT}
2343
+ schema={schema}
2344
+ name={name}
2345
+ />
2346
+ ```
2347
+
2348
+ ## `FormFieldBoolean`
2349
+
2350
+ Boolean input (switch, checkbox, toggle, or radio) driven by boolean UI metadata.
2351
+
2352
+ **Composition**
2353
+
2354
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2355
+
2356
+ **Through the consumer wrapper**
2357
+
2358
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2359
+
2360
+ ```tsx
2361
+ import { FormFieldBoolean } from '@wildo-ai/saas-frontend-lib';
2362
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2363
+
2364
+ <FormFieldBoolean
2365
+ preset={CorePresetNames.DEFAULT}
2366
+ schema={schema}
2367
+ name={name}
2368
+ />
2369
+ ```
2370
+
2371
+ ## `FormFieldCode`
2372
+
2373
+ Code input for `FieldSchemaType.CODE` values (`CodeValue = { content, language }`): a language selector plus a CodeMirror-6-backed text plane with per-language syntax tint.
2374
+
2375
+ **Props**
2376
+
2377
+ - `value` — Controlled `CodeValue` — `content` is the source text, `language` selects the syntax mode and the Select state.
2378
+ - `value` note: Value type is `CodeValue` from `@wildo-ai/zod-decorators`.
2379
+ - `onChange` — Fires with the full next `CodeValue` on content edits and on language switches. Signature: `(value: CodeValue) => void`.
2380
+ - `rows` — Minimum visible editor height, in text rows (approximate). Type: `number`. Default `10`.
2381
+
2382
+ **Composition**
2383
+
2384
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2385
+
2386
+ **Through the consumer wrapper (RHF-controlled)**
2387
+
2388
+ Registry-aware wrapper wired as a controlled react-hook-form field, as the automated FormField dispatcher does for `FieldSchemaType.CODE`.
2389
+
2390
+ ```tsx
2391
+ import { FormFieldCode } from '@wildo-ai/saas-frontend-lib';
2392
+
2393
+ <FormFieldCode {...baseFieldProps} value={field.value} onChange={field.onChange} onBlur={field.onBlur} ref={field.ref} placeholder={placeholder} />
2394
+ ```
2395
+
2396
+ ## `FormFieldDate`
2397
+
2398
+ Date-only picker and display aligned with zoned date policies.
2399
+
2400
+ **Composition**
2401
+
2402
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2403
+
2404
+ **Through the consumer wrapper**
2405
+
2406
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2407
+
2408
+ ```tsx
2409
+ import { FormFieldDate } from '@wildo-ai/saas-frontend-lib';
2410
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2411
+
2412
+ <FormFieldDate
2413
+ preset={CorePresetNames.DEFAULT}
2414
+ schema={schema}
2415
+ name={name}
2416
+ />
2417
+ ```
2418
+
2419
+ ## `FormFieldDateTime`
2420
+
2421
+ Combined date and time capture with timezone-aware handling.
2422
+
2423
+ **Composition**
2424
+
2425
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2426
+
2427
+ **Through the consumer wrapper**
2428
+
2429
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2430
+
2431
+ ```tsx
2432
+ import { FormFieldDateTime } from '@wildo-ai/saas-frontend-lib';
2433
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2434
+
2435
+ <FormFieldDateTime
2436
+ preset={CorePresetNames.DEFAULT}
2437
+ schema={schema}
2438
+ name={name}
2439
+ />
2440
+ ```
2441
+
2442
+ ## `FormFieldDuration`
2443
+
2444
+ Duration entry control for ISO-8601 or decomposed duration parts.
2445
+
2446
+ **Composition**
2447
+
2448
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2449
+
2450
+ **Through the consumer wrapper**
2451
+
2452
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2453
+
2454
+ ```tsx
2455
+ import { FormFieldDuration } from '@wildo-ai/saas-frontend-lib';
2456
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2457
+
2458
+ <FormFieldDuration
2459
+ preset={CorePresetNames.DEFAULT}
2460
+ schema={schema}
2461
+ name={name}
2462
+ />
2463
+ ```
2464
+
2465
+ ## `FormFieldEnum`
2466
+
2467
+ Single- or multi-select enum control. The declared `EnumEditMode` picks the shape: dropdown, radio group, segmented toggle, card grid or searchable combobox — each of the radio, toggle and card shapes also in an icon-only form that draws the value's glyph in place of its words and keeps the words as the accessible name.
2468
+
2469
+ **Composition**
2470
+
2471
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2472
+
2473
+ **Through the consumer wrapper**
2474
+
2475
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2476
+
2477
+ ```tsx
2478
+ import { FormFieldEnum } from '@wildo-ai/saas-frontend-lib';
2479
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2480
+
2481
+ <FormFieldEnum
2482
+ preset={CorePresetNames.DEFAULT}
2483
+ schema={schema}
2484
+ name={name}
2485
+ />
2486
+ ```
2487
+
2488
+ ## `FormFieldFile`
2489
+
2490
+ File upload and preview control that waits for server-confirmed readiness before publishing new references. Refreshes pending metadata, blocks submission while unresolved, and retains the existing value during replacement.
2491
+
2492
+ **Composition**
2493
+
2494
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2495
+
2496
+ **Through the consumer wrapper**
2497
+
2498
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2499
+
2500
+ ```tsx
2501
+ import { FormFieldFile } from '@wildo-ai/saas-frontend-lib';
2502
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2503
+
2504
+ <FormFieldFile
2505
+ preset={CorePresetNames.DEFAULT}
2506
+ schema={schema}
2507
+ name={name}
2508
+ />
2509
+ ```
2510
+
2511
+ ## `FormFieldMoney`
2512
+
2513
+ Currency-aware amount input (major/minor units) from money schema metadata.
2514
+
2515
+ **Composition**
2516
+
2517
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2518
+
2519
+ **Through the consumer wrapper**
2520
+
2521
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2522
+
2523
+ ```tsx
2524
+ import { FormFieldMoney } from '@wildo-ai/saas-frontend-lib';
2525
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2526
+
2527
+ <FormFieldMoney
2528
+ preset={CorePresetNames.DEFAULT}
2529
+ schema={schema}
2530
+ name={name}
2531
+ />
2532
+ ```
2533
+
2534
+ ## `FormFieldNumber`
2535
+
2536
+ Numeric input with optional clamps and step metadata.
2537
+
2538
+ **Composition**
2539
+
2540
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2541
+
2542
+ **Through the consumer wrapper**
2543
+
2544
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2545
+
2546
+ ```tsx
2547
+ import { FormFieldNumber } from '@wildo-ai/saas-frontend-lib';
2548
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2549
+
2550
+ <FormFieldNumber
2551
+ preset={CorePresetNames.DEFAULT}
2552
+ schema={schema}
2553
+ name={name}
2554
+ />
2555
+ ```
2556
+
2557
+ ## `FormFieldPhone`
2558
+
2559
+ Phone number input with formatting and validation hints.
2560
+
2561
+ **Composition**
2562
+
2563
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2564
+
2565
+ **Through the consumer wrapper**
2566
+
2567
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2568
+
2569
+ ```tsx
2570
+ import { FormFieldPhone } from '@wildo-ai/saas-frontend-lib';
2571
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2572
+
2573
+ <FormFieldPhone
2574
+ preset={CorePresetNames.DEFAULT}
2575
+ schema={schema}
2576
+ name={name}
2577
+ />
2578
+ ```
2579
+
2580
+ ## `FormFieldPrimitive`
2581
+
2582
+ Thin `react-hook-form` `Controller` wrapper registered as the default form-field primitive.
2583
+
2584
+ **Composition**
2585
+
2586
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2587
+
2588
+ ## `FormFieldRangeBigDecimal`
2589
+
2590
+ Min/max bigdecimal range control.
2591
+
2592
+ **Composition**
2593
+
2594
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2595
+
2596
+ **Through the consumer wrapper**
2597
+
2598
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2599
+
2600
+ ```tsx
2601
+ import { FormFieldRangeBigDecimal } from '@wildo-ai/saas-frontend-lib';
2602
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2603
+
2604
+ <FormFieldRangeBigDecimal
2605
+ preset={CorePresetNames.DEFAULT}
2606
+ schema={schema}
2607
+ name={name}
2608
+ />
2609
+ ```
2610
+
2611
+ ## `FormFieldRangeDate`
2612
+
2613
+ Start/end date range without times.
2614
+
2615
+ **Composition**
2616
+
2617
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2618
+
2619
+ **Through the consumer wrapper**
2620
+
2621
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2622
+
2623
+ ```tsx
2624
+ import { FormFieldRangeDate } from '@wildo-ai/saas-frontend-lib';
2625
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2626
+
2627
+ <FormFieldRangeDate
2628
+ preset={CorePresetNames.DEFAULT}
2629
+ schema={schema}
2630
+ name={name}
2631
+ />
2632
+ ```
2633
+
2634
+ ## `FormFieldRangeDateTime`
2635
+
2636
+ Start/end datetime range control.
2637
+
2638
+ **Composition**
2639
+
2640
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2641
+
2642
+ **Through the consumer wrapper**
2643
+
2644
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2645
+
2646
+ ```tsx
2647
+ import { FormFieldRangeDateTime } from '@wildo-ai/saas-frontend-lib';
2648
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2649
+
2650
+ <FormFieldRangeDateTime
2651
+ preset={CorePresetNames.DEFAULT}
2652
+ schema={schema}
2653
+ name={name}
2654
+ />
2655
+ ```
2656
+
2657
+ ## `FormFieldRangeMoney`
2658
+
2659
+ Min/max money range with currency coherence.
2660
+
2661
+ **Composition**
2662
+
2663
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2664
+
2665
+ **Through the consumer wrapper**
2666
+
2667
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2668
+
2669
+ ```tsx
2670
+ import { FormFieldRangeMoney } from '@wildo-ai/saas-frontend-lib';
2671
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2672
+
2673
+ <FormFieldRangeMoney
2674
+ preset={CorePresetNames.DEFAULT}
2675
+ schema={schema}
2676
+ name={name}
2677
+ />
2678
+ ```
2679
+
2680
+ ## `FormFieldRangeNumber`
2681
+
2682
+ Min/max numeric range control.
2683
+
2684
+ **Composition**
2685
+
2686
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2687
+
2688
+ **Through the consumer wrapper**
2689
+
2690
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2691
+
2692
+ ```tsx
2693
+ import { FormFieldRangeNumber } from '@wildo-ai/saas-frontend-lib';
2694
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2695
+
2696
+ <FormFieldRangeNumber
2697
+ preset={CorePresetNames.DEFAULT}
2698
+ schema={schema}
2699
+ name={name}
2700
+ />
2701
+ ```
2702
+
2703
+ ## `FormFieldRangeTime`
2704
+
2705
+ Start/end time-of-day range.
2706
+
2707
+ **Composition**
2708
+
2709
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2710
+
2711
+ **Through the consumer wrapper**
2712
+
2713
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2714
+
2715
+ ```tsx
2716
+ import { FormFieldRangeTime } from '@wildo-ai/saas-frontend-lib';
2717
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2718
+
2719
+ <FormFieldRangeTime
2720
+ preset={CorePresetNames.DEFAULT}
2721
+ schema={schema}
2722
+ name={name}
2723
+ />
2724
+ ```
2725
+
2726
+ ## `FormFieldString`
2727
+
2728
+ General string input (input, textarea, markdown, password, OTP, color, single organization role) from string UI metadata. `StringEditMode.ORGANIZATION_ROLE` picks ONE key of the organization role table the backend publishes (`organizationRoles`: core plus custom organization roles), each option worded from the `roles` labels, and falls back to a text input when no table is published.
2729
+
2730
+ **Composition**
2731
+
2732
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2733
+
2734
+ **Through the consumer wrapper**
2735
+
2736
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2737
+
2738
+ ```tsx
2739
+ import { FormFieldString } from '@wildo-ai/saas-frontend-lib';
2740
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2741
+
2742
+ <FormFieldString
2743
+ preset={CorePresetNames.DEFAULT}
2744
+ schema={schema}
2745
+ name={name}
2746
+ />
2747
+ ```
2748
+
2749
+ ## `FormFieldTime`
2750
+
2751
+ Time-of-day control without calendar date.
2752
+
2753
+ **Composition**
2754
+
2755
+ - Typed form-field presets ship from `@wildo-ai/saas-frontend-lib` and register in `registerFrameworkLayouts` alongside other framework layout surfaces.
2756
+
2757
+ **Through the consumer wrapper**
2758
+
2759
+ Use the registry-aware wrapper so app-registered presets can override the default implementation.
2760
+
2761
+ ```tsx
2762
+ import { FormFieldTime } from '@wildo-ai/saas-frontend-lib';
2763
+ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2764
+
2765
+ <FormFieldTime
2766
+ preset={CorePresetNames.DEFAULT}
2767
+ schema={schema}
2768
+ name={name}
2769
+ />
2770
+ ```
2771
+
2772
+ ## `FormItem`
2773
+
2774
+ Layout container grouping label, control, description, and validation message.
2775
+
2776
+ **Composition**
2777
+
2778
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2779
+
2780
+ ## `FormLabel`
2781
+
2782
+ Accessible label primitive wired to `FormField` ids.
2783
+
2784
+ **Composition**
2785
+
2786
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2787
+
2788
+ ## `FormMessage`
2789
+
2790
+ Validation and helper messaging surface for form items (client or server errors).
2791
+
2792
+ **Composition**
2793
+
2794
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2795
+
2796
+ ## `FormRoot`
2797
+
2798
+ React Hook Form `FormProvider` shell registered as the framework form root preset.
2799
+
2800
+ **Composition**
2801
+
2802
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2803
+
2804
+ ## `Heading`
2805
+
2806
+ Render a semantic heading (`h1`–`h6`) with design-system typography recipes for page and section titles.
2807
+
2808
+ **Props**
2809
+
2810
+ - `level` — Semantic heading level mapped to `h1`–`h6` and recipe size tokens. Values: `1` · `2` · `3` · `4` · `5` · `6`. Default `1`.
2811
+ - `1` — Top-level page title.
2812
+ - `2` — Major section title.
2813
+ - `3` — Sub-section title.
2814
+ - `4` — Nested section title.
2815
+ - `5` — Minor heading.
2816
+ - `6` — Smallest heading level.
2817
+
2818
+ **Composition**
2819
+
2820
+ - Implementation reads `UIBehavior.TYPOGRAPHY` + `TypographyVariant.HEADING` recipes from `useUI()`.
2821
+
2822
+ **Page title**
2823
+
2824
+ ```tsx
2825
+ import { Heading } from '@wildo-ai/saas-frontend-lib';
2826
+
2827
+ <Heading level={1}>Dashboard</Heading>
2828
+ ```
2829
+
2830
+ ## `HoverCard`
2831
+
2832
+ Preview surface that opens on hover/focus to show supplementary content.
2833
+
2834
+ **Composition**
2835
+
2836
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2837
+
2838
+ ## `Identifier`
2839
+
2840
+ A machine address rendered verbatim and greppable — a resource ref, a task id, a slug, a file path.
2841
+
2842
+ **Props**
2843
+
2844
+ - `size` — Type scale, reusing the framework text scale rather than declaring one of its own. **Enum** `TextSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `xxs` · `xs` · `sm` · `base` · `lg`.
2845
+ - `xxs` — A trailing chip or a secondary address in a dense row.
2846
+ - `xs` — The default — what the field pipeline renders an identifier at.
2847
+ - `sm` — The row SUBJECT: the ref the row is about.
2848
+ - `base` — Body size; inherits whatever the body recipe defines.
2849
+ - `lg` — A page-level address, e.g. a heading-adjacent ref.
2850
+ - `variant` — Colour. INHERIT withholds a colour so an enclosing link or badge keeps its own. **Enum** `TextVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `default` · `muted` · `contrast` · `destructive` · `success` · `inherit`.
2851
+ - `default` — Full-strength text colour: the address IS the subject.
2852
+ - `muted` — The default — recedes behind the prose it identifies.
2853
+ - `contrast` — Full-strength, chosen deliberately over the muted default.
2854
+ - `destructive` — An address implicated in a failure.
2855
+ - `success` — An address implicated in a positive outcome.
2856
+ - `inherit` — No colour of its own — required inside a link, which owns its colour.
2857
+ - `className` — Merged LAST, so a surface can override the preset treatment. Type: `string`.
2858
+
2859
+ **A row subject and a secondary address inside a link**
2860
+
2861
+ ```tsx
2862
+ import { Identifier, TextLink } from '@wildo-ai/saas-frontend-lib';
2863
+ import { TextSize, TextVariant } from '@wildo-ai/presets-components-models';
2864
+
2865
+ <Identifier size={TextSize.SM} variant={TextVariant.DEFAULT}>{task.taskRef}</Identifier>
2866
+
2867
+ <TextLink href={traceUrl}>
2868
+ <Identifier variant={TextVariant.INHERIT}>{task.codingTaskId}</Identifier>
2869
+ </TextLink>
2870
+ ```
2871
+
2872
+ ## `ImageCrop`
2873
+
2874
+ Modal pan/zoom crop step between image selection and upload for aspect-ratio-constrained file fields.
2875
+
2876
+ **Composition**
2877
+
2878
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2879
+
2880
+ ## `InlineEditText`
2881
+
2882
+ Click-to-edit text: shows its value as plain text and reveals an input only once the reader decides to change it.
2883
+
2884
+ **Props**
2885
+
2886
+ - `value` **(required)** — The committed value shown in display mode and seeded into the draft when edit begins. Type: `string`.
2887
+ - `onCommit` **(required)** — Called with the trimmed draft when the user commits a non-empty change. Not called on cancel, and not called when the draft is empty. Signature: `(next: string) => void`.
2888
+ - `placeholder` — Muted text shown when `value` is empty, in both display and edit mode. Type: `string`.
2889
+ - `disabled` — Renders the value as plain text with no edit affordance. Type: `boolean`.
2890
+ - `ariaLabel` — Accessible name for both the display trigger and the input. The visible text is the value, which is rarely a name for it. Type: `string`.
2891
+ - `className` — Layout and spacing classes applied in both modes, so the control does not shift when it switches. Type: `string`.
2892
+ - `controlSize` — Control density, forwarded to the edit-mode input. Type: `ControlSize` from `@wildo-ai/presets-components-models`.
2893
+
2894
+ **Composition**
2895
+
2896
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2897
+ - DOMAIN-AGNOSTIC by construction: conditional appearance — a done item struck through, an overdue one in red — is the CALLER's concern. Style around the control; do not ask it to know what the value means.
2898
+ - Fully controlled. `value` is the committed value and `onCommit` is the only way it changes, so the caller owns the state and decides what persistence looks like.
2899
+ - The DEFAULT preset composes the framework `InputRoot` control for edit mode, so it inherits the application's input chrome rather than carrying its own.
2900
+
2901
+ **Renameable list item**
2902
+
2903
+ ```tsx
2904
+ import { InlineEditText } from '@wildo-ai/saas-frontend-lib';
2905
+
2906
+ <InlineEditText
2907
+ value={todo.title}
2908
+ onCommit={(next) => void renameTodo(todo.id, next)}
2909
+ ariaLabel={t('todos.title.ariaLabel')}
2910
+ placeholder={t('todos.title.placeholder')}
2911
+ />
2912
+ ```
2913
+
2914
+ ## `Input`
2915
+
2916
+ Compound text/numeric input with optional prefix/suffix slots and schema-aware typing.
2917
+
2918
+ **Composition**
2919
+
2920
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2921
+ - Compound component: includes `Input.Root` for affix layouts.
2922
+
2923
+ ## `InputGroup`
2924
+
2925
+ Flex row/column shell that visually merges addons, inline buttons, and a borderless input or textarea.
2926
+
2927
+ **Composition**
2928
+
2929
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2930
+ - Compound family: pair with `LOW_LEVEL_INPUT_GROUP_*` parts registered from the same presets module.
2931
+
2932
+ ## `InputGroupAddon`
2933
+
2934
+ Non-editable chrome region (icon, unit, kbd) aligned around the input-group control.
2935
+
2936
+ **Composition**
2937
+
2938
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2939
+
2940
+ ## `InputGroupButton`
2941
+
2942
+ Compact in-field button (clear, reveal password, copy) using the input-group size ladder.
2943
+
2944
+ **Composition**
2945
+
2946
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2947
+ - Uses an intentional size ladder separate from global `ButtonSize` — see V-5.e comment in presets `input-group.tsx`.
2948
+
2949
+ ## `InputGroupInput`
2950
+
2951
+ Borderless single-line control slot that inherits focus ring from the parent input group.
2952
+
2953
+ **Composition**
2954
+
2955
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2956
+
2957
+ ## `InputGroupText`
2958
+
2959
+ Muted inline text span for static hints inside an input group (e.g. domain suffix).
2960
+
2961
+ **Composition**
2962
+
2963
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2964
+
2965
+ ## `InputGroupTextarea`
2966
+
2967
+ Borderless multiline control slot that grows the input group height when embedded.
2968
+
2969
+ **Composition**
2970
+
2971
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2972
+
2973
+ ## `InputOTP`
2974
+
2975
+ One-time code entry with segmented boxes.
2976
+
2977
+ **Composition**
2978
+
2979
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2980
+
2981
+ ## `InvoiceHistory`
2982
+
2983
+ Lists recent invoices with links to hosted invoice PDFs and portal actions.
2984
+
2985
+ **Composition**
2986
+
2987
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
2988
+
2989
+ ## `Kbd`
2990
+
2991
+ A keyboard key or chord, as a person is told to press it — ⌘K, Esc, ↑↓, Enter.
2992
+
2993
+ **Props**
2994
+
2995
+ - `className` — Merged LAST — for where the cap sits (ms-auto, pointer-coarse:hidden), never for how it is drawn. Type: `string`.
2996
+
2997
+ **A shortcut hint on a search control, and a hotkey in a help list**
2998
+
2999
+ ```tsx
3000
+ import { Kbd } from '@wildo-ai/saas-frontend-lib';
3001
+
3002
+ <Kbd className="pointer-coarse:hidden">⌘K</Kbd>
3003
+
3004
+ <Kbd>{hotkey.parsed.display}</Kbd>
3005
+ ```
3006
+
3007
+ ## `Label`
3008
+
3009
+ Provide accessible captions for form controls and inline field labels with design-system typography.
3010
+
3011
+ **Label tied to input**
3012
+
3013
+ ```tsx
3014
+ import { Label } from '@wildo-ai/saas-frontend-lib';
3015
+
3016
+ <Label htmlFor="email">Email</Label>
3017
+ ```
3018
+
3019
+ ## `Link`
3020
+
3021
+ Navigate or deep-link with framework styling, optional icons, and external-link affordances.
3022
+
3023
+ **Props**
3024
+
3025
+ - `variant` — Semantic color treatment for the link. **Enum** `LinkVariants_Variant` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `default` · `muted` · `contrast` · `destructive` · `success` · `inherit`.
3026
+ - `default` — Primary link color.
3027
+ - `muted` — De-emphasized inline link.
3028
+ - `contrast` — High contrast on tinted surfaces.
3029
+ - `destructive` — Dangerous navigation (e.g. leave flow).
3030
+ - `success` — Positive / confirmation-adjacent link tone.
3031
+ - `inherit` — Match surrounding text color.
3032
+ - `underline` — When the underline is shown. **Enum** `LinkVariants_Underline` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `hover` · `always` · `none`.
3033
+ - `hover` — Underline appears on hover/focus.
3034
+ - `always` — Underline always visible.
3035
+ - `none` — No underline.
3036
+ - `size` — Optional type scale borrowed from button size tokens. Omitted, the link inherits the font size of the text it sits in. **Enum** `ButtonSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `sm` · `md` · `lg` · `icon` · `icon-sm`.
3037
+ - `size` values note: There is no default size: an inline link inside body copy should omit it and inherit the copy's size.
3038
+ - `sm` — Compact inline link.
3039
+ - `md` — Base-size link, independent of the surrounding text.
3040
+ - `lg` — Prominent link.
3041
+ - `icon` — Rare — icon-sized link treatments.
3042
+ - `icon-sm` — Compact icon-sized link treatments.
3043
+ - `weight` — Font weight for the link text. **Enum** `LinkVariants_Weight` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `normal` · `medium` · `semibold`.
3044
+ - `normal` — Regular weight.
3045
+ - `medium` — Slightly emphasized.
3046
+ - `semibold` — Strong emphasis.
3047
+ - `external` — When true, opens in a new tab with rel security attributes and optional external icon. Type: `boolean`. Default `false`.
3048
+ - `disabled` — Non-interactive presentation without navigation. Type: `boolean`. Default `false`.
3049
+ - `asChild` — Merge link styles onto a child element (e.g. router `Link`). Type: `boolean`. Default `false`.
3050
+
3051
+ **Inline navigation**
3052
+
3053
+ ```tsx
3054
+ import { Link, LinkVariants_Variant } from '@wildo-ai/saas-frontend-lib';
3055
+
3056
+ <Link href="/settings" variant={LinkVariants_Variant.MUTED}>
3057
+ Settings
3058
+ </Link>
3059
+ ```
3060
+
3061
+ ## `LoadingSpinner`
3062
+
3063
+ Inline indeterminate spinner with accessible busy semantics.
3064
+
3065
+ **Composition**
3066
+
3067
+ - The wrapper falls back to a bootstrap SVG implementation when no preset is registered.
3068
+
3069
+ ## `MarkdownEditor`
3070
+
3071
+ Markdown SOURCE editor for string fields authored with `StringEditMode.MARKDOWN` — the stored truth stays plain markdown source, edited with syntax tint.
3072
+
3073
+ **Props**
3074
+
3075
+ - `value` — Markdown source (controlled) — the exact string persisted for the field. Type: `string`.
3076
+ - `onChange` — Fires with the full next markdown source on every edit. Signature: `(value: string) => void`.
3077
+ - `onBlur` — Fires on editor blur; wire to the form field so `ValidationMode.ON_BLUR` and autosave see real blur. Signature: `() => void`.
3078
+ - `minRows` — Minimum visible height, in text rows (approximate). Type: `number`. Default `6`.
3079
+ - `ariaLabel` — Accessible name for the editor (CodeMirror renders a contenteditable, not a labelled textarea). Type: `string`.
3080
+
3081
+ **Composition**
3082
+
3083
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3084
+
3085
+ **Through the consumer wrapper**
3086
+
3087
+ Registry-aware wrapper as dispatched by `FormFieldString` for `StringEditMode.MARKDOWN` — a controlled markdown-source field participating in blur validation.
3088
+
3089
+ ```tsx
3090
+ import { MarkdownEditor } from '@wildo-ai/saas-frontend-lib';
3091
+
3092
+ <MarkdownEditor
3093
+ value={currentValue}
3094
+ onChange={handleChange}
3095
+ onBlur={handleBlur}
3096
+ placeholder={placeholder}
3097
+ disabled={disabled}
3098
+ readOnly={readOnly}
3099
+ minRows={textareaRows}
3100
+ ariaLabel={name}
3101
+ />
3102
+ ```
3103
+
3104
+ ## `Menubar`
3105
+
3106
+ Horizontal menubar with nested menus, checkable items, and accelerator hints.
3107
+
3108
+ **Composition**
3109
+
3110
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3111
+
3112
+ ## `NavigationMenu`
3113
+
3114
+ Top-level site or app navigation with mega-menu style content and viewport.
3115
+
3116
+ **Composition**
3117
+
3118
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3119
+ - Despite the enum name `LOW_LEVEL_NAVBAR`, the implementation and consumer export are `NavigationMenu` (see `navigation/navbar.tsx`).
3120
+
3121
+ ## `NotificationIndicator`
3122
+
3123
+ Notification count / signal-dot indicator over the Badge, with a theme-owned pulse.
3124
+
3125
+ **Props**
3126
+
3127
+ - `mode` — Whether to render the numeric count, a signal dot, or nothing. **Enum** `NotificationBadgeDisplayMode` from `@wildo-ai/saas-models` — import it and pass a MEMBER, not a string. Values: `dot` · `count` · `none`.
3128
+ - `dot` — A colored signal dot (≥ 1), no number.
3129
+ - `count` — The numeric count (truncated at the display cap).
3130
+ - `none` — Rendered as nothing (count still available).
3131
+ - `tone` — Semantic colour, mapped to the Badge variant. **Enum** `IndicatorVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `neutral` · `info` · `success` · `warning` · `error`.
3132
+ - `neutral` — Neutral emphasis.
3133
+ - `info` — Informational emphasis.
3134
+ - `success` — Positive state.
3135
+ - `warning` — Caution or attention-needed state.
3136
+ - `error` — Error or urgent state.
3137
+ - `count` — The value; ignored when mode is DOT, must be > 0 to render anything. Type: `number`.
3138
+ - `pulse` — Already-resolved "pulse now" — the theme supplies the animation via motion.attention. Type: `boolean`. Default `false`.
3139
+ - `label` — Accessible name — sr-only for DOT, aria-label for COUNT. Type: `string`.
3140
+
3141
+ **Notification count indicator**
3142
+
3143
+ ```tsx
3144
+ import { NotificationIndicator } from '@wildo-ai/saas-frontend-lib';
3145
+ import { NotificationBadgeDisplayMode } from '@wildo-ai/saas-models';
3146
+ import { IndicatorVariant } from '@wildo-ai/presets-components-models';
3147
+
3148
+ <NotificationIndicator
3149
+ mode={NotificationBadgeDisplayMode.COUNT}
3150
+ tone={IndicatorVariant.INFO}
3151
+ count={3}
3152
+ pulse
3153
+ label="Incomplete todos"
3154
+ />
3155
+ ```
3156
+
3157
+ ## `OperationsConfirmCritical`
3158
+
3159
+ Inline or dialog confirmation control for destructive or irreversible operations.
3160
+
3161
+ **Props**
3162
+
3163
+ - `cancelCallback` **(required)** — Invoked when the user aborts the critical action. Signature: `() => void`.
3164
+ - `validationCallback` **(required)** — Invoked when the user confirms after satisfying any inline checks. Signature: `() => void`.
3165
+
3166
+ ## `Pagination`
3167
+
3168
+ Navigate paged data with previous/next, numeric links, and ellipsis affordances.
3169
+
3170
+ **Composition**
3171
+
3172
+ - Link sizing reuses `ButtonSize` on `PaginationLink` variants.
3173
+
3174
+ **Page controls**
3175
+
3176
+ ```tsx
3177
+ import { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationPrevious, PaginationNext } from '@wildo-ai/saas-frontend-lib';
3178
+
3179
+ <Pagination>
3180
+ <PaginationContent>
3181
+ <PaginationItem>
3182
+ <PaginationPrevious href="#" />
3183
+ </PaginationItem>
3184
+ <PaginationItem>
3185
+ <PaginationLink href="#">1</PaginationLink>
3186
+ </PaginationItem>
3187
+ <PaginationItem>
3188
+ <PaginationNext href="#" />
3189
+ </PaginationItem>
3190
+ </PaginationContent>
3191
+ </Pagination>
3192
+ ```
3193
+
3194
+ ## `PasswordInput`
3195
+
3196
+ Password field with visibility toggle and shared security styling.
3197
+
3198
+ **Composition**
3199
+
3200
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3201
+
3202
+ ## `PlanChangePreview`
3203
+
3204
+ Provider-computed invoice estimate and explicit confirmation bound to the selected subscription and target price.
3205
+
3206
+ **Composition**
3207
+
3208
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3209
+
3210
+ ## `Popover`
3211
+
3212
+ Click/focus anchored floating panel for forms, pickers, and inline editors.
3213
+
3214
+ **Composition**
3215
+
3216
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3217
+
3218
+ ## `PricingTable`
3219
+
3220
+ Selectable pricing tiers with feature bullets and CTA wiring.
3221
+
3222
+ **Composition**
3223
+
3224
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3225
+
3226
+ ## `ProgressionMilestoneTracker`
3227
+
3228
+ Show a person how far they have come through the application's milestones, and what to do next.
3229
+
3230
+ **Props**
3231
+
3232
+ - `variant` — How much progression this mount shows — chosen per mount, so one application can put a glance on its dashboard and the full breakdown on an achievements screen. **Enum** `ProgressionTrackerVariant` from `@wildo-ai/saas-models` — import it and pass a MEMBER, not a string. Values: `next_actions` · `summary` · `flat` · `detailed`. Default `summary`.
3233
+ - `next_actions` — Overall progress and only the milestones in reach; achieved ones are not listed. For a surface whose job is to get someone to their next action.
3234
+ - `summary` — A glance: overall progress, the points total and the single next milestone. For a dashboard card sharing the screen with other cards. The default.
3235
+ - `flat` — Every milestone in one list with one progress bar; categories become plain headings.
3236
+ - `detailed` — Categories measured in their own right, with the full per-milestone breakdown. For a screen whose whole subject is progression.
3237
+ - `actionableLimit` — How many in-reach milestones the NEXT_ACTIONS variant lists. Ignored by every other variant. Type: `number`. Default `3`.
3238
+
3239
+ **Composition**
3240
+
3241
+ - Tier-2 framework-internal slot: composed directly by name; not resolved through ComponentRegistry, so there is no preset to register for it. Its SHAPE is customised through `variant`, per mount.
3242
+ - Renders inside its own `Card` with a `region` landmark named by its title; pass `className` to size it rather than wrapping it in another element, which would break that association.
3243
+ - To change how a milestone CELEBRATES rather than how progress is listed, set `celebrationMode` on the milestone definition, or register your own preset for the celebration overlay.
3244
+
3245
+ **A progress glance on a dashboard**
3246
+
3247
+ The SUMMARY variant in a dashboard column beside other cards.
3248
+
3249
+ ```tsx
3250
+ import { ProgressionMilestoneTracker } from '@wildo-ai/saas-frontend-lib';
3251
+ import { ProgressionTrackerVariant } from '@wildo-ai/saas-models';
3252
+
3253
+ <ProgressionMilestoneTracker variant={ProgressionTrackerVariant.SUMMARY} className="w-full" />
3254
+ ```
3255
+
3256
+ **The full breakdown on an achievements screen**
3257
+
3258
+ ```tsx
3259
+ <ProgressionMilestoneTracker variant={ProgressionTrackerVariant.DETAILED} className="w-full" />
3260
+ ```
3261
+
3262
+ ## `PublicLayout_MainContainer`
3263
+
3264
+ Public / unauthenticated layout container with optional centered card chrome, and — when the application opts in via `publicShellIdentityMode` — the surface identity at the top of that card.
3265
+
3266
+ **Composition**
3267
+
3268
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3269
+
3270
+ ## `PublicLayout_StaticContentContainer`
3271
+
3272
+ Minimal public-layout frame for static or CMS-driven content with optional children slot.
3273
+
3274
+ **Composition**
3275
+
3276
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3277
+
3278
+ ## `PublicLayout_Terms`
3279
+
3280
+ Public governed-document page for the public shell, serving privacy notices and service terms from the application's `compliance.publicDocuments`: the release in force with the text that release carries, or the latest draft of a document the application has never released.
3281
+
3282
+ **Composition**
3283
+
3284
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3285
+
3286
+ ## `RadioGroup`
3287
+
3288
+ Single-selection radio list with optional custom option rendering.
3289
+
3290
+ **Composition**
3291
+
3292
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3293
+ - Compound component with `RadioGroup.Root` for advanced layouts.
3294
+
3295
+ ## `RadioGroupItem`
3296
+
3297
+ Individual radio item registered separately from the group container.
3298
+
3299
+ **Composition**
3300
+
3301
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3302
+
3303
+ ## `RangeSlider`
3304
+
3305
+ Dual-thumb slider for numeric intervals.
3306
+
3307
+ **Composition**
3308
+
3309
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3310
+
3311
+ ## `ResizablePanelGroup`
3312
+
3313
+ Let users resize adjacent panels (IDE-style sidebars, preview panes) with persisted layout optional.
3314
+
3315
+ **Props**
3316
+
3317
+ - `direction` **(required)** — Whether panels stack horizontally or vertically. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `horizontal` · `vertical`.
3318
+ - `horizontal` — Sidebar + main split.
3319
+ - `vertical` — Stacked resizable rows.
3320
+ - `autoSaveId` — Optional id for persisting layout to storage. Type: `string`.
3321
+ - `onLayout` — Fires when panel sizes change. Signature: `(layout: number[]) => void`.
3322
+
3323
+ **Composition**
3324
+
3325
+ - `ResizablePanel` and `ResizableHandle` are separate wrapper exports that resolve the same compound preset.
3326
+
3327
+ **Sidebar + content**
3328
+
3329
+ ```tsx
3330
+ import { ResizablePanelGroup, ResizablePanel, ResizableHandle } from '@wildo-ai/saas-frontend-lib';
3331
+ import { DisplayDirection } from '@wildo-ai/zod-decorators';
3332
+
3333
+ <ResizablePanelGroup direction={DisplayDirection.HORIZONTAL}>
3334
+ <ResizablePanel defaultSize={20}>Sidebar</ResizablePanel>
3335
+ <ResizableHandle />
3336
+ <ResizablePanel>Main</ResizablePanel>
3337
+ </ResizablePanelGroup>
3338
+ ```
3339
+
3340
+ ## `ResourceEmptyState`
3341
+
3342
+ Resource-aware empty state that resolves i18n and configuration into the generic `EmptyState` preset.
3343
+
3344
+ **Props**
3345
+
3346
+ - `resourceType` **(required)** — Resource identifier used for scoped i18n lookup. Type: `string`.
3347
+
3348
+ **Composition**
3349
+
3350
+ - Labels are registered alongside `LOW_LEVEL_EMPTY_STATE` in the same presets file because the JSX implementation is shared.
3351
+
3352
+ **Resource list surface**
3353
+
3354
+ ```tsx
3355
+ import { ResourceEmptyState } from '@wildo-ai/saas-frontend-lib';
3356
+
3357
+ <ResourceEmptyState resourceType="projects" hasCreateOperation onCreateAction={openCreate} />
3358
+ ```
3359
+
3360
+ ## `ResourceFieldDisplay_ResourceReference`
3361
+
3362
+ Read-only display of foreign-key values with optional navigation to related records.
3363
+
3364
+ **Composition**
3365
+
3366
+ - Registrations use `FrontEndComponentResourceFieldCategory.DISPLAY` and `registerFrameworkLayouts`.
3367
+
3368
+ ## `ResourceFieldEdit_ResourceReference`
3369
+
3370
+ Editable foreign-key / resource-reference field with combobox search, quick-create hooks, and multi-select support.
3371
+
3372
+ **Composition**
3373
+
3374
+ - Registrations use `FrontEndComponentResourceFieldCategory.EDIT` and `registerFrameworkLayouts`.
3375
+
3376
+ ## `ResourceLayout_Action`
3377
+
3378
+ Renders operation-scoped actions (primary/secondary) with resource context.
3379
+
3380
+ **Composition**
3381
+
3382
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3383
+
3384
+ ## `ResourceLayout_Breadcrumb`
3385
+
3386
+ Renders the parent chain for hierarchical resources using route context and label resolution.
3387
+
3388
+ **Composition**
3389
+
3390
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3391
+
3392
+ ## `ResourceLayout_ContainerDialogs`
3393
+
3394
+ Hosts modal/dialog shells scoped to a resource operation (confirm, destructive, custom).
3395
+
3396
+ **Composition**
3397
+
3398
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3399
+
3400
+ ## `ResourceLayout_ContainerNested`
3401
+
3402
+ Renders the child resources a parent OWNS as embedded sections of the parent read surface, one section per child-direction relationship.
3403
+
3404
+ **Composition**
3405
+
3406
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3407
+
3408
+ ## `ResourceLayout_Create`
3409
+
3410
+ Framework create-operation surface with schema-driven form and operation actions.
3411
+
3412
+ **Composition**
3413
+
3414
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3415
+
3416
+ ## `ResourceLayout_DangerZone`
3417
+
3418
+ Danger-zone section grouping the destructive operations of a resource.
3419
+
3420
+ **Composition**
3421
+
3422
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3423
+
3424
+ ## `ResourceLayout_Filters`
3425
+
3426
+ Resource list/search filter strip wired to filter state and backend query params.
3427
+
3428
+ **Composition**
3429
+
3430
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3431
+
3432
+ ## `ResourceLayout_Header`
3433
+
3434
+ Title, description, and iconography for the active resource operation.
3435
+
3436
+ **Composition**
3437
+
3438
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3439
+
3440
+ ## `ResourceLayout_List`
3441
+
3442
+ Framework list-operation shell for resource collections: a unified collection toolbar (expand-on-focus search, icon-only filters, multi-sort, and a cards/table view toggle), the collection renderer, and create entry points.
3443
+
3444
+ **Composition**
3445
+
3446
+ - Default and table presets register in `registerFrameworkLayouts`; apps may add further list presets.
3447
+ - The DEFAULT preset owns the data fetch and renders the cards body or the table body in place, so toggling cards/table never refetches. The default body + whether a runtime toggle is shown come from the operation's `operationFrontendConfig.collectionDisplayConfig` (`displayMode` + `userSwitchableDisplayMode`), authored in the resource UI behavior — a pure FRONTEND concern, NOT on the shared resources-config. The table preset is a thin wrapper that seeds the table view.
3448
+ - `collectionDisplayConfig` also carries: `cardLayout` (CARDS arrangement — a single-column bordered LIST or an N-column responsive GRID via `CardLayoutStyle`); `cardActionPlacement` (where each card's per-item actions sit — a 2-axis `VerticalPlacement`×`HorizontalPlacement` anchor + `DisplayDirection` orientation, MIDDLE×MIDDLE rejected); and `selectable` (opt-in per-item selection + bulk actions). Selection is a single host-level model shared by the cards checkbox and the table select column (keyed on `resourceFieldIdentifier`), clears on filter/search change but persists across pagination, and the bulk-action bar contextually replaces the Create action in the toolbar trailing zone while a selection is active. The table also renders a trailing per-row actions column mirroring the cards' per-item operations. All pure FRONTEND presentation.
3449
+ - Sort is one multi-sort model (`SortState[]`, priority = order) shared by the toolbar sort popover and the table column headers, serialized as `sort=field:dir,field:dir` with LIST/SEARCH parity (validated against the operation `sortFields` and applied at the repository).
3450
+
3451
+ ## `ResourceLayout_OperationBulk`
3452
+
3453
+ Bulk selection actions bar for list operations.
3454
+
3455
+ **Composition**
3456
+
3457
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3458
+
3459
+ ## `ResourceLayout_OperationsItems`
3460
+
3461
+ Per-row operation affordances on list or search results.
3462
+
3463
+ **Composition**
3464
+
3465
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3466
+
3467
+ ## `ResourceLayout_Pagination`
3468
+
3469
+ Pagination controls bound to `Resources_PaginationMetadata`.
3470
+
3471
+ **Composition**
3472
+
3473
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3474
+
3475
+ ## `ResourceLayout_Read`
3476
+
3477
+ Provide the framework read-surface contract for resource detail views that resolve through the injectable layout preset lane.
3478
+
3479
+ **Props**
3480
+
3481
+ - `showCharts` — Controls whether inserted charts are rendered under the main read content when the chosen implementation honors that toggle. Type: `boolean`. Default `true`.
3482
+ - `showCharts` note: Some preset implementations force this behavior internally; for example the expandable read preset currently suppresses inserted charts.
3483
+
3484
+ **Composition**
3485
+
3486
+ - The wrapper resolves the effective read implementation from the preset override key and otherwise falls back to the default read preset.
3487
+ - Default and expandable read presets both participate in the framework component registry and therefore belong in this injectable component specification family.
3488
+ - Direct app code rarely constructs this component manually; most usage flows through route/runtime resource operations that already own `resourceContext` and `navigationZone`.
3489
+ - Use `displayPresetOverride.resourceLayoutPresetKey` to choose framework-owned preset variants such as `DEFAULT` or `EXPANDABLE`.
3490
+
3491
+ **Render the expandable framework read preset**
3492
+
3493
+ Direct wrapper usage when runtime code already owns a `resourceContext` and wants the expandable preset variant.
3494
+
3495
+ ```tsx
3496
+ import { ResourceLayout_Read } from '@wildo-ai/saas-frontend-lib';
3497
+ import { CorePreset_ResourceLayout_Read } from '@wildo-ai/presets-components-models';
3498
+
3499
+ <ResourceLayout_Read
3500
+ resourceContext={resourceContext}
3501
+ navigationZone={navigationZone}
3502
+ preset={CorePreset_ResourceLayout_Read.EXPANDABLE}
3503
+ />
3504
+ ```
3505
+
3506
+ ## `ResourceLayout_ReadSummary`
3507
+
3508
+ Summarized read surface for a resource record, used in cards, drawers, or table rows.
3509
+
3510
+ **Composition**
3511
+
3512
+ - Default and table-row presets both register through `registerFrameworkLayouts`.
3513
+
3514
+ ## `ResourceLayout_Search`
3515
+
3516
+ Framework search-operation shell combining query inputs, results, and resource chrome.
3517
+
3518
+ **Composition**
3519
+
3520
+ - Default and table search presets register in `registerFrameworkLayouts`.
3521
+
3522
+ ## `ResourceLayout_Update`
3523
+
3524
+ Framework update-operation surface for editing existing records.
3525
+
3526
+ **Composition**
3527
+
3528
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3529
+
3530
+ ## `ScrollArea`
3531
+
3532
+ Provide a scrollable viewport with custom scrollbars that match the design system.
3533
+
3534
+ **Props**
3535
+
3536
+ - `type` — Scrollbar visibility mode. **Enum** `ScrollAreaType` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `auto` · `always` · `scroll` · `hover`.
3537
+ - `auto` — Show scrollbars when needed.
3538
+ - `always` — Scrollbars always visible.
3539
+ - `scroll` — Reserved scroll gutter.
3540
+ - `hover` — Show on hover.
3541
+ - `viewportClassName` — Classes applied to the inner viewport element. Type: `string`.
3542
+
3543
+ **Composition**
3544
+
3545
+ - `ScrollBar` is a separate export that resolves the same compound implementation.
3546
+
3547
+ **Constrained list**
3548
+
3549
+ ```tsx
3550
+ import { ScrollArea, ScrollBar } from '@wildo-ai/saas-frontend-lib';
3551
+
3552
+ <ScrollArea className="h-48">
3553
+ <div className="p-4">{longContent}</div>
3554
+ <ScrollBar orientation="vertical" />
3555
+ </ScrollArea>
3556
+ ```
3557
+
3558
+ ## `Select`
3559
+
3560
+ Compound select menu for single choice fields.
3561
+
3562
+ **Composition**
3563
+
3564
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3565
+ - Compound component with `Select.Trigger`, `Select.Content`, etc.
3566
+
3567
+ ## `SelectMultiple`
3568
+
3569
+ Multi-select dropdown with badge summaries.
3570
+
3571
+ **Composition**
3572
+
3573
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3574
+
3575
+ ## `Separator`
3576
+
3577
+ Visual separator between flex or toolbar items (distinct from thematic `<hr>` divider).
3578
+
3579
+ **Props**
3580
+
3581
+ - `orientation` — Line orientation. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `horizontal` · `vertical`.
3582
+ - `horizontal` — Horizontal rule segment.
3583
+ - `vertical` — Vertical rule in row layouts.
3584
+ - `decorative` — Hide from assistive technology when purely visual. Type: `boolean`.
3585
+
3586
+ **Toolbar separator**
3587
+
3588
+ ```tsx
3589
+ import { Separator } from '@wildo-ai/saas-frontend-lib';
3590
+ import { DisplayDirection } from '@wildo-ai/zod-decorators';
3591
+
3592
+ <Separator orientation={DisplayDirection.VERTICAL} className="h-4" />
3593
+ ```
3594
+
3595
+ ## `Sheet`
3596
+
3597
+ Edge-anchored panel (top/right/bottom/left) for auxiliary workflows and pickers.
3598
+
3599
+ **Composition**
3600
+
3601
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3602
+
3603
+ ## `Sidebar`
3604
+
3605
+ Collapsible application sidebar shell with grouped navigation, inputs, and menu primitives.
3606
+
3607
+ **Composition**
3608
+
3609
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3610
+
3611
+ ## `Slider`
3612
+
3613
+ Compound slider for single-thumb numeric values.
3614
+
3615
+ **Composition**
3616
+
3617
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3618
+ - Compound component with `Slider.Root` for Radix wiring.
3619
+
3620
+ ## `StackedLayout`
3621
+
3622
+ Compose stacked application pages: header band, title, actions, toolbar, body with optional aside, and section variants.
3623
+
3624
+ **Props**
3625
+
3626
+ - `maxWidth` — Constrains content width for readability. Values: `full` · `xl` · `2xl` · `3xl` · `4xl` · `7xl`.
3627
+ - `full` — Use full available width.
3628
+ - `xl` — Narrower reading column.
3629
+ - `2xl` — Medium-wide layout.
3630
+ - `3xl` — Wider layout.
3631
+ - `4xl` — Extra-wide layout.
3632
+ - `7xl` — Maximum framework content width.
3633
+
3634
+ **Composition**
3635
+
3636
+ - Sub-components: `StackedLayout`, `StackedHeader`, `StackedTitle`, `StackedSubtitle`, `StackedActions`, `StackedToolbar`, `StackedBody`, `StackedAside`, `StackedContent`, `StackedSection`.
3637
+
3638
+ **Page scaffold**
3639
+
3640
+ ```tsx
3641
+ import {
3642
+ StackedLayout, StackedHeader, StackedTitle, StackedBody, StackedContent,
3643
+ } from '@wildo-ai/saas-frontend-lib';
3644
+
3645
+ <StackedLayout maxWidth="4xl">
3646
+ <StackedHeader>
3647
+ <StackedTitle>Account</StackedTitle>
3648
+ </StackedHeader>
3649
+ <StackedBody>
3650
+ <StackedContent>{children}</StackedContent>
3651
+ </StackedBody>
3652
+ </StackedLayout>
3653
+ ```
3654
+
3655
+ ## `Stepper`
3656
+
3657
+ Show progress through a linear workflow (wizard steps, onboarding checkpoints).
3658
+
3659
+ **Props**
3660
+
3661
+ - `currentStep` **(required)** — Position of the active step, counted from 0; each `StepperItem`/`StepperIndicator` `step` uses the same count, and the indicator shows it plus 1. Type: `number`.
3662
+ - `totalSteps` **(required)** — Total number of steps in the sequence. Type: `number`.
3663
+ - `orientation` — Horizontal or vertical stepper layout. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `horizontal` · `vertical`.
3664
+ - `horizontal` — Default inline steps.
3665
+ - `vertical` — Stacked steps.
3666
+
3667
+ **Composition**
3668
+
3669
+ - Each sub-component receives a `step` index tying it to the parent `currentStep` / `totalSteps`.
3670
+
3671
+ **Three-step flow, on the second step**
3672
+
3673
+ ```tsx
3674
+ import { Stepper, StepperItem, StepperIndicator, StepperTitle } from '@wildo-ai/saas-frontend-lib';
3675
+
3676
+ // Steps are counted from 0: the second step is step 1, and its indicator shows "2".
3677
+ <Stepper currentStep={1} totalSteps={3}>
3678
+ <StepperItem step={0}>
3679
+ <StepperIndicator step={0} />
3680
+ <StepperTitle step={0}>Account</StepperTitle>
3681
+ </StepperItem>
3682
+ <StepperItem step={1}>
3683
+ <StepperIndicator step={1} />
3684
+ <StepperTitle step={1}>Profile</StepperTitle>
3685
+ </StepperItem>
3686
+ </Stepper>
3687
+ ```
3688
+
3689
+ ## `Strong`
3690
+
3691
+ Emphasize a short span of inline copy using semantic `<strong>` with framework typography.
3692
+
3693
+ **Highlight a value**
3694
+
3695
+ ```tsx
3696
+ import { Text, Strong } from '@wildo-ai/saas-frontend-lib';
3697
+
3698
+ <Text>
3699
+ Total: <Strong>$120.00</Strong>
3700
+ </Text>
3701
+ ```
3702
+
3703
+ ## `Subheading`
3704
+
3705
+ Render a de-emphasized heading suitable for subtitles and secondary titles using the same semantic heading model as `Heading`.
3706
+
3707
+ **Props**
3708
+
3709
+ - `level` — Semantic heading level for the subtitle. Values: `1` · `2` · `3` · `4` · `5` · `6`. Default `2`.
3710
+ - `1` — Rare — only when subheading must be top-level for outline reasons.
3711
+ - `2` — Default subtitle level under an `h1`.
3712
+ - `3` — Nested subtitle.
3713
+ - `4` — Deeper nested subtitle.
3714
+ - `5` — Minor subtitle.
3715
+ - `6` — Smallest subtitle level.
3716
+
3717
+ **Composition**
3718
+
3719
+ - Shares `heading.tsx` implementation file with `Heading`; default level is 2 with reduced size classes.
3720
+
3721
+ **Subtitle under page title**
3722
+
3723
+ ```tsx
3724
+ import { Subheading } from '@wildo-ai/saas-frontend-lib';
3725
+
3726
+ <Subheading level={2}>Last updated today</Subheading>
3727
+ ```
3728
+
3729
+ ## `SubscriptionStatus`
3730
+
3731
+ Current subscription state, renewal timing, and trial badges.
3732
+
3733
+ **Composition**
3734
+
3735
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3736
+
3737
+ ## `Switch`
3738
+
3739
+ Toggle switch for boolean settings.
3740
+
3741
+ **Composition**
3742
+
3743
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3744
+
3745
+ ## `Table`
3746
+
3747
+ Render tabular data with semantic `<table>` structure and framework styling for header, body, and cells.
3748
+
3749
+ **Composition**
3750
+
3751
+ - Cell-level interaction patterns (row selection, sorting) are composed outside this primitive or via resource layouts.
3752
+
3753
+ **Simple table**
3754
+
3755
+ ```tsx
3756
+ import { Table, TableHeader, TableBody, TableRow, TableHead, TableCell } from '@wildo-ai/saas-frontend-lib';
3757
+
3758
+ <Table>
3759
+ <TableHeader>
3760
+ <TableRow>
3761
+ <TableHead>Name</TableHead>
3762
+ <TableHead>Status</TableHead>
3763
+ </TableRow>
3764
+ </TableHeader>
3765
+ <TableBody>
3766
+ <TableRow>
3767
+ <TableCell>Acme</TableCell>
3768
+ <TableCell>Active</TableCell>
3769
+ </TableRow>
3770
+ </TableBody>
3771
+ </Table>
3772
+ ```
3773
+
3774
+ ## `Tabs`
3775
+
3776
+ Switch between related views or settings panels without full page navigation.
3777
+
3778
+ **Props**
3779
+
3780
+ - `value` — Controlled active tab id. Type: `string`.
3781
+ - `defaultValue` — Initial tab id when uncontrolled. Type: `string`.
3782
+ - `onValueChange` — Fires when the active tab changes. Signature: `(value: string) => void`.
3783
+ - `orientation` — Horizontal or vertical tab list. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `horizontal` · `vertical`.
3784
+ - `horizontal` — Default top tabs.
3785
+ - `vertical` — Side rail tabs.
3786
+ - `activationMode` — Whether focusing a tab activates it automatically. **Enum** `TabsActivationMode` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `automatic` · `manual`.
3787
+ - `automatic` — Focus moves activation (default for many UIs).
3788
+ - `manual` — User must activate with Enter/Space.
3789
+ - `level` — Which level the set sits at. SECONDARY draws pills without a rule or a panel surface, for a set nested inside another (a record's tabs inside a page's); it is the default inside another Tabs and PRIMARY otherwise, so nesting needs no declaration. **Enum** `TabsLevel` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `primary` · `secondary`.
3790
+ - `primary` — The page's own tabs: an underline strip over a tab panel surface.
3791
+ - `secondary` — A nested set: small pills, no rule, no panel surface of its own.
3792
+
3793
+ **Composition**
3794
+
3795
+ - `activationMode` controls automatic vs manual tab activation (ARIA tabs pattern).
3796
+
3797
+ **Two tabs**
3798
+
3799
+ ```tsx
3800
+ import { Tabs, TabsList, TabsTrigger, TabsContent } from '@wildo-ai/saas-frontend-lib';
3801
+
3802
+ <Tabs defaultValue="a">
3803
+ <TabsList>
3804
+ <TabsTrigger value="a">Overview</TabsTrigger>
3805
+ <TabsTrigger value="b">Details</TabsTrigger>
3806
+ </TabsList>
3807
+ <TabsContent value="a">{overview}</TabsContent>
3808
+ <TabsContent value="b">{details}</TabsContent>
3809
+ </Tabs>
3810
+ ```
3811
+
3812
+ ## `Text`
3813
+
3814
+ Render body and inline copy using the design-system text scale instead of ad-hoc Tailwind size utilities.
3815
+
3816
+ **Props**
3817
+
3818
+ - `variant` — Semantic color variant for the text. **Enum** `TextVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `default` · `muted` · `subtle` · `contrast` · `destructive` · `success` · `inherit`.
3819
+ - `default` — Primary body text color.
3820
+ - `muted` — Secondary / de-emphasized copy.
3821
+ - `subtle` — The third level, below MUTED: meta copy — a time, a count, an attribution — that must not compete with a description.
3822
+ - `contrast` — High contrast on tinted surfaces.
3823
+ - `destructive` — Error or danger-adjacent copy.
3824
+ - `success` — Positive status copy.
3825
+ - `inherit` — Match parent color.
3826
+ - `typography` — The TYPOGRAPHY recipe the text is set in — BODY unless said otherwise; EYEBROW for a tracked uppercase label above a heading or a section. **Enum** `TypographyVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `body` · `eyebrow` · `description`. Default `body`.
3827
+ - `body` — Body copy — the default.
3828
+ - `eyebrow` — A small tracked uppercase label above a heading or a section, worded by the theme.
3829
+ - `description` — Descriptive copy beneath a title.
3830
+ - `size` — Type scale mapped to design-system CSS variables. **Enum** `TextSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `xxs` · `xs` · `sm` · `base` · `lg`.
3831
+ - `xxs` — Meta / badge scale.
3832
+ - `xs` — Compact helper text.
3833
+ - `sm` — Dense UI copy.
3834
+ - `base` — Default — inherits body scale.
3835
+ - `lg` — Emphasized body copy.
3836
+ - `as` — Element to render (`p`, `span`, or `div`) for block vs inline semantics. Values: `p` · `span` · `div`. Default `p`.
3837
+ - `p` — Default block paragraph.
3838
+ - `span` — Inline copy inside sentences or labels.
3839
+ - `div` — Neutral block container when paragraph semantics are wrong.
3840
+
3841
+ **Composition**
3842
+
3843
+ - Shares `text.tsx` with `Strong`, `Code`, and `TextLink` registrations in the presets package.
3844
+
3845
+ **Muted helper text**
3846
+
3847
+ ```tsx
3848
+ import { Text } from '@wildo-ai/saas-frontend-lib';
3849
+ import { TextVariant, TextSize } from '@wildo-ai/presets-components-models';
3850
+
3851
+ <Text variant={TextVariant.MUTED} size={TextSize.SM}>
3852
+ This field is optional.
3853
+ </Text>
3854
+ ```
3855
+
3856
+ ## `Textarea`
3857
+
3858
+ Multi-line text control with shared form-control recipes.
3859
+
3860
+ **Composition**
3861
+
3862
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3863
+
3864
+ ## `TextLink`
3865
+
3866
+ Expose the `Link` contract under a dedicated slot for inline prose so typography pipelines can distinguish text links from standalone anchors.
3867
+
3868
+ **Composition**
3869
+
3870
+ - Wrapper `TextLink` in `@wildo-ai/saas-frontend-lib` resolves to the `TextLink` implementation registered against this slot (backed by link styling in presets).
3871
+
3872
+ **Inline sentence link**
3873
+
3874
+ ```tsx
3875
+ import { Text, TextLink } from '@wildo-ai/saas-frontend-lib';
3876
+
3877
+ <Text>
3878
+ Read the <TextLink href="/docs">documentation</TextLink> for details.
3879
+ </Text>
3880
+ ```
3881
+
3882
+ ## `Timeline`
3883
+
3884
+ A chronological list along one rail: an entry per thing that happened, each with a marker in a theme tone, a time, a body and optional trailing actions.
3885
+
3886
+ **Props**
3887
+
3888
+ - `selectable` — The rail is a list a person picks from: it renders as a grid (give it an aria-label) and every entry carrying `option` renders as a row whose gridcell is the focusable, aria-selected entry. Without it the rail is an ordered list. Type: `boolean`.
3889
+ - `className` — Merged LAST, so a surface can override the preset treatment. Type: `string`.
3890
+
3891
+ **A run stream, newest first, with a hot entry and a settled one**
3892
+
3893
+ ```tsx
3894
+ import { Timeline, TimelineActions, TimelineBody, TimelineEntry, TimelineTime, Duration } from '@wildo-ai/saas-frontend-lib';
3895
+ import { IndicatorVariant } from '@wildo-ai/presets-components-models';
3896
+
3897
+ <Timeline>
3898
+ <TimelineEntry tone={IndicatorVariant.INFO}>
3899
+ <TimelineTime dateTime={run.startedAt}><Duration since={run.startedAt} /></TimelineTime>
3900
+ <TimelineBody>{run.playbookRef}</TimelineBody>
3901
+ </TimelineEntry>
3902
+ <TimelineEntry tone={IndicatorVariant.SUCCESS}>
3903
+ <TimelineTime dateTime={done.finishedAt}>{done.finishedAt}</TimelineTime>
3904
+ <TimelineBody>{done.playbookRef}</TimelineBody>
3905
+ <TimelineActions>{revertButton}</TimelineActions>
3906
+ </TimelineEntry>
3907
+ </Timeline>
3908
+ ```
3909
+
3910
+ **A stream a person picks from: the selected entry opens beside the rail**
3911
+
3912
+ ```tsx
3913
+ import { Timeline, TimelineActions, TimelineBody, TimelineEntry } from '@wildo-ai/saas-frontend-lib';
3914
+
3915
+ <Timeline selectable aria-label={streamLabel}>
3916
+ {writes.map((write) => (
3917
+ <TimelineEntry key={write.id} option={{ onSelect: () => open(write.id) }} selected={write.id === openId}>
3918
+ <TimelineBody>{write.title}</TimelineBody>
3919
+ <TimelineActions>{revertButtonFor(write)}</TimelineActions>
3920
+ </TimelineEntry>
3921
+ ))}
3922
+ </Timeline>
3923
+ ```
3924
+
3925
+ ## `TimePicker`
3926
+
3927
+ Time-of-day picker control.
3928
+
3929
+ **Composition**
3930
+
3931
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3932
+
3933
+ ## `TimeRangePicker`
3934
+
3935
+ Picker for start/end times within a day.
3936
+
3937
+ **Composition**
3938
+
3939
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3940
+
3941
+ ## `Toaster`
3942
+
3943
+ Global toast host (Sonner-backed) mounted once per app shell.
3944
+
3945
+ **Composition**
3946
+
3947
+ - The registry entry resolves to the `Toaster` component even though the enum name reads `LOW_LEVEL_TOAST`.
3948
+
3949
+ ## `Toggle`
3950
+
3951
+ Pressable toggle button styling (distinct from `Switch`).
3952
+
3953
+ **Composition**
3954
+
3955
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3956
+
3957
+ ## `ToggleGroup`
3958
+
3959
+ Segmented toggle group supporting single or multi selection.
3960
+
3961
+ **Composition**
3962
+
3963
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3964
+ - Compound component with `ToggleGroup.Item` accessors via `ToggleGroupItem` wrapper.
3965
+
3966
+ ## `ToggleGroupBoolean`
3967
+
3968
+ Specialized toggle group preset for boolean on/off pairings.
3969
+
3970
+ **Composition**
3971
+
3972
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3973
+
3974
+ ## `Tooltip`
3975
+
3976
+ Short hint surfaced on hover/focus with optional provider-level delay settings.
3977
+
3978
+ **Composition**
3979
+
3980
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3981
+
3982
+ ## `UsageDashboard`
3983
+
3984
+ Metered usage visualization with period selectors and limit callouts.
3985
+
3986
+ **Composition**
3987
+
3988
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.