@wildo-ai/saas-specifications 1.1.0 → 1.1.2

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 (423) hide show
  1. package/dist/assurance/external-framework-mapping.json +980 -0
  2. package/dist/esm/_core/brand/brand.family-aspects.d.ts +3 -0
  3. package/dist/esm/_core/brand/brand.family-aspects.d.ts.map +1 -0
  4. package/dist/esm/_core/brand/brand.family-aspects.js +51 -0
  5. package/dist/esm/_core/brand/brand.family-aspects.js.map +1 -0
  6. package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts +3 -0
  7. package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -0
  8. package/dist/esm/_core/build-plan/build-plan.family-aspects.js +28 -0
  9. package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -0
  10. package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts +3 -0
  11. package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts.map +1 -0
  12. package/dist/esm/_core/business-model-lite/business-model.family-aspects.js +21 -0
  13. package/dist/esm/_core/business-model-lite/business-model.family-aspects.js.map +1 -0
  14. package/dist/esm/_core/chart-view-specification.schemas.d.ts +11 -0
  15. package/dist/esm/_core/chart-view-specification.schemas.d.ts.map +1 -1
  16. package/dist/esm/_core/chart-view-specification.schemas.js.map +1 -1
  17. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts +85 -0
  18. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts.map +1 -1
  19. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js +41 -0
  20. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js.map +1 -1
  21. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +168 -2
  22. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
  23. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +98 -9
  24. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
  25. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts +12 -0
  26. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts.map +1 -0
  27. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.js +47 -0
  28. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.js.map +1 -0
  29. package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.d.ts.map +1 -1
  30. package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.js +8 -3
  31. package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.js.map +1 -1
  32. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts +21 -0
  33. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts.map +1 -0
  34. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.js +40 -0
  35. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.js.map +1 -0
  36. package/dist/esm/_core/composite-view-specification.schemas.d.ts +11 -0
  37. package/dist/esm/_core/composite-view-specification.schemas.d.ts.map +1 -1
  38. package/dist/esm/_core/composite-view-specification.schemas.js.map +1 -1
  39. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +3 -0
  40. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -0
  41. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +32 -0
  42. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -0
  43. package/dist/esm/_core/execution-view-specification.schemas.d.ts +11 -0
  44. package/dist/esm/_core/execution-view-specification.schemas.d.ts.map +1 -1
  45. package/dist/esm/_core/execution-view-specification.schemas.js.map +1 -1
  46. package/dist/esm/_core/family-aspects.registry.d.ts +18 -0
  47. package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -0
  48. package/dist/esm/_core/family-aspects.registry.js +60 -0
  49. package/dist/esm/_core/family-aspects.registry.js.map +1 -0
  50. package/dist/esm/_core/family-aspects.schemas.d.ts +122 -0
  51. package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -0
  52. package/dist/esm/_core/family-aspects.schemas.js +15 -0
  53. package/dist/esm/_core/family-aspects.schemas.js.map +1 -0
  54. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +11 -11
  55. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts +3 -0
  56. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts.map +1 -0
  57. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js +25 -0
  58. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js.map +1 -0
  59. package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts +11 -0
  60. package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts.map +1 -1
  61. package/dist/esm/_core/flows-actors-view-specification.schemas.js.map +1 -1
  62. package/dist/esm/_core/frontend-component-specification.schemas.d.ts.map +1 -1
  63. package/dist/esm/_core/frontend-component-specification.schemas.js +19 -1
  64. package/dist/esm/_core/frontend-component-specification.schemas.js.map +1 -1
  65. package/dist/esm/_core/full-custom-view-specification.schemas.d.ts +11 -0
  66. package/dist/esm/_core/full-custom-view-specification.schemas.d.ts.map +1 -1
  67. package/dist/esm/_core/full-custom-view-specification.schemas.js.map +1 -1
  68. package/dist/esm/_core/guidance-flow-specification.schemas.d.ts +11 -0
  69. package/dist/esm/_core/guidance-flow-specification.schemas.d.ts.map +1 -1
  70. package/dist/esm/_core/guidance-flow-specification.schemas.js +14 -0
  71. package/dist/esm/_core/guidance-flow-specification.schemas.js.map +1 -1
  72. package/dist/esm/_core/index.d.ts +2 -0
  73. package/dist/esm/_core/index.d.ts.map +1 -1
  74. package/dist/esm/_core/index.js +2 -0
  75. package/dist/esm/_core/index.js.map +1 -1
  76. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +22 -22
  77. package/dist/esm/_core/market/market.family-aspects.d.ts +9 -0
  78. package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -0
  79. package/dist/esm/_core/market/market.family-aspects.js +227 -0
  80. package/dist/esm/_core/market/market.family-aspects.js.map +1 -0
  81. package/dist/esm/_core/onboarding-view-specification.schemas.d.ts +11 -0
  82. package/dist/esm/_core/onboarding-view-specification.schemas.d.ts.map +1 -1
  83. package/dist/esm/_core/onboarding-view-specification.schemas.js +14 -0
  84. package/dist/esm/_core/onboarding-view-specification.schemas.js.map +1 -1
  85. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts +3 -0
  86. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -0
  87. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js +31 -0
  88. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js.map +1 -0
  89. package/dist/esm/_core/requirements/requirements.family-aspects.d.ts +9 -0
  90. package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -0
  91. package/dist/esm/_core/requirements/requirements.family-aspects.js +40 -0
  92. package/dist/esm/_core/requirements/requirements.family-aspects.js.map +1 -0
  93. package/dist/esm/_core/resource-specification.schemas.d.ts +22 -0
  94. package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
  95. package/dist/esm/_core/resource-specification.schemas.js.map +1 -1
  96. package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts +3 -0
  97. package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts.map +1 -0
  98. package/dist/esm/_core/roadmap/roadmap.family-aspects.js +26 -0
  99. package/dist/esm/_core/roadmap/roadmap.family-aspects.js.map +1 -0
  100. package/dist/esm/_core/vision/vision.family-aspects.d.ts +11 -0
  101. package/dist/esm/_core/vision/vision.family-aspects.d.ts.map +1 -0
  102. package/dist/esm/_core/vision/vision.family-aspects.js +63 -0
  103. package/dist/esm/_core/vision/vision.family-aspects.js.map +1 -0
  104. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +188 -33
  105. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
  106. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +158 -57
  107. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
  108. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts +38 -4
  109. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts.map +1 -1
  110. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js +37 -3
  111. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js.map +1 -1
  112. package/dist/esm/application-creation/document-facts.family-aspects.d.ts +12 -0
  113. package/dist/esm/application-creation/document-facts.family-aspects.d.ts.map +1 -0
  114. package/dist/esm/application-creation/document-facts.family-aspects.js +37 -0
  115. package/dist/esm/application-creation/document-facts.family-aspects.js.map +1 -0
  116. package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts +3 -0
  117. package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts.map +1 -0
  118. package/dist/esm/application-creation/document-release-policy.family-aspects.js +23 -0
  119. package/dist/esm/application-creation/document-release-policy.family-aspects.js.map +1 -0
  120. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +93 -62
  121. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
  122. package/dist/esm/application-creation/playbooks.application-creation.schemas.js +114 -59
  123. package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
  124. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts +2 -0
  125. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
  126. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js +2 -0
  127. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js.map +1 -1
  128. package/dist/esm/application-creation.exports.d.ts +11 -0
  129. package/dist/esm/application-creation.exports.d.ts.map +1 -1
  130. package/dist/esm/application-creation.exports.js +11 -0
  131. package/dist/esm/application-creation.exports.js.map +1 -1
  132. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +976 -2
  133. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
  134. package/dist/esm/assurance/assurance-authority-basis.definitions.js +2026 -61
  135. package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
  136. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +1 -0
  137. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
  138. package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
  139. package/dist/esm/assurance/assurance-document-system.definitions.js +18 -3
  140. package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
  141. package/dist/esm/assurance/assurance-document-system.schemas.d.ts +32 -2
  142. package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
  143. package/dist/esm/assurance/assurance-document-system.schemas.js +32 -2
  144. package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
  145. package/dist/esm/assurance/assurance-external-framework-mapping.d.ts +90 -0
  146. package/dist/esm/assurance/assurance-external-framework-mapping.d.ts.map +1 -0
  147. package/dist/esm/assurance/assurance-external-framework-mapping.js +134 -0
  148. package/dist/esm/assurance/assurance-external-framework-mapping.js.map +1 -0
  149. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +71 -1
  150. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
  151. package/dist/esm/assurance/assurance-objective-catalog.definitions.js +545 -5
  152. package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
  153. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +141 -0
  154. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -0
  155. package/dist/esm/assurance/assurance-program-generation.schemas.js +377 -0
  156. package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -0
  157. package/dist/esm/assurance/assurance-program.family-aspects.d.ts +13 -0
  158. package/dist/esm/assurance/assurance-program.family-aspects.d.ts.map +1 -0
  159. package/dist/esm/assurance/assurance-program.family-aspects.js +16 -0
  160. package/dist/esm/assurance/assurance-program.family-aspects.js.map +1 -0
  161. package/dist/esm/assurance/assurance-program.schemas.d.ts +30 -6
  162. package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
  163. package/dist/esm/assurance/assurance-program.schemas.js +29 -6
  164. package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
  165. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts +1 -0
  166. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
  167. package/dist/esm/assurance/assurance-source-registry.definitions.js +12 -0
  168. package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
  169. package/dist/esm/assurance/assurance-sources.schemas.d.ts +76 -0
  170. package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
  171. package/dist/esm/assurance/assurance-sources.schemas.js +59 -0
  172. package/dist/esm/assurance/assurance-sources.schemas.js.map +1 -1
  173. package/dist/esm/assurance/document-publication.family-aspects.d.ts +29 -0
  174. package/dist/esm/assurance/document-publication.family-aspects.d.ts.map +1 -0
  175. package/dist/esm/assurance/document-publication.family-aspects.js +48 -0
  176. package/dist/esm/assurance/document-publication.family-aspects.js.map +1 -0
  177. package/dist/esm/assurance.exports.d.ts +2 -0
  178. package/dist/esm/assurance.exports.d.ts.map +1 -1
  179. package/dist/esm/assurance.exports.js +2 -0
  180. package/dist/esm/assurance.exports.js.map +1 -1
  181. package/dist/esm/companion-exports.d.ts +19 -2
  182. package/dist/esm/companion-exports.d.ts.map +1 -1
  183. package/dist/esm/companion-exports.js.map +1 -1
  184. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
  185. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +2 -0
  186. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
  187. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
  188. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +3 -1
  189. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
  190. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
  191. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +3 -1
  192. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
  193. package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
  194. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +3 -1
  195. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
  196. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
  197. package/dist/esm/engine/applications/resources/applications.resource.specification.js +3 -1
  198. package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
  199. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts +36 -0
  200. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts.map +1 -0
  201. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js +193 -0
  202. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -0
  203. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts +1 -1
  204. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts.map +1 -1
  205. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +2 -0
  206. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
  207. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
  208. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +2 -0
  209. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
  210. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
  211. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +3 -1
  212. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
  213. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts +1 -1
  214. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
  215. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +2 -0
  216. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
  217. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
  218. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +2 -0
  219. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
  220. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
  221. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +2 -0
  222. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
  223. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
  224. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +2 -0
  225. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
  226. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
  227. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +6 -4
  228. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
  229. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
  230. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +2 -0
  231. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
  232. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
  233. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +2 -0
  234. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.map +1 -1
  235. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts +2 -2
  236. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
  237. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +2 -0
  238. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
  239. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts +8 -8
  240. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
  241. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +2 -0
  242. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
  243. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts +2 -2
  244. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts.map +1 -1
  245. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +2 -0
  246. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
  247. package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
  248. package/dist/esm/engine/billing/resources/prices.resource.specification.js +3 -1
  249. package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
  250. package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
  251. package/dist/esm/engine/billing/resources/products.resource.specification.js +3 -1
  252. package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
  253. package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
  254. package/dist/esm/engine/billing/resources/promotions.resource.specification.js +2 -0
  255. package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
  256. package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
  257. package/dist/esm/engine/billing/resources/referrals.resource.specification.js +3 -1
  258. package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
  259. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +6 -6
  260. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
  261. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +2 -0
  262. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
  263. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +6 -6
  264. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
  265. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +2 -0
  266. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
  267. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
  268. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +2 -0
  269. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
  270. package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
  271. package/dist/esm/engine/engine-resource-specifications.registry.js +5 -0
  272. package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
  273. package/dist/esm/engine/engine-resource-sub-domain.d.ts +63 -0
  274. package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -0
  275. package/dist/esm/engine/engine-resource-sub-domain.js +87 -0
  276. package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -0
  277. package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
  278. package/dist/esm/engine/errors/error-messages.specification.js +30 -1
  279. package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
  280. package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
  281. package/dist/esm/engine/features/resources/application-features.resource.specification.js +2 -0
  282. package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
  283. package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts.map +1 -1
  284. package/dist/esm/engine/features/resources/organization-features.resource.specification.js +2 -0
  285. package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
  286. package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts +1 -1
  287. package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts.map +1 -1
  288. package/dist/esm/engine/features/resources/user-features.resource.specification.js +2 -0
  289. package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
  290. package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
  291. package/dist/esm/engine/files/resources/files.resource.specification.js +2 -0
  292. package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
  293. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts +3 -3
  294. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
  295. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +12 -0
  296. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
  297. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.d.ts +3 -3
  298. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.d.ts.map +1 -1
  299. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +2 -0
  300. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
  301. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts +3 -3
  302. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
  303. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +2 -0
  304. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
  305. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts +3 -3
  306. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
  307. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +3 -1
  308. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.map +1 -1
  309. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.d.ts.map +1 -1
  310. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js +8 -3
  311. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js.map +1 -1
  312. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.d.ts +1 -1
  313. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.d.ts.map +1 -1
  314. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +3 -0
  315. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
  316. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts +1 -1
  317. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
  318. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +3 -0
  319. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
  320. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts +1 -1
  321. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
  322. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +3 -0
  323. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
  324. package/dist/esm/engine/index.d.ts +1 -0
  325. package/dist/esm/engine/index.d.ts.map +1 -1
  326. package/dist/esm/engine/index.js +1 -0
  327. package/dist/esm/engine/index.js.map +1 -1
  328. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.d.ts.map +1 -1
  329. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +2 -0
  330. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
  331. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
  332. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +2 -0
  333. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
  334. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
  335. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +2 -0
  336. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
  337. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts.map +1 -1
  338. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +2 -0
  339. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
  340. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
  341. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +2 -0
  342. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
  343. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts +1 -1
  344. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
  345. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +3 -0
  346. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
  347. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
  348. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +2 -0
  349. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
  350. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +1 -1
  351. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
  352. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +2 -0
  353. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
  354. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.d.ts.map +1 -1
  355. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +2 -0
  356. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
  357. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.d.ts.map +1 -1
  358. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +2 -0
  359. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
  360. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
  361. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +2 -0
  362. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
  363. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
  364. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +2 -0
  365. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
  366. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
  367. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js +2 -0
  368. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.map +1 -1
  369. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
  370. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +2 -0
  371. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
  372. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts.map +1 -1
  373. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +2 -0
  374. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
  375. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts +1 -1
  376. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts.map +1 -1
  377. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +2 -0
  378. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
  379. package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts +1 -1
  380. package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts.map +1 -1
  381. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +2 -0
  382. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
  383. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts +1 -1
  384. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts.map +1 -1
  385. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +2 -0
  386. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
  387. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +1 -1
  388. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
  389. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +2 -0
  390. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
  391. package/dist/esm/engine/users/resources/user-profiles.resource.specification.d.ts +1 -1
  392. package/dist/esm/engine/users/resources/user-profiles.resource.specification.d.ts.map +1 -1
  393. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +2 -0
  394. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
  395. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +1 -1
  396. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
  397. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +2 -0
  398. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
  399. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.d.ts +1 -1
  400. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.d.ts.map +1 -1
  401. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +2 -0
  402. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
  403. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
  404. package/dist/esm/engine/users/resources/user-self.resource.specification.js +3 -1
  405. package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
  406. package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
  407. package/dist/esm/engine/users/resources/users.resource.specification.js +2 -0
  408. package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
  409. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts +5 -0
  410. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
  411. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +385 -9
  412. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
  413. package/dist/esm/technical-documentation/technical-documentation-units.schemas.js +1 -1
  414. package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
  415. package/dist/tsconfig.build.tsbuildinfo +1 -0
  416. package/package.json +8 -8
  417. package/dist/esm/.builder.pid +0 -9
  418. package/dist/esm/_core/business-coverage/coverage-findings-validation.d.ts +0 -0
  419. package/dist/esm/_core/business-coverage/coverage-findings-validation.d.ts.map +0 -0
  420. package/dist/esm/_core/business-coverage/coverage-findings-validation.js.map +0 -0
  421. package/dist/esm/_core/business-coverage/coverage-findings.schemas.d.ts +0 -0
  422. package/dist/esm/_core/business-coverage/coverage-findings.schemas.d.ts.map +0 -0
  423. package/dist/esm/_core/business-coverage/coverage-findings.schemas.js.map +0 -0
