@astryxdesign/cli 0.6.3-canary.d0d49a4 → 0.6.3-canary.db4e378

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 (206) hide show
  1. package/README.md +86 -72
  2. package/api/build/build.doc.mjs +3 -3
  3. package/api/build/build.test.mjs +14 -3
  4. package/api/build/build.type.d.mts +35 -1
  5. package/api/build/build.type.mjs +24 -3
  6. package/api/build/help/help.d.mts +8 -5
  7. package/api/build/help/help.mjs +56 -6
  8. package/api/component/component.doc.mjs +12 -3
  9. package/api/component/component.mjs +31 -2
  10. package/api/component/component.test.mjs +38 -0
  11. package/api/component/component.type.d.mts +16 -5
  12. package/api/component/component.type.mjs +13 -5
  13. package/api/component/detail/blocks/blocks.d.mts +2 -1
  14. package/api/component/detail/blocks/blocks.mjs +4 -3
  15. package/api/component/list/list.d.mts +0 -5
  16. package/api/component/list/list.mjs +37 -9
  17. package/api/discover/discover.doc.mjs +1 -1
  18. package/api/gap-report/gap-report.doc.mjs +7 -4
  19. package/api/init/init.doc.mjs +4 -0
  20. package/api/init/init.test.mjs +41 -1
  21. package/api/init/remove/remove.mjs +1 -1
  22. package/api/init/run/run.mjs +20 -10
  23. package/api/integration/add-contribution.component-names.test.mjs +120 -0
  24. package/api/integration/add-contribution.mjs +11 -0
  25. package/api/integration/add-contribution.test.mjs +80 -0
  26. package/api/integration/integrationAdd.doc.mjs +7 -4
  27. package/api/integration/integrationAddComponent.doc.mjs +1 -1
  28. package/api/integration/validate-integration.mjs +2 -0
  29. package/api/integration/validate-integration.test.mjs +91 -0
  30. package/api/integration/validateIntegration.doc.mjs +1 -1
  31. package/api/json/envelope-types.test.mjs +76 -0
  32. package/api/json/parseResponse.doc.mjs +2 -2
  33. package/api/layout/expand/expand.mjs +7 -5
  34. package/api/layout/expand/expand.path-safety.test.mjs +53 -0
  35. package/api/layout/grammar/grammar.mjs +2 -1
  36. package/api/layout/layoutExpand.doc.mjs +1 -1
  37. package/api/search/search-return-type.test.mjs +54 -0
  38. package/api/search/search.d.mts +2 -9
  39. package/api/search/search.doc.mjs +5 -1
  40. package/api/search/search.mjs +10 -3
  41. package/api/search/search.test.mjs +34 -0
  42. package/api/swizzle/copy/copy.mjs +28 -11
  43. package/api/swizzle/swizzle.doc.mjs +1 -1
  44. package/api/template/copy/copy.mjs +17 -23
  45. package/api/template/copy/copy.test.mjs +17 -0
  46. package/api/template/template.doc.mjs +2 -1
  47. package/api/theme/add/add.binary.test.mjs +91 -0
  48. package/api/theme/add/add.mjs +20 -3
  49. package/api/theme/add/add.staging.test.mjs +66 -0
  50. package/api/theme/build/build.mjs +114 -37
  51. package/api/theme/build/build.public-component-vars.test.mjs +1 -1
  52. package/api/theme/build/build.receipt-doc.test.mjs +111 -0
  53. package/api/theme/build/font-warning.mjs +3 -3
  54. package/api/theme/build/font-warning.test.mjs +5 -2
  55. package/api/theme/palette/generate/generate.mjs +7 -2
  56. package/api/theme/palette/generate/generate.test.mjs +96 -0
  57. package/api/theme/palette/generate/generator.mjs +8 -1
  58. package/api/theme/palette/generate/generator.test.mjs +10 -0
  59. package/api/theme/template/template.mjs +11 -2
  60. package/api/theme/template/template.test.mjs +15 -0
  61. package/api/theme/themeBuild.doc.mjs +7 -4
  62. package/api/theme/themeTemplate.doc.mjs +4 -1
  63. package/api/upgrade/_adapter.mjs +27 -4
  64. package/api/upgrade/list/list.mjs +2 -1
  65. package/api/upgrade/list/list.test.mjs +73 -0
  66. package/api/upgrade/status/status.mjs +2 -2
  67. package/api/upgrade/upgrade.doc.mjs +2 -1
  68. package/api/upgrade/upgrade.type.d.mts +4 -0
  69. package/api/upgrade/upgrade.type.mjs +1 -0
  70. package/assets/codemods/term-log.mjs +32 -8
  71. package/assets/codemods/term-log.test.mjs +19 -1
  72. package/assets/codemods/transform-prop.mjs +109 -0
  73. package/assets/codemods/transform-prop.test.mjs +95 -0
  74. package/assets/codemods/transforms/v0.0.14/__tests__/rename-status-variants.test.mjs +86 -165
  75. package/assets/codemods/transforms/v0.0.14/rename-status-variants.mjs +72 -210
  76. package/assets/codemods/transforms/v0.1.8/__tests__/rename-avatar-size-scale.test.mjs +83 -115
  77. package/assets/codemods/transforms/v0.1.8/rename-avatar-size-scale.mjs +57 -186
  78. package/assets/codemods/transforms/v0.6.0/__tests__/next-codemods.test.mjs +47 -0
  79. package/assets/codemods/transforms/v0.6.0/rename-resizable-pixel-bounds.mjs +57 -10
  80. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaInlineRail.doc.mjs +14 -0
  81. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaInlineRail.tsx +61 -0
  82. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaOverscrollChaining.doc.mjs +14 -0
  83. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaOverscrollChaining.tsx +126 -0
  84. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaShowcase.doc.mjs +15 -0
  85. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaShowcase.tsx +86 -0
  86. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyGroupHeaders.doc.mjs +14 -0
  87. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyGroupHeaders.tsx +99 -0
  88. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.doc.mjs +14 -0
  89. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.tsx +122 -0
  90. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.doc.mjs +14 -0
  91. package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.tsx +95 -0
  92. package/assets/templates/pages/table-tree/page.tsx +1704 -0
  93. package/assets/templates/pages/table-tree/template.doc.mjs +12 -0
  94. package/authoring/config/config.doc.mjs +1 -1
  95. package/authoring/config/debug-composition.test.mjs +92 -0
  96. package/authoring/config/type.ts +15 -3
  97. package/clients/cli/command-load-failure.test.mjs +83 -0
  98. package/clients/cli/commands/blog.mjs +23 -8
  99. package/clients/cli/commands/blog.test.mjs +42 -1
  100. package/clients/cli/commands/build-theme.ascii-output.test.mjs +161 -0
  101. package/clients/cli/commands/build-theme.flag-docs.test.mjs +110 -0
  102. package/clients/cli/commands/build-theme.mjs +5 -5
  103. package/clients/cli/commands/build-theme.path-safety.test.mjs +86 -1
  104. package/clients/cli/commands/build-theme.variants.test.mjs +76 -0
  105. package/clients/cli/commands/build.doc.mjs +4 -1
  106. package/clients/cli/commands/build.exit-codes-doc.test.mjs +50 -0
  107. package/clients/cli/commands/build.mjs +32 -47
  108. package/clients/cli/commands/build.playbook.test.mjs +75 -0
  109. package/clients/cli/commands/build.text-fields.test.mjs +40 -0
  110. package/clients/cli/commands/component/index.mjs +2 -7
  111. package/clients/cli/commands/component-package.test.mjs +46 -0
  112. package/clients/cli/commands/component-resolution.test.mjs +21 -0
  113. package/clients/cli/commands/component.test.mjs +19 -0
  114. package/clients/cli/commands/detail-levels.test.mjs +2 -2
  115. package/clients/cli/commands/discover.broken-integration.test.mjs +48 -0
  116. package/clients/cli/commands/discover.components-flag.test.mjs +97 -0
  117. package/clients/cli/commands/discover.doc.mjs +4 -2
  118. package/clients/cli/commands/discover.mjs +3 -3
  119. package/clients/cli/commands/discover.text-projection.test.mjs +103 -0
  120. package/clients/cli/commands/doctor-integration.package-json.test.mjs +53 -0
  121. package/clients/cli/commands/doctor.mjs +6 -16
  122. package/clients/cli/commands/doctor.test.mjs +42 -0
  123. package/clients/cli/commands/gap-report.doc.mjs +16 -5
  124. package/clients/cli/commands/gap-report.test.mjs +72 -0
  125. package/clients/cli/commands/hook/index.mjs +7 -17
  126. package/clients/cli/commands/hook.text-projection.test.mjs +45 -0
  127. package/clients/cli/commands/init.doc.mjs +19 -8
  128. package/clients/cli/commands/init.flag-help.test.mjs +153 -0
  129. package/clients/cli/commands/integration-add.controls.test.mjs +132 -0
  130. package/clients/cli/commands/integration-add.doc.mjs +21 -5
  131. package/clients/cli/commands/interactive-guard.test.mjs +101 -24
  132. package/clients/cli/commands/json-contract.test.mjs +33 -0
  133. package/clients/cli/commands/layout-check.doc.mjs +14 -3
  134. package/clients/cli/commands/layout-expand.doc.mjs +21 -4
  135. package/clients/cli/commands/layout.doc.mjs +2 -2
  136. package/clients/cli/commands/layout.mjs +21 -9
  137. package/clients/cli/commands/layout.path-help.test.mjs +33 -0
  138. package/clients/cli/commands/layout.stdin-cap.test.mjs +47 -0
  139. package/clients/cli/commands/layout.text-fields.test.mjs +39 -0
  140. package/clients/cli/commands/no-prompt-wording.test.mjs +94 -0
  141. package/clients/cli/commands/search.doc.mjs +6 -3
  142. package/clients/cli/commands/search.mjs +17 -7
  143. package/clients/cli/commands/search.test.mjs +75 -0
  144. package/clients/cli/commands/swizzle.doc.mjs +2 -1
  145. package/clients/cli/commands/swizzle.path-safety.test.mjs +42 -0
  146. package/clients/cli/commands/template.doc.mjs +28 -6
  147. package/clients/cli/commands/template.flag-help.test.mjs +117 -0
  148. package/clients/cli/commands/template.path-help.test.mjs +40 -0
  149. package/clients/cli/commands/theme-add.doc.mjs +2 -1
  150. package/clients/cli/commands/theme-build.doc.mjs +7 -6
  151. package/clients/cli/commands/theme-palette-generate.test.mjs +19 -0
  152. package/clients/cli/commands/theme-template.behavior.test.mjs +12 -0
  153. package/clients/cli/commands/theme-template.doc.mjs +1 -1
  154. package/clients/cli/commands/upgrade.ascii-output.test.mjs +87 -0
  155. package/clients/cli/commands/upgrade.doc.mjs +17 -6
  156. package/clients/cli/commands/upgrade.flag-help.test.mjs +188 -0
  157. package/clients/cli/commands/upgrade.hook-output.test.mjs +88 -0
  158. package/clients/cli/index.mjs +13 -30
  159. package/clients/cli/latest-version-env.test.mjs +50 -0
  160. package/clients/cli/lib/cli-error.test.mjs +7 -0
  161. package/clients/cli/lib/component-format.mjs +9 -9
  162. package/clients/cli/lib/component-format.test.mjs +1 -1
  163. package/clients/cli/lib/define-command.mjs +32 -6
  164. package/clients/cli/lib/doc-text-ascii.test.mjs +82 -0
  165. package/clients/cli/lib/exit-codes.test.mjs +97 -0
  166. package/clients/cli/lib/hook-format.mjs +5 -5
  167. package/clients/cli/lib/json-shim.mjs +38 -2
  168. package/clients/cli/lib/json-shim.test.mjs +83 -0
  169. package/clients/cli/lib/manifest.d.ts +2 -0
  170. package/clients/cli/lib/manifest.mjs +22 -0
  171. package/clients/cli/lib/manifest.test.mjs +17 -0
  172. package/foundation/agent-docs/agent-docs.d.mts +4 -0
  173. package/foundation/agent-docs/agent-docs.mjs +69 -3
  174. package/foundation/agent-docs/agent-docs.path-safety.test.mjs +266 -4
  175. package/foundation/config/integration-debug.test.mjs +28 -3
  176. package/foundation/config/project.mjs +123 -9
  177. package/foundation/config/project.test.mjs +126 -0
  178. package/foundation/discovery/template-adapter.d.mts +14 -5
  179. package/foundation/discovery/template-adapter.fixture-refs.test.mjs +248 -0
  180. package/foundation/discovery/template-adapter.integration-isolation.test.mjs +94 -0
  181. package/foundation/discovery/template-adapter.mjs +292 -25
  182. package/foundation/discovery/theming-targets.test.mjs +4 -0
  183. package/foundation/fs/module-loader.d.mts +1 -0
  184. package/foundation/fs/module-loader.mjs +50 -1
  185. package/foundation/fs/module-loader.stdout.test.mjs +332 -0
  186. package/foundation/fs/path-safety.d.mts +3 -2
  187. package/foundation/fs/path-safety.mjs +49 -19
  188. package/foundation/fs/path-safety.test.mjs +50 -0
  189. package/foundation/fs/publish-file-hardlink-unavailable.test.mjs +129 -94
  190. package/foundation/integrations/autolink.mjs +6 -1
  191. package/foundation/response/base.d.ts +8 -4
  192. package/foundation/response/error-codes.doc.mjs +1 -2
  193. package/foundation/response/error-codes.mjs +1 -1
  194. package/foundation/response/error-codes.test.mjs +83 -0
  195. package/foundation/response/json-contract.test.mjs +11 -0
  196. package/foundation/response/json.d.mts +4 -2
  197. package/foundation/response/json.mjs +8 -10
  198. package/foundation/response/response-types.doc.mjs +10 -10
  199. package/foundation/response/response-types.doc.test.mjs +158 -0
  200. package/foundation/xle/expand.d.mts +2 -0
  201. package/foundation/xle/expand.mjs +3 -2
  202. package/foundation/xle/expand.test.mjs +54 -0
  203. package/package.json +9 -9
  204. package/clients/cli/lib/update-check.mjs +0 -83
  205. package/clients/cli/lib/update-check.test.mjs +0 -137
  206. package/clients/cli/update-hint-commands.test.mjs +0 -54
@@ -0,0 +1,248 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ import {describe, expect, it} from 'vitest';
4
+ import * as fs from 'node:fs';
5
+ import * as path from 'node:path';
6
+ import {fileURLToPath} from 'node:url';
7
+ import jscodeshift from 'jscodeshift';
8
+ import {stripTemplateAssetRefs} from './template-adapter.mjs';
9
+
10
+ const PLACEHOLDER = stripTemplateAssetRefs("'/template-assets/x.png'").slice(
11
+ 1,
12
+ -1,
13
+ );
14
+
15
+ describe('stripTemplateAssetRefs fixture references', () => {
16
+ it('replaces an image with a self-contained placeholder', () => {
17
+ expect(PLACEHOLDER).toMatch(/^data:image\/svg\+xml,[^\s'"`()]+$/u);
18
+ });
19
+
20
+ it.each([
21
+ 'https://cdn.example.com/template-assets/logo.png',
22
+ '//cdn.example.com/template-assets/logo.png',
23
+ '/my-app/template-assets/hero.jpg',
24
+ './template-assets/hero.jpg',
25
+ 'template-assets/hero.jpg',
26
+ '/template-assets-archive/hero.jpg',
27
+ '@/template-assets/hero.jpg',
28
+ ])('leaves %s untouched', value => {
29
+ const source = `const src = '${value}';`;
30
+ expect(stripTemplateAssetRefs(source)).toBe(source);
31
+ });
32
+
33
+ it.each([
34
+ 'import StarIcon from "./icons/star.svg";',
35
+ '<Icon icon="/icons/star.svg" />',
36
+ '<Button icon={StarIcon} />',
37
+ "const icons = {star: 'heroicons:star'};",
38
+ ])('leaves an icon outside the fixture namespace untouched: %s', source => {
39
+ expect(stripTemplateAssetRefs(source)).toBe(source);
40
+ });
41
+
42
+ it.each([
43
+ ['a subdirectory', '/template-assets/avatars/ada.png'],
44
+ ['an @ in its name', '/template-assets/hero@2x.png'],
45
+ ['a plus in its name', '/template-assets/cover+1.jpg'],
46
+ ['an encoded space in its name', '/template-assets/hero%20wide.png'],
47
+ ])('replaces a fixture with %s', (_, value) => {
48
+ expect(stripTemplateAssetRefs(`<img src="${value}" />`)).toBe(
49
+ `<img src="${PLACEHOLDER}" />`,
50
+ );
51
+ });
52
+
53
+ it('replaces the whole reference, query and fragment included', () => {
54
+ expect(
55
+ stripTemplateAssetRefs("const hero = '/template-assets/hero.jpg?w=200';"),
56
+ ).toBe(`const hero = '${PLACEHOLDER}';`);
57
+ expect(
58
+ stripTemplateAssetRefs("const clip = '/template-assets/clip.mp4#t=5';"),
59
+ ).toBe("const clip = '';");
60
+ expect(
61
+ stripTemplateAssetRefs(
62
+ "const hero = '/template-assets/a.png?f=/template-assets/b.png';",
63
+ ),
64
+ ).toBe(`const hero = '${PLACEHOLDER}';`);
65
+ });
66
+
67
+ it('classifies by the complete final suffix, ignoring case', () => {
68
+ expect(
69
+ stripTemplateAssetRefs("src: '/template-assets/Clip.Min.MP4',"),
70
+ ).toBe("src: '',");
71
+ });
72
+
73
+ it.each([
74
+ [
75
+ 'a CSS url()',
76
+ "backgroundImage: 'url(/template-assets/hero.png)'",
77
+ `backgroundImage: 'url(${PLACEHOLDER})'`,
78
+ ],
79
+ [
80
+ 'a srcset list',
81
+ 'srcSet="/template-assets/a.png 1x, /template-assets/a@2x.png 2x"',
82
+ `srcSet="${PLACEHOLDER} 1x, ${PLACEHOLDER} 2x"`,
83
+ ],
84
+ [
85
+ 'an HTML string with escaped quotes',
86
+ 'const html = "<img src=\\"/template-assets/a.png\\">";',
87
+ `const html = "<img src=\\"${PLACEHOLDER}\\">";`,
88
+ ],
89
+ [
90
+ 'JSX text',
91
+ '<code>/template-assets/hero.png</code>',
92
+ `<code>${PLACEHOLDER}</code>`,
93
+ ],
94
+ [
95
+ 'a sentence that quotes it',
96
+ 'const tip = "Replace \'/template-assets/hero.png\'.";',
97
+ `const tip = "Replace '${PLACEHOLDER}'.";`,
98
+ ],
99
+ [
100
+ 'a url() inside a longer string',
101
+ "const bg = 'url(/template-assets/a.png) + x';",
102
+ `const bg = 'url(${PLACEHOLDER}) + x';`,
103
+ ],
104
+ [
105
+ 'a comment',
106
+ '// hero: /template-assets/hero.png\n',
107
+ `// hero: ${PLACEHOLDER}\n`,
108
+ ],
109
+ [
110
+ 'a sentence, keeping its punctuation',
111
+ '// Uses /template-assets/a.png, then /template-assets/b.png.\n',
112
+ `// Uses ${PLACEHOLDER}, then ${PLACEHOLDER}.\n`,
113
+ ],
114
+ ])('replaces a fixture inside %s', (_, source, expected) => {
115
+ expect(stripTemplateAssetRefs(source)).toBe(expected);
116
+ });
117
+
118
+ it.each([
119
+ '<Text>Put your images in /template-assets/ first.</Text>',
120
+ "const note = 'Media: /template-assets/hero';",
121
+ '// Demo images live under /template-assets and are replaced.\n',
122
+ "const html = '<img src=/template-assets-archive/a.png>';",
123
+ ])('leaves a mention in text that names no media file: %s', source => {
124
+ expect(stripTemplateAssetRefs(source)).toBe(source);
125
+ });
126
+
127
+ it.each([
128
+ "// Images come from `/template-assets/*` and '/template-assets/'.\nexport default function Page() {\n return null;\n}\n",
129
+ "/* Was '/template-assets/clip.bin'. */\nexport const x = 1;\n",
130
+ ])('leaves a comment it would otherwise reject: %s', source => {
131
+ expect(stripTemplateAssetRefs(source)).toBe(source);
132
+ });
133
+
134
+ it.each([
135
+ [
136
+ 'no file suffix',
137
+ "src: '/template-assets/hero',",
138
+ '/template-assets/hero',
139
+ ],
140
+ ['no file name', "src: '/template-assets/',", '/template-assets/'],
141
+ [
142
+ 'no path below it',
143
+ "export const base = '/template-assets'; // base\n",
144
+ '/template-assets',
145
+ ],
146
+ ])(
147
+ 'fails with the fixture path when a value has %s',
148
+ (_, source, reference) => {
149
+ expect(() => stripTemplateAssetRefs(source)).toThrow(
150
+ `Unrecognized template asset format (none) for ${reference}`,
151
+ );
152
+ },
153
+ );
154
+
155
+ it.each([
156
+ [
157
+ 'const src = `/template-assets/${name}.png`;',
158
+ '/template-assets/${name}.png',
159
+ ],
160
+ ['const src = `/template-assets${path}`;', '/template-assets${path}'],
161
+ ])(
162
+ 'fails when a fixture path is built by interpolation: %s',
163
+ (source, reference) => {
164
+ expect(() => stripTemplateAssetRefs(source)).toThrow(
165
+ `Template asset reference ${reference} cannot be replaced safely: it is built by a template-literal interpolation`,
166
+ );
167
+ },
168
+ );
169
+
170
+ it.each([
171
+ [
172
+ 'follows an interpolation',
173
+ 'const src = `${base}/template-assets/a.png`;',
174
+ ],
175
+ ['is cut short by a parenthesis', "src: '/template-assets/a(1).mp4',"],
176
+ ['ends a word in text', 'const s = "clip: /template-assets/a.png(1).mp4";'],
177
+ [
178
+ 'has mismatched escaped quotes',
179
+ 'const html = "<img src=\\"/template-assets/a.png\\\'>";',
180
+ ],
181
+ [
182
+ 'sits between a quote and a parenthesis',
183
+ "const s = '\"/template-assets/a.png)';",
184
+ ],
185
+ ])('fails when a fixture path %s', (_, source) => {
186
+ expect(() => stripTemplateAssetRefs(source)).toThrow(
187
+ /\/template-assets\/a.* cannot be replaced safely: it is not a whole/u,
188
+ );
189
+ });
190
+
191
+ it.each([
192
+ 'srcSet="/template-assets/a.png 1x,/template-assets/b.png 2x"',
193
+ "const html = '<img src=/template-assets/b.png>';",
194
+ "const s = 'hero\\n/template-assets/b.png';",
195
+ ])('fails when a fixture path is joined to other text: %s', source => {
196
+ expect(() => stripTemplateAssetRefs(source)).toThrow(
197
+ /\/template-assets\/b\.png cannot be replaced safely: it is joined/u,
198
+ );
199
+ });
200
+
201
+ it.each([
202
+ ['concatenated', "const src = base + '/template-assets/hero.png';"],
203
+ ['concatenated', "const src = '/template-assets/hero.png' + query;"],
204
+ ['concatenated', "src += '/template-assets/hero.png';"],
205
+ ['a method', "const src = '/template-assets/hero.png'.concat('?w=1');"],
206
+ ['imported', "import hero from '/template-assets/hero.png';"],
207
+ ['imported', "const hero = require('/template-assets/hero.png');"],
208
+ ])('fails when a fixture string is %s: %s', (use, source) => {
209
+ expect(() => stripTemplateAssetRefs(source)).toThrow(
210
+ new RegExp(`/template-assets/hero\\.png .*${use}`, 'u'),
211
+ );
212
+ });
213
+ });
214
+
215
+ describe('shipped templates', () => {
216
+ it('copy with every fixture replaced and still parse', () => {
217
+ const root = path.resolve(
218
+ path.dirname(fileURLToPath(import.meta.url)),
219
+ '../../assets/templates',
220
+ );
221
+ const parse = jscodeshift.withParser('tsx');
222
+ const files = fs
223
+ .readdirSync(root, {recursive: true, encoding: 'utf-8'})
224
+ .filter(file => file.endsWith('.tsx'))
225
+ .filter(file =>
226
+ fs
227
+ .readFileSync(path.join(root, file), 'utf-8')
228
+ .includes('/template-assets'),
229
+ );
230
+ expect(files.length).toBeGreaterThan(10);
231
+
232
+ const problems = [];
233
+ for (const file of files) {
234
+ try {
235
+ const output = stripTemplateAssetRefs(
236
+ fs.readFileSync(path.join(root, file), 'utf-8'),
237
+ );
238
+ if (output.includes('/template-assets')) {
239
+ problems.push(`${file}: fixture reference left behind`);
240
+ }
241
+ parse(output);
242
+ } catch (err) {
243
+ problems.push(`${file}: ${/** @type {Error} */ (err).message}`);
244
+ }
245
+ }
246
+ expect(problems).toEqual([]);
247
+ });
248
+ });
@@ -0,0 +1,94 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /**
4
+ * @file Template discovery isolates each configured integration.
5
+ *
6
+ * An integration whose templates root cannot be read (here, the manifest points
7
+ * `templates` at a file) is that package's discovery error. Core templates and
8
+ * every other integration's templates are still discovered.
9
+ */
10
+
11
+ import {describe, it, expect, beforeEach, afterEach} from 'vitest';
12
+ import * as fs from 'node:fs';
13
+ import * as os from 'node:os';
14
+ import * as path from 'node:path';
15
+ import {discoverAll, discoverAllWithErrors} from './template-adapter.mjs';
16
+ import {runCli} from '../../test-utils/run-cli.mjs';
17
+
18
+ let tmpDir = '';
19
+
20
+ /**
21
+ * @param {string} name
22
+ * @param {Record<string, string>} files
23
+ */
24
+ function installPackage(name, files) {
25
+ const dir = path.join(tmpDir, 'node_modules', ...name.split('/'));
26
+ fs.mkdirSync(dir, {recursive: true});
27
+ fs.writeFileSync(
28
+ path.join(dir, 'package.json'),
29
+ JSON.stringify({name, version: '1.0.0'}),
30
+ );
31
+ for (const [file, contents] of Object.entries(files)) {
32
+ fs.mkdirSync(path.dirname(path.join(dir, file)), {recursive: true});
33
+ fs.writeFileSync(path.join(dir, file), contents);
34
+ }
35
+ }
36
+
37
+ beforeEach(() => {
38
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-template-isolation-'));
39
+ fs.writeFileSync(
40
+ path.join(tmpDir, 'package.json'),
41
+ JSON.stringify({name: 'consumer', version: '1.0.0'}),
42
+ );
43
+ fs.writeFileSync(
44
+ path.join(tmpDir, 'astryx.config.mjs'),
45
+ `export default {integrations: ['@acme/file-root', '@acme/good']};\n`,
46
+ );
47
+ installPackage('@acme/file-root', {
48
+ 'astryx.integration.mjs': `export default {templates: './templates.mjs'};\n`,
49
+ 'templates.mjs': 'export default {};\n',
50
+ });
51
+ installPackage('@acme/good', {
52
+ 'astryx.integration.mjs': `export default {templates: './templates'};\n`,
53
+ 'templates/good-hero.template.mjs': `export default {type: 'block', name: 'Good hero', description: 'A hero.'};\n`,
54
+ 'templates/good-hero.tsx': 'export default function GoodHero() { return null; }\n',
55
+ });
56
+ });
57
+
58
+ afterEach(() => {
59
+ fs.rmSync(tmpDir, {recursive: true, force: true});
60
+ });
61
+
62
+ describe('template discovery with an unreadable templates root', () => {
63
+ it('keeps core and the other integrations', async () => {
64
+ const templates = await discoverAll(tmpDir);
65
+
66
+ expect(templates).toContainEqual(
67
+ expect.objectContaining({dirName: 'good-hero', package: '@acme/good'}),
68
+ );
69
+ expect(templates.some(template => template.package == null)).toBe(true);
70
+ expect(templates.some(t => t.package === '@acme/file-root')).toBe(false);
71
+ });
72
+
73
+ it('reports the unreadable root as that package’s error', async () => {
74
+ const {errors} = await discoverAllWithErrors(tmpDir);
75
+
76
+ expect(errors).toContainEqual(
77
+ expect.objectContaining({
78
+ package: '@acme/file-root',
79
+ message: expect.stringContaining('templates.mjs'),
80
+ }),
81
+ );
82
+ });
83
+
84
+ it('keeps astryx template --list working', async () => {
85
+ const {status, stdout} = await runCli(['template', '--list', '--json'], {
86
+ cwd: tmpDir,
87
+ });
88
+
89
+ expect(status).toBe(0);
90
+ expect(JSON.parse(stdout).data).toContainEqual(
91
+ expect.objectContaining({id: 'good-hero'}),
92
+ );
93
+ });
94
+ });