@fragments-sdk/cli 0.10.1 → 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 (149) hide show
  1. package/dist/bin.js +20 -2
  2. package/dist/bin.js.map +1 -1
  3. package/dist/{init-NDQXUWDU.js → init-UFGK5TCN.js} +75 -4
  4. package/dist/init-UFGK5TCN.js.map +1 -0
  5. package/dist/snapshot-SV2JOFZH.js +139 -0
  6. package/dist/snapshot-SV2JOFZH.js.map +1 -0
  7. package/dist/{viewer-DNMNC5VS.js → viewer-DLLJIMCK.js} +68 -46
  8. package/dist/viewer-DLLJIMCK.js.map +1 -0
  9. package/package.json +6 -14
  10. package/src/bin.ts +30 -0
  11. package/src/commands/init.ts +76 -1
  12. package/src/commands/snapshot.ts +197 -0
  13. package/src/viewer/__tests__/viewer-integration.test.ts +85 -74
  14. package/src/viewer/server.ts +37 -22
  15. package/src/viewer/vite-plugin.ts +25 -9
  16. package/dist/init-NDQXUWDU.js.map +0 -1
  17. package/dist/viewer-DNMNC5VS.js.map +0 -1
  18. package/src/viewer/__tests__/a11y-fixes.test.ts +0 -358
  19. package/src/viewer/__tests__/jsx-parser.test.ts +0 -502
  20. package/src/viewer/__tests__/render-utils.test.ts +0 -232
  21. package/src/viewer/__tests__/style-utils.test.ts +0 -404
  22. package/src/viewer/assets/fragments-logo.ts +0 -4
  23. package/src/viewer/assets/fragments_logo.png +0 -0
  24. package/src/viewer/components/AccessibilityPanel.tsx +0 -1457
  25. package/src/viewer/components/ActionCapture.tsx +0 -172
  26. package/src/viewer/components/ActionsPanel.tsx +0 -332
  27. package/src/viewer/components/AllVariantsPreview.tsx +0 -78
  28. package/src/viewer/components/App.tsx +0 -582
  29. package/src/viewer/components/BottomPanel.tsx +0 -288
  30. package/src/viewer/components/CodePanel.naming.test.tsx +0 -59
  31. package/src/viewer/components/CodePanel.tsx +0 -118
  32. package/src/viewer/components/CommandPalette.tsx +0 -392
  33. package/src/viewer/components/ComponentDocView.tsx +0 -164
  34. package/src/viewer/components/ComponentGraph.tsx +0 -380
  35. package/src/viewer/components/ComponentHeader.tsx +0 -88
  36. package/src/viewer/components/ContractPanel.tsx +0 -241
  37. package/src/viewer/components/EmptyVariantMessage.tsx +0 -54
  38. package/src/viewer/components/ErrorBoundary.tsx +0 -97
  39. package/src/viewer/components/FigmaEmbed.tsx +0 -238
  40. package/src/viewer/components/FragmentEditor.tsx +0 -525
  41. package/src/viewer/components/FragmentRenderer.tsx +0 -61
  42. package/src/viewer/components/HeaderSearch.tsx +0 -24
  43. package/src/viewer/components/HealthDashboard.tsx +0 -441
  44. package/src/viewer/components/HmrStatusIndicator.tsx +0 -61
  45. package/src/viewer/components/Icons.tsx +0 -479
  46. package/src/viewer/components/InteractionsPanel.tsx +0 -757
  47. package/src/viewer/components/IsolatedPreviewFrame.tsx +0 -346
  48. package/src/viewer/components/IsolatedRender.tsx +0 -113
  49. package/src/viewer/components/KeyboardShortcutsHelp.tsx +0 -53
  50. package/src/viewer/components/LandingPage.tsx +0 -421
  51. package/src/viewer/components/Layout.tsx +0 -27
  52. package/src/viewer/components/LeftSidebar.tsx +0 -472
  53. package/src/viewer/components/LoadErrorMessage.tsx +0 -102
  54. package/src/viewer/components/MultiViewportPreview.tsx +0 -522
  55. package/src/viewer/components/NoVariantsMessage.tsx +0 -59
  56. package/src/viewer/components/PanelShell.tsx +0 -161
  57. package/src/viewer/components/PerformancePanel.tsx +0 -304
  58. package/src/viewer/components/PreviewArea.tsx +0 -472
  59. package/src/viewer/components/PreviewAside.tsx +0 -168
  60. package/src/viewer/components/PreviewFrameHost.tsx +0 -303
  61. package/src/viewer/components/PreviewPane.tsx +0 -149
  62. package/src/viewer/components/PreviewToolbar.tsx +0 -80
  63. package/src/viewer/components/PropsEditor.tsx +0 -506
  64. package/src/viewer/components/PropsTable.tsx +0 -111
  65. package/src/viewer/components/RelationsSection.tsx +0 -88
  66. package/src/viewer/components/ResizablePanel.tsx +0 -271
  67. package/src/viewer/components/RightSidebar.tsx +0 -102
  68. package/src/viewer/components/RuntimeToolsRegistrar.tsx +0 -17
  69. package/src/viewer/components/ScreenshotButton.tsx +0 -90
  70. package/src/viewer/components/Sidebar.tsx +0 -169
  71. package/src/viewer/components/SkeletonLoader.tsx +0 -161
  72. package/src/viewer/components/ThemeProvider.tsx +0 -42
  73. package/src/viewer/components/Toast.tsx +0 -3
  74. package/src/viewer/components/TokenStylePanel.tsx +0 -699
  75. package/src/viewer/components/TopToolbar.tsx +0 -159
  76. package/src/viewer/components/UsageSection.tsx +0 -95
  77. package/src/viewer/components/VariantMatrix.tsx +0 -388
  78. package/src/viewer/components/VariantRenderer.tsx +0 -131
  79. package/src/viewer/components/VariantTabs.tsx +0 -40
  80. package/src/viewer/components/ViewerHeader.tsx +0 -69
  81. package/src/viewer/components/ViewerStateSync.tsx +0 -52
  82. package/src/viewer/components/ViewportSelector.tsx +0 -172
  83. package/src/viewer/components/WebMCPDevTools.tsx +0 -503
  84. package/src/viewer/components/WebMCPIntegration.tsx +0 -47
  85. package/src/viewer/components/WebMCPStatusIndicator.tsx +0 -60
  86. package/src/viewer/components/_future/CreatePage.tsx +0 -836
  87. package/src/viewer/components/viewer-utils.ts +0 -16
  88. package/src/viewer/composition-renderer.ts +0 -381
  89. package/src/viewer/constants/index.ts +0 -1
  90. package/src/viewer/constants/ui.ts +0 -166
  91. package/src/viewer/entry.tsx +0 -335
  92. package/src/viewer/hooks/index.ts +0 -2
  93. package/src/viewer/hooks/useA11yCache.ts +0 -383
  94. package/src/viewer/hooks/useA11yService.ts +0 -364
  95. package/src/viewer/hooks/useActions.ts +0 -138
  96. package/src/viewer/hooks/useAppState.ts +0 -147
  97. package/src/viewer/hooks/useCompiledFragments.ts +0 -42
  98. package/src/viewer/hooks/useFigmaIntegration.ts +0 -132
  99. package/src/viewer/hooks/useHmrStatus.ts +0 -109
  100. package/src/viewer/hooks/useKeyboardShortcuts.ts +0 -270
  101. package/src/viewer/hooks/usePreviewBridge.ts +0 -347
  102. package/src/viewer/hooks/useScrollSpy.ts +0 -78
  103. package/src/viewer/hooks/useUrlState.ts +0 -318
  104. package/src/viewer/hooks/useViewSettings.ts +0 -111
  105. package/src/viewer/index.html +0 -28
  106. package/src/viewer/intelligence/healthReport.ts +0 -505
  107. package/src/viewer/intelligence/styleDrift.ts +0 -340
  108. package/src/viewer/intelligence/usageScanner.ts +0 -309
  109. package/src/viewer/jsx-parser.ts +0 -486
  110. package/src/viewer/preview-frame-entry.tsx +0 -25
  111. package/src/viewer/preview-frame.html +0 -125
  112. package/src/viewer/public/favicon.ico +0 -0
  113. package/src/viewer/render-template.html +0 -68
  114. package/src/viewer/styles/globals.css +0 -278
  115. package/src/viewer/types/a11y.ts +0 -197
  116. package/src/viewer/utils/a11y-fixes.ts +0 -509
  117. package/src/viewer/utils/actionExport.ts +0 -372
  118. package/src/viewer/utils/colorSchemes.ts +0 -201
  119. package/src/viewer/utils/detectRelationships.ts +0 -256
  120. package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss +0 -10
  121. package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss.d.ts +0 -2
  122. package/src/viewer/vendor/shared/src/ComponentDocContent.tsx +0 -274
  123. package/src/viewer/vendor/shared/src/DocsHeaderBar.tsx +0 -129
  124. package/src/viewer/vendor/shared/src/DocsPageAsideHost.tsx +0 -89
  125. package/src/viewer/vendor/shared/src/DocsPageShell.tsx +0 -124
  126. package/src/viewer/vendor/shared/src/DocsSearchCommand.tsx +0 -99
  127. package/src/viewer/vendor/shared/src/DocsSidebarNav.tsx +0 -66
  128. package/src/viewer/vendor/shared/src/PropsTable.module.scss +0 -68
  129. package/src/viewer/vendor/shared/src/PropsTable.module.scss.d.ts +0 -2
  130. package/src/viewer/vendor/shared/src/PropsTable.tsx +0 -76
  131. package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss +0 -114
  132. package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss.d.ts +0 -2
  133. package/src/viewer/vendor/shared/src/VariantPreviewCard.tsx +0 -137
  134. package/src/viewer/vendor/shared/src/docs-data/index.ts +0 -32
  135. package/src/viewer/vendor/shared/src/docs-data/mcp-configs.ts +0 -72
  136. package/src/viewer/vendor/shared/src/docs-data/palettes.ts +0 -75
  137. package/src/viewer/vendor/shared/src/docs-data/setup-examples.ts +0 -55
  138. package/src/viewer/vendor/shared/src/docs-layout.scss +0 -28
  139. package/src/viewer/vendor/shared/src/docs-layout.scss.d.ts +0 -2
  140. package/src/viewer/vendor/shared/src/index.ts +0 -34
  141. package/src/viewer/vendor/shared/src/types.ts +0 -53
  142. package/src/viewer/webmcp/__tests__/analytics.test.ts +0 -108
  143. package/src/viewer/webmcp/analytics.ts +0 -165
  144. package/src/viewer/webmcp/index.ts +0 -3
  145. package/src/viewer/webmcp/posthog-bridge.ts +0 -39
  146. package/src/viewer/webmcp/runtime-tools.ts +0 -152
  147. package/src/viewer/webmcp/scan-utils.ts +0 -135
  148. package/src/viewer/webmcp/use-tool-analytics.ts +0 -69
  149. package/src/viewer/webmcp/viewer-state.ts +0 -45