@@ -0,0 +1,122 @@
1
+ import type { z } from 'zod';
2
+ /**
3
+ * FAMILY ASPECTS — the canonical declaration of a specification family's SECOND-LEVEL structure.
4
+ *
5
+ * ## What this is
6
+ *
7
+ * Every `_core` family snapshot is a document holding collections and singletons — the vision's
8
+ * success criteria, the market's ICPs and personas, the requirements' functional entries. Those
9
+ * members reference EACH OTHER by business key (`icpRefs`, `deliversRequirementRefs`,
10
+ * `belongsToIcpRefs`, …): the families form one product GRAPH that the snapshot files flatten.
11
+ *
12
+ * This module is the contract for declaring that graph ONCE, beside the schemas that own it
13
+ * (decided 2026-09-01: schemas stay authoritative — a family's aspect declaration is colocated
14
+ * with the family, never re-derived downstream). Everything that makes an aspect a navigable
15
+ * RESOURCE derives from the declaration: the workbench's introspection projections, the aspect
16
+ * resource surfaces, the REFERENCE relationships, and the reference-popup navigation.
17
+ *
18
+ * ## What this is NOT
19
+ *
20
+ * Not a reshape of any family schema — the snapshots stay exactly as authored and validated.
21
+ * Not a persistence model — aspect rows are DERIVED per read from the landed files (git is the
22
+ * database), exactly like the specification-artifacts rows they refine.
23
+ *
24
+ * The platform spine (platform-core-shared) deliberately never imports this package; it carries
25
+ * a plain-data descriptor table whose keys a registry test pins against these declarations —
26
+ * the same split `APPLICATION_SPECIFICATION_SEMANTIC_SCHEMA_BINDINGS` already makes.
27
+ */
28
+ /**
29
+ * Global aspect key: `<family-domain>.<aspect>`, kebab-case, unique across ALL families —
30
+ * it names the aspect KIND everywhere (edge targets, resource surfaces, projections).
31
+ */
32
+ export type FamilyAspectKey = `${string}.${string}`;
33
+ /**
34
+ * One reference EDGE from this aspect's items to another aspect's items.
35
+ */
36
+ export interface FamilyAspectEdge {
37
+ /**
38
+ * The field on the ITEM schema carrying the reference(s) — a business-key string, an array of
39
+ * them, or (with `throughField`) an array of edge OBJECTS each carrying the key.
40
+ */
41
+ readonly field: string;
42
+ /**
43
+ * For weighted/qualified edge objects (`jobs: JobEdge[]` where `JobEdge.jobRef` holds the key):
44
+ * the ref-carrying subfield of each array entry — itself either one key or an ARRAY of keys
45
+ * (`valuePillars[].backedByBenefitRefs`). Absent for plain string / string[] fields.
46
+ */
47
+ readonly throughField?: string;
48
+ /**
49
+ * The aspect KIND(s) the reference may point at. Usually one; more when a field legitimately
50
+ * holds keys of several kinds — a roadmap phase's `deliversRequirementRefs` carries functional
51
+ * AND non-functional requirement keys, told apart by their namespaced prefixes. Resolution is
52
+ * membership: the key belongs to whichever target aspect's key set contains it.
53
+ */
54
+ readonly targetAspects: readonly FamilyAspectKey[];
55
+ }
56
+ /**
57
+ * How an aspect is SHAPED inside the family snapshot, which decides how a reader addresses its rows.
58
+ *
59
+ * The distinction is not cosmetic: it selects the identity contract. A COLLECTION carries many items
60
+ * and needs a business key (or an index fallback) to name one; a SINGLETON is one object per family,
61
+ * so the aspect key IS its identity and a business key would be a second name for the same row.
62
+ */
63
+ export declare enum FamilyAspectKind {
64
+ /** An array of items — icps, features, requirements. Rows are addressed by business key or index. */
65
+ COLLECTION = "collection",
66
+ /** One object per family — mission, problem, idea. The aspect key is the row's identity. */
67
+ SINGLETON = "singleton"
68
+ }
69
+ /**
70
+ * One second-level aspect of a family snapshot.
71
+ */
72
+ export interface FamilyAspectDeclaration {
73
+ /** Global aspect key — see {@link FamilyAspectKey}. */
74
+ readonly key: FamilyAspectKey;
75
+ /** Top-level member of the family snapshot this aspect reads from (`'icps'`, `'mission'`). */
76
+ readonly snapshotPath: string;
77
+ /** How this aspect is shaped inside the family snapshot — see {@link FamilyAspectKind}. */
78
+ readonly kind: FamilyAspectKind;
79
+ /** The item's authoritative Zod schema — the SAME instance the snapshot schema composes. */
80
+ readonly itemSchema: z.ZodTypeAny;
81
+ /**
82
+ * The item field whose value is the aspect's BUSINESS KEY (`'ref'`, `'featureRef'`, …).
83
+ * Undefined for singletons (identity = the aspect key — one per family) and for the rare
84
+ * collection whose schema declares no single-field key (a publication VARIANT is keyed by
85
+ * locale × jurisdictions): there, row identity falls back to `<aspectKey>[<index>]`, which is
86
+ * stable per landed snapshot and honest about carrying no business meaning.
87
+ */
88
+ readonly businessKey?: string;
89
+ /**
90
+ * The item field a reader meets first — the popup/summary headline.
91
+ *
92
+ * A DOTTED PATH is allowed (`'draft.purpose'`) for the families whose reader-facing name sits
93
+ * under a wrapper the schema needs and a reader does not: a feature draft is
94
+ * `{featureRef, draft: {purpose, …}}` because the payload is authored ref-lessly, so its only
95
+ * top-level string is the machine slug. Naming the slug there made every reference TO a feature
96
+ * draft — and its own popup header — read `feature-deal-owner` where its siblings read a
97
+ * sentence. Resolution walks plain objects only; a path that misses falls back to the row
98
+ * identity, and the registry pin refuses a path the item schema does not carry.
99
+ */
100
+ readonly headlineField: string;
101
+ /** Every reference this aspect's items carry toward other aspects. */
102
+ readonly edges: readonly FamilyAspectEdge[];
103
+ /**
104
+ * Item fields that LOOK like references (`*Ref`/`*Refs`) but deliberately are not edges —
105
+ * external vocabularies, machine addresses, refs whose target is not an aspect. Each entry
106
+ * carries the reason, so the drift pin (every ref-shaped field is an edge OR is listed here)
107
+ * refuses silence instead of guessing.
108
+ */
109
+ readonly nonEdgeRefFields?: Readonly<Record<string, string>>;
110
+ }
111
+ /**
112
+ * A family's whole aspect declaration — authored beside the family's `_core` schemas.
113
+ */
114
+ export interface FamilyAspectsDeclaration {
115
+ /**
116
+ * The family's semantic schema ref (`ApplicationSpecificationFamilySemanticSchemaRef` value) —
117
+ * the same identity the artifact rows carry as `schemaRef`, which is what keys the registry.
118
+ */
119
+ readonly schemaRef: string;
120
+ readonly aspects: readonly FamilyAspectDeclaration[];
121
+ }
122
+ //# sourceMappingURL=family-aspects.schemas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-aspects.schemas.d.ts","sourceRoot":"","sources":["../../../../src/_core/family-aspects.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,eAAe,EAAE,CAAC;CACpD;AAED;;;;;;GAMG;AACH,oBAAY,gBAAgB;IAC1B,qGAAqG;IACrG,UAAU,eAAe;IACzB,4FAA4F;IAC5F,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACtD"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * How an aspect is SHAPED inside the family snapshot, which decides how a reader addresses its rows.
3
+ *
4
+ * The distinction is not cosmetic: it selects the identity contract. A COLLECTION carries many items
5
+ * and needs a business key (or an index fallback) to name one; a SINGLETON is one object per family,
6
+ * so the aspect key IS its identity and a business key would be a second name for the same row.
7
+ */
8
+ export var FamilyAspectKind;
9
+ (function (FamilyAspectKind) {
10
+ /** An array of items — icps, features, requirements. Rows are addressed by business key or index. */
11
+ FamilyAspectKind["COLLECTION"] = "collection";
12
+ /** One object per family — mission, problem, idea. The aspect key is the row's identity. */
13
+ FamilyAspectKind["SINGLETON"] = "singleton";
14
+ })(FamilyAspectKind || (FamilyAspectKind = {}));
15
+ //# sourceMappingURL=family-aspects.schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-aspects.schemas.js","sourceRoot":"","sources":["../../../../src/_core/family-aspects.schemas.ts"],"names":[],"mappings":"AA2DA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,qGAAqG;IACrG,6CAAyB,CAAA;IACzB,4FAA4F;IAC5F,2CAAuB,CAAA;AACzB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B","sourcesContent":["import type { z } from 'zod';\n\n/**\n * FAMILY ASPECTS — the canonical declaration of a specification family's SECOND-LEVEL structure.\n *\n * ## What this is\n *\n * Every `_core` family snapshot is a document holding collections and singletons — the vision's\n * success criteria, the market's ICPs and personas, the requirements' functional entries. Those\n * members reference EACH OTHER by business key (`icpRefs`, `deliversRequirementRefs`,\n * `belongsToIcpRefs`, …): the families form one product GRAPH that the snapshot files flatten.\n *\n * This module is the contract for declaring that graph ONCE, beside the schemas that own it\n * (decided 2026-09-01: schemas stay authoritative — a family's aspect declaration is colocated\n * with the family, never re-derived downstream). Everything that makes an aspect a navigable\n * RESOURCE derives from the declaration: the workbench's introspection projections, the aspect\n * resource surfaces, the REFERENCE relationships, and the reference-popup navigation.\n *\n * ## What this is NOT\n *\n * Not a reshape of any family schema — the snapshots stay exactly as authored and validated.\n * Not a persistence model — aspect rows are DERIVED per read from the landed files (git is the\n * database), exactly like the specification-artifacts rows they refine.\n *\n * The platform spine (platform-core-shared) deliberately never imports this package; it carries\n * a plain-data descriptor table whose keys a registry test pins against these declarations —\n * the same split `APPLICATION_SPECIFICATION_SEMANTIC_SCHEMA_BINDINGS` already makes.\n */\n\n/**\n * Global aspect key: `<family-domain>.<aspect>`, kebab-case, unique across ALL families —\n * it names the aspect KIND everywhere (edge targets, resource surfaces, projections).\n */\nexport type FamilyAspectKey = `${string}.${string}`;\n\n/**\n * One reference EDGE from this aspect's items to another aspect's items.\n */\nexport interface FamilyAspectEdge {\n /**\n * The field on the ITEM schema carrying the reference(s) — a business-key string, an array of\n * them, or (with `throughField`) an array of edge OBJECTS each carrying the key.\n */\n readonly field: string;\n /**\n * For weighted/qualified edge objects (`jobs: JobEdge[]` where `JobEdge.jobRef` holds the key):\n * the ref-carrying subfield of each array entry — itself either one key or an ARRAY of keys\n * (`valuePillars[].backedByBenefitRefs`). Absent for plain string / string[] fields.\n */\n readonly throughField?: string;\n /**\n * The aspect KIND(s) the reference may point at. Usually one; more when a field legitimately\n * holds keys of several kinds — a roadmap phase's `deliversRequirementRefs` carries functional\n * AND non-functional requirement keys, told apart by their namespaced prefixes. Resolution is\n * membership: the key belongs to whichever target aspect's key set contains it.\n */\n readonly targetAspects: readonly FamilyAspectKey[];\n}\n\n/**\n * How an aspect is SHAPED inside the family snapshot, which decides how a reader addresses its rows.\n *\n * The distinction is not cosmetic: it selects the identity contract. A COLLECTION carries many items\n * and needs a business key (or an index fallback) to name one; a SINGLETON is one object per family,\n * so the aspect key IS its identity and a business key would be a second name for the same row.\n */\nexport enum FamilyAspectKind {\n /** An array of items — icps, features, requirements. Rows are addressed by business key or index. */\n COLLECTION = 'collection',\n /** One object per family — mission, problem, idea. The aspect key is the row's identity. */\n SINGLETON = 'singleton',\n}\n\n/**\n * One second-level aspect of a family snapshot.\n */\nexport interface FamilyAspectDeclaration {\n /** Global aspect key — see {@link FamilyAspectKey}. */\n readonly key: FamilyAspectKey;\n /** Top-level member of the family snapshot this aspect reads from (`'icps'`, `'mission'`). */\n readonly snapshotPath: string;\n /** How this aspect is shaped inside the family snapshot — see {@link FamilyAspectKind}. */\n readonly kind: FamilyAspectKind;\n /** The item's authoritative Zod schema — the SAME instance the snapshot schema composes. */\n readonly itemSchema: z.ZodTypeAny;\n /**\n * The item field whose value is the aspect's BUSINESS KEY (`'ref'`, `'featureRef'`, …).\n * Undefined for singletons (identity = the aspect key — one per family) and for the rare\n * collection whose schema declares no single-field key (a publication VARIANT is keyed by\n * locale × jurisdictions): there, row identity falls back to `<aspectKey>[<index>]`, which is\n * stable per landed snapshot and honest about carrying no business meaning.\n */\n readonly businessKey?: string;\n /**\n * The item field a reader meets first — the popup/summary headline.\n *\n * A DOTTED PATH is allowed (`'draft.purpose'`) for the families whose reader-facing name sits\n * under a wrapper the schema needs and a reader does not: a feature draft is\n * `{featureRef, draft: {purpose, …}}` because the payload is authored ref-lessly, so its only\n * top-level string is the machine slug. Naming the slug there made every reference TO a feature\n * draft — and its own popup header — read `feature-deal-owner` where its siblings read a\n * sentence. Resolution walks plain objects only; a path that misses falls back to the row\n * identity, and the registry pin refuses a path the item schema does not carry.\n */\n readonly headlineField: string;\n /** Every reference this aspect's items carry toward other aspects. */\n readonly edges: readonly FamilyAspectEdge[];\n /**\n * Item fields that LOOK like references (`*Ref`/`*Refs`) but deliberately are not edges —\n * external vocabularies, machine addresses, refs whose target is not an aspect. Each entry\n * carries the reason, so the drift pin (every ref-shaped field is an edge OR is listed here)\n * refuses silence instead of guessing.\n */\n readonly nonEdgeRefFields?: Readonly<Record<string, string>>;\n}\n\n/**\n * A family's whole aspect declaration — authored beside the family's `_core` schemas.\n */\nexport interface FamilyAspectsDeclaration {\n /**\n * The family's semantic schema ref (`ApplicationSpecificationFamilySemanticSchemaRef` value) —\n * the same identity the artifact rows carry as `schemaRef`, which is what keys the registry.\n */\n readonly schemaRef: string;\n readonly aspects: readonly FamilyAspectDeclaration[];\n}\n"]}
@@ -133,22 +133,22 @@ export declare const CapabilityMapOutputSetGenerationSchema: z.ZodObject<{
133
133
  slug: z.ZodString;
134
134
  } & {
135
135
  statement: z.ZodString;
136
+ successCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
136
137
  jobKind: z.ZodEnum<typeof import("..").JobKind>;
137
138
  context: z.ZodOptional<z.ZodString>;
138
- successCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
139
139
  }, z.core.$strict>>;
