@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,699 +0,0 @@
1
- /**
2
- * Token-Aware Style Comparison Panel
3
- *
4
- * Enhanced style comparison that shows:
5
- * - Property, Figma value, Rendered value, Match status
6
- * - Token names when values match design tokens
7
- * - Hardcoded value warnings
8
- * - Fix suggestions that can be copied
9
- */
10
-
11
- import { useState, useEffect, useCallback } from "react";
12
- import { Badge, Stack, Text, Button, Box } from "@fragments-sdk/ui";
13
- import type { DesignToken, EnhancedStyleDiffItem, TokenUsageSummary } from "../../core/index.js";
14
- import { Palette } from "@phosphor-icons/react";
15
- import { CheckIcon, XIcon, LoadingIcon, FigmaIcon, WandIcon } from "./Icons.js";
16
- import { PanelShell } from "./PanelShell.js";
17
-
18
- // Alias for semantic clarity
19
- const SyncingIcon = LoadingIcon;
20
-
21
- /**
22
- * Maps CSS properties to expected token categories
23
- * This prevents false positives like "height: 49px" matching "--top-bar-height"
24
- */
25
- const PROPERTY_CATEGORY_MAP: Record<string, string[]> = {
26
- // Color properties
27
- color: ["color"],
28
- backgroundColor: ["color"],
29
- borderColor: ["color", "border"],
30
- borderTopColor: ["color", "border"],
31
- borderRightColor: ["color", "border"],
32
- borderBottomColor: ["color", "border"],
33
- borderLeftColor: ["color", "border"],
34
- outlineColor: ["color"],
35
- fill: ["color"],
36
- stroke: ["color"],
37
- caretColor: ["color"],
38
- textDecorationColor: ["color"],
39
- boxShadow: ["shadow", "color"],
40
-
41
- // Spacing properties
42
- margin: ["spacing"],
43
- marginTop: ["spacing"],
44
- marginRight: ["spacing"],
45
- marginBottom: ["spacing"],
46
- marginLeft: ["spacing"],
47
- padding: ["spacing"],
48
- paddingTop: ["spacing"],
49
- paddingRight: ["spacing"],
50
- paddingBottom: ["spacing"],
51
- paddingLeft: ["spacing"],
52
- gap: ["spacing"],
53
- rowGap: ["spacing"],
54
- columnGap: ["spacing"],
55
-
56
- // Sizing properties (NOT spacing - heights shouldn't match spacing tokens)
57
- width: ["sizing"],
58
- height: ["sizing"],
59
- minWidth: ["sizing"],
60
- minHeight: ["sizing"],
61
- maxWidth: ["sizing"],
62
- maxHeight: ["sizing"],
63
-
64
- // Border radius
65
- borderRadius: ["radius"],
66
- borderTopLeftRadius: ["radius"],
67
- borderTopRightRadius: ["radius"],
68
- borderBottomLeftRadius: ["radius"],
69
- borderBottomRightRadius: ["radius"],
70
-
71
- // Typography
72
- fontSize: ["typography"],
73
- fontWeight: ["typography"],
74
- lineHeight: ["typography"],
75
- letterSpacing: ["typography"],
76
- fontFamily: ["typography"],
77
-
78
- // Border
79
- borderWidth: ["border"],
80
- borderTopWidth: ["border"],
81
- borderRightWidth: ["border"],
82
- borderBottomWidth: ["border"],
83
- borderLeftWidth: ["border"],
84
-
85
- // Z-index
86
- zIndex: ["z-index"],
87
-
88
- // Animation
89
- transitionDuration: ["animation"],
90
- animationDuration: ["animation"],
91
- transitionDelay: ["animation"],
92
- animationDelay: ["animation"],
93
- };
94
-
95
- /**
96
- * Get expected token categories for a CSS property
97
- */
98
- function getExpectedCategories(property: string): string[] | null {
99
- return PROPERTY_CATEGORY_MAP[property] || null;
100
- }
101
-
102
- interface TokenStylePanelProps {
103
- figmaUrl: string;
104
- figmaStyles: Record<string, string> | null;
105
- renderedStyles: Record<string, string> | null;
106
- figmaLoading: boolean;
107
- figmaError?: string;
108
- onFetchFigma: () => void;
109
- onRefreshRendered: () => void;
110
- }
111
-
112
- interface TokenData {
113
- tokens: DesignToken[];
114
- meta?: {
115
- totalTokens: number;
116
- parseTimeMs: number;
117
- };
118
- }
119
-
120
- // Module-level cache for tokens to avoid refetching on tab switches
121
- let cachedTokenData: TokenData | null = null;
122
- let cachedTokenError: string | null = null;
123
- let tokenFetchPromise: Promise<void> | null = null;
124
-
125
- export function TokenStylePanel({
126
- figmaUrl,
127
- figmaStyles,
128
- renderedStyles,
129
- figmaLoading,
130
- figmaError,
131
- onFetchFigma,
132
- onRefreshRendered,
133
- }: TokenStylePanelProps) {
134
- const [tokenData, setTokenData] = useState<TokenData | null>(null);
135
- const [tokenError, setTokenError] = useState<string | null>(null);
136
- const [tokenLoading, setTokenLoading] = useState(false);
137
- const [copiedFix, setCopiedFix] = useState<string | null>(null);
138
-
139
- // Fetch tokens on mount (with module-level caching)
140
- useEffect(() => {
141
- // Use cached data if available
142
- if (cachedTokenData) {
143
- setTokenData(cachedTokenData);
144
- setTokenLoading(false);
145
- return;
146
- }
147
- if (cachedTokenError) {
148
- setTokenError(cachedTokenError);
149
- setTokenLoading(false);
150
- return;
151
- }
152
-
153
- // If a fetch is already in progress, wait for it
154
- if (tokenFetchPromise) {
155
- setTokenLoading(true);
156
- tokenFetchPromise.then(() => {
157
- setTokenData(cachedTokenData);
158
- setTokenError(cachedTokenError);
159
- setTokenLoading(false);
160
- });
161
- return;
162
- }
163
-
164
- const fetchTokens = async () => {
165
- setTokenLoading(true);
166
- setTokenError(null);
167
-
168
- try {
169
- const response = await fetch("/fragments/tokens");
170
-
171
- if (!response.ok) {
172
- const data = await response.json();
173
- if (data.error) {
174
- cachedTokenError = data.suggestion || data.error;
175
- setTokenError(cachedTokenError);
176
- }
177
- return;
178
- }
179
-
180
- const data = await response.json();
181
- cachedTokenData = data;
182
- setTokenData(data);
183
- } catch (err) {
184
- cachedTokenError = "Failed to fetch tokens";
185
- setTokenError(cachedTokenError);
186
- } finally {
187
- setTokenLoading(false);
188
- tokenFetchPromise = null;
189
- }
190
- };
191
-
192
- tokenFetchPromise = fetchTokens();
193
- }, []);
194
-
195
- /**
196
- * Find a token by value, filtered by property category to avoid false positives.
197
- * Returns null if no appropriate token is found.
198
- */
199
- const tokenByValue = useCallback(
200
- (value: string, property?: string): { token: DesignToken; confidence: "exact" | "value-only" } | null => {
201
- if (!tokenData?.tokens) return null;
202
-
203
- const normalized = normalizeValue(value);
204
- const expectedCategories = property ? getExpectedCategories(property) : null;
205
-
206
- // First pass: look for exact category match
207
- for (const token of tokenData.tokens) {
208
- const tokenNormalized = normalizeValue(token.resolvedValue);
209
- if (tokenNormalized === normalized) {
210
- // Check if this token's category matches what we expect for this property
211
- if (expectedCategories && expectedCategories.includes(token.category)) {
212
- return { token, confidence: "exact" };
213
- }
214
- }
215
- }
216
-
217
- // Second pass: if we have expectedCategories but found no match, don't return anything
218
- // This prevents "height: 49px" from matching "--top-bar-height" (a sizing token when we want sizing)
219
- if (expectedCategories) {
220
- return null;
221
- }
222
-
223
- // Fallback: if we don't know the property type, return any matching token
224
- // but mark it as "value-only" confidence
225
- for (const token of tokenData.tokens) {
226
- const tokenNormalized = normalizeValue(token.resolvedValue);
227
- if (tokenNormalized === normalized) {
228
- return { token, confidence: "value-only" };
229
- }
230
- }
231
-
232
- return null;
233
- },
234
- [tokenData]
235
- );
236
-
237
- // Copy fix to clipboard
238
- const copyFix = useCallback((property: string, tokenName: string) => {
239
- const cssProperty = property.replace(/([A-Z])/g, "-$1").toLowerCase();
240
- const code = `${cssProperty}: var(${tokenName});`;
241
- navigator.clipboard.writeText(code);
242
- setCopiedFix(property);
243
- setTimeout(() => setCopiedFix(null), 2000);
244
- }, []);
245
-
246
- // Determine empty config for error / idle states
247
- const emptyConfig = (() => {
248
- if (!figmaLoading && figmaError) {
249
- return {
250
- icon: <Palette size={24} weight="regular" style={{ color: 'var(--text-tertiary)' }} />,
251
- title: "Style comparison failed",
252
- description: figmaError,
253
- action: <Button variant="secondary" size="sm" onClick={onFetchFigma}>Retry</Button>,
254
- };
255
- }
256
- if (!figmaLoading && !figmaStyles) {
257
- return {
258
- icon: <Palette size={24} weight="regular" style={{ color: 'var(--text-tertiary)' }} />,
259
- title: "No style data",
260
- description: "Load Figma styles to compare design tokens with rendered output.",
261
- action: <Button size="sm" onClick={onFetchFigma}>Load Styles</Button>,
262
- };
263
- }
264
- return undefined;
265
- })();
266
-
267
- // Build comparison data (safe — only used when figmaStyles exist, i.e. PanelShell renders children)
268
- const figma = figmaStyles || {};
269
- const rendered = renderedStyles || {};
270
- const allProps = [...new Set([...Object.keys(figma), ...Object.keys(rendered)])];
271
-
272
- const properties = allProps.map((prop) => {
273
- const figmaValue = figma[prop] || "(not set)";
274
- const renderedValue = rendered[prop] || "(not set)";
275
- const match = compareValue(prop, figma[prop] || "", rendered[prop] || "");
276
-
277
- const figmaMatch = figma[prop] ? tokenByValue(figma[prop], prop) : null;
278
- const renderedMatch = rendered[prop] ? tokenByValue(rendered[prop], prop) : null;
279
-
280
- const figmaToken = figmaMatch?.token || null;
281
- const renderedToken = renderedMatch?.token || null;
282
- const figmaConfidence = figmaMatch?.confidence;
283
- const renderedConfidence = renderedMatch?.confidence;
284
-
285
- const isHardcoded = !!figmaToken && !renderedToken && figma[prop] !== rendered[prop];
286
-
287
- return {
288
- property: prop,
289
- figma: figmaValue,
290
- rendered: renderedValue,
291
- match,
292
- figmaToken,
293
- renderedToken,
294
- figmaConfidence,
295
- renderedConfidence,
296
- isHardcoded,
297
- };
298
- });
299
-
300
- const differences = properties.filter((p) => !p.match).length;
301
- const hardcodedCount = properties.filter((p) => p.isHardcoded).length;
302
- const fixableCount = properties.filter((p) => p.isHardcoded && p.figmaToken).length;
303
- const tokenUsageCount = properties.filter((p) => p.renderedToken).length;
304
-
305
- const compliancePercent =
306
- properties.length > 0
307
- ? Math.round(((tokenUsageCount + properties.filter((p) => p.match && !p.figmaToken).length) / properties.length) * 100)
308
- : 100;
309
-
310
- // Toolbar with token status + summary badges (only when data is loaded)
311
- const toolbar = figmaStyles ? (
312
- <Stack direction="row" align="center" justify="between" style={{ width: '100%' }}>
313
- <Stack direction="row" align="center" gap="md">
314
- {tokenData && (
315
- <Text size="xs" color="tertiary">
316
- {tokenData.meta?.totalTokens || tokenData.tokens.length} tokens loaded
317
- </Text>
318
- )}
319
- {tokenLoading && (
320
- <Stack direction="row" align="center" gap="xs" style={{ color: 'var(--text-tertiary)' }}>
321
- <SyncingIcon style={{ width: 12, height: 12, animation: 'spin 1s linear infinite' }} />
322
- <Text size="xs">Loading tokens...</Text>
323
- </Stack>
324
- )}
325
- {tokenError && !tokenLoading && (
326
- <Text size="xs" style={{ color: '#d97706' }} title={tokenError}>
327
- Tokens not configured
328
- </Text>
329
- )}
330
- </Stack>
331
-
332
- <Stack direction="row" align="center" gap="sm">
333
- {tokenData && (
334
- <Badge
335
- variant={compliancePercent >= 80 ? 'success' : compliancePercent >= 50 ? 'warning' : 'danger'}
336
- >
337
- {compliancePercent}% token compliance
338
- </Badge>
339
- )}
340
-
341
- <Badge variant={differences === 0 ? 'success' : 'warning'}>
342
- {differences === 0 ? "All styles match" : `${differences} difference${differences !== 1 ? "s" : ""}`}
343
- </Badge>
344
-
345
- {hardcodedCount > 0 && (
346
- <Badge variant="danger">
347
- {hardcodedCount} hardcoded
348
- </Badge>
349
- )}
350
- </Stack>
351
- </Stack>
352
- ) : undefined;
353
-
354
- return (
355
- <PanelShell loading={figmaLoading} toolbar={toolbar} empty={emptyConfig}>
356
- <div style={{ overflowX: 'auto' }}>
357
- {/* Comparison Table */}
358
- <table style={{ width: '100%', fontSize: '12px' }}>
359
- <thead>
360
- <tr style={{ borderBottom: '1px solid var(--border)' }}>
361
- <th style={{ padding: '8px 12px', textAlign: 'left', color: 'var(--text-tertiary)', fontWeight: 500 }}>Property</th>
362
- <th style={{ padding: '8px 12px', textAlign: 'left', color: 'var(--text-tertiary)', fontWeight: 500 }}>Figma</th>
363
- {tokenData && (
364
- <th style={{ padding: '8px 12px', textAlign: 'left', color: 'var(--text-tertiary)', fontWeight: 500 }}>Token</th>
365
- )}
366
- <th style={{ padding: '8px 12px', textAlign: 'left', color: 'var(--text-tertiary)', fontWeight: 500 }}>Rendered</th>
367
- <th style={{ padding: '8px 12px', textAlign: 'center', color: 'var(--text-tertiary)', fontWeight: 500, width: '48px' }}>Match</th>
368
- {tokenData && fixableCount > 0 && (
369
- <th style={{ padding: '8px 12px', textAlign: 'center', color: 'var(--text-tertiary)', fontWeight: 500, width: '64px' }}>Fix</th>
370
- )}
371
- </tr>
372
- </thead>
373
- <tbody>
374
- {properties.map((prop, index) => (
375
- <tr
376
- key={prop.property}
377
- style={{
378
- borderBottom: index < properties.length - 1 ? '1px solid var(--border)' : undefined,
379
- background: prop.isHardcoded
380
- ? 'color-mix(in srgb, #ef4444 5%, transparent)'
381
- : !prop.match
382
- ? 'color-mix(in srgb, #f59e0b 5%, transparent)'
383
- : undefined,
384
- }}
385
- >
386
- <td style={{ padding: '8px 12px', fontFamily: 'monospace', color: 'var(--text-primary)' }}>{prop.property}</td>
387
- <td style={{ padding: '8px 12px' }}>
388
- <div style={{ display: 'flex', alignItems: 'center', gap: '8px' }}>
389
- {isColorProperty(prop.property) && prop.figma !== "(not set)" && (
390
- <ColorSwatch color={prop.figma} />
391
- )}
392
- <span style={{ fontFamily: 'monospace', color: 'var(--text-secondary)', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', maxWidth: '120px' }} title={prop.figma}>
393
- {prop.figma}
394
- </span>
395
- </div>
396
- </td>
397
- {tokenData && (
398
- <td style={{ padding: '8px 12px' }}>
399
- {prop.figmaToken ? (
400
- <TokenBadge token={prop.figmaToken} confidence={prop.figmaConfidence} />
401
- ) : prop.renderedToken ? (
402
- <TokenBadge token={prop.renderedToken} confidence={prop.renderedConfidence} />
403
- ) : (
404
- <span style={{ color: 'var(--text-tertiary)' }}>-</span>
405
- )}
406
- </td>
407
- )}
408
- <td style={{ padding: '8px 12px' }}>
409
- <div style={{ display: 'flex', alignItems: 'center', gap: '8px' }}>
410
- {isColorProperty(prop.property) && prop.rendered !== "(not set)" && (
411
- <ColorSwatch color={prop.rendered} />
412
- )}
413
- <span style={{ fontFamily: 'monospace', color: 'var(--text-secondary)', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', maxWidth: '120px' }} title={prop.rendered}>
414
- {prop.rendered}
415
- </span>
416
- {prop.isHardcoded && (
417
- <Badge variant="danger">HC</Badge>
418
- )}
419
- </div>
420
- </td>
421
- <td style={{ padding: '8px 12px', textAlign: 'center' }}>
422
- {prop.match ? (
423
- <CheckIcon style={{ width: 16, height: 16, color: '#16a34a', margin: '0 auto' }} />
424
- ) : (
425
- <XIcon style={{ width: 16, height: 16, color: '#d97706', margin: '0 auto' }} />
426
- )}
427
- </td>
428
- {tokenData && fixableCount > 0 && (
429
- <td style={{ padding: '8px 12px', textAlign: 'center' }}>
430
- {prop.isHardcoded && prop.figmaToken && (
431
- <button
432
- onClick={() => copyFix(prop.property, prop.figmaToken!.name)}
433
- style={{
434
- padding: '4px',
435
- borderRadius: '4px',
436
- transition: 'color 0.15s, background 0.15s',
437
- background: copiedFix === prop.property ? 'color-mix(in srgb, #22c55e 15%, transparent)' : 'transparent',
438
- color: copiedFix === prop.property ? '#16a34a' : 'var(--text-tertiary)',
439
- border: 'none',
440
- cursor: 'pointer',
441
- }}
442
- title={`Copy: ${prop.property.replace(/([A-Z])/g, "-$1").toLowerCase()}: var(${prop.figmaToken.name});`}
443
- >
444
- {copiedFix === prop.property ? (
445
- <CheckIcon style={{ width: 12, height: 12 }} />
446
- ) : (
447
- <WandIcon style={{ width: 12, height: 12 }} />
448
- )}
449
- </button>
450
- )}
451
- </td>
452
- )}
453
- </tr>
454
- ))}
455
- </tbody>
456
- </table>
457
-
458
- {/* Hardcoded fixes summary */}
459
- {hardcodedCount > 0 && tokenData && (
460
- <Box padding="sm" rounded="md" style={{ marginTop: '16px', background: 'color-mix(in srgb, #f59e0b 8%, transparent)', border: '1px solid color-mix(in srgb, #f59e0b 20%, transparent)' }}>
461
- <Stack direction="row" align="start" gap="sm">
462
- <WandIcon style={{ width: 16, height: 16, color: '#d97706', marginTop: '2px' }} />
463
- <div>
464
- <Text size="xs" weight="medium" style={{ color: '#92400e' }}>
465
- {hardcodedCount} hardcoded value{hardcodedCount !== 1 ? "s" : ""} detected
466
- </Text>
467
- <Text size="xs" style={{ color: '#a16207', marginTop: '4px' }}>
468
- These values should use design tokens for consistency and theming support.
469
- Click the fix button to copy the token-based CSS.
470
- </Text>
471
- </div>
472
- </Stack>
473
- </Box>
474
- )}
475
- </div>
476
- </PanelShell>
477
- );
478
- }
479
-
480
- // ----- Helper Components -----
481
-
482
- /**
483
- * Enhanced tooltip showing full token details on hover
484
- */
485
- function TokenBadge({
486
- token,
487
- confidence,
488
- }: {
489
- token: DesignToken;
490
- confidence?: "exact" | "value-only";
491
- }) {
492
- const [showTooltip, setShowTooltip] = useState(false);
493
-
494
- const isValueOnly = confidence === "value-only";
495
-
496
- return (
497
- <div style={{ position: 'relative', display: 'inline-block' }}>
498
- <span
499
- style={{
500
- fontFamily: 'monospace',
501
- fontSize: '12px',
502
- cursor: 'help',
503
- padding: '2px 6px',
504
- borderRadius: '4px',
505
- color: isValueOnly ? '#d97706' : 'var(--color-accent)',
506
- background: isValueOnly
507
- ? 'color-mix(in srgb, #f59e0b 8%, transparent)'
508
- : 'color-mix(in srgb, var(--color-accent) 8%, transparent)',
509
- }}
510
- onMouseEnter={() => setShowTooltip(true)}
511
- onMouseLeave={() => setShowTooltip(false)}
512
- >
513
- {token.name}
514
- </span>
515
-
516
- {/* Enhanced tooltip */}
517
- {showTooltip && (
518
- <div
519
- style={{
520
- position: 'absolute',
521
- zIndex: 50,
522
- left: 0,
523
- top: '100%',
524
- marginTop: '4px',
525
- padding: '12px',
526
- background: 'var(--bg-primary)',
527
- border: '1px solid var(--border)',
528
- borderRadius: '8px',
529
- boxShadow: '0 10px 15px -3px rgba(0,0,0,0.1), 0 4px 6px -4px rgba(0,0,0,0.1)',
530
- minWidth: '280px',
531
- maxWidth: '320px',
532
- }}
533
- >
534
- <div style={{ display: 'flex', flexDirection: 'column', gap: '8px', fontSize: '12px' }}>
535
- {/* Token name */}
536
- <div>
537
- <span style={{ color: 'var(--text-tertiary)' }}>Token:</span>
538
- <span style={{ marginLeft: '8px', fontFamily: 'monospace', color: 'var(--text-primary)', fontWeight: 500 }}>{token.name}</span>
539
- </div>
540
-
541
- {/* Resolved value */}
542
- <div style={{ display: 'flex', alignItems: 'center' }}>
543
- <span style={{ color: 'var(--text-tertiary)' }}>Value:</span>
544
- <span style={{ marginLeft: '8px', fontFamily: 'monospace', color: 'var(--text-secondary)' }}>{token.resolvedValue}</span>
545
- {token.category === "color" && (
546
- <ColorSwatch color={token.resolvedValue} />
547
- )}
548
- </div>
549
-
550
- {/* Raw value (if different from resolved) */}
551
- {token.rawValue !== token.resolvedValue && (
552
- <div>
553
- <span style={{ color: 'var(--text-tertiary)' }}>Raw:</span>
554
- <span style={{ marginLeft: '8px', fontFamily: 'monospace', color: 'var(--text-secondary)' }}>{token.rawValue}</span>
555
- </div>
556
- )}
557
-
558
- {/* Category & Level */}
559
- <div style={{ display: 'flex', gap: '16px' }}>
560
- <div>
561
- <span style={{ color: 'var(--text-tertiary)' }}>Category:</span>
562
- <span style={{ marginLeft: '8px', color: 'var(--text-secondary)', textTransform: 'capitalize' }}>{token.category}</span>
563
- </div>
564
- <div>
565
- <span style={{ color: 'var(--text-tertiary)' }}>Level:</span>
566
- <span style={{ marginLeft: '8px', color: 'var(--text-secondary)' }}>
567
- {token.level === 1 ? "Base" : token.level === 2 ? "Semantic" : "Component"}
568
- </span>
569
- </div>
570
- </div>
571
-
572
- {/* Theme */}
573
- <div>
574
- <span style={{ color: 'var(--text-tertiary)' }}>Theme:</span>
575
- <span style={{ marginLeft: '8px', color: 'var(--text-secondary)' }}>{token.theme}</span>
576
- </div>
577
-
578
- {/* Reference chain (if has references) */}
579
- {token.referenceChain.length > 1 && (
580
- <div>
581
- <span style={{ color: 'var(--text-tertiary)' }}>References:</span>
582
- <div style={{ marginTop: '4px', fontFamily: 'monospace', color: 'var(--text-secondary)', fontSize: '10px', display: 'flex', flexDirection: 'column', gap: '2px' }}>
583
- {token.referenceChain.map((ref, i) => (
584
- <div key={ref} style={{ display: 'flex', alignItems: 'center' }}>
585
- {i > 0 && <span style={{ marginRight: '4px', color: 'var(--text-tertiary)' }}>&rarr;</span>}
586
- <span>{ref}</span>
587
- </div>
588
- ))}
589
- </div>
590
- </div>
591
- )}
592
-
593
- {/* Source file */}
594
- <div style={{ paddingTop: '4px', borderTop: '1px solid var(--border)' }}>
595
- <span style={{ color: 'var(--text-tertiary)' }}>Source:</span>
596
- <span style={{ marginLeft: '8px', fontFamily: 'monospace', fontSize: '10px', color: 'var(--text-tertiary)', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>
597
- {token.sourceFile.split("/").slice(-2).join("/")}
598
- {token.lineNumber && `:${token.lineNumber}`}
599
- </span>
600
- </div>
601
-
602
- {/* Confidence indicator */}
603
- {confidence === "value-only" && (
604
- <div style={{ paddingTop: '4px', color: '#d97706' }}>
605
- Warning: Value match only - verify this is the correct token
606
- </div>
607
- )}
608
- </div>
609
- </div>
610
- )}
611
- </div>
612
- );
613
- }
614
-
615
- function ColorSwatch({ color }: { color: string }) {
616
- return (
617
- <div
618
- style={{
619
- width: '16px',
620
- height: '16px',
621
- borderRadius: '4px',
622
- border: '1px solid var(--border)',
623
- flexShrink: 0,
624
- marginLeft: '4px',
625
- backgroundColor: color,
626
- }}
627
- title={color}
628
- />
629
- );
630
- }
631
-
632
- // ----- Helper Functions -----
633
-
634
- function isColorProperty(prop: string): boolean {
635
- const colorProps = ["backgroundColor", "borderColor", "color", "fill", "stroke"];
636
- return colorProps.includes(prop) || prop.toLowerCase().includes("color");
637
- }
638
-
639
- /**
640
- * Normalize a CSS value for comparison.
641
- * Handles colors (hex, rgb, rgba) and general values.
642
- */
643
- function normalizeValue(value: string): string {
644
- if (!value) return "";
645
-
646
- const trimmed = value.toLowerCase().trim();
647
-
648
- // Already normalized hex
649
- if (trimmed.match(/^#[0-9a-f]{6}$/i)) {
650
- return trimmed;
651
- }
652
-
653
- // Short hex -> long hex
654
- const shortHex = trimmed.match(/^#([0-9a-f])([0-9a-f])([0-9a-f])$/i);
655
- if (shortHex) {
656
- return `#${shortHex[1]}${shortHex[1]}${shortHex[2]}${shortHex[2]}${shortHex[3]}${shortHex[3]}`;
657
- }
658
-
659
- // Parse hex
660
- const hexMatch = trimmed.match(/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i);
661
- if (hexMatch) {
662
- return trimmed;
663
- }
664
-
665
- // Parse rgb/rgba
666
- const rgbMatch = value.match(
667
- /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(?:,\s*[\d.]+)?\s*\)/
668
- );
669
- if (rgbMatch) {
670
- const r = parseInt(rgbMatch[1], 10).toString(16).padStart(2, "0");
671
- const g = parseInt(rgbMatch[2], 10).toString(16).padStart(2, "0");
672
- const b = parseInt(rgbMatch[3], 10).toString(16).padStart(2, "0");
673
- return `#${r}${g}${b}`;
674
- }
675
-
676
- return trimmed;
677
- }
678
-
679
- function compareValue(prop: string, figma: string, rendered: string): boolean {
680
- if (figma === rendered) return true;
681
- if (!figma || !rendered) return false;
682
-
683
- // Color comparison
684
- if (isColorProperty(prop)) {
685
- return normalizeValue(figma) === normalizeValue(rendered);
686
- }
687
-
688
- // Numeric comparison with near-zero tolerance for floating point rounding only
689
- // Using < 0.1 ensures 1px vs 2px shows as mismatch, while 1.0001px vs 1px matches
690
- const figmaNum = parseFloat(figma);
691
- const renderedNum = parseFloat(rendered);
692
- if (!isNaN(figmaNum) && !isNaN(renderedNum)) {
693
- return Math.abs(figmaNum - renderedNum) < 0.1;
694
- }
695
-
696
- return false;
697
- }
698
-
699
- export default TokenStylePanel;