@astryxdesign/cli 0.6.3-canary.ea2f048 → 0.6.3-canary.ee13359

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 (571) hide show
  1. package/README.md +114 -76
  2. package/api/blog/blog.doc.mjs +1 -0
  3. package/api/build/build.doc.mjs +4 -3
  4. package/api/build/build.test.mjs +14 -3
  5. package/api/build/build.type.d.mts +36 -2
  6. package/api/build/build.type.mjs +25 -4
  7. package/api/build/help/help.d.mts +8 -5
  8. package/api/build/help/help.mjs +56 -6
  9. package/api/component/_adapter.d.mts +6 -12
  10. package/api/component/_adapter.mjs +20 -10
  11. package/api/component/component.doc.mjs +13 -3
  12. package/api/component/component.mjs +91 -14
  13. package/api/component/component.test.mjs +38 -0
  14. package/api/component/component.type.d.mts +22 -11
  15. package/api/component/component.type.mjs +32 -24
  16. package/api/component/detail/blocks/blocks.d.mts +2 -1
  17. package/api/component/detail/blocks/blocks.mjs +4 -3
  18. package/api/component/list/list.d.mts +0 -5
  19. package/api/component/list/list.mjs +40 -11
  20. package/api/discover/discover.doc.mjs +2 -1
  21. package/api/discover/discover.type.d.mts +4 -4
  22. package/api/discover/discover.type.mjs +10 -10
  23. package/api/docs/_adapter.d.mts +230 -41
  24. package/api/docs/_adapter.mjs +734 -108
  25. package/api/docs/compiled-topics.test.mjs +78 -0
  26. package/api/docs/detail/detail.mjs +22 -63
  27. package/api/docs/detail/section/section.d.mts +1 -1
  28. package/api/docs/detail/section/section.mjs +54 -19
  29. package/api/docs/detail/section/section.test.mjs +50 -0
  30. package/api/docs/docs.d.mts +10 -3
  31. package/api/docs/docs.doc.mjs +54 -16
  32. package/api/docs/docs.mjs +53 -10
  33. package/api/docs/docs.test.mjs +164 -4
  34. package/api/docs/docs.type.d.mts +205 -5
  35. package/api/docs/docs.type.mjs +137 -11
  36. package/api/docs/index/index.d.mts +18 -0
  37. package/api/docs/index/index.mjs +40 -0
  38. package/api/docs/index/index.test.mjs +62 -0
  39. package/api/docs/integration-tree.test.mjs +547 -0
  40. package/api/docs/integrationDocs.test.mjs +114 -8
  41. package/api/docs/list/list.mjs +28 -12
  42. package/api/docs/node/node.d.mts +43 -0
  43. package/api/docs/node/node.mjs +192 -0
  44. package/api/doctor/doctor.d.mts +99 -1
  45. package/api/doctor/doctor.doc.mjs +1 -0
  46. package/api/doctor/doctor.mjs +544 -1
  47. package/api/doctor/doctor.test.mjs +610 -1
  48. package/api/gap-report/gap-report.doc.mjs +8 -4
  49. package/api/hook/_adapter.mjs +19 -5
  50. package/api/hook/hook.doc.mjs +1 -0
  51. package/api/hook/hook.type.d.mts +3 -3
  52. package/api/hook/hook.type.mjs +11 -11
  53. package/api/hook/list/list.d.mts +2 -2
  54. package/api/hook/list/list.mjs +69 -17
  55. package/api/index.d.mts +1 -1
  56. package/api/index.mjs +1 -0
  57. package/api/init/init.doc.mjs +6 -1
  58. package/api/init/init.test.mjs +41 -1
  59. package/api/init/remove/remove.mjs +1 -1
  60. package/api/init/run/run.mjs +20 -10
  61. package/api/integration/add-contribution.component-names.test.mjs +120 -0
  62. package/api/integration/add-contribution.d.mts +2 -1
  63. package/api/integration/add-contribution.mjs +130 -15
  64. package/api/integration/add-contribution.test.mjs +258 -7
  65. package/api/integration/add-theme.mjs +34 -64
  66. package/api/integration/add-theme.test.mjs +105 -21
  67. package/api/integration/authoring-checks.mjs +108 -31
  68. package/api/integration/authoring-checks.test.mjs +171 -6
  69. package/api/integration/authoring-checks.type.d.mts +3 -1
  70. package/api/integration/authoring-checks.type.mjs +3 -1
  71. package/api/integration/integration-authoring.type.d.mts +3 -1
  72. package/api/integration/integration-authoring.type.mjs +2 -0
  73. package/api/integration/integration-block-exports.test.mjs +10 -6
  74. package/api/integration/integrationAdd.doc.mjs +14 -4
  75. package/api/integration/integrationAddAgentDoc.doc.mjs +1 -0
  76. package/api/integration/integrationAddCodemod.doc.mjs +1 -0
  77. package/api/integration/integrationAddComponent.doc.mjs +2 -1
  78. package/api/integration/integrationAddDoc.doc.mjs +8 -1
  79. package/api/integration/integrationAddTemplate.doc.mjs +1 -0
  80. package/api/integration/integrationAddTheme.doc.mjs +6 -5
  81. package/api/integration/integrationComponentConflicts.doc.mjs +1 -0
  82. package/api/integration/integrationDocConflicts.doc.mjs +2 -1
  83. package/api/integration/integrationPackCheck.doc.mjs +2 -1
  84. package/api/integration/integrationTemplateConflicts.doc.mjs +7 -5
  85. package/api/integration/pack-check.mjs +83 -7
  86. package/api/integration/pack-check.test.mjs +387 -47
  87. package/api/integration/pack-check.type.d.mts +26 -2
  88. package/api/integration/pack-check.type.mjs +14 -1
  89. package/api/integration/summarizeIssues.doc.mjs +1 -0
  90. package/api/integration/validate-integration-fixes.test.mjs +1389 -0
  91. package/api/integration/validate-integration.mjs +52 -102
  92. package/api/integration/validate-integration.test.mjs +179 -26
  93. package/api/integration/validate-unread-theme-folders.test.mjs +110 -0
  94. package/api/integration/validateIntegration.doc.mjs +3 -2
  95. package/api/json/assertResponse.doc.mjs +1 -0
  96. package/api/json/envelope-types.test.mjs +76 -0
  97. package/api/json/index.ts +2 -0
  98. package/api/json/isError.doc.mjs +1 -0
  99. package/api/json/parseResponse.doc.mjs +3 -2
  100. package/api/layout/_adapter.mjs +20 -5
  101. package/api/layout/expand/expand.mjs +7 -5
  102. package/api/layout/expand/expand.path-safety.test.mjs +53 -0
  103. package/api/layout/grammar/grammar.mjs +2 -1
  104. package/api/layout/layoutCheck.doc.mjs +1 -0
  105. package/api/layout/layoutExpand.doc.mjs +2 -1
  106. package/api/layout/layoutGrammar.doc.mjs +1 -0
  107. package/api/search/search-return-type.test.mjs +54 -0
  108. package/api/search/search.d.mts +29 -11
  109. package/api/search/search.doc.mjs +8 -2
  110. package/api/search/search.mjs +337 -41
  111. package/api/search/search.test.mjs +124 -1
  112. package/api/search/search.type.d.mts +15 -3
  113. package/api/search/search.type.mjs +5 -2
  114. package/api/swizzle/copy/copy.mjs +28 -11
  115. package/api/swizzle/swizzle.doc.mjs +2 -1
  116. package/api/swizzle/swizzle.type.d.mts +2 -2
  117. package/api/swizzle/swizzle.type.mjs +2 -2
  118. package/api/template/copy/copy.mjs +17 -23
  119. package/api/template/copy/copy.test.mjs +17 -0
  120. package/api/template/list/list.mjs +1 -0
  121. package/api/template/template-integration.test.mjs +1022 -3
  122. package/api/template/template-suffix.test.mjs +41 -21
  123. package/api/template/template.d.mts +1 -1
  124. package/api/template/template.doc.mjs +30 -8
  125. package/api/template/template.mjs +45 -8
  126. package/api/template/template.type.d.mts +12 -14
  127. package/api/template/template.type.mjs +15 -14
  128. package/api/theme/_adapter.d.mts +2 -3
  129. package/api/theme/_adapter.mjs +4 -5
  130. package/api/theme/add/add.binary.test.mjs +84 -0
  131. package/api/theme/add/add.mjs +20 -3
  132. package/api/theme/add/add.staging.test.mjs +66 -0
  133. package/api/theme/add/add.test.mjs +14 -1
  134. package/api/theme/build/build.mjs +133 -42
  135. package/api/theme/build/build.public-component-vars.test.mjs +1 -1
  136. package/api/theme/build/build.receipt-doc.test.mjs +111 -0
  137. package/api/theme/build/build.test.mjs +127 -0
  138. package/api/theme/build/font-warning.mjs +3 -3
  139. package/api/theme/build/font-warning.test.mjs +5 -2
  140. package/api/theme/generateTonalPalette.doc.mjs +1 -0
  141. package/api/theme/integration-themes.test.mjs +39 -28
  142. package/api/theme/list/list.test.mjs +19 -20
  143. package/api/theme/listThemes.doc.mjs +6 -5
  144. package/api/theme/palette/generate/generate.mjs +8 -3
  145. package/api/theme/palette/generate/generate.test.mjs +96 -0
  146. package/api/theme/palette/generate/generator.d.mts +10 -13
  147. package/api/theme/palette/generate/generator.mjs +15 -4
  148. package/api/theme/palette/generate/generator.test.mjs +10 -0
  149. package/api/theme/template/template.mjs +11 -2
  150. package/api/theme/template/template.test.mjs +20 -0
  151. package/api/theme/theme.type.d.mts +170 -11
  152. package/api/theme/theme.type.mjs +94 -27
  153. package/api/theme/themeAdd.doc.mjs +4 -3
  154. package/api/theme/themeBuild.doc.mjs +8 -4
  155. package/api/theme/themeList.doc.mjs +6 -3
  156. package/api/theme/themeListAvailable.doc.mjs +5 -3
  157. package/api/theme/themePaletteGenerate.doc.mjs +1 -0
  158. package/api/theme/themeTargets.doc.mjs +1 -0
  159. package/api/theme/themeTemplate.doc.mjs +6 -2
  160. package/api/upgrade/_adapter.d.mts +32 -5
  161. package/api/upgrade/_adapter.mjs +139 -22
  162. package/api/upgrade/list/list.mjs +2 -1
  163. package/api/upgrade/list/list.test.mjs +73 -0
  164. package/api/upgrade/project-context.test.mjs +272 -0
  165. package/api/upgrade/provider-agreement.test.mjs +152 -0
  166. package/api/upgrade/run/run.mjs +356 -59
  167. package/api/upgrade/status/status.mjs +2 -2
  168. package/api/upgrade/upgrade.doc.mjs +12 -5
  169. package/api/upgrade/upgrade.type.d.mts +43 -5
  170. package/api/upgrade/upgrade.type.mjs +27 -11
  171. package/assets/codemods/__tests__/runner.test.mjs +330 -8
  172. package/assets/codemods/integration-discovery.mjs +48 -4
  173. package/assets/codemods/integration-discovery.test.mjs +73 -0
  174. package/assets/codemods/integration-runner.mjs +56 -4
  175. package/assets/codemods/integration-runner.protection.test.mjs +153 -0
  176. package/assets/codemods/run-codemod.mjs +177 -34
  177. package/assets/codemods/runner.mjs +350 -102
  178. package/assets/codemods/term-log.mjs +32 -8
  179. package/assets/codemods/term-log.test.mjs +19 -1
  180. package/assets/codemods/transform-prop.mjs +109 -0
  181. package/assets/codemods/transform-prop.test.mjs +95 -0
  182. package/assets/codemods/transforms/next/__tests__/migrate-native-picker-to-presentation.test.mjs +63 -0
  183. package/assets/codemods/transforms/next/__tests__/migrate-theme-catalog-to-descriptors.test.mjs +220 -0
  184. package/assets/codemods/transforms/next/index.mjs +19 -1
  185. package/assets/codemods/transforms/next/migrate-native-picker-to-presentation.mjs +148 -0
  186. package/assets/codemods/transforms/next/migrate-theme-catalog-to-descriptors.mjs +141 -0
  187. package/assets/codemods/transforms/v0.0.14/__tests__/rename-status-variants.test.mjs +86 -165
  188. package/assets/codemods/transforms/v0.0.14/rename-status-variants.mjs +72 -210
  189. package/assets/codemods/transforms/v0.1.8/__tests__/rename-avatar-size-scale.test.mjs +83 -115
  190. package/assets/codemods/transforms/v0.1.8/rename-avatar-size-scale.mjs +57 -186
  191. package/assets/codemods/transforms/v0.3.0/__tests__/unwrap-authoring-factories.test.mjs +27 -5
  192. package/assets/codemods/transforms/v0.3.0/unwrap-authoring-factories.mjs +20 -5
  193. package/assets/codemods/transforms/v0.6.0/__tests__/next-codemods.test.mjs +47 -0
  194. package/assets/codemods/transforms/v0.6.0/rename-resizable-pixel-bounds.mjs +57 -10
  195. package/assets/docs/README.md +9 -0
  196. package/assets/docs/authoring.doc.mjs +14 -0
  197. package/assets/docs/getting-started.doc.mjs +2 -2
  198. package/assets/docs/principles.doc.mjs +6 -6
  199. package/assets/docs/styling-libraries.doc.mjs +3 -3
  200. package/assets/docs/styling.doc.mjs +4 -4
  201. package/assets/docs/theme.doc.mjs +4 -4
  202. package/assets/docs/tokens.doc.mjs +1 -1
  203. package/assets/docs/tree/api.doc.mjs +30 -0
  204. package/assets/docs/tree/cli.doc.mjs +23 -0
  205. package/assets/docs/tree/commands.doc.mjs +25 -0
  206. package/assets/docs/{cli-integrations.doc.mjs → tree/integrations.doc.mjs} +124 -25
  207. package/assets/docs/tree/integrations.test.mjs +62 -0
  208. package/assets/docs/tree/writing-docs.doc.mjs +286 -0
  209. package/assets/docs/working-with-ai.doc.mjs +1 -1
  210. package/assets/templates/blocks/components/DateInput/DateInputDateRange.tsx +1 -1
  211. package/assets/templates/blocks/components/Item/ItemDocumentTabs.doc.mjs +14 -0
  212. package/assets/templates/blocks/components/Item/ItemDocumentTabs.tsx +100 -0
  213. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaInlineRail.doc.mjs +14 -0
  214. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaInlineRail.tsx +61 -0
  215. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaOverscrollChaining.doc.mjs +14 -0
  216. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaOverscrollChaining.tsx +126 -0
  217. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaShowcase.doc.mjs +15 -0
  218. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaShowcase.tsx +86 -0
  219. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyGroupHeaders.doc.mjs +14 -0
  220. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyGroupHeaders.tsx +99 -0
  221. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.doc.mjs +14 -0
  222. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.tsx +122 -0
  223. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.doc.mjs +14 -0
  224. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.tsx +95 -0
  225. package/assets/templates/blocks/components/TimeInput/TimeInputConstrained.tsx +1 -0
  226. package/assets/templates/pages/table-tree/page.tsx +1704 -0
  227. package/assets/templates/pages/table-tree/template.doc.mjs +12 -0
  228. package/assets/templates/themes/butter/butterTheme.doc.mjs +11 -0
  229. package/assets/templates/themes/chocolate/chocolateTheme.doc.mjs +11 -0
  230. package/assets/templates/themes/gothic/gothicTheme.doc.mjs +11 -0
  231. package/assets/templates/themes/matcha/matchaTheme.doc.mjs +11 -0
  232. package/assets/templates/themes/neutral/neutralTheme.doc.mjs +11 -0
  233. package/assets/templates/themes/stone/stoneTheme.doc.mjs +11 -0
  234. package/assets/templates/themes/y2k/y2kTheme.doc.mjs +11 -0
  235. package/authoring/_shared/contract.ts +22 -0
  236. package/authoring/codemod/codemod.doc.mjs +7 -2
  237. package/authoring/codemod/parse.d.mts +8 -8
  238. package/authoring/codemod/parse.mjs +8 -6
  239. package/authoring/codemod/type.ts +12 -0
  240. package/authoring/config/config.doc.mjs +2 -2
  241. package/authoring/config/debug-composition.test.mjs +92 -0
  242. package/authoring/config/parse.d.mts +13 -13
  243. package/authoring/config/parse.mjs +8 -8
  244. package/authoring/config/type.ts +18 -6
  245. package/authoring/debug/debug.doc.d.mts +11 -0
  246. package/authoring/debug/debug.doc.mjs +182 -0
  247. package/authoring/debug/parse.d.mts +8 -8
  248. package/authoring/debug/parse.mjs +3 -3
  249. package/authoring/doctypes/_schema.d.mts +718 -23
  250. package/authoring/doctypes/_schema.mjs +519 -39
  251. package/authoring/doctypes/base/graph-fields.doc.d.mts +9 -0
  252. package/authoring/doctypes/base/graph-fields.doc.mjs +64 -0
  253. package/authoring/doctypes/base/type.ts +41 -0
  254. package/authoring/doctypes/command/command.doc.mjs +4 -3
  255. package/authoring/doctypes/command/parse.d.mts +2 -2
  256. package/authoring/doctypes/command/parse.mjs +1 -1
  257. package/authoring/doctypes/command/type.ts +5 -4
  258. package/authoring/doctypes/component/component.doc.mjs +6 -3
  259. package/authoring/doctypes/component/parse.d.mts +2 -2
  260. package/authoring/doctypes/component/parse.mjs +1 -1
  261. package/authoring/doctypes/component/type.ts +6 -5
  262. package/authoring/doctypes/doctypes-new.test.mjs +48 -6
  263. package/authoring/doctypes/enum/enum.doc.mjs +1 -1
  264. package/authoring/doctypes/enum/parse.d.mts +2 -2
  265. package/authoring/doctypes/enum/parse.mjs +1 -1
  266. package/authoring/doctypes/enum/type.ts +4 -2
  267. package/authoring/doctypes/function/function.doc.mjs +7 -2
  268. package/authoring/doctypes/function/parse.d.mts +2 -2
  269. package/authoring/doctypes/function/parse.mjs +1 -1
  270. package/authoring/doctypes/function/type.ts +9 -4
  271. package/authoring/doctypes/hook/hook.doc.mjs +4 -0
  272. package/authoring/doctypes/hook/parse.d.mts +2 -2
  273. package/authoring/doctypes/hook/parse.mjs +1 -1
  274. package/authoring/doctypes/hook/type.ts +5 -4
  275. package/authoring/doctypes/legacy.d.mts +8 -6
  276. package/authoring/doctypes/legacy.mjs +5 -4
  277. package/authoring/doctypes/load-contract.test.mjs +208 -0
  278. package/authoring/doctypes/namespace/namespace.doc.d.mts +9 -0
  279. package/authoring/doctypes/namespace/namespace.doc.mjs +128 -0
  280. package/authoring/doctypes/namespace/parse.d.mts +12 -0
  281. package/authoring/doctypes/namespace/parse.mjs +25 -0
  282. package/authoring/doctypes/namespace/parse.test.mjs +163 -0
  283. package/authoring/doctypes/namespace/type.ts +74 -0
  284. package/authoring/doctypes/parse.d.mts +22 -18
  285. package/authoring/doctypes/parse.mjs +22 -11
  286. package/authoring/doctypes/parse.test.mjs +77 -3
  287. package/authoring/doctypes/reference/parse.d.mts +2 -2
  288. package/authoring/doctypes/reference/parse.mjs +8 -5
  289. package/authoring/doctypes/reference/reference.doc.mjs +20 -5
  290. package/authoring/doctypes/reference/type.ts +53 -5
  291. package/authoring/doctypes/schema/parse.d.mts +2 -2
  292. package/authoring/doctypes/schema/parse.mjs +1 -1
  293. package/authoring/doctypes/schema/schema.doc.mjs +1 -1
  294. package/authoring/doctypes/schema/type.ts +4 -4
  295. package/authoring/doctypes/template/parse.d.mts +94 -1
  296. package/authoring/doctypes/template/parse.mjs +40 -2
  297. package/authoring/doctypes/template/parse.test.mjs +26 -2
  298. package/authoring/doctypes/template/template.doc.mjs +13 -3
  299. package/authoring/doctypes/template/type.ts +13 -2
  300. package/authoring/doctypes/theme/parse.d.mts +35 -0
  301. package/authoring/doctypes/theme/parse.mjs +76 -0
  302. package/authoring/doctypes/theme/theme.doc.d.mts +9 -0
  303. package/authoring/doctypes/theme/theme.doc.mjs +79 -0
  304. package/authoring/doctypes/theme/type.ts +42 -0
  305. package/authoring/doctypes/types.ts +12 -10
  306. package/authoring/gap-report/gap-report.doc.d.mts +12 -0
  307. package/authoring/gap-report/gap-report.doc.mjs +183 -0
  308. package/authoring/gap-report/parse.d.mts +10 -10
  309. package/authoring/gap-report/parse.mjs +6 -6
  310. package/authoring/gap-report/type.ts +1 -1
  311. package/authoring/identity/identity.doc.d.mts +9 -0
  312. package/authoring/identity/identity.doc.mjs +61 -0
  313. package/authoring/identity/type.ts +132 -0
  314. package/authoring/index.d.mts +2 -0
  315. package/authoring/index.d.ts +52 -17
  316. package/authoring/index.mjs +3 -1
  317. package/authoring/integration/integration.doc.mjs +15 -8
  318. package/authoring/integration/parse.d.mts +2 -2
  319. package/authoring/integration/parse.mjs +1 -1
  320. package/authoring/integration/parse.test.mjs +10 -1
  321. package/authoring/integration/schema.d.mts +6 -4
  322. package/authoring/integration/schema.mjs +9 -3
  323. package/authoring/integration/type.ts +19 -8
  324. package/authoring/shadcn/receipt.d.mts +6 -6
  325. package/clients/cli/__tests__/cliManifest.test.ts +27 -29
  326. package/clients/cli/command-load-failure.test.mjs +83 -0
  327. package/clients/cli/commands/blog.doc.mjs +1 -1
  328. package/clients/cli/commands/blog.mjs +23 -8
  329. package/clients/cli/commands/blog.test.mjs +42 -1
  330. package/clients/cli/commands/build-theme.adaptations.test.mjs +100 -1
  331. package/clients/cli/commands/build-theme.ascii-output.test.mjs +161 -0
  332. package/clients/cli/commands/build-theme.flag-docs.test.mjs +110 -0
  333. package/clients/cli/commands/build-theme.mjs +16 -50
  334. package/clients/cli/commands/build-theme.path-safety.test.mjs +86 -1
  335. package/clients/cli/commands/build-theme.variants.test.mjs +76 -0
  336. package/clients/cli/commands/build.doc.mjs +5 -2
  337. package/clients/cli/commands/build.exit-codes-doc.test.mjs +50 -0
  338. package/clients/cli/commands/build.mjs +37 -49
  339. package/clients/cli/commands/build.playbook.test.mjs +75 -0
  340. package/clients/cli/commands/build.text-fields.test.mjs +40 -0
  341. package/clients/cli/commands/component/index.mjs +3 -8
  342. package/clients/cli/commands/component-ownership.test.mjs +3 -3
  343. package/clients/cli/commands/component-package.test.mjs +46 -0
  344. package/clients/cli/commands/component-resolution.test.mjs +21 -0
  345. package/clients/cli/commands/component.doc.mjs +1 -1
  346. package/clients/cli/commands/component.test.mjs +19 -0
  347. package/clients/cli/commands/detail-levels.test.mjs +2 -2
  348. package/clients/cli/commands/discover.broken-integration.test.mjs +52 -5
  349. package/clients/cli/commands/discover.components-flag.test.mjs +97 -0
  350. package/clients/cli/commands/discover.doc.mjs +5 -3
  351. package/clients/cli/commands/discover.mjs +4 -4
  352. package/clients/cli/commands/discover.text-projection.test.mjs +103 -0
  353. package/clients/cli/commands/docs.doc.mjs +28 -6
  354. package/clients/cli/commands/docs.mjs +238 -24
  355. package/clients/cli/commands/docs.test.mjs +193 -1
  356. package/clients/cli/commands/doctor-integration-components.doc.mjs +1 -1
  357. package/clients/cli/commands/doctor-integration-docs.doc.mjs +3 -3
  358. package/clients/cli/commands/doctor-integration-templates.doc.mjs +15 -8
  359. package/clients/cli/commands/doctor-integration-validate.doc.mjs +1 -1
  360. package/clients/cli/commands/doctor-integration.doc.mjs +1 -1
  361. package/clients/cli/commands/doctor-integration.package-json.test.mjs +53 -0
  362. package/clients/cli/commands/doctor-integration.test.mjs +83 -8
  363. package/clients/cli/commands/doctor.doc.mjs +1 -1
  364. package/clients/cli/commands/doctor.mjs +30 -25
  365. package/clients/cli/commands/doctor.test.mjs +42 -0
  366. package/clients/cli/commands/gap-report.doc.mjs +17 -6
  367. package/clients/cli/commands/gap-report.test.mjs +72 -0
  368. package/clients/cli/commands/hook/index.mjs +7 -17
  369. package/clients/cli/commands/hook.doc.mjs +1 -1
  370. package/clients/cli/commands/hook.text-projection.test.mjs +45 -0
  371. package/clients/cli/commands/init.doc.mjs +20 -9
  372. package/clients/cli/commands/init.flag-help.test.mjs +153 -0
  373. package/clients/cli/commands/integration-add.controls.test.mjs +132 -0
  374. package/clients/cli/commands/integration-add.doc.mjs +32 -6
  375. package/clients/cli/commands/integration-authoring.test.mjs +13 -9
  376. package/clients/cli/commands/integration-pack.doc.mjs +1 -1
  377. package/clients/cli/commands/integration-real-world.test.mjs +3 -9
  378. package/clients/cli/commands/integration.doc.mjs +1 -1
  379. package/clients/cli/commands/integration.mjs +1 -0
  380. package/clients/cli/commands/interactive-guard.test.mjs +101 -24
  381. package/clients/cli/commands/json-contract.test.mjs +33 -0
  382. package/clients/cli/commands/layout-check.doc.mjs +15 -4
  383. package/clients/cli/commands/layout-expand.doc.mjs +22 -5
  384. package/clients/cli/commands/layout-grammar.doc.mjs +1 -1
  385. package/clients/cli/commands/layout.doc.mjs +3 -3
  386. package/clients/cli/commands/layout.mjs +21 -9
  387. package/clients/cli/commands/layout.path-help.test.mjs +33 -0
  388. package/clients/cli/commands/layout.stdin-cap.test.mjs +47 -0
  389. package/clients/cli/commands/layout.text-fields.test.mjs +39 -0
  390. package/clients/cli/commands/manifest.doc.mjs +1 -1
  391. package/clients/cli/commands/no-prompt-wording.test.mjs +94 -0
  392. package/clients/cli/commands/search.doc.mjs +7 -4
  393. package/clients/cli/commands/search.mjs +28 -9
  394. package/clients/cli/commands/search.test.mjs +75 -0
  395. package/clients/cli/commands/setup-nudge.test.mjs +6 -0
  396. package/clients/cli/commands/swizzle.doc.mjs +3 -2
  397. package/clients/cli/commands/swizzle.path-safety.test.mjs +42 -0
  398. package/clients/cli/commands/template.doc.mjs +52 -13
  399. package/clients/cli/commands/template.flag-help.test.mjs +117 -0
  400. package/clients/cli/commands/template.mjs +4 -91
  401. package/clients/cli/commands/template.path-help.test.mjs +40 -0
  402. package/clients/cli/commands/text-json-parity.test.mjs +719 -0
  403. package/clients/cli/commands/theme-add.doc.mjs +4 -3
  404. package/clients/cli/commands/theme-build.doc.mjs +8 -7
  405. package/clients/cli/commands/theme-list.doc.mjs +2 -2
  406. package/clients/cli/commands/theme-palette-generate.doc.mjs +9 -5
  407. package/clients/cli/commands/theme-palette-generate.test.mjs +19 -0
  408. package/clients/cli/commands/theme-palette.doc.mjs +1 -1
  409. package/clients/cli/commands/theme-targets.behavior.test.mjs +4 -3
  410. package/clients/cli/commands/theme-targets.doc.mjs +1 -1
  411. package/clients/cli/commands/theme-template.behavior.test.mjs +12 -0
  412. package/clients/cli/commands/theme-template.doc.mjs +2 -2
  413. package/clients/cli/commands/theme.doc.mjs +1 -1
  414. package/clients/cli/commands/upgrade.ascii-output.test.mjs +87 -0
  415. package/clients/cli/commands/upgrade.doc.mjs +22 -10
  416. package/clients/cli/commands/upgrade.file-protection.test.mjs +228 -0
  417. package/clients/cli/commands/upgrade.flag-help.test.mjs +188 -0
  418. package/clients/cli/commands/upgrade.hook-output.test.mjs +88 -0
  419. package/clients/cli/commands/upgrade.mjs +29 -7
  420. package/clients/cli/formatters/index.mjs +164 -1
  421. package/clients/cli/formatters/index.test.mjs +97 -0
  422. package/clients/cli/index.mjs +21 -30
  423. package/clients/cli/latest-version-env.test.mjs +50 -0
  424. package/clients/cli/lib/cli-error.test.mjs +7 -0
  425. package/clients/cli/lib/component-format.mjs +9 -9
  426. package/clients/cli/lib/component-format.test.mjs +1 -1
  427. package/clients/cli/lib/define-command.mjs +32 -6
  428. package/clients/cli/lib/doc-text-ascii.test.mjs +82 -0
  429. package/clients/cli/lib/exit-codes.test.mjs +97 -0
  430. package/clients/cli/lib/hook-format.mjs +19 -10
  431. package/clients/cli/lib/json-shim.mjs +38 -2
  432. package/clients/cli/lib/json-shim.test.mjs +83 -0
  433. package/clients/cli/lib/manifest.d.ts +2 -0
  434. package/clients/cli/lib/manifest.mjs +36 -2
  435. package/clients/cli/lib/manifest.test.mjs +17 -0
  436. package/foundation/agent-docs/agent-docs.d.mts +4 -0
  437. package/foundation/agent-docs/agent-docs.mjs +70 -3
  438. package/foundation/agent-docs/agent-docs.path-safety.test.mjs +266 -4
  439. package/foundation/agent-docs/agent-docs.test.mjs +10 -1
  440. package/foundation/config/integration-debug.test.mjs +28 -3
  441. package/foundation/config/project-themes.test.mjs +11 -19
  442. package/foundation/config/project.d.mts +20 -11
  443. package/foundation/config/project.mjs +263 -91
  444. package/foundation/config/project.test.mjs +270 -21
  445. package/foundation/discovery/authoring-self-docs.d.mts +75 -0
  446. package/foundation/discovery/authoring-self-docs.mjs +224 -0
  447. package/foundation/discovery/authoring-self-docs.test.mjs +165 -0
  448. package/foundation/discovery/authoring-surface.d.mts +74 -0
  449. package/foundation/discovery/authoring-surface.mjs +525 -0
  450. package/foundation/discovery/authoring-surface.test.mjs +392 -0
  451. package/foundation/discovery/cli-self-docs.d.mts +119 -0
  452. package/foundation/discovery/cli-self-docs.mjs +490 -0
  453. package/foundation/discovery/cli-self-docs.test.mjs +375 -0
  454. package/foundation/discovery/component-discovery.d.mts +39 -1
  455. package/foundation/discovery/component-discovery.mjs +50 -1
  456. package/foundation/discovery/component-loader.d.mts +35 -38
  457. package/foundation/discovery/component-loader.mjs +53 -222
  458. package/foundation/discovery/docs-discovery.d.mts +116 -11
  459. package/foundation/discovery/docs-discovery.mjs +389 -108
  460. package/foundation/discovery/docs-discovery.test.mjs +325 -20
  461. package/foundation/discovery/docs-output-budget.d.mts +28 -0
  462. package/foundation/discovery/docs-output-budget.mjs +50 -0
  463. package/foundation/discovery/docs-section-key.d.mts +116 -0
  464. package/foundation/discovery/docs-section-key.mjs +322 -0
  465. package/foundation/discovery/docs-section-key.test.mjs +246 -0
  466. package/foundation/discovery/template-adapter.d.mts +113 -11
  467. package/foundation/discovery/template-adapter.fixture-refs.test.mjs +248 -0
  468. package/foundation/discovery/template-adapter.integration-isolation.test.mjs +94 -0
  469. package/foundation/discovery/template-adapter.mjs +774 -83
  470. package/foundation/discovery/template-adapter.test.mjs +57 -0
  471. package/foundation/discovery/theme-discovery.d.mts +67 -7
  472. package/foundation/discovery/theme-discovery.mjs +916 -186
  473. package/foundation/discovery/theme-discovery.test.mjs +613 -219
  474. package/foundation/discovery/theming-targets.test.mjs +4 -0
  475. package/foundation/doc-compiler/bundle.d.mts +47 -0
  476. package/foundation/doc-compiler/bundle.mjs +278 -0
  477. package/foundation/doc-compiler/bundle.test.mjs +266 -0
  478. package/foundation/doc-compiler/compile.d.mts +343 -0
  479. package/foundation/doc-compiler/compile.mjs +558 -0
  480. package/foundation/doc-compiler/diagnostics.d.mts +126 -0
  481. package/foundation/doc-compiler/diagnostics.mjs +305 -0
  482. package/foundation/doc-compiler/doc-compiler.test.mjs +714 -0
  483. package/foundation/doc-compiler/doc-loads.test.mjs +1642 -0
  484. package/foundation/doc-compiler/import.d.mts +24 -0
  485. package/foundation/doc-compiler/import.mjs +59 -0
  486. package/foundation/doc-compiler/inputs.d.mts +102 -0
  487. package/foundation/doc-compiler/inputs.mjs +291 -0
  488. package/foundation/doc-compiler/inputs.test.mjs +299 -0
  489. package/foundation/doc-compiler/ir.d.mts +22 -0
  490. package/foundation/doc-compiler/ir.mjs +471 -0
  491. package/foundation/doc-compiler/lenses.d.mts +34 -0
  492. package/foundation/doc-compiler/lenses.mjs +128 -0
  493. package/foundation/doc-compiler/links.d.mts +135 -0
  494. package/foundation/doc-compiler/links.mjs +253 -0
  495. package/foundation/doc-compiler/links.test.mjs +139 -0
  496. package/foundation/doc-compiler/lower-doc.test.mjs +495 -0
  497. package/foundation/doc-compiler/overlays.d.mts +37 -0
  498. package/foundation/doc-compiler/overlays.mjs +206 -0
  499. package/foundation/doc-compiler/parse-readable.d.mts +9 -0
  500. package/foundation/doc-compiler/parse-readable.mjs +29 -0
  501. package/foundation/doc-compiler/read.d.mts +127 -0
  502. package/foundation/doc-compiler/read.mjs +325 -0
  503. package/foundation/doc-compiler/read.test.mjs +313 -0
  504. package/foundation/doc-compiler/source.d.mts +33 -0
  505. package/foundation/doc-compiler/source.mjs +128 -0
  506. package/foundation/doc-compiler/tree.d.mts +288 -0
  507. package/foundation/doc-compiler/tree.mjs +876 -0
  508. package/foundation/doc-compiler/tree.test.mjs +598 -0
  509. package/foundation/fs/file-protection.d.mts +33 -0
  510. package/foundation/fs/file-protection.mjs +825 -0
  511. package/foundation/fs/file-protection.test.mjs +250 -0
  512. package/foundation/fs/module-loader.d.mts +1 -0
  513. package/foundation/fs/module-loader.mjs +50 -1
  514. package/foundation/fs/module-loader.stdout.test.mjs +332 -0
  515. package/foundation/fs/path-safety.d.mts +3 -2
  516. package/foundation/fs/path-safety.mjs +49 -19
  517. package/foundation/fs/path-safety.test.mjs +50 -0
  518. package/foundation/fs/publish-file-hardlink-unavailable.test.mjs +129 -94
  519. package/foundation/identity/provider-identity.d.mts +90 -0
  520. package/foundation/identity/provider-identity.mjs +320 -0
  521. package/foundation/identity/provider-identity.test.mjs +254 -0
  522. package/foundation/identity/providers.d.mts +7 -0
  523. package/foundation/identity/providers.mjs +16 -0
  524. package/foundation/integrations/autolink.d.mts +58 -1
  525. package/foundation/integrations/autolink.mjs +143 -45
  526. package/foundation/integrations/autolink.test.mjs +1 -1
  527. package/foundation/integrations/cli-requirement.d.mts +45 -0
  528. package/foundation/integrations/cli-requirement.mjs +154 -0
  529. package/foundation/integrations/cli-requirement.test.mjs +109 -0
  530. package/foundation/integrations/contribution-fixes.d.mts +145 -0
  531. package/foundation/integrations/contribution-fixes.mjs +1284 -0
  532. package/foundation/integrations/contribution-inventory.d.mts +3 -2
  533. package/foundation/integrations/contribution-inventory.mjs +27 -24
  534. package/foundation/integrations/contribution-inventory.test.mjs +86 -27
  535. package/foundation/integrations/integration-warnings.d.mts +9 -2
  536. package/foundation/integrations/integration-warnings.mjs +52 -21
  537. package/foundation/integrations/integration-warnings.test.mjs +74 -1
  538. package/foundation/integrations/integrations.d.mts +49 -2
  539. package/foundation/integrations/integrations.mjs +81 -8
  540. package/foundation/integrations/integrations.test.mjs +384 -1
  541. package/foundation/integrations/provider-conflicts.test.mjs +125 -0
  542. package/foundation/integrations/provider-ledger.test.mjs +275 -0
  543. package/foundation/integrations/provider-resolution.d.mts +152 -0
  544. package/foundation/integrations/provider-resolution.mjs +576 -0
  545. package/foundation/integrations/provider-resolution.test.mjs +369 -0
  546. package/foundation/integrations/theme-descriptor.d.mts +8 -0
  547. package/foundation/integrations/theme-descriptor.mjs +44 -0
  548. package/foundation/integrations/validate-contributions.d.mts +2 -0
  549. package/foundation/integrations/validate-contributions.mjs +131 -29
  550. package/foundation/response/base.d.ts +8 -4
  551. package/foundation/response/error-codes.d.mts +3 -1
  552. package/foundation/response/error-codes.d.ts +2 -0
  553. package/foundation/response/error-codes.doc.mjs +13 -4
  554. package/foundation/response/error-codes.mjs +8 -2
  555. package/foundation/response/error-codes.test.mjs +137 -10
  556. package/foundation/response/json-contract.test.mjs +57 -17
  557. package/foundation/response/json.d.mts +4 -2
  558. package/foundation/response/json.mjs +8 -10
  559. package/foundation/response/response-types.doc.mjs +26 -16
  560. package/foundation/response/response-types.doc.test.mjs +158 -0
  561. package/foundation/response/response.doc.mjs +1 -1
  562. package/foundation/text/string-utils.mjs +22 -10
  563. package/foundation/xle/expand.d.mts +2 -0
  564. package/foundation/xle/expand.mjs +4 -3
  565. package/foundation/xle/expand.test.mjs +54 -0
  566. package/foundation/xle/xle.test.mjs +13 -0
  567. package/package.json +10 -11
  568. package/assets/templates/themes/manifest.json +0 -95
  569. package/clients/cli/lib/update-check.mjs +0 -83
  570. package/clients/cli/lib/update-check.test.mjs +0 -137
  571. package/clients/cli/update-hint-commands.test.mjs +0 -54
