@fragments-sdk/cli 0.15.0 → 0.15.2
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.
- package/dist/{ai-client-I6MDWNYA.js → ai-client-LSLQGOMM.js} +1 -2
- package/dist/bin.js +565 -548
- package/dist/bin.js.map +1 -1
- package/dist/chunk-5JF26E55.js +1255 -0
- package/dist/chunk-5JF26E55.js.map +1 -0
- package/dist/{chunk-XJQ5BIWI.js → chunk-6SQPP47U.js} +30 -314
- package/dist/chunk-6SQPP47U.js.map +1 -0
- package/dist/{chunk-65WSVDV5.js → chunk-HQ6A6DTV.js} +1386 -1097
- package/dist/chunk-HQ6A6DTV.js.map +1 -0
- package/dist/chunk-MHIBEEW4.js +511 -0
- package/dist/chunk-MHIBEEW4.js.map +1 -0
- package/dist/{chunk-CZD3AD4Q.js → chunk-ONUP6Z4W.js} +17 -6
- package/dist/chunk-ONUP6Z4W.js.map +1 -0
- package/dist/{codebase-scanner-VOTPXRYW.js → codebase-scanner-MQHUZC2G.js} +1 -2
- package/dist/{converter-JLINP7CJ.js → converter-7XM3Y6NJ.js} +1 -2
- package/dist/{converter-JLINP7CJ.js.map → converter-7XM3Y6NJ.js.map} +1 -1
- package/dist/core/index.js +0 -1
- package/dist/create-JVAU3YKN.js +852 -0
- package/dist/create-JVAU3YKN.js.map +1 -0
- package/dist/doctor-BDPMYYE6.js +385 -0
- package/dist/doctor-BDPMYYE6.js.map +1 -0
- package/dist/{generate-A4FP5426.js → generate-PVOLUAAC.js} +3 -4
- package/dist/{generate-A4FP5426.js.map → generate-PVOLUAAC.js.map} +1 -1
- package/dist/{govern-scan-UCBZR6D6.js → govern-scan-OYFZYOQW.js} +142 -9
- package/dist/govern-scan-OYFZYOQW.js.map +1 -0
- package/dist/index.d.ts +2 -22
- package/dist/index.js +8 -7
- package/dist/index.js.map +1 -1
- package/dist/{init-HGSM35XA.js → init-SSGUSP7Z.js} +3 -4
- package/dist/{init-HGSM35XA.js.map → init-SSGUSP7Z.js.map} +1 -1
- package/dist/{init-cloud-MQ6GRJAZ.js → init-cloud-3DNKPWFB.js} +29 -4
- package/dist/{init-cloud-MQ6GRJAZ.js.map → init-cloud-3DNKPWFB.js.map} +1 -1
- package/dist/mcp-bin.js +1 -2
- package/dist/mcp-bin.js.map +1 -1
- package/dist/node-37AUE74M.js +65 -0
- package/dist/push-contracts-WY32TFP6.js +84 -0
- package/dist/push-contracts-WY32TFP6.js.map +1 -0
- package/dist/{scan-VNNKACG2.js → scan-PKSYSTRR.js} +5 -5
- package/dist/{scan-generate-TWRHNU5M.js → scan-generate-VY27PIOX.js} +8 -9
- package/dist/scan-generate-VY27PIOX.js.map +1 -0
- package/dist/{scanner-7LAZYPWZ.js → scanner-4KZNOXAK.js} +1 -2
- package/dist/{service-FHQU7YS7.js → service-QJGWUIVL.js} +16 -9
- package/dist/{snapshot-KQEQ6XHL.js → snapshot-WIJMEIFT.js} +1 -2
- package/dist/{snapshot-KQEQ6XHL.js.map → snapshot-WIJMEIFT.js.map} +1 -1
- package/dist/{static-viewer-63PG6FWY.js → static-viewer-7QIBQZRC.js} +1 -2
- package/dist/{test-UQYUCZIS.js → test-64Z5BKBA.js} +2 -3
- package/dist/{test-UQYUCZIS.js.map → test-64Z5BKBA.js.map} +1 -1
- package/dist/token-normalizer-TEPOVBPV.js +312 -0
- package/dist/token-normalizer-TEPOVBPV.js.map +1 -0
- package/dist/token-parser-32KOIOFN.js +22 -0
- package/dist/token-parser-32KOIOFN.js.map +1 -0
- package/dist/{tokens-6GYKDV6U.js → tokens-NZWFQIAB.js} +7 -7
- package/dist/{tokens-generate-VTZV5EEW.js → tokens-generate-5JQSJ27E.js} +1 -2
- package/dist/{tokens-generate-VTZV5EEW.js.map → tokens-generate-5JQSJ27E.js.map} +1 -1
- package/dist/tokens-push-HY3KO36V.js +148 -0
- package/dist/tokens-push-HY3KO36V.js.map +1 -0
- package/package.json +18 -16
- package/src/bin.ts +94 -1
- package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/label.contract.json +1 -1
- package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/primitive.contract.json +1 -1
- package/src/commands/__tests__/build-freshness.test.ts +231 -0
- package/src/commands/__tests__/create.test.ts +71 -0
- package/src/commands/__tests__/drift-sync.test.ts +1 -1
- package/src/commands/__tests__/govern.test.ts +258 -0
- package/src/commands/__tests__/init.test.ts +9 -1
- package/src/commands/__tests__/scan-generate.test.ts +1 -1
- package/src/commands/build.ts +54 -1
- package/src/commands/context.ts +1 -1
- package/src/commands/create.ts +590 -0
- package/src/commands/doctor.ts +3 -2
- package/src/commands/govern-scan.ts +187 -8
- package/src/commands/govern.ts +65 -2
- package/src/commands/init-cloud.ts +32 -4
- package/src/commands/push-contracts.ts +112 -0
- package/src/commands/scan-generate.ts +1 -1
- package/src/commands/scan.ts +13 -0
- package/src/commands/sync.ts +2 -2
- package/src/commands/tokens-push.ts +199 -0
- package/src/core/__tests__/token-resolver.test.ts +1 -1
- package/src/core/component-extractor.test.ts +1 -1
- package/src/core/drift-verifier.ts +1 -1
- package/src/core/extractor-adapter.ts +1 -1
- package/src/index.ts +3 -3
- package/src/migrate/fragment-to-contract.ts +2 -2
- package/src/service/index.ts +8 -0
- package/src/service/tailwind-v4-parser.ts +314 -0
- package/src/service/token-parser.ts +56 -0
- package/src/setup.ts +10 -39
- package/src/theme/__tests__/component-contrast.test.ts +2 -2
- package/src/theme/__tests__/serializer.test.ts +1 -1
- package/src/theme/generator.ts +30 -1
- package/src/theme/schema.ts +8 -0
- package/src/theme/serializer.ts +13 -9
- package/src/theme/types.ts +8 -0
- package/src/validators.ts +1 -2
- package/dist/chunk-65WSVDV5.js.map +0 -1
- package/dist/chunk-7WHVW72L.js +0 -2664
- package/dist/chunk-7WHVW72L.js.map +0 -1
- package/dist/chunk-CZD3AD4Q.js.map +0 -1
- package/dist/chunk-MN3TJ3D5.js +0 -695
- package/dist/chunk-MN3TJ3D5.js.map +0 -1
- package/dist/chunk-XJQ5BIWI.js.map +0 -1
- package/dist/chunk-Z7EY4VHE.js +0 -50
- package/dist/govern-scan-UCBZR6D6.js.map +0 -1
- package/dist/sass.node-4XJK6YBF.js +0 -130708
- package/dist/sass.node-4XJK6YBF.js.map +0 -1
- package/dist/scan-generate-TWRHNU5M.js.map +0 -1
- package/src/build.ts +0 -736
- package/src/core/auto-props.ts +0 -464
- package/src/core/component-extractor.ts +0 -1121
- package/src/core/token-resolver.ts +0 -155
- package/src/viewer/preview-adapter.ts +0 -116
- /package/dist/{ai-client-I6MDWNYA.js.map → ai-client-LSLQGOMM.js.map} +0 -0
- /package/dist/{chunk-Z7EY4VHE.js.map → codebase-scanner-MQHUZC2G.js.map} +0 -0
- /package/dist/{codebase-scanner-VOTPXRYW.js.map → node-37AUE74M.js.map} +0 -0
- /package/dist/{scan-VNNKACG2.js.map → scan-PKSYSTRR.js.map} +0 -0
- /package/dist/{scanner-7LAZYPWZ.js.map → scanner-4KZNOXAK.js.map} +0 -0
- /package/dist/{service-FHQU7YS7.js.map → service-QJGWUIVL.js.map} +0 -0
- /package/dist/{static-viewer-63PG6FWY.js.map → static-viewer-7QIBQZRC.js.map} +0 -0
- /package/dist/{tokens-6GYKDV6U.js.map → tokens-NZWFQIAB.js.map} +0 -0
|
@@ -0,0 +1,312 @@
|
|
|
1
|
+
import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
|
|
2
|
+
import {
|
|
3
|
+
parseColor
|
|
4
|
+
} from "./chunk-32LIWN2P.js";
|
|
5
|
+
|
|
6
|
+
// src/service/token-normalizer.ts
|
|
7
|
+
import { existsSync } from "fs";
|
|
8
|
+
import { resolve } from "path";
|
|
9
|
+
import { createJiti } from "jiti";
|
|
10
|
+
function normalizeCSSVarTokens(tokens) {
|
|
11
|
+
return tokens.map((token) => ({
|
|
12
|
+
name: token.name,
|
|
13
|
+
value: token.resolvedValue,
|
|
14
|
+
category: token.category,
|
|
15
|
+
source: "css-var",
|
|
16
|
+
originalName: token.name,
|
|
17
|
+
theme: token.theme
|
|
18
|
+
}));
|
|
19
|
+
}
|
|
20
|
+
var TAILWIND_CATEGORY_MAP = {
|
|
21
|
+
colors: "color",
|
|
22
|
+
backgroundColor: "color",
|
|
23
|
+
textColor: "color",
|
|
24
|
+
borderColor: "color",
|
|
25
|
+
fill: "color",
|
|
26
|
+
stroke: "color",
|
|
27
|
+
accentColor: "color",
|
|
28
|
+
ringColor: "color",
|
|
29
|
+
outlineColor: "color",
|
|
30
|
+
spacing: "spacing",
|
|
31
|
+
margin: "spacing",
|
|
32
|
+
padding: "spacing",
|
|
33
|
+
gap: "spacing",
|
|
34
|
+
space: "spacing",
|
|
35
|
+
inset: "spacing",
|
|
36
|
+
fontSize: "typography",
|
|
37
|
+
fontFamily: "typography",
|
|
38
|
+
fontWeight: "typography",
|
|
39
|
+
lineHeight: "typography",
|
|
40
|
+
letterSpacing: "typography",
|
|
41
|
+
borderRadius: "radius",
|
|
42
|
+
borderWidth: "border",
|
|
43
|
+
boxShadow: "shadow",
|
|
44
|
+
width: "sizing",
|
|
45
|
+
height: "sizing",
|
|
46
|
+
maxWidth: "sizing",
|
|
47
|
+
maxHeight: "sizing",
|
|
48
|
+
minWidth: "sizing",
|
|
49
|
+
minHeight: "sizing",
|
|
50
|
+
size: "sizing",
|
|
51
|
+
zIndex: "z-index",
|
|
52
|
+
animation: "animation",
|
|
53
|
+
transitionDuration: "animation",
|
|
54
|
+
transitionTimingFunction: "animation",
|
|
55
|
+
transitionDelay: "animation"
|
|
56
|
+
};
|
|
57
|
+
function normalizeTailwindTheme(theme, options = {}) {
|
|
58
|
+
const { source = "tailwind", defaultTheme = "default" } = options;
|
|
59
|
+
const tokens = [];
|
|
60
|
+
for (const [themeKey, themeValue] of Object.entries(theme)) {
|
|
61
|
+
const category = TAILWIND_CATEGORY_MAP[themeKey];
|
|
62
|
+
if (!category || themeValue == null || typeof themeValue === "function") {
|
|
63
|
+
continue;
|
|
64
|
+
}
|
|
65
|
+
if (typeof themeValue !== "object") {
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
flattenThemeValue(
|
|
69
|
+
themeValue,
|
|
70
|
+
themeKey,
|
|
71
|
+
category,
|
|
72
|
+
source,
|
|
73
|
+
defaultTheme,
|
|
74
|
+
tokens
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
return tokens;
|
|
78
|
+
}
|
|
79
|
+
function flattenThemeValue(obj, prefix, category, source, theme, out) {
|
|
80
|
+
for (const [key, value] of Object.entries(obj)) {
|
|
81
|
+
const path = key === "DEFAULT" ? prefix : `${prefix}.${key}`;
|
|
82
|
+
if (value == null || typeof value === "function") {
|
|
83
|
+
continue;
|
|
84
|
+
}
|
|
85
|
+
if (typeof value === "string") {
|
|
86
|
+
out.push({
|
|
87
|
+
name: path,
|
|
88
|
+
value,
|
|
89
|
+
category,
|
|
90
|
+
source,
|
|
91
|
+
originalName: path,
|
|
92
|
+
theme
|
|
93
|
+
});
|
|
94
|
+
continue;
|
|
95
|
+
}
|
|
96
|
+
if (typeof value === "number") {
|
|
97
|
+
out.push({
|
|
98
|
+
name: path,
|
|
99
|
+
value: String(value),
|
|
100
|
+
category,
|
|
101
|
+
source,
|
|
102
|
+
originalName: path,
|
|
103
|
+
theme
|
|
104
|
+
});
|
|
105
|
+
continue;
|
|
106
|
+
}
|
|
107
|
+
if (Array.isArray(value)) {
|
|
108
|
+
const resolved = resolveArrayValue(value, category);
|
|
109
|
+
if (resolved !== null) {
|
|
110
|
+
out.push({
|
|
111
|
+
name: path,
|
|
112
|
+
value: resolved,
|
|
113
|
+
category,
|
|
114
|
+
source,
|
|
115
|
+
originalName: path,
|
|
116
|
+
theme
|
|
117
|
+
});
|
|
118
|
+
}
|
|
119
|
+
continue;
|
|
120
|
+
}
|
|
121
|
+
if (typeof value === "object") {
|
|
122
|
+
flattenThemeValue(
|
|
123
|
+
value,
|
|
124
|
+
path,
|
|
125
|
+
category,
|
|
126
|
+
source,
|
|
127
|
+
theme,
|
|
128
|
+
out
|
|
129
|
+
);
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
function resolveArrayValue(value, category) {
|
|
134
|
+
if (value.length === 0) return null;
|
|
135
|
+
if (category === "typography" && value.every((v) => typeof v === "string")) {
|
|
136
|
+
return value.join(", ");
|
|
137
|
+
}
|
|
138
|
+
if (typeof value[0] === "string") {
|
|
139
|
+
return value[0];
|
|
140
|
+
}
|
|
141
|
+
return null;
|
|
142
|
+
}
|
|
143
|
+
function deepMerge(base, override) {
|
|
144
|
+
const result = { ...base };
|
|
145
|
+
for (const [key, value] of Object.entries(override)) {
|
|
146
|
+
const existing = result[key];
|
|
147
|
+
if (existing && typeof existing === "object" && !Array.isArray(existing) && value && typeof value === "object" && !Array.isArray(value)) {
|
|
148
|
+
result[key] = deepMerge(
|
|
149
|
+
existing,
|
|
150
|
+
value
|
|
151
|
+
);
|
|
152
|
+
} else {
|
|
153
|
+
result[key] = value;
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
return result;
|
|
157
|
+
}
|
|
158
|
+
async function loadTailwindConfig(configPath) {
|
|
159
|
+
const absolutePath = resolve(configPath);
|
|
160
|
+
if (!existsSync(absolutePath)) {
|
|
161
|
+
throw new Error(`Tailwind config not found: ${absolutePath}`);
|
|
162
|
+
}
|
|
163
|
+
const jiti = createJiti(absolutePath);
|
|
164
|
+
const mod = await jiti.import(absolutePath);
|
|
165
|
+
const config = mod.default ?? mod;
|
|
166
|
+
if (!config || typeof config !== "object") {
|
|
167
|
+
throw new Error(
|
|
168
|
+
`Tailwind config at ${absolutePath} does not export a valid object`
|
|
169
|
+
);
|
|
170
|
+
}
|
|
171
|
+
const configObj = config;
|
|
172
|
+
const theme = configObj.theme ?? {};
|
|
173
|
+
const extend = theme.extend ?? {};
|
|
174
|
+
const merged = {};
|
|
175
|
+
for (const [key, value] of Object.entries(theme)) {
|
|
176
|
+
if (key !== "extend") {
|
|
177
|
+
merged[key] = value;
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
for (const [key, value] of Object.entries(extend)) {
|
|
181
|
+
const existing = merged[key];
|
|
182
|
+
if (existing && typeof existing === "object" && !Array.isArray(existing) && value && typeof value === "object" && !Array.isArray(value)) {
|
|
183
|
+
merged[key] = deepMerge(
|
|
184
|
+
existing,
|
|
185
|
+
value
|
|
186
|
+
);
|
|
187
|
+
} else {
|
|
188
|
+
merged[key] = value;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
return normalizeTailwindTheme(merged);
|
|
192
|
+
}
|
|
193
|
+
var TAILWIND_CONFIG_FILENAMES = [
|
|
194
|
+
"tailwind.config.ts",
|
|
195
|
+
"tailwind.config.js",
|
|
196
|
+
"tailwind.config.mjs",
|
|
197
|
+
"tailwind.config.cjs"
|
|
198
|
+
];
|
|
199
|
+
function findTailwindConfig(projectRoot) {
|
|
200
|
+
for (const filename of TAILWIND_CONFIG_FILENAMES) {
|
|
201
|
+
const fullPath = resolve(projectRoot, filename);
|
|
202
|
+
if (existsSync(fullPath)) {
|
|
203
|
+
return fullPath;
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
return null;
|
|
207
|
+
}
|
|
208
|
+
var NormalizedTokenLookup = class {
|
|
209
|
+
byName = /* @__PURE__ */ new Map();
|
|
210
|
+
byValue = /* @__PURE__ */ new Map();
|
|
211
|
+
constructor(tokens) {
|
|
212
|
+
for (const token of tokens) {
|
|
213
|
+
const dt = normalizedToDesignToken(token);
|
|
214
|
+
this.byName.set(token.name, dt);
|
|
215
|
+
const normalizedValue = normalizeForLookup(token.value);
|
|
216
|
+
const existing = this.byValue.get(normalizedValue) || [];
|
|
217
|
+
existing.push(token.name);
|
|
218
|
+
this.byValue.set(normalizedValue, existing);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
findByValue(value, theme) {
|
|
222
|
+
const normalized = normalizeForLookup(value);
|
|
223
|
+
const names = this.byValue.get(normalized) || [];
|
|
224
|
+
if (theme && names.length > 0) {
|
|
225
|
+
return names.filter((name) => {
|
|
226
|
+
const token = this.byName.get(name);
|
|
227
|
+
return token?.theme === theme || token?.theme === "default";
|
|
228
|
+
});
|
|
229
|
+
}
|
|
230
|
+
return names;
|
|
231
|
+
}
|
|
232
|
+
getToken(name) {
|
|
233
|
+
return this.byName.get(name);
|
|
234
|
+
}
|
|
235
|
+
calculateUsageSummary(styleDiffs, theme = "default") {
|
|
236
|
+
const hardcodedProperties = [];
|
|
237
|
+
let usingTokens = 0;
|
|
238
|
+
let hardcoded = 0;
|
|
239
|
+
let implicitMatches = 0;
|
|
240
|
+
for (const diff of styleDiffs) {
|
|
241
|
+
const figmaTokens = this.findByValue(diff.figma, theme);
|
|
242
|
+
const renderedTokens = this.findByValue(diff.rendered, theme);
|
|
243
|
+
const figmaToken = figmaTokens.length > 0 ? figmaTokens[0] : void 0;
|
|
244
|
+
const renderedToken = renderedTokens.length > 0 ? renderedTokens[0] : void 0;
|
|
245
|
+
const isHardcoded = !!figmaToken && !renderedToken;
|
|
246
|
+
if (renderedToken) {
|
|
247
|
+
usingTokens++;
|
|
248
|
+
} else if (isHardcoded) {
|
|
249
|
+
hardcoded++;
|
|
250
|
+
hardcodedProperties.push({
|
|
251
|
+
...diff,
|
|
252
|
+
figmaToken,
|
|
253
|
+
renderedToken,
|
|
254
|
+
isHardcoded: true
|
|
255
|
+
});
|
|
256
|
+
} else if (diff.match && figmaToken) {
|
|
257
|
+
implicitMatches++;
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
const totalProperties = styleDiffs.length;
|
|
261
|
+
const compliancePercent = totalProperties > 0 ? Math.round(
|
|
262
|
+
(usingTokens + implicitMatches) / totalProperties * 100
|
|
263
|
+
) : 100;
|
|
264
|
+
return {
|
|
265
|
+
totalProperties,
|
|
266
|
+
usingTokens,
|
|
267
|
+
hardcoded,
|
|
268
|
+
implicitMatches,
|
|
269
|
+
compliancePercent,
|
|
270
|
+
hardcodedProperties
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
};
|
|
274
|
+
function createTokenLookup(tokens) {
|
|
275
|
+
return new NormalizedTokenLookup(tokens);
|
|
276
|
+
}
|
|
277
|
+
function normalizedToDesignToken(token) {
|
|
278
|
+
return {
|
|
279
|
+
name: token.name,
|
|
280
|
+
rawValue: token.value,
|
|
281
|
+
resolvedValue: token.value,
|
|
282
|
+
category: token.category,
|
|
283
|
+
level: 2,
|
|
284
|
+
referenceChain: [],
|
|
285
|
+
sourceFile: token.source,
|
|
286
|
+
theme: token.theme,
|
|
287
|
+
selector: token.source === "css-var" ? ":root" : ""
|
|
288
|
+
};
|
|
289
|
+
}
|
|
290
|
+
function normalizeForLookup(value) {
|
|
291
|
+
let normalized = value.toLowerCase().trim();
|
|
292
|
+
if (looksLikeColor(normalized)) {
|
|
293
|
+
const rgb = parseColor(value);
|
|
294
|
+
if (rgb) {
|
|
295
|
+
normalized = `#${[rgb.r, rgb.g, rgb.b].map((x) => x.toString(16).padStart(2, "0")).join("")}`;
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
normalized = normalized.replace(/\s+/g, " ");
|
|
299
|
+
return normalized;
|
|
300
|
+
}
|
|
301
|
+
function looksLikeColor(value) {
|
|
302
|
+
return value.startsWith("#") || value.startsWith("rgb") || value.startsWith("hsl");
|
|
303
|
+
}
|
|
304
|
+
export {
|
|
305
|
+
NormalizedTokenLookup,
|
|
306
|
+
createTokenLookup,
|
|
307
|
+
findTailwindConfig,
|
|
308
|
+
loadTailwindConfig,
|
|
309
|
+
normalizeCSSVarTokens,
|
|
310
|
+
normalizeTailwindTheme
|
|
311
|
+
};
|
|
312
|
+
//# sourceMappingURL=token-normalizer-TEPOVBPV.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/service/token-normalizer.ts"],"sourcesContent":["/**\n * Token Normalizer\n *\n * One normalization layer that produces NormalizedToken[] regardless of source:\n * - CSS custom properties (from token-parser.ts)\n * - Tailwind theme tokens (from tailwind.config.{js,ts,mjs,cjs})\n *\n * Also provides NormalizedTokenLookup implementing the core TokenLookup\n * interface so the canonical comparison engine can consume any token source.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { createJiti } from \"jiti\";\nimport { parseColor } from \"@fragments-sdk/core\";\nimport type {\n DesignToken,\n EnhancedStyleDiffItem,\n NormalizedToken,\n TokenCategory,\n TokenLookup,\n TokenUsageSummary,\n} from \"@fragments-sdk/core\";\n\n// ─── CSS Custom Property Normalization ───────────────────────────────────────\n\n/**\n * Convert parsed DesignToken[] (CSS custom properties) to NormalizedToken[].\n */\nexport function normalizeCSSVarTokens(tokens: DesignToken[]): NormalizedToken[] {\n return tokens.map((token) => ({\n name: token.name,\n value: token.resolvedValue,\n category: token.category,\n source: \"css-var\" as const,\n originalName: token.name,\n theme: token.theme,\n }));\n}\n\n// ─── Tailwind Theme Normalization ────────────────────────────────────────────\n\n/**\n * Tailwind theme key → NormalizedToken category mapping.\n * Only keys that map to meaningful token categories are listed.\n */\nconst TAILWIND_CATEGORY_MAP: Record<string, TokenCategory> = {\n colors: \"color\",\n backgroundColor: \"color\",\n textColor: \"color\",\n borderColor: \"color\",\n fill: \"color\",\n stroke: \"color\",\n accentColor: \"color\",\n ringColor: \"color\",\n outlineColor: \"color\",\n\n spacing: \"spacing\",\n margin: \"spacing\",\n padding: \"spacing\",\n gap: \"spacing\",\n space: \"spacing\",\n inset: \"spacing\",\n\n fontSize: \"typography\",\n fontFamily: \"typography\",\n fontWeight: \"typography\",\n lineHeight: \"typography\",\n letterSpacing: \"typography\",\n\n borderRadius: \"radius\",\n\n borderWidth: \"border\",\n\n boxShadow: \"shadow\",\n\n width: \"sizing\",\n height: \"sizing\",\n maxWidth: \"sizing\",\n maxHeight: \"sizing\",\n minWidth: \"sizing\",\n minHeight: \"sizing\",\n size: \"sizing\",\n\n zIndex: \"z-index\",\n\n animation: \"animation\",\n transitionDuration: \"animation\",\n transitionTimingFunction: \"animation\",\n transitionDelay: \"animation\",\n};\n\n/**\n * Convert a Tailwind theme object into NormalizedToken[].\n *\n * Handles:\n * - Flat values: `{ primary: '#0051c2' }` → `colors.primary`\n * - Nested values: `{ blue: { 50: '#eff6ff', 500: '#3b82f6' } }` → `colors.blue.50`\n * - DEFAULT key: `{ blue: { DEFAULT: '#3b82f6' } }` → `colors.blue`\n * - Array values for fontFamily: `{ sans: ['Inter', 'sans-serif'] }` → joined\n * - Tuple values for fontSize: `{ sm: ['14px', { lineHeight: '20px' }] }` → first element\n */\nexport function normalizeTailwindTheme(\n theme: Record<string, unknown>,\n options: {\n /** Source identifier (default: \"tailwind\") */\n source?: string;\n /** Theme name (default: \"default\") */\n defaultTheme?: string;\n } = {}\n): NormalizedToken[] {\n const { source = \"tailwind\", defaultTheme = \"default\" } = options;\n const tokens: NormalizedToken[] = [];\n\n for (const [themeKey, themeValue] of Object.entries(theme)) {\n const category = TAILWIND_CATEGORY_MAP[themeKey];\n if (!category || themeValue == null || typeof themeValue === \"function\") {\n continue;\n }\n\n if (typeof themeValue !== \"object\") {\n continue;\n }\n\n flattenThemeValue(\n themeValue as Record<string, unknown>,\n themeKey,\n category,\n source,\n defaultTheme,\n tokens\n );\n }\n\n return tokens;\n}\n\n/**\n * Recursively flatten a Tailwind theme value object into NormalizedToken entries.\n */\nfunction flattenThemeValue(\n obj: Record<string, unknown>,\n prefix: string,\n category: TokenCategory,\n source: string,\n theme: string,\n out: NormalizedToken[]\n): void {\n for (const [key, value] of Object.entries(obj)) {\n // Build the path, collapsing DEFAULT to the parent\n const path = key === \"DEFAULT\" ? prefix : `${prefix}.${key}`;\n\n if (value == null || typeof value === \"function\") {\n continue;\n }\n\n // String value → leaf token\n if (typeof value === \"string\") {\n out.push({\n name: path,\n value,\n category,\n source,\n originalName: path,\n theme,\n });\n continue;\n }\n\n // Number value → convert to string\n if (typeof value === \"number\") {\n out.push({\n name: path,\n value: String(value),\n category,\n source,\n originalName: path,\n theme,\n });\n continue;\n }\n\n // Array value → handle fontFamily (join) and fontSize tuples (first element)\n if (Array.isArray(value)) {\n const resolved = resolveArrayValue(value, category);\n if (resolved !== null) {\n out.push({\n name: path,\n value: resolved,\n category,\n source,\n originalName: path,\n theme,\n });\n }\n continue;\n }\n\n // Nested object → recurse\n if (typeof value === \"object\") {\n flattenThemeValue(\n value as Record<string, unknown>,\n path,\n category,\n source,\n theme,\n out\n );\n }\n }\n}\n\n/**\n * Resolve an array theme value to a string.\n * - fontFamily: ['Inter', 'sans-serif'] → 'Inter, sans-serif'\n * - fontSize: ['14px', { lineHeight: '20px' }] → '14px'\n */\nfunction resolveArrayValue(\n value: unknown[],\n category: TokenCategory\n): string | null {\n if (value.length === 0) return null;\n\n // fontFamily arrays: join with comma\n if (category === \"typography\" && value.every((v) => typeof v === \"string\")) {\n return value.join(\", \");\n }\n\n // fontSize tuples: [size, config] — take the first element\n if (typeof value[0] === \"string\") {\n return value[0];\n }\n\n return null;\n}\n\n/**\n * Recursively deep-merge two objects. Values in `override` take precedence.\n * Nested plain objects are merged recursively; arrays and primitives are replaced.\n */\nfunction deepMerge(\n base: Record<string, unknown>,\n override: Record<string, unknown>,\n): Record<string, unknown> {\n const result = { ...base };\n for (const [key, value] of Object.entries(override)) {\n const existing = result[key];\n if (\n existing &&\n typeof existing === \"object\" &&\n !Array.isArray(existing) &&\n value &&\n typeof value === \"object\" &&\n !Array.isArray(value)\n ) {\n result[key] = deepMerge(\n existing as Record<string, unknown>,\n value as Record<string, unknown>,\n );\n } else {\n result[key] = value;\n }\n }\n return result;\n}\n\n/**\n * Load a Tailwind config file and extract normalized tokens from its theme.\n *\n * Supports tailwind.config.{js,ts,mjs,cjs} via jiti.\n * Reads both `theme` and `theme.extend` (extend values are merged).\n */\nexport async function loadTailwindConfig(\n configPath: string\n): Promise<NormalizedToken[]> {\n const absolutePath = resolve(configPath);\n\n if (!existsSync(absolutePath)) {\n throw new Error(`Tailwind config not found: ${absolutePath}`);\n }\n\n const jiti = createJiti(absolutePath);\n const mod = await jiti.import(absolutePath);\n const config = (mod as { default?: unknown }).default ?? mod;\n\n if (!config || typeof config !== \"object\") {\n throw new Error(\n `Tailwind config at ${absolutePath} does not export a valid object`\n );\n }\n\n const configObj = config as Record<string, unknown>;\n const theme = (configObj.theme ?? {}) as Record<string, unknown>;\n\n // Merge base theme with extend overrides\n const extend = (theme.extend ?? {}) as Record<string, unknown>;\n const merged: Record<string, unknown> = {};\n\n // Copy base theme keys (except 'extend')\n for (const [key, value] of Object.entries(theme)) {\n if (key !== \"extend\") {\n merged[key] = value;\n }\n }\n\n // Deep merge extend values on top (preserves nested tokens like colors.blue.50)\n for (const [key, value] of Object.entries(extend)) {\n const existing = merged[key];\n if (\n existing &&\n typeof existing === \"object\" &&\n !Array.isArray(existing) &&\n value &&\n typeof value === \"object\" &&\n !Array.isArray(value)\n ) {\n merged[key] = deepMerge(\n existing as Record<string, unknown>,\n value as Record<string, unknown>,\n );\n } else {\n merged[key] = value;\n }\n }\n\n return normalizeTailwindTheme(merged);\n}\n\n// ─── Tailwind Config Discovery ───────────────────────────────────────────────\n\nconst TAILWIND_CONFIG_FILENAMES = [\n \"tailwind.config.ts\",\n \"tailwind.config.js\",\n \"tailwind.config.mjs\",\n \"tailwind.config.cjs\",\n];\n\n/**\n * Find a Tailwind config file in the given directory.\n */\nexport function findTailwindConfig(projectRoot: string): string | null {\n for (const filename of TAILWIND_CONFIG_FILENAMES) {\n const fullPath = resolve(projectRoot, filename);\n if (existsSync(fullPath)) {\n return fullPath;\n }\n }\n return null;\n}\n\n// ─── NormalizedTokenLookup ───────────────────────────────────────────────────\n\n/**\n * Implements the core TokenLookup interface over NormalizedToken[].\n *\n * This is the single adapter that lets the canonical comparison engine\n * consume tokens from any source (CSS vars, Tailwind, DTCG, Figma).\n */\nexport class NormalizedTokenLookup implements TokenLookup {\n private byName = new Map<string, DesignToken>();\n private byValue = new Map<string, string[]>();\n\n constructor(tokens: NormalizedToken[]) {\n for (const token of tokens) {\n const dt = normalizedToDesignToken(token);\n this.byName.set(token.name, dt);\n\n const normalizedValue = normalizeForLookup(token.value);\n const existing = this.byValue.get(normalizedValue) || [];\n existing.push(token.name);\n this.byValue.set(normalizedValue, existing);\n }\n }\n\n findByValue(value: string, theme?: string): string[] {\n const normalized = normalizeForLookup(value);\n const names = this.byValue.get(normalized) || [];\n\n if (theme && names.length > 0) {\n return names.filter((name) => {\n const token = this.byName.get(name);\n return token?.theme === theme || token?.theme === \"default\";\n });\n }\n\n return names;\n }\n\n getToken(name: string): DesignToken | undefined {\n return this.byName.get(name);\n }\n\n calculateUsageSummary(\n styleDiffs: Array<{\n property: string;\n figma: string;\n rendered: string;\n match: boolean;\n }>,\n theme = \"default\"\n ): TokenUsageSummary {\n const hardcodedProperties: EnhancedStyleDiffItem[] = [];\n let usingTokens = 0;\n let hardcoded = 0;\n let implicitMatches = 0;\n\n for (const diff of styleDiffs) {\n const figmaTokens = this.findByValue(diff.figma, theme);\n const renderedTokens = this.findByValue(diff.rendered, theme);\n\n const figmaToken = figmaTokens.length > 0 ? figmaTokens[0] : undefined;\n const renderedToken =\n renderedTokens.length > 0 ? renderedTokens[0] : undefined;\n const isHardcoded = !!figmaToken && !renderedToken;\n\n if (renderedToken) {\n usingTokens++;\n } else if (isHardcoded) {\n hardcoded++;\n hardcodedProperties.push({\n ...diff,\n figmaToken,\n renderedToken,\n isHardcoded: true,\n } as EnhancedStyleDiffItem);\n } else if (diff.match && figmaToken) {\n implicitMatches++;\n }\n }\n\n const totalProperties = styleDiffs.length;\n const compliancePercent =\n totalProperties > 0\n ? Math.round(\n ((usingTokens + implicitMatches) / totalProperties) * 100\n )\n : 100;\n\n return {\n totalProperties,\n usingTokens,\n hardcoded,\n implicitMatches,\n compliancePercent,\n hardcodedProperties,\n };\n }\n}\n\n// ─── Factory ─────────────────────────────────────────────────────────────────\n\n/**\n * Create a TokenLookup from NormalizedToken[].\n * Convenience factory for the most common use case.\n */\nexport function createTokenLookup(tokens: NormalizedToken[]): TokenLookup {\n return new NormalizedTokenLookup(tokens);\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Convert a NormalizedToken to a DesignToken for TokenLookup compatibility.\n * Fills source-specific fields with sensible defaults.\n */\nfunction normalizedToDesignToken(token: NormalizedToken): DesignToken {\n return {\n name: token.name,\n rawValue: token.value,\n resolvedValue: token.value,\n category: token.category,\n level: 2,\n referenceChain: [],\n sourceFile: token.source,\n theme: token.theme,\n selector: token.source === \"css-var\" ? \":root\" : \"\",\n };\n}\n\n/**\n * Normalize a value for consistent reverse lookup.\n * Matches the normalization logic in TokenRegistryManager for parity.\n */\nfunction normalizeForLookup(value: string): string {\n let normalized = value.toLowerCase().trim();\n\n // Normalize color formats to lowercase hex\n if (looksLikeColor(normalized)) {\n const rgb = parseColor(value);\n if (rgb) {\n normalized = `#${[rgb.r, rgb.g, rgb.b]\n .map((x) => x.toString(16).padStart(2, \"0\"))\n .join(\"\")}`;\n }\n }\n\n normalized = normalized.replace(/\\s+/g, \" \");\n return normalized;\n}\n\n/**\n * Check if a value looks like a color.\n */\nfunction looksLikeColor(value: string): boolean {\n return (\n value.startsWith(\"#\") ||\n value.startsWith(\"rgb\") ||\n value.startsWith(\"hsl\")\n );\n}\n"],"mappings":"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","names":[]}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
|
|
2
|
+
import {
|
|
3
|
+
containsTailwindV4Theme,
|
|
4
|
+
hexToRgb,
|
|
5
|
+
normalizeColor,
|
|
6
|
+
parseRgb,
|
|
7
|
+
parseTailwindV4File,
|
|
8
|
+
parseTokenFile,
|
|
9
|
+
parseTokenFiles,
|
|
10
|
+
rgbToHex
|
|
11
|
+
} from "./chunk-MHIBEEW4.js";
|
|
12
|
+
export {
|
|
13
|
+
containsTailwindV4Theme,
|
|
14
|
+
hexToRgb,
|
|
15
|
+
normalizeColor,
|
|
16
|
+
parseRgb,
|
|
17
|
+
parseTailwindV4File,
|
|
18
|
+
parseTokenFile,
|
|
19
|
+
parseTokenFiles,
|
|
20
|
+
rgbToHex
|
|
21
|
+
};
|
|
22
|
+
//# sourceMappingURL=token-parser-32KOIOFN.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
|
|
2
|
+
import "./chunk-6SQPP47U.js";
|
|
3
|
+
import "./chunk-D2CDBRNU.js";
|
|
2
4
|
import {
|
|
3
5
|
loadConfig
|
|
4
|
-
} from "./chunk-
|
|
5
|
-
import {
|
|
6
|
-
parseTokenFiles
|
|
7
|
-
} from "./chunk-XJQ5BIWI.js";
|
|
8
|
-
import "./chunk-D2CDBRNU.js";
|
|
6
|
+
} from "./chunk-HQ6A6DTV.js";
|
|
9
7
|
import {
|
|
10
8
|
BRAND
|
|
11
9
|
} from "./chunk-32LIWN2P.js";
|
|
10
|
+
import {
|
|
11
|
+
parseTokenFiles
|
|
12
|
+
} from "./chunk-MHIBEEW4.js";
|
|
12
13
|
import "./chunk-QCN35LJU.js";
|
|
13
14
|
import "./chunk-7DZC4YEV.js";
|
|
14
|
-
import "./chunk-Z7EY4VHE.js";
|
|
15
15
|
|
|
16
16
|
// src/commands/tokens.ts
|
|
17
17
|
import pc from "picocolors";
|
|
@@ -173,4 +173,4 @@ export {
|
|
|
173
173
|
tokens_default as default,
|
|
174
174
|
tokens
|
|
175
175
|
};
|
|
176
|
-
//# sourceMappingURL=tokens-
|
|
176
|
+
//# sourceMappingURL=tokens-NZWFQIAB.js.map
|
|
@@ -6,7 +6,6 @@ import {
|
|
|
6
6
|
generateSCSSVariables,
|
|
7
7
|
generateTailwindConfig
|
|
8
8
|
} from "./chunk-32LIWN2P.js";
|
|
9
|
-
import "./chunk-Z7EY4VHE.js";
|
|
10
9
|
|
|
11
10
|
// src/commands/tokens-generate.ts
|
|
12
11
|
import { readFile, writeFile, mkdir } from "fs/promises";
|
|
@@ -83,4 +82,4 @@ export default ${JSON.stringify(config, null, 2)};
|
|
|
83
82
|
export {
|
|
84
83
|
tokensGenerate
|
|
85
84
|
};
|
|
86
|
-
//# sourceMappingURL=tokens-generate-
|
|
85
|
+
//# sourceMappingURL=tokens-generate-5JQSJ27E.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/commands/tokens-generate.ts"],"sourcesContent":["/**\n * fragments tokens generate — Generate CSS, SCSS, Tailwind, or Figma output\n * from a DTCG .tokens.json source file.\n */\n\nimport { readFile, writeFile, mkdir } from 'node:fs/promises';\nimport { resolve, dirname, basename, extname } from 'node:path';\nimport pc from 'picocolors';\nimport {\n generateCSSCustomProperties,\n generateSCSSVariables,\n generateTailwindConfig,\n generateFigmaVariables,\n} from '../core/index.js';\nimport type { DTCGTokenFile } from '../core/index.js';\n\nexport interface TokensGenerateOptions {\n /** Path to DTCG .tokens.json source file */\n from: string;\n /** Output formats (comma-separated: css, scss, tailwind, figma) */\n format: string;\n /** Output directory */\n out?: string;\n /** Token name prefix */\n prefix?: string;\n /** CSS selector for custom properties (default: ':root') */\n selector?: string;\n /** Verbose output */\n verbose?: boolean;\n}\n\ntype OutputFormat = 'css' | 'scss' | 'tailwind' | 'figma';\n\nconst VALID_FORMATS = new Set<OutputFormat>(['css', 'scss', 'tailwind', 'figma']);\n\nexport async function tokensGenerate(options: TokensGenerateOptions): Promise<void> {\n const { from, format, out, prefix, selector, verbose } = options;\n\n // Parse formats\n const formats = format.split(',').map((f) => f.trim().toLowerCase()) as OutputFormat[];\n const invalidFormats = formats.filter((f) => !VALID_FORMATS.has(f));\n if (invalidFormats.length > 0) {\n console.error(pc.red(`Invalid format(s): ${invalidFormats.join(', ')}`));\n console.error(`Valid formats: ${[...VALID_FORMATS].join(', ')}`);\n process.exit(1);\n }\n\n // Read source file\n const sourcePath = resolve(process.cwd(), from);\n let content: string;\n try {\n content = await readFile(sourcePath, 'utf-8');\n } catch {\n console.error(pc.red(`Could not read file: ${sourcePath}`));\n process.exit(1);\n }\n\n let tokens: DTCGTokenFile;\n try {\n tokens = JSON.parse(content) as DTCGTokenFile;\n } catch {\n console.error(pc.red(`Invalid JSON in: ${sourcePath}`));\n process.exit(1);\n }\n\n // Determine output directory\n const outDir = out ? resolve(process.cwd(), out) : dirname(sourcePath);\n await mkdir(outDir, { recursive: true });\n\n const baseName = basename(from, extname(from)).replace(/\\.tokens$/, '');\n\n // Generate each format\n for (const fmt of formats) {\n let output: string;\n let fileName: string;\n\n switch (fmt) {\n case 'css': {\n output = generateCSSCustomProperties(tokens, { prefix, selector });\n fileName = `${baseName}.css`;\n break;\n }\n case 'scss': {\n output = generateSCSSVariables(tokens, { prefix });\n fileName = `_${baseName}.scss`;\n break;\n }\n case 'tailwind': {\n const config = generateTailwindConfig(tokens);\n output = `// Auto-generated Tailwind config from DTCG tokens\\n// Do not edit directly\\nexport default ${JSON.stringify(config, null, 2)};\\n`;\n fileName = `tailwind.tokens.js`;\n break;\n }\n case 'figma': {\n const collections = generateFigmaVariables(tokens);\n output = JSON.stringify(collections, null, 2);\n fileName = `${baseName}.figma-variables.json`;\n break;\n }\n default:\n continue;\n }\n\n const outputPath = resolve(outDir, fileName);\n await writeFile(outputPath, output, 'utf-8');\n\n if (verbose) {\n console.log(pc.green(` ✓ ${fmt}`), pc.dim(outputPath));\n }\n }\n\n console.log(pc.green(`Generated ${formats.length} output(s) from ${from}`));\n}\n"],"mappings":"
|
|
1
|
+
{"version":3,"sources":["../src/commands/tokens-generate.ts"],"sourcesContent":["/**\n * fragments tokens generate — Generate CSS, SCSS, Tailwind, or Figma output\n * from a DTCG .tokens.json source file.\n */\n\nimport { readFile, writeFile, mkdir } from 'node:fs/promises';\nimport { resolve, dirname, basename, extname } from 'node:path';\nimport pc from 'picocolors';\nimport {\n generateCSSCustomProperties,\n generateSCSSVariables,\n generateTailwindConfig,\n generateFigmaVariables,\n} from '../core/index.js';\nimport type { DTCGTokenFile } from '../core/index.js';\n\nexport interface TokensGenerateOptions {\n /** Path to DTCG .tokens.json source file */\n from: string;\n /** Output formats (comma-separated: css, scss, tailwind, figma) */\n format: string;\n /** Output directory */\n out?: string;\n /** Token name prefix */\n prefix?: string;\n /** CSS selector for custom properties (default: ':root') */\n selector?: string;\n /** Verbose output */\n verbose?: boolean;\n}\n\ntype OutputFormat = 'css' | 'scss' | 'tailwind' | 'figma';\n\nconst VALID_FORMATS = new Set<OutputFormat>(['css', 'scss', 'tailwind', 'figma']);\n\nexport async function tokensGenerate(options: TokensGenerateOptions): Promise<void> {\n const { from, format, out, prefix, selector, verbose } = options;\n\n // Parse formats\n const formats = format.split(',').map((f) => f.trim().toLowerCase()) as OutputFormat[];\n const invalidFormats = formats.filter((f) => !VALID_FORMATS.has(f));\n if (invalidFormats.length > 0) {\n console.error(pc.red(`Invalid format(s): ${invalidFormats.join(', ')}`));\n console.error(`Valid formats: ${[...VALID_FORMATS].join(', ')}`);\n process.exit(1);\n }\n\n // Read source file\n const sourcePath = resolve(process.cwd(), from);\n let content: string;\n try {\n content = await readFile(sourcePath, 'utf-8');\n } catch {\n console.error(pc.red(`Could not read file: ${sourcePath}`));\n process.exit(1);\n }\n\n let tokens: DTCGTokenFile;\n try {\n tokens = JSON.parse(content) as DTCGTokenFile;\n } catch {\n console.error(pc.red(`Invalid JSON in: ${sourcePath}`));\n process.exit(1);\n }\n\n // Determine output directory\n const outDir = out ? resolve(process.cwd(), out) : dirname(sourcePath);\n await mkdir(outDir, { recursive: true });\n\n const baseName = basename(from, extname(from)).replace(/\\.tokens$/, '');\n\n // Generate each format\n for (const fmt of formats) {\n let output: string;\n let fileName: string;\n\n switch (fmt) {\n case 'css': {\n output = generateCSSCustomProperties(tokens, { prefix, selector });\n fileName = `${baseName}.css`;\n break;\n }\n case 'scss': {\n output = generateSCSSVariables(tokens, { prefix });\n fileName = `_${baseName}.scss`;\n break;\n }\n case 'tailwind': {\n const config = generateTailwindConfig(tokens);\n output = `// Auto-generated Tailwind config from DTCG tokens\\n// Do not edit directly\\nexport default ${JSON.stringify(config, null, 2)};\\n`;\n fileName = `tailwind.tokens.js`;\n break;\n }\n case 'figma': {\n const collections = generateFigmaVariables(tokens);\n output = JSON.stringify(collections, null, 2);\n fileName = `${baseName}.figma-variables.json`;\n break;\n }\n default:\n continue;\n }\n\n const outputPath = resolve(outDir, fileName);\n await writeFile(outputPath, output, 'utf-8');\n\n if (verbose) {\n console.log(pc.green(` ✓ ${fmt}`), pc.dim(outputPath));\n }\n }\n\n console.log(pc.green(`Generated ${formats.length} output(s) from ${from}`));\n}\n"],"mappings":";;;;;;;;;;AAKA,SAAS,UAAU,WAAW,aAAa;AAC3C,SAAS,SAAS,SAAS,UAAU,eAAe;AACpD,OAAO,QAAQ;AA0Bf,IAAM,gBAAgB,oBAAI,IAAkB,CAAC,OAAO,QAAQ,YAAY,OAAO,CAAC;AAEhF,eAAsB,eAAe,SAA+C;AAClF,QAAM,EAAE,MAAM,QAAQ,KAAK,QAAQ,UAAU,QAAQ,IAAI;AAGzD,QAAM,UAAU,OAAO,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC;AACnE,QAAM,iBAAiB,QAAQ,OAAO,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC;AAClE,MAAI,eAAe,SAAS,GAAG;AAC7B,YAAQ,MAAM,GAAG,IAAI,sBAAsB,eAAe,KAAK,IAAI,CAAC,EAAE,CAAC;AACvE,YAAQ,MAAM,kBAAkB,CAAC,GAAG,aAAa,EAAE,KAAK,IAAI,CAAC,EAAE;AAC/D,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,aAAa,QAAQ,QAAQ,IAAI,GAAG,IAAI;AAC9C,MAAI;AACJ,MAAI;AACF,cAAU,MAAM,SAAS,YAAY,OAAO;AAAA,EAC9C,QAAQ;AACN,YAAQ,MAAM,GAAG,IAAI,wBAAwB,UAAU,EAAE,CAAC;AAC1D,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,OAAO;AAAA,EAC7B,QAAQ;AACN,YAAQ,MAAM,GAAG,IAAI,oBAAoB,UAAU,EAAE,CAAC;AACtD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI,GAAG,GAAG,IAAI,QAAQ,UAAU;AACrE,QAAM,MAAM,QAAQ,EAAE,WAAW,KAAK,CAAC;AAEvC,QAAM,WAAW,SAAS,MAAM,QAAQ,IAAI,CAAC,EAAE,QAAQ,aAAa,EAAE;AAGtE,aAAW,OAAO,SAAS;AACzB,QAAI;AACJ,QAAI;AAEJ,YAAQ,KAAK;AAAA,MACX,KAAK,OAAO;AACV,iBAAS,4BAA4B,QAAQ,EAAE,QAAQ,SAAS,CAAC;AACjE,mBAAW,GAAG,QAAQ;AACtB;AAAA,MACF;AAAA,MACA,KAAK,QAAQ;AACX,iBAAS,sBAAsB,QAAQ,EAAE,OAAO,CAAC;AACjD,mBAAW,IAAI,QAAQ;AACvB;AAAA,MACF;AAAA,MACA,KAAK,YAAY;AACf,cAAM,SAAS,uBAAuB,MAAM;AAC5C,iBAAS;AAAA;AAAA,iBAA+F,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA;AACvI,mBAAW;AACX;AAAA,MACF;AAAA,MACA,KAAK,SAAS;AACZ,cAAM,cAAc,uBAAuB,MAAM;AACjD,iBAAS,KAAK,UAAU,aAAa,MAAM,CAAC;AAC5C,mBAAW,GAAG,QAAQ;AACtB;AAAA,MACF;AAAA,MACA;AACE;AAAA,IACJ;AAEA,UAAM,aAAa,QAAQ,QAAQ,QAAQ;AAC3C,UAAM,UAAU,YAAY,QAAQ,OAAO;AAE3C,QAAI,SAAS;AACX,cAAQ,IAAI,GAAG,MAAM,YAAO,GAAG,EAAE,GAAG,GAAG,IAAI,UAAU,CAAC;AAAA,IACxD;AAAA,EACF;AAEA,UAAQ,IAAI,GAAG,MAAM,aAAa,QAAQ,MAAM,mBAAmB,IAAI,EAAE,CAAC;AAC5E;","names":[]}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
|
|
2
|
+
|
|
3
|
+
// src/commands/tokens-push.ts
|
|
4
|
+
import { resolve } from "path";
|
|
5
|
+
import pc from "picocolors";
|
|
6
|
+
async function tokensPush(options) {
|
|
7
|
+
const startTime = Date.now();
|
|
8
|
+
const apiKey = process.env.FRAGMENTS_API_KEY;
|
|
9
|
+
const baseUrl = process.env.FRAGMENTS_URL || "https://app.usefragments.com";
|
|
10
|
+
if (!apiKey && !options.dryRun) {
|
|
11
|
+
console.error(pc.red("Error: FRAGMENTS_API_KEY environment variable is required"));
|
|
12
|
+
console.error(pc.dim("Get your API key from https://app.usefragments.com/api-keys"));
|
|
13
|
+
process.exit(1);
|
|
14
|
+
}
|
|
15
|
+
const flatMap = {};
|
|
16
|
+
if (options.tailwindV4) {
|
|
17
|
+
const { parseTailwindV4File } = await import("./token-parser-32KOIOFN.js");
|
|
18
|
+
const filePath = resolve(process.cwd(), options.tailwindV4);
|
|
19
|
+
const result = parseTailwindV4File(filePath);
|
|
20
|
+
if (result.errors.length > 0) {
|
|
21
|
+
for (const err of result.errors) {
|
|
22
|
+
console.error(pc.red(` Error: ${err.message}`));
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
if (options.verbose && result.warnings.length > 0) {
|
|
26
|
+
for (const warn of result.warnings) {
|
|
27
|
+
console.warn(pc.yellow(` Warning: ${warn}`));
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
for (const token of result.tokens) {
|
|
31
|
+
flatMap[token.name] = token.resolvedValue;
|
|
32
|
+
}
|
|
33
|
+
if (options.verbose) {
|
|
34
|
+
console.log(
|
|
35
|
+
pc.dim(` Parsed ${result.tokens.length} tokens from ${options.tailwindV4} (${result.parseTimeMs.toFixed(1)}ms)`)
|
|
36
|
+
);
|
|
37
|
+
}
|
|
38
|
+
} else if (options.config) {
|
|
39
|
+
try {
|
|
40
|
+
const { loadConfig } = await import("./node-37AUE74M.js");
|
|
41
|
+
const { parseTokenFiles } = await import("./service-QJGWUIVL.js");
|
|
42
|
+
const { config, configDir } = await loadConfig(options.config);
|
|
43
|
+
if (config.tokens?.include?.length) {
|
|
44
|
+
const result = await parseTokenFiles(config.tokens, configDir);
|
|
45
|
+
for (const token of result.tokens) {
|
|
46
|
+
flatMap[token.name] = token.resolvedValue;
|
|
47
|
+
}
|
|
48
|
+
if (options.verbose) {
|
|
49
|
+
console.log(
|
|
50
|
+
pc.dim(` Parsed ${result.tokens.length} tokens from config (${result.parseTimeMs.toFixed(1)}ms)`)
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
} else {
|
|
54
|
+
console.error(pc.red("Error: Config file has no tokens.include patterns"));
|
|
55
|
+
process.exit(1);
|
|
56
|
+
}
|
|
57
|
+
} catch (error) {
|
|
58
|
+
console.error(pc.red("Error loading config:"), error instanceof Error ? error.message : error);
|
|
59
|
+
process.exit(1);
|
|
60
|
+
}
|
|
61
|
+
} else {
|
|
62
|
+
try {
|
|
63
|
+
const { loadConfig } = await import("./node-37AUE74M.js");
|
|
64
|
+
const { parseTokenFiles } = await import("./service-QJGWUIVL.js");
|
|
65
|
+
const { config, configDir } = await loadConfig();
|
|
66
|
+
if (config.tokens?.include?.length) {
|
|
67
|
+
const result = await parseTokenFiles(config.tokens, configDir);
|
|
68
|
+
for (const token of result.tokens) {
|
|
69
|
+
flatMap[token.name] = token.resolvedValue;
|
|
70
|
+
}
|
|
71
|
+
if (options.verbose) {
|
|
72
|
+
console.log(
|
|
73
|
+
pc.dim(` Parsed ${result.tokens.length} tokens from auto-detected config (${result.parseTimeMs.toFixed(1)}ms)`)
|
|
74
|
+
);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
} catch {
|
|
78
|
+
}
|
|
79
|
+
if (Object.keys(flatMap).length === 0) {
|
|
80
|
+
console.error(pc.red("Error: No token source specified"));
|
|
81
|
+
console.error(pc.dim("Provide one of:"));
|
|
82
|
+
console.error(pc.dim(" --tailwind-v4 <path> Path to Tailwind v4 CSS file with @theme block"));
|
|
83
|
+
console.error(pc.dim(" --config <path> Path to fragments config with tokens.include"));
|
|
84
|
+
console.error(pc.dim("\nExample: fragments tokens push --tailwind-v4 ./app.css"));
|
|
85
|
+
process.exit(1);
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
const tokenCount = Object.keys(flatMap).length;
|
|
89
|
+
if (tokenCount === 0) {
|
|
90
|
+
console.log(pc.yellow("No tokens found."));
|
|
91
|
+
return;
|
|
92
|
+
}
|
|
93
|
+
console.log(pc.cyan(`Found ${tokenCount} tokens`));
|
|
94
|
+
if (options.dryRun) {
|
|
95
|
+
console.log(pc.dim("\nDry run \u2014 tokens that would be pushed:\n"));
|
|
96
|
+
const entries = Object.entries(flatMap);
|
|
97
|
+
for (const [name, value] of entries.slice(0, 20)) {
|
|
98
|
+
console.log(` ${pc.bold(name)}: ${value}`);
|
|
99
|
+
}
|
|
100
|
+
if (entries.length > 20) {
|
|
101
|
+
console.log(pc.dim(` ... and ${entries.length - 20} more`));
|
|
102
|
+
}
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
try {
|
|
106
|
+
const response = await fetch(`${baseUrl}/api/ingest`, {
|
|
107
|
+
method: "POST",
|
|
108
|
+
headers: {
|
|
109
|
+
"Content-Type": "application/json",
|
|
110
|
+
"Authorization": `Bearer ${apiKey}`
|
|
111
|
+
},
|
|
112
|
+
body: JSON.stringify({
|
|
113
|
+
codeTokens: JSON.stringify(flatMap)
|
|
114
|
+
})
|
|
115
|
+
});
|
|
116
|
+
if (!response.ok) {
|
|
117
|
+
const errorText = await response.text();
|
|
118
|
+
console.error(pc.red(`Error: API returned ${response.status}`));
|
|
119
|
+
console.error(pc.dim(errorText));
|
|
120
|
+
process.exit(1);
|
|
121
|
+
}
|
|
122
|
+
const result = await response.json();
|
|
123
|
+
console.log(pc.green(`
|
|
124
|
+
Pushed ${tokenCount} tokens to Fragments Cloud`));
|
|
125
|
+
if (result.tokenDrift) {
|
|
126
|
+
const drift = result.tokenDrift;
|
|
127
|
+
const summary = drift.summary;
|
|
128
|
+
if (summary) {
|
|
129
|
+
console.log(pc.cyan("\nDrift Summary:"));
|
|
130
|
+
if (summary.total !== void 0) console.log(pc.dim(` Total issues: ${summary.total}`));
|
|
131
|
+
if (summary.missingInCode > 0) console.log(pc.yellow(` Missing in code: ${summary.missingInCode}`));
|
|
132
|
+
if (summary.missingInFigma > 0) console.log(pc.yellow(` Missing in Figma: ${summary.missingInFigma}`));
|
|
133
|
+
if (summary.valueMismatch > 0) console.log(pc.yellow(` Value mismatches: ${summary.valueMismatch}`));
|
|
134
|
+
if (summary.score !== void 0) console.log(` Health score: ${summary.score}%`);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
console.log(pc.dim(`
|
|
138
|
+
View dashboard: ${baseUrl}/tokens`));
|
|
139
|
+
console.log(pc.dim(`Completed in ${Date.now() - startTime}ms`));
|
|
140
|
+
} catch (error) {
|
|
141
|
+
console.error(pc.red("Error pushing tokens:"), error instanceof Error ? error.message : error);
|
|
142
|
+
process.exit(1);
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
export {
|
|
146
|
+
tokensPush
|
|
147
|
+
};
|
|
148
|
+
//# sourceMappingURL=tokens-push-HY3KO36V.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/commands/tokens-push.ts"],"sourcesContent":["/**\n * fragments tokens push — Push code tokens to Fragments Cloud for drift comparison.\n *\n * Extracts CSS custom properties from Tailwind v4 @theme blocks (or config-based\n * token files) and POSTs them to the Fragments Cloud /api/ingest endpoint.\n * Supports --dry-run for local inspection without pushing.\n */\n\nimport { resolve } from 'node:path';\nimport pc from 'picocolors';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface TokensPushOptions {\n /** Path to fragments config file */\n config?: string;\n /** Path to Tailwind v4 CSS file with @theme block */\n tailwindV4?: string;\n /** Parse and display tokens without pushing */\n dryRun?: boolean;\n /** Show detailed output */\n verbose?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// tokensPush\n// ---------------------------------------------------------------------------\n\nexport async function tokensPush(options: TokensPushOptions): Promise<void> {\n const startTime = Date.now();\n\n // 1. Resolve API credentials\n const apiKey = process.env.FRAGMENTS_API_KEY;\n const baseUrl = process.env.FRAGMENTS_URL || 'https://app.usefragments.com';\n\n if (!apiKey && !options.dryRun) {\n console.error(pc.red('Error: FRAGMENTS_API_KEY environment variable is required'));\n console.error(pc.dim('Get your API key from https://app.usefragments.com/api-keys'));\n process.exit(1);\n }\n\n // 2. Token extraction\n const flatMap: Record<string, string> = {};\n\n if (options.tailwindV4) {\n // Use @theme parser for Tailwind v4 CSS files\n const { parseTailwindV4File } = await import('../service/token-parser.js');\n\n const filePath = resolve(process.cwd(), options.tailwindV4);\n const result = parseTailwindV4File(filePath);\n\n if (result.errors.length > 0) {\n for (const err of result.errors) {\n console.error(pc.red(` Error: ${err.message}`));\n }\n }\n\n if (options.verbose && result.warnings.length > 0) {\n for (const warn of result.warnings) {\n console.warn(pc.yellow(` Warning: ${warn}`));\n }\n }\n\n for (const token of result.tokens) {\n flatMap[token.name] = token.resolvedValue;\n }\n\n if (options.verbose) {\n console.log(\n pc.dim(` Parsed ${result.tokens.length} tokens from ${options.tailwindV4} (${result.parseTimeMs.toFixed(1)}ms)`),\n );\n }\n } else if (options.config) {\n // Use config-based token extraction\n try {\n const { loadConfig } = await import('../core/node.js');\n const { parseTokenFiles } = await import('../service/index.js');\n\n const { config, configDir } = await loadConfig(options.config);\n if (config.tokens?.include?.length) {\n const result = await parseTokenFiles(config.tokens, configDir);\n for (const token of result.tokens) {\n flatMap[token.name] = token.resolvedValue;\n }\n\n if (options.verbose) {\n console.log(\n pc.dim(` Parsed ${result.tokens.length} tokens from config (${result.parseTimeMs.toFixed(1)}ms)`),\n );\n }\n } else {\n console.error(pc.red('Error: Config file has no tokens.include patterns'));\n process.exit(1);\n }\n } catch (error) {\n console.error(pc.red('Error loading config:'), error instanceof Error ? error.message : error);\n process.exit(1);\n }\n } else {\n // No source specified — try auto-detection\n try {\n const { loadConfig } = await import('../core/node.js');\n const { parseTokenFiles } = await import('../service/index.js');\n\n const { config, configDir } = await loadConfig();\n if (config.tokens?.include?.length) {\n const result = await parseTokenFiles(config.tokens, configDir);\n for (const token of result.tokens) {\n flatMap[token.name] = token.resolvedValue;\n }\n\n if (options.verbose) {\n console.log(\n pc.dim(` Parsed ${result.tokens.length} tokens from auto-detected config (${result.parseTimeMs.toFixed(1)}ms)`),\n );\n }\n }\n } catch {\n // No config found — fall through to error\n }\n\n if (Object.keys(flatMap).length === 0) {\n console.error(pc.red('Error: No token source specified'));\n console.error(pc.dim('Provide one of:'));\n console.error(pc.dim(' --tailwind-v4 <path> Path to Tailwind v4 CSS file with @theme block'));\n console.error(pc.dim(' --config <path> Path to fragments config with tokens.include'));\n console.error(pc.dim('\\nExample: fragments tokens push --tailwind-v4 ./app.css'));\n process.exit(1);\n }\n }\n\n const tokenCount = Object.keys(flatMap).length;\n\n if (tokenCount === 0) {\n console.log(pc.yellow('No tokens found.'));\n return;\n }\n\n console.log(pc.cyan(`Found ${tokenCount} tokens`));\n\n // 3. Dry run — display tokens and exit\n if (options.dryRun) {\n console.log(pc.dim('\\nDry run — tokens that would be pushed:\\n'));\n const entries = Object.entries(flatMap);\n for (const [name, value] of entries.slice(0, 20)) {\n console.log(` ${pc.bold(name)}: ${value}`);\n }\n if (entries.length > 20) {\n console.log(pc.dim(` ... and ${entries.length - 20} more`));\n }\n return;\n }\n\n // 4. POST to Fragments Cloud\n try {\n const response = await fetch(`${baseUrl}/api/ingest`, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Authorization': `Bearer ${apiKey}`,\n },\n body: JSON.stringify({\n codeTokens: JSON.stringify(flatMap),\n }),\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n console.error(pc.red(`Error: API returned ${response.status}`));\n console.error(pc.dim(errorText));\n process.exit(1);\n }\n\n const result = await response.json() as Record<string, unknown>;\n\n console.log(pc.green(`\\nPushed ${tokenCount} tokens to Fragments Cloud`));\n\n if (result.tokenDrift) {\n const drift = result.tokenDrift as Record<string, unknown>;\n const summary = drift.summary as Record<string, number> | undefined;\n if (summary) {\n console.log(pc.cyan('\\nDrift Summary:'));\n if (summary.total !== undefined) console.log(pc.dim(` Total issues: ${summary.total}`));\n if (summary.missingInCode > 0) console.log(pc.yellow(` Missing in code: ${summary.missingInCode}`));\n if (summary.missingInFigma > 0) console.log(pc.yellow(` Missing in Figma: ${summary.missingInFigma}`));\n if (summary.valueMismatch > 0) console.log(pc.yellow(` Value mismatches: ${summary.valueMismatch}`));\n if (summary.score !== undefined) console.log(` Health score: ${summary.score}%`);\n }\n }\n\n console.log(pc.dim(`\\nView dashboard: ${baseUrl}/tokens`));\n console.log(pc.dim(`Completed in ${Date.now() - startTime}ms`));\n } catch (error) {\n console.error(pc.red('Error pushing tokens:'), error instanceof Error ? error.message : error);\n process.exit(1);\n }\n}\n"],"mappings":"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","names":[]}
|