@agent-scope/cli 1.14.0 → 1.15.0
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/cli.js +1245 -818
- package/dist/cli.js.map +1 -1
- package/dist/index.cjs +1082 -659
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +116 -1
- package/dist/index.d.ts +116 -1
- package/dist/index.js +1073 -654
- package/dist/index.js.map +1 -1
- package/package.json +6 -6
package/dist/cli.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
3
|
// src/program.ts
|
|
4
|
-
import { readFileSync as
|
|
4
|
+
import { readFileSync as readFileSync10 } from "fs";
|
|
5
5
|
import { generateTest, loadTrace } from "@agent-scope/playwright";
|
|
6
|
-
import { Command as
|
|
6
|
+
import { Command as Command9 } from "commander";
|
|
7
7
|
|
|
8
8
|
// src/browser.ts
|
|
9
9
|
import { writeFileSync } from "fs";
|
|
@@ -50,16 +50,935 @@ function writeReportToFile(report, outputPath, pretty) {
|
|
|
50
50
|
writeFileSync(outputPath, json, "utf-8");
|
|
51
51
|
}
|
|
52
52
|
|
|
53
|
+
// src/ci/commands.ts
|
|
54
|
+
import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
|
|
55
|
+
import { resolve as resolve2 } from "path";
|
|
56
|
+
import { generateManifest } from "@agent-scope/manifest";
|
|
57
|
+
import { BrowserPool, safeRender } from "@agent-scope/render";
|
|
58
|
+
import { ComplianceEngine, TokenResolver } from "@agent-scope/tokens";
|
|
59
|
+
import { Command } from "commander";
|
|
60
|
+
|
|
61
|
+
// src/component-bundler.ts
|
|
62
|
+
import { dirname } from "path";
|
|
63
|
+
import * as esbuild from "esbuild";
|
|
64
|
+
async function buildComponentHarness(filePath, componentName, props, viewportWidth, projectCss) {
|
|
65
|
+
const bundledScript = await bundleComponentToIIFE(filePath, componentName, props);
|
|
66
|
+
return wrapInHtml(bundledScript, viewportWidth, projectCss);
|
|
67
|
+
}
|
|
68
|
+
async function bundleComponentToIIFE(filePath, componentName, props) {
|
|
69
|
+
const propsJson = JSON.stringify(props).replace(/<\/script>/gi, "<\\/script>");
|
|
70
|
+
const wrapperCode = (
|
|
71
|
+
/* ts */
|
|
72
|
+
`
|
|
73
|
+
import * as __scopeMod from ${JSON.stringify(filePath)};
|
|
74
|
+
import { createRoot } from "react-dom/client";
|
|
75
|
+
import { createElement } from "react";
|
|
76
|
+
|
|
77
|
+
(function scopeRenderHarness() {
|
|
78
|
+
var Component =
|
|
79
|
+
__scopeMod["default"] ||
|
|
80
|
+
__scopeMod[${JSON.stringify(componentName)}] ||
|
|
81
|
+
(Object.values(__scopeMod).find(
|
|
82
|
+
function(v) { return typeof v === "function" && /^[A-Z]/.test(v.name || ""); }
|
|
83
|
+
));
|
|
84
|
+
|
|
85
|
+
if (!Component) {
|
|
86
|
+
window.__SCOPE_RENDER_ERROR__ =
|
|
87
|
+
"No renderable component found. Checked: default, " +
|
|
88
|
+
${JSON.stringify(componentName)} + ", and PascalCase named exports. " +
|
|
89
|
+
"Available exports: " + Object.keys(__scopeMod).join(", ");
|
|
90
|
+
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
91
|
+
return;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
try {
|
|
95
|
+
var props = ${propsJson};
|
|
96
|
+
var rootEl = document.getElementById("scope-root");
|
|
97
|
+
if (!rootEl) {
|
|
98
|
+
window.__SCOPE_RENDER_ERROR__ = "#scope-root element not found";
|
|
99
|
+
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
102
|
+
createRoot(rootEl).render(createElement(Component, props));
|
|
103
|
+
// Use requestAnimationFrame to let React flush the render
|
|
104
|
+
requestAnimationFrame(function() {
|
|
105
|
+
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
106
|
+
});
|
|
107
|
+
} catch (err) {
|
|
108
|
+
window.__SCOPE_RENDER_ERROR__ = err instanceof Error ? err.message : String(err);
|
|
109
|
+
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
110
|
+
}
|
|
111
|
+
})();
|
|
112
|
+
`
|
|
113
|
+
);
|
|
114
|
+
const result = await esbuild.build({
|
|
115
|
+
stdin: {
|
|
116
|
+
contents: wrapperCode,
|
|
117
|
+
// Resolve relative imports (within the component's dir)
|
|
118
|
+
resolveDir: dirname(filePath),
|
|
119
|
+
loader: "tsx",
|
|
120
|
+
sourcefile: "__scope_harness__.tsx"
|
|
121
|
+
},
|
|
122
|
+
bundle: true,
|
|
123
|
+
format: "iife",
|
|
124
|
+
write: false,
|
|
125
|
+
platform: "browser",
|
|
126
|
+
jsx: "automatic",
|
|
127
|
+
jsxImportSource: "react",
|
|
128
|
+
target: "es2020",
|
|
129
|
+
// Bundle everything — no externals
|
|
130
|
+
external: [],
|
|
131
|
+
define: {
|
|
132
|
+
"process.env.NODE_ENV": '"development"',
|
|
133
|
+
global: "globalThis"
|
|
134
|
+
},
|
|
135
|
+
logLevel: "silent",
|
|
136
|
+
// Suppress "React must be in scope" warnings from old JSX (we use automatic)
|
|
137
|
+
banner: {
|
|
138
|
+
js: "/* @agent-scope/cli component harness */"
|
|
139
|
+
}
|
|
140
|
+
});
|
|
141
|
+
if (result.errors.length > 0) {
|
|
142
|
+
const msg = result.errors.map((e) => `${e.text}${e.location ? ` (${e.location.file}:${e.location.line})` : ""}`).join("\n");
|
|
143
|
+
throw new Error(`esbuild failed to bundle component:
|
|
144
|
+
${msg}`);
|
|
145
|
+
}
|
|
146
|
+
const outputFile = result.outputFiles?.[0];
|
|
147
|
+
if (outputFile === void 0 || outputFile.text.length === 0) {
|
|
148
|
+
throw new Error("esbuild produced no output");
|
|
149
|
+
}
|
|
150
|
+
return outputFile.text;
|
|
151
|
+
}
|
|
152
|
+
function wrapInHtml(bundledScript, viewportWidth, projectCss) {
|
|
153
|
+
const projectStyleBlock = projectCss != null && projectCss.length > 0 ? `<style id="scope-project-css">
|
|
154
|
+
${projectCss.replace(/<\/style>/gi, "<\\/style>")}
|
|
155
|
+
</style>` : "";
|
|
156
|
+
return `<!DOCTYPE html>
|
|
157
|
+
<html lang="en">
|
|
158
|
+
<head>
|
|
159
|
+
<meta charset="UTF-8" />
|
|
160
|
+
<meta name="viewport" content="width=${viewportWidth}, initial-scale=1.0" />
|
|
161
|
+
<style>
|
|
162
|
+
*, *::before, *::after { box-sizing: border-box; }
|
|
163
|
+
html, body { margin: 0; padding: 0; background: #fff; font-family: system-ui, sans-serif; }
|
|
164
|
+
#scope-root { display: inline-block; min-width: 1px; min-height: 1px; }
|
|
165
|
+
</style>
|
|
166
|
+
${projectStyleBlock}
|
|
167
|
+
</head>
|
|
168
|
+
<body>
|
|
169
|
+
<div id="scope-root" data-reactscope-root></div>
|
|
170
|
+
<script>${bundledScript}</script>
|
|
171
|
+
</body>
|
|
172
|
+
</html>`;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
// src/manifest-formatter.ts
|
|
176
|
+
function isTTY() {
|
|
177
|
+
return process.stdout.isTTY === true;
|
|
178
|
+
}
|
|
179
|
+
function pad(value, width) {
|
|
180
|
+
return value.length >= width ? value.slice(0, width) : value + " ".repeat(width - value.length);
|
|
181
|
+
}
|
|
182
|
+
function buildTable(headers, rows) {
|
|
183
|
+
const colWidths = headers.map(
|
|
184
|
+
(h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length))
|
|
185
|
+
);
|
|
186
|
+
const divider = colWidths.map((w) => "-".repeat(w)).join(" ");
|
|
187
|
+
const headerRow = headers.map((h, i) => pad(h, colWidths[i] ?? 0)).join(" ");
|
|
188
|
+
const dataRows = rows.map(
|
|
189
|
+
(row2) => row2.map((cell, i) => pad(cell ?? "", colWidths[i] ?? 0)).join(" ")
|
|
190
|
+
);
|
|
191
|
+
return [headerRow, divider, ...dataRows].join("\n");
|
|
192
|
+
}
|
|
193
|
+
function formatListTable(rows) {
|
|
194
|
+
if (rows.length === 0) return "No components found.";
|
|
195
|
+
const headers = ["NAME", "FILE", "COMPLEXITY", "HOOKS", "CONTEXTS"];
|
|
196
|
+
const tableRows = rows.map((r) => [
|
|
197
|
+
r.name,
|
|
198
|
+
r.file,
|
|
199
|
+
r.complexityClass,
|
|
200
|
+
String(r.hookCount),
|
|
201
|
+
String(r.contextCount)
|
|
202
|
+
]);
|
|
203
|
+
return buildTable(headers, tableRows);
|
|
204
|
+
}
|
|
205
|
+
function formatListJson(rows) {
|
|
206
|
+
return JSON.stringify(rows, null, 2);
|
|
207
|
+
}
|
|
208
|
+
function formatSideEffects(se) {
|
|
209
|
+
const parts = [];
|
|
210
|
+
if (se.fetches.length > 0) parts.push(`fetches: ${se.fetches.join(", ")}`);
|
|
211
|
+
if (se.timers) parts.push("timers");
|
|
212
|
+
if (se.subscriptions.length > 0) parts.push(`subscriptions: ${se.subscriptions.join(", ")}`);
|
|
213
|
+
if (se.globalListeners) parts.push("globalListeners");
|
|
214
|
+
return parts.length > 0 ? parts.join(" | ") : "none";
|
|
215
|
+
}
|
|
216
|
+
function formatGetTable(name, descriptor) {
|
|
217
|
+
const propNames = Object.keys(descriptor.props);
|
|
218
|
+
const lines = [
|
|
219
|
+
`Component: ${name}`,
|
|
220
|
+
` File: ${descriptor.filePath}`,
|
|
221
|
+
` Export: ${descriptor.exportType}`,
|
|
222
|
+
` Display Name: ${descriptor.displayName}`,
|
|
223
|
+
` Complexity: ${descriptor.complexityClass}`,
|
|
224
|
+
` Memoized: ${descriptor.memoized}`,
|
|
225
|
+
` Forwarded Ref: ${descriptor.forwardedRef}`,
|
|
226
|
+
` HOC Wrappers: ${descriptor.hocWrappers.join(", ") || "none"}`,
|
|
227
|
+
` Hooks: ${descriptor.detectedHooks.join(", ") || "none"}`,
|
|
228
|
+
` Contexts: ${descriptor.requiredContexts.join(", ") || "none"}`,
|
|
229
|
+
` Composes: ${descriptor.composes.join(", ") || "none"}`,
|
|
230
|
+
` Composed By: ${descriptor.composedBy.join(", ") || "none"}`,
|
|
231
|
+
` Side Effects: ${formatSideEffects(descriptor.sideEffects)}`,
|
|
232
|
+
"",
|
|
233
|
+
` Props (${propNames.length}):`
|
|
234
|
+
];
|
|
235
|
+
if (propNames.length === 0) {
|
|
236
|
+
lines.push(" (none)");
|
|
237
|
+
} else {
|
|
238
|
+
for (const propName of propNames) {
|
|
239
|
+
const p = descriptor.props[propName];
|
|
240
|
+
if (p === void 0) continue;
|
|
241
|
+
const req = p.required ? "required" : "optional";
|
|
242
|
+
const def = p.default !== void 0 ? ` [default: ${p.default}]` : "";
|
|
243
|
+
const vals = p.values !== void 0 ? ` (${p.values.join(" | ")})` : "";
|
|
244
|
+
lines.push(` ${propName}: ${p.rawType}${vals} \u2014 ${req}${def}`);
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
return lines.join("\n");
|
|
248
|
+
}
|
|
249
|
+
function formatGetJson(name, descriptor) {
|
|
250
|
+
return JSON.stringify({ name, ...descriptor }, null, 2);
|
|
251
|
+
}
|
|
252
|
+
function formatQueryTable(rows, queryDesc) {
|
|
253
|
+
if (rows.length === 0) return `No components match: ${queryDesc}`;
|
|
254
|
+
const headers = ["NAME", "FILE", "COMPLEXITY", "HOOKS", "CONTEXTS"];
|
|
255
|
+
const tableRows = rows.map((r) => [r.name, r.file, r.complexityClass, r.hooks, r.contexts]);
|
|
256
|
+
return `Query: ${queryDesc}
|
|
257
|
+
|
|
258
|
+
${buildTable(headers, tableRows)}`;
|
|
259
|
+
}
|
|
260
|
+
function formatQueryJson(rows) {
|
|
261
|
+
return JSON.stringify(rows, null, 2);
|
|
262
|
+
}
|
|
263
|
+
function matchGlob(pattern, value) {
|
|
264
|
+
const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
|
|
265
|
+
const regexStr = escaped.replace(/\*\*/g, "\xA7GLOBSTAR\xA7").replace(/\*/g, "[^/]*").replace(/§GLOBSTAR§/g, ".*");
|
|
266
|
+
const regex = new RegExp(`^${regexStr}$`, "i");
|
|
267
|
+
return regex.test(value);
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
// src/render-formatter.ts
|
|
271
|
+
function parseViewport(spec) {
|
|
272
|
+
const lower = spec.toLowerCase();
|
|
273
|
+
const match = /^(\d+)[x×](\d+)$/.exec(lower);
|
|
274
|
+
if (!match) {
|
|
275
|
+
throw new Error(`Invalid viewport "${spec}". Expected format: WIDTHxHEIGHT (e.g. 1280x720)`);
|
|
276
|
+
}
|
|
277
|
+
const width = parseInt(match[1] ?? "0", 10);
|
|
278
|
+
const height = parseInt(match[2] ?? "0", 10);
|
|
279
|
+
if (width <= 0 || height <= 0) {
|
|
280
|
+
throw new Error(`Viewport dimensions must be positive integers, got: ${spec}`);
|
|
281
|
+
}
|
|
282
|
+
return { width, height };
|
|
283
|
+
}
|
|
284
|
+
function formatRenderJson(componentName, props, result) {
|
|
285
|
+
return {
|
|
286
|
+
component: componentName,
|
|
287
|
+
props,
|
|
288
|
+
width: result.width,
|
|
289
|
+
height: result.height,
|
|
290
|
+
renderTimeMs: result.renderTimeMs,
|
|
291
|
+
computedStyles: result.computedStyles,
|
|
292
|
+
screenshot: result.screenshot.toString("base64"),
|
|
293
|
+
dom: result.dom,
|
|
294
|
+
console: result.console,
|
|
295
|
+
accessibility: result.accessibility
|
|
296
|
+
};
|
|
297
|
+
}
|
|
298
|
+
function formatMatrixJson(result) {
|
|
299
|
+
return {
|
|
300
|
+
axes: result.axes.map((axis) => ({
|
|
301
|
+
name: axis.name,
|
|
302
|
+
values: axis.values.map((v) => String(v))
|
|
303
|
+
})),
|
|
304
|
+
stats: { ...result.stats },
|
|
305
|
+
cells: result.cells.map((cell) => ({
|
|
306
|
+
index: cell.index,
|
|
307
|
+
axisIndices: cell.axisIndices,
|
|
308
|
+
props: cell.props,
|
|
309
|
+
renderTimeMs: cell.result.renderTimeMs,
|
|
310
|
+
width: cell.result.width,
|
|
311
|
+
height: cell.result.height,
|
|
312
|
+
screenshot: cell.result.screenshot.toString("base64")
|
|
313
|
+
}))
|
|
314
|
+
};
|
|
315
|
+
}
|
|
316
|
+
function formatMatrixHtml(componentName, result) {
|
|
317
|
+
const cellsHtml = result.cells.map((cell) => {
|
|
318
|
+
const b64 = cell.result.screenshot.toString("base64");
|
|
319
|
+
const propLabel = escapeHtml(
|
|
320
|
+
Object.entries(cell.props).map(([k, v]) => `${k}: ${String(v)}`).join(", ")
|
|
321
|
+
);
|
|
322
|
+
return ` <div class="cell">
|
|
323
|
+
<img src="data:image/png;base64,${b64}" alt="${propLabel}" width="${cell.result.width}" height="${cell.result.height}" />
|
|
324
|
+
<div class="label">${propLabel}</div>
|
|
325
|
+
<div class="meta">${cell.result.renderTimeMs.toFixed(1)}ms</div>
|
|
326
|
+
</div>`;
|
|
327
|
+
}).join("\n");
|
|
328
|
+
const axesDesc = result.axes.map((a) => `${a.name}: ${a.values.map((v) => String(v)).join(", ")}`).join(" | ");
|
|
329
|
+
return `<!DOCTYPE html>
|
|
330
|
+
<html lang="en">
|
|
331
|
+
<head>
|
|
332
|
+
<meta charset="UTF-8" />
|
|
333
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
334
|
+
<title>${escapeHtml(componentName)} \u2014 Render Matrix</title>
|
|
335
|
+
<style>
|
|
336
|
+
body { font-family: system-ui, sans-serif; background: #f8fafc; margin: 0; padding: 24px; }
|
|
337
|
+
h1 { font-size: 1.25rem; color: #1e293b; margin-bottom: 8px; }
|
|
338
|
+
.axes { font-size: 0.8rem; color: #64748b; margin-bottom: 20px; }
|
|
339
|
+
.grid { display: flex; flex-wrap: wrap; gap: 16px; }
|
|
340
|
+
.cell { background: #fff; border: 1px solid #e2e8f0; border-radius: 8px; overflow: hidden; }
|
|
341
|
+
.cell img { display: block; }
|
|
342
|
+
.label { padding: 6px 8px; font-size: 0.75rem; color: #374151; border-top: 1px solid #f1f5f9; }
|
|
343
|
+
.meta { padding: 2px 8px 6px; font-size: 0.7rem; color: #94a3b8; }
|
|
344
|
+
.stats { margin-top: 24px; font-size: 0.8rem; color: #64748b; }
|
|
345
|
+
</style>
|
|
346
|
+
</head>
|
|
347
|
+
<body>
|
|
348
|
+
<h1>${escapeHtml(componentName)} \u2014 Render Matrix</h1>
|
|
349
|
+
<div class="axes">Axes: ${escapeHtml(axesDesc)}</div>
|
|
350
|
+
<div class="grid">
|
|
351
|
+
${cellsHtml}
|
|
352
|
+
</div>
|
|
353
|
+
<div class="stats">
|
|
354
|
+
${result.stats.totalCells} cells \xB7
|
|
355
|
+
avg ${result.stats.avgRenderTimeMs.toFixed(1)}ms \xB7
|
|
356
|
+
min ${result.stats.minRenderTimeMs.toFixed(1)}ms \xB7
|
|
357
|
+
max ${result.stats.maxRenderTimeMs.toFixed(1)}ms \xB7
|
|
358
|
+
wall ${result.stats.wallClockTimeMs.toFixed(0)}ms
|
|
359
|
+
</div>
|
|
360
|
+
</body>
|
|
361
|
+
</html>
|
|
362
|
+
`;
|
|
363
|
+
}
|
|
364
|
+
function formatMatrixCsv(componentName, result) {
|
|
365
|
+
const axisNames = result.axes.map((a) => a.name);
|
|
366
|
+
const headers = ["component", ...axisNames, "renderTimeMs", "width", "height"];
|
|
367
|
+
const rows = result.cells.map((cell) => {
|
|
368
|
+
const axisVals = result.axes.map((_, i) => {
|
|
369
|
+
const axisIdx = cell.axisIndices[i];
|
|
370
|
+
const axis = result.axes[i];
|
|
371
|
+
if (axisIdx === void 0 || axis === void 0) return "";
|
|
372
|
+
const val = axis.values[axisIdx];
|
|
373
|
+
return val !== void 0 ? csvEscape(String(val)) : "";
|
|
374
|
+
});
|
|
375
|
+
return [
|
|
376
|
+
csvEscape(componentName),
|
|
377
|
+
...axisVals,
|
|
378
|
+
cell.result.renderTimeMs.toFixed(3),
|
|
379
|
+
String(cell.result.width),
|
|
380
|
+
String(cell.result.height)
|
|
381
|
+
].join(",");
|
|
382
|
+
});
|
|
383
|
+
return `${[headers.join(","), ...rows].join("\n")}
|
|
384
|
+
`;
|
|
385
|
+
}
|
|
386
|
+
function renderProgressBar(completed, total, currentName, pct, barWidth = 20) {
|
|
387
|
+
const filled = Math.round(pct / 100 * barWidth);
|
|
388
|
+
const empty = barWidth - filled;
|
|
389
|
+
const bar = "=".repeat(Math.max(0, filled - 1)) + (filled > 0 ? ">" : "") + " ".repeat(empty);
|
|
390
|
+
const nameSlice = currentName.slice(0, 25).padEnd(25);
|
|
391
|
+
return `Rendering ${completed}/${total} ${nameSlice} [${bar}] ${pct}%`;
|
|
392
|
+
}
|
|
393
|
+
function formatSummaryText(results, outputDir) {
|
|
394
|
+
const total = results.length;
|
|
395
|
+
const passed = results.filter((r) => r.success).length;
|
|
396
|
+
const failed = total - passed;
|
|
397
|
+
const successTimes = results.filter((r) => r.success).map((r) => r.renderTimeMs);
|
|
398
|
+
const avgMs = successTimes.length > 0 ? successTimes.reduce((a, b) => a + b, 0) / successTimes.length : 0;
|
|
399
|
+
const lines = [
|
|
400
|
+
"\u2500".repeat(60),
|
|
401
|
+
`Render Summary`,
|
|
402
|
+
"\u2500".repeat(60),
|
|
403
|
+
` Total components : ${total}`,
|
|
404
|
+
` Passed : ${passed}`,
|
|
405
|
+
` Failed : ${failed}`,
|
|
406
|
+
` Avg render time : ${avgMs.toFixed(1)}ms`,
|
|
407
|
+
` Output dir : ${outputDir}`
|
|
408
|
+
];
|
|
409
|
+
if (failed > 0) {
|
|
410
|
+
lines.push("", " Failed components:");
|
|
411
|
+
for (const r of results) {
|
|
412
|
+
if (!r.success) {
|
|
413
|
+
lines.push(` \u2717 ${r.name}: ${r.errorMessage ?? "unknown error"}`);
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
lines.push("\u2500".repeat(60));
|
|
418
|
+
return lines.join("\n");
|
|
419
|
+
}
|
|
420
|
+
function escapeHtml(str) {
|
|
421
|
+
return str.replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">").replace(/"/g, """).replace(/'/g, "'");
|
|
422
|
+
}
|
|
423
|
+
function csvEscape(value) {
|
|
424
|
+
if (value.includes(",") || value.includes('"') || value.includes("\n")) {
|
|
425
|
+
return `"${value.replace(/"/g, '""')}"`;
|
|
426
|
+
}
|
|
427
|
+
return value;
|
|
428
|
+
}
|
|
429
|
+
|
|
430
|
+
// src/tailwind-css.ts
|
|
431
|
+
import { existsSync, readFileSync } from "fs";
|
|
432
|
+
import { createRequire } from "module";
|
|
433
|
+
import { resolve } from "path";
|
|
434
|
+
var CONFIG_FILENAMES = [
|
|
435
|
+
".reactscope/config.json",
|
|
436
|
+
".reactscope/config.js",
|
|
437
|
+
".reactscope/config.mjs"
|
|
438
|
+
];
|
|
439
|
+
var STYLE_ENTRY_CANDIDATES = [
|
|
440
|
+
"src/index.css",
|
|
441
|
+
"src/globals.css",
|
|
442
|
+
"app/globals.css",
|
|
443
|
+
"app/index.css",
|
|
444
|
+
"styles/index.css",
|
|
445
|
+
"index.css"
|
|
446
|
+
];
|
|
447
|
+
var TAILWIND_IMPORT = /@import\s+["']tailwindcss["']\s*;?/;
|
|
448
|
+
var compilerCache = null;
|
|
449
|
+
function getCachedBuild(cwd) {
|
|
450
|
+
if (compilerCache !== null && resolve(compilerCache.cwd) === resolve(cwd)) {
|
|
451
|
+
return compilerCache.build;
|
|
452
|
+
}
|
|
453
|
+
return null;
|
|
454
|
+
}
|
|
455
|
+
function findStylesEntry(cwd) {
|
|
456
|
+
for (const name of CONFIG_FILENAMES) {
|
|
457
|
+
const p = resolve(cwd, name);
|
|
458
|
+
if (!existsSync(p)) continue;
|
|
459
|
+
try {
|
|
460
|
+
if (name.endsWith(".json")) {
|
|
461
|
+
const raw = readFileSync(p, "utf-8");
|
|
462
|
+
const data = JSON.parse(raw);
|
|
463
|
+
const scope = data.scope;
|
|
464
|
+
const entry = scope?.stylesEntry ?? data.stylesEntry;
|
|
465
|
+
if (typeof entry === "string") {
|
|
466
|
+
const full = resolve(cwd, entry);
|
|
467
|
+
if (existsSync(full)) return full;
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
} catch {
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
const pkgPath = resolve(cwd, "package.json");
|
|
474
|
+
if (existsSync(pkgPath)) {
|
|
475
|
+
try {
|
|
476
|
+
const raw = readFileSync(pkgPath, "utf-8");
|
|
477
|
+
const pkg = JSON.parse(raw);
|
|
478
|
+
const entry = pkg.scope?.stylesEntry;
|
|
479
|
+
if (typeof entry === "string") {
|
|
480
|
+
const full = resolve(cwd, entry);
|
|
481
|
+
if (existsSync(full)) return full;
|
|
482
|
+
}
|
|
483
|
+
} catch {
|
|
484
|
+
}
|
|
485
|
+
}
|
|
486
|
+
for (const candidate of STYLE_ENTRY_CANDIDATES) {
|
|
487
|
+
const full = resolve(cwd, candidate);
|
|
488
|
+
if (existsSync(full)) {
|
|
489
|
+
try {
|
|
490
|
+
const content = readFileSync(full, "utf-8");
|
|
491
|
+
if (TAILWIND_IMPORT.test(content)) return full;
|
|
492
|
+
} catch {
|
|
493
|
+
}
|
|
494
|
+
}
|
|
495
|
+
}
|
|
496
|
+
return null;
|
|
497
|
+
}
|
|
498
|
+
async function getTailwindCompiler(cwd) {
|
|
499
|
+
const cached = getCachedBuild(cwd);
|
|
500
|
+
if (cached !== null) return cached;
|
|
501
|
+
const entryPath = findStylesEntry(cwd);
|
|
502
|
+
if (entryPath === null) return null;
|
|
503
|
+
let compile;
|
|
504
|
+
try {
|
|
505
|
+
const require2 = createRequire(resolve(cwd, "package.json"));
|
|
506
|
+
const tailwind = require2("tailwindcss");
|
|
507
|
+
const fn = tailwind.compile;
|
|
508
|
+
if (typeof fn !== "function") return null;
|
|
509
|
+
compile = fn;
|
|
510
|
+
} catch {
|
|
511
|
+
return null;
|
|
512
|
+
}
|
|
513
|
+
const entryContent = readFileSync(entryPath, "utf-8");
|
|
514
|
+
const loadStylesheet = async (id, base) => {
|
|
515
|
+
if (id === "tailwindcss") {
|
|
516
|
+
const nodeModules = resolve(cwd, "node_modules");
|
|
517
|
+
const tailwindCssPath = resolve(nodeModules, "tailwindcss", "index.css");
|
|
518
|
+
if (!existsSync(tailwindCssPath)) {
|
|
519
|
+
throw new Error(
|
|
520
|
+
`Tailwind v4: tailwindcss package not found at ${tailwindCssPath}. Install with: npm install tailwindcss`
|
|
521
|
+
);
|
|
522
|
+
}
|
|
523
|
+
const content = readFileSync(tailwindCssPath, "utf-8");
|
|
524
|
+
return { path: "virtual:tailwindcss/index.css", base, content };
|
|
525
|
+
}
|
|
526
|
+
const full = resolve(base, id);
|
|
527
|
+
if (existsSync(full)) {
|
|
528
|
+
const content = readFileSync(full, "utf-8");
|
|
529
|
+
return { path: full, base: resolve(full, ".."), content };
|
|
530
|
+
}
|
|
531
|
+
throw new Error(`Tailwind v4: could not load stylesheet: ${id} (base: ${base})`);
|
|
532
|
+
};
|
|
533
|
+
const result = await compile(entryContent, {
|
|
534
|
+
base: cwd,
|
|
535
|
+
from: entryPath,
|
|
536
|
+
loadStylesheet
|
|
537
|
+
});
|
|
538
|
+
const build2 = result.build.bind(result);
|
|
539
|
+
compilerCache = { cwd, build: build2 };
|
|
540
|
+
return build2;
|
|
541
|
+
}
|
|
542
|
+
async function getCompiledCssForClasses(cwd, classes) {
|
|
543
|
+
const build2 = await getTailwindCompiler(cwd);
|
|
544
|
+
if (build2 === null) return null;
|
|
545
|
+
const deduped = [...new Set(classes)].filter(Boolean);
|
|
546
|
+
if (deduped.length === 0) return null;
|
|
547
|
+
return build2(deduped);
|
|
548
|
+
}
|
|
549
|
+
|
|
550
|
+
// src/ci/commands.ts
|
|
551
|
+
var CI_EXIT = {
|
|
552
|
+
/** All checks passed */
|
|
553
|
+
OK: 0,
|
|
554
|
+
/** Compliance score below threshold */
|
|
555
|
+
COMPLIANCE_BELOW_THRESHOLD: 1,
|
|
556
|
+
/** Accessibility violations found */
|
|
557
|
+
A11Y_VIOLATIONS: 2,
|
|
558
|
+
/** Console errors detected during render */
|
|
559
|
+
CONSOLE_ERRORS: 3,
|
|
560
|
+
/** Visual regression detected against baseline */
|
|
561
|
+
VISUAL_REGRESSION: 4,
|
|
562
|
+
/** One or more components failed to render */
|
|
563
|
+
RENDER_FAILURES: 5
|
|
564
|
+
};
|
|
565
|
+
var ALL_CHECKS = ["compliance", "a11y", "console-errors", "visual-regression"];
|
|
566
|
+
var _pool = null;
|
|
567
|
+
async function getPool(viewportWidth, viewportHeight) {
|
|
568
|
+
if (_pool === null) {
|
|
569
|
+
_pool = new BrowserPool({
|
|
570
|
+
size: { browsers: 1, pagesPerBrowser: 4 },
|
|
571
|
+
viewportWidth,
|
|
572
|
+
viewportHeight
|
|
573
|
+
});
|
|
574
|
+
await _pool.init();
|
|
575
|
+
}
|
|
576
|
+
return _pool;
|
|
577
|
+
}
|
|
578
|
+
async function shutdownPool() {
|
|
579
|
+
if (_pool !== null) {
|
|
580
|
+
await _pool.close();
|
|
581
|
+
_pool = null;
|
|
582
|
+
}
|
|
583
|
+
}
|
|
584
|
+
async function renderComponent(filePath, componentName, props, viewportWidth, viewportHeight) {
|
|
585
|
+
const pool = await getPool(viewportWidth, viewportHeight);
|
|
586
|
+
const htmlHarness = await buildComponentHarness(filePath, componentName, props, viewportWidth);
|
|
587
|
+
const slot = await pool.acquire();
|
|
588
|
+
const { page } = slot;
|
|
589
|
+
try {
|
|
590
|
+
await page.setContent(htmlHarness, { waitUntil: "load" });
|
|
591
|
+
await page.waitForFunction(
|
|
592
|
+
() => {
|
|
593
|
+
const w = window;
|
|
594
|
+
return w.__SCOPE_RENDER_COMPLETE__ === true;
|
|
595
|
+
},
|
|
596
|
+
{ timeout: 15e3 }
|
|
597
|
+
);
|
|
598
|
+
const renderError = await page.evaluate(() => {
|
|
599
|
+
return window.__SCOPE_RENDER_ERROR__ ?? null;
|
|
600
|
+
});
|
|
601
|
+
if (renderError !== null) {
|
|
602
|
+
throw new Error(`Component render error: ${renderError}`);
|
|
603
|
+
}
|
|
604
|
+
const rootDir = process.cwd();
|
|
605
|
+
const classes = await page.evaluate(() => {
|
|
606
|
+
const set = /* @__PURE__ */ new Set();
|
|
607
|
+
document.querySelectorAll("[class]").forEach((el) => {
|
|
608
|
+
for (const c of el.className.split(/\s+/)) {
|
|
609
|
+
if (c) set.add(c);
|
|
610
|
+
}
|
|
611
|
+
});
|
|
612
|
+
return [...set];
|
|
613
|
+
});
|
|
614
|
+
const projectCss = await getCompiledCssForClasses(rootDir, classes);
|
|
615
|
+
if (projectCss != null && projectCss.length > 0) {
|
|
616
|
+
await page.addStyleTag({ content: projectCss });
|
|
617
|
+
}
|
|
618
|
+
const startMs = performance.now();
|
|
619
|
+
const rootLocator = page.locator("[data-reactscope-root]");
|
|
620
|
+
const boundingBox = await rootLocator.boundingBox();
|
|
621
|
+
if (boundingBox === null || boundingBox.width === 0 || boundingBox.height === 0) {
|
|
622
|
+
throw new Error(
|
|
623
|
+
`Component "${componentName}" rendered with zero bounding box \u2014 it may be invisible or not mounted`
|
|
624
|
+
);
|
|
625
|
+
}
|
|
626
|
+
const PAD = 24;
|
|
627
|
+
const MIN_W = 320;
|
|
628
|
+
const MIN_H = 200;
|
|
629
|
+
const clipX = Math.max(0, boundingBox.x - PAD);
|
|
630
|
+
const clipY = Math.max(0, boundingBox.y - PAD);
|
|
631
|
+
const rawW = boundingBox.width + PAD * 2;
|
|
632
|
+
const rawH = boundingBox.height + PAD * 2;
|
|
633
|
+
const clipW = Math.max(rawW, MIN_W);
|
|
634
|
+
const clipH = Math.max(rawH, MIN_H);
|
|
635
|
+
const safeW = Math.min(clipW, viewportWidth - clipX);
|
|
636
|
+
const safeH = Math.min(clipH, viewportHeight - clipY);
|
|
637
|
+
const screenshot = await page.screenshot({
|
|
638
|
+
clip: { x: clipX, y: clipY, width: safeW, height: safeH },
|
|
639
|
+
type: "png"
|
|
640
|
+
});
|
|
641
|
+
const computedStylesRaw = {};
|
|
642
|
+
const styles = await page.evaluate((sel) => {
|
|
643
|
+
const el = document.querySelector(sel);
|
|
644
|
+
if (el === null) return {};
|
|
645
|
+
const computed = window.getComputedStyle(el);
|
|
646
|
+
const out = {};
|
|
647
|
+
for (const prop of [
|
|
648
|
+
"display",
|
|
649
|
+
"width",
|
|
650
|
+
"height",
|
|
651
|
+
"color",
|
|
652
|
+
"backgroundColor",
|
|
653
|
+
"fontSize",
|
|
654
|
+
"fontFamily",
|
|
655
|
+
"padding",
|
|
656
|
+
"margin"
|
|
657
|
+
]) {
|
|
658
|
+
out[prop] = computed.getPropertyValue(prop);
|
|
659
|
+
}
|
|
660
|
+
return out;
|
|
661
|
+
}, "[data-reactscope-root] > *");
|
|
662
|
+
computedStylesRaw["[data-reactscope-root] > *"] = styles;
|
|
663
|
+
const renderTimeMs = performance.now() - startMs;
|
|
664
|
+
return {
|
|
665
|
+
screenshot,
|
|
666
|
+
width: Math.round(safeW),
|
|
667
|
+
height: Math.round(safeH),
|
|
668
|
+
renderTimeMs,
|
|
669
|
+
computedStyles: computedStylesRaw
|
|
670
|
+
};
|
|
671
|
+
} finally {
|
|
672
|
+
pool.release(slot);
|
|
673
|
+
}
|
|
674
|
+
}
|
|
675
|
+
function extractComputedStyles(computedStylesRaw) {
|
|
676
|
+
const flat = {};
|
|
677
|
+
for (const styles of Object.values(computedStylesRaw)) {
|
|
678
|
+
Object.assign(flat, styles);
|
|
679
|
+
}
|
|
680
|
+
const colors = {};
|
|
681
|
+
const spacing = {};
|
|
682
|
+
const typography = {};
|
|
683
|
+
const borders = {};
|
|
684
|
+
const shadows = {};
|
|
685
|
+
for (const [prop, value] of Object.entries(flat)) {
|
|
686
|
+
if (prop === "color" || prop === "backgroundColor") {
|
|
687
|
+
colors[prop] = value;
|
|
688
|
+
} else if (prop === "padding" || prop === "margin") {
|
|
689
|
+
spacing[prop] = value;
|
|
690
|
+
} else if (prop === "fontSize" || prop === "fontFamily" || prop === "fontWeight" || prop === "lineHeight") {
|
|
691
|
+
typography[prop] = value;
|
|
692
|
+
} else if (prop === "borderRadius" || prop === "borderWidth") {
|
|
693
|
+
borders[prop] = value;
|
|
694
|
+
} else if (prop === "boxShadow") {
|
|
695
|
+
shadows[prop] = value;
|
|
696
|
+
}
|
|
697
|
+
}
|
|
698
|
+
return { colors, spacing, typography, borders, shadows };
|
|
699
|
+
}
|
|
700
|
+
function loadBaselineRenderJson(baselineDir, componentName) {
|
|
701
|
+
const jsonPath = resolve2(baselineDir, "renders", `${componentName}.json`);
|
|
702
|
+
if (!existsSync2(jsonPath)) return null;
|
|
703
|
+
return JSON.parse(readFileSync2(jsonPath, "utf-8"));
|
|
704
|
+
}
|
|
705
|
+
async function runCi(options = {}) {
|
|
706
|
+
const {
|
|
707
|
+
baselineDir: baselineDirRaw,
|
|
708
|
+
checks = ALL_CHECKS,
|
|
709
|
+
complianceThreshold = 0.9,
|
|
710
|
+
viewportWidth = 375,
|
|
711
|
+
viewportHeight = 812
|
|
712
|
+
} = options;
|
|
713
|
+
const startTime = performance.now();
|
|
714
|
+
const rootDir = process.cwd();
|
|
715
|
+
const checksSet = new Set(checks);
|
|
716
|
+
const baselineDir = baselineDirRaw !== void 0 ? resolve2(rootDir, baselineDirRaw) : void 0;
|
|
717
|
+
process.stderr.write("Scanning for React components\u2026\n");
|
|
718
|
+
const manifest = await generateManifest({ rootDir });
|
|
719
|
+
const componentNames = Object.keys(manifest.components);
|
|
720
|
+
const total = componentNames.length;
|
|
721
|
+
process.stderr.write(`Found ${total} components.
|
|
722
|
+
`);
|
|
723
|
+
process.stderr.write(`Rendering ${total} components\u2026
|
|
724
|
+
`);
|
|
725
|
+
const computedStylesMap = /* @__PURE__ */ new Map();
|
|
726
|
+
const currentRenderMeta = /* @__PURE__ */ new Map();
|
|
727
|
+
const renderFailures = /* @__PURE__ */ new Set();
|
|
728
|
+
let completed = 0;
|
|
729
|
+
const CONCURRENCY = 4;
|
|
730
|
+
let nextIdx = 0;
|
|
731
|
+
const renderOne = async (name) => {
|
|
732
|
+
const descriptor = manifest.components[name];
|
|
733
|
+
if (descriptor === void 0) return;
|
|
734
|
+
const filePath = resolve2(rootDir, descriptor.filePath);
|
|
735
|
+
const outcome = await safeRender(
|
|
736
|
+
() => renderComponent(filePath, name, {}, viewportWidth, viewportHeight),
|
|
737
|
+
{
|
|
738
|
+
props: {},
|
|
739
|
+
sourceLocation: {
|
|
740
|
+
file: descriptor.filePath,
|
|
741
|
+
line: descriptor.loc.start,
|
|
742
|
+
column: 0
|
|
743
|
+
}
|
|
744
|
+
}
|
|
745
|
+
);
|
|
746
|
+
completed++;
|
|
747
|
+
const pct = Math.round(completed / total * 100);
|
|
748
|
+
if (isTTY()) {
|
|
749
|
+
process.stderr.write(`${renderProgressBar(completed, total, name, pct)}\r`);
|
|
750
|
+
}
|
|
751
|
+
if (outcome.crashed) {
|
|
752
|
+
renderFailures.add(name);
|
|
753
|
+
return;
|
|
754
|
+
}
|
|
755
|
+
const result = outcome.result;
|
|
756
|
+
currentRenderMeta.set(name, { width: result.width, height: result.height });
|
|
757
|
+
computedStylesMap.set(name, extractComputedStyles(result.computedStyles));
|
|
758
|
+
};
|
|
759
|
+
if (total > 0) {
|
|
760
|
+
const worker = async () => {
|
|
761
|
+
while (nextIdx < componentNames.length) {
|
|
762
|
+
const i = nextIdx++;
|
|
763
|
+
const name = componentNames[i];
|
|
764
|
+
if (name !== void 0) {
|
|
765
|
+
await renderOne(name);
|
|
766
|
+
}
|
|
767
|
+
}
|
|
768
|
+
};
|
|
769
|
+
const workers = [];
|
|
770
|
+
for (let w = 0; w < Math.min(CONCURRENCY, total); w++) {
|
|
771
|
+
workers.push(worker());
|
|
772
|
+
}
|
|
773
|
+
await Promise.all(workers);
|
|
774
|
+
}
|
|
775
|
+
await shutdownPool();
|
|
776
|
+
if (isTTY() && total > 0) {
|
|
777
|
+
process.stderr.write("\n");
|
|
778
|
+
}
|
|
779
|
+
const resolver = new TokenResolver([]);
|
|
780
|
+
const engine = new ComplianceEngine(resolver);
|
|
781
|
+
const batchReport = engine.auditBatch(computedStylesMap);
|
|
782
|
+
const complianceScore = batchReport.aggregateCompliance;
|
|
783
|
+
const checkResults = [];
|
|
784
|
+
const renderFailureCount = renderFailures.size;
|
|
785
|
+
const rendersPassed = renderFailureCount === 0;
|
|
786
|
+
if (checksSet.has("compliance")) {
|
|
787
|
+
const compliancePassed = complianceScore >= complianceThreshold;
|
|
788
|
+
checkResults.push({
|
|
789
|
+
check: "compliance",
|
|
790
|
+
passed: compliancePassed,
|
|
791
|
+
message: compliancePassed ? `Compliance ${(complianceScore * 100).toFixed(1)}% >= threshold ${(complianceThreshold * 100).toFixed(1)}%` : `Compliance ${(complianceScore * 100).toFixed(1)}% < threshold ${(complianceThreshold * 100).toFixed(1)}%`,
|
|
792
|
+
value: complianceScore,
|
|
793
|
+
threshold: complianceThreshold
|
|
794
|
+
});
|
|
795
|
+
}
|
|
796
|
+
if (checksSet.has("a11y")) {
|
|
797
|
+
checkResults.push({
|
|
798
|
+
check: "a11y",
|
|
799
|
+
passed: true,
|
|
800
|
+
message: "Accessibility audit not yet implemented \u2014 skipped"
|
|
801
|
+
});
|
|
802
|
+
}
|
|
803
|
+
if (checksSet.has("console-errors")) {
|
|
804
|
+
const consoleErrorsPassed = rendersPassed;
|
|
805
|
+
checkResults.push({
|
|
806
|
+
check: "console-errors",
|
|
807
|
+
passed: consoleErrorsPassed,
|
|
808
|
+
message: consoleErrorsPassed ? "No console errors detected" : `Console errors likely \u2014 ${renderFailureCount} component(s) failed to render`
|
|
809
|
+
});
|
|
810
|
+
}
|
|
811
|
+
let hasVisualRegression = false;
|
|
812
|
+
if (checksSet.has("visual-regression") && baselineDir !== void 0) {
|
|
813
|
+
if (!existsSync2(baselineDir)) {
|
|
814
|
+
process.stderr.write(
|
|
815
|
+
`Warning: baseline directory not found at "${baselineDir}" \u2014 skipping visual regression check.
|
|
816
|
+
`
|
|
817
|
+
);
|
|
818
|
+
checkResults.push({
|
|
819
|
+
check: "visual-regression",
|
|
820
|
+
passed: true,
|
|
821
|
+
message: `Baseline not found at ${baselineDir} \u2014 skipped`
|
|
822
|
+
});
|
|
823
|
+
} else {
|
|
824
|
+
const regressions = [];
|
|
825
|
+
for (const name of componentNames) {
|
|
826
|
+
const baselineMeta = loadBaselineRenderJson(baselineDir, name);
|
|
827
|
+
const currentMeta = currentRenderMeta.get(name);
|
|
828
|
+
if (baselineMeta !== null && currentMeta !== void 0) {
|
|
829
|
+
const dw = Math.abs(currentMeta.width - baselineMeta.width);
|
|
830
|
+
const dh = Math.abs(currentMeta.height - baselineMeta.height);
|
|
831
|
+
if (dw > 10 || dh > 10) {
|
|
832
|
+
regressions.push(name);
|
|
833
|
+
}
|
|
834
|
+
}
|
|
835
|
+
}
|
|
836
|
+
hasVisualRegression = regressions.length > 0;
|
|
837
|
+
checkResults.push({
|
|
838
|
+
check: "visual-regression",
|
|
839
|
+
passed: !hasVisualRegression,
|
|
840
|
+
message: hasVisualRegression ? `Visual regression detected in ${regressions.length} component(s): ${regressions.slice(0, 5).join(", ")}${regressions.length > 5 ? "..." : ""}` : "No visual regressions detected"
|
|
841
|
+
});
|
|
842
|
+
}
|
|
843
|
+
}
|
|
844
|
+
let exitCode = CI_EXIT.OK;
|
|
845
|
+
const complianceResult = checkResults.find((r) => r.check === "compliance");
|
|
846
|
+
const a11yResult = checkResults.find((r) => r.check === "a11y");
|
|
847
|
+
const consoleResult = checkResults.find((r) => r.check === "console-errors");
|
|
848
|
+
const visualResult = checkResults.find((r) => r.check === "visual-regression");
|
|
849
|
+
if (complianceResult !== void 0 && !complianceResult.passed) {
|
|
850
|
+
exitCode = CI_EXIT.COMPLIANCE_BELOW_THRESHOLD;
|
|
851
|
+
} else if (a11yResult !== void 0 && !a11yResult.passed) {
|
|
852
|
+
exitCode = CI_EXIT.A11Y_VIOLATIONS;
|
|
853
|
+
} else if (consoleResult !== void 0 && !consoleResult.passed) {
|
|
854
|
+
exitCode = CI_EXIT.CONSOLE_ERRORS;
|
|
855
|
+
} else if (visualResult !== void 0 && !visualResult.passed) {
|
|
856
|
+
exitCode = CI_EXIT.VISUAL_REGRESSION;
|
|
857
|
+
} else if (!rendersPassed) {
|
|
858
|
+
exitCode = CI_EXIT.RENDER_FAILURES;
|
|
859
|
+
}
|
|
860
|
+
const passed = exitCode === CI_EXIT.OK;
|
|
861
|
+
const wallClockMs = performance.now() - startTime;
|
|
862
|
+
return {
|
|
863
|
+
ranAt: (/* @__PURE__ */ new Date()).toISOString(),
|
|
864
|
+
passed,
|
|
865
|
+
exitCode,
|
|
866
|
+
checks: checkResults,
|
|
867
|
+
components: {
|
|
868
|
+
total,
|
|
869
|
+
rendered: total - renderFailureCount,
|
|
870
|
+
failed: renderFailureCount
|
|
871
|
+
},
|
|
872
|
+
complianceScore,
|
|
873
|
+
complianceThreshold,
|
|
874
|
+
baselineCompared: baselineDir !== void 0 && existsSync2(baselineDir),
|
|
875
|
+
wallClockMs
|
|
876
|
+
};
|
|
877
|
+
}
|
|
878
|
+
function formatCiReport(result) {
|
|
879
|
+
const lines = [];
|
|
880
|
+
const title = "Scope CI Report";
|
|
881
|
+
const rule2 = "=".repeat(Math.max(title.length, 40));
|
|
882
|
+
lines.push(title, rule2);
|
|
883
|
+
const { total, rendered, failed } = result.components;
|
|
884
|
+
lines.push(
|
|
885
|
+
`Components: ${total} total ${rendered} rendered${failed > 0 ? ` ${failed} failed` : ""}`
|
|
886
|
+
);
|
|
887
|
+
lines.push("");
|
|
888
|
+
for (const check of result.checks) {
|
|
889
|
+
const icon = check.passed ? "pass" : "FAIL";
|
|
890
|
+
lines.push(` [${icon}] ${check.message}`);
|
|
891
|
+
}
|
|
892
|
+
if (result.components.failed > 0) {
|
|
893
|
+
lines.push(` [FAIL] ${result.components.failed} component(s) failed to render`);
|
|
894
|
+
}
|
|
895
|
+
lines.push("");
|
|
896
|
+
lines.push(rule2);
|
|
897
|
+
if (result.passed) {
|
|
898
|
+
lines.push(
|
|
899
|
+
`CI passed in ${(result.wallClockMs / 1e3).toFixed(1)}s (exit code ${result.exitCode})`
|
|
900
|
+
);
|
|
901
|
+
} else {
|
|
902
|
+
lines.push(
|
|
903
|
+
`CI failed in ${(result.wallClockMs / 1e3).toFixed(1)}s (exit code ${result.exitCode})`
|
|
904
|
+
);
|
|
905
|
+
}
|
|
906
|
+
return lines.join("\n");
|
|
907
|
+
}
|
|
908
|
+
function parseChecks(raw) {
|
|
909
|
+
if (raw === void 0) return void 0;
|
|
910
|
+
const parts = raw.split(",").map((s) => s.trim()).filter(Boolean);
|
|
911
|
+
if (parts.length === 0) return void 0;
|
|
912
|
+
const valid = new Set(ALL_CHECKS);
|
|
913
|
+
const parsed = [];
|
|
914
|
+
for (const part of parts) {
|
|
915
|
+
if (!valid.has(part)) {
|
|
916
|
+
process.stderr.write(
|
|
917
|
+
`Warning: unknown check "${part}" \u2014 valid checks are: ${ALL_CHECKS.join(", ")}
|
|
918
|
+
`
|
|
919
|
+
);
|
|
920
|
+
continue;
|
|
921
|
+
}
|
|
922
|
+
parsed.push(part);
|
|
923
|
+
}
|
|
924
|
+
return parsed.length > 0 ? parsed : void 0;
|
|
925
|
+
}
|
|
926
|
+
function createCiCommand() {
|
|
927
|
+
return new Command("ci").description(
|
|
928
|
+
"Run a non-interactive CI pipeline (manifest -> render -> compliance -> regression) with exit codes"
|
|
929
|
+
).option(
|
|
930
|
+
"-b, --baseline <dir>",
|
|
931
|
+
"Baseline directory for visual regression comparison (omit to skip)"
|
|
932
|
+
).option(
|
|
933
|
+
"--checks <list>",
|
|
934
|
+
`Comma-separated checks to run (default: all). Valid: ${ALL_CHECKS.join(", ")}`
|
|
935
|
+
).option("--threshold <n>", "Compliance pass threshold (0-1, default: 0.90)", "0.90").option("--viewport <WxH>", "Viewport size, e.g. 1280x720", "375x812").option("--json", "Emit structured JSON to stdout in addition to the summary", false).option("-o, --output <path>", "Write the CI result JSON to a file").action(
|
|
936
|
+
async (opts) => {
|
|
937
|
+
try {
|
|
938
|
+
const [wStr, hStr] = opts.viewport.split("x");
|
|
939
|
+
const viewportWidth = Number.parseInt(wStr ?? "375", 10);
|
|
940
|
+
const viewportHeight = Number.parseInt(hStr ?? "812", 10);
|
|
941
|
+
const complianceThreshold = Number.parseFloat(opts.threshold);
|
|
942
|
+
const checks = parseChecks(opts.checks);
|
|
943
|
+
const result = await runCi({
|
|
944
|
+
baselineDir: opts.baseline,
|
|
945
|
+
checks,
|
|
946
|
+
complianceThreshold,
|
|
947
|
+
viewportWidth,
|
|
948
|
+
viewportHeight
|
|
949
|
+
});
|
|
950
|
+
if (opts.output !== void 0) {
|
|
951
|
+
const outPath = resolve2(process.cwd(), opts.output);
|
|
952
|
+
writeFileSync2(outPath, JSON.stringify(result, null, 2), "utf-8");
|
|
953
|
+
process.stderr.write(`CI result written to ${opts.output}
|
|
954
|
+
`);
|
|
955
|
+
}
|
|
956
|
+
process.stdout.write(`${formatCiReport(result)}
|
|
957
|
+
`);
|
|
958
|
+
if (opts.json) {
|
|
959
|
+
process.stdout.write(`${JSON.stringify(result, null, 2)}
|
|
960
|
+
`);
|
|
961
|
+
}
|
|
962
|
+
process.exit(result.exitCode);
|
|
963
|
+
} catch (err) {
|
|
964
|
+
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
965
|
+
`);
|
|
966
|
+
process.exit(CI_EXIT.RENDER_FAILURES);
|
|
967
|
+
}
|
|
968
|
+
}
|
|
969
|
+
);
|
|
970
|
+
}
|
|
971
|
+
|
|
53
972
|
// src/init/index.ts
|
|
54
|
-
import { appendFileSync, existsSync as
|
|
973
|
+
import { appendFileSync, existsSync as existsSync4, mkdirSync, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
|
|
55
974
|
import { join as join2 } from "path";
|
|
56
975
|
import * as readline from "readline";
|
|
57
976
|
|
|
58
977
|
// src/init/detect.ts
|
|
59
|
-
import { existsSync, readdirSync, readFileSync } from "fs";
|
|
978
|
+
import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3 } from "fs";
|
|
60
979
|
import { join } from "path";
|
|
61
980
|
function hasConfigFile(dir, stem) {
|
|
62
|
-
if (!
|
|
981
|
+
if (!existsSync3(dir)) return false;
|
|
63
982
|
try {
|
|
64
983
|
const entries = readdirSync(dir);
|
|
65
984
|
return entries.some((f) => f === stem || f.startsWith(`${stem}.`));
|
|
@@ -69,7 +988,7 @@ function hasConfigFile(dir, stem) {
|
|
|
69
988
|
}
|
|
70
989
|
function readSafe(path) {
|
|
71
990
|
try {
|
|
72
|
-
return
|
|
991
|
+
return readFileSync3(path, "utf-8");
|
|
73
992
|
} catch {
|
|
74
993
|
return null;
|
|
75
994
|
}
|
|
@@ -82,15 +1001,15 @@ function detectFramework(rootDir, packageDeps) {
|
|
|
82
1001
|
return "unknown";
|
|
83
1002
|
}
|
|
84
1003
|
function detectPackageManager(rootDir) {
|
|
85
|
-
if (
|
|
86
|
-
if (
|
|
87
|
-
if (
|
|
88
|
-
if (
|
|
1004
|
+
if (existsSync3(join(rootDir, "bun.lock"))) return "bun";
|
|
1005
|
+
if (existsSync3(join(rootDir, "yarn.lock"))) return "yarn";
|
|
1006
|
+
if (existsSync3(join(rootDir, "pnpm-lock.yaml"))) return "pnpm";
|
|
1007
|
+
if (existsSync3(join(rootDir, "package-lock.json"))) return "npm";
|
|
89
1008
|
return "npm";
|
|
90
1009
|
}
|
|
91
1010
|
function detectTypeScript(rootDir) {
|
|
92
1011
|
const candidate = join(rootDir, "tsconfig.json");
|
|
93
|
-
if (
|
|
1012
|
+
if (existsSync3(candidate)) {
|
|
94
1013
|
return { typescript: true, tsconfigPath: candidate };
|
|
95
1014
|
}
|
|
96
1015
|
return { typescript: false, tsconfigPath: null };
|
|
@@ -103,7 +1022,7 @@ function detectComponentPatterns(rootDir, typescript) {
|
|
|
103
1022
|
const altExt = typescript ? "jsx" : "jsx";
|
|
104
1023
|
for (const dir of COMPONENT_DIRS) {
|
|
105
1024
|
const absDir = join(rootDir, dir);
|
|
106
|
-
if (!
|
|
1025
|
+
if (!existsSync3(absDir)) continue;
|
|
107
1026
|
let hasComponents = false;
|
|
108
1027
|
try {
|
|
109
1028
|
const entries = readdirSync(absDir, { withFileTypes: true });
|
|
@@ -158,7 +1077,7 @@ function detectTokenSources(rootDir) {
|
|
|
158
1077
|
}
|
|
159
1078
|
}
|
|
160
1079
|
const srcDir = join(rootDir, "src");
|
|
161
|
-
const dirsToScan =
|
|
1080
|
+
const dirsToScan = existsSync3(srcDir) ? [srcDir] : [];
|
|
162
1081
|
for (const scanDir of dirsToScan) {
|
|
163
1082
|
try {
|
|
164
1083
|
const entries = readdirSync(scanDir, { withFileTypes: true });
|
|
@@ -174,7 +1093,7 @@ function detectTokenSources(rootDir) {
|
|
|
174
1093
|
} catch {
|
|
175
1094
|
}
|
|
176
1095
|
}
|
|
177
|
-
if (
|
|
1096
|
+
if (existsSync3(srcDir)) {
|
|
178
1097
|
try {
|
|
179
1098
|
const entries = readdirSync(srcDir);
|
|
180
1099
|
for (const entry of entries) {
|
|
@@ -217,7 +1136,7 @@ function detectProject(rootDir) {
|
|
|
217
1136
|
}
|
|
218
1137
|
|
|
219
1138
|
// src/init/index.ts
|
|
220
|
-
import { Command } from "commander";
|
|
1139
|
+
import { Command as Command2 } from "commander";
|
|
221
1140
|
function buildDefaultConfig(detected, tokenFile, outputDir) {
|
|
222
1141
|
const include = detected.componentPatterns.length > 0 ? detected.componentPatterns : ["src/**/*.tsx"];
|
|
223
1142
|
return {
|
|
@@ -255,9 +1174,9 @@ function createRL() {
|
|
|
255
1174
|
});
|
|
256
1175
|
}
|
|
257
1176
|
async function ask(rl, question) {
|
|
258
|
-
return new Promise((
|
|
1177
|
+
return new Promise((resolve15) => {
|
|
259
1178
|
rl.question(question, (answer) => {
|
|
260
|
-
|
|
1179
|
+
resolve15(answer.trim());
|
|
261
1180
|
});
|
|
262
1181
|
});
|
|
263
1182
|
}
|
|
@@ -267,8 +1186,8 @@ async function askWithDefault(rl, label, defaultValue) {
|
|
|
267
1186
|
}
|
|
268
1187
|
function ensureGitignoreEntry(rootDir, entry) {
|
|
269
1188
|
const gitignorePath = join2(rootDir, ".gitignore");
|
|
270
|
-
if (
|
|
271
|
-
const content =
|
|
1189
|
+
if (existsSync4(gitignorePath)) {
|
|
1190
|
+
const content = readFileSync4(gitignorePath, "utf-8");
|
|
272
1191
|
const normalised = entry.replace(/\/$/, "");
|
|
273
1192
|
const lines = content.split("\n").map((l) => l.trim());
|
|
274
1193
|
if (lines.includes(entry) || lines.includes(normalised)) {
|
|
@@ -278,24 +1197,24 @@ function ensureGitignoreEntry(rootDir, entry) {
|
|
|
278
1197
|
appendFileSync(gitignorePath, `${suffix}${entry}
|
|
279
1198
|
`);
|
|
280
1199
|
} else {
|
|
281
|
-
|
|
1200
|
+
writeFileSync3(gitignorePath, `${entry}
|
|
282
1201
|
`);
|
|
283
1202
|
}
|
|
284
1203
|
}
|
|
285
1204
|
function scaffoldConfig(rootDir, config) {
|
|
286
1205
|
const path = join2(rootDir, "reactscope.config.json");
|
|
287
|
-
|
|
1206
|
+
writeFileSync3(path, `${JSON.stringify(config, null, 2)}
|
|
288
1207
|
`);
|
|
289
1208
|
return path;
|
|
290
1209
|
}
|
|
291
1210
|
function scaffoldTokenFile(rootDir, tokenFile) {
|
|
292
1211
|
const path = join2(rootDir, tokenFile);
|
|
293
|
-
if (!
|
|
1212
|
+
if (!existsSync4(path)) {
|
|
294
1213
|
const stub = {
|
|
295
1214
|
$schema: "https://raw.githubusercontent.com/FlatFilers/Scope/main/packages/tokens/schema.json",
|
|
296
1215
|
tokens: {}
|
|
297
1216
|
};
|
|
298
|
-
|
|
1217
|
+
writeFileSync3(path, `${JSON.stringify(stub, null, 2)}
|
|
299
1218
|
`);
|
|
300
1219
|
}
|
|
301
1220
|
return path;
|
|
@@ -304,8 +1223,8 @@ function scaffoldOutputDir(rootDir, outputDir) {
|
|
|
304
1223
|
const dirPath = join2(rootDir, outputDir);
|
|
305
1224
|
mkdirSync(dirPath, { recursive: true });
|
|
306
1225
|
const keepPath = join2(dirPath, ".gitkeep");
|
|
307
|
-
if (!
|
|
308
|
-
|
|
1226
|
+
if (!existsSync4(keepPath)) {
|
|
1227
|
+
writeFileSync3(keepPath, "");
|
|
309
1228
|
}
|
|
310
1229
|
return dirPath;
|
|
311
1230
|
}
|
|
@@ -313,7 +1232,7 @@ async function runInit(options) {
|
|
|
313
1232
|
const rootDir = options.cwd ?? process.cwd();
|
|
314
1233
|
const configPath = join2(rootDir, "reactscope.config.json");
|
|
315
1234
|
const created = [];
|
|
316
|
-
if (
|
|
1235
|
+
if (existsSync4(configPath) && !options.force) {
|
|
317
1236
|
const msg = "reactscope.config.json already exists. Run with --force to overwrite.";
|
|
318
1237
|
process.stderr.write(`\u26A0\uFE0F ${msg}
|
|
319
1238
|
`);
|
|
@@ -352,288 +1271,77 @@ async function runInit(options) {
|
|
|
352
1271
|
const excludeRaw = await askWithDefault(
|
|
353
1272
|
rl,
|
|
354
1273
|
"Component exclude patterns (comma-separated)",
|
|
355
|
-
config.components.exclude.join(", ")
|
|
356
|
-
);
|
|
357
|
-
config.components.exclude = excludeRaw.split(",").map((s) => s.trim()).filter(Boolean);
|
|
358
|
-
const tokenFile = await askWithDefault(rl, "Token file location", config.tokens.file);
|
|
359
|
-
config.tokens.file = tokenFile;
|
|
360
|
-
config.ci.baselinePath = `${config.output.dir}baseline/`;
|
|
361
|
-
const outputDir = await askWithDefault(rl, "Output directory", config.output.dir);
|
|
362
|
-
config.output.dir = outputDir.endsWith("/") ? outputDir : `${outputDir}/`;
|
|
363
|
-
config.ci.baselinePath = `${config.output.dir}baseline/`;
|
|
364
|
-
config = buildDefaultConfig(detected, config.tokens.file, config.output.dir);
|
|
365
|
-
config.components.include = includeRaw.split(",").map((s) => s.trim()).filter(Boolean);
|
|
366
|
-
config.components.exclude = excludeRaw.split(",").map((s) => s.trim()).filter(Boolean);
|
|
367
|
-
} finally {
|
|
368
|
-
rl.close();
|
|
369
|
-
}
|
|
370
|
-
process.stdout.write("\n");
|
|
371
|
-
}
|
|
372
|
-
const cfgPath = scaffoldConfig(rootDir, config);
|
|
373
|
-
created.push(cfgPath);
|
|
374
|
-
const tokPath = scaffoldTokenFile(rootDir, config.tokens.file);
|
|
375
|
-
created.push(tokPath);
|
|
376
|
-
const outDirPath = scaffoldOutputDir(rootDir, config.output.dir);
|
|
377
|
-
created.push(outDirPath);
|
|
378
|
-
ensureGitignoreEntry(rootDir, config.output.dir);
|
|
379
|
-
process.stdout.write("\u2705 Scope project initialised!\n\n");
|
|
380
|
-
process.stdout.write(" Created files:\n");
|
|
381
|
-
for (const p of created) {
|
|
382
|
-
process.stdout.write(` ${p}
|
|
383
|
-
`);
|
|
384
|
-
}
|
|
385
|
-
process.stdout.write("\n Next steps: run `scope manifest` to scan your components.\n\n");
|
|
386
|
-
return {
|
|
387
|
-
success: true,
|
|
388
|
-
message: "Project initialised successfully.",
|
|
389
|
-
created,
|
|
390
|
-
skipped: false
|
|
391
|
-
};
|
|
392
|
-
}
|
|
393
|
-
function createInitCommand() {
|
|
394
|
-
return new Command("init").description("Initialise a Scope project \u2014 scaffold reactscope.config.json and friends").option("-y, --yes", "Accept all detected defaults without prompting", false).option("--force", "Overwrite existing reactscope.config.json if present", false).action(async (opts) => {
|
|
395
|
-
try {
|
|
396
|
-
const result = await runInit({ yes: opts.yes, force: opts.force });
|
|
397
|
-
if (!result.success && !result.skipped) {
|
|
398
|
-
process.exit(1);
|
|
399
|
-
}
|
|
400
|
-
} catch (err) {
|
|
401
|
-
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
402
|
-
`);
|
|
403
|
-
process.exit(1);
|
|
404
|
-
}
|
|
405
|
-
});
|
|
406
|
-
}
|
|
407
|
-
|
|
408
|
-
// src/instrument/renders.ts
|
|
409
|
-
import { resolve as resolve5 } from "path";
|
|
410
|
-
import { BrowserPool as BrowserPool2 } from "@agent-scope/render";
|
|
411
|
-
import { Command as Command4 } from "commander";
|
|
412
|
-
|
|
413
|
-
// src/component-bundler.ts
|
|
414
|
-
import { dirname } from "path";
|
|
415
|
-
import * as esbuild from "esbuild";
|
|
416
|
-
async function buildComponentHarness(filePath, componentName, props, viewportWidth, projectCss) {
|
|
417
|
-
const bundledScript = await bundleComponentToIIFE(filePath, componentName, props);
|
|
418
|
-
return wrapInHtml(bundledScript, viewportWidth, projectCss);
|
|
419
|
-
}
|
|
420
|
-
async function bundleComponentToIIFE(filePath, componentName, props) {
|
|
421
|
-
const propsJson = JSON.stringify(props).replace(/<\/script>/gi, "<\\/script>");
|
|
422
|
-
const wrapperCode = (
|
|
423
|
-
/* ts */
|
|
424
|
-
`
|
|
425
|
-
import * as __scopeMod from ${JSON.stringify(filePath)};
|
|
426
|
-
import { createRoot } from "react-dom/client";
|
|
427
|
-
import { createElement } from "react";
|
|
428
|
-
|
|
429
|
-
(function scopeRenderHarness() {
|
|
430
|
-
var Component =
|
|
431
|
-
__scopeMod["default"] ||
|
|
432
|
-
__scopeMod[${JSON.stringify(componentName)}] ||
|
|
433
|
-
(Object.values(__scopeMod).find(
|
|
434
|
-
function(v) { return typeof v === "function" && /^[A-Z]/.test(v.name || ""); }
|
|
435
|
-
));
|
|
436
|
-
|
|
437
|
-
if (!Component) {
|
|
438
|
-
window.__SCOPE_RENDER_ERROR__ =
|
|
439
|
-
"No renderable component found. Checked: default, " +
|
|
440
|
-
${JSON.stringify(componentName)} + ", and PascalCase named exports. " +
|
|
441
|
-
"Available exports: " + Object.keys(__scopeMod).join(", ");
|
|
442
|
-
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
443
|
-
return;
|
|
444
|
-
}
|
|
445
|
-
|
|
446
|
-
try {
|
|
447
|
-
var props = ${propsJson};
|
|
448
|
-
var rootEl = document.getElementById("scope-root");
|
|
449
|
-
if (!rootEl) {
|
|
450
|
-
window.__SCOPE_RENDER_ERROR__ = "#scope-root element not found";
|
|
451
|
-
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
452
|
-
return;
|
|
453
|
-
}
|
|
454
|
-
createRoot(rootEl).render(createElement(Component, props));
|
|
455
|
-
// Use requestAnimationFrame to let React flush the render
|
|
456
|
-
requestAnimationFrame(function() {
|
|
457
|
-
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
458
|
-
});
|
|
459
|
-
} catch (err) {
|
|
460
|
-
window.__SCOPE_RENDER_ERROR__ = err instanceof Error ? err.message : String(err);
|
|
461
|
-
window.__SCOPE_RENDER_COMPLETE__ = true;
|
|
462
|
-
}
|
|
463
|
-
})();
|
|
464
|
-
`
|
|
465
|
-
);
|
|
466
|
-
const result = await esbuild.build({
|
|
467
|
-
stdin: {
|
|
468
|
-
contents: wrapperCode,
|
|
469
|
-
// Resolve relative imports (within the component's dir)
|
|
470
|
-
resolveDir: dirname(filePath),
|
|
471
|
-
loader: "tsx",
|
|
472
|
-
sourcefile: "__scope_harness__.tsx"
|
|
473
|
-
},
|
|
474
|
-
bundle: true,
|
|
475
|
-
format: "iife",
|
|
476
|
-
write: false,
|
|
477
|
-
platform: "browser",
|
|
478
|
-
jsx: "automatic",
|
|
479
|
-
jsxImportSource: "react",
|
|
480
|
-
target: "es2020",
|
|
481
|
-
// Bundle everything — no externals
|
|
482
|
-
external: [],
|
|
483
|
-
define: {
|
|
484
|
-
"process.env.NODE_ENV": '"development"',
|
|
485
|
-
global: "globalThis"
|
|
486
|
-
},
|
|
487
|
-
logLevel: "silent",
|
|
488
|
-
// Suppress "React must be in scope" warnings from old JSX (we use automatic)
|
|
489
|
-
banner: {
|
|
490
|
-
js: "/* @agent-scope/cli component harness */"
|
|
491
|
-
}
|
|
492
|
-
});
|
|
493
|
-
if (result.errors.length > 0) {
|
|
494
|
-
const msg = result.errors.map((e) => `${e.text}${e.location ? ` (${e.location.file}:${e.location.line})` : ""}`).join("\n");
|
|
495
|
-
throw new Error(`esbuild failed to bundle component:
|
|
496
|
-
${msg}`);
|
|
497
|
-
}
|
|
498
|
-
const outputFile = result.outputFiles?.[0];
|
|
499
|
-
if (outputFile === void 0 || outputFile.text.length === 0) {
|
|
500
|
-
throw new Error("esbuild produced no output");
|
|
501
|
-
}
|
|
502
|
-
return outputFile.text;
|
|
503
|
-
}
|
|
504
|
-
function wrapInHtml(bundledScript, viewportWidth, projectCss) {
|
|
505
|
-
const projectStyleBlock = projectCss != null && projectCss.length > 0 ? `<style id="scope-project-css">
|
|
506
|
-
${projectCss.replace(/<\/style>/gi, "<\\/style>")}
|
|
507
|
-
</style>` : "";
|
|
508
|
-
return `<!DOCTYPE html>
|
|
509
|
-
<html lang="en">
|
|
510
|
-
<head>
|
|
511
|
-
<meta charset="UTF-8" />
|
|
512
|
-
<meta name="viewport" content="width=${viewportWidth}, initial-scale=1.0" />
|
|
513
|
-
<style>
|
|
514
|
-
*, *::before, *::after { box-sizing: border-box; }
|
|
515
|
-
html, body { margin: 0; padding: 0; background: #fff; font-family: system-ui, sans-serif; }
|
|
516
|
-
#scope-root { display: inline-block; min-width: 1px; min-height: 1px; }
|
|
517
|
-
</style>
|
|
518
|
-
${projectStyleBlock}
|
|
519
|
-
</head>
|
|
520
|
-
<body>
|
|
521
|
-
<div id="scope-root" data-reactscope-root></div>
|
|
522
|
-
<script>${bundledScript}</script>
|
|
523
|
-
</body>
|
|
524
|
-
</html>`;
|
|
525
|
-
}
|
|
526
|
-
|
|
527
|
-
// src/manifest-commands.ts
|
|
528
|
-
import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
|
|
529
|
-
import { resolve } from "path";
|
|
530
|
-
import { generateManifest } from "@agent-scope/manifest";
|
|
531
|
-
import { Command as Command2 } from "commander";
|
|
532
|
-
|
|
533
|
-
// src/manifest-formatter.ts
|
|
534
|
-
function isTTY() {
|
|
535
|
-
return process.stdout.isTTY === true;
|
|
536
|
-
}
|
|
537
|
-
function pad(value, width) {
|
|
538
|
-
return value.length >= width ? value.slice(0, width) : value + " ".repeat(width - value.length);
|
|
539
|
-
}
|
|
540
|
-
function buildTable(headers, rows) {
|
|
541
|
-
const colWidths = headers.map(
|
|
542
|
-
(h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length))
|
|
543
|
-
);
|
|
544
|
-
const divider = colWidths.map((w) => "-".repeat(w)).join(" ");
|
|
545
|
-
const headerRow = headers.map((h, i) => pad(h, colWidths[i] ?? 0)).join(" ");
|
|
546
|
-
const dataRows = rows.map(
|
|
547
|
-
(row2) => row2.map((cell, i) => pad(cell ?? "", colWidths[i] ?? 0)).join(" ")
|
|
548
|
-
);
|
|
549
|
-
return [headerRow, divider, ...dataRows].join("\n");
|
|
550
|
-
}
|
|
551
|
-
function formatListTable(rows) {
|
|
552
|
-
if (rows.length === 0) return "No components found.";
|
|
553
|
-
const headers = ["NAME", "FILE", "COMPLEXITY", "HOOKS", "CONTEXTS"];
|
|
554
|
-
const tableRows = rows.map((r) => [
|
|
555
|
-
r.name,
|
|
556
|
-
r.file,
|
|
557
|
-
r.complexityClass,
|
|
558
|
-
String(r.hookCount),
|
|
559
|
-
String(r.contextCount)
|
|
560
|
-
]);
|
|
561
|
-
return buildTable(headers, tableRows);
|
|
562
|
-
}
|
|
563
|
-
function formatListJson(rows) {
|
|
564
|
-
return JSON.stringify(rows, null, 2);
|
|
565
|
-
}
|
|
566
|
-
function formatSideEffects(se) {
|
|
567
|
-
const parts = [];
|
|
568
|
-
if (se.fetches.length > 0) parts.push(`fetches: ${se.fetches.join(", ")}`);
|
|
569
|
-
if (se.timers) parts.push("timers");
|
|
570
|
-
if (se.subscriptions.length > 0) parts.push(`subscriptions: ${se.subscriptions.join(", ")}`);
|
|
571
|
-
if (se.globalListeners) parts.push("globalListeners");
|
|
572
|
-
return parts.length > 0 ? parts.join(" | ") : "none";
|
|
573
|
-
}
|
|
574
|
-
function formatGetTable(name, descriptor) {
|
|
575
|
-
const propNames = Object.keys(descriptor.props);
|
|
576
|
-
const lines = [
|
|
577
|
-
`Component: ${name}`,
|
|
578
|
-
` File: ${descriptor.filePath}`,
|
|
579
|
-
` Export: ${descriptor.exportType}`,
|
|
580
|
-
` Display Name: ${descriptor.displayName}`,
|
|
581
|
-
` Complexity: ${descriptor.complexityClass}`,
|
|
582
|
-
` Memoized: ${descriptor.memoized}`,
|
|
583
|
-
` Forwarded Ref: ${descriptor.forwardedRef}`,
|
|
584
|
-
` HOC Wrappers: ${descriptor.hocWrappers.join(", ") || "none"}`,
|
|
585
|
-
` Hooks: ${descriptor.detectedHooks.join(", ") || "none"}`,
|
|
586
|
-
` Contexts: ${descriptor.requiredContexts.join(", ") || "none"}`,
|
|
587
|
-
` Composes: ${descriptor.composes.join(", ") || "none"}`,
|
|
588
|
-
` Composed By: ${descriptor.composedBy.join(", ") || "none"}`,
|
|
589
|
-
` Side Effects: ${formatSideEffects(descriptor.sideEffects)}`,
|
|
590
|
-
"",
|
|
591
|
-
` Props (${propNames.length}):`
|
|
592
|
-
];
|
|
593
|
-
if (propNames.length === 0) {
|
|
594
|
-
lines.push(" (none)");
|
|
595
|
-
} else {
|
|
596
|
-
for (const propName of propNames) {
|
|
597
|
-
const p = descriptor.props[propName];
|
|
598
|
-
if (p === void 0) continue;
|
|
599
|
-
const req = p.required ? "required" : "optional";
|
|
600
|
-
const def = p.default !== void 0 ? ` [default: ${p.default}]` : "";
|
|
601
|
-
const vals = p.values !== void 0 ? ` (${p.values.join(" | ")})` : "";
|
|
602
|
-
lines.push(` ${propName}: ${p.rawType}${vals} \u2014 ${req}${def}`);
|
|
1274
|
+
config.components.exclude.join(", ")
|
|
1275
|
+
);
|
|
1276
|
+
config.components.exclude = excludeRaw.split(",").map((s) => s.trim()).filter(Boolean);
|
|
1277
|
+
const tokenFile = await askWithDefault(rl, "Token file location", config.tokens.file);
|
|
1278
|
+
config.tokens.file = tokenFile;
|
|
1279
|
+
config.ci.baselinePath = `${config.output.dir}baseline/`;
|
|
1280
|
+
const outputDir = await askWithDefault(rl, "Output directory", config.output.dir);
|
|
1281
|
+
config.output.dir = outputDir.endsWith("/") ? outputDir : `${outputDir}/`;
|
|
1282
|
+
config.ci.baselinePath = `${config.output.dir}baseline/`;
|
|
1283
|
+
config = buildDefaultConfig(detected, config.tokens.file, config.output.dir);
|
|
1284
|
+
config.components.include = includeRaw.split(",").map((s) => s.trim()).filter(Boolean);
|
|
1285
|
+
config.components.exclude = excludeRaw.split(",").map((s) => s.trim()).filter(Boolean);
|
|
1286
|
+
} finally {
|
|
1287
|
+
rl.close();
|
|
603
1288
|
}
|
|
1289
|
+
process.stdout.write("\n");
|
|
604
1290
|
}
|
|
605
|
-
|
|
1291
|
+
const cfgPath = scaffoldConfig(rootDir, config);
|
|
1292
|
+
created.push(cfgPath);
|
|
1293
|
+
const tokPath = scaffoldTokenFile(rootDir, config.tokens.file);
|
|
1294
|
+
created.push(tokPath);
|
|
1295
|
+
const outDirPath = scaffoldOutputDir(rootDir, config.output.dir);
|
|
1296
|
+
created.push(outDirPath);
|
|
1297
|
+
ensureGitignoreEntry(rootDir, config.output.dir);
|
|
1298
|
+
process.stdout.write("\u2705 Scope project initialised!\n\n");
|
|
1299
|
+
process.stdout.write(" Created files:\n");
|
|
1300
|
+
for (const p of created) {
|
|
1301
|
+
process.stdout.write(` ${p}
|
|
1302
|
+
`);
|
|
1303
|
+
}
|
|
1304
|
+
process.stdout.write("\n Next steps: run `scope manifest` to scan your components.\n\n");
|
|
1305
|
+
return {
|
|
1306
|
+
success: true,
|
|
1307
|
+
message: "Project initialised successfully.",
|
|
1308
|
+
created,
|
|
1309
|
+
skipped: false
|
|
1310
|
+
};
|
|
606
1311
|
}
|
|
607
|
-
function
|
|
608
|
-
return
|
|
1312
|
+
function createInitCommand() {
|
|
1313
|
+
return new Command2("init").description("Initialise a Scope project \u2014 scaffold reactscope.config.json and friends").option("-y, --yes", "Accept all detected defaults without prompting", false).option("--force", "Overwrite existing reactscope.config.json if present", false).action(async (opts) => {
|
|
1314
|
+
try {
|
|
1315
|
+
const result = await runInit({ yes: opts.yes, force: opts.force });
|
|
1316
|
+
if (!result.success && !result.skipped) {
|
|
1317
|
+
process.exit(1);
|
|
1318
|
+
}
|
|
1319
|
+
} catch (err) {
|
|
1320
|
+
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
1321
|
+
`);
|
|
1322
|
+
process.exit(1);
|
|
1323
|
+
}
|
|
1324
|
+
});
|
|
609
1325
|
}
|
|
610
|
-
function formatQueryTable(rows, queryDesc) {
|
|
611
|
-
if (rows.length === 0) return `No components match: ${queryDesc}`;
|
|
612
|
-
const headers = ["NAME", "FILE", "COMPLEXITY", "HOOKS", "CONTEXTS"];
|
|
613
|
-
const tableRows = rows.map((r) => [r.name, r.file, r.complexityClass, r.hooks, r.contexts]);
|
|
614
|
-
return `Query: ${queryDesc}
|
|
615
1326
|
|
|
616
|
-
|
|
617
|
-
}
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
}
|
|
621
|
-
function matchGlob(pattern, value) {
|
|
622
|
-
const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
|
|
623
|
-
const regexStr = escaped.replace(/\*\*/g, "\xA7GLOBSTAR\xA7").replace(/\*/g, "[^/]*").replace(/§GLOBSTAR§/g, ".*");
|
|
624
|
-
const regex = new RegExp(`^${regexStr}$`, "i");
|
|
625
|
-
return regex.test(value);
|
|
626
|
-
}
|
|
1327
|
+
// src/instrument/renders.ts
|
|
1328
|
+
import { resolve as resolve7 } from "path";
|
|
1329
|
+
import { BrowserPool as BrowserPool3 } from "@agent-scope/render";
|
|
1330
|
+
import { Command as Command5 } from "commander";
|
|
627
1331
|
|
|
628
1332
|
// src/manifest-commands.ts
|
|
1333
|
+
import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
|
|
1334
|
+
import { resolve as resolve3 } from "path";
|
|
1335
|
+
import { generateManifest as generateManifest2 } from "@agent-scope/manifest";
|
|
1336
|
+
import { Command as Command3 } from "commander";
|
|
629
1337
|
var MANIFEST_PATH = ".reactscope/manifest.json";
|
|
630
1338
|
function loadManifest(manifestPath = MANIFEST_PATH) {
|
|
631
|
-
const absPath =
|
|
632
|
-
if (!
|
|
1339
|
+
const absPath = resolve3(process.cwd(), manifestPath);
|
|
1340
|
+
if (!existsSync5(absPath)) {
|
|
633
1341
|
throw new Error(`Manifest not found at ${absPath}.
|
|
634
1342
|
Run \`scope manifest generate\` first.`);
|
|
635
1343
|
}
|
|
636
|
-
const raw =
|
|
1344
|
+
const raw = readFileSync5(absPath, "utf-8");
|
|
637
1345
|
return JSON.parse(raw);
|
|
638
1346
|
}
|
|
639
1347
|
function resolveFormat(formatFlag) {
|
|
@@ -756,13 +1464,13 @@ function registerGenerate(manifestCmd) {
|
|
|
756
1464
|
"Generate the component manifest from source and write to .reactscope/manifest.json"
|
|
757
1465
|
).option("--root <path>", "Project root directory (default: cwd)").option("--output <path>", "Output path for manifest.json", MANIFEST_PATH).option("--include <globs>", "Comma-separated glob patterns to include").option("--exclude <globs>", "Comma-separated glob patterns to exclude").action(async (opts) => {
|
|
758
1466
|
try {
|
|
759
|
-
const rootDir =
|
|
760
|
-
const outputPath =
|
|
1467
|
+
const rootDir = resolve3(process.cwd(), opts.root ?? ".");
|
|
1468
|
+
const outputPath = resolve3(process.cwd(), opts.output);
|
|
761
1469
|
const include = opts.include?.split(",").map((s) => s.trim());
|
|
762
1470
|
const exclude = opts.exclude?.split(",").map((s) => s.trim());
|
|
763
1471
|
process.stderr.write(`Scanning ${rootDir} for React components...
|
|
764
1472
|
`);
|
|
765
|
-
const manifest = await
|
|
1473
|
+
const manifest = await generateManifest2({
|
|
766
1474
|
rootDir,
|
|
767
1475
|
...include !== void 0 && { include },
|
|
768
1476
|
...exclude !== void 0 && { exclude }
|
|
@@ -771,10 +1479,10 @@ function registerGenerate(manifestCmd) {
|
|
|
771
1479
|
process.stderr.write(`Found ${componentCount} components.
|
|
772
1480
|
`);
|
|
773
1481
|
const outputDir = outputPath.replace(/\/[^/]+$/, "");
|
|
774
|
-
if (!
|
|
1482
|
+
if (!existsSync5(outputDir)) {
|
|
775
1483
|
mkdirSync2(outputDir, { recursive: true });
|
|
776
1484
|
}
|
|
777
|
-
|
|
1485
|
+
writeFileSync4(outputPath, JSON.stringify(manifest, null, 2), "utf-8");
|
|
778
1486
|
process.stderr.write(`Manifest written to ${outputPath}
|
|
779
1487
|
`);
|
|
780
1488
|
process.stdout.write(`${outputPath}
|
|
@@ -787,7 +1495,7 @@ function registerGenerate(manifestCmd) {
|
|
|
787
1495
|
});
|
|
788
1496
|
}
|
|
789
1497
|
function createManifestCommand() {
|
|
790
|
-
const manifestCmd = new
|
|
1498
|
+
const manifestCmd = new Command3("manifest").description(
|
|
791
1499
|
"Query and explore the component manifest"
|
|
792
1500
|
);
|
|
793
1501
|
registerList(manifestCmd);
|
|
@@ -797,168 +1505,8 @@ function createManifestCommand() {
|
|
|
797
1505
|
return manifestCmd;
|
|
798
1506
|
}
|
|
799
1507
|
|
|
800
|
-
// src/render-formatter.ts
|
|
801
|
-
function parseViewport(spec) {
|
|
802
|
-
const lower = spec.toLowerCase();
|
|
803
|
-
const match = /^(\d+)[x×](\d+)$/.exec(lower);
|
|
804
|
-
if (!match) {
|
|
805
|
-
throw new Error(`Invalid viewport "${spec}". Expected format: WIDTHxHEIGHT (e.g. 1280x720)`);
|
|
806
|
-
}
|
|
807
|
-
const width = parseInt(match[1] ?? "0", 10);
|
|
808
|
-
const height = parseInt(match[2] ?? "0", 10);
|
|
809
|
-
if (width <= 0 || height <= 0) {
|
|
810
|
-
throw new Error(`Viewport dimensions must be positive integers, got: ${spec}`);
|
|
811
|
-
}
|
|
812
|
-
return { width, height };
|
|
813
|
-
}
|
|
814
|
-
function formatRenderJson(componentName, props, result) {
|
|
815
|
-
return {
|
|
816
|
-
component: componentName,
|
|
817
|
-
props,
|
|
818
|
-
width: result.width,
|
|
819
|
-
height: result.height,
|
|
820
|
-
renderTimeMs: result.renderTimeMs,
|
|
821
|
-
computedStyles: result.computedStyles,
|
|
822
|
-
screenshot: result.screenshot.toString("base64"),
|
|
823
|
-
dom: result.dom,
|
|
824
|
-
console: result.console,
|
|
825
|
-
accessibility: result.accessibility
|
|
826
|
-
};
|
|
827
|
-
}
|
|
828
|
-
function formatMatrixJson(result) {
|
|
829
|
-
return {
|
|
830
|
-
axes: result.axes.map((axis) => ({
|
|
831
|
-
name: axis.name,
|
|
832
|
-
values: axis.values.map((v) => String(v))
|
|
833
|
-
})),
|
|
834
|
-
stats: { ...result.stats },
|
|
835
|
-
cells: result.cells.map((cell) => ({
|
|
836
|
-
index: cell.index,
|
|
837
|
-
axisIndices: cell.axisIndices,
|
|
838
|
-
props: cell.props,
|
|
839
|
-
renderTimeMs: cell.result.renderTimeMs,
|
|
840
|
-
width: cell.result.width,
|
|
841
|
-
height: cell.result.height,
|
|
842
|
-
screenshot: cell.result.screenshot.toString("base64")
|
|
843
|
-
}))
|
|
844
|
-
};
|
|
845
|
-
}
|
|
846
|
-
function formatMatrixHtml(componentName, result) {
|
|
847
|
-
const cellsHtml = result.cells.map((cell) => {
|
|
848
|
-
const b64 = cell.result.screenshot.toString("base64");
|
|
849
|
-
const propLabel = escapeHtml(
|
|
850
|
-
Object.entries(cell.props).map(([k, v]) => `${k}: ${String(v)}`).join(", ")
|
|
851
|
-
);
|
|
852
|
-
return ` <div class="cell">
|
|
853
|
-
<img src="data:image/png;base64,${b64}" alt="${propLabel}" width="${cell.result.width}" height="${cell.result.height}" />
|
|
854
|
-
<div class="label">${propLabel}</div>
|
|
855
|
-
<div class="meta">${cell.result.renderTimeMs.toFixed(1)}ms</div>
|
|
856
|
-
</div>`;
|
|
857
|
-
}).join("\n");
|
|
858
|
-
const axesDesc = result.axes.map((a) => `${a.name}: ${a.values.map((v) => String(v)).join(", ")}`).join(" | ");
|
|
859
|
-
return `<!DOCTYPE html>
|
|
860
|
-
<html lang="en">
|
|
861
|
-
<head>
|
|
862
|
-
<meta charset="UTF-8" />
|
|
863
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
864
|
-
<title>${escapeHtml(componentName)} \u2014 Render Matrix</title>
|
|
865
|
-
<style>
|
|
866
|
-
body { font-family: system-ui, sans-serif; background: #f8fafc; margin: 0; padding: 24px; }
|
|
867
|
-
h1 { font-size: 1.25rem; color: #1e293b; margin-bottom: 8px; }
|
|
868
|
-
.axes { font-size: 0.8rem; color: #64748b; margin-bottom: 20px; }
|
|
869
|
-
.grid { display: flex; flex-wrap: wrap; gap: 16px; }
|
|
870
|
-
.cell { background: #fff; border: 1px solid #e2e8f0; border-radius: 8px; overflow: hidden; }
|
|
871
|
-
.cell img { display: block; }
|
|
872
|
-
.label { padding: 6px 8px; font-size: 0.75rem; color: #374151; border-top: 1px solid #f1f5f9; }
|
|
873
|
-
.meta { padding: 2px 8px 6px; font-size: 0.7rem; color: #94a3b8; }
|
|
874
|
-
.stats { margin-top: 24px; font-size: 0.8rem; color: #64748b; }
|
|
875
|
-
</style>
|
|
876
|
-
</head>
|
|
877
|
-
<body>
|
|
878
|
-
<h1>${escapeHtml(componentName)} \u2014 Render Matrix</h1>
|
|
879
|
-
<div class="axes">Axes: ${escapeHtml(axesDesc)}</div>
|
|
880
|
-
<div class="grid">
|
|
881
|
-
${cellsHtml}
|
|
882
|
-
</div>
|
|
883
|
-
<div class="stats">
|
|
884
|
-
${result.stats.totalCells} cells \xB7
|
|
885
|
-
avg ${result.stats.avgRenderTimeMs.toFixed(1)}ms \xB7
|
|
886
|
-
min ${result.stats.minRenderTimeMs.toFixed(1)}ms \xB7
|
|
887
|
-
max ${result.stats.maxRenderTimeMs.toFixed(1)}ms \xB7
|
|
888
|
-
wall ${result.stats.wallClockTimeMs.toFixed(0)}ms
|
|
889
|
-
</div>
|
|
890
|
-
</body>
|
|
891
|
-
</html>
|
|
892
|
-
`;
|
|
893
|
-
}
|
|
894
|
-
function formatMatrixCsv(componentName, result) {
|
|
895
|
-
const axisNames = result.axes.map((a) => a.name);
|
|
896
|
-
const headers = ["component", ...axisNames, "renderTimeMs", "width", "height"];
|
|
897
|
-
const rows = result.cells.map((cell) => {
|
|
898
|
-
const axisVals = result.axes.map((_, i) => {
|
|
899
|
-
const axisIdx = cell.axisIndices[i];
|
|
900
|
-
const axis = result.axes[i];
|
|
901
|
-
if (axisIdx === void 0 || axis === void 0) return "";
|
|
902
|
-
const val = axis.values[axisIdx];
|
|
903
|
-
return val !== void 0 ? csvEscape(String(val)) : "";
|
|
904
|
-
});
|
|
905
|
-
return [
|
|
906
|
-
csvEscape(componentName),
|
|
907
|
-
...axisVals,
|
|
908
|
-
cell.result.renderTimeMs.toFixed(3),
|
|
909
|
-
String(cell.result.width),
|
|
910
|
-
String(cell.result.height)
|
|
911
|
-
].join(",");
|
|
912
|
-
});
|
|
913
|
-
return `${[headers.join(","), ...rows].join("\n")}
|
|
914
|
-
`;
|
|
915
|
-
}
|
|
916
|
-
function renderProgressBar(completed, total, currentName, pct, barWidth = 20) {
|
|
917
|
-
const filled = Math.round(pct / 100 * barWidth);
|
|
918
|
-
const empty = barWidth - filled;
|
|
919
|
-
const bar = "=".repeat(Math.max(0, filled - 1)) + (filled > 0 ? ">" : "") + " ".repeat(empty);
|
|
920
|
-
const nameSlice = currentName.slice(0, 25).padEnd(25);
|
|
921
|
-
return `Rendering ${completed}/${total} ${nameSlice} [${bar}] ${pct}%`;
|
|
922
|
-
}
|
|
923
|
-
function formatSummaryText(results, outputDir) {
|
|
924
|
-
const total = results.length;
|
|
925
|
-
const passed = results.filter((r) => r.success).length;
|
|
926
|
-
const failed = total - passed;
|
|
927
|
-
const successTimes = results.filter((r) => r.success).map((r) => r.renderTimeMs);
|
|
928
|
-
const avgMs = successTimes.length > 0 ? successTimes.reduce((a, b) => a + b, 0) / successTimes.length : 0;
|
|
929
|
-
const lines = [
|
|
930
|
-
"\u2500".repeat(60),
|
|
931
|
-
`Render Summary`,
|
|
932
|
-
"\u2500".repeat(60),
|
|
933
|
-
` Total components : ${total}`,
|
|
934
|
-
` Passed : ${passed}`,
|
|
935
|
-
` Failed : ${failed}`,
|
|
936
|
-
` Avg render time : ${avgMs.toFixed(1)}ms`,
|
|
937
|
-
` Output dir : ${outputDir}`
|
|
938
|
-
];
|
|
939
|
-
if (failed > 0) {
|
|
940
|
-
lines.push("", " Failed components:");
|
|
941
|
-
for (const r of results) {
|
|
942
|
-
if (!r.success) {
|
|
943
|
-
lines.push(` \u2717 ${r.name}: ${r.errorMessage ?? "unknown error"}`);
|
|
944
|
-
}
|
|
945
|
-
}
|
|
946
|
-
}
|
|
947
|
-
lines.push("\u2500".repeat(60));
|
|
948
|
-
return lines.join("\n");
|
|
949
|
-
}
|
|
950
|
-
function escapeHtml(str) {
|
|
951
|
-
return str.replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">").replace(/"/g, """).replace(/'/g, "'");
|
|
952
|
-
}
|
|
953
|
-
function csvEscape(value) {
|
|
954
|
-
if (value.includes(",") || value.includes('"') || value.includes("\n")) {
|
|
955
|
-
return `"${value.replace(/"/g, '""')}"`;
|
|
956
|
-
}
|
|
957
|
-
return value;
|
|
958
|
-
}
|
|
959
|
-
|
|
960
1508
|
// src/instrument/hooks.ts
|
|
961
|
-
import { resolve as
|
|
1509
|
+
import { resolve as resolve4 } from "path";
|
|
962
1510
|
import { Command as Cmd } from "commander";
|
|
963
1511
|
import { chromium as chromium2 } from "playwright";
|
|
964
1512
|
var MANIFEST_PATH2 = ".reactscope/manifest.json";
|
|
@@ -1281,7 +1829,7 @@ Available: ${available}`
|
|
|
1281
1829
|
throw new Error(`Invalid props JSON: ${opts.props}`);
|
|
1282
1830
|
}
|
|
1283
1831
|
const rootDir = process.cwd();
|
|
1284
|
-
const filePath =
|
|
1832
|
+
const filePath = resolve4(rootDir, descriptor.filePath);
|
|
1285
1833
|
process.stderr.write(`Instrumenting hooks for ${componentName}\u2026
|
|
1286
1834
|
`);
|
|
1287
1835
|
const result = await runHooksProfiling(componentName, filePath, props);
|
|
@@ -1309,7 +1857,7 @@ Available: ${available}`
|
|
|
1309
1857
|
}
|
|
1310
1858
|
|
|
1311
1859
|
// src/instrument/profile.ts
|
|
1312
|
-
import { resolve as
|
|
1860
|
+
import { resolve as resolve5 } from "path";
|
|
1313
1861
|
import { Command as Cmd2 } from "commander";
|
|
1314
1862
|
import { chromium as chromium3 } from "playwright";
|
|
1315
1863
|
var MANIFEST_PATH3 = ".reactscope/manifest.json";
|
|
@@ -1575,7 +2123,7 @@ Available: ${available}`
|
|
|
1575
2123
|
throw new Error(`Invalid interaction JSON: ${opts.interaction}`);
|
|
1576
2124
|
}
|
|
1577
2125
|
const rootDir = process.cwd();
|
|
1578
|
-
const filePath =
|
|
2126
|
+
const filePath = resolve5(rootDir, descriptor.filePath);
|
|
1579
2127
|
process.stderr.write(`Profiling interaction for ${componentName}\u2026
|
|
1580
2128
|
`);
|
|
1581
2129
|
const result = await runInteractionProfile(componentName, filePath, props, interaction);
|
|
@@ -1603,29 +2151,29 @@ Available: ${available}`
|
|
|
1603
2151
|
}
|
|
1604
2152
|
|
|
1605
2153
|
// src/instrument/tree.ts
|
|
1606
|
-
import { resolve as
|
|
2154
|
+
import { resolve as resolve6 } from "path";
|
|
1607
2155
|
import { getBrowserEntryScript as getBrowserEntryScript2 } from "@agent-scope/playwright";
|
|
1608
|
-
import { BrowserPool } from "@agent-scope/render";
|
|
1609
|
-
import { Command as
|
|
2156
|
+
import { BrowserPool as BrowserPool2 } from "@agent-scope/render";
|
|
2157
|
+
import { Command as Command4 } from "commander";
|
|
1610
2158
|
var MANIFEST_PATH4 = ".reactscope/manifest.json";
|
|
1611
2159
|
var DEFAULT_VIEWPORT_WIDTH = 375;
|
|
1612
2160
|
var DEFAULT_VIEWPORT_HEIGHT = 812;
|
|
1613
|
-
var
|
|
1614
|
-
async function
|
|
1615
|
-
if (
|
|
1616
|
-
|
|
2161
|
+
var _pool2 = null;
|
|
2162
|
+
async function getPool2() {
|
|
2163
|
+
if (_pool2 === null) {
|
|
2164
|
+
_pool2 = new BrowserPool2({
|
|
1617
2165
|
size: { browsers: 1, pagesPerBrowser: 1 },
|
|
1618
2166
|
viewportWidth: DEFAULT_VIEWPORT_WIDTH,
|
|
1619
2167
|
viewportHeight: DEFAULT_VIEWPORT_HEIGHT
|
|
1620
2168
|
});
|
|
1621
|
-
await
|
|
2169
|
+
await _pool2.init();
|
|
1622
2170
|
}
|
|
1623
|
-
return
|
|
1624
|
-
}
|
|
1625
|
-
async function
|
|
1626
|
-
if (
|
|
1627
|
-
await
|
|
1628
|
-
|
|
2171
|
+
return _pool2;
|
|
2172
|
+
}
|
|
2173
|
+
async function shutdownPool2() {
|
|
2174
|
+
if (_pool2 !== null) {
|
|
2175
|
+
await _pool2.close();
|
|
2176
|
+
_pool2 = null;
|
|
1629
2177
|
}
|
|
1630
2178
|
}
|
|
1631
2179
|
function mapNodeType(node) {
|
|
@@ -1839,7 +2387,7 @@ function formatInstrumentTree(root, showProviderDepth = false) {
|
|
|
1839
2387
|
}
|
|
1840
2388
|
async function runInstrumentTree(options) {
|
|
1841
2389
|
const { componentName, filePath } = options;
|
|
1842
|
-
const pool = await
|
|
2390
|
+
const pool = await getPool2();
|
|
1843
2391
|
const slot = await pool.acquire();
|
|
1844
2392
|
const { page } = slot;
|
|
1845
2393
|
try {
|
|
@@ -1900,7 +2448,7 @@ async function runInstrumentTree(options) {
|
|
|
1900
2448
|
}
|
|
1901
2449
|
}
|
|
1902
2450
|
function createInstrumentTreeCommand() {
|
|
1903
|
-
return new
|
|
2451
|
+
return new Command4("tree").description("Render a component via BrowserPool and output a structured instrumentation tree").argument("<component>", "Component name to instrument (must exist in the manifest)").option("--sort-by <field>", "Sort nodes by field: renderCount | depth").option("--limit <n>", "Limit output to the first N nodes (depth-first)").option("--uses-context <name>", "Filter to components that use a specific context").option("--provider-depth", "Annotate each node with its context-provider nesting depth", false).option(
|
|
1904
2452
|
"--wasted-renders",
|
|
1905
2453
|
"Filter to components with wasted renders (no prop/state/context changes, not memoized)",
|
|
1906
2454
|
false
|
|
@@ -1924,7 +2472,7 @@ Available: ${available}`
|
|
|
1924
2472
|
}
|
|
1925
2473
|
}
|
|
1926
2474
|
const rootDir = process.cwd();
|
|
1927
|
-
const filePath =
|
|
2475
|
+
const filePath = resolve6(rootDir, descriptor.filePath);
|
|
1928
2476
|
process.stderr.write(`Instrumenting ${componentName}\u2026
|
|
1929
2477
|
`);
|
|
1930
2478
|
const instrumentRoot = await runInstrumentTree({
|
|
@@ -1936,7 +2484,7 @@ Available: ${available}`
|
|
|
1936
2484
|
providerDepth: opts.providerDepth,
|
|
1937
2485
|
wastedRenders: opts.wastedRenders
|
|
1938
2486
|
});
|
|
1939
|
-
await
|
|
2487
|
+
await shutdownPool2();
|
|
1940
2488
|
const fmt = resolveFormat2(opts.format);
|
|
1941
2489
|
if (fmt === "json") {
|
|
1942
2490
|
process.stdout.write(`${JSON.stringify(instrumentRoot, null, 2)}
|
|
@@ -1947,7 +2495,7 @@ Available: ${available}`
|
|
|
1947
2495
|
`);
|
|
1948
2496
|
}
|
|
1949
2497
|
} catch (err) {
|
|
1950
|
-
await
|
|
2498
|
+
await shutdownPool2();
|
|
1951
2499
|
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
1952
2500
|
`);
|
|
1953
2501
|
process.exit(1);
|
|
@@ -2267,22 +2815,22 @@ async function replayInteraction2(page, steps) {
|
|
|
2267
2815
|
}
|
|
2268
2816
|
}
|
|
2269
2817
|
}
|
|
2270
|
-
var
|
|
2271
|
-
async function
|
|
2272
|
-
if (
|
|
2273
|
-
|
|
2818
|
+
var _pool3 = null;
|
|
2819
|
+
async function getPool3() {
|
|
2820
|
+
if (_pool3 === null) {
|
|
2821
|
+
_pool3 = new BrowserPool3({
|
|
2274
2822
|
size: { browsers: 1, pagesPerBrowser: 2 },
|
|
2275
2823
|
viewportWidth: 1280,
|
|
2276
2824
|
viewportHeight: 800
|
|
2277
2825
|
});
|
|
2278
|
-
await
|
|
2826
|
+
await _pool3.init();
|
|
2279
2827
|
}
|
|
2280
|
-
return
|
|
2828
|
+
return _pool3;
|
|
2281
2829
|
}
|
|
2282
|
-
async function
|
|
2283
|
-
if (
|
|
2284
|
-
await
|
|
2285
|
-
|
|
2830
|
+
async function shutdownPool3() {
|
|
2831
|
+
if (_pool3 !== null) {
|
|
2832
|
+
await _pool3.close();
|
|
2833
|
+
_pool3 = null;
|
|
2286
2834
|
}
|
|
2287
2835
|
}
|
|
2288
2836
|
async function analyzeRenders(options) {
|
|
@@ -2297,9 +2845,9 @@ Available: ${available}`
|
|
|
2297
2845
|
);
|
|
2298
2846
|
}
|
|
2299
2847
|
const rootDir = process.cwd();
|
|
2300
|
-
const filePath =
|
|
2848
|
+
const filePath = resolve7(rootDir, descriptor.filePath);
|
|
2301
2849
|
const htmlHarness = await buildComponentHarness(filePath, options.componentName, {}, 1280);
|
|
2302
|
-
const pool = await
|
|
2850
|
+
const pool = await getPool3();
|
|
2303
2851
|
const slot = await pool.acquire();
|
|
2304
2852
|
const { page } = slot;
|
|
2305
2853
|
const startMs = performance.now();
|
|
@@ -2380,7 +2928,7 @@ function formatRendersTable(result) {
|
|
|
2380
2928
|
return lines.join("\n");
|
|
2381
2929
|
}
|
|
2382
2930
|
function createInstrumentRendersCommand() {
|
|
2383
|
-
return new
|
|
2931
|
+
return new Command5("renders").description("Trace re-render causality chains for a component during an interaction sequence").argument("<component>", "Component name to instrument (must be in manifest)").option(
|
|
2384
2932
|
"--interaction <json>",
|
|
2385
2933
|
`Interaction sequence JSON, e.g. '[{"action":"click","target":"button"}]'`,
|
|
2386
2934
|
"[]"
|
|
@@ -2407,7 +2955,7 @@ function createInstrumentRendersCommand() {
|
|
|
2407
2955
|
interaction,
|
|
2408
2956
|
manifestPath: opts.manifest
|
|
2409
2957
|
});
|
|
2410
|
-
await
|
|
2958
|
+
await shutdownPool3();
|
|
2411
2959
|
if (opts.json || !isTTY()) {
|
|
2412
2960
|
process.stdout.write(`${JSON.stringify(result, null, 2)}
|
|
2413
2961
|
`);
|
|
@@ -2416,7 +2964,7 @@ function createInstrumentRendersCommand() {
|
|
|
2416
2964
|
`);
|
|
2417
2965
|
}
|
|
2418
2966
|
} catch (err) {
|
|
2419
|
-
await
|
|
2967
|
+
await shutdownPool3();
|
|
2420
2968
|
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
2421
2969
|
`);
|
|
2422
2970
|
process.exit(1);
|
|
@@ -2425,7 +2973,7 @@ function createInstrumentRendersCommand() {
|
|
|
2425
2973
|
);
|
|
2426
2974
|
}
|
|
2427
2975
|
function createInstrumentCommand() {
|
|
2428
|
-
const instrumentCmd = new
|
|
2976
|
+
const instrumentCmd = new Command5("instrument").description(
|
|
2429
2977
|
"Structured instrumentation commands for React component analysis"
|
|
2430
2978
|
);
|
|
2431
2979
|
instrumentCmd.addCommand(createInstrumentRendersCommand());
|
|
@@ -2436,159 +2984,37 @@ function createInstrumentCommand() {
|
|
|
2436
2984
|
}
|
|
2437
2985
|
|
|
2438
2986
|
// src/render-commands.ts
|
|
2439
|
-
import { mkdirSync as mkdirSync3, writeFileSync as
|
|
2440
|
-
import { resolve as
|
|
2987
|
+
import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync5 } from "fs";
|
|
2988
|
+
import { resolve as resolve8 } from "path";
|
|
2441
2989
|
import {
|
|
2442
2990
|
ALL_CONTEXT_IDS,
|
|
2443
2991
|
ALL_STRESS_IDS,
|
|
2444
|
-
BrowserPool as
|
|
2992
|
+
BrowserPool as BrowserPool4,
|
|
2445
2993
|
contextAxis,
|
|
2446
2994
|
RenderMatrix,
|
|
2447
2995
|
SatoriRenderer,
|
|
2448
|
-
safeRender,
|
|
2996
|
+
safeRender as safeRender2,
|
|
2449
2997
|
stressAxis
|
|
2450
2998
|
} from "@agent-scope/render";
|
|
2451
|
-
import { Command as
|
|
2452
|
-
|
|
2453
|
-
// src/tailwind-css.ts
|
|
2454
|
-
import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
|
|
2455
|
-
import { createRequire } from "module";
|
|
2456
|
-
import { resolve as resolve6 } from "path";
|
|
2457
|
-
var CONFIG_FILENAMES = [
|
|
2458
|
-
".reactscope/config.json",
|
|
2459
|
-
".reactscope/config.js",
|
|
2460
|
-
".reactscope/config.mjs"
|
|
2461
|
-
];
|
|
2462
|
-
var STYLE_ENTRY_CANDIDATES = [
|
|
2463
|
-
"src/index.css",
|
|
2464
|
-
"src/globals.css",
|
|
2465
|
-
"app/globals.css",
|
|
2466
|
-
"app/index.css",
|
|
2467
|
-
"styles/index.css",
|
|
2468
|
-
"index.css"
|
|
2469
|
-
];
|
|
2470
|
-
var TAILWIND_IMPORT = /@import\s+["']tailwindcss["']\s*;?/;
|
|
2471
|
-
var compilerCache = null;
|
|
2472
|
-
function getCachedBuild(cwd) {
|
|
2473
|
-
if (compilerCache !== null && resolve6(compilerCache.cwd) === resolve6(cwd)) {
|
|
2474
|
-
return compilerCache.build;
|
|
2475
|
-
}
|
|
2476
|
-
return null;
|
|
2477
|
-
}
|
|
2478
|
-
function findStylesEntry(cwd) {
|
|
2479
|
-
for (const name of CONFIG_FILENAMES) {
|
|
2480
|
-
const p = resolve6(cwd, name);
|
|
2481
|
-
if (!existsSync4(p)) continue;
|
|
2482
|
-
try {
|
|
2483
|
-
if (name.endsWith(".json")) {
|
|
2484
|
-
const raw = readFileSync4(p, "utf-8");
|
|
2485
|
-
const data = JSON.parse(raw);
|
|
2486
|
-
const scope = data.scope;
|
|
2487
|
-
const entry = scope?.stylesEntry ?? data.stylesEntry;
|
|
2488
|
-
if (typeof entry === "string") {
|
|
2489
|
-
const full = resolve6(cwd, entry);
|
|
2490
|
-
if (existsSync4(full)) return full;
|
|
2491
|
-
}
|
|
2492
|
-
}
|
|
2493
|
-
} catch {
|
|
2494
|
-
}
|
|
2495
|
-
}
|
|
2496
|
-
const pkgPath = resolve6(cwd, "package.json");
|
|
2497
|
-
if (existsSync4(pkgPath)) {
|
|
2498
|
-
try {
|
|
2499
|
-
const raw = readFileSync4(pkgPath, "utf-8");
|
|
2500
|
-
const pkg = JSON.parse(raw);
|
|
2501
|
-
const entry = pkg.scope?.stylesEntry;
|
|
2502
|
-
if (typeof entry === "string") {
|
|
2503
|
-
const full = resolve6(cwd, entry);
|
|
2504
|
-
if (existsSync4(full)) return full;
|
|
2505
|
-
}
|
|
2506
|
-
} catch {
|
|
2507
|
-
}
|
|
2508
|
-
}
|
|
2509
|
-
for (const candidate of STYLE_ENTRY_CANDIDATES) {
|
|
2510
|
-
const full = resolve6(cwd, candidate);
|
|
2511
|
-
if (existsSync4(full)) {
|
|
2512
|
-
try {
|
|
2513
|
-
const content = readFileSync4(full, "utf-8");
|
|
2514
|
-
if (TAILWIND_IMPORT.test(content)) return full;
|
|
2515
|
-
} catch {
|
|
2516
|
-
}
|
|
2517
|
-
}
|
|
2518
|
-
}
|
|
2519
|
-
return null;
|
|
2520
|
-
}
|
|
2521
|
-
async function getTailwindCompiler(cwd) {
|
|
2522
|
-
const cached = getCachedBuild(cwd);
|
|
2523
|
-
if (cached !== null) return cached;
|
|
2524
|
-
const entryPath = findStylesEntry(cwd);
|
|
2525
|
-
if (entryPath === null) return null;
|
|
2526
|
-
let compile;
|
|
2527
|
-
try {
|
|
2528
|
-
const require2 = createRequire(resolve6(cwd, "package.json"));
|
|
2529
|
-
const tailwind = require2("tailwindcss");
|
|
2530
|
-
const fn = tailwind.compile;
|
|
2531
|
-
if (typeof fn !== "function") return null;
|
|
2532
|
-
compile = fn;
|
|
2533
|
-
} catch {
|
|
2534
|
-
return null;
|
|
2535
|
-
}
|
|
2536
|
-
const entryContent = readFileSync4(entryPath, "utf-8");
|
|
2537
|
-
const loadStylesheet = async (id, base) => {
|
|
2538
|
-
if (id === "tailwindcss") {
|
|
2539
|
-
const nodeModules = resolve6(cwd, "node_modules");
|
|
2540
|
-
const tailwindCssPath = resolve6(nodeModules, "tailwindcss", "index.css");
|
|
2541
|
-
if (!existsSync4(tailwindCssPath)) {
|
|
2542
|
-
throw new Error(
|
|
2543
|
-
`Tailwind v4: tailwindcss package not found at ${tailwindCssPath}. Install with: npm install tailwindcss`
|
|
2544
|
-
);
|
|
2545
|
-
}
|
|
2546
|
-
const content = readFileSync4(tailwindCssPath, "utf-8");
|
|
2547
|
-
return { path: "virtual:tailwindcss/index.css", base, content };
|
|
2548
|
-
}
|
|
2549
|
-
const full = resolve6(base, id);
|
|
2550
|
-
if (existsSync4(full)) {
|
|
2551
|
-
const content = readFileSync4(full, "utf-8");
|
|
2552
|
-
return { path: full, base: resolve6(full, ".."), content };
|
|
2553
|
-
}
|
|
2554
|
-
throw new Error(`Tailwind v4: could not load stylesheet: ${id} (base: ${base})`);
|
|
2555
|
-
};
|
|
2556
|
-
const result = await compile(entryContent, {
|
|
2557
|
-
base: cwd,
|
|
2558
|
-
from: entryPath,
|
|
2559
|
-
loadStylesheet
|
|
2560
|
-
});
|
|
2561
|
-
const build2 = result.build.bind(result);
|
|
2562
|
-
compilerCache = { cwd, build: build2 };
|
|
2563
|
-
return build2;
|
|
2564
|
-
}
|
|
2565
|
-
async function getCompiledCssForClasses(cwd, classes) {
|
|
2566
|
-
const build2 = await getTailwindCompiler(cwd);
|
|
2567
|
-
if (build2 === null) return null;
|
|
2568
|
-
const deduped = [...new Set(classes)].filter(Boolean);
|
|
2569
|
-
if (deduped.length === 0) return null;
|
|
2570
|
-
return build2(deduped);
|
|
2571
|
-
}
|
|
2572
|
-
|
|
2573
|
-
// src/render-commands.ts
|
|
2999
|
+
import { Command as Command6 } from "commander";
|
|
2574
3000
|
var MANIFEST_PATH6 = ".reactscope/manifest.json";
|
|
2575
3001
|
var DEFAULT_OUTPUT_DIR = ".reactscope/renders";
|
|
2576
|
-
var
|
|
2577
|
-
async function
|
|
2578
|
-
if (
|
|
2579
|
-
|
|
3002
|
+
var _pool4 = null;
|
|
3003
|
+
async function getPool4(viewportWidth, viewportHeight) {
|
|
3004
|
+
if (_pool4 === null) {
|
|
3005
|
+
_pool4 = new BrowserPool4({
|
|
2580
3006
|
size: { browsers: 1, pagesPerBrowser: 4 },
|
|
2581
3007
|
viewportWidth,
|
|
2582
3008
|
viewportHeight
|
|
2583
3009
|
});
|
|
2584
|
-
await
|
|
3010
|
+
await _pool4.init();
|
|
2585
3011
|
}
|
|
2586
|
-
return
|
|
3012
|
+
return _pool4;
|
|
2587
3013
|
}
|
|
2588
|
-
async function
|
|
2589
|
-
if (
|
|
2590
|
-
await
|
|
2591
|
-
|
|
3014
|
+
async function shutdownPool4() {
|
|
3015
|
+
if (_pool4 !== null) {
|
|
3016
|
+
await _pool4.close();
|
|
3017
|
+
_pool4 = null;
|
|
2592
3018
|
}
|
|
2593
3019
|
}
|
|
2594
3020
|
function buildRenderer(filePath, componentName, viewportWidth, viewportHeight) {
|
|
@@ -2599,7 +3025,7 @@ function buildRenderer(filePath, componentName, viewportWidth, viewportHeight) {
|
|
|
2599
3025
|
_satori: satori,
|
|
2600
3026
|
async renderCell(props, _complexityClass) {
|
|
2601
3027
|
const startMs = performance.now();
|
|
2602
|
-
const pool = await
|
|
3028
|
+
const pool = await getPool4(viewportWidth, viewportHeight);
|
|
2603
3029
|
const htmlHarness = await buildComponentHarness(
|
|
2604
3030
|
filePath,
|
|
2605
3031
|
componentName,
|
|
@@ -2718,13 +3144,13 @@ Available: ${available}`
|
|
|
2718
3144
|
}
|
|
2719
3145
|
const { width, height } = parseViewport(opts.viewport);
|
|
2720
3146
|
const rootDir = process.cwd();
|
|
2721
|
-
const filePath =
|
|
3147
|
+
const filePath = resolve8(rootDir, descriptor.filePath);
|
|
2722
3148
|
const renderer = buildRenderer(filePath, componentName, width, height);
|
|
2723
3149
|
process.stderr.write(
|
|
2724
3150
|
`Rendering ${componentName} [${descriptor.complexityClass}] at ${width}\xD7${height}\u2026
|
|
2725
3151
|
`
|
|
2726
3152
|
);
|
|
2727
|
-
const outcome = await
|
|
3153
|
+
const outcome = await safeRender2(
|
|
2728
3154
|
() => renderer.renderCell(props, descriptor.complexityClass),
|
|
2729
3155
|
{
|
|
2730
3156
|
props,
|
|
@@ -2735,7 +3161,7 @@ Available: ${available}`
|
|
|
2735
3161
|
}
|
|
2736
3162
|
}
|
|
2737
3163
|
);
|
|
2738
|
-
await
|
|
3164
|
+
await shutdownPool4();
|
|
2739
3165
|
if (outcome.crashed) {
|
|
2740
3166
|
process.stderr.write(`\u2717 Render failed: ${outcome.error.message}
|
|
2741
3167
|
`);
|
|
@@ -2748,8 +3174,8 @@ Available: ${available}`
|
|
|
2748
3174
|
}
|
|
2749
3175
|
const result = outcome.result;
|
|
2750
3176
|
if (opts.output !== void 0) {
|
|
2751
|
-
const outPath =
|
|
2752
|
-
|
|
3177
|
+
const outPath = resolve8(process.cwd(), opts.output);
|
|
3178
|
+
writeFileSync5(outPath, result.screenshot);
|
|
2753
3179
|
process.stdout.write(
|
|
2754
3180
|
`\u2713 ${componentName} \u2192 ${opts.output} (${result.width}\xD7${result.height}, ${result.renderTimeMs.toFixed(0)}ms)
|
|
2755
3181
|
`
|
|
@@ -2762,20 +3188,20 @@ Available: ${available}`
|
|
|
2762
3188
|
process.stdout.write(`${JSON.stringify(json, null, 2)}
|
|
2763
3189
|
`);
|
|
2764
3190
|
} else if (fmt === "file") {
|
|
2765
|
-
const dir =
|
|
3191
|
+
const dir = resolve8(process.cwd(), DEFAULT_OUTPUT_DIR);
|
|
2766
3192
|
mkdirSync3(dir, { recursive: true });
|
|
2767
|
-
const outPath =
|
|
2768
|
-
|
|
3193
|
+
const outPath = resolve8(dir, `${componentName}.png`);
|
|
3194
|
+
writeFileSync5(outPath, result.screenshot);
|
|
2769
3195
|
const relPath = `${DEFAULT_OUTPUT_DIR}/${componentName}.png`;
|
|
2770
3196
|
process.stdout.write(
|
|
2771
3197
|
`\u2713 ${componentName} \u2192 ${relPath} (${result.width}\xD7${result.height}, ${result.renderTimeMs.toFixed(0)}ms)
|
|
2772
3198
|
`
|
|
2773
3199
|
);
|
|
2774
3200
|
} else {
|
|
2775
|
-
const dir =
|
|
3201
|
+
const dir = resolve8(process.cwd(), DEFAULT_OUTPUT_DIR);
|
|
2776
3202
|
mkdirSync3(dir, { recursive: true });
|
|
2777
|
-
const outPath =
|
|
2778
|
-
|
|
3203
|
+
const outPath = resolve8(dir, `${componentName}.png`);
|
|
3204
|
+
writeFileSync5(outPath, result.screenshot);
|
|
2779
3205
|
const relPath = `${DEFAULT_OUTPUT_DIR}/${componentName}.png`;
|
|
2780
3206
|
process.stdout.write(
|
|
2781
3207
|
`\u2713 ${componentName} \u2192 ${relPath} (${result.width}\xD7${result.height}, ${result.renderTimeMs.toFixed(0)}ms)
|
|
@@ -2783,7 +3209,7 @@ Available: ${available}`
|
|
|
2783
3209
|
);
|
|
2784
3210
|
}
|
|
2785
3211
|
} catch (err) {
|
|
2786
|
-
await
|
|
3212
|
+
await shutdownPool4();
|
|
2787
3213
|
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
2788
3214
|
`);
|
|
2789
3215
|
process.exit(1);
|
|
@@ -2810,7 +3236,7 @@ Available: ${available}`
|
|
|
2810
3236
|
const concurrency = Math.max(1, parseInt(opts.concurrency, 10) || 8);
|
|
2811
3237
|
const { width, height } = { width: 375, height: 812 };
|
|
2812
3238
|
const rootDir = process.cwd();
|
|
2813
|
-
const filePath =
|
|
3239
|
+
const filePath = resolve8(rootDir, descriptor.filePath);
|
|
2814
3240
|
const renderer = buildRenderer(filePath, componentName, width, height);
|
|
2815
3241
|
const axes = [];
|
|
2816
3242
|
if (opts.axes !== void 0) {
|
|
@@ -2868,7 +3294,7 @@ Available: ${available}`
|
|
|
2868
3294
|
concurrency
|
|
2869
3295
|
});
|
|
2870
3296
|
const result = await matrix.render();
|
|
2871
|
-
await
|
|
3297
|
+
await shutdownPool4();
|
|
2872
3298
|
process.stderr.write(
|
|
2873
3299
|
`Done. ${result.stats.totalCells} cells, avg ${result.stats.avgRenderTimeMs.toFixed(1)}ms
|
|
2874
3300
|
`
|
|
@@ -2877,8 +3303,8 @@ Available: ${available}`
|
|
|
2877
3303
|
const { SpriteSheetGenerator: SpriteSheetGenerator2 } = await import("@agent-scope/render");
|
|
2878
3304
|
const gen = new SpriteSheetGenerator2();
|
|
2879
3305
|
const sheet = await gen.generate(result);
|
|
2880
|
-
const spritePath =
|
|
2881
|
-
|
|
3306
|
+
const spritePath = resolve8(process.cwd(), opts.sprite);
|
|
3307
|
+
writeFileSync5(spritePath, sheet.png);
|
|
2882
3308
|
process.stderr.write(`Sprite sheet saved to ${spritePath}
|
|
2883
3309
|
`);
|
|
2884
3310
|
}
|
|
@@ -2887,10 +3313,10 @@ Available: ${available}`
|
|
|
2887
3313
|
const { SpriteSheetGenerator: SpriteSheetGenerator2 } = await import("@agent-scope/render");
|
|
2888
3314
|
const gen = new SpriteSheetGenerator2();
|
|
2889
3315
|
const sheet = await gen.generate(result);
|
|
2890
|
-
const dir =
|
|
3316
|
+
const dir = resolve8(process.cwd(), DEFAULT_OUTPUT_DIR);
|
|
2891
3317
|
mkdirSync3(dir, { recursive: true });
|
|
2892
|
-
const outPath =
|
|
2893
|
-
|
|
3318
|
+
const outPath = resolve8(dir, `${componentName}-matrix.png`);
|
|
3319
|
+
writeFileSync5(outPath, sheet.png);
|
|
2894
3320
|
const relPath = `${DEFAULT_OUTPUT_DIR}/${componentName}-matrix.png`;
|
|
2895
3321
|
process.stdout.write(
|
|
2896
3322
|
`\u2713 ${componentName} matrix (${result.stats.totalCells} cells) \u2192 ${relPath} (${result.stats.wallClockTimeMs.toFixed(0)}ms total)
|
|
@@ -2913,7 +3339,7 @@ Available: ${available}`
|
|
|
2913
3339
|
process.stdout.write(formatMatrixCsv(componentName, result));
|
|
2914
3340
|
}
|
|
2915
3341
|
} catch (err) {
|
|
2916
|
-
await
|
|
3342
|
+
await shutdownPool4();
|
|
2917
3343
|
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
2918
3344
|
`);
|
|
2919
3345
|
process.exit(1);
|
|
@@ -2933,7 +3359,7 @@ function registerRenderAll(renderCmd) {
|
|
|
2933
3359
|
return;
|
|
2934
3360
|
}
|
|
2935
3361
|
const concurrency = Math.max(1, parseInt(opts.concurrency, 10) || 4);
|
|
2936
|
-
const outputDir =
|
|
3362
|
+
const outputDir = resolve8(process.cwd(), opts.outputDir);
|
|
2937
3363
|
mkdirSync3(outputDir, { recursive: true });
|
|
2938
3364
|
const rootDir = process.cwd();
|
|
2939
3365
|
process.stderr.write(`Rendering ${total} components (concurrency: ${concurrency})\u2026
|
|
@@ -2943,9 +3369,9 @@ function registerRenderAll(renderCmd) {
|
|
|
2943
3369
|
const renderOne = async (name) => {
|
|
2944
3370
|
const descriptor = manifest.components[name];
|
|
2945
3371
|
if (descriptor === void 0) return;
|
|
2946
|
-
const filePath =
|
|
3372
|
+
const filePath = resolve8(rootDir, descriptor.filePath);
|
|
2947
3373
|
const renderer = buildRenderer(filePath, name, 375, 812);
|
|
2948
|
-
const outcome = await
|
|
3374
|
+
const outcome = await safeRender2(
|
|
2949
3375
|
() => renderer.renderCell({}, descriptor.complexityClass),
|
|
2950
3376
|
{
|
|
2951
3377
|
props: {},
|
|
@@ -2966,8 +3392,8 @@ function registerRenderAll(renderCmd) {
|
|
|
2966
3392
|
success: false,
|
|
2967
3393
|
errorMessage: outcome.error.message
|
|
2968
3394
|
});
|
|
2969
|
-
const errPath =
|
|
2970
|
-
|
|
3395
|
+
const errPath = resolve8(outputDir, `${name}.error.json`);
|
|
3396
|
+
writeFileSync5(
|
|
2971
3397
|
errPath,
|
|
2972
3398
|
JSON.stringify(
|
|
2973
3399
|
{
|
|
@@ -2984,10 +3410,10 @@ function registerRenderAll(renderCmd) {
|
|
|
2984
3410
|
}
|
|
2985
3411
|
const result = outcome.result;
|
|
2986
3412
|
results.push({ name, renderTimeMs: result.renderTimeMs, success: true });
|
|
2987
|
-
const pngPath =
|
|
2988
|
-
|
|
2989
|
-
const jsonPath =
|
|
2990
|
-
|
|
3413
|
+
const pngPath = resolve8(outputDir, `${name}.png`);
|
|
3414
|
+
writeFileSync5(pngPath, result.screenshot);
|
|
3415
|
+
const jsonPath = resolve8(outputDir, `${name}.json`);
|
|
3416
|
+
writeFileSync5(jsonPath, JSON.stringify(formatRenderJson(name, {}, result), null, 2));
|
|
2991
3417
|
if (isTTY()) {
|
|
2992
3418
|
process.stdout.write(
|
|
2993
3419
|
`\u2713 ${name} \u2192 ${opts.outputDir}/${name}.png (${result.width}\xD7${result.height}, ${result.renderTimeMs.toFixed(0)}ms)
|
|
@@ -3010,13 +3436,13 @@ function registerRenderAll(renderCmd) {
|
|
|
3010
3436
|
workers.push(worker());
|
|
3011
3437
|
}
|
|
3012
3438
|
await Promise.all(workers);
|
|
3013
|
-
await
|
|
3439
|
+
await shutdownPool4();
|
|
3014
3440
|
process.stderr.write("\n");
|
|
3015
3441
|
const summary = formatSummaryText(results, outputDir);
|
|
3016
3442
|
process.stderr.write(`${summary}
|
|
3017
3443
|
`);
|
|
3018
3444
|
} catch (err) {
|
|
3019
|
-
await
|
|
3445
|
+
await shutdownPool4();
|
|
3020
3446
|
process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
|
|
3021
3447
|
`);
|
|
3022
3448
|
process.exit(1);
|
|
@@ -3049,7 +3475,7 @@ function resolveMatrixFormat(formatFlag, spriteAlreadyWritten) {
|
|
|
3049
3475
|
return "json";
|
|
3050
3476
|
}
|
|
3051
3477
|
function createRenderCommand() {
|
|
3052
|
-
const renderCmd = new
|
|
3478
|
+
const renderCmd = new Command6("render").description(
|
|
3053
3479
|
"Render components to PNG or JSON via esbuild + BrowserPool"
|
|
3054
3480
|
);
|
|
3055
3481
|
registerRenderSingle(renderCmd);
|
|
@@ -3059,32 +3485,32 @@ function createRenderCommand() {
|
|
|
3059
3485
|
}
|
|
3060
3486
|
|
|
3061
3487
|
// src/report/baseline.ts
|
|
3062
|
-
import { existsSync as
|
|
3063
|
-
import { resolve as
|
|
3064
|
-
import { generateManifest as
|
|
3065
|
-
import { BrowserPool as
|
|
3066
|
-
import { ComplianceEngine, TokenResolver } from "@agent-scope/tokens";
|
|
3488
|
+
import { existsSync as existsSync6, mkdirSync as mkdirSync4, rmSync, writeFileSync as writeFileSync6 } from "fs";
|
|
3489
|
+
import { resolve as resolve9 } from "path";
|
|
3490
|
+
import { generateManifest as generateManifest3 } from "@agent-scope/manifest";
|
|
3491
|
+
import { BrowserPool as BrowserPool5, safeRender as safeRender3 } from "@agent-scope/render";
|
|
3492
|
+
import { ComplianceEngine as ComplianceEngine2, TokenResolver as TokenResolver2 } from "@agent-scope/tokens";
|
|
3067
3493
|
var DEFAULT_BASELINE_DIR = ".reactscope/baseline";
|
|
3068
|
-
var
|
|
3069
|
-
async function
|
|
3070
|
-
if (
|
|
3071
|
-
|
|
3494
|
+
var _pool5 = null;
|
|
3495
|
+
async function getPool5(viewportWidth, viewportHeight) {
|
|
3496
|
+
if (_pool5 === null) {
|
|
3497
|
+
_pool5 = new BrowserPool5({
|
|
3072
3498
|
size: { browsers: 1, pagesPerBrowser: 4 },
|
|
3073
3499
|
viewportWidth,
|
|
3074
3500
|
viewportHeight
|
|
3075
3501
|
});
|
|
3076
|
-
await
|
|
3502
|
+
await _pool5.init();
|
|
3077
3503
|
}
|
|
3078
|
-
return
|
|
3504
|
+
return _pool5;
|
|
3079
3505
|
}
|
|
3080
|
-
async function
|
|
3081
|
-
if (
|
|
3082
|
-
await
|
|
3083
|
-
|
|
3506
|
+
async function shutdownPool5() {
|
|
3507
|
+
if (_pool5 !== null) {
|
|
3508
|
+
await _pool5.close();
|
|
3509
|
+
_pool5 = null;
|
|
3084
3510
|
}
|
|
3085
3511
|
}
|
|
3086
|
-
async function
|
|
3087
|
-
const pool = await
|
|
3512
|
+
async function renderComponent2(filePath, componentName, props, viewportWidth, viewportHeight) {
|
|
3513
|
+
const pool = await getPool5(viewportWidth, viewportHeight);
|
|
3088
3514
|
const htmlHarness = await buildComponentHarness(filePath, componentName, props, viewportWidth);
|
|
3089
3515
|
const slot = await pool.acquire();
|
|
3090
3516
|
const { page } = slot;
|
|
@@ -3174,7 +3600,7 @@ async function renderComponent(filePath, componentName, props, viewportWidth, vi
|
|
|
3174
3600
|
pool.release(slot);
|
|
3175
3601
|
}
|
|
3176
3602
|
}
|
|
3177
|
-
function
|
|
3603
|
+
function extractComputedStyles2(computedStylesRaw) {
|
|
3178
3604
|
const flat = {};
|
|
3179
3605
|
for (const styles of Object.values(computedStylesRaw)) {
|
|
3180
3606
|
Object.assign(flat, styles);
|
|
@@ -3209,30 +3635,30 @@ async function runBaseline(options = {}) {
|
|
|
3209
3635
|
} = options;
|
|
3210
3636
|
const startTime = performance.now();
|
|
3211
3637
|
const rootDir = process.cwd();
|
|
3212
|
-
const baselineDir =
|
|
3213
|
-
const rendersDir =
|
|
3214
|
-
if (
|
|
3638
|
+
const baselineDir = resolve9(rootDir, outputDir);
|
|
3639
|
+
const rendersDir = resolve9(baselineDir, "renders");
|
|
3640
|
+
if (existsSync6(baselineDir)) {
|
|
3215
3641
|
rmSync(baselineDir, { recursive: true, force: true });
|
|
3216
3642
|
}
|
|
3217
3643
|
mkdirSync4(rendersDir, { recursive: true });
|
|
3218
3644
|
let manifest;
|
|
3219
3645
|
if (manifestPath !== void 0) {
|
|
3220
|
-
const { readFileSync:
|
|
3221
|
-
const absPath =
|
|
3222
|
-
if (!
|
|
3646
|
+
const { readFileSync: readFileSync11 } = await import("fs");
|
|
3647
|
+
const absPath = resolve9(rootDir, manifestPath);
|
|
3648
|
+
if (!existsSync6(absPath)) {
|
|
3223
3649
|
throw new Error(`Manifest not found at ${absPath}.`);
|
|
3224
3650
|
}
|
|
3225
|
-
manifest = JSON.parse(
|
|
3651
|
+
manifest = JSON.parse(readFileSync11(absPath, "utf-8"));
|
|
3226
3652
|
process.stderr.write(`Loaded manifest from ${manifestPath}
|
|
3227
3653
|
`);
|
|
3228
3654
|
} else {
|
|
3229
3655
|
process.stderr.write("Scanning for React components\u2026\n");
|
|
3230
|
-
manifest = await
|
|
3656
|
+
manifest = await generateManifest3({ rootDir });
|
|
3231
3657
|
const count = Object.keys(manifest.components).length;
|
|
3232
3658
|
process.stderr.write(`Found ${count} components.
|
|
3233
3659
|
`);
|
|
3234
3660
|
}
|
|
3235
|
-
|
|
3661
|
+
writeFileSync6(resolve9(baselineDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf-8");
|
|
3236
3662
|
let componentNames = Object.keys(manifest.components);
|
|
3237
3663
|
if (componentsGlob !== void 0) {
|
|
3238
3664
|
componentNames = componentNames.filter((name) => matchGlob(componentsGlob, name));
|
|
@@ -3252,8 +3678,8 @@ async function runBaseline(options = {}) {
|
|
|
3252
3678
|
aggregateCompliance: 1,
|
|
3253
3679
|
auditedAt: (/* @__PURE__ */ new Date()).toISOString()
|
|
3254
3680
|
};
|
|
3255
|
-
|
|
3256
|
-
|
|
3681
|
+
writeFileSync6(
|
|
3682
|
+
resolve9(baselineDir, "compliance.json"),
|
|
3257
3683
|
JSON.stringify(emptyReport, null, 2),
|
|
3258
3684
|
"utf-8"
|
|
3259
3685
|
);
|
|
@@ -3274,9 +3700,9 @@ async function runBaseline(options = {}) {
|
|
|
3274
3700
|
const renderOne = async (name) => {
|
|
3275
3701
|
const descriptor = manifest.components[name];
|
|
3276
3702
|
if (descriptor === void 0) return;
|
|
3277
|
-
const filePath =
|
|
3278
|
-
const outcome = await
|
|
3279
|
-
() =>
|
|
3703
|
+
const filePath = resolve9(rootDir, descriptor.filePath);
|
|
3704
|
+
const outcome = await safeRender3(
|
|
3705
|
+
() => renderComponent2(filePath, name, {}, viewportWidth, viewportHeight),
|
|
3280
3706
|
{
|
|
3281
3707
|
props: {},
|
|
3282
3708
|
sourceLocation: {
|
|
@@ -3293,8 +3719,8 @@ async function runBaseline(options = {}) {
|
|
|
3293
3719
|
}
|
|
3294
3720
|
if (outcome.crashed) {
|
|
3295
3721
|
failureCount++;
|
|
3296
|
-
const errPath =
|
|
3297
|
-
|
|
3722
|
+
const errPath = resolve9(rendersDir, `${name}.error.json`);
|
|
3723
|
+
writeFileSync6(
|
|
3298
3724
|
errPath,
|
|
3299
3725
|
JSON.stringify(
|
|
3300
3726
|
{
|
|
@@ -3311,14 +3737,14 @@ async function runBaseline(options = {}) {
|
|
|
3311
3737
|
return;
|
|
3312
3738
|
}
|
|
3313
3739
|
const result = outcome.result;
|
|
3314
|
-
|
|
3740
|
+
writeFileSync6(resolve9(rendersDir, `${name}.png`), result.screenshot);
|
|
3315
3741
|
const jsonOutput = formatRenderJson(name, {}, result);
|
|
3316
|
-
|
|
3317
|
-
|
|
3742
|
+
writeFileSync6(
|
|
3743
|
+
resolve9(rendersDir, `${name}.json`),
|
|
3318
3744
|
JSON.stringify(jsonOutput, null, 2),
|
|
3319
3745
|
"utf-8"
|
|
3320
3746
|
);
|
|
3321
|
-
computedStylesMap.set(name,
|
|
3747
|
+
computedStylesMap.set(name, extractComputedStyles2(result.computedStyles));
|
|
3322
3748
|
};
|
|
3323
3749
|
const worker = async () => {
|
|
3324
3750
|
while (nextIdx < componentNames.length) {
|
|
@@ -3334,15 +3760,15 @@ async function runBaseline(options = {}) {
|
|
|
3334
3760
|
workers.push(worker());
|
|
3335
3761
|
}
|
|
3336
3762
|
await Promise.all(workers);
|
|
3337
|
-
await
|
|
3763
|
+
await shutdownPool5();
|
|
3338
3764
|
if (isTTY()) {
|
|
3339
3765
|
process.stderr.write("\n");
|
|
3340
3766
|
}
|
|
3341
|
-
const resolver = new
|
|
3342
|
-
const engine = new
|
|
3767
|
+
const resolver = new TokenResolver2([]);
|
|
3768
|
+
const engine = new ComplianceEngine2(resolver);
|
|
3343
3769
|
const batchReport = engine.auditBatch(computedStylesMap);
|
|
3344
|
-
|
|
3345
|
-
|
|
3770
|
+
writeFileSync6(
|
|
3771
|
+
resolve9(baselineDir, "compliance.json"),
|
|
3346
3772
|
JSON.stringify(batchReport, null, 2),
|
|
3347
3773
|
"utf-8"
|
|
3348
3774
|
);
|
|
@@ -3385,43 +3811,43 @@ function registerBaselineSubCommand(reportCmd) {
|
|
|
3385
3811
|
}
|
|
3386
3812
|
|
|
3387
3813
|
// src/report/diff.ts
|
|
3388
|
-
import { existsSync as
|
|
3389
|
-
import { resolve as
|
|
3390
|
-
import { generateManifest as
|
|
3391
|
-
import { BrowserPool as
|
|
3392
|
-
import { ComplianceEngine as
|
|
3814
|
+
import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync7 } from "fs";
|
|
3815
|
+
import { resolve as resolve10 } from "path";
|
|
3816
|
+
import { generateManifest as generateManifest4 } from "@agent-scope/manifest";
|
|
3817
|
+
import { BrowserPool as BrowserPool6, safeRender as safeRender4 } from "@agent-scope/render";
|
|
3818
|
+
import { ComplianceEngine as ComplianceEngine3, TokenResolver as TokenResolver3 } from "@agent-scope/tokens";
|
|
3393
3819
|
var DEFAULT_BASELINE_DIR2 = ".reactscope/baseline";
|
|
3394
3820
|
function loadBaselineCompliance(baselineDir) {
|
|
3395
|
-
const compliancePath =
|
|
3396
|
-
if (!
|
|
3397
|
-
const raw = JSON.parse(
|
|
3821
|
+
const compliancePath = resolve10(baselineDir, "compliance.json");
|
|
3822
|
+
if (!existsSync7(compliancePath)) return null;
|
|
3823
|
+
const raw = JSON.parse(readFileSync6(compliancePath, "utf-8"));
|
|
3398
3824
|
return raw;
|
|
3399
3825
|
}
|
|
3400
|
-
function
|
|
3401
|
-
const jsonPath =
|
|
3402
|
-
if (!
|
|
3403
|
-
return JSON.parse(
|
|
3826
|
+
function loadBaselineRenderJson2(baselineDir, componentName) {
|
|
3827
|
+
const jsonPath = resolve10(baselineDir, "renders", `${componentName}.json`);
|
|
3828
|
+
if (!existsSync7(jsonPath)) return null;
|
|
3829
|
+
return JSON.parse(readFileSync6(jsonPath, "utf-8"));
|
|
3404
3830
|
}
|
|
3405
|
-
var
|
|
3406
|
-
async function
|
|
3407
|
-
if (
|
|
3408
|
-
|
|
3831
|
+
var _pool6 = null;
|
|
3832
|
+
async function getPool6(viewportWidth, viewportHeight) {
|
|
3833
|
+
if (_pool6 === null) {
|
|
3834
|
+
_pool6 = new BrowserPool6({
|
|
3409
3835
|
size: { browsers: 1, pagesPerBrowser: 4 },
|
|
3410
3836
|
viewportWidth,
|
|
3411
3837
|
viewportHeight
|
|
3412
3838
|
});
|
|
3413
|
-
await
|
|
3839
|
+
await _pool6.init();
|
|
3414
3840
|
}
|
|
3415
|
-
return
|
|
3841
|
+
return _pool6;
|
|
3416
3842
|
}
|
|
3417
|
-
async function
|
|
3418
|
-
if (
|
|
3419
|
-
await
|
|
3420
|
-
|
|
3843
|
+
async function shutdownPool6() {
|
|
3844
|
+
if (_pool6 !== null) {
|
|
3845
|
+
await _pool6.close();
|
|
3846
|
+
_pool6 = null;
|
|
3421
3847
|
}
|
|
3422
3848
|
}
|
|
3423
|
-
async function
|
|
3424
|
-
const pool = await
|
|
3849
|
+
async function renderComponent3(filePath, componentName, props, viewportWidth, viewportHeight) {
|
|
3850
|
+
const pool = await getPool6(viewportWidth, viewportHeight);
|
|
3425
3851
|
const htmlHarness = await buildComponentHarness(filePath, componentName, props, viewportWidth);
|
|
3426
3852
|
const slot = await pool.acquire();
|
|
3427
3853
|
const { page } = slot;
|
|
@@ -3511,7 +3937,7 @@ async function renderComponent2(filePath, componentName, props, viewportWidth, v
|
|
|
3511
3937
|
pool.release(slot);
|
|
3512
3938
|
}
|
|
3513
3939
|
}
|
|
3514
|
-
function
|
|
3940
|
+
function extractComputedStyles3(computedStylesRaw) {
|
|
3515
3941
|
const flat = {};
|
|
3516
3942
|
for (const styles of Object.values(computedStylesRaw)) {
|
|
3517
3943
|
Object.assign(flat, styles);
|
|
@@ -3567,19 +3993,19 @@ async function runDiff(options = {}) {
|
|
|
3567
3993
|
} = options;
|
|
3568
3994
|
const startTime = performance.now();
|
|
3569
3995
|
const rootDir = process.cwd();
|
|
3570
|
-
const baselineDir =
|
|
3571
|
-
if (!
|
|
3996
|
+
const baselineDir = resolve10(rootDir, baselineDirRaw);
|
|
3997
|
+
if (!existsSync7(baselineDir)) {
|
|
3572
3998
|
throw new Error(
|
|
3573
3999
|
`Baseline directory not found at "${baselineDir}". Run \`scope report baseline\` first to create a baseline snapshot.`
|
|
3574
4000
|
);
|
|
3575
4001
|
}
|
|
3576
|
-
const baselineManifestPath =
|
|
3577
|
-
if (!
|
|
4002
|
+
const baselineManifestPath = resolve10(baselineDir, "manifest.json");
|
|
4003
|
+
if (!existsSync7(baselineManifestPath)) {
|
|
3578
4004
|
throw new Error(
|
|
3579
4005
|
`Baseline manifest.json not found at "${baselineManifestPath}". The baseline directory may be incomplete \u2014 re-run \`scope report baseline\`.`
|
|
3580
4006
|
);
|
|
3581
4007
|
}
|
|
3582
|
-
const baselineManifest = JSON.parse(
|
|
4008
|
+
const baselineManifest = JSON.parse(readFileSync6(baselineManifestPath, "utf-8"));
|
|
3583
4009
|
const baselineCompliance = loadBaselineCompliance(baselineDir);
|
|
3584
4010
|
const baselineComponentNames = new Set(Object.keys(baselineManifest.components));
|
|
3585
4011
|
process.stderr.write(
|
|
@@ -3588,16 +4014,16 @@ async function runDiff(options = {}) {
|
|
|
3588
4014
|
);
|
|
3589
4015
|
let currentManifest;
|
|
3590
4016
|
if (manifestPath !== void 0) {
|
|
3591
|
-
const absPath =
|
|
3592
|
-
if (!
|
|
4017
|
+
const absPath = resolve10(rootDir, manifestPath);
|
|
4018
|
+
if (!existsSync7(absPath)) {
|
|
3593
4019
|
throw new Error(`Manifest not found at "${absPath}".`);
|
|
3594
4020
|
}
|
|
3595
|
-
currentManifest = JSON.parse(
|
|
4021
|
+
currentManifest = JSON.parse(readFileSync6(absPath, "utf-8"));
|
|
3596
4022
|
process.stderr.write(`Loaded manifest from ${manifestPath}
|
|
3597
4023
|
`);
|
|
3598
4024
|
} else {
|
|
3599
4025
|
process.stderr.write("Scanning for React components\u2026\n");
|
|
3600
|
-
currentManifest = await
|
|
4026
|
+
currentManifest = await generateManifest4({ rootDir });
|
|
3601
4027
|
const count = Object.keys(currentManifest.components).length;
|
|
3602
4028
|
process.stderr.write(`Found ${count} components.
|
|
3603
4029
|
`);
|
|
@@ -3625,9 +4051,9 @@ async function runDiff(options = {}) {
|
|
|
3625
4051
|
const renderOne = async (name) => {
|
|
3626
4052
|
const descriptor = currentManifest.components[name];
|
|
3627
4053
|
if (descriptor === void 0) return;
|
|
3628
|
-
const filePath =
|
|
3629
|
-
const outcome = await
|
|
3630
|
-
() =>
|
|
4054
|
+
const filePath = resolve10(rootDir, descriptor.filePath);
|
|
4055
|
+
const outcome = await safeRender4(
|
|
4056
|
+
() => renderComponent3(filePath, name, {}, viewportWidth, viewportHeight),
|
|
3631
4057
|
{
|
|
3632
4058
|
props: {},
|
|
3633
4059
|
sourceLocation: {
|
|
@@ -3652,7 +4078,7 @@ async function runDiff(options = {}) {
|
|
|
3652
4078
|
height: result.height,
|
|
3653
4079
|
renderTimeMs: result.renderTimeMs
|
|
3654
4080
|
});
|
|
3655
|
-
computedStylesMap.set(name,
|
|
4081
|
+
computedStylesMap.set(name, extractComputedStyles3(result.computedStyles));
|
|
3656
4082
|
};
|
|
3657
4083
|
if (total > 0) {
|
|
3658
4084
|
const worker = async () => {
|
|
@@ -3670,18 +4096,18 @@ async function runDiff(options = {}) {
|
|
|
3670
4096
|
}
|
|
3671
4097
|
await Promise.all(workers);
|
|
3672
4098
|
}
|
|
3673
|
-
await
|
|
4099
|
+
await shutdownPool6();
|
|
3674
4100
|
if (isTTY() && total > 0) {
|
|
3675
4101
|
process.stderr.write("\n");
|
|
3676
4102
|
}
|
|
3677
|
-
const resolver = new
|
|
3678
|
-
const engine = new
|
|
4103
|
+
const resolver = new TokenResolver3([]);
|
|
4104
|
+
const engine = new ComplianceEngine3(resolver);
|
|
3679
4105
|
const currentBatchReport = engine.auditBatch(computedStylesMap);
|
|
3680
4106
|
const entries = [];
|
|
3681
4107
|
for (const name of componentNames) {
|
|
3682
4108
|
const baselineComp = baselineCompliance?.components[name] ?? null;
|
|
3683
4109
|
const currentComp = currentBatchReport.components[name] ?? null;
|
|
3684
|
-
const baselineMeta =
|
|
4110
|
+
const baselineMeta = loadBaselineRenderJson2(baselineDir, name);
|
|
3685
4111
|
const currentMeta = currentRenderMeta.get(name) ?? null;
|
|
3686
4112
|
const failed = renderFailures.has(name);
|
|
3687
4113
|
const baselineComplianceScore = baselineComp?.aggregateCompliance ?? null;
|
|
@@ -3701,7 +4127,7 @@ async function runDiff(options = {}) {
|
|
|
3701
4127
|
}
|
|
3702
4128
|
for (const name of removedNames) {
|
|
3703
4129
|
const baselineComp = baselineCompliance?.components[name] ?? null;
|
|
3704
|
-
const baselineMeta =
|
|
4130
|
+
const baselineMeta = loadBaselineRenderJson2(baselineDir, name);
|
|
3705
4131
|
entries.push({
|
|
3706
4132
|
name,
|
|
3707
4133
|
status: "removed",
|
|
@@ -3843,7 +4269,7 @@ function registerDiffSubCommand(reportCmd) {
|
|
|
3843
4269
|
regressionThreshold
|
|
3844
4270
|
});
|
|
3845
4271
|
if (opts.output !== void 0) {
|
|
3846
|
-
|
|
4272
|
+
writeFileSync7(opts.output, JSON.stringify(result, null, 2), "utf-8");
|
|
3847
4273
|
process.stderr.write(`Diff written to ${opts.output}
|
|
3848
4274
|
`);
|
|
3849
4275
|
}
|
|
@@ -4144,35 +4570,35 @@ function buildStructuredReport(report) {
|
|
|
4144
4570
|
}
|
|
4145
4571
|
|
|
4146
4572
|
// src/tokens/commands.ts
|
|
4147
|
-
import { existsSync as
|
|
4148
|
-
import { resolve as
|
|
4573
|
+
import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
|
|
4574
|
+
import { resolve as resolve14 } from "path";
|
|
4149
4575
|
import {
|
|
4150
4576
|
parseTokenFileSync as parseTokenFileSync2,
|
|
4151
4577
|
TokenParseError,
|
|
4152
|
-
TokenResolver as
|
|
4578
|
+
TokenResolver as TokenResolver8,
|
|
4153
4579
|
TokenValidationError,
|
|
4154
4580
|
validateTokenFile
|
|
4155
4581
|
} from "@agent-scope/tokens";
|
|
4156
|
-
import { Command as
|
|
4582
|
+
import { Command as Command8 } from "commander";
|
|
4157
4583
|
|
|
4158
4584
|
// src/tokens/compliance.ts
|
|
4159
|
-
import { existsSync as
|
|
4160
|
-
import { resolve as
|
|
4585
|
+
import { existsSync as existsSync8, readFileSync as readFileSync7 } from "fs";
|
|
4586
|
+
import { resolve as resolve11 } from "path";
|
|
4161
4587
|
import {
|
|
4162
|
-
ComplianceEngine as
|
|
4163
|
-
TokenResolver as
|
|
4588
|
+
ComplianceEngine as ComplianceEngine4,
|
|
4589
|
+
TokenResolver as TokenResolver4
|
|
4164
4590
|
} from "@agent-scope/tokens";
|
|
4165
4591
|
var DEFAULT_STYLES_PATH = ".reactscope/compliance-styles.json";
|
|
4166
4592
|
function loadStylesFile(stylesPath) {
|
|
4167
|
-
const absPath =
|
|
4168
|
-
if (!
|
|
4593
|
+
const absPath = resolve11(process.cwd(), stylesPath);
|
|
4594
|
+
if (!existsSync8(absPath)) {
|
|
4169
4595
|
throw new Error(
|
|
4170
4596
|
`Compliance styles file not found at ${absPath}.
|
|
4171
4597
|
Run \`scope render all\` first to generate component styles, or use --styles to specify a path.
|
|
4172
4598
|
Expected format: { "ComponentName": { colors: {}, spacing: {}, typography: {}, borders: {}, shadows: {} } }`
|
|
4173
4599
|
);
|
|
4174
4600
|
}
|
|
4175
|
-
const raw =
|
|
4601
|
+
const raw = readFileSync7(absPath, "utf-8");
|
|
4176
4602
|
let parsed;
|
|
4177
4603
|
try {
|
|
4178
4604
|
parsed = JSON.parse(raw);
|
|
@@ -4298,8 +4724,8 @@ function registerCompliance(tokensCmd) {
|
|
|
4298
4724
|
try {
|
|
4299
4725
|
const tokenFilePath = resolveTokenFilePath(opts.file);
|
|
4300
4726
|
const { tokens } = loadTokens(tokenFilePath);
|
|
4301
|
-
const resolver = new
|
|
4302
|
-
const engine = new
|
|
4727
|
+
const resolver = new TokenResolver4(tokens);
|
|
4728
|
+
const engine = new ComplianceEngine4(resolver);
|
|
4303
4729
|
const stylesPath = opts.styles ?? DEFAULT_STYLES_PATH;
|
|
4304
4730
|
const stylesFile = loadStylesFile(stylesPath);
|
|
4305
4731
|
const componentMap = /* @__PURE__ */ new Map();
|
|
@@ -4332,38 +4758,38 @@ function registerCompliance(tokensCmd) {
|
|
|
4332
4758
|
}
|
|
4333
4759
|
|
|
4334
4760
|
// src/tokens/export.ts
|
|
4335
|
-
import { existsSync as
|
|
4336
|
-
import { resolve as
|
|
4761
|
+
import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync8 } from "fs";
|
|
4762
|
+
import { resolve as resolve12 } from "path";
|
|
4337
4763
|
import {
|
|
4338
4764
|
exportTokens,
|
|
4339
4765
|
parseTokenFileSync,
|
|
4340
4766
|
ThemeResolver,
|
|
4341
|
-
TokenResolver as
|
|
4767
|
+
TokenResolver as TokenResolver5
|
|
4342
4768
|
} from "@agent-scope/tokens";
|
|
4343
|
-
import { Command as
|
|
4769
|
+
import { Command as Command7 } from "commander";
|
|
4344
4770
|
var DEFAULT_TOKEN_FILE = "reactscope.tokens.json";
|
|
4345
4771
|
var CONFIG_FILE = "reactscope.config.json";
|
|
4346
4772
|
var SUPPORTED_FORMATS = ["css", "ts", "scss", "tailwind", "flat-json", "figma"];
|
|
4347
4773
|
function resolveTokenFilePath2(fileFlag) {
|
|
4348
4774
|
if (fileFlag !== void 0) {
|
|
4349
|
-
return
|
|
4775
|
+
return resolve12(process.cwd(), fileFlag);
|
|
4350
4776
|
}
|
|
4351
|
-
const configPath =
|
|
4352
|
-
if (
|
|
4777
|
+
const configPath = resolve12(process.cwd(), CONFIG_FILE);
|
|
4778
|
+
if (existsSync9(configPath)) {
|
|
4353
4779
|
try {
|
|
4354
|
-
const raw =
|
|
4780
|
+
const raw = readFileSync8(configPath, "utf-8");
|
|
4355
4781
|
const config = JSON.parse(raw);
|
|
4356
4782
|
if (typeof config === "object" && config !== null && "tokens" in config && typeof config.tokens === "object" && config.tokens !== null && typeof config.tokens?.file === "string") {
|
|
4357
4783
|
const file = config.tokens.file;
|
|
4358
|
-
return
|
|
4784
|
+
return resolve12(process.cwd(), file);
|
|
4359
4785
|
}
|
|
4360
4786
|
} catch {
|
|
4361
4787
|
}
|
|
4362
4788
|
}
|
|
4363
|
-
return
|
|
4789
|
+
return resolve12(process.cwd(), DEFAULT_TOKEN_FILE);
|
|
4364
4790
|
}
|
|
4365
4791
|
function createTokensExportCommand() {
|
|
4366
|
-
return new
|
|
4792
|
+
return new Command7("export").description("Export design tokens to a downstream format").requiredOption("--format <fmt>", `Output format: ${SUPPORTED_FORMATS.join(", ")}`).option("--file <path>", "Path to token file (overrides config)").option("--out <path>", "Write output to file instead of stdout").option("--prefix <prefix>", "CSS/SCSS: prefix for variable names (e.g. 'scope')").option("--selector <selector>", "CSS: custom root selector (default: ':root')").option(
|
|
4367
4793
|
"--theme <name>",
|
|
4368
4794
|
"Include theme overrides for the named theme (applies to css, ts, scss, tailwind, figma)"
|
|
4369
4795
|
).action(
|
|
@@ -4379,13 +4805,13 @@ Supported formats: ${SUPPORTED_FORMATS.join(", ")}
|
|
|
4379
4805
|
const format = opts.format;
|
|
4380
4806
|
try {
|
|
4381
4807
|
const filePath = resolveTokenFilePath2(opts.file);
|
|
4382
|
-
if (!
|
|
4808
|
+
if (!existsSync9(filePath)) {
|
|
4383
4809
|
throw new Error(
|
|
4384
4810
|
`Token file not found at ${filePath}.
|
|
4385
4811
|
Create a reactscope.tokens.json file or use --file to specify a path.`
|
|
4386
4812
|
);
|
|
4387
4813
|
}
|
|
4388
|
-
const raw =
|
|
4814
|
+
const raw = readFileSync8(filePath, "utf-8");
|
|
4389
4815
|
const { tokens, rawFile } = parseTokenFileSync(raw);
|
|
4390
4816
|
let themesMap;
|
|
4391
4817
|
if (opts.theme !== void 0) {
|
|
@@ -4396,7 +4822,7 @@ Create a reactscope.tokens.json file or use --file to specify a path.`
|
|
|
4396
4822
|
Available themes: ${available}`
|
|
4397
4823
|
);
|
|
4398
4824
|
}
|
|
4399
|
-
const baseResolver = new
|
|
4825
|
+
const baseResolver = new TokenResolver5(tokens);
|
|
4400
4826
|
const themeResolver = ThemeResolver.fromTokenFile(
|
|
4401
4827
|
baseResolver,
|
|
4402
4828
|
rawFile
|
|
@@ -4424,8 +4850,8 @@ Available themes: ${themeNames.join(", ")}`
|
|
|
4424
4850
|
themes: themesMap
|
|
4425
4851
|
});
|
|
4426
4852
|
if (opts.out !== void 0) {
|
|
4427
|
-
const outPath =
|
|
4428
|
-
|
|
4853
|
+
const outPath = resolve12(process.cwd(), opts.out);
|
|
4854
|
+
writeFileSync8(outPath, output, "utf-8");
|
|
4429
4855
|
process.stderr.write(`Exported ${tokens.length} tokens to ${outPath}
|
|
4430
4856
|
`);
|
|
4431
4857
|
} else {
|
|
@@ -4445,9 +4871,9 @@ Available themes: ${themeNames.join(", ")}`
|
|
|
4445
4871
|
|
|
4446
4872
|
// src/tokens/impact.ts
|
|
4447
4873
|
import {
|
|
4448
|
-
ComplianceEngine as
|
|
4874
|
+
ComplianceEngine as ComplianceEngine5,
|
|
4449
4875
|
ImpactAnalyzer,
|
|
4450
|
-
TokenResolver as
|
|
4876
|
+
TokenResolver as TokenResolver6
|
|
4451
4877
|
} from "@agent-scope/tokens";
|
|
4452
4878
|
var DEFAULT_STYLES_PATH2 = ".reactscope/compliance-styles.json";
|
|
4453
4879
|
var SEVERITY_EMOJI = {
|
|
@@ -4505,8 +4931,8 @@ function registerImpact(tokensCmd) {
|
|
|
4505
4931
|
try {
|
|
4506
4932
|
const tokenFilePath = resolveTokenFilePath(opts.file);
|
|
4507
4933
|
const { tokens } = loadTokens(tokenFilePath);
|
|
4508
|
-
const resolver = new
|
|
4509
|
-
const engine = new
|
|
4934
|
+
const resolver = new TokenResolver6(tokens);
|
|
4935
|
+
const engine = new ComplianceEngine5(resolver);
|
|
4510
4936
|
const stylesPath = opts.styles ?? DEFAULT_STYLES_PATH2;
|
|
4511
4937
|
const stylesFile = loadStylesFile(stylesPath);
|
|
4512
4938
|
const componentMap = new Map(Object.entries(stylesFile));
|
|
@@ -4539,10 +4965,10 @@ ${formatImpactSummary(report)}
|
|
|
4539
4965
|
}
|
|
4540
4966
|
|
|
4541
4967
|
// src/tokens/preview.ts
|
|
4542
|
-
import { mkdirSync as mkdirSync5, writeFileSync as
|
|
4543
|
-
import { resolve as
|
|
4544
|
-
import { BrowserPool as
|
|
4545
|
-
import { ComplianceEngine as
|
|
4968
|
+
import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync9 } from "fs";
|
|
4969
|
+
import { resolve as resolve13 } from "path";
|
|
4970
|
+
import { BrowserPool as BrowserPool7, SpriteSheetGenerator } from "@agent-scope/render";
|
|
4971
|
+
import { ComplianceEngine as ComplianceEngine6, ImpactAnalyzer as ImpactAnalyzer2, TokenResolver as TokenResolver7 } from "@agent-scope/tokens";
|
|
4546
4972
|
var DEFAULT_STYLES_PATH3 = ".reactscope/compliance-styles.json";
|
|
4547
4973
|
var DEFAULT_MANIFEST_PATH = ".reactscope/manifest.json";
|
|
4548
4974
|
var DEFAULT_OUTPUT_DIR2 = ".reactscope/previews";
|
|
@@ -4556,7 +4982,7 @@ async function renderComponentWithCssOverride(filePath, componentName, cssOverri
|
|
|
4556
4982
|
cssOverride
|
|
4557
4983
|
// injected as <style>
|
|
4558
4984
|
);
|
|
4559
|
-
const pool = new
|
|
4985
|
+
const pool = new BrowserPool7({
|
|
4560
4986
|
size: { browsers: 1, pagesPerBrowser: 1 },
|
|
4561
4987
|
viewportWidth: vpWidth,
|
|
4562
4988
|
viewportHeight: vpHeight
|
|
@@ -4600,8 +5026,8 @@ function registerPreview(tokensCmd) {
|
|
|
4600
5026
|
try {
|
|
4601
5027
|
const tokenFilePath = resolveTokenFilePath(opts.file);
|
|
4602
5028
|
const { tokens } = loadTokens(tokenFilePath);
|
|
4603
|
-
const resolver = new
|
|
4604
|
-
const engine = new
|
|
5029
|
+
const resolver = new TokenResolver7(tokens);
|
|
5030
|
+
const engine = new ComplianceEngine6(resolver);
|
|
4605
5031
|
const stylesPath = opts.styles ?? DEFAULT_STYLES_PATH3;
|
|
4606
5032
|
const stylesFile = loadStylesFile(stylesPath);
|
|
4607
5033
|
const componentMap = new Map(Object.entries(stylesFile));
|
|
@@ -4721,10 +5147,10 @@ function registerPreview(tokensCmd) {
|
|
|
4721
5147
|
});
|
|
4722
5148
|
const spriteResult = await generator.generate(matrixResult);
|
|
4723
5149
|
const tokenLabel = tokenPath.replace(/\./g, "-");
|
|
4724
|
-
const outputPath = opts.output ??
|
|
4725
|
-
const outputDir =
|
|
5150
|
+
const outputPath = opts.output ?? resolve13(process.cwd(), DEFAULT_OUTPUT_DIR2, `preview-${tokenLabel}.png`);
|
|
5151
|
+
const outputDir = resolve13(outputPath, "..");
|
|
4726
5152
|
mkdirSync5(outputDir, { recursive: true });
|
|
4727
|
-
|
|
5153
|
+
writeFileSync9(outputPath, spriteResult.png);
|
|
4728
5154
|
const useJson = opts.format === "json" || opts.format !== "text" && !isTTY();
|
|
4729
5155
|
if (useJson) {
|
|
4730
5156
|
process.stdout.write(
|
|
@@ -4783,30 +5209,30 @@ function buildTable2(headers, rows) {
|
|
|
4783
5209
|
}
|
|
4784
5210
|
function resolveTokenFilePath(fileFlag) {
|
|
4785
5211
|
if (fileFlag !== void 0) {
|
|
4786
|
-
return
|
|
5212
|
+
return resolve14(process.cwd(), fileFlag);
|
|
4787
5213
|
}
|
|
4788
|
-
const configPath =
|
|
4789
|
-
if (
|
|
5214
|
+
const configPath = resolve14(process.cwd(), CONFIG_FILE2);
|
|
5215
|
+
if (existsSync10(configPath)) {
|
|
4790
5216
|
try {
|
|
4791
|
-
const raw =
|
|
5217
|
+
const raw = readFileSync9(configPath, "utf-8");
|
|
4792
5218
|
const config = JSON.parse(raw);
|
|
4793
5219
|
if (typeof config === "object" && config !== null && "tokens" in config && typeof config.tokens === "object" && config.tokens !== null && typeof config.tokens?.file === "string") {
|
|
4794
5220
|
const file = config.tokens.file;
|
|
4795
|
-
return
|
|
5221
|
+
return resolve14(process.cwd(), file);
|
|
4796
5222
|
}
|
|
4797
5223
|
} catch {
|
|
4798
5224
|
}
|
|
4799
5225
|
}
|
|
4800
|
-
return
|
|
5226
|
+
return resolve14(process.cwd(), DEFAULT_TOKEN_FILE2);
|
|
4801
5227
|
}
|
|
4802
5228
|
function loadTokens(absPath) {
|
|
4803
|
-
if (!
|
|
5229
|
+
if (!existsSync10(absPath)) {
|
|
4804
5230
|
throw new Error(
|
|
4805
5231
|
`Token file not found at ${absPath}.
|
|
4806
5232
|
Create a reactscope.tokens.json file or use --file to specify a path.`
|
|
4807
5233
|
);
|
|
4808
5234
|
}
|
|
4809
|
-
const raw =
|
|
5235
|
+
const raw = readFileSync9(absPath, "utf-8");
|
|
4810
5236
|
return parseTokenFileSync2(raw);
|
|
4811
5237
|
}
|
|
4812
5238
|
function getRawValue(node, segments) {
|
|
@@ -4846,7 +5272,7 @@ function registerGet2(tokensCmd) {
|
|
|
4846
5272
|
try {
|
|
4847
5273
|
const filePath = resolveTokenFilePath(opts.file);
|
|
4848
5274
|
const { tokens } = loadTokens(filePath);
|
|
4849
|
-
const resolver = new
|
|
5275
|
+
const resolver = new TokenResolver8(tokens);
|
|
4850
5276
|
const resolvedValue = resolver.resolve(tokenPath);
|
|
4851
5277
|
const useJson = opts.format === "json" || opts.format !== "text" && !isTTY2();
|
|
4852
5278
|
if (useJson) {
|
|
@@ -4872,7 +5298,7 @@ function registerList2(tokensCmd) {
|
|
|
4872
5298
|
try {
|
|
4873
5299
|
const filePath = resolveTokenFilePath(opts.file);
|
|
4874
5300
|
const { tokens } = loadTokens(filePath);
|
|
4875
|
-
const resolver = new
|
|
5301
|
+
const resolver = new TokenResolver8(tokens);
|
|
4876
5302
|
const filtered = resolver.list(opts.type, category);
|
|
4877
5303
|
const useJson = opts.format === "json" || opts.format !== "table" && !isTTY2();
|
|
4878
5304
|
if (useJson) {
|
|
@@ -4902,7 +5328,7 @@ function registerSearch(tokensCmd) {
|
|
|
4902
5328
|
try {
|
|
4903
5329
|
const filePath = resolveTokenFilePath(opts.file);
|
|
4904
5330
|
const { tokens } = loadTokens(filePath);
|
|
4905
|
-
const resolver = new
|
|
5331
|
+
const resolver = new TokenResolver8(tokens);
|
|
4906
5332
|
const useJson = opts.format === "json" || opts.format !== "table" && !isTTY2();
|
|
4907
5333
|
const typesToSearch = opts.type ? [opts.type] : [
|
|
4908
5334
|
"color",
|
|
@@ -4985,7 +5411,7 @@ function registerResolve(tokensCmd) {
|
|
|
4985
5411
|
const filePath = resolveTokenFilePath(opts.file);
|
|
4986
5412
|
const absFilePath = filePath;
|
|
4987
5413
|
const { tokens, rawFile } = loadTokens(absFilePath);
|
|
4988
|
-
const resolver = new
|
|
5414
|
+
const resolver = new TokenResolver8(tokens);
|
|
4989
5415
|
resolver.resolve(tokenPath);
|
|
4990
5416
|
const chain = buildResolutionChain(tokenPath, rawFile.tokens);
|
|
4991
5417
|
const useJson = opts.format === "json" || opts.format !== "text" && !isTTY2();
|
|
@@ -5020,13 +5446,13 @@ function registerValidate(tokensCmd) {
|
|
|
5020
5446
|
).option("--file <path>", "Path to token file (overrides config)").option("--format <fmt>", "Output format: json or text (default: auto-detect)").action((opts) => {
|
|
5021
5447
|
try {
|
|
5022
5448
|
const filePath = resolveTokenFilePath(opts.file);
|
|
5023
|
-
if (!
|
|
5449
|
+
if (!existsSync10(filePath)) {
|
|
5024
5450
|
throw new Error(
|
|
5025
5451
|
`Token file not found at ${filePath}.
|
|
5026
5452
|
Create a reactscope.tokens.json file or use --file to specify a path.`
|
|
5027
5453
|
);
|
|
5028
5454
|
}
|
|
5029
|
-
const raw =
|
|
5455
|
+
const raw = readFileSync9(filePath, "utf-8");
|
|
5030
5456
|
const useJson = opts.format === "json" || opts.format !== "text" && !isTTY2();
|
|
5031
5457
|
const errors = [];
|
|
5032
5458
|
let parsed;
|
|
@@ -5094,7 +5520,7 @@ function outputValidationResult(filePath, errors, useJson) {
|
|
|
5094
5520
|
}
|
|
5095
5521
|
}
|
|
5096
5522
|
function createTokensCommand() {
|
|
5097
|
-
const tokensCmd = new
|
|
5523
|
+
const tokensCmd = new Command8("tokens").description(
|
|
5098
5524
|
"Query and validate design tokens from a reactscope.tokens.json file"
|
|
5099
5525
|
);
|
|
5100
5526
|
registerGet2(tokensCmd);
|
|
@@ -5111,7 +5537,7 @@ function createTokensCommand() {
|
|
|
5111
5537
|
|
|
5112
5538
|
// src/program.ts
|
|
5113
5539
|
function createProgram(options = {}) {
|
|
5114
|
-
const program2 = new
|
|
5540
|
+
const program2 = new Command9("scope").version(options.version ?? "0.1.0").description("Scope \u2014 React instrumentation toolkit");
|
|
5115
5541
|
program2.command("capture <url>").description("Capture a React component tree from a live URL and output as JSON").option("-o, --output <path>", "Write JSON to file instead of stdout").option("--pretty", "Pretty-print JSON output (default: minified)", false).option("--timeout <ms>", "Max wait time for React to mount (ms)", "10000").option("--wait <ms>", "Additional wait after page load before capture (ms)", "0").action(
|
|
5116
5542
|
async (url, opts) => {
|
|
5117
5543
|
try {
|
|
@@ -5184,7 +5610,7 @@ function createProgram(options = {}) {
|
|
|
5184
5610
|
}
|
|
5185
5611
|
);
|
|
5186
5612
|
program2.command("generate").description("Generate a Playwright test from a Scope trace file").argument("<trace>", "Path to a serialized Scope trace (.json)").option("-o, --output <path>", "Output file path", "scope.spec.ts").option("-d, --description <text>", "Test description").action((tracePath, opts) => {
|
|
5187
|
-
const raw =
|
|
5613
|
+
const raw = readFileSync10(tracePath, "utf-8");
|
|
5188
5614
|
const trace = loadTrace(raw);
|
|
5189
5615
|
const source = generateTest(trace, {
|
|
5190
5616
|
description: opts.description,
|
|
@@ -5198,6 +5624,7 @@ function createProgram(options = {}) {
|
|
|
5198
5624
|
program2.addCommand(createTokensCommand());
|
|
5199
5625
|
program2.addCommand(createInstrumentCommand());
|
|
5200
5626
|
program2.addCommand(createInitCommand());
|
|
5627
|
+
program2.addCommand(createCiCommand());
|
|
5201
5628
|
const existingReportCmd = program2.commands.find((c) => c.name() === "report");
|
|
5202
5629
|
if (existingReportCmd !== void 0) {
|
|
5203
5630
|
registerBaselineSubCommand(existingReportCmd);
|