@@ -15,7 +15,7 @@
15
15
  */
16
16
  /**
17
17
  * Compute the files the tarball must contain for an integration's
18
- * contributions to be visible. Reads catalogs and walks directories;
18
+ * contributions to be visible. Walks descriptor-owned directories;
19
19
  * never imports or executes authored modules.
20
20
  *
21
21
  * @param {import('./integrations.mjs').LoadedIntegration} loaded
@@ -26,7 +26,7 @@ export function computeRequiredFiles(loaded: import("./integrations.mjs").Loaded
26
26
  * @typedef {object} ContributionIdentities
27
27
  * @property {{slug: string, exportName: string}[]} themes
28
28
  * @property {string[]} components
29
- * @property {{id: string, type: string, name: string}[]} templates
29
+ * @property {{id: string, type: string, name: string, replaces?: string}[]} templates
30
30
  * @property {{version: string, id: string}[]} codemods
31
31
  * @property {string[]} docs
32
32
  * @property {string[]} agentDocsAppend
@@ -127,6 +127,7 @@ export type ContributionIdentities = {
127
127
  id: string;
128
128
  type: string;
129
129
  name: string;
130
+ replaces?: string;
130
131
  }[];
131
132
  codemods: {
132
133
  version: string;
@@ -14,8 +14,11 @@
14
14
  import * as fs from 'node:fs';
15
15
  import * as path from 'node:path';
16
16
  import {isDeepStrictEqual} from 'node:util';
17
- import {THEME_MANIFEST_BASENAME} from '../discovery/theme-discovery.mjs';
18
- import {discoverIntegrationThemes} from '../discovery/theme-discovery.mjs';
17
+ import {
18
+ discoverIntegrationThemes,
19
+ isThemeFolder,
20
+ listThemeFiles,
21
+ } from '../discovery/theme-discovery.mjs';
19
22
  import {discoverIntegrationComponents} from '../discovery/component-discovery.mjs';
20
23
  import {loadComponentDoc} from '../discovery/component-loader.mjs';
21
24
  import {discoverIntegrationTemplatesForOne} from '../discovery/template-adapter.mjs';
@@ -65,27 +68,21 @@ function rel(packageDir, file) {
65
68
 
66
69
  /** @param {string} root @param {string} pkgDir */