140
140
  pains: z.ZodArray<z.ZodObject<{
141
141
  slug: z.ZodString;
142
142
  } & {
143
- evidence: z.ZodDefault<z.ZodArray<z.ZodString>>;
144
143
  statement: z.ZodString;
145
144
  painKind: z.ZodEnum<typeof import("..").PainKind>;
145
+ evidence: z.ZodDefault<z.ZodArray<z.ZodString>>;
146
146
  }, z.core.$strict>>;
147
147
  gains: z.ZodArray<z.ZodObject<{
148
148
  slug: z.ZodString;
149
149
  } & {
150
- evidence: z.ZodDefault<z.ZodArray<z.ZodString>>;
151
150
  statement: z.ZodString;
151
+ evidence: z.ZodDefault<z.ZodArray<z.ZodString>>;
152
152
  gainKind: z.ZodEnum<typeof import("..").GainKind>;
153
153
  }, z.core.$strict>>;
154
154
  tonesOfVoice: z.ZodArray<z.ZodObject<{
@@ -170,8 +170,9 @@ export declare const CapabilityMapOutputSetGenerationSchema: z.ZodObject<{
170
170
  slug: z.ZodString;
171
171
  } & {
172
172
  role: z.ZodEnum<typeof import("..").BenefitRole>;
173
- claim: z.ZodString;
173
+ proofRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
174
174
  evidence: z.ZodOptional<z.ZodString>;
175
+ claim: z.ZodString;
175
176
  deliveredByFeatureRefs: z.ZodArray<z.ZodString>;
176
177
  differentiation: z.ZodOptional<z.ZodString>;
177
178
  relieves: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -191,7 +192,6 @@ export declare const CapabilityMapOutputSetGenerationSchema: z.ZodObject<{
191
192
  weight: z.ZodNumber;
192
193
  kanoCategory: z.ZodEnum<typeof import("..").BenefitKanoCategory>;
193
194
  }, z.core.$strip>>>;
194
- proofRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
195
195
  addressesObjectionRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
196
196
  }, z.core.$strict>>;
197
197
  positionings: z.ZodArray<z.ZodObject<{
@@ -264,6 +264,11 @@ export declare const CapabilityMapOutputSetGenerationSchema: z.ZodObject<{
264
264
  slug: z.ZodString;
265
265
  } & {
266
266
  statement: z.ZodString;
267
+ metric: z.ZodOptional<z.ZodObject<{
268
+ value: z.ZodNumber;
269
+ unit: z.ZodString;
270
+ period: z.ZodOptional<z.ZodString>;
271
+ }, z.core.$strip>>;
267
272
  proofKind: z.ZodEnum<typeof import("..").ProofKind>;
268
273
  attribution: z.ZodOptional<z.ZodObject<{
269
274
  name: z.ZodString;
@@ -271,11 +276,6 @@ export declare const CapabilityMapOutputSetGenerationSchema: z.ZodObject<{
271
276
  company: z.ZodOptional<z.ZodString>;
272
277
  url: z.ZodOptional<z.ZodURL>;
273
278
  }, z.core.$strip>>;
274
- metric: z.ZodOptional<z.ZodObject<{
275
- value: z.ZodNumber;
276
- unit: z.ZodString;
277
- period: z.ZodOptional<z.ZodString>;
278
- }, z.core.$strip>>;
279
279
  evidenceUrl: z.ZodOptional<z.ZodURL>;
280
280
  supportsBenefitRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
281
281
  supportsIcpRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -283,8 +283,8 @@ export declare const CapabilityMapOutputSetGenerationSchema: z.ZodObject<{
283
283
  objections: z.ZodArray<z.ZodObject<{
284
284
  slug: z.ZodString;
285
285
  } & {
286
- proofRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
287
286
  statement: z.ZodString;
287
+ proofRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
288
288
  objectionKind: z.ZodEnum<typeof import("..").ObjectionKind>;
289
289
  raisedByIcpRefs: z.ZodArray<z.ZodString>;
290
290
  raisedByPersonaRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -0,0 +1,3 @@
1
+ import type { FamilyAspectsDeclaration } from '../family-aspects.schemas';
2
+ export declare const FEATURE_DRAFTS_FAMILY_ASPECTS: FamilyAspectsDeclaration;
3
+ //# sourceMappingURL=feature-drafts.family-aspects.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feature-drafts.family-aspects.d.ts","sourceRoot":"","sources":["../../../../../src/_core/feature-drafts/feature-drafts.family-aspects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAI1E,eAAO,MAAM,6BAA6B,EAAE,wBAoB3C,CAAC"}
@@ -0,0 +1,25 @@
1
+ import { ApplicationSpecificationFamilySemanticSchemaRef } from '../../application-creation/application-specification-family-identity.application-creation.schemas.js';
2
+ import { FamilyAspectKind } from '../family-aspects.schemas.js';
3
+ import { FeatureSpecificationDraftArtifactSchema } from './feature-specification-drafts.schemas.js';
4
+ export const FEATURE_DRAFTS_FAMILY_ASPECTS = {
5
+ schemaRef: ApplicationSpecificationFamilySemanticSchemaRef.FEATURE_SPECIFICATION_DRAFTS,
6
+ aspects: [
7
+ {
8
+ key: 'feature-drafts.draft',
9
+ snapshotPath: 'drafts',
10
+ kind: FamilyAspectKind.COLLECTION,
11
+ itemSchema: FeatureSpecificationDraftArtifactSchema,
12
+ businessKey: 'featureRef',
13
+ /*
14
+ * The PURPOSE, not the ref. `featureRef` is the business key and the only top-level string
15
+ * this item carries — the payload is authored ref-lessly under `draft` — so naming it here
16
+ * made a feature draft the one aspect whose headline was a machine slug: its popup header,
17
+ * and every reference to it from a benefit or a build task, read `feature-deal-owner` while
18
+ * every sibling aspect read a sentence.
19
+ */
20
+ headlineField: 'draft.purpose',
21
+ edges: [],
22
+ },
23
+ ],
24
+ };
25
+ //# sourceMappingURL=feature-drafts.family-aspects.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feature-drafts.family-aspects.js","sourceRoot":"","sources":["../../../../../src/_core/feature-drafts/feature-drafts.family-aspects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+CAA+C,EAAE,MAAM,mGAAmG,CAAC;AAEpK,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,uCAAuC,EAAE,MAAM,wCAAwC,CAAC;AAEjG,MAAM,CAAC,MAAM,6BAA6B,GAA6B;IACrE,SAAS,EAAE,+CAA+C,CAAC,4BAA4B;IACvF,OAAO,EAAE;QACP;YACE,GAAG,EAAE,sBAAsB;YAC3B,YAAY,EAAE,QAAQ;YACtB,IAAI,EAAE,gBAAgB,CAAC,UAAU;YACjC,UAAU,EAAE,uCAAuC;YACnD,WAAW,EAAE,YAAY;YACzB;;;;;;eAMG;YACH,aAAa,EAAE,eAAe;YAC9B,KAAK,EAAE,EAAE;SACV;KACF;CACF,CAAC","sourcesContent":["import { ApplicationSpecificationFamilySemanticSchemaRef } from '../../application-creation/application-specification-family-identity.application-creation.schemas';\nimport type { FamilyAspectsDeclaration } from '../family-aspects.schemas';\nimport { FamilyAspectKind } from '../family-aspects.schemas';\nimport { FeatureSpecificationDraftArtifactSchema } from './feature-specification-drafts.schemas';\n\nexport const FEATURE_DRAFTS_FAMILY_ASPECTS: FamilyAspectsDeclaration = {\n schemaRef: ApplicationSpecificationFamilySemanticSchemaRef.FEATURE_SPECIFICATION_DRAFTS,\n aspects: [\n {\n key: 'feature-drafts.draft',\n snapshotPath: 'drafts',\n kind: FamilyAspectKind.COLLECTION,\n itemSchema: FeatureSpecificationDraftArtifactSchema,\n businessKey: 'featureRef',\n /*\n * The PURPOSE, not the ref. `featureRef` is the business key and the only top-level string\n * this item carries — the payload is authored ref-lessly under `draft` — so naming it here\n * made a feature draft the one aspect whose headline was a machine slug: its popup header,\n * and every reference to it from a benefit or a build task, read `feature-deal-owner` while\n * every sibling aspect read a sentence.\n */\n headlineField: 'draft.purpose',\n edges: [],\n },\n ],\n};\n"]}
@@ -3,7 +3,18 @@ import type { TranslationSlotSpecificationMap } from './translation-slot-specifi
3
3
  interface PublicCodeSymbolRef {
4
4
  packageName: string;
5
5
  exportName: string;
6
+ /**
7
+ * PUBLIC SUBPATH only — a subpath the owning package declares in
8
+ * `package.json#exports`, so `${packageName}/${importPath}` resolves. For a module
9
+ * that has no public door, author `filePathHint` instead (issue #150).
10
+ */
6
11
  importPath?: string;
12
+ /**
13
+ * MODULE LOCATION inside the owning package — a navigation aid, never concatenated
14
+ * onto `packageName`. See `CodeSymbolRef` in `@wildo-ai/zod-decorators` for the
15
+ * canonical contract this narrows.
16
+ */
17
+ filePathHint?: string;
7
18
  }
8
19
  interface FlowsActorsViewDefinitionSpecRef {
9
20
  ref: string;
@@ -1 +1 @@
1
- {"version":3,"file":"flows-actors-view-specification.schemas.d.ts","sourceRoot":"","sources":["../../../../src/_core/flows-actors-view-specification.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAEhG,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,gCAAgC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wCAAwC;IACvD,oEAAoE;IACpE,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC3C,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kCAAkC;IACjD,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,+BAA+B,CAAC;IAC5C,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,qDAAqD;IACrD,YAAY,CAAC,EAAE,wCAAwC,CAAC;CACzD;AAED,kDAAkD;AAClD,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC;AAE9F,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,kCAAkC,EAAE,SAAS,CAAC,CAAC;AAEpG,wBAAgB,0CAA0C,CACxD,cAAc,EAAE,gCAAgC,EAChD,oBAAoB,EAAE,MAAM,iCAAiC,GAC5D,kCAAkC,CASpC;AAED,wBAAgB,oCAAoC,CAClD,GAAG,cAAc,EAAE,kCAAkC,EAAE,GACtD,4BAA4B,CAa9B"}
1
+ {"version":3,"file":"flows-actors-view-specification.schemas.d.ts","sourceRoot":"","sources":["../../../../src/_core/flows-actors-view-specification.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAEhG,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,gCAAgC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wCAAwC;IACvD,oEAAoE;IACpE,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC3C,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kCAAkC;IACjD,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,+BAA+B,CAAC;IAC5C,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,qDAAqD;IACrD,YAAY,CAAC,EAAE,wCAAwC,CAAC;CACzD;AAED,kDAAkD;AAClD,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC;AAE9F,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,kCAAkC,EAAE,SAAS,CAAC,CAAC;AAEpG,wBAAgB,0CAA0C,CACxD,cAAc,EAAE,gCAAgC,EAChD,oBAAoB,EAAE,MAAM,iCAAiC,GAC5D,kCAAkC,CASpC;AAED,wBAAgB,oCAAoC,CAClD,GAAG,cAAc,EAAE,kCAAkC,EAAE,GACtD,4BAA4B,CAa9B"}
@@ -1 +1 @@
1
- {"version":3,"file":"flows-actors-view-specification.schemas.js","sourceRoot":"","sources":["../../../../src/_core/flows-actors-view-specification.schemas.ts"],"names":[],"mappings":"AA8CA,MAAM,UAAU,0CAA0C,CACxD,cAAgD,EAChD,oBAA6D;IAE7D,MAAM,aAAa,GAAuC;QACxD,OAAO,EAAE,cAAc,CAAC,GAAG;QAC3B,GAAG,oBAAoB,EAAE;KAC1B,CAAC;IAEF,oCAAoC,CAAC,aAAa,CAAC,CAAC;IAEpD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,GAAG,cAAoD;IAEvD,MAAM,MAAM,GAAiC,EAAE,CAAC;IAEhD,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,2EAA2E,aAAa,CAAC,OAAO,IAAI,CACrG,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,qCAAqC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAEvE,SAAS,oCAAoC,CAC3C,aAAiD;IAEjD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3E,KAAK,MAAM,WAAW,IAAI,qCAAqC,EAAE,CAAC;QAChE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,uDAAuD,aAAa,CAAC,OAAO,8BAA8B,WAAW,wEAAwE,CAC9L,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type { SpecificationOwnerRef } from './definition-specification.schemas';\nimport type { TranslationSlotSpecificationMap } from './translation-slot-specification.schemas';\n\ninterface PublicCodeSymbolRef {\n packageName: string;\n exportName: string;\n importPath?: string;\n}\n\ninterface FlowsActorsViewDefinitionSpecRef {\n ref: string;\n}\n\nexport interface FlowsActorsViewSpecificationCodeHandling {\n /** Module/application owner that authored the flows-actors view. */\n definitionOwner?: SpecificationOwnerRef;\n /** Public declarations where the view is wired into runtime registries. */\n declarationSymbols?: PublicCodeSymbolRef[];\n /** Extra caveats for coding/transposition consumers. */\n notes?: string[];\n}\n\nexport interface FlowsActorsViewSpecificationConfig {\n /** Stable runtime view reference. */\n viewRef: string;\n /** Why this flows-actors surface exists from a product/workflow perspective. */\n purpose: string;\n /** Interaction role this surface plays in the surrounding UX. */\n uiRole: string;\n /** Situations where this surface is the right destination. */\n useWhen?: string;\n /** Situations where another surface should be preferred. */\n avoidWhen?: string;\n /** Meaning of the view-level translatable slots. */\n textSlots?: TranslationSlotSpecificationMap;\n /** Additional domain constraints that matter beyond raw runtime structure. */\n businessConstraints?: string[];\n /** Import-oriented coding/transposition metadata. */\n codeHandling?: FlowsActorsViewSpecificationCodeHandling;\n}\n\n/** Keyed by the stable runtime view reference. */\nexport type FlowsActorsViewSpecification = Record<string, FlowsActorsViewSpecificationConfig>;\n\nexport type FlowsActorsViewSpecificationDraft = Omit<FlowsActorsViewSpecificationConfig, 'viewRef'>;\n\nexport function flowsActorsViewSpecificationFromDefinition(\n viewDefinition: FlowsActorsViewDefinitionSpecRef,\n specificationFactory: () => FlowsActorsViewSpecificationDraft,\n): FlowsActorsViewSpecificationConfig {\n const specification: FlowsActorsViewSpecificationConfig = {\n viewRef: viewDefinition.ref,\n ...specificationFactory(),\n };\n\n validateFlowsActorsViewSpecification(specification);\n\n return specification;\n}\n\nexport function buildFlowsActorsViewSpecificationMap(\n ...specifications: FlowsActorsViewSpecificationConfig[]\n): FlowsActorsViewSpecification {\n const result: FlowsActorsViewSpecification = {};\n\n for (const specification of specifications) {\n if (result[specification.viewRef]) {\n throw new Error(\n `buildFlowsActorsViewSpecificationMap(): duplicate flows-actors viewRef \"${specification.viewRef}\".`,\n );\n }\n result[specification.viewRef] = specification;\n }\n\n return result;\n}\n\nconst FLOWS_ACTORS_VIEW_REQUIRED_TEXT_SLOTS = ['title', 'description'];\n\nfunction validateFlowsActorsViewSpecification(\n specification: FlowsActorsViewSpecificationConfig,\n): void {\n const knownTextSlots = new Set(Object.keys(specification.textSlots ?? {}));\n for (const textSlotKey of FLOWS_ACTORS_VIEW_REQUIRED_TEXT_SLOTS) {\n if (!knownTextSlots.has(textSlotKey)) {\n throw new Error(\n `flowsActorsViewSpecificationFromDefinition(): view \"${specification.viewRef}\" must document text slot \"${textSlotKey}\" so generated launcher and overlay labels stay semantically grounded.`,\n );\n }\n }\n}\n"]}
1
+ {"version":3,"file":"flows-actors-view-specification.schemas.js","sourceRoot":"","sources":["../../../../src/_core/flows-actors-view-specification.schemas.ts"],"names":[],"mappings":"AAyDA,MAAM,UAAU,0CAA0C,CACxD,cAAgD,EAChD,oBAA6D;IAE7D,MAAM,aAAa,GAAuC;QACxD,OAAO,EAAE,cAAc,CAAC,GAAG;QAC3B,GAAG,oBAAoB,EAAE;KAC1B,CAAC;IAEF,oCAAoC,CAAC,aAAa,CAAC,CAAC;IAEpD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,GAAG,cAAoD;IAEvD,MAAM,MAAM,GAAiC,EAAE,CAAC;IAEhD,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,2EAA2E,aAAa,CAAC,OAAO,IAAI,CACrG,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,qCAAqC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAEvE,SAAS,oCAAoC,CAC3C,aAAiD;IAEjD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3E,KAAK,MAAM,WAAW,IAAI,qCAAqC,EAAE,CAAC;QAChE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,uDAAuD,aAAa,CAAC,OAAO,8BAA8B,WAAW,wEAAwE,CAC9L,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type { SpecificationOwnerRef } from './definition-specification.schemas';\nimport type { TranslationSlotSpecificationMap } from './translation-slot-specification.schemas';\n\ninterface PublicCodeSymbolRef {\n packageName: string;\n exportName: string;\n /**\n * PUBLIC SUBPATH only — a subpath the owning package declares in\n * `package.json#exports`, so `${packageName}/${importPath}` resolves. For a module\n * that has no public door, author `filePathHint` instead (issue #150).\n */\n importPath?: string;\n /**\n * MODULE LOCATION inside the owning package — a navigation aid, never concatenated\n * onto `packageName`. See `CodeSymbolRef` in `@wildo-ai/zod-decorators` for the\n * canonical contract this narrows.\n */\n filePathHint?: string;\n}\n\ninterface FlowsActorsViewDefinitionSpecRef {\n ref: string;\n}\n\nexport interface FlowsActorsViewSpecificationCodeHandling {\n /** Module/application owner that authored the flows-actors view. */\n definitionOwner?: SpecificationOwnerRef;\n /** Public declarations where the view is wired into runtime registries. */\n declarationSymbols?: PublicCodeSymbolRef[];\n /** Extra caveats for coding/transposition consumers. */\n notes?: string[];\n}\n\nexport interface FlowsActorsViewSpecificationConfig {\n /** Stable runtime view reference. */\n viewRef: string;\n /** Why this flows-actors surface exists from a product/workflow perspective. */\n purpose: string;\n /** Interaction role this surface plays in the surrounding UX. */\n uiRole: string;\n /** Situations where this surface is the right destination. */\n useWhen?: string;\n /** Situations where another surface should be preferred. */\n avoidWhen?: string;\n /** Meaning of the view-level translatable slots. */\n textSlots?: TranslationSlotSpecificationMap;\n /** Additional domain constraints that matter beyond raw runtime structure. */\n businessConstraints?: string[];\n /** Import-oriented coding/transposition metadata. */\n codeHandling?: FlowsActorsViewSpecificationCodeHandling;\n}\n\n/** Keyed by the stable runtime view reference. */\nexport type FlowsActorsViewSpecification = Record<string, FlowsActorsViewSpecificationConfig>;\n\nexport type FlowsActorsViewSpecificationDraft = Omit<FlowsActorsViewSpecificationConfig, 'viewRef'>;\n\nexport function flowsActorsViewSpecificationFromDefinition(\n viewDefinition: FlowsActorsViewDefinitionSpecRef,\n specificationFactory: () => FlowsActorsViewSpecificationDraft,\n): FlowsActorsViewSpecificationConfig {\n const specification: FlowsActorsViewSpecificationConfig = {\n viewRef: viewDefinition.ref,\n ...specificationFactory(),\n };\n\n validateFlowsActorsViewSpecification(specification);\n\n return specification;\n}\n\nexport function buildFlowsActorsViewSpecificationMap(\n ...specifications: FlowsActorsViewSpecificationConfig[]\n): FlowsActorsViewSpecification {\n const result: FlowsActorsViewSpecification = {};\n\n for (const specification of specifications) {\n if (result[specification.viewRef]) {\n throw new Error(\n `buildFlowsActorsViewSpecificationMap(): duplicate flows-actors viewRef \"${specification.viewRef}\".`,\n );\n }\n result[specification.viewRef] = specification;\n }\n\n return result;\n}\n\nconst FLOWS_ACTORS_VIEW_REQUIRED_TEXT_SLOTS = ['title', 'description'];\n\nfunction validateFlowsActorsViewSpecification(\n specification: FlowsActorsViewSpecificationConfig,\n): void {\n const knownTextSlots = new Set(Object.keys(specification.textSlots ?? {}));\n for (const textSlotKey of FLOWS_ACTORS_VIEW_REQUIRED_TEXT_SLOTS) {\n if (!knownTextSlots.has(textSlotKey)) {\n throw new Error(\n `flowsActorsViewSpecificationFromDefinition(): view \"${specification.viewRef}\" must document text slot \"${textSlotKey}\" so generated launcher and overlay labels stay semantically grounded.`,\n );\n }\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"frontend-component-specification.schemas.d.ts","sourceRoot":"","sources":["../../../../src/_core/frontend-component-specification.schemas.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"frontend-component-specification.schemas.d.ts","sourceRoot":"","sources":["../../../../src/_core/frontend-component-specification.schemas.ts"],"names":[],"mappings":"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"}
@@ -223,10 +223,28 @@ function mergeCodeSymbolRefs(base, incoming) {
223
223
  }
224
224
  const byKey = new Map();
225
225
  for (const symbol of [...base, ...incoming]) {
226
- byKey.set(buildCodeSymbolRefKey(symbol), symbol);
226
+ const key = buildCodeSymbolRefKey(symbol);
227
+ const existing = byKey.get(key);
228
+ /*
229
+ * `incoming` wins on every field, EXCEPT that a location already known is not lost to an
230
+ * overlay that simply does not restate it. Without this, an overlay re-declaring a symbol
231
+ * to change (say) its notes would silently drop the base's `filePathHint`, and the drop is
232
+ * invisible: the merged ref is still valid, just less useful to the coding agent that reads
233
+ * it. Same-key refs describe the same symbol, so the base's location cannot be wrong here.
234
+ */
235
+ byKey.set(key, existing?.filePathHint !== undefined && symbol.filePathHint === undefined
236
+ ? { ...symbol, filePathHint: existing.filePathHint }
237
+ : symbol);
227
238
  }
228
239
  return [...byKey.values()];
229
240
  }
241
+ /**
242
+ * Dedup identity for a symbol ref: WHERE it is imported from plus WHAT it is called.
243
+ *
244
+ * `filePathHint` is deliberately excluded. It is a navigation aid describing the same symbol,
245
+ * not part of its identity — keying on it would split one symbol into two entries the moment a
246
+ * single overlay omitted the hint (issue #150).
247
+ */
230
248
  function buildCodeSymbolRefKey(symbol) {
231
249
  return [
232
250
  symbol.packageName,
@@ -1 +1 @@
1
- {"version":3,"file":"frontend-component-specification.schemas.js","sourceRoot":"","sources":["../../../../src/_core/frontend-component-specification.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CodePrimitiveKind, CodeSymbolRef } from '@wildo-ai/zod-decorators';\nimport type {\n CodeNamedMemberRef,\n SpecificationOwnerRef,\n} from './definition-specification.schemas';\n\n/**\n * @wildo_source:part:start saas.specifications.frontend-component-spec-model facet:layer:specification facet:family:companion\n *\n * Which logical layer a component contribution belongs to.\n *\n * `BASE_ELEMENT` means the framework/app slot owner that originally defines the\n * implementation. `INJECTED_CONTRIBUTION` means a later contribution that\n * provides or overrides the implementation for the same slot target.\n */\nexport enum FrontendComponentContributionKind {\n BASE_ELEMENT = 'base-element',\n INJECTED_CONTRIBUTION = 'injected-contribution',\n}\n\n/**\n * How the component implementation is loaded at runtime.\n */\nexport enum FrontendComponentLoadKind {\n STATIC_IMPORT = 'static-import',\n LAZY_IMPORT = 'lazy-import',\n}\n\n/**\n * Which runtime registration path owns a contribution.\n *\n * These values deliberately mirror the current runtime seams instead of hiding\n * them behind a generic \"registered somewhere\" label.\n */\nexport enum FrontendComponentRegistrationPathKind {\n FRAMEWORK_DEFAULT_PRESETS = 'framework-default-presets',\n FRAMEWORK_LAYOUTS = 'framework-layouts',\n FRONTEND_MODULE_REGISTRATION = 'frontend-module-registration',\n LEGACY_CUSTOM_COMPONENT_REGISTRY = 'legacy-custom-component-registry',\n}\n\n/**\n * Conflict semantics currently used by a registration path.\n *\n * Tooling needs this because the same slot can behave differently depending on\n * whether it went through direct registry registration, lazy custom loading, or\n * module-registry merge.\n */\nexport enum FrontendComponentResolutionPolicyKind {\n LAST_REGISTRATION_WINS = 'last-registration-wins',\n FIRST_REGISTRATION_WINS = 'first-registration-wins',\n MERGED_BY_COMPONENT_REF = 'merged-by-component-ref',\n}\n\n/**\n * How precisely a contribution source is identified before runtime merge.\n *\n * Some paths target the full slot tuple (`componentRef + preset + category`),\n * while current `FrontendModule.componentRegistrations` only preserve\n * `componentRef` identity before the loader resolves the effective runtime slot.\n */\nexport enum FrontendComponentContributionIdentityGranularity {\n COMPONENT_REF = 'componentRef',\n SLOT = 'slot',\n}\n\n/**\n * Stable component target identity shared by all presets of one component slot.\n *\n * Presets are modeled separately so component-level interface, examples, and\n * translation guidance can stay DRY across several preset implementations.\n */\nexport interface FrontendComponentSpecificationTarget {\n /** Runtime component slot / component ref. */\n componentRef: string;\n /** Optional public declaration owning the component ref/type constant. */\n componentTypeDeclaration?: CodeNamedMemberRef;\n /** Optional extra dimension used by some slots, e.g. EDIT vs DISPLAY. */\n category?: string;\n /** Optional public declaration owning the category constant/member. */\n categoryDeclaration?: CodeNamedMemberRef;\n}\n\nexport function buildFrontendComponentSpecificationKey(\n target: Pick<FrontendComponentSpecificationTarget, 'componentRef' | 'category'>,\n): string {\n return target.category ? `${target.componentRef}:${target.category}` : target.componentRef;\n}\n\n/**\n * Preset-specific runtime target nested under one shared component target.\n */\nexport interface FrontendComponentPresetTarget {\n /** Runtime preset name used for this implementation aspect. */\n preset: string;\n /** Optional public declaration owning the preset constant/member. */\n presetDeclaration?: CodeNamedMemberRef;\n /** Exact registry key if the author wants to pin the composed runtime key. */\n registryKey?: string;\n}\n\n/**\n * Source identity of one contribution before runtime merge/registration.\n *\n * This stays separate from the top-level slot because some contribution paths\n * are authored more loosely than the final runtime registry key they end up\n * affecting.\n */\nexport interface FrontendComponentContributionSourceIdentity {\n /** Current authored merge-key granularity for this contribution source. */\n identityGranularity: FrontendComponentContributionIdentityGranularity;\n /** Authored component ref / registration key anchor. */\n componentRef: string;\n /** Optional authored preset when that path preserves it explicitly. */\n preset?: string;\n /** Optional authored category when that path preserves it explicitly. */\n category?: string;\n}\n\n/**\n * One authored source that can provide the implementation for a component slot.\n */\nexport interface FrontendComponentSpecificationContribution {\n /** Whether this source is the base slot owner or an injected contribution. */\n contributionKind: FrontendComponentContributionKind;\n /** Authored source identity before the runtime resolves the effective slot. */\n sourceIdentity: FrontendComponentContributionSourceIdentity;\n /** Module/application owner that authored this contribution. */\n owner?: SpecificationOwnerRef;\n /** Runtime registration lane used to surface the contribution. */\n registrationPath: FrontendComponentRegistrationPathKind;\n /** Whether the component is loaded eagerly or lazily. */\n loadKind: FrontendComponentLoadKind;\n /** Public symbol exposing the registration declaration/loader. */\n registrationSymbol: CodeSymbolRef;\n /** Public symbol exposing the actual React component when importable. */\n implementationSymbol?: CodeSymbolRef;\n /** Preferred public wrapper/import surface for normal downstream consumption. */\n consumerFacingSymbol?: CodeSymbolRef;\n /** Conflict/override semantics applied on this registration path. */\n resolutionPolicy?: FrontendComponentResolutionPolicyKind;\n /** Extra public symbols that downstream coding helpers may need. */\n supportingSymbols?: CodeSymbolRef[];\n /**\n * Authoring caveats for the contribution.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened/joined into a single line, and never\n * collapsed into the contribution's structural summary line.\n *\n * Companion materializers should emit one `${contributionLabel} note:\n * ${note}` bullet per entry alongside the contribution's structural header\n * bullet (and any owner-note bullets surfaced via\n * {@link SpecificationOwnerRef.notes}). This keeps each caveat individually\n * citable downstream and matches the contract enforced for\n * {@link TranslationSlotSpecification.notes} and\n * {@link FrontendComponentPropSpecification.notes}.\n */\n notes?: string[];\n}\n\n/**\n * Import-oriented metadata for frontend component specifications.\n *\n * The structural component target now lives at the top level of the\n * specification. This lane is reserved for extra import-oriented references that\n * help downstream code-writing prompts.\n */\nexport interface FrontendComponentSpecificationCodeHandling {\n /** Extra public symbols useful for downstream code-writing prompts. */\n supportingSymbols?: CodeSymbolRef[];\n}\n\n/**\n * Additive preset-level specification layered on top of the shared component\n * description.\n *\n * Most components will only expose `DEFAULT`, but multi-preset components can\n * add several preset entries without duplicating interface or usage guidance.\n */\nexport interface FrontendComponentPresetSpecification {\n /** Why this preset exists beyond the shared component contract. */\n specialConcern?: string;\n /** Translation-specific caveats or wording posture for this preset. */\n translationNotes?: string[];\n /** Authoring caveats specific to this preset implementation. */\n authoringNotes?: string[];\n /** Effective runtime target for this preset implementation. */\n presetTarget: FrontendComponentPresetTarget;\n /** Original/base slot implementation source, if one exists. */\n baseElement?: FrontendComponentSpecificationContribution;\n /** Later contributions that inject or override the slot implementation. */\n injectedContributions?: FrontendComponentSpecificationContribution[];\n /** Extra public symbols useful for downstream code-writing prompts. */\n supportingSymbols?: CodeSymbolRef[];\n}\n\n/**\n * Structural kind of one documented component prop.\n */\nexport enum FrontendComponentPropValueKind {\n PRIMITIVE = 'primitive',\n ENUM = 'enum',\n OBJECT = 'object',\n ARRAY = 'array',\n FUNCTION = 'function',\n REACT_NODE = 'react-node',\n TYPE_REFERENCE = 'type-reference',\n UNION = 'union',\n}\n\n/**\n * Nested value-shape description for non-trivial prop kinds such as arrays,\n * unions, object references, and callback props.\n */\nexport interface FrontendComponentPropValueShape {\n /** High-level kind of value expected by the prop or nested member. */\n valueKind: FrontendComponentPropValueKind;\n /** Primitive kind when the value is a primitive. */\n primitiveType?: CodePrimitiveKind;\n /** Importable type/value reference when the shape is driven by another contract. */\n valueTypeSymbol?: CodeSymbolRef;\n /** Structured vocabulary when the value is constrained by known options. */\n vocabulary?: FrontendComponentPropValueVocabulary;\n /** Array element shape when `valueKind` is `ARRAY`. */\n arrayElement?: Omit<FrontendComponentPropValueShape, 'arrayElement' | 'unionMembers'>;\n /** Union member shapes when `valueKind` is `UNION`. */\n unionMembers?: Array<Omit<FrontendComponentPropValueShape, 'arrayElement' | 'unionMembers'>>;\n /** Short callback signature hint when `valueKind` is `FUNCTION`. */\n functionSignature?: string;\n /**\n * Extra caveats for the nested value shape.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened into the inline structural summary\n * produced for the shape (which appears within a parent prop bullet line).\n *\n * Because nested shapes (`arrayElement`, `unionMembers`, root prop shape)\n * are composed inline into a single structural summary, companion\n * materializers MUST hoist these notes UP to the parent prop's bullet\n * block, prefixed with a path-aware label (e.g. ``\\`propName\\` arrayElement\n * note: ${note}`` or ``\\`propName\\` unionMember[0] note: ${note}``) so each\n * caveat surfaces as its own bullet. This matches the per-bullet contract\n * enforced for {@link FrontendComponentPropSpecification.notes} and\n * {@link FrontendComponentPropValueVocabulary.notes}.\n */\n notes?: string[];\n}\n\n/**\n * One explicit value inside a prop vocabulary.\n */\nexport interface FrontendComponentPropValueOption {\n /** Literal runtime value expected for the prop. */\n value: string | number | boolean;\n /** Short explanation of what this value means in practice. */\n meaning?: string;\n}\n\n/**\n * Structured vocabulary metadata for a prop that has a constrained set of\n * values or a declared enum source.\n */\nexport interface FrontendComponentPropValueVocabulary {\n /** Public enum/const declaration that owns the value vocabulary, if any. */\n enumerationSource?: CodeSymbolRef;\n /** Explicit known values that downstream tools can present directly. */\n values?: FrontendComponentPropValueOption[];\n /** Whether arbitrary user-defined values are still allowed beyond the list. */\n allowCustomValues?: boolean;\n /**\n * Extra caveats when the vocabulary alone is not sufficient.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened into the inline vocabulary summary\n * (which appears either in the top-level prop-vocabulary bullet block or\n * inside a parent prop's bullet line via a nested shape).\n *\n * Companion materializers MUST emit one ``\\`propName\\` vocabulary note:\n * ${note}`` bullet per entry — at the top-level vocabulary block when the\n * vocabulary is attached directly to a prop, and hoisted to the parent\n * prop's bullet block when the vocabulary is nested inside a shape (e.g.\n * ``\\`propName\\` arrayElement vocabulary note: ${note}``). This matches\n * the per-bullet contract enforced for\n * {@link FrontendComponentPropValueShape.notes} and\n * {@link FrontendComponentPropSpecification.notes}.\n */\n notes?: string[];\n}\n\n/**\n * One documented prop on the consumer-facing component interface.\n */\nexport interface FrontendComponentPropSpecification {\n /** Literal prop name on the exported component interface. */\n propName: string;\n /** Why this prop exists from a UI/authoring perspective. */\n purpose: string;\n /** Whether callers normally need to provide the prop explicitly. */\n required?: boolean;\n /** High-level kind of value expected by the prop. */\n valueKind: FrontendComponentPropValueKind;\n /** Primitive kind when `valueKind` is `primitive`. */\n primitiveType?: CodePrimitiveKind;\n /** Importable type/value reference when the prop is backed by another contract. */\n valueTypeSymbol?: CodeSymbolRef;\n /** Declared vocabulary / possible values for constrained props. */\n vocabulary?: FrontendComponentPropValueVocabulary;\n /** Array element shape when `valueKind` is `ARRAY`. */\n arrayElement?: FrontendComponentPropValueShape;\n /** Union member shapes when `valueKind` is `UNION`. */\n unionMembers?: FrontendComponentPropValueShape[];\n /** Short callback signature hint when `valueKind` is `FUNCTION`. */\n functionSignature?: string;\n /** Optional documented default when omitted. */\n defaultValue?: string | number | boolean;\n /**\n * Extra authoring caveats for this prop.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened/joined into a single line, and never\n * collapsed into the prop's structural summary line.\n *\n * Companion materializers should emit one ``\\`propName\\` note: ${note}``\n * bullet per entry, alongside the prop's structural header bullet (and any\n * shape/vocabulary notes hoisted from nested\n * {@link FrontendComponentPropValueShape.notes} and\n * {@link FrontendComponentPropValueVocabulary.notes}). This keeps each\n * caveat individually citable downstream and matches the contract enforced\n * for {@link TranslationSlotSpecification.notes} and\n * {@link FrontendComponentSpecificationContribution.notes}.\n */\n notes?: string[];\n}\n\n/**\n * Interface contract for the consumer-facing component surface.\n */\nexport interface FrontendComponentInterfaceContract {\n /** Public type alias/interface describing the consumer-facing props. */\n propsType?: CodeSymbolRef;\n /** Public type alias/interface describing the forwarded ref, if any. */\n refType?: CodeSymbolRef;\n /** Structured documentation for high-value props on the interface. */\n propSpecifications?: FrontendComponentPropSpecification[];\n}\n\n/**\n * Concrete example usage that downstream tools can reuse in prompts or docs.\n */\nexport interface FrontendComponentUsageExample {\n /** Short label for the scenario shown by the snippet. */\n title: string;\n /** Why this example is useful or representative. */\n description?: string;\n /** Code language for rendering/transposition. */\n language?: 'tsx' | 'typescript' | 'javascript';\n /** Example snippet showing truthful component usage. */\n code: string;\n /** Extra caveats or follow-up notes for the snippet. */\n notes?: string[];\n}\n/** @wildo_source:part:end saas.specifications.frontend-component-spec-model */\n\n/**\n * @wildo_source:part:start saas.specifications.frontend-component-spec-factory facet:layer:specification facet:family:companion\n *\n * Semantic overlay for one shared frontend component target.\n */\nexport interface FrontendComponentSpecificationConfig {\n /** Structural runtime target shared by all preset aspects of this component. */\n target: FrontendComponentSpecificationTarget;\n /** Cross-surface semantic identifier shared with higher-level semantics lanes. */\n componentId: string;\n /** Why this component target exists in the product/authoring model. */\n purpose: string;\n /** UI role played by the component target. */\n uiRole: string;\n /** Situations where this component family is the recommended choice. */\n useWhen?: string;\n /** Situations where another component family/pattern should be preferred. */\n avoidWhen?: string;\n /** Translation/i18n role carried by the shared component contract if relevant. */\n translationRole?: string;\n /** Extra authoring guidance for AI/app developers. */\n authoringNotes?: string[];\n /** Notes about how this slot composes with surrounding UI surfaces. */\n compositionNotes?: string[];\n /** Public interface contract for the consumer-facing component surface. */\n componentInterface?: FrontendComponentInterfaceContract;\n /** Concrete usage snippets that prove truthful component authoring. */\n usageExamples?: FrontendComponentUsageExample[];\n /** Default preset to use when callers do not ask for a specific preset. */\n defaultPreset?: string;\n /** Preset-specific additive aspects layered on top of the shared component contract. */\n presetSpecifications: Record<string, FrontendComponentPresetSpecification>;\n /**\n * Public-import-oriented metadata for coding/transposition consumers.\n *\n * Optional: Step 7 deferred follow-up #2 flipped this slot from required to\n * optional once the audit confirmed every engine spec authors `{}` as a\n * noise-only placeholder (no inner field is populated). Keeping the slot\n * preserves the future expansion point for app overlays that want to ship\n * `supportingSymbols`, but the empty-object placeholder is no longer\n * required at the call site. The companion renderer reads it via optional\n * chaining (`specification.codeHandling?.supportingSymbols ?? []`) so absence\n * collapses cleanly to the same \"no extra symbols\" output as `{}` did.\n */\n codeHandling?: FrontendComponentSpecificationCodeHandling;\n}\n\n/**\n * Authored input shape before composition helpers normalize the optional preset\n * lane.\n */\nexport interface FrontendComponentSpecificationConfigInput\n extends Omit<FrontendComponentSpecificationConfig, 'presetSpecifications'> {\n presetSpecifications?: Record<string, FrontendComponentPresetSpecification>;\n}\n\n/**\n * Normalize one authored component specification so later additive helpers can\n * safely extend it without every leaf re-declaring empty records.\n */\nexport function frontendComponentSpecification(\n config: FrontendComponentSpecificationConfigInput,\n): FrontendComponentSpecificationConfig {\n const normalized = {\n ...config,\n presetSpecifications: { ...(config.presetSpecifications ?? {}) },\n };\n validateFrontendComponentSpecification(normalized);\n return normalized;\n}\n\n/**\n * Add one preset aspect to an existing shared component target specification.\n */\nexport function addFrontendComponentPresetSpecification(\n specification: FrontendComponentSpecificationConfig,\n presetId: string,\n presetSpecification: FrontendComponentPresetSpecification,\n): FrontendComponentSpecificationConfig {\n const nextSpecification = {\n ...specification,\n presetSpecifications: {\n ...specification.presetSpecifications,\n [presetId]: specification.presetSpecifications[presetId]\n ? mergeFrontendComponentPresetSpecification(\n specification.presetSpecifications[presetId]!,\n presetSpecification,\n )\n : presetSpecification,\n },\n };\n validateFrontendComponentSpecification(nextSpecification);\n return nextSpecification;\n}\n/** @wildo_source:part:end saas.specifications.frontend-component-spec-factory */\n\nfunction validateFrontendComponentSpecification(\n specification: FrontendComponentSpecificationConfig,\n): void {\n const presetEntries = Object.entries(specification.presetSpecifications);\n if (presetEntries.length === 0) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must declare at least one preset specification.`,\n );\n }\n\n if (\n specification.defaultPreset !== undefined\n && specification.presetSpecifications[specification.defaultPreset] === undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" declares defaultPreset \"${specification.defaultPreset}\" but no matching preset specification exists.`,\n );\n }\n\n for (const [presetId, presetSpecification] of presetEntries) {\n if (presetSpecification.presetTarget.preset !== presetId) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" registered preset key \"${presetId}\" but the preset target declares \"${presetSpecification.presetTarget.preset}\".`,\n );\n }\n validatePresetContribution(\n specification,\n presetId,\n 'baseElement',\n presetSpecification.baseElement,\n );\n for (const [index, contribution] of (presetSpecification.injectedContributions ?? []).entries()) {\n validatePresetContribution(\n specification,\n presetId,\n `injectedContributions[${index}]`,\n contribution,\n );\n }\n }\n}\n\nfunction validatePresetContribution(\n specification: FrontendComponentSpecificationConfig,\n presetId: string,\n contributionPath: string,\n contribution: FrontendComponentSpecificationContribution | undefined,\n): void {\n if (!contribution) {\n return;\n }\n\n if (contribution.sourceIdentity.componentRef !== specification.target.componentRef) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with componentRef \"${contribution.sourceIdentity.componentRef}\" that does not match target \"${specification.target.componentRef}\".`,\n );\n }\n\n if (\n contribution.sourceIdentity.identityGranularity === FrontendComponentContributionIdentityGranularity.SLOT\n && specification.target.category === undefined\n && contribution.sourceIdentity.category !== undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with unexpected category \"${contribution.sourceIdentity.category}\" on an uncategorized target.`,\n );\n }\n\n if (\n contribution.sourceIdentity.identityGranularity === FrontendComponentContributionIdentityGranularity.SLOT\n && specification.target.category !== undefined\n && contribution.sourceIdentity.category === undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must preserve category \"${specification.target.category}\" for ${contributionPath}.`,\n );\n }\n\n if (\n contribution.sourceIdentity.identityGranularity === FrontendComponentContributionIdentityGranularity.SLOT\n && specification.target.category !== undefined\n && contribution.sourceIdentity.category !== specification.target.category\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with category \"${contribution.sourceIdentity.category}\" that does not match target category \"${specification.target.category}\".`,\n );\n }\n\n if (\n contribution.sourceIdentity.preset !== undefined\n && contribution.sourceIdentity.preset !== presetId\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with preset \"${contribution.sourceIdentity.preset}\" that does not match preset \"${presetId}\".`,\n );\n }\n\n if (contribution.registrationPath === FrontendComponentRegistrationPathKind.FRONTEND_MODULE_REGISTRATION) {\n if (contribution.sourceIdentity.identityGranularity !== FrontendComponentContributionIdentityGranularity.COMPONENT_REF) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must use COMPONENT_REF identity for ${contributionPath} on FRONTEND_MODULE_REGISTRATION.`,\n );\n }\n if (\n contribution.sourceIdentity.preset !== undefined\n || contribution.sourceIdentity.category !== undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" cannot preserve preset/category identity for ${contributionPath} on FRONTEND_MODULE_REGISTRATION.`,\n );\n }\n }\n\n if (\n contribution.registrationPath === FrontendComponentRegistrationPathKind.FRAMEWORK_DEFAULT_PRESETS\n || contribution.registrationPath === FrontendComponentRegistrationPathKind.FRAMEWORK_LAYOUTS\n ) {\n if (contribution.sourceIdentity.identityGranularity !== FrontendComponentContributionIdentityGranularity.SLOT) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must use SLOT identity for ${contributionPath} on ${contribution.registrationPath}.`,\n );\n }\n if (contribution.sourceIdentity.preset === undefined) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must declare a preset for ${contributionPath} on ${contribution.registrationPath}.`,\n );\n }\n }\n}\n\nfunction mergeFrontendComponentPresetSpecification(\n base: FrontendComponentPresetSpecification,\n incoming: FrontendComponentPresetSpecification,\n): FrontendComponentPresetSpecification {\n const mergedInjectedContributions = [\n ...(base.injectedContributions ?? []),\n ...(incoming.injectedContributions ?? []),\n ];\n return {\n specialConcern: mergeCompatibleScalar('specialConcern', base.specialConcern, incoming.specialConcern),\n translationNotes: mergeStringArrays(base.translationNotes, incoming.translationNotes),\n authoringNotes: mergeStringArrays(base.authoringNotes, incoming.authoringNotes),\n presetTarget: mergePresetTarget(base.presetTarget, incoming.presetTarget),\n baseElement: mergeCompatibleScalar('baseElement', base.baseElement, incoming.baseElement),\n injectedContributions: mergedInjectedContributions.length > 0 ? mergedInjectedContributions : undefined,\n supportingSymbols: mergeCodeSymbolRefs(base.supportingSymbols, incoming.supportingSymbols),\n };\n}\n\nfunction mergePresetTarget(\n base: FrontendComponentPresetTarget,\n incoming: FrontendComponentPresetTarget,\n): FrontendComponentPresetTarget {\n if (base.preset !== incoming.preset) {\n throw new Error(\n `Cannot merge preset specifications for different preset targets (\"${base.preset}\" vs \"${incoming.preset}\").`,\n );\n }\n return {\n preset: base.preset,\n presetDeclaration: mergeCompatibleScalar(\n 'presetDeclaration',\n base.presetDeclaration,\n incoming.presetDeclaration,\n ),\n registryKey: mergeCompatibleScalar('registryKey', base.registryKey, incoming.registryKey),\n };\n}\n\nfunction mergeCompatibleScalar<T>(\n label: string,\n base: T | undefined,\n incoming: T | undefined,\n): T | undefined {\n if (base === undefined) {\n return incoming;\n }\n if (incoming === undefined) {\n return base;\n }\n if (areValuesEqual(base, incoming)) {\n return base;\n }\n throw new Error(`Cannot merge frontend component preset specifications because \"${label}\" conflicts.`);\n}\n\nfunction mergeStringArrays(\n base: string[] | undefined,\n incoming: string[] | undefined,\n): string[] | undefined {\n if (base === undefined) {\n return incoming;\n }\n if (incoming === undefined) {\n return base;\n }\n return [...new Set([...base, ...incoming])];\n}\n\nfunction mergeCodeSymbolRefs(\n base: CodeSymbolRef[] | undefined,\n incoming: CodeSymbolRef[] | undefined,\n): CodeSymbolRef[] | undefined {\n if (base === undefined) {\n return incoming;\n }\n if (incoming === undefined) {\n return base;\n }\n\n const byKey = new Map<string, CodeSymbolRef>();\n for (const symbol of [...base, ...incoming]) {\n byKey.set(buildCodeSymbolRefKey(symbol), symbol);\n }\n return [...byKey.values()];\n}\n\nfunction buildCodeSymbolRefKey(symbol: CodeSymbolRef): string {\n return [\n symbol.packageName,\n symbol.importPath ?? '',\n symbol.exportName,\n symbol.symbolKind ?? '',\n symbol.declarationKind ?? '',\n ].join('::');\n}\n\nfunction areValuesEqual(left: unknown, right: unknown): boolean {\n return JSON.stringify(left) === JSON.stringify(right);\n}\n\n/**\n * @wildo_source:part:start saas.specifications.frontend-component-spec-factory facet:layer:specification facet:family:companion\n *\n * Registry keyed by the shared component target identity.\n */\nexport type FrontendComponentSpecification = Record<string, FrontendComponentSpecificationConfig>;\n/** @wildo_source:part:end saas.specifications.frontend-component-spec-factory */\n"]}
1
+ {"version":3,"file":"frontend-component-specification.schemas.js","sourceRoot":"","sources":["../../../../src/_core/frontend-component-specification.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CodePrimitiveKind, CodeSymbolRef } from '@wildo-ai/zod-decorators';\nimport type {\n CodeNamedMemberRef,\n SpecificationOwnerRef,\n} from './definition-specification.schemas';\n\n/**\n * @wildo_source:part:start saas.specifications.frontend-component-spec-model facet:layer:specification facet:family:companion\n *\n * Which logical layer a component contribution belongs to.\n *\n * `BASE_ELEMENT` means the framework/app slot owner that originally defines the\n * implementation. `INJECTED_CONTRIBUTION` means a later contribution that\n * provides or overrides the implementation for the same slot target.\n */\nexport enum FrontendComponentContributionKind {\n BASE_ELEMENT = 'base-element',\n INJECTED_CONTRIBUTION = 'injected-contribution',\n}\n\n/**\n * How the component implementation is loaded at runtime.\n */\nexport enum FrontendComponentLoadKind {\n STATIC_IMPORT = 'static-import',\n LAZY_IMPORT = 'lazy-import',\n}\n\n/**\n * Which runtime registration path owns a contribution.\n *\n * These values deliberately mirror the current runtime seams instead of hiding\n * them behind a generic \"registered somewhere\" label.\n */\nexport enum FrontendComponentRegistrationPathKind {\n FRAMEWORK_DEFAULT_PRESETS = 'framework-default-presets',\n FRAMEWORK_LAYOUTS = 'framework-layouts',\n FRONTEND_MODULE_REGISTRATION = 'frontend-module-registration',\n LEGACY_CUSTOM_COMPONENT_REGISTRY = 'legacy-custom-component-registry',\n}\n\n/**\n * Conflict semantics currently used by a registration path.\n *\n * Tooling needs this because the same slot can behave differently depending on\n * whether it went through direct registry registration, lazy custom loading, or\n * module-registry merge.\n */\nexport enum FrontendComponentResolutionPolicyKind {\n LAST_REGISTRATION_WINS = 'last-registration-wins',\n FIRST_REGISTRATION_WINS = 'first-registration-wins',\n MERGED_BY_COMPONENT_REF = 'merged-by-component-ref',\n}\n\n/**\n * How precisely a contribution source is identified before runtime merge.\n *\n * Some paths target the full slot tuple (`componentRef + preset + category`),\n * while current `FrontendModule.componentRegistrations` only preserve\n * `componentRef` identity before the loader resolves the effective runtime slot.\n */\nexport enum FrontendComponentContributionIdentityGranularity {\n COMPONENT_REF = 'componentRef',\n SLOT = 'slot',\n}\n\n/**\n * Stable component target identity shared by all presets of one component slot.\n *\n * Presets are modeled separately so component-level interface, examples, and\n * translation guidance can stay DRY across several preset implementations.\n */\nexport interface FrontendComponentSpecificationTarget {\n /** Runtime component slot / component ref. */\n componentRef: string;\n /** Optional public declaration owning the component ref/type constant. */\n componentTypeDeclaration?: CodeNamedMemberRef;\n /** Optional extra dimension used by some slots, e.g. EDIT vs DISPLAY. */\n category?: string;\n /** Optional public declaration owning the category constant/member. */\n categoryDeclaration?: CodeNamedMemberRef;\n}\n\nexport function buildFrontendComponentSpecificationKey(\n target: Pick<FrontendComponentSpecificationTarget, 'componentRef' | 'category'>,\n): string {\n return target.category ? `${target.componentRef}:${target.category}` : target.componentRef;\n}\n\n/**\n * Preset-specific runtime target nested under one shared component target.\n */\nexport interface FrontendComponentPresetTarget {\n /** Runtime preset name used for this implementation aspect. */\n preset: string;\n /** Optional public declaration owning the preset constant/member. */\n presetDeclaration?: CodeNamedMemberRef;\n /** Exact registry key if the author wants to pin the composed runtime key. */\n registryKey?: string;\n}\n\n/**\n * Source identity of one contribution before runtime merge/registration.\n *\n * This stays separate from the top-level slot because some contribution paths\n * are authored more loosely than the final runtime registry key they end up\n * affecting.\n */\nexport interface FrontendComponentContributionSourceIdentity {\n /** Current authored merge-key granularity for this contribution source. */\n identityGranularity: FrontendComponentContributionIdentityGranularity;\n /** Authored component ref / registration key anchor. */\n componentRef: string;\n /** Optional authored preset when that path preserves it explicitly. */\n preset?: string;\n /** Optional authored category when that path preserves it explicitly. */\n category?: string;\n}\n\n/**\n * One authored source that can provide the implementation for a component slot.\n */\nexport interface FrontendComponentSpecificationContribution {\n /** Whether this source is the base slot owner or an injected contribution. */\n contributionKind: FrontendComponentContributionKind;\n /** Authored source identity before the runtime resolves the effective slot. */\n sourceIdentity: FrontendComponentContributionSourceIdentity;\n /** Module/application owner that authored this contribution. */\n owner?: SpecificationOwnerRef;\n /** Runtime registration lane used to surface the contribution. */\n registrationPath: FrontendComponentRegistrationPathKind;\n /** Whether the component is loaded eagerly or lazily. */\n loadKind: FrontendComponentLoadKind;\n /** Public symbol exposing the registration declaration/loader. */\n registrationSymbol: CodeSymbolRef;\n /** Public symbol exposing the actual React component when importable. */\n implementationSymbol?: CodeSymbolRef;\n /** Preferred public wrapper/import surface for normal downstream consumption. */\n consumerFacingSymbol?: CodeSymbolRef;\n /** Conflict/override semantics applied on this registration path. */\n resolutionPolicy?: FrontendComponentResolutionPolicyKind;\n /** Extra public symbols that downstream coding helpers may need. */\n supportingSymbols?: CodeSymbolRef[];\n /**\n * Authoring caveats for the contribution.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened/joined into a single line, and never\n * collapsed into the contribution's structural summary line.\n *\n * Companion materializers should emit one `${contributionLabel} note:\n * ${note}` bullet per entry alongside the contribution's structural header\n * bullet (and any owner-note bullets surfaced via\n * {@link SpecificationOwnerRef.notes}). This keeps each caveat individually\n * citable downstream and matches the contract enforced for\n * {@link TranslationSlotSpecification.notes} and\n * {@link FrontendComponentPropSpecification.notes}.\n */\n notes?: string[];\n}\n\n/**\n * Import-oriented metadata for frontend component specifications.\n *\n * The structural component target now lives at the top level of the\n * specification. This lane is reserved for extra import-oriented references that\n * help downstream code-writing prompts.\n */\nexport interface FrontendComponentSpecificationCodeHandling {\n /** Extra public symbols useful for downstream code-writing prompts. */\n supportingSymbols?: CodeSymbolRef[];\n}\n\n/**\n * Additive preset-level specification layered on top of the shared component\n * description.\n *\n * Most components will only expose `DEFAULT`, but multi-preset components can\n * add several preset entries without duplicating interface or usage guidance.\n */\nexport interface FrontendComponentPresetSpecification {\n /** Why this preset exists beyond the shared component contract. */\n specialConcern?: string;\n /** Translation-specific caveats or wording posture for this preset. */\n translationNotes?: string[];\n /** Authoring caveats specific to this preset implementation. */\n authoringNotes?: string[];\n /** Effective runtime target for this preset implementation. */\n presetTarget: FrontendComponentPresetTarget;\n /** Original/base slot implementation source, if one exists. */\n baseElement?: FrontendComponentSpecificationContribution;\n /** Later contributions that inject or override the slot implementation. */\n injectedContributions?: FrontendComponentSpecificationContribution[];\n /** Extra public symbols useful for downstream code-writing prompts. */\n supportingSymbols?: CodeSymbolRef[];\n}\n\n/**\n * Structural kind of one documented component prop.\n */\nexport enum FrontendComponentPropValueKind {\n PRIMITIVE = 'primitive',\n ENUM = 'enum',\n OBJECT = 'object',\n ARRAY = 'array',\n FUNCTION = 'function',\n REACT_NODE = 'react-node',\n TYPE_REFERENCE = 'type-reference',\n UNION = 'union',\n}\n\n/**\n * Nested value-shape description for non-trivial prop kinds such as arrays,\n * unions, object references, and callback props.\n */\nexport interface FrontendComponentPropValueShape {\n /** High-level kind of value expected by the prop or nested member. */\n valueKind: FrontendComponentPropValueKind;\n /** Primitive kind when the value is a primitive. */\n primitiveType?: CodePrimitiveKind;\n /** Importable type/value reference when the shape is driven by another contract. */\n valueTypeSymbol?: CodeSymbolRef;\n /** Structured vocabulary when the value is constrained by known options. */\n vocabulary?: FrontendComponentPropValueVocabulary;\n /** Array element shape when `valueKind` is `ARRAY`. */\n arrayElement?: Omit<FrontendComponentPropValueShape, 'arrayElement' | 'unionMembers'>;\n /** Union member shapes when `valueKind` is `UNION`. */\n unionMembers?: Array<Omit<FrontendComponentPropValueShape, 'arrayElement' | 'unionMembers'>>;\n /** Short callback signature hint when `valueKind` is `FUNCTION`. */\n functionSignature?: string;\n /**\n * Extra caveats for the nested value shape.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened into the inline structural summary\n * produced for the shape (which appears within a parent prop bullet line).\n *\n * Because nested shapes (`arrayElement`, `unionMembers`, root prop shape)\n * are composed inline into a single structural summary, companion\n * materializers MUST hoist these notes UP to the parent prop's bullet\n * block, prefixed with a path-aware label (e.g. ``\\`propName\\` arrayElement\n * note: ${note}`` or ``\\`propName\\` unionMember[0] note: ${note}``) so each\n * caveat surfaces as its own bullet. This matches the per-bullet contract\n * enforced for {@link FrontendComponentPropSpecification.notes} and\n * {@link FrontendComponentPropValueVocabulary.notes}.\n */\n notes?: string[];\n}\n\n/**\n * One explicit value inside a prop vocabulary.\n */\nexport interface FrontendComponentPropValueOption {\n /** Literal runtime value expected for the prop. */\n value: string | number | boolean;\n /** Short explanation of what this value means in practice. */\n meaning?: string;\n}\n\n/**\n * Structured vocabulary metadata for a prop that has a constrained set of\n * values or a declared enum source.\n */\nexport interface FrontendComponentPropValueVocabulary {\n /** Public enum/const declaration that owns the value vocabulary, if any. */\n enumerationSource?: CodeSymbolRef;\n /** Explicit known values that downstream tools can present directly. */\n values?: FrontendComponentPropValueOption[];\n /** Whether arbitrary user-defined values are still allowed beyond the list. */\n allowCustomValues?: boolean;\n /**\n * Extra caveats when the vocabulary alone is not sufficient.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened into the inline vocabulary summary\n * (which appears either in the top-level prop-vocabulary bullet block or\n * inside a parent prop's bullet line via a nested shape).\n *\n * Companion materializers MUST emit one ``\\`propName\\` vocabulary note:\n * ${note}`` bullet per entry — at the top-level vocabulary block when the\n * vocabulary is attached directly to a prop, and hoisted to the parent\n * prop's bullet block when the vocabulary is nested inside a shape (e.g.\n * ``\\`propName\\` arrayElement vocabulary note: ${note}``). This matches\n * the per-bullet contract enforced for\n * {@link FrontendComponentPropValueShape.notes} and\n * {@link FrontendComponentPropSpecification.notes}.\n */\n notes?: string[];\n}\n\n/**\n * One documented prop on the consumer-facing component interface.\n */\nexport interface FrontendComponentPropSpecification {\n /** Literal prop name on the exported component interface. */\n propName: string;\n /** Why this prop exists from a UI/authoring perspective. */\n purpose: string;\n /** Whether callers normally need to provide the prop explicitly. */\n required?: boolean;\n /** High-level kind of value expected by the prop. */\n valueKind: FrontendComponentPropValueKind;\n /** Primitive kind when `valueKind` is `primitive`. */\n primitiveType?: CodePrimitiveKind;\n /** Importable type/value reference when the prop is backed by another contract. */\n valueTypeSymbol?: CodeSymbolRef;\n /** Declared vocabulary / possible values for constrained props. */\n vocabulary?: FrontendComponentPropValueVocabulary;\n /** Array element shape when `valueKind` is `ARRAY`. */\n arrayElement?: FrontendComponentPropValueShape;\n /** Union member shapes when `valueKind` is `UNION`. */\n unionMembers?: FrontendComponentPropValueShape[];\n /** Short callback signature hint when `valueKind` is `FUNCTION`. */\n functionSignature?: string;\n /** Optional documented default when omitted. */\n defaultValue?: string | number | boolean;\n /**\n * Extra authoring caveats for this prop.\n *\n * **Companion-bullet contract**: Each entry MUST be rendered as a dedicated\n * markdown bullet — never flattened/joined into a single line, and never\n * collapsed into the prop's structural summary line.\n *\n * Companion materializers should emit one ``\\`propName\\` note: ${note}``\n * bullet per entry, alongside the prop's structural header bullet (and any\n * shape/vocabulary notes hoisted from nested\n * {@link FrontendComponentPropValueShape.notes} and\n * {@link FrontendComponentPropValueVocabulary.notes}). This keeps each\n * caveat individually citable downstream and matches the contract enforced\n * for {@link TranslationSlotSpecification.notes} and\n * {@link FrontendComponentSpecificationContribution.notes}.\n */\n notes?: string[];\n}\n\n/**\n * Interface contract for the consumer-facing component surface.\n */\nexport interface FrontendComponentInterfaceContract {\n /** Public type alias/interface describing the consumer-facing props. */\n propsType?: CodeSymbolRef;\n /** Public type alias/interface describing the forwarded ref, if any. */\n refType?: CodeSymbolRef;\n /** Structured documentation for high-value props on the interface. */\n propSpecifications?: FrontendComponentPropSpecification[];\n}\n\n/**\n * Concrete example usage that downstream tools can reuse in prompts or docs.\n */\nexport interface FrontendComponentUsageExample {\n /** Short label for the scenario shown by the snippet. */\n title: string;\n /** Why this example is useful or representative. */\n description?: string;\n /** Code language for rendering/transposition. */\n language?: 'tsx' | 'typescript' | 'javascript';\n /** Example snippet showing truthful component usage. */\n code: string;\n /** Extra caveats or follow-up notes for the snippet. */\n notes?: string[];\n}\n/** @wildo_source:part:end saas.specifications.frontend-component-spec-model */\n\n/**\n * @wildo_source:part:start saas.specifications.frontend-component-spec-factory facet:layer:specification facet:family:companion\n *\n * Semantic overlay for one shared frontend component target.\n */\nexport interface FrontendComponentSpecificationConfig {\n /** Structural runtime target shared by all preset aspects of this component. */\n target: FrontendComponentSpecificationTarget;\n /** Cross-surface semantic identifier shared with higher-level semantics lanes. */\n componentId: string;\n /** Why this component target exists in the product/authoring model. */\n purpose: string;\n /** UI role played by the component target. */\n uiRole: string;\n /** Situations where this component family is the recommended choice. */\n useWhen?: string;\n /** Situations where another component family/pattern should be preferred. */\n avoidWhen?: string;\n /** Translation/i18n role carried by the shared component contract if relevant. */\n translationRole?: string;\n /** Extra authoring guidance for AI/app developers. */\n authoringNotes?: string[];\n /** Notes about how this slot composes with surrounding UI surfaces. */\n compositionNotes?: string[];\n /** Public interface contract for the consumer-facing component surface. */\n componentInterface?: FrontendComponentInterfaceContract;\n /** Concrete usage snippets that prove truthful component authoring. */\n usageExamples?: FrontendComponentUsageExample[];\n /** Default preset to use when callers do not ask for a specific preset. */\n defaultPreset?: string;\n /** Preset-specific additive aspects layered on top of the shared component contract. */\n presetSpecifications: Record<string, FrontendComponentPresetSpecification>;\n /**\n * Public-import-oriented metadata for coding/transposition consumers.\n *\n * Optional: Step 7 deferred follow-up #2 flipped this slot from required to\n * optional once the audit confirmed every engine spec authors `{}` as a\n * noise-only placeholder (no inner field is populated). Keeping the slot\n * preserves the future expansion point for app overlays that want to ship\n * `supportingSymbols`, but the empty-object placeholder is no longer\n * required at the call site. The companion renderer reads it via optional\n * chaining (`specification.codeHandling?.supportingSymbols ?? []`) so absence\n * collapses cleanly to the same \"no extra symbols\" output as `{}` did.\n */\n codeHandling?: FrontendComponentSpecificationCodeHandling;\n}\n\n/**\n * Authored input shape before composition helpers normalize the optional preset\n * lane.\n */\nexport interface FrontendComponentSpecificationConfigInput\n extends Omit<FrontendComponentSpecificationConfig, 'presetSpecifications'> {\n presetSpecifications?: Record<string, FrontendComponentPresetSpecification>;\n}\n\n/**\n * Normalize one authored component specification so later additive helpers can\n * safely extend it without every leaf re-declaring empty records.\n */\nexport function frontendComponentSpecification(\n config: FrontendComponentSpecificationConfigInput,\n): FrontendComponentSpecificationConfig {\n const normalized = {\n ...config,\n presetSpecifications: { ...(config.presetSpecifications ?? {}) },\n };\n validateFrontendComponentSpecification(normalized);\n return normalized;\n}\n\n/**\n * Add one preset aspect to an existing shared component target specification.\n */\nexport function addFrontendComponentPresetSpecification(\n specification: FrontendComponentSpecificationConfig,\n presetId: string,\n presetSpecification: FrontendComponentPresetSpecification,\n): FrontendComponentSpecificationConfig {\n const nextSpecification = {\n ...specification,\n presetSpecifications: {\n ...specification.presetSpecifications,\n [presetId]: specification.presetSpecifications[presetId]\n ? mergeFrontendComponentPresetSpecification(\n specification.presetSpecifications[presetId]!,\n presetSpecification,\n )\n : presetSpecification,\n },\n };\n validateFrontendComponentSpecification(nextSpecification);\n return nextSpecification;\n}\n/** @wildo_source:part:end saas.specifications.frontend-component-spec-factory */\n\nfunction validateFrontendComponentSpecification(\n specification: FrontendComponentSpecificationConfig,\n): void {\n const presetEntries = Object.entries(specification.presetSpecifications);\n if (presetEntries.length === 0) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must declare at least one preset specification.`,\n );\n }\n\n if (\n specification.defaultPreset !== undefined\n && specification.presetSpecifications[specification.defaultPreset] === undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" declares defaultPreset \"${specification.defaultPreset}\" but no matching preset specification exists.`,\n );\n }\n\n for (const [presetId, presetSpecification] of presetEntries) {\n if (presetSpecification.presetTarget.preset !== presetId) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" registered preset key \"${presetId}\" but the preset target declares \"${presetSpecification.presetTarget.preset}\".`,\n );\n }\n validatePresetContribution(\n specification,\n presetId,\n 'baseElement',\n presetSpecification.baseElement,\n );\n for (const [index, contribution] of (presetSpecification.injectedContributions ?? []).entries()) {\n validatePresetContribution(\n specification,\n presetId,\n `injectedContributions[${index}]`,\n contribution,\n );\n }\n }\n}\n\nfunction validatePresetContribution(\n specification: FrontendComponentSpecificationConfig,\n presetId: string,\n contributionPath: string,\n contribution: FrontendComponentSpecificationContribution | undefined,\n): void {\n if (!contribution) {\n return;\n }\n\n if (contribution.sourceIdentity.componentRef !== specification.target.componentRef) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with componentRef \"${contribution.sourceIdentity.componentRef}\" that does not match target \"${specification.target.componentRef}\".`,\n );\n }\n\n if (\n contribution.sourceIdentity.identityGranularity === FrontendComponentContributionIdentityGranularity.SLOT\n && specification.target.category === undefined\n && contribution.sourceIdentity.category !== undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with unexpected category \"${contribution.sourceIdentity.category}\" on an uncategorized target.`,\n );\n }\n\n if (\n contribution.sourceIdentity.identityGranularity === FrontendComponentContributionIdentityGranularity.SLOT\n && specification.target.category !== undefined\n && contribution.sourceIdentity.category === undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must preserve category \"${specification.target.category}\" for ${contributionPath}.`,\n );\n }\n\n if (\n contribution.sourceIdentity.identityGranularity === FrontendComponentContributionIdentityGranularity.SLOT\n && specification.target.category !== undefined\n && contribution.sourceIdentity.category !== specification.target.category\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with category \"${contribution.sourceIdentity.category}\" that does not match target category \"${specification.target.category}\".`,\n );\n }\n\n if (\n contribution.sourceIdentity.preset !== undefined\n && contribution.sourceIdentity.preset !== presetId\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" has ${contributionPath} with preset \"${contribution.sourceIdentity.preset}\" that does not match preset \"${presetId}\".`,\n );\n }\n\n if (contribution.registrationPath === FrontendComponentRegistrationPathKind.FRONTEND_MODULE_REGISTRATION) {\n if (contribution.sourceIdentity.identityGranularity !== FrontendComponentContributionIdentityGranularity.COMPONENT_REF) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must use COMPONENT_REF identity for ${contributionPath} on FRONTEND_MODULE_REGISTRATION.`,\n );\n }\n if (\n contribution.sourceIdentity.preset !== undefined\n || contribution.sourceIdentity.category !== undefined\n ) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" cannot preserve preset/category identity for ${contributionPath} on FRONTEND_MODULE_REGISTRATION.`,\n );\n }\n }\n\n if (\n contribution.registrationPath === FrontendComponentRegistrationPathKind.FRAMEWORK_DEFAULT_PRESETS\n || contribution.registrationPath === FrontendComponentRegistrationPathKind.FRAMEWORK_LAYOUTS\n ) {\n if (contribution.sourceIdentity.identityGranularity !== FrontendComponentContributionIdentityGranularity.SLOT) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must use SLOT identity for ${contributionPath} on ${contribution.registrationPath}.`,\n );\n }\n if (contribution.sourceIdentity.preset === undefined) {\n throw new Error(\n `Frontend component specification \"${specification.componentId}\" must declare a preset for ${contributionPath} on ${contribution.registrationPath}.`,\n );\n }\n }\n}\n\nfunction mergeFrontendComponentPresetSpecification(\n base: FrontendComponentPresetSpecification,\n incoming: FrontendComponentPresetSpecification,\n): FrontendComponentPresetSpecification {\n const mergedInjectedContributions = [\n ...(base.injectedContributions ?? []),\n ...(incoming.injectedContributions ?? []),\n ];\n return {\n specialConcern: mergeCompatibleScalar('specialConcern', base.specialConcern, incoming.specialConcern),\n translationNotes: mergeStringArrays(base.translationNotes, incoming.translationNotes),\n authoringNotes: mergeStringArrays(base.authoringNotes, incoming.authoringNotes),\n presetTarget: mergePresetTarget(base.presetTarget, incoming.presetTarget),\n baseElement: mergeCompatibleScalar('baseElement', base.baseElement, incoming.baseElement),\n injectedContributions: mergedInjectedContributions.length > 0 ? mergedInjectedContributions : undefined,\n supportingSymbols: mergeCodeSymbolRefs(base.supportingSymbols, incoming.supportingSymbols),\n };\n}\n\nfunction mergePresetTarget(\n base: FrontendComponentPresetTarget,\n incoming: FrontendComponentPresetTarget,\n): FrontendComponentPresetTarget {\n if (base.preset !== incoming.preset) {\n throw new Error(\n `Cannot merge preset specifications for different preset targets (\"${base.preset}\" vs \"${incoming.preset}\").`,\n );\n }\n return {\n preset: base.preset,\n presetDeclaration: mergeCompatibleScalar(\n 'presetDeclaration',\n base.presetDeclaration,\n incoming.presetDeclaration,\n ),\n registryKey: mergeCompatibleScalar('registryKey', base.registryKey, incoming.registryKey),\n };\n}\n\nfunction mergeCompatibleScalar<T>(\n label: string,\n base: T | undefined,\n incoming: T | undefined,\n): T | undefined {\n if (base === undefined) {\n return incoming;\n }\n if (incoming === undefined) {\n return base;\n }\n if (areValuesEqual(base, incoming)) {\n return base;\n }\n throw new Error(`Cannot merge frontend component preset specifications because \"${label}\" conflicts.`);\n}\n\nfunction mergeStringArrays(\n base: string[] | undefined,\n incoming: string[] | undefined,\n): string[] | undefined {\n if (base === undefined) {\n return incoming;\n }\n if (incoming === undefined) {\n return base;\n }\n return [...new Set([...base, ...incoming])];\n}\n\nfunction mergeCodeSymbolRefs(\n base: CodeSymbolRef[] | undefined,\n incoming: CodeSymbolRef[] | undefined,\n): CodeSymbolRef[] | undefined {\n if (base === undefined) {\n return incoming;\n }\n if (incoming === undefined) {\n return base;\n }\n\n const byKey = new Map<string, CodeSymbolRef>();\n for (const symbol of [...base, ...incoming]) {\n const key = buildCodeSymbolRefKey(symbol);\n const existing = byKey.get(key);\n /*\n * `incoming` wins on every field, EXCEPT that a location already known is not lost to an\n * overlay that simply does not restate it. Without this, an overlay re-declaring a symbol\n * to change (say) its notes would silently drop the base's `filePathHint`, and the drop is\n * invisible: the merged ref is still valid, just less useful to the coding agent that reads\n * it. Same-key refs describe the same symbol, so the base's location cannot be wrong here.\n */\n byKey.set(\n key,\n existing?.filePathHint !== undefined && symbol.filePathHint === undefined\n ? { ...symbol, filePathHint: existing.filePathHint }\n : symbol,\n );\n }\n return [...byKey.values()];\n}\n\n/**\n * Dedup identity for a symbol ref: WHERE it is imported from plus WHAT it is called.\n *\n * `filePathHint` is deliberately excluded. It is a navigation aid describing the same symbol,\n * not part of its identity — keying on it would split one symbol into two entries the moment a\n * single overlay omitted the hint (issue #150).\n */\nfunction buildCodeSymbolRefKey(symbol: CodeSymbolRef): string {\n return [\n symbol.packageName,\n symbol.importPath ?? '',\n symbol.exportName,\n symbol.symbolKind ?? '',\n symbol.declarationKind ?? '',\n ].join('::');\n}\n\nfunction areValuesEqual(left: unknown, right: unknown): boolean {\n return JSON.stringify(left) === JSON.stringify(right);\n}\n\n/**\n * @wildo_source:part:start saas.specifications.frontend-component-spec-factory facet:layer:specification facet:family:companion\n *\n * Registry keyed by the shared component target identity.\n */\nexport type FrontendComponentSpecification = Record<string, FrontendComponentSpecificationConfig>;\n/** @wildo_source:part:end saas.specifications.frontend-component-spec-factory */\n"]}
@@ -3,7 +3,18 @@ import type { TranslationSlotSpecificationMap } from './translation-slot-specifi
3
3
  interface PublicCodeSymbolRef {
4
4
  packageName: string;
5
5
  exportName: string;
6
+ /**
7
+ * PUBLIC SUBPATH only — a subpath the owning package declares in
8
+ * `package.json#exports`, so `${packageName}/${importPath}` resolves. For a module
9
+ * that has no public door, author `filePathHint` instead (issue #150).
10
+ */
6
11
  importPath?: string;
12
+ /**
13
+ * MODULE LOCATION inside the owning package — a navigation aid, never concatenated
14
+ * onto `packageName`. See `CodeSymbolRef` in `@wildo-ai/zod-decorators` for the
15
+ * canonical contract this narrows.
16
+ */
17
+ filePathHint?: string;
7
18
  }
8
19
  interface FullCustomViewDefinitionSpecRef {
9
20
  ref: string;