@fragments-sdk/cli 0.10.1 → 0.12.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 (223) hide show
  1. package/dist/ai-client-I6MDWNYA.js +21 -0
  2. package/dist/bin.js +292 -367
  3. package/dist/bin.js.map +1 -1
  4. package/dist/{chunk-PW7QTQA6.js → chunk-4OC7FTJB.js} +2 -2
  5. package/dist/{chunk-HRFUSSZI.js → chunk-AM4MRTMN.js} +2 -2
  6. package/dist/{chunk-5G3VZH43.js → chunk-GVDSFQ4E.js} +281 -351
  7. package/dist/chunk-GVDSFQ4E.js.map +1 -0
  8. package/dist/chunk-JJ2VRTBU.js +626 -0
  9. package/dist/chunk-JJ2VRTBU.js.map +1 -0
  10. package/dist/{chunk-D5PYOXEI.js → chunk-LVWFOLUZ.js} +148 -13
  11. package/dist/{chunk-D5PYOXEI.js.map → chunk-LVWFOLUZ.js.map} +1 -1
  12. package/dist/{chunk-WXSR2II7.js → chunk-OQKMEFOS.js} +58 -6
  13. package/dist/chunk-OQKMEFOS.js.map +1 -0
  14. package/dist/chunk-SXTKFDCR.js +104 -0
  15. package/dist/chunk-SXTKFDCR.js.map +1 -0
  16. package/dist/chunk-T5OMVL7E.js +443 -0
  17. package/dist/chunk-T5OMVL7E.js.map +1 -0
  18. package/dist/{chunk-ZM4ZQZWZ.js → chunk-TPWGL2XS.js} +39 -37
  19. package/dist/chunk-TPWGL2XS.js.map +1 -0
  20. package/dist/{chunk-OQO55NKV.js → chunk-WFS63PCW.js} +85 -11
  21. package/dist/chunk-WFS63PCW.js.map +1 -0
  22. package/dist/core/index.js +9 -1
  23. package/dist/{discovery-NEOY4MPN.js → discovery-ZJQSXF56.js} +3 -3
  24. package/dist/{generate-FBHSXR3D.js → generate-RJFS2JWA.js} +4 -4
  25. package/dist/index.js +7 -6
  26. package/dist/index.js.map +1 -1
  27. package/dist/init-ZSX3NRCZ.js +636 -0
  28. package/dist/init-ZSX3NRCZ.js.map +1 -0
  29. package/dist/mcp-bin.js +2 -2
  30. package/dist/{scan-CJF2DOQW.js → scan-3PMCJ4RB.js} +6 -6
  31. package/dist/scan-generate-SYU4PYZD.js +1115 -0
  32. package/dist/scan-generate-SYU4PYZD.js.map +1 -0
  33. package/dist/{service-TQYWY65E.js → service-VMGNJZ42.js} +3 -3
  34. package/dist/snapshot-XOISO2IS.js +139 -0
  35. package/dist/snapshot-XOISO2IS.js.map +1 -0
  36. package/dist/{static-viewer-NUBFPKWH.js → static-viewer-5GXH2MGE.js} +3 -3
  37. package/dist/static-viewer-5GXH2MGE.js.map +1 -0
  38. package/dist/{test-Z5LVO724.js → test-SI4NSHQX.js} +4 -4
  39. package/dist/{tokens-CE46OTMD.js → tokens-T6SIVUT5.js} +5 -5
  40. package/dist/{viewer-DNMNC5VS.js → viewer-7ZEAFBVN.js} +80 -58
  41. package/dist/viewer-7ZEAFBVN.js.map +1 -0
  42. package/package.json +6 -14
  43. package/src/ai-client.ts +156 -0
  44. package/src/bin.ts +74 -2
  45. package/src/build.ts +95 -33
  46. package/src/commands/__tests__/drift-sync.test.ts +252 -0
  47. package/src/commands/__tests__/scan-generate.test.ts +497 -45
  48. package/src/commands/enhance.ts +11 -35
  49. package/src/commands/init.ts +296 -193
  50. package/src/commands/scan-generate.ts +740 -139
  51. package/src/commands/scan.ts +37 -32
  52. package/src/commands/setup.ts +143 -52
  53. package/src/commands/snapshot.ts +197 -0
  54. package/src/commands/sync.ts +357 -0
  55. package/src/commands/validate.ts +43 -1
  56. package/src/core/component-extractor.test.ts +282 -0
  57. package/src/core/component-extractor.ts +1030 -0
  58. package/src/core/discovery.ts +93 -7
  59. package/src/service/enhance/props-extractor.ts +235 -13
  60. package/src/validators.ts +236 -0
  61. package/src/viewer/__tests__/viewer-integration.test.ts +85 -74
  62. package/src/viewer/server.ts +37 -22
  63. package/src/viewer/vite-plugin.ts +25 -9
  64. package/dist/chunk-5G3VZH43.js.map +0 -1
  65. package/dist/chunk-OQO55NKV.js.map +0 -1
  66. package/dist/chunk-WXSR2II7.js.map +0 -1
  67. package/dist/chunk-ZM4ZQZWZ.js.map +0 -1
  68. package/dist/init-NDQXUWDU.js +0 -796
  69. package/dist/init-NDQXUWDU.js.map +0 -1
  70. package/dist/scan-generate-SJAN5MVI.js +0 -691
  71. package/dist/scan-generate-SJAN5MVI.js.map +0 -1
  72. package/dist/viewer-DNMNC5VS.js.map +0 -1
  73. package/src/ai.ts +0 -266
  74. package/src/commands/init-framework.ts +0 -414
  75. package/src/mcp/bin.ts +0 -36
  76. package/src/migrate/bin.ts +0 -114
  77. package/src/theme/index.ts +0 -77
  78. package/src/viewer/__tests__/a11y-fixes.test.ts +0 -358
  79. package/src/viewer/__tests__/jsx-parser.test.ts +0 -502
  80. package/src/viewer/__tests__/render-utils.test.ts +0 -232
  81. package/src/viewer/__tests__/style-utils.test.ts +0 -404
  82. package/src/viewer/assets/fragments-logo.ts +0 -4
  83. package/src/viewer/assets/fragments_logo.png +0 -0
  84. package/src/viewer/bin.ts +0 -86
  85. package/src/viewer/cli/health.ts +0 -256
  86. package/src/viewer/cli/index.ts +0 -33
  87. package/src/viewer/cli/scan.ts +0 -124
  88. package/src/viewer/cli/utils.ts +0 -174
  89. package/src/viewer/components/AccessibilityPanel.tsx +0 -1457
  90. package/src/viewer/components/ActionCapture.tsx +0 -172
  91. package/src/viewer/components/ActionsPanel.tsx +0 -332
  92. package/src/viewer/components/AllVariantsPreview.tsx +0 -78
  93. package/src/viewer/components/App.tsx +0 -582
  94. package/src/viewer/components/BottomPanel.tsx +0 -288
  95. package/src/viewer/components/CodePanel.naming.test.tsx +0 -59
  96. package/src/viewer/components/CodePanel.tsx +0 -118
  97. package/src/viewer/components/CommandPalette.tsx +0 -392
  98. package/src/viewer/components/ComponentDocView.tsx +0 -164
  99. package/src/viewer/components/ComponentGraph.tsx +0 -380
  100. package/src/viewer/components/ComponentHeader.tsx +0 -88
  101. package/src/viewer/components/ContractPanel.tsx +0 -241
  102. package/src/viewer/components/EmptyVariantMessage.tsx +0 -54
  103. package/src/viewer/components/ErrorBoundary.tsx +0 -97
  104. package/src/viewer/components/FigmaEmbed.tsx +0 -238
  105. package/src/viewer/components/FragmentEditor.tsx +0 -525
  106. package/src/viewer/components/FragmentRenderer.tsx +0 -61
  107. package/src/viewer/components/HeaderSearch.tsx +0 -24
  108. package/src/viewer/components/HealthDashboard.tsx +0 -441
  109. package/src/viewer/components/HmrStatusIndicator.tsx +0 -61
  110. package/src/viewer/components/Icons.tsx +0 -479
  111. package/src/viewer/components/InteractionsPanel.tsx +0 -757
  112. package/src/viewer/components/IsolatedPreviewFrame.tsx +0 -346
  113. package/src/viewer/components/IsolatedRender.tsx +0 -113
  114. package/src/viewer/components/KeyboardShortcutsHelp.tsx +0 -53
  115. package/src/viewer/components/LandingPage.tsx +0 -421
  116. package/src/viewer/components/Layout.tsx +0 -27
  117. package/src/viewer/components/LeftSidebar.tsx +0 -472
  118. package/src/viewer/components/LoadErrorMessage.tsx +0 -102
  119. package/src/viewer/components/MultiViewportPreview.tsx +0 -522
  120. package/src/viewer/components/NoVariantsMessage.tsx +0 -59
  121. package/src/viewer/components/PanelShell.tsx +0 -161
  122. package/src/viewer/components/PerformancePanel.tsx +0 -304
  123. package/src/viewer/components/PreviewArea.tsx +0 -472
  124. package/src/viewer/components/PreviewAside.tsx +0 -168
  125. package/src/viewer/components/PreviewFrameHost.tsx +0 -303
  126. package/src/viewer/components/PreviewPane.tsx +0 -149
  127. package/src/viewer/components/PreviewToolbar.tsx +0 -80
  128. package/src/viewer/components/PropsEditor.tsx +0 -506
  129. package/src/viewer/components/PropsTable.tsx +0 -111
  130. package/src/viewer/components/RelationsSection.tsx +0 -88
  131. package/src/viewer/components/ResizablePanel.tsx +0 -271
  132. package/src/viewer/components/RightSidebar.tsx +0 -102
  133. package/src/viewer/components/RuntimeToolsRegistrar.tsx +0 -17
  134. package/src/viewer/components/ScreenshotButton.tsx +0 -90
  135. package/src/viewer/components/Sidebar.tsx +0 -169
  136. package/src/viewer/components/SkeletonLoader.tsx +0 -161
  137. package/src/viewer/components/ThemeProvider.tsx +0 -42
  138. package/src/viewer/components/Toast.tsx +0 -3
  139. package/src/viewer/components/TokenStylePanel.tsx +0 -699
  140. package/src/viewer/components/TopToolbar.tsx +0 -159
  141. package/src/viewer/components/UsageSection.tsx +0 -95
  142. package/src/viewer/components/VariantMatrix.tsx +0 -388
  143. package/src/viewer/components/VariantRenderer.tsx +0 -131
  144. package/src/viewer/components/VariantTabs.tsx +0 -40
  145. package/src/viewer/components/ViewerHeader.tsx +0 -69
  146. package/src/viewer/components/ViewerStateSync.tsx +0 -52
  147. package/src/viewer/components/ViewportSelector.tsx +0 -172
  148. package/src/viewer/components/WebMCPDevTools.tsx +0 -503
  149. package/src/viewer/components/WebMCPIntegration.tsx +0 -47
  150. package/src/viewer/components/WebMCPStatusIndicator.tsx +0 -60
  151. package/src/viewer/components/_future/CreatePage.tsx +0 -836
  152. package/src/viewer/components/viewer-utils.ts +0 -16
  153. package/src/viewer/composition-renderer.ts +0 -381
  154. package/src/viewer/constants/index.ts +0 -1
  155. package/src/viewer/constants/ui.ts +0 -166
  156. package/src/viewer/entry.tsx +0 -335
  157. package/src/viewer/hooks/index.ts +0 -2
  158. package/src/viewer/hooks/useA11yCache.ts +0 -383
  159. package/src/viewer/hooks/useA11yService.ts +0 -364
  160. package/src/viewer/hooks/useActions.ts +0 -138
  161. package/src/viewer/hooks/useAppState.ts +0 -147
  162. package/src/viewer/hooks/useCompiledFragments.ts +0 -42
  163. package/src/viewer/hooks/useFigmaIntegration.ts +0 -132
  164. package/src/viewer/hooks/useHmrStatus.ts +0 -109
  165. package/src/viewer/hooks/useKeyboardShortcuts.ts +0 -270
  166. package/src/viewer/hooks/usePreviewBridge.ts +0 -347
  167. package/src/viewer/hooks/useScrollSpy.ts +0 -78
  168. package/src/viewer/hooks/useUrlState.ts +0 -318
  169. package/src/viewer/hooks/useViewSettings.ts +0 -111
  170. package/src/viewer/index.html +0 -28
  171. package/src/viewer/intelligence/healthReport.ts +0 -505
  172. package/src/viewer/intelligence/styleDrift.ts +0 -340
  173. package/src/viewer/intelligence/usageScanner.ts +0 -309
  174. package/src/viewer/jsx-parser.ts +0 -486
  175. package/src/viewer/preview-frame-entry.tsx +0 -25
  176. package/src/viewer/preview-frame.html +0 -125
  177. package/src/viewer/public/favicon.ico +0 -0
  178. package/src/viewer/render-template.html +0 -68
  179. package/src/viewer/styles/globals.css +0 -278
  180. package/src/viewer/types/a11y.ts +0 -197
  181. package/src/viewer/utils/a11y-fixes.ts +0 -509
  182. package/src/viewer/utils/actionExport.ts +0 -372
  183. package/src/viewer/utils/colorSchemes.ts +0 -201
  184. package/src/viewer/utils/detectRelationships.ts +0 -256
  185. package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss +0 -10
  186. package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss.d.ts +0 -2
  187. package/src/viewer/vendor/shared/src/ComponentDocContent.tsx +0 -274
  188. package/src/viewer/vendor/shared/src/DocsHeaderBar.tsx +0 -129
  189. package/src/viewer/vendor/shared/src/DocsPageAsideHost.tsx +0 -89
  190. package/src/viewer/vendor/shared/src/DocsPageShell.tsx +0 -124
  191. package/src/viewer/vendor/shared/src/DocsSearchCommand.tsx +0 -99
  192. package/src/viewer/vendor/shared/src/DocsSidebarNav.tsx +0 -66
  193. package/src/viewer/vendor/shared/src/PropsTable.module.scss +0 -68
  194. package/src/viewer/vendor/shared/src/PropsTable.module.scss.d.ts +0 -2
  195. package/src/viewer/vendor/shared/src/PropsTable.tsx +0 -76
  196. package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss +0 -114
  197. package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss.d.ts +0 -2
  198. package/src/viewer/vendor/shared/src/VariantPreviewCard.tsx +0 -137
  199. package/src/viewer/vendor/shared/src/docs-data/index.ts +0 -32
  200. package/src/viewer/vendor/shared/src/docs-data/mcp-configs.ts +0 -72
  201. package/src/viewer/vendor/shared/src/docs-data/palettes.ts +0 -75
  202. package/src/viewer/vendor/shared/src/docs-data/setup-examples.ts +0 -55
  203. package/src/viewer/vendor/shared/src/docs-layout.scss +0 -28
  204. package/src/viewer/vendor/shared/src/docs-layout.scss.d.ts +0 -2
  205. package/src/viewer/vendor/shared/src/index.ts +0 -34
  206. package/src/viewer/vendor/shared/src/types.ts +0 -53
  207. package/src/viewer/webmcp/__tests__/analytics.test.ts +0 -108
  208. package/src/viewer/webmcp/analytics.ts +0 -165
  209. package/src/viewer/webmcp/index.ts +0 -3
  210. package/src/viewer/webmcp/posthog-bridge.ts +0 -39
  211. package/src/viewer/webmcp/runtime-tools.ts +0 -152
  212. package/src/viewer/webmcp/scan-utils.ts +0 -135
  213. package/src/viewer/webmcp/use-tool-analytics.ts +0 -69
  214. package/src/viewer/webmcp/viewer-state.ts +0 -45
  215. /package/dist/{discovery-NEOY4MPN.js.map → ai-client-I6MDWNYA.js.map} +0 -0
  216. /package/dist/{chunk-PW7QTQA6.js.map → chunk-4OC7FTJB.js.map} +0 -0
  217. /package/dist/{chunk-HRFUSSZI.js.map → chunk-AM4MRTMN.js.map} +0 -0
  218. /package/dist/{scan-CJF2DOQW.js.map → discovery-ZJQSXF56.js.map} +0 -0
  219. /package/dist/{generate-FBHSXR3D.js.map → generate-RJFS2JWA.js.map} +0 -0
  220. /package/dist/{service-TQYWY65E.js.map → scan-3PMCJ4RB.js.map} +0 -0
  221. /package/dist/{static-viewer-NUBFPKWH.js.map → service-VMGNJZ42.js.map} +0 -0
  222. /package/dist/{test-Z5LVO724.js.map → test-SI4NSHQX.js.map} +0 -0
  223. /package/dist/{tokens-CE46OTMD.js.map → tokens-T6SIVUT5.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
- });