67
70
  function enumerateThemeFiles(root, pkgDir) {
71
+ if (!root || !fs.existsSync(root) || !fs.statSync(root).isDirectory()) {
72
+ return [];
73
+ }
74
+ // Exactly what `theme add` copies: each theme folder's files, including
75
+ // tests and fixtures, but no dot entry or file npm never publishes. Files
76
+ // beside the theme folders belong to no theme.
68
77
  /** @type {string[]} */
69
78
  const files = [];
70
- const catalog = path.join(root, THEME_MANIFEST_BASENAME);
71
- if (!fs.existsSync(catalog)) return files;
72
- files.push(rel(pkgDir, catalog));
73
- try {
74
- const data = JSON.parse(fs.readFileSync(catalog, 'utf-8'));
75
- if (data?.version !== 1 || !Array.isArray(data.themes)) return files;
76
- for (const theme of data.themes) {
77
- if (typeof theme.slug !== 'string' || !Array.isArray(theme.files))
78
- continue;
79
- for (const f of theme.files) {
80
- if (typeof f === 'string') {
81
- files.push(rel(pkgDir, path.join(root, theme.slug, f)));
82
- }
83
- }
79
+ for (const entry of fs.readdirSync(root, {withFileTypes: true})) {
80
+ const full = path.join(root, entry.name);
81
+ if (entry.isDirectory() && isThemeFolder(full)) {
82
+ files.push(...listThemeFiles(full).map(file => path.join(full, file)));
84
83
  }
85
- } catch {
86
- /* Phase 1 catches structural issues */
87
84
  }
88
- return files;
85
+ return files.sort().map(file => rel(pkgDir, file));
89
86
  }
90
87
 
91
88
  /** @param {string} root @param {string} pkgDir */
@@ -158,7 +155,7 @@ const ROOT_KINDS = /** @type {const} */ ([
158
155
 
159
156
  /**
160
157
  * Compute the files the tarball must contain for an integration's
161
- * contributions to be visible. Reads catalogs and walks directories;
158
+ * contributions to be visible. Walks descriptor-owned directories;
162
159
  * never imports or executes authored modules.
163
160
  *
164
161
  * @param {import('./integrations.mjs').LoadedIntegration} loaded
@@ -192,7 +189,7 @@ export function computeRequiredFiles(loaded) {
192
189
  * @typedef {object} ContributionIdentities
193
190
  * @property {{slug: string, exportName: string}[]} themes
194
191
  * @property {string[]} components
195
- * @property {{id: string, type: string, name: string}[]} templates
192
+ * @property {{id: string, type: string, name: string, replaces?: string}[]} templates
196
193
  * @property {{version: string, id: string}[]} codemods
197
194
  * @property {string[]} docs
198
195
  * @property {string[]} agentDocsAppend
@@ -281,7 +278,12 @@ export async function collectIdentities(loaded) {
281
278
  errors.push({kind: 'templates', message: templateError.message});
282
279
  }
283
280
  identities.templates = templates
284
- .map(t => ({id: t.dirName, type: t.type, name: t.name}))
281
+ .map(t => ({
282
+ id: t.dirName,
283
+ type: t.type,
284
+ name: t.name,
285
+ ...(t.replaces == null ? {} : {replaces: t.replaces}),
286
+ }))
285
287
  .sort((a, b) => a.id.localeCompare(b.id));
286
288
  } catch (err) {
287
289
  errors.push({
@@ -312,12 +314,13 @@ export async function collectIdentities(loaded) {
312
314
 
313
315
  if (loaded.docs && fs.existsSync(loaded.docs)) {
314
316
  try {
315
- const {records, errors: docErrors} =
317
+ const {records, guides, errors: docErrors} =
316
318
  await discoverIntegrationDocs(loaded);
317
319
  for (const docError of docErrors) {
318
320
  errors.push({kind: 'docs', message: docError.message});
319
321
  }
320
- identities.docs = records.map(r => r.name).sort();
322
+ // A guide placed in the docs tree is a doc contribution too.
323
+ identities.docs = [...records, ...guides].map(r => r.name).sort();
321
324
  } catch (err) {
322
325
  errors.push({kind: 'docs', message: /** @type {Error} */ (err).message});
323
326
  }
@@ -37,30 +37,37 @@ function loaded(overrides = {}) {
37
37
 
38
38
  function writeTheme(slug, files = [`${slug}Theme.ts`]) {
39
39
  const root = path.join(tmpDir, 'themes');
40
- fs.mkdirSync(path.join(root, slug), {recursive: true});
41
- for (const f of files) {
42
- fs.writeFileSync(path.join(root, slug, f), `// ${f}\n`);
40
+ const themeDir = path.join(root, slug);
41
+ fs.mkdirSync(themeDir, {recursive: true});
42
+ for (const file of files) {
43
+ const target = path.join(themeDir, file);
44
+ fs.mkdirSync(path.dirname(target), {recursive: true});
45
+ fs.writeFileSync(target, `// ${file}\n`);
43
46
  }
44
- const catalogPath = path.join(root, 'manifest.json');
45
- let catalog = {version: 1, themes: []};
46
- if (fs.existsSync(catalogPath)) {
47
- catalog = JSON.parse(fs.readFileSync(catalogPath, 'utf-8'));
48
- }
49
- catalog.themes.push({
50
- slug,
51
- displayName: slug,
52
- description: `${slug} theme.`,
53
- maintained: true,
54
- entry: files[0],
55
- exportName: `${slug}Theme`,
56
- files,
57
- });
58
- fs.writeFileSync(catalogPath, JSON.stringify(catalog, null, 2) + '\n');
47
+ fs.writeFileSync(
48
+ path.join(themeDir, `${slug}Theme.doc.mjs`),
49
+ `/** @type {import('@astryxdesign/cli/authoring').ThemeDoc} */\nexport default {type: 'theme', name: '${slug}', displayName: '${slug}', description: '${slug} theme.', maintained: true};\n`,
50
+ );
59
51
  return root;
60
52
  }
61
53
 
54
+ const UNPUBLISHED = [
55
+ '.DS_Store',
56
+ '._oceanTheme.ts',
57
+ '.gitignore',
58
+ '.npmignore',
59
+ '.npmrc',
60
+ 'oceanTheme.ts.orig',
61
+ 'npm-debug.log',
62
+ 'palette/.DS_Store',
63
+ 'palette/npm-debug.log',
64
+ '.git/HEAD',
65
+ 'CVS/Entries',
66
+ 'node_modules/dep/index.js',
67
+ ];
68
+
62
69
  describe('computeRequiredFiles', () => {
63
- it('enumerates manifest + theme catalog files', () => {
70
+ it('enumerates each complete descriptor-owned theme directory', () => {
64
71
  const root = writeTheme('ocean', ['oceanTheme.ts', 'tokens.ts']);
65
72
  const inv = computeRequiredFiles(loaded({themes: root}));
66
73
 
@@ -69,13 +76,46 @@ describe('computeRequiredFiles', () => {
69
76
  expect(inv.roots[0].kind).toBe('themes');
70
77
  expect(inv.roots[0].files).toEqual(
71
78
  expect.arrayContaining([
72
- 'themes/manifest.json',
79
+ 'themes/ocean/oceanTheme.doc.mjs',
73
80
  'themes/ocean/oceanTheme.ts',
74
81
  'themes/ocean/tokens.ts',
75
82
  ]),
76
83
  );
77
84
  expect(inv.allFiles).toContain('astryx.integration.mjs');
78
- expect(inv.allFiles).toContain('themes/manifest.json');
85
+ expect(inv.allFiles).toContain('themes/ocean/oceanTheme.doc.mjs');
86
+ expect(inv.allFiles).not.toContain('themes/manifest.json');
87
+ });
88
+
89
+ it('requires no file npm leaves out, at any depth, and none beside the themes', () => {
90
+ const root = writeTheme('ocean', ['oceanTheme.ts', 'palette/tokens.ts']);
91
+ for (const file of [
92
+ ...UNPUBLISHED.map(name => `ocean/${name}`),
93
+ 'README.md',
94
+ 'npm-debug.log',
95
+ ]) {
96
+ fs.mkdirSync(path.dirname(path.join(root, file)), {recursive: true});
97
+ fs.writeFileSync(path.join(root, file), 'x\n');
98
+ }
99
+ expect(computeRequiredFiles(loaded({themes: root})).roots[0].files).toEqual(
100
+ [
101
+ 'themes/ocean/oceanTheme.doc.mjs',
102
+ 'themes/ocean/oceanTheme.ts',
103
+ 'themes/ocean/palette/tokens.ts',
104
+ ],
105
+ );
106
+ });
107
+
108
+ it('requires only the folders theme discovery reads', () => {
109
+ const root = writeTheme('ocean');
110
+ for (const file of ['shared/palette.ts', '.cache/state.json']) {
111
+ fs.mkdirSync(path.dirname(path.join(root, file)), {recursive: true});
112
+ fs.writeFileSync(path.join(root, file), '{}\n');
113
+ }
114
+ const inv = computeRequiredFiles(loaded({themes: root}));
115
+ expect(inv.roots[0].files).toEqual([
116
+ 'themes/ocean/oceanTheme.doc.mjs',
117
+ 'themes/ocean/oceanTheme.ts',
118
+ ]);
79
119
  });
80
120
 
81
121
  it('enumerates paired component metadata and source files', () => {
@@ -139,31 +179,31 @@ describe('computeRequiredFiles', () => {
139
179
  const root = path.join(tmpDir, 'templates');
140
180
  fs.mkdirSync(path.join(root, 'dashboard'), {recursive: true});
141
181
  fs.writeFileSync(
142
- path.join(root, 'dashboard', 'dashboard.template.mjs'),
182
+ path.join(root, 'dashboard', 'dashboard.doc.mjs'),
143
183
  '// tmpl\n',
144
184
  );
145
185
  fs.writeFileSync(path.join(root, 'dashboard', 'dashboard.tsx'), '// src\n');
146
186
  const inv = computeRequiredFiles(loaded({templates: root}));
147
187
 
148
188
  expect(inv.roots[0].files).toContain(
149
- 'templates/dashboard/dashboard.template.mjs',
189
+ 'templates/dashboard/dashboard.doc.mjs',
150
190
  );
151
191
  expect(inv.roots[0].files).toContain('templates/dashboard/dashboard.tsx');
152
192
  });
153
193
 
154
- it('enumerates legacy .doc template metadata with paired sources', () => {
194
+ it('enumerates released .template compatibility metadata with paired sources', () => {
155
195
  const root = path.join(tmpDir, 'templates');
156
196
  fs.mkdirSync(path.join(root, 'dashboard'), {recursive: true});
157
197
  fs.writeFileSync(
158
- path.join(root, 'dashboard', 'dashboard.doc.mjs'),
159
- '// legacy template\n',
198
+ path.join(root, 'dashboard', 'dashboard.template.mjs'),
199
+ '// released compatibility template\n',
160
200
  );
161
201
  fs.writeFileSync(path.join(root, 'dashboard', 'dashboard.tsx'), '// src\n');
162
202
 
163
203
  const inv = computeRequiredFiles(loaded({templates: root}));
164
204
 
165
205
  expect(inv.roots[0].files).toEqual([
166
- 'templates/dashboard/dashboard.doc.mjs',
206
+ 'templates/dashboard/dashboard.template.mjs',
167
207
  'templates/dashboard/dashboard.tsx',
168
208
  ]);
169
209
  });
@@ -264,6 +304,25 @@ describe('compareIdentities', () => {
264
304
  expect(issues[0].message).toContain('dash');
265
305
  });
266
306
 
307
+ it('errors when a packed template replaces a different target', () => {
308
+ const template = {id: 'acme-shell', type: 'page', name: 'Acme shell'};
309
+ const local = {
310
+ ...base(),
311
+ templates: [{...template, replaces: 'shell-side-nav'}],
312
+ };
313
+ const packed = {
314
+ ...base(),
315
+ templates: [{...template, replaces: 'shell-top-nav'}],
316
+ };
317
+
318
+ expect(compareIdentities(local, packed)).toEqual([
319
+ expect.objectContaining({
320
+ code: 'identity_mismatch',
321
+ message: expect.stringContaining('acme-shell'),
322
+ }),
323
+ ]);
324
+ });
325
+
267
326
  it('errors when a codemod is missing from packed', () => {
268
327
  const local = {
269
328
  ...base(),
@@ -8,10 +8,17 @@
8
8
  *
9
9
  * Warning: <pkg> has N integration issue(s). Run: astryx doctor integration validate <pkg>
10
10
  *
11
- * @param {Array<import('./integrations.mjs').LoadedIntegration>} loadedIntegrations the Project's loaded integrations
11
+ * @param {Array<import('./integrations.mjs').LoadedIntegration> | {issues: () => Promise<Array<{package: string, code: string, severity: string, message: string}>>}} source loaded integrations or their Project owner
12
12
  * @param {{json?: boolean}} [options]
13
13
  * @returns {Promise<void>}
14
14
  */
15
- export function warnOnIntegrationIssues(loadedIntegrations: Array<import("./integrations.mjs").LoadedIntegration>, { json }?: {
15
+ export function warnOnIntegrationIssues(source: Array<import("./integrations.mjs").LoadedIntegration> | {
16
+ issues: () => Promise<Array<{
17
+ package: string;
18
+ code: string;
19
+ severity: string;
20
+ message: string;
21
+ }>>;
22
+ }, { json }?: {
16
23
  json?: boolean;
17
24
  }): Promise<void>;
@@ -10,8 +10,9 @@
10
10
  * contributions or spamming per-contribution diagnostics.
11
11
  *
12
12
  * Design constraints (all enforced here):
13
- * - Reuses the Doctor integration validators (validateLoadedIntegration);
14
- * no validation logic is duplicated.
13
+ * - Reuses Project.issues() when a Project is available, so cross-package
14
+ * replacement warnings are visible; accepts loaded integrations for legacy
15
+ * internal callers and tests.
15
16
  * - Writes to STDERR only, so it never corrupts a --json stdout envelope.
16
17
  * - Suppressed entirely in --json mode.
17
18
  * - Best-effort: never throws, never changes the exit code. Broken
@@ -28,32 +29,62 @@ import {validateLoadedIntegration} from './validate-contributions.mjs';
28
29
  *
29
30
  * Warning: <pkg> has N integration issue(s). Run: astryx doctor integration validate <pkg>
30
31
  *
31
- * @param {Array<import('./integrations.mjs').LoadedIntegration>} loadedIntegrations the Project's loaded integrations
32
+ * @param {Array<import('./integrations.mjs').LoadedIntegration> | {issues: () => Promise<Array<{package: string, code: string, severity: string, message: string}>>}} source loaded integrations or their Project owner
32
33
  * @param {{json?: boolean}} [options]
33
34
  * @returns {Promise<void>}
34
35
  */
35
- export async function warnOnIntegrationIssues(loadedIntegrations, {json = false} = {}) {
36
+ export async function warnOnIntegrationIssues(source, {json = false} = {}) {
36
37
  try {
37
- // Cheap guard: only do work when integrations are actually configured.
38
38
  if (json) return;
39
- if (!Array.isArray(loadedIntegrations) || loadedIntegrations.length === 0) {
40
- return;
41
- }
42
- for (const integration of loadedIntegrations) {
43
- if (!integration || typeof integration !== 'object') continue;
44
- let issues;
45
- try {
46
- issues = await validateLoadedIntegration(integration);
47
- } catch {
48
- // Best-effort: a validator throwing must not break the host command.
49
- continue;
39
+
40
+ /** @type {Map<string, number>} */
41
+ const issueCounts = new Map();
42
+ const fromProject =
43
+ source != null &&
44
+ !Array.isArray(source) &&
45
+ typeof source.issues === 'function';
46
+
47
+ if (fromProject) {
48
+ const issues = await source.issues();
49
+ for (const issue of issues) {
50
+ // A provider-conflict issue carries the specific message that
51
+ // `doctor integration validate` would not explain. Print it directly.
52
+ if (issue.code === 'duplicate_provider') {
53
+ console.error(`Warning: ${issue.message}`);
54
+ continue;
55
+ }
56
+ issueCounts.set(
57
+ issue.package,
58
+ (issueCounts.get(issue.package) ?? 0) + 1,
59
+ );
50
60
  }
51
- if (!Array.isArray(issues) || issues.length === 0) continue;
52
- const pkg = integration.name ?? integration.__spec ?? '(integration)';
53
- // Stderr only — keeps stdout (and any --json envelope) clean.
61
+ } else if (Array.isArray(source)) {
62
+ for (const integration of source) {
63
+ if (!integration || typeof integration !== 'object') continue;
64
+ // A package set aside for a provider-ID conflict is fine in isolation,
65
+ // so `doctor integration validate` would not explain it. Say it here.
66
+ if (integration.__providerConflict) {
67
+ console.error(`Warning: ${integration.__providerConflict.message}`);
68
+ continue;
69
+ }
70
+ let issues;
71
+ try {
72
+ issues = await validateLoadedIntegration(integration);
73
+ } catch {
74
+ continue;
75
+ }
76
+ if (!Array.isArray(issues) || issues.length === 0) continue;
77
+ const pkg = integration.name ?? integration.__spec ?? '(integration)';
78
+ issueCounts.set(pkg, issues.length);
79
+ }
80
+ }
81
+
82
+ for (const [pkg, count] of issueCounts) {
83
+ const command = fromProject
84
+ ? 'astryx doctor'
85
+ : `astryx doctor integration validate ${pkg}`;
54
86
  console.error(
55
- `Warning: ${pkg} has ${issues.length} integration issue(s). ` +
56
- `Run: astryx doctor integration validate ${pkg}`,
87
+ `Warning: ${pkg} has ${count} integration issue(s). Run: ${command}`,
57
88
  );
58
89
  }
59
90
  } catch {
@@ -37,7 +37,12 @@ afterEach(() => {
37
37
  * Build a loaded-integration-shaped object. Roots are absolute (mirrors
38
38
  * loadIntegrations' resolveRoot).
39
39
  */
40
- function loaded({name = '@acme/widgets', components, templates, codemods} = {}) {
40
+ function loaded({
41
+ name = '@acme/widgets',
42
+ components,
43
+ templates,
44
+ codemods,
45
+ } = {}) {
41
46
  return {
42
47
  name,
43
48
  version: '1.0.0',
@@ -62,6 +67,25 @@ describe('warnOnIntegrationIssues', () => {
62
67
  );
63
68
  });
64
69
 
70
+ it('surfaces cross-package issues collected by Project', async () => {
71
+ const project = {
72
+ issues: async () => [
73
+ {
74
+ package: '@acme/later',
75
+ code: 'ambiguous_template_replacement',
76
+ severity: 'warning',
77
+ message: 'Later configured replacement wins.',
78
+ },
79
+ ],
80
+ };
81
+
82
+ await warnOnIntegrationIssues(project, {json: false});
83
+
84
+ expect(errLines).toEqual([
85
+ 'Warning: @acme/later has 1 integration issue(s). Run: astryx doctor',
86
+ ]);
87
+ });
88
+
65
89
  it('emits nothing in --json mode (keeps stdout/JSON clean)', async () => {
66
90
  const integration = loaded({components: 'does-not-exist'});
67
91
  await warnOnIntegrationIssues([integration], {json: true});
@@ -116,4 +140,53 @@ describe('warnOnIntegrationIssues', () => {
116
140
  ).resolves.toBeUndefined();
117
141
  expect(errLines).toHaveLength(0);
118
142
  });
143
+
144
+ it('prints the specific provider-conflict message via the array path', async () => {
145
+ const conflict = {
146
+ name: '@acme/charts',
147
+ version: '2.0.0',
148
+ __spec: '@acme/charts',
149
+ __packageDir: tmpDir,
150
+ __providerConflict: {
151
+ providerId: '@acme/lab',
152
+ claimedBy: '@acme/lab',
153
+ message:
154
+ '@acme/charts@2.0.0 and @acme/lab@1.0.0 both claim provider ID ' +
155
+ '"@acme/lab". @acme/lab@1.0.0 loads first and is used; ' +
156
+ '@acme/charts@2.0.0 contributes nothing until one package changes ' +
157
+ 'its providerId.',
158
+ },
159
+ };
160
+ await warnOnIntegrationIssues([conflict], {json: false});
161
+
162
+ expect(errLines).toHaveLength(1);
163
+ expect(errLines[0]).toBe(`Warning: ${conflict.__providerConflict.message}`);
164
+ // Must NOT print the generic validate pointer for a provider conflict.
165
+ expect(errLines[0]).not.toContain('integration issue(s)');
166
+ });
167
+
168
+ it('prints the specific provider-conflict message via the Project path', async () => {
169
+ const conflictMessage =
170
+ '@acme/charts@2.0.0 and @acme/lab@1.0.0 both claim provider ID ' +
171
+ '"@acme/lab". @acme/lab@1.0.0 loads first and is used; ' +
172
+ '@acme/charts@2.0.0 contributes nothing until one package changes ' +
173
+ 'its providerId.';
174
+ const project = {
175
+ issues: async () => [
176
+ {
177
+ package: '@acme/charts@2.0.0',
178
+ code: 'duplicate_provider',
179
+ severity: 'warning',
180
+ message: conflictMessage,
181
+ },
182
+ ],
183
+ };
184
+
185
+ await warnOnIntegrationIssues(project, {json: false});
186
+
187
+ expect(errLines).toHaveLength(1);
188
+ expect(errLines[0]).toBe(`Warning: ${conflictMessage}`);
189
+ // Must NOT print the generic validate pointer for a provider conflict.
190
+ expect(errLines[0]).not.toContain('integration issue(s)');
191
+ });
119
192
  });
@@ -1,6 +1,26 @@
1
1
  // @generated by scripts/sync-api-types.mjs from the JSDoc in foundation/**/*.mjs.
2
2
  // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
3
3
 
4
+ /**
5
+ * Resolve provider identity across loaded integrations, in precedence order.
6
+ *
7
+ * Artifact and document IDs are provider-scoped, so two packages cannot both
8
+ * contribute under one provider ID. The same package reached twice (an npm
9
+ * alias beside the package it aliases, with the same name and version) loads
10
+ * once. Any other later claimant, including the same package at another
11
+ * version, stays as an inert entry that carries the conflict. The package being
12
+ * authored claims its ID before precedence order is considered, because the
13
+ * source being edited is authoritative. The winner still contributes; Project
14
+ * issues, Doctor, and the per-command warning name the one set aside instead of
15
+ * dropping it without a word.
16
+ *
17
+ * The conflict pass of {@link resolveProviders}, for a list that is already
18
+ * assembled.
19
+ *
20
+ * @param {LoadedIntegration[]} integrations in precedence order
21
+ * @returns {LoadedIntegration[]}
22
+ */
23
+ export function markProviderConflicts(integrations: LoadedIntegration[]): LoadedIntegration[];
4
24
  /**
5
25
  * Return the conventional root manifest paths present in `dir`, in
6
26
  * load-precedence order. Unlike {@link resolveManifestPath} this never throws —
@@ -75,12 +95,15 @@ export function loadLocalIntegration(packageDir: string, { fresh }?: {
75
95
  * Load configured integrations.
76
96
  *
77
97
  * @param {string[]} [specs] package names
78
- * @param {{cwd?: string, fresh?: boolean}} [options]
98
+ * @param {{cwd?: string, fresh?: boolean, resolveProviders?: boolean}} [options]
99
+ * `resolveProviders: false` leaves provider identity to a caller that
100
+ * resolves it once over a larger set (Project.load)
79
101
  * @returns {Promise<LoadedIntegration[]>}
80
102
  */
81
- export function loadIntegrations(specs?: string[], { cwd, fresh }?: {
103
+ export function loadIntegrations(specs?: string[], { cwd, fresh, resolveProviders }?: {
82
104
  cwd?: string;
83
105
  fresh?: boolean;
106
+ resolveProviders?: boolean;
84
107
  }): Promise<LoadedIntegration[]>;
85
108
  /**
86
109
  * A fully-resolved, loaded integration. Identity (`name`, `version`) comes from
@@ -89,6 +112,10 @@ export function loadIntegrations(specs?: string[], { cwd, fresh }?: {
89
112
  * are internal bookkeeping used by Doctor integration validation and Project.
90
113
  * @typedef {object} LoadedIntegration
91
114
  * @property {string} name
115
+ * @property {import('../../authoring/identity/type').ProviderId} [providerId]
116
+ * normalized stable provider identity; absent only for a legacy unnamed local
117
+ * package. Unique among contributing integrations: a later claimant is kept
118
+ * inert with `__providerConflict` (see {@link markProviderConflicts})
92
119
  * @property {string} [version]
93
120
  * @property {string} [components]
94
121
  * @property {string} [templates]
@@ -107,6 +134,10 @@ export function loadIntegrations(specs?: string[], { cwd, fresh }?: {
107
134
  * @property {string} __manifestFile
108
135
  * @property {string} [__loadError] set when the manifest failed to load/validate;
109
136
  * such an integration contributes nothing and is surfaced via Project.issues()
137
+ * @property {{providerId: import('../../authoring/identity/type').ProviderId, claimedBy: string, message: string}} [__providerConflict]
138
+ * set on a package whose provider ID an earlier-loaded package already
139
+ * claims; it contributes nothing and is reported as a `duplicate_provider`
140
+ * warning
110
141
  * @property {string[]} [__unknownKeys] manifest keys this CLI does not know —
111
142
  * surfaced as a warning; the rest of the manifest still contributes
112
143
  * @property {boolean} [__autolinked] loaded because the project declares the
@@ -134,6 +165,12 @@ export const MANIFEST_BASENAMES: string[];
134
165
  */
135
166
  export type LoadedIntegration = {
136
167
  name: string;
168
+ /**
169
+ * normalized stable provider identity; absent only for a legacy unnamed local
170
+ * package. Unique among contributing integrations: a later claimant is kept
171
+ * inert with `__providerConflict` (see {@link markProviderConflicts})
172
+ */
173
+ providerId?: import("../../authoring/identity/type").ProviderId | undefined;
137
174
  version?: string | undefined;
138
175
  components?: string | undefined;
139
176
  templates?: string | undefined;
@@ -163,6 +200,16 @@ export type LoadedIntegration = {
163
200
  * such an integration contributes nothing and is surfaced via Project.issues()
164
201
  */
165
202
  __loadError?: string | undefined;
203
+ /**
204
+ * set on a package whose provider ID an earlier-loaded package already
205
+ * claims; it contributes nothing and is reported as a `duplicate_provider`
206
+ * warning
207
+ */
208
+ __providerConflict?: {
209
+ providerId: import("../../authoring/identity/type").ProviderId;
210
+ claimedBy: string;
211
+ message: string;
212
+ } | undefined;
166
213
  /**
167
214
  * manifest keys this CLI does not know —
168
215
  * surfaced as a warning; the rest of the manifest still contributes