@@ -1,335 +0,0 @@
1
- import { createRoot, type Root } from "react-dom/client";
2
- import { Component, type ReactNode, type ErrorInfo } from "react";
3
- import { App } from "./components/App.js";
4
- import { ThemeProvider } from "./components/ThemeProvider.js";
5
- import { ToastProvider } from "./components/Toast.js";
6
- import { AppSkeleton } from "./components/SkeletonLoader.js";
7
- import { WebMCPIntegration } from "./components/WebMCPIntegration.js";
8
- // Fragments UI globals - base resets (box-sizing, body, scrollbars) + --fui-* CSS variables
9
- import "@fragments-sdk/ui";
10
- // Viewer-specific token aliases and utility classes
11
- import "./styles/globals.css";
12
-
13
- // App-level error boundary that catches any unhandled errors
14
- class AppErrorBoundary extends Component<{ children: ReactNode }, { hasError: boolean; error: Error | null; errorInfo: ErrorInfo | null }> {
15
- constructor(props: { children: ReactNode }) {
16
- super(props);
17
- this.state = { hasError: false, error: null, errorInfo: null };
18
- }
19
-
20
- static getDerivedStateFromError(error: Error) {
21
- return { hasError: true, error };
22
- }
23
-
24
- componentDidCatch(error: Error, errorInfo: ErrorInfo) {
25
- console.error('[Fragments] App Error:', error);
26
- console.error('[Fragments] Component Stack:', errorInfo.componentStack);
27
- this.setState({ errorInfo });
28
- }
29
-
30
- handleRetry = () => {
31
- this.setState({ hasError: false, error: null, errorInfo: null });
32
- window.location.reload();
33
- };
34
-
35
- render() {
36
- if (this.state.hasError) {
37
- const { error, errorInfo } = this.state;
38
- return (
39
- <div style={{
40
- fontFamily: 'system-ui, -apple-system, sans-serif',
41
- padding: '40px',
42
- maxWidth: '800px',
43
- margin: '0 auto',
44
- }}>
45
- <div style={{
46
- background: '#fef2f2',
47
- border: '1px solid #fecaca',
48
- borderRadius: '12px',
49
- padding: '24px',
50
- }}>
51
- <h1 style={{ color: '#dc2626', marginBottom: '16px', fontSize: '20px', fontWeight: 600 }}>
52
- Application Error
53
- </h1>
54
- <p style={{ color: '#991b1b', marginBottom: '16px', fontSize: '14px' }}>
55
- An error occurred while rendering the application:
56
- </p>
57
- <pre style={{
58
- background: '#fee2e2',
59
- border: '1px solid #fecaca',
60
- borderRadius: '8px',
61
- padding: '16px',
62
- overflow: 'auto',
63
- whiteSpace: 'pre-wrap',
64
- wordBreak: 'break-word',
65
- color: '#991b1b',
66
- fontSize: '13px',
67
- fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace',
68
- marginBottom: '16px',
69
- }}>
70
- {error?.message || 'Unknown error'}
71
- </pre>
72
- {errorInfo?.componentStack && (
73
- <details style={{ marginBottom: '16px' }}>
74
- <summary style={{
75
- color: '#b91c1c',
76
- cursor: 'pointer',
77
- fontSize: '13px',
78
- marginBottom: '8px',
79
- }}>
80
- Show component stack trace
81
- </summary>
82
- <pre style={{
83
- background: '#fee2e2',
84
- border: '1px solid #fecaca',
85
- borderRadius: '8px',
86
- padding: '12px',
87
- overflow: 'auto',
88
- whiteSpace: 'pre-wrap',
89
- wordBreak: 'break-word',
90
- color: '#7f1d1d',
91
- fontSize: '11px',
92
- fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace',
93
- maxHeight: '300px',
94
- }}>
95
- {error?.stack || errorInfo.componentStack}
96
- </pre>
97
- </details>
98
- )}
99
- <button
100
- onClick={this.handleRetry}
101
- style={{
102
- background: '#dc2626',
103
- color: 'white',
104
- border: 'none',
105
- borderRadius: '6px',
106
- padding: '10px 16px',
107
- fontSize: '14px',
108
- fontWeight: 500,
109
- cursor: 'pointer',
110
- }}
111
- >
112
- Reload Application
113
- </button>
114
- </div>
115
- <p style={{ marginTop: '16px', color: '#6b7280', fontSize: '13px' }}>
116
- Check the browser console for more details. Common causes:
117
- </p>
118
- <ul style={{ color: '#6b7280', marginTop: '8px', paddingLeft: '20px', fontSize: '13px' }}>
119
- <li>Syntax errors in fragment or component files</li>
120
- <li>Missing or undefined imports</li>
121
- <li>Components that crash during render</li>
122
- <li>Invalid props passed to components</li>
123
- </ul>
124
- </div>
125
- );
126
- }
127
-
128
- return this.props.children;
129
- }
130
- }
131
-
132
- // Declare global types
133
- declare global {
134
- interface Window {
135
- __FRAGMENTS__?: Array<{
136
- path: string;
137
- fragment: import("../core/index.js").FragmentDefinition;
138
- }>;
139
- __FRAGMENTS_CONFIG__?: import("../core/index.js").FragmentsConfig;
140
- __FRAGMENTS_PACKAGE_NAME__?: string | null;
141
- __FRAGMENTS_ERROR__?: string;
142
- }
143
- }
144
-
145
- type FragmentItem = {
146
- path: string;
147
- fragment: import("../core/index.js").FragmentDefinition;
148
- };
149
-
150
- // Initialize fragments from window or empty array
151
- let fragments: FragmentItem[] = window.__FRAGMENTS__ ?? [];
152
- let loadError: string | null = window.__FRAGMENTS_ERROR__ ?? null;
153
- let appRoot: Root | null = null;
154
- const SKELETON_DELAY_MS = 120;
155
- const MIN_SKELETON_DISPLAY_MS = 220;
156
-
157
- // Filter helper
158
- function filterValidFragments(items: FragmentItem[]): FragmentItem[] {
159
- return items.filter(s => s && s.fragment && s.fragment.meta);
160
- }
161
-
162
- // Async loader for virtual module (runs after initial render)
163
- async function loadFragmentsFromVirtualModule(): Promise<void> {
164
- if (fragments.length > 0 || loadError) {
165
- // Already have fragments or error from window
166
- return;
167
- }
168
-
169
- try {
170
- // @ts-expect-error Virtual module
171
- const virtualModule = await import("virtual:fragments");
172
- // Wait for lazy-loaded fragments
173
- if (virtualModule.fragmentsPromise) {
174
- fragments = await virtualModule.fragmentsPromise;
175
- } else {
176
- fragments = virtualModule.fragments;
177
- }
178
- fragments = filterValidFragments(fragments);
179
- // Store consumer package name for import path display
180
- if (virtualModule.projectPackageName) {
181
- window.__FRAGMENTS_PACKAGE_NAME__ = virtualModule.projectPackageName;
182
- }
183
- } catch (e) {
184
- const error = e as Error;
185
- loadError = error.message || "Failed to load fragments";
186
- console.error("[Fragments] Failed to load:", error);
187
- }
188
- }
189
-
190
- // Filter initial fragments
191
- fragments = filterValidFragments(fragments);
192
-
193
- // Error display component
194
- function ErrorDisplay({ error }: { error: string }) {
195
- return (
196
- <div style={{
197
- fontFamily: 'system-ui, -apple-system, sans-serif',
198
- padding: '40px',
199
- maxWidth: '600px',
200
- margin: '0 auto',
201
- }}>
202
- <h1 style={{ color: '#dc2626', marginBottom: '16px' }}>
203
- Failed to Load Fragments
204
- </h1>
205
- <pre style={{
206
- background: '#fef2f2',
207
- border: '1px solid #fecaca',
208
- borderRadius: '8px',
209
- padding: '16px',
210
- overflow: 'auto',
211
- whiteSpace: 'pre-wrap',
212
- wordBreak: 'break-word',
213
- color: '#991b1b',
214
- fontSize: '14px',
215
- }}>
216
- {error}
217
- </pre>
218
- <p style={{ marginTop: '16px', color: '#6b7280' }}>
219
- Check the console for more details. Common issues:
220
- </p>
221
- <ul style={{ color: '#6b7280', marginTop: '8px', paddingLeft: '20px' }}>
222
- <li>Fragment files have syntax errors</li>
223
- <li>Components are not exported correctly</li>
224
- <li>Missing dependencies</li>
225
- </ul>
226
- </div>
227
- );
228
- }
229
-
230
- // Render the app
231
- const rootElement = document.getElementById("root");
232
- if (rootElement) {
233
- appRoot = createRoot(rootElement);
234
-
235
- const renderApp = (showSkeleton = false) => {
236
- const currentFragments = window.__FRAGMENTS__ ?? fragments;
237
- const currentError = loadError || window.__FRAGMENTS_ERROR__;
238
-
239
- // Show skeleton while loading
240
- if (showSkeleton && currentFragments.length === 0 && !currentError) {
241
- appRoot?.render(
242
- <ThemeProvider>
243
- <AppSkeleton />
244
- </ThemeProvider>
245
- );
246
- return;
247
- }
248
-
249
- // Show error if we have one and no valid fragments
250
- if (currentError && currentFragments.length === 0) {
251
- appRoot?.render(<ErrorDisplay error={currentError} />);
252
- return;
253
- }
254
-
255
- appRoot?.render(
256
- <ThemeProvider>
257
- <ToastProvider position="bottom-right" duration={3000}>
258
- <WebMCPIntegration>
259
- <AppErrorBoundary>
260
- <App fragments={currentFragments} />
261
- </AppErrorBoundary>
262
- </WebMCPIntegration>
263
- </ToastProvider>
264
- </ThemeProvider>
265
- );
266
- };
267
-
268
- // Show skeleton immediately if no fragments yet
269
- if (fragments.length === 0 && !loadError) {
270
- const loadStartedAt = Date.now();
271
- let skeletonShown = false;
272
-
273
- const skeletonTimer = setTimeout(() => {
274
- skeletonShown = true;
275
- renderApp(true);
276
- }, SKELETON_DELAY_MS);
277
-
278
- // Load fragments asynchronously and re-render
279
- loadFragmentsFromVirtualModule().then(() => {
280
- clearTimeout(skeletonTimer);
281
-
282
- if (!skeletonShown) {
283
- renderApp(false);
284
- return;
285
- }
286
-
287
- const elapsed = Date.now() - loadStartedAt;
288
- const remaining = Math.max(MIN_SKELETON_DISPLAY_MS - elapsed, 0);
289
- if (remaining === 0) {
290
- renderApp(false);
291
- return;
292
- }
293
-
294
- setTimeout(() => {
295
- renderApp(false);
296
- }, remaining);
297
- });
298
- } else {
299
- // We have fragments from window, render immediately
300
- renderApp(false);
301
- }
302
-
303
- // Listen for HMR updates from Fragments plugin
304
- window.addEventListener("fragments:update", () => {
305
- console.log("[Fragments] Refreshing viewer...");
306
- // Re-render with updated fragments
307
- renderApp(false);
308
- });
309
- }
310
-
311
- // HMR support for entry file and a11y invalidation
312
- // @ts-expect-error Vite HMR types
313
- if (import.meta.hot) {
314
- // @ts-expect-error Vite HMR types
315
- import.meta.hot.accept();
316
-
317
- // Subscribe to a11y invalidation events from Vite plugin
318
- // @ts-expect-error Vite HMR types
319
- import.meta.hot.on("fragments:a11y-invalidate", (data: {
320
- components: string[];
321
- file: string;
322
- timestamp: number;
323
- }) => {
324
- console.log("[Fragments] A11y invalidation triggered for:", data.components.join(", "));
325
-
326
- // Dispatch custom event for a11y service to handle
327
- window.dispatchEvent(new CustomEvent("a11y-cache-invalidated", {
328
- detail: {
329
- components: data.components,
330
- file: data.file,
331
- timestamp: data.timestamp,
332
- },
333
- }));
334
- });
335
- }
@@ -1,2 +0,0 @@
1
- export * from './useHmrStatus.js';
2
- export * from './usePreviewBridge.js';