@fragments-sdk/cli 0.10.0 → 0.11.1

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 (167) hide show
  1. package/dist/bin.js +26 -8
  2. package/dist/bin.js.map +1 -1
  3. package/dist/{chunk-ZDA3PLQ6.js → chunk-5G3VZH43.js} +2 -2
  4. package/dist/{chunk-566BNPQZ.js → chunk-HRFUSSZI.js} +25 -6
  5. package/dist/chunk-HRFUSSZI.js.map +1 -0
  6. package/dist/{chunk-CAMXG5HJ.js → chunk-ZM4ZQZWZ.js} +2 -2
  7. package/dist/{generate-BGKTKO6E.js → generate-FBHSXR3D.js} +2 -2
  8. package/dist/index.js +2 -2
  9. package/dist/{init-Q53R5Q2T.js → init-UFGK5TCN.js} +77 -6
  10. package/dist/init-UFGK5TCN.js.map +1 -0
  11. package/dist/{scan-OQU7M4GH.js → scan-CJF2DOQW.js} +3 -3
  12. package/dist/{scan-generate-T5QNUG7N.js → scan-generate-SJAN5MVI.js} +2 -2
  13. package/dist/snapshot-SV2JOFZH.js +139 -0
  14. package/dist/snapshot-SV2JOFZH.js.map +1 -0
  15. package/dist/{test-2CSOSS3B.js → test-Z5LVO724.js} +2 -2
  16. package/dist/{tokens-DXEGYTOJ.js → tokens-CE46OTMD.js} +2 -2
  17. package/dist/{viewer-DBEPYM3G.js → viewer-DLLJIMCK.js} +69 -47
  18. package/dist/viewer-DLLJIMCK.js.map +1 -0
  19. package/package.json +6 -14
  20. package/src/bin.ts +30 -0
  21. package/src/commands/init.ts +76 -1
  22. package/src/commands/snapshot.ts +197 -0
  23. package/src/core/loader.ts +38 -8
  24. package/src/viewer/__tests__/viewer-integration.test.ts +85 -74
  25. package/src/viewer/server.ts +37 -22
  26. package/src/viewer/vite-plugin.ts +25 -9
  27. package/dist/chunk-566BNPQZ.js.map +0 -1
  28. package/dist/init-Q53R5Q2T.js.map +0 -1
  29. package/dist/viewer-DBEPYM3G.js.map +0 -1
  30. package/src/viewer/__tests__/a11y-fixes.test.ts +0 -358
  31. package/src/viewer/__tests__/jsx-parser.test.ts +0 -502
  32. package/src/viewer/__tests__/render-utils.test.ts +0 -232
  33. package/src/viewer/__tests__/style-utils.test.ts +0 -404
  34. package/src/viewer/assets/fragments-logo.ts +0 -4
  35. package/src/viewer/components/AccessibilityPanel.tsx +0 -1457
  36. package/src/viewer/components/ActionCapture.tsx +0 -172
  37. package/src/viewer/components/ActionsPanel.tsx +0 -332
  38. package/src/viewer/components/AllVariantsPreview.tsx +0 -78
  39. package/src/viewer/components/App.tsx +0 -582
  40. package/src/viewer/components/BottomPanel.tsx +0 -288
  41. package/src/viewer/components/CodePanel.naming.test.tsx +0 -59
  42. package/src/viewer/components/CodePanel.tsx +0 -118
  43. package/src/viewer/components/CommandPalette.tsx +0 -392
  44. package/src/viewer/components/ComponentDocView.tsx +0 -164
  45. package/src/viewer/components/ComponentGraph.tsx +0 -380
  46. package/src/viewer/components/ComponentHeader.tsx +0 -88
  47. package/src/viewer/components/ContractPanel.tsx +0 -241
  48. package/src/viewer/components/EmptyVariantMessage.tsx +0 -54
  49. package/src/viewer/components/ErrorBoundary.tsx +0 -97
  50. package/src/viewer/components/FigmaEmbed.tsx +0 -238
  51. package/src/viewer/components/FragmentEditor.tsx +0 -525
  52. package/src/viewer/components/FragmentRenderer.tsx +0 -61
  53. package/src/viewer/components/HeaderSearch.tsx +0 -24
  54. package/src/viewer/components/HealthDashboard.tsx +0 -441
  55. package/src/viewer/components/HmrStatusIndicator.tsx +0 -61
  56. package/src/viewer/components/Icons.tsx +0 -479
  57. package/src/viewer/components/InteractionsPanel.tsx +0 -757
  58. package/src/viewer/components/IsolatedPreviewFrame.tsx +0 -346
  59. package/src/viewer/components/IsolatedRender.tsx +0 -113
  60. package/src/viewer/components/KeyboardShortcutsHelp.tsx +0 -53
  61. package/src/viewer/components/LandingPage.tsx +0 -421
  62. package/src/viewer/components/Layout.tsx +0 -27
  63. package/src/viewer/components/LeftSidebar.tsx +0 -472
  64. package/src/viewer/components/LoadErrorMessage.tsx +0 -102
  65. package/src/viewer/components/MultiViewportPreview.tsx +0 -522
  66. package/src/viewer/components/NoVariantsMessage.tsx +0 -59
  67. package/src/viewer/components/PanelShell.tsx +0 -161
  68. package/src/viewer/components/PerformancePanel.tsx +0 -304
  69. package/src/viewer/components/PreviewArea.tsx +0 -472
  70. package/src/viewer/components/PreviewAside.tsx +0 -168
  71. package/src/viewer/components/PreviewFrameHost.tsx +0 -303
  72. package/src/viewer/components/PreviewPane.tsx +0 -149
  73. package/src/viewer/components/PreviewToolbar.tsx +0 -80
  74. package/src/viewer/components/PropsEditor.tsx +0 -506
  75. package/src/viewer/components/PropsTable.tsx +0 -111
  76. package/src/viewer/components/RelationsSection.tsx +0 -88
  77. package/src/viewer/components/ResizablePanel.tsx +0 -271
  78. package/src/viewer/components/RightSidebar.tsx +0 -102
  79. package/src/viewer/components/RuntimeToolsRegistrar.tsx +0 -17
  80. package/src/viewer/components/ScreenshotButton.tsx +0 -90
  81. package/src/viewer/components/Sidebar.tsx +0 -169
  82. package/src/viewer/components/SkeletonLoader.tsx +0 -161
  83. package/src/viewer/components/ThemeProvider.tsx +0 -42
  84. package/src/viewer/components/Toast.tsx +0 -3
  85. package/src/viewer/components/TokenStylePanel.tsx +0 -699
  86. package/src/viewer/components/TopToolbar.tsx +0 -159
  87. package/src/viewer/components/UsageSection.tsx +0 -95
  88. package/src/viewer/components/VariantMatrix.tsx +0 -388
  89. package/src/viewer/components/VariantRenderer.tsx +0 -131
  90. package/src/viewer/components/VariantTabs.tsx +0 -40
  91. package/src/viewer/components/ViewerHeader.tsx +0 -69
  92. package/src/viewer/components/ViewerStateSync.tsx +0 -52
  93. package/src/viewer/components/ViewportSelector.tsx +0 -172
  94. package/src/viewer/components/WebMCPDevTools.tsx +0 -503
  95. package/src/viewer/components/WebMCPIntegration.tsx +0 -47
  96. package/src/viewer/components/WebMCPStatusIndicator.tsx +0 -60
  97. package/src/viewer/components/_future/CreatePage.tsx +0 -836
  98. package/src/viewer/components/viewer-utils.ts +0 -16
  99. package/src/viewer/composition-renderer.ts +0 -381
  100. package/src/viewer/constants/index.ts +0 -1
  101. package/src/viewer/constants/ui.ts +0 -166
  102. package/src/viewer/entry.tsx +0 -335
  103. package/src/viewer/hooks/index.ts +0 -2
  104. package/src/viewer/hooks/useA11yCache.ts +0 -383
  105. package/src/viewer/hooks/useA11yService.ts +0 -364
  106. package/src/viewer/hooks/useActions.ts +0 -138
  107. package/src/viewer/hooks/useAppState.ts +0 -147
  108. package/src/viewer/hooks/useCompiledFragments.ts +0 -42
  109. package/src/viewer/hooks/useFigmaIntegration.ts +0 -132
  110. package/src/viewer/hooks/useHmrStatus.ts +0 -109
  111. package/src/viewer/hooks/useKeyboardShortcuts.ts +0 -270
  112. package/src/viewer/hooks/usePreviewBridge.ts +0 -347
  113. package/src/viewer/hooks/useScrollSpy.ts +0 -78
  114. package/src/viewer/hooks/useUrlState.ts +0 -318
  115. package/src/viewer/hooks/useViewSettings.ts +0 -111
  116. package/src/viewer/index.html +0 -28
  117. package/src/viewer/intelligence/healthReport.ts +0 -505
  118. package/src/viewer/intelligence/styleDrift.ts +0 -340
  119. package/src/viewer/intelligence/usageScanner.ts +0 -309
  120. package/src/viewer/jsx-parser.ts +0 -486
  121. package/src/viewer/preview-frame-entry.tsx +0 -25
  122. package/src/viewer/preview-frame.html +0 -125
  123. package/src/viewer/public/favicon.ico +0 -0
  124. package/src/viewer/render-template.html +0 -68
  125. package/src/viewer/styles/globals.css +0 -278
  126. package/src/viewer/types/a11y.ts +0 -197
  127. package/src/viewer/utils/a11y-fixes.ts +0 -509
  128. package/src/viewer/utils/actionExport.ts +0 -372
  129. package/src/viewer/utils/colorSchemes.ts +0 -201
  130. package/src/viewer/utils/detectRelationships.ts +0 -256
  131. package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss +0 -10
  132. package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss.d.ts +0 -2
  133. package/src/viewer/vendor/shared/src/ComponentDocContent.tsx +0 -274
  134. package/src/viewer/vendor/shared/src/DocsHeaderBar.tsx +0 -129
  135. package/src/viewer/vendor/shared/src/DocsPageAsideHost.tsx +0 -89
  136. package/src/viewer/vendor/shared/src/DocsPageShell.tsx +0 -124
  137. package/src/viewer/vendor/shared/src/DocsSearchCommand.tsx +0 -99
  138. package/src/viewer/vendor/shared/src/DocsSidebarNav.tsx +0 -66
  139. package/src/viewer/vendor/shared/src/PropsTable.module.scss +0 -68
  140. package/src/viewer/vendor/shared/src/PropsTable.module.scss.d.ts +0 -2
  141. package/src/viewer/vendor/shared/src/PropsTable.tsx +0 -76
  142. package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss +0 -114
  143. package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss.d.ts +0 -2
  144. package/src/viewer/vendor/shared/src/VariantPreviewCard.tsx +0 -134
  145. package/src/viewer/vendor/shared/src/docs-data/index.ts +0 -32
  146. package/src/viewer/vendor/shared/src/docs-data/mcp-configs.ts +0 -72
  147. package/src/viewer/vendor/shared/src/docs-data/palettes.ts +0 -75
  148. package/src/viewer/vendor/shared/src/docs-data/setup-examples.ts +0 -55
  149. package/src/viewer/vendor/shared/src/docs-layout.scss +0 -28
  150. package/src/viewer/vendor/shared/src/docs-layout.scss.d.ts +0 -2
  151. package/src/viewer/vendor/shared/src/index.ts +0 -34
  152. package/src/viewer/vendor/shared/src/types.ts +0 -53
  153. package/src/viewer/webmcp/__tests__/analytics.test.ts +0 -108
  154. package/src/viewer/webmcp/analytics.ts +0 -165
  155. package/src/viewer/webmcp/index.ts +0 -3
  156. package/src/viewer/webmcp/posthog-bridge.ts +0 -39
  157. package/src/viewer/webmcp/runtime-tools.ts +0 -152
  158. package/src/viewer/webmcp/scan-utils.ts +0 -135
  159. package/src/viewer/webmcp/use-tool-analytics.ts +0 -69
  160. package/src/viewer/webmcp/viewer-state.ts +0 -45
  161. /package/dist/{chunk-ZDA3PLQ6.js.map → chunk-5G3VZH43.js.map} +0 -0
  162. /package/dist/{chunk-CAMXG5HJ.js.map → chunk-ZM4ZQZWZ.js.map} +0 -0
  163. /package/dist/{generate-BGKTKO6E.js.map → generate-FBHSXR3D.js.map} +0 -0
  164. /package/dist/{scan-OQU7M4GH.js.map → scan-CJF2DOQW.js.map} +0 -0
  165. /package/dist/{scan-generate-T5QNUG7N.js.map → scan-generate-SJAN5MVI.js.map} +0 -0
  166. /package/dist/{test-2CSOSS3B.js.map → test-Z5LVO724.js.map} +0 -0
  167. /package/dist/{tokens-DXEGYTOJ.js.map → tokens-CE46OTMD.js.map} +0 -0
@@ -1,502 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import {
3
- parseJSX,
4
- extractComponents,
5
- validateComponents,
6
- type ComponentNode,
7
- } from "../jsx-parser.js";
8
-
9
- describe("parseJSX", () => {
10
- describe("basic parsing", () => {
11
- it("parses a simple component", () => {
12
- const result = parseJSX('<Button variant="primary">Click me</Button>');
13
-
14
- expect(result.errors).toEqual([]);
15
- expect(result.components).toEqual(["Button"]);
16
- expect(result.tree).toEqual({
17
- name: "Button",
18
- isHtmlElement: false,
19
- props: { variant: "primary" },
20
- children: ["Click me"],
21
- });
22
- });
23
-
24
- it("parses a self-closing component", () => {
25
- const result = parseJSX('<Input placeholder="Enter text" />');
26
-
27
- expect(result.errors).toEqual([]);
28
- expect(result.components).toEqual(["Input"]);
29
- expect(result.tree).toEqual({
30
- name: "Input",
31
- isHtmlElement: false,
32
- props: { placeholder: "Enter text" },
33
- children: [],
34
- });
35
- });
36
-
37
- it("parses nested components", () => {
38
- const result = parseJSX('<Card><Button>Click</Button></Card>');
39
-
40
- expect(result.errors).toEqual([]);
41
- expect(result.components).toEqual(["Button", "Card"]);
42
-
43
- const tree = result.tree as ComponentNode;
44
- expect(tree.name).toBe("Card");
45
- expect(tree.children).toHaveLength(1);
46
-
47
- const button = tree.children[0] as ComponentNode;
48
- expect(button.name).toBe("Button");
49
- expect(button.children).toEqual(["Click"]);
50
- });
51
-
52
- it("parses deeply nested components", () => {
53
- const result = parseJSX(`
54
- <Card>
55
- <Alert severity="warning">
56
- <Button variant="danger">Delete</Button>
57
- </Alert>
58
- </Card>
59
- `);
60
-
61
- expect(result.errors).toEqual([]);
62
- expect(result.components).toEqual(["Alert", "Button", "Card"]);
63
-
64
- const tree = result.tree as ComponentNode;
65
- expect(tree.name).toBe("Card");
66
-
67
- const alert = tree.children[0] as ComponentNode;
68
- expect(alert.name).toBe("Alert");
69
- expect(alert.props).toEqual({ severity: "warning" });
70
-
71
- const button = alert.children[0] as ComponentNode;
72
- expect(button.name).toBe("Button");
73
- expect(button.props).toEqual({ variant: "danger" });
74
- });
75
- });
76
-
77
- describe("HTML elements", () => {
78
- it("recognizes HTML elements (lowercase)", () => {
79
- const result = parseJSX('<div className="container"><span>Text</span></div>');
80
-
81
- expect(result.errors).toEqual([]);
82
- expect(result.components).toEqual([]); // HTML elements not tracked as components
83
-
84
- const tree = result.tree as ComponentNode;
85
- expect(tree.name).toBe("div");
86
- expect(tree.isHtmlElement).toBe(true);
87
- expect(tree.props).toEqual({ className: "container" });
88
-
89
- const span = tree.children[0] as ComponentNode;
90
- expect(span.name).toBe("span");
91
- expect(span.isHtmlElement).toBe(true);
92
- });
93
-
94
- it("distinguishes HTML elements from custom components", () => {
95
- const result = parseJSX('<div><Button>Click</Button></div>');
96
-
97
- expect(result.components).toEqual(["Button"]);
98
-
99
- const tree = result.tree as ComponentNode;
100
- expect(tree.isHtmlElement).toBe(true);
101
-
102
- const button = tree.children[0] as ComponentNode;
103
- expect(button.isHtmlElement).toBe(false);
104
- });
105
- });
106
-
107
- describe("props parsing", () => {
108
- it("parses string props", () => {
109
- const result = parseJSX('<Button variant="primary" size="large" />');
110
-
111
- const tree = result.tree as ComponentNode;
112
- expect(tree.props).toEqual({
113
- variant: "primary",
114
- size: "large",
115
- });
116
- });
117
-
118
- it("parses boolean props (no value = true)", () => {
119
- const result = parseJSX("<Button disabled />");
120
-
121
- const tree = result.tree as ComponentNode;
122
- expect(tree.props).toEqual({ disabled: true });
123
- });
124
-
125
- it("parses boolean expression props", () => {
126
- const result = parseJSX("<Button disabled={true} checked={false} />");
127
-
128
- const tree = result.tree as ComponentNode;
129
- expect(tree.props).toEqual({ disabled: true, checked: false });
130
- });
131
-
132
- it("parses numeric props", () => {
133
- const result = parseJSX("<Button count={42} price={19.99} negative={-5} />");
134
-
135
- const tree = result.tree as ComponentNode;
136
- expect(tree.props).toEqual({ count: 42, price: 19.99, negative: -5 });
137
- });
138
-
139
- it("parses object props", () => {
140
- const result = parseJSX('<Button style={{ color: "red", fontSize: 14 }} />');
141
-
142
- const tree = result.tree as ComponentNode;
143
- expect(tree.props).toEqual({
144
- style: { color: "red", fontSize: 14 },
145
- });
146
- });
147
-
148
- it("parses array props", () => {
149
- const result = parseJSX('<Select options={["a", "b", "c"]} values={[1, 2, 3]} />');
150
-
151
- const tree = result.tree as ComponentNode;
152
- expect(tree.props).toEqual({
153
- options: ["a", "b", "c"],
154
- values: [1, 2, 3],
155
- });
156
- });
157
-
158
- it("parses null and undefined props", () => {
159
- const result = parseJSX("<Button value={null} other={undefined} />");
160
-
161
- const tree = result.tree as ComponentNode;
162
- expect(tree.props).toEqual({ value: null, other: undefined });
163
- });
164
-
165
- it("handles function props as placeholder", () => {
166
- const result = parseJSX("<Button onClick={() => console.log('clicked')} />");
167
-
168
- const tree = result.tree as ComponentNode;
169
- expect(tree.props.onClick).toBe("[Function]");
170
- });
171
-
172
- it("handles identifier props as placeholder", () => {
173
- const result = parseJSX("<Button onClick={handleClick} />");
174
-
175
- const tree = result.tree as ComponentNode;
176
- expect(tree.props.onClick).toBe("{handleClick}");
177
- });
178
- });
179
-
180
- describe("multiple root elements", () => {
181
- it("handles multiple root elements", () => {
182
- const result = parseJSX("<Button>A</Button><Button>B</Button>");
183
-
184
- expect(result.errors).toEqual([]);
185
- expect(result.components).toEqual(["Button"]);
186
- expect(Array.isArray(result.tree)).toBe(true);
187
-
188
- const trees = result.tree as ComponentNode[];
189
- expect(trees).toHaveLength(2);
190
- expect(trees[0].children).toEqual(["A"]);
191
- expect(trees[1].children).toEqual(["B"]);
192
- });
193
-
194
- it("handles fragments", () => {
195
- const result = parseJSX("<><Button>A</Button><Card>B</Card></>");
196
-
197
- expect(result.errors).toEqual([]);
198
- expect(result.components).toEqual(["Button", "Card"]);
199
-
200
- const trees = result.tree as ComponentNode[];
201
- expect(trees).toHaveLength(2);
202
- });
203
- });
204
-
205
- describe("mixed content", () => {
206
- it("handles text children with components", () => {
207
- const result = parseJSX('<Card>Hello <Button>world</Button>!</Card>');
208
-
209
- const tree = result.tree as ComponentNode;
210
- expect(tree.name).toBe("Card");
211
- expect(tree.children).toHaveLength(3);
212
- expect(tree.children[0]).toBe("Hello");
213
- expect((tree.children[1] as ComponentNode).name).toBe("Button");
214
- expect(tree.children[2]).toBe("!");
215
- });
216
-
217
- it("handles multiple sibling components", () => {
218
- const result = parseJSX(`
219
- <Card>
220
- <Alert severity="info">Info</Alert>
221
- <Alert severity="warning">Warning</Alert>
222
- <Button>Action</Button>
223
- </Card>
224
- `);
225
-
226
- const tree = result.tree as ComponentNode;
227
- const componentChildren = tree.children.filter(
228
- (c): c is ComponentNode => typeof c !== "string"
229
- );
230
- expect(componentChildren).toHaveLength(3);
231
- expect(componentChildren[0].name).toBe("Alert");
232
- expect(componentChildren[1].name).toBe("Alert");
233
- expect(componentChildren[2].name).toBe("Button");
234
- });
235
- });
236
-
237
- describe("error handling", () => {
238
- it("returns error for invalid JSX", () => {
239
- const result = parseJSX("<Button");
240
- expect(result.errors.length).toBeGreaterThan(0);
241
- expect(result.tree).toEqual([]);
242
- });
243
-
244
- it("returns error for mismatched tags", () => {
245
- const result = parseJSX("<Button></Card>");
246
- expect(result.errors.length).toBeGreaterThan(0);
247
- });
248
-
249
- it("returns empty tree for empty input", () => {
250
- const result = parseJSX("");
251
- // Empty string wraps to <></> which is an empty fragment
252
- expect(Array.isArray(result.tree) || result.tree).toBeTruthy();
253
- });
254
- });
255
-
256
- describe("member expressions", () => {
257
- it("parses JSX member expressions", () => {
258
- const result = parseJSX('<MyLib.Button variant="primary" />');
259
-
260
- expect(result.errors).toEqual([]);
261
- expect(result.components).toEqual(["MyLib.Button"]);
262
-
263
- const tree = result.tree as ComponentNode;
264
- expect(tree.name).toBe("MyLib.Button");
265
- });
266
- });
267
- });
268
-
269
- describe("extractComponents", () => {
270
- it("extracts components from single node", () => {
271
- const tree: ComponentNode = {
272
- name: "Button",
273
- isHtmlElement: false,
274
- props: {},
275
- children: [],
276
- };
277
-
278
- expect(extractComponents(tree)).toEqual(["Button"]);
279
- });
280
-
281
- it("extracts components from nested tree", () => {
282
- const tree: ComponentNode = {
283
- name: "Card",
284
- isHtmlElement: false,
285
- props: {},
286
- children: [
287
- {
288
- name: "Alert",
289
- isHtmlElement: false,
290
- props: {},
291
- children: [
292
- {
293
- name: "Button",
294
- isHtmlElement: false,
295
- props: {},
296
- children: [],
297
- },
298
- ],
299
- },
300
- ],
301
- };
302
-
303
- expect(extractComponents(tree)).toEqual(["Alert", "Button", "Card"]);
304
- });
305
-
306
- it("ignores HTML elements", () => {
307
- const tree: ComponentNode = {
308
- name: "div",
309
- isHtmlElement: true,
310
- props: {},
311
- children: [
312
- {
313
- name: "Button",
314
- isHtmlElement: false,
315
- props: {},
316
- children: [],
317
- },
318
- ],
319
- };
320
-
321
- expect(extractComponents(tree)).toEqual(["Button"]);
322
- });
323
-
324
- it("handles array of nodes", () => {
325
- const trees: ComponentNode[] = [
326
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
327
- { name: "Card", isHtmlElement: false, props: {}, children: [] },
328
- ];
329
-
330
- expect(extractComponents(trees)).toEqual(["Button", "Card"]);
331
- });
332
-
333
- it("deduplicates component names", () => {
334
- const tree: ComponentNode = {
335
- name: "Card",
336
- isHtmlElement: false,
337
- props: {},
338
- children: [
339
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
340
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
341
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
342
- ],
343
- };
344
-
345
- expect(extractComponents(tree)).toEqual(["Button", "Card"]);
346
- });
347
- });
348
-
349
- describe("validateComponents", () => {
350
- const availableComponents = ["Button", "Card", "Alert", "Input", "Badge"];
351
-
352
- it("validates when all components exist", () => {
353
- const tree: ComponentNode = {
354
- name: "Card",
355
- isHtmlElement: false,
356
- props: {},
357
- children: [
358
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
359
- ],
360
- };
361
-
362
- const result = validateComponents(tree, availableComponents);
363
- expect(result.valid).toBe(true);
364
- expect(result.missing).toEqual([]);
365
- });
366
-
367
- it("returns missing components", () => {
368
- const tree: ComponentNode = {
369
- name: "Modal",
370
- isHtmlElement: false,
371
- props: {},
372
- children: [
373
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
374
- ],
375
- };
376
-
377
- const result = validateComponents(tree, availableComponents);
378
- expect(result.valid).toBe(false);
379
- expect(result.missing).toEqual(["Modal"]);
380
- });
381
-
382
- it("provides suggestions for similar components", () => {
383
- const tree: ComponentNode = {
384
- name: "Buton", // typo
385
- isHtmlElement: false,
386
- props: {},
387
- children: [],
388
- };
389
-
390
- const result = validateComponents(tree, availableComponents);
391
- expect(result.valid).toBe(false);
392
- expect(result.missing).toEqual(["Buton"]);
393
- expect(result.suggestions.has("Buton")).toBe(true);
394
- expect(result.suggestions.get("Buton")).toContain("Button");
395
- });
396
-
397
- it("handles case-insensitive matching", () => {
398
- const tree: ComponentNode = {
399
- name: "button", // lowercase
400
- isHtmlElement: false,
401
- props: {},
402
- children: [],
403
- };
404
-
405
- const result = validateComponents(tree, availableComponents);
406
- expect(result.valid).toBe(true);
407
- });
408
-
409
- it("ignores HTML elements in validation", () => {
410
- const tree: ComponentNode = {
411
- name: "div",
412
- isHtmlElement: true,
413
- props: {},
414
- children: [
415
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
416
- ],
417
- };
418
-
419
- const result = validateComponents(tree, availableComponents);
420
- expect(result.valid).toBe(true);
421
- });
422
-
423
- it("validates array of nodes", () => {
424
- const trees: ComponentNode[] = [
425
- { name: "Button", isHtmlElement: false, props: {}, children: [] },
426
- { name: "Unknown", isHtmlElement: false, props: {}, children: [] },
427
- ];
428
-
429
- const result = validateComponents(trees, availableComponents);
430
- expect(result.valid).toBe(false);
431
- expect(result.missing).toEqual(["Unknown"]);
432
- });
433
- });
434
-
435
- describe("complex composition scenarios", () => {
436
- it("parses a realistic composition", () => {
437
- const jsx = `
438
- <Card padding="lg">
439
- <Alert severity="warning">
440
- Are you sure you want to delete this item?
441
- </Alert>
442
- <div style={{ marginTop: 16, display: "flex", gap: 8 }}>
443
- <Button variant="secondary">Cancel</Button>
444
- <Button variant="danger">Delete</Button>
445
- </div>
446
- </Card>
447
- `;
448
-
449
- const result = parseJSX(jsx);
450
- expect(result.errors).toEqual([]);
451
- expect(result.components).toEqual(["Alert", "Button", "Card"]);
452
-
453
- const card = result.tree as ComponentNode;
454
- expect(card.name).toBe("Card");
455
- expect(card.props).toEqual({ padding: "lg" });
456
-
457
- // Find the Alert
458
- const alert = card.children.find(
459
- (c): c is ComponentNode => typeof c !== "string" && c.name === "Alert"
460
- );
461
- expect(alert).toBeDefined();
462
- expect(alert?.props).toEqual({ severity: "warning" });
463
-
464
- // Find the div with buttons
465
- const div = card.children.find(
466
- (c): c is ComponentNode => typeof c !== "string" && c.name === "div"
467
- );
468
- expect(div).toBeDefined();
469
- expect(div?.isHtmlElement).toBe(true);
470
-
471
- // Find buttons inside div
472
- const buttons = div?.children.filter(
473
- (c): c is ComponentNode => typeof c !== "string" && c.name === "Button"
474
- );
475
- expect(buttons).toHaveLength(2);
476
- expect(buttons?.[0].props).toEqual({ variant: "secondary" });
477
- expect(buttons?.[1].props).toEqual({ variant: "danger" });
478
- });
479
-
480
- it("handles form-like composition", () => {
481
- const jsx = `
482
- <Card>
483
- <Input label="Email" type="email" placeholder="you@example.com" />
484
- <Input label="Password" type="password" />
485
- <Button type="submit" variant="primary">Sign In</Button>
486
- </Card>
487
- `;
488
-
489
- const result = parseJSX(jsx);
490
- expect(result.errors).toEqual([]);
491
- expect(result.components).toEqual(["Button", "Card", "Input"]);
492
-
493
- const card = result.tree as ComponentNode;
494
- const componentChildren = card.children.filter(
495
- (c): c is ComponentNode => typeof c !== "string"
496
- );
497
- expect(componentChildren).toHaveLength(3);
498
- expect(componentChildren[0].name).toBe("Input");
499
- expect(componentChildren[1].name).toBe("Input");
500
- expect(componentChildren[2].name).toBe("Button");
501
- });
502
- });