@motion-proto/live-tokens 0.97.0 → 0.99.0

package/dist-plugin/index.js

@@ -13,7 +13,7 @@ import {
   parseGradientValue,
   reconcilePalettesFromCssVars,
   sanitizeFileName
-} from "./chunk-A4TBP4MM.js";
+} from "./chunk-SLICH4IH.js";
 import {
   CURRENT_COMPONENT_SCHEMA_VERSION
 } from "./chunk-QQASYPW7.js";
@@ -36,9 +36,9 @@ import {
 } from "./chunk-6WGFOJXO.js";
 
 // vite-plugin/themeFileApi.ts
-import fs2 from "fs";
+import fs3 from "fs";
 import { createHash as createHash2 } from "crypto";
-import path3 from "path";
+import path4 from "path";
 
 // src/editor/core/themes/migrations/2026-07-21-palette-oklch-basis.ts
 var round = (v, dp) => {
@@ -748,18 +748,158 @@ function formatReport({ propertiesBefore, propertiesAfter, bytesSaved }) {
   return `live-tokens: the production CSS declares ${propertiesAfter.toLocaleString("en-US")} of ${propertiesBefore.toLocaleString("en-US")} custom properties and is ${kB} kB ${bytesSaved >= 0 ? "smaller" : "larger"}.`;
 }
 
+// vite-plugin/a11y/a11yRunServer.ts
+import { spawn } from "child_process";
+import fs2 from "fs";
+import path3 from "path";
+var A11Y_RUN_ARGS = ["check-component", "--tests", "--a11y", "--no-fix", "--json", "--open-theme"];
+var A11Y_REPORTS_DIR_NAME = "_a11y-reports";
+var STDERR_TAIL = 2e3;
+var CONTRAST_ROLES = /* @__PURE__ */ new Set(["text", "non-text"]);
+function spawnCli(cliPath) {
+  return (args, cwd) => {
+    const child = spawn(process.execPath, [cliPath, ...args], { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    const done = new Promise((resolve) => {
+      let stdout = "";
+      let stderr = "";
+      child.stdout.on("data", (chunk) => stdout += chunk);
+      child.stderr.on("data", (chunk) => stderr += chunk);
+      child.on("error", (error) => resolve({ code: null, stdout, stderr: `${stderr}${error.message}` }));
+      child.on("close", (code) => resolve({ code, stdout, stderr }));
+    });
+    return { done, stop: () => child.kill("SIGINT") };
+  };
+}
+function isContrastFailure(value) {
+  const v = value;
+  return !!v && typeof v === "object" && typeof v.component === "string" && typeof v.variable === "string" && v.variable.startsWith("--") && Array.isArray(v.backdrop) && v.backdrop.every((layer) => typeof layer === "string") && typeof v.role === "string" && CONTRAST_ROLES.has(v.role) && typeof v.ratio === "number" && typeof v.floor === "number" && (v.context === void 0 || typeof v.context === "string");
+}
+function readContrast(body) {
+  const contrast = body?.contrast;
+  return Array.isArray(contrast) && contrast.every(isContrastFailure) ? contrast : null;
+}
+function parseCliReport(stdout) {
+  try {
+    const parsed = JSON.parse(stdout);
+    return parsed && Array.isArray(parsed.findings) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function a11yRunServer({ root, reportsDir, openTheme, runCli, broadcast }) {
+  let running = null;
+  const reportFile = (theme) => path3.join(reportsDir, `${theme}.json`);
+  function readReport(theme) {
+    const listed = fs2.existsSync(reportsDir) && fs2.readdirSync(reportsDir).includes(`${theme}.json`);
+    return listed ? JSON.parse(fs2.readFileSync(reportFile(theme), "utf-8")) : null;
+  }
+  function writeReport(report) {
+    fs2.mkdirSync(reportsDir, { recursive: true });
+    fs2.writeFileSync(reportFile(report.theme), `${JSON.stringify(report, null, 2)}
+`);
+  }
+  function withConfirmed(report, confirmed) {
+    const review = new Set(report.findings.filter((f) => f.rule === "a11y-review").map((f) => f.message));
+    const kept = [...new Set(confirmed)].filter((message) => review.has(message)).sort();
+    const out = { ...report, confirmed: kept };
+    if (kept.length === 0) delete out.confirmed;
+    return out;
+  }
+  function reports() {
+    if (!fs2.existsSync(reportsDir)) return {};
+    return Object.fromEntries(
+      fs2.readdirSync(reportsDir).filter((name) => name.endsWith(".json")).map((name) => [name.slice(0, -".json".length), JSON.parse(fs2.readFileSync(path3.join(reportsDir, name), "utf-8"))])
+    );
+  }
+  function settle(started, outcome) {
+    const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const cli = parseCliReport(outcome.stdout);
+    if (!cli) {
+      const stderr = outcome.stderr.trim().slice(-STDERR_TAIL);
+      return {
+        ...started,
+        state: "failed",
+        finishedAt,
+        error: `check-component exited with code ${outcome.code} and printed no report.${stderr ? `
+${stderr}` : ""}`
+      };
+    }
+    return {
+      ...started,
+      state: "finished",
+      finishedAt,
+      findings: cli.findings.filter((f) => f.details?.engineRule !== "color-contrast")
+    };
+  }
+  function start(body) {
+    if (running) {
+      return { status: 409, body: { error: "An accessibility run is already going.", code: "A11Y_RUN_IN_PROGRESS" } };
+    }
+    const contrast = readContrast(body);
+    if (!contrast) {
+      return {
+        status: 400,
+        body: { error: "Body must be { contrast: [...] } with one entry per failing pair", code: "INVALID_BODY" }
+      };
+    }
+    const report = { state: "running", startedAt: (/* @__PURE__ */ new Date()).toISOString(), theme: openTheme(), contrast };
+    const run = runCli(A11Y_RUN_ARGS, root);
+    running = { report, stop: run.stop };
+    broadcast(report);
+    void run.done.then((outcome) => {
+      const settled = settle(report, outcome);
+      const final = settled.state === "finished" ? withConfirmed(settled, readReport(settled.theme)?.confirmed ?? []) : settled;
+      if (final.state === "finished") writeReport(final);
+      running = null;
+      broadcast(final);
+    });
+    return { status: 202, body: report };
+  }
+  function confirm(body) {
+    const { theme, messages, confirmed } = body ?? {};
+    if (typeof theme !== "string" || typeof confirmed !== "boolean" || !Array.isArray(messages) || !messages.every((m) => typeof m === "string")) {
+      return {
+        status: 400,
+        body: { error: "Body must be { theme, messages: [...], confirmed: true | false }", code: "INVALID_BODY" }
+      };
+    }
+    const report = readReport(theme);
+    if (!report) return { status: 404, body: { error: `No report for theme "${theme}"`, code: "NO_REPORT" } };
+    const marked = new Set(report.confirmed ?? []);
+    for (const message of messages) {
+      if (confirmed) marked.add(message);
+      else marked.delete(message);
+    }
+    const updated = withConfirmed(report, marked);
+    writeReport(updated);
+    broadcast(updated);
+    return { status: 200, body: updated };
+  }
+  return {
+    start,
+    confirm,
+    report: () => ({ status: 200, body: { running: running?.report ?? null, reports: reports() } }),
+    /** Removes a deleted theme's report. */
+    forget: (theme) => fs2.rmSync(reportFile(theme), { force: true }),
+    stop: () => running?.stop()
+  };
+}
+
+// src/editor/core/a11y/a11yReportTypes.ts
+var A11Y_EVENT = "a11y";
+
 // vite-plugin/themeFileApi.ts
 import { fileURLToPath as fileURLToPath2 } from "url";
 var PKG_VERSION = (() => {
   try {
-    let dir = path3.dirname(fileURLToPath2(import.meta.url));
+    let dir = path4.dirname(fileURLToPath2(import.meta.url));
     for (let i = 0; i < 4; i++) {
-      const p = path3.join(dir, "package.json");
-      if (fs2.existsSync(p)) {
-        const json = JSON.parse(fs2.readFileSync(p, "utf-8"));
+      const p = path4.join(dir, "package.json");
+      if (fs3.existsSync(p)) {
+        const json = JSON.parse(fs3.readFileSync(p, "utf-8"));
         if (json?.name === "@motion-proto/live-tokens") return json.version ?? "";
       }
-      const up = path3.dirname(dir);
+      const up = path4.dirname(dir);
       if (up === dir) break;
       dir = up;
     }
@@ -803,46 +943,48 @@ function themeFileApi(opts) {
   const COMPONENT_CONFIGS_DIR = dataDirs.componentConfigsDir;
   const THEMES_DIR = dataDirs.themesDir;
   const SKETCH_STYLES_DIR = dataDirs.sketchStylesDir;
-  const CSS_PATH = path3.resolve(opts.tokensCssPath);
+  const CSS_PATH = path4.resolve(opts.tokensCssPath);
   const ISOLATED_DATA_DIR = testDataDir();
-  const GENERATED_CSS_PATH = ISOLATED_DATA_DIR ? path3.join(ISOLATED_DATA_DIR, "tokens.generated.css") : opts.tokensGeneratedCssPath ? path3.resolve(opts.tokensGeneratedCssPath) : path3.join(dataDirs.dataDir, "tokens.generated.css");
-  const FONTS_CSS_PATH = ISOLATED_DATA_DIR ? path3.join(ISOLATED_DATA_DIR, "fonts.css") : opts.fontsCssPath ? path3.resolve(opts.fontsCssPath) : path3.join(path3.dirname(CSS_PATH), "fonts.css");
+  const GENERATED_CSS_PATH = ISOLATED_DATA_DIR ? path4.join(ISOLATED_DATA_DIR, "tokens.generated.css") : opts.tokensGeneratedCssPath ? path4.resolve(opts.tokensGeneratedCssPath) : path4.join(dataDirs.dataDir, "tokens.generated.css");
+  const FONTS_CSS_PATH = ISOLATED_DATA_DIR ? path4.join(ISOLATED_DATA_DIR, "fonts.css") : opts.fontsCssPath ? path4.resolve(opts.fontsCssPath) : path4.join(path4.dirname(CSS_PATH), "fonts.css");
+  const A11Y_REPORTS_DIR = path4.join(dataDirs.dataDir, A11Y_REPORTS_DIR_NAME);
   const API_BASE = opts.apiBase ?? "/api/live-tokens";
-  const consumerComponentDirs = opts.componentsSrcDir ? [path3.resolve(opts.componentsSrcDir)] : [path3.resolve("src/components"), path3.resolve("src/system/components")];
-  const packageComponentsDir = path3.resolve(
-    path3.dirname(fileURLToPath2(import.meta.url)),
+  const consumerComponentDirs = opts.componentsSrcDir ? [path4.resolve(opts.componentsSrcDir)] : [path4.resolve("src/components"), path4.resolve("src/system/components")];
+  const packageComponentsDir = path4.resolve(
+    path4.dirname(fileURLToPath2(import.meta.url)),
     "..",
     "src",
     "system",
     "components"
   );
-  const packageDataDir = testPackageDataDir() ?? path3.resolve(
-    path3.dirname(fileURLToPath2(import.meta.url)),
+  const PACKAGE_CLI_PATH = path4.resolve(path4.dirname(fileURLToPath2(import.meta.url)), "..", "bin", "cli.mjs");
+  const packageDataDir = testPackageDataDir() ?? path4.resolve(
+    path4.dirname(fileURLToPath2(import.meta.url)),
     "..",
     "src",
     "live-tokens",
     "data"
   );
-  const packageColorsAndTypeDir = path3.join(packageDataDir, "colors-and-type");
-  const packageThemesDir = path3.join(packageDataDir, "themes");
-  const packageComponentConfigsDir = path3.join(packageDataDir, "component-configs");
-  const packageSketchStylesDir = path3.join(packageDataDir, "sketch-styles");
+  const packageColorsAndTypeDir = path4.join(packageDataDir, "colors-and-type");
+  const packageThemesDir = path4.join(packageDataDir, "themes");
+  const packageComponentConfigsDir = path4.join(packageDataDir, "component-configs");
+  const packageSketchStylesDir = path4.join(packageDataDir, "sketch-styles");
   function shippedNames(dataDir, subdir) {
     try {
-      const pkgRoot = path3.resolve(dataDir, "..", "..", "..");
-      const pkg = JSON.parse(fs2.readFileSync(path3.join(pkgRoot, "package.json"), "utf-8"));
+      const pkgRoot = path4.resolve(dataDir, "..", "..", "..");
+      const pkg = JSON.parse(fs3.readFileSync(path4.join(pkgRoot, "package.json"), "utf-8"));
       const files = Array.isArray(pkg.files) ? pkg.files : [];
       const owned = new RegExp(`^src/live-tokens/data/${subdir}/[^/]+\\.json$`);
-      return files.filter((f) => owned.test(f)).map((f) => path3.basename(f, ".json"));
+      return files.filter((f) => owned.test(f)).map((f) => path4.basename(f, ".json"));
     } catch {
       return [];
     }
   }
   const COMPONENTS_SCAN_DIRS = [...consumerComponentDirs];
-  if (!COMPONENTS_SCAN_DIRS.includes(packageComponentsDir) && fs2.existsSync(packageComponentsDir)) {
+  if (!COMPONENTS_SCAN_DIRS.includes(packageComponentsDir) && fs3.existsSync(packageComponentsDir)) {
     COMPONENTS_SCAN_DIRS.push(packageComponentsDir);
   }
-  const isLiveStateFile = (file) => file === path3.join(THEMES_DIR, "_active.json") || path3.basename(file) === "_working.json" && (file.startsWith(COLORS_AND_TYPE_DIR + path3.sep) || file.startsWith(COMPONENT_CONFIGS_DIR + path3.sep));
+  const isLiveStateFile = (file) => file === path4.join(THEMES_DIR, "_active.json") || path4.basename(file) === "_working.json" && (file.startsWith(COLORS_AND_TYPE_DIR + path4.sep) || file.startsWith(COMPONENT_CONFIGS_DIR + path4.sep));
   const liveWatch = dataTreeWatch({
     dirs: [COLORS_AND_TYPE_DIR, COMPONENT_CONFIGS_DIR, THEMES_DIR],
     isLive: isLiveStateFile
@@ -858,8 +1000,8 @@ function themeFileApi(opts) {
     let r = componentResourceCache.get(comp);
     if (!r) {
       r = versionedFileResourceServer({
-        dir: path3.join(COMPONENT_CONFIGS_DIR, comp),
-        packageDir: path3.join(packageComponentConfigsDir, comp),
+        dir: path4.join(COMPONENT_CONFIGS_DIR, comp),
+        packageDir: path4.join(packageComponentConfigsDir, comp),
         onWrite: liveWatch.noteOwnWrite
       });
       componentResourceCache.set(comp, r);
@@ -947,7 +1089,7 @@ function themeFileApi(opts) {
     const productionThemeName = themesResource.getProductionName();
     const productionTheme = readTheme(productionThemeName)?.theme ?? null;
     if (themesResource.existingPath(productionThemeName) !== null && !productionTheme?.colorsAndType) {
-      const tail = `${path3.basename(GENERATED_CSS_PATH)} was left as it was.`;
+      const tail = `${path4.basename(GENERATED_CSS_PATH)} was left as it was.`;
       throw new Error(
         unreadableThemeReason(productionThemeName) === "colors-and-type" ? `[live-tokens] ${notAThemeError(productionThemeName)} ${tail}` : `[live-tokens] Production theme "${productionThemeName}" is unreadable, so ${tail} Repair the theme file or adopt another theme.`
       );
@@ -985,7 +1127,7 @@ function themeFileApi(opts) {
       }
     }
     let componentOverrideCount = 0;
-    if (fs2.existsSync(COMPONENT_CONFIGS_DIR)) {
+    if (fs3.existsSync(COMPONENT_CONFIGS_DIR)) {
       const blocks = [];
       for (const comp of listComponentNames()) {
         const prodCfg = productionTheme?.componentConfigs[comp];
@@ -1030,18 +1172,18 @@ function themeFileApi(opts) {
       `/* Bake fingerprint: ${bakeFingerprint(body)} */`,
       ""
     ];
-    if (!fs2.existsSync(path3.dirname(GENERATED_CSS_PATH))) {
-      fs2.mkdirSync(path3.dirname(GENERATED_CSS_PATH), { recursive: true });
+    if (!fs3.existsSync(path4.dirname(GENERATED_CSS_PATH))) {
+      fs3.mkdirSync(path4.dirname(GENERATED_CSS_PATH), { recursive: true });
     }
-    fs2.writeFileSync(GENERATED_CSS_PATH, [...header, body].join("\n"));
+    fs3.writeFileSync(GENERATED_CSS_PATH, [...header, body].join("\n"));
     console.log(
-      `[regenerateTokensCss] Wrote ${path3.basename(GENERATED_CSS_PATH)} (${colorsAndTypeVarCount} theme vars, ${componentOverrideCount} component overrides)`
+      `[regenerateTokensCss] Wrote ${path4.basename(GENERATED_CSS_PATH)} (${colorsAndTypeVarCount} theme vars, ${componentOverrideCount} component overrides)`
     );
   }
   function bakeIsCurrent() {
     let baked;
     try {
-      baked = fs2.readFileSync(GENERATED_CSS_PATH, "utf-8");
+      baked = fs3.readFileSync(GENERATED_CSS_PATH, "utf-8");
     } catch {
       return false;
     }
@@ -1077,18 +1219,18 @@ function themeFileApi(opts) {
       lines.push("");
     }
     const content = lines.join("\n");
-    if (!fs2.existsSync(path3.dirname(FONTS_CSS_PATH))) {
-      fs2.mkdirSync(path3.dirname(FONTS_CSS_PATH), { recursive: true });
+    if (!fs3.existsSync(path4.dirname(FONTS_CSS_PATH))) {
+      fs3.mkdirSync(path4.dirname(FONTS_CSS_PATH), { recursive: true });
     }
-    fs2.writeFileSync(FONTS_CSS_PATH, content);
-    console.log(`[syncFontsToCss] Wrote ${sources.length} source(s) into ${path3.basename(FONTS_CSS_PATH)}`);
+    fs3.writeFileSync(FONTS_CSS_PATH, content);
+    console.log(`[syncFontsToCss] Wrote ${sources.length} source(s) into ${path4.basename(FONTS_CSS_PATH)}`);
   }
   function componentNameFromFile(filePath) {
-    return path3.basename(filePath, ".svelte").toLowerCase();
+    return path4.basename(filePath, ".svelte").toLowerCase();
   }
   function isThemeAwareComponent(filePath) {
     try {
-      const source = fs2.readFileSync(filePath, "utf-8");
+      const source = fs3.readFileSync(filePath, "utf-8");
       return /:global\(:root\)\s*\{/.test(source);
     } catch {
       return false;
@@ -1097,10 +1239,10 @@ function themeFileApi(opts) {
   function listComponentSourcePaths() {
     const byName = /* @__PURE__ */ new Map();
     for (const dir of COMPONENTS_SCAN_DIRS) {
-      if (!fs2.existsSync(dir)) continue;
-      for (const f of fs2.readdirSync(dir)) {
+      if (!fs3.existsSync(dir)) continue;
+      for (const f of fs3.readdirSync(dir)) {
         if (!f.endsWith(".svelte")) continue;
-        const full = path3.join(dir, f);
+        const full = path4.join(dir, f);
         if (!isThemeAwareComponent(full)) continue;
         const name = componentNameFromFile(f);
         if (!byName.has(name)) byName.set(name, full);
@@ -1114,18 +1256,18 @@ function themeFileApi(opts) {
   function warnOnTokenDrift(log) {
     let tokensCss = "";
     try {
-      tokensCss = fs2.readFileSync(CSS_PATH, "utf-8");
+      tokensCss = fs3.readFileSync(CSS_PATH, "utf-8");
     } catch {
       return;
     }
     let generatedCss = "";
     try {
-      generatedCss = fs2.readFileSync(GENERATED_CSS_PATH, "utf-8");
+      generatedCss = fs3.readFileSync(GENERATED_CSS_PATH, "utf-8");
     } catch {
     }
     const componentSources = listComponentSourcePaths().map((p) => ({
       name: componentNameFromFile(p),
-      source: fs2.readFileSync(p, "utf-8")
+      source: fs3.readFileSync(p, "utf-8")
     }));
     const missing = validateTokensCss({ tokensCss, generatedCss, componentSources });
     if (missing.length === 0) return;
@@ -1133,7 +1275,7 @@ function themeFileApi(opts) {
       (m) => `  ${m.token}  (referenced by ${m.referencedBy.join(", ")})`
     );
     log(
-      `[live-tokens] ${missing.length} token(s) referenced by components are not defined in ${path3.relative(process.cwd(), CSS_PATH)}:
+      `[live-tokens] ${missing.length} token(s) referenced by components are not defined in ${path4.relative(process.cwd(), CSS_PATH)}:
 ${lines.join("\n")}
   These render as blank/empty editor slots. Run \`npx live-tokens migrate\` to reconcile.`
     );
@@ -1141,30 +1283,30 @@ ${lines.join("\n")}
   function autoMigrateAdditive(log) {
     let before = "";
     try {
-      before = fs2.readFileSync(CSS_PATH, "utf-8");
+      before = fs3.readFileSync(CSS_PATH, "utf-8");
     } catch {
       return;
     }
     const { css, applied, changed } = runAdditiveTokensCssMigrations(before);
     if (!changed) return;
-    fs2.writeFileSync(CSS_PATH, css);
+    fs3.writeFileSync(CSS_PATH, css);
     log(
-      `[live-tokens] autoMigrate applied ${applied.length} additive migration(s) to ${path3.relative(process.cwd(), CSS_PATH)}: ${applied.join(", ")}. Review the diff in git.`
+      `[live-tokens] autoMigrate applied ${applied.length} additive migration(s) to ${path4.relative(process.cwd(), CSS_PATH)}: ${applied.join(", ")}. Review the diff in git.`
     );
   }
   function generateDefaultConfig(comp, sourcePath) {
-    if (!fs2.existsSync(sourcePath)) return;
+    if (!fs3.existsSync(sourcePath)) return;
     const r = componentResource(comp);
     r.ensureDir();
     const defaultPath = r.filePath("default");
-    const sourceStat = fs2.statSync(sourcePath);
+    const sourceStat = fs3.statSync(sourcePath);
     let createdAt = (/* @__PURE__ */ new Date()).toISOString();
     let existingUpdatedAt;
     let existingAliases;
     let existingSchemaVersion;
-    if (fs2.existsSync(defaultPath)) {
+    if (fs3.existsSync(defaultPath)) {
       try {
-        const existing = JSON.parse(fs2.readFileSync(defaultPath, "utf-8"));
+        const existing = JSON.parse(fs3.readFileSync(defaultPath, "utf-8"));
         if (existing.createdAt) createdAt = existing.createdAt;
         if (typeof existing.updatedAt === "string") existingUpdatedAt = existing.updatedAt;
         if (existing.aliases && typeof existing.aliases === "object") {
@@ -1173,13 +1315,13 @@ ${lines.join("\n")}
         if (typeof existing.schemaVersion === "number") existingSchemaVersion = existing.schemaVersion;
       } catch {
       }
-      const defaultStat = fs2.statSync(defaultPath);
+      const defaultStat = fs3.statSync(defaultPath);
       if (defaultStat.mtimeMs >= sourceStat.mtimeMs && existingSchemaVersion === CURRENT_COMPONENT_SCHEMA_VERSION) {
         return;
       }
     }
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const source = fs2.readFileSync(sourcePath, "utf-8");
+    const source = fs3.readFileSync(sourcePath, "utf-8");
     const body = extractGlobalRootBody(source);
     const aliases = extractAliasDeclarations(body);
     const aliasesUnchanged = existingAliases !== void 0 && JSON.stringify(existingAliases) === JSON.stringify(aliases);
@@ -1194,14 +1336,14 @@ ${lines.join("\n")}
     };
     if (aliasesUnchanged && schemaStampCurrent && existingUpdatedAt) {
       const t = /* @__PURE__ */ new Date();
-      fs2.utimesSync(defaultPath, t, t);
+      fs3.utimesSync(defaultPath, t, t);
       return;
     }
-    fs2.writeFileSync(defaultPath, JSON.stringify(defaultConfig, null, 2));
+    fs3.writeFileSync(defaultPath, JSON.stringify(defaultConfig, null, 2));
   }
   function ensureComponentConfigsDir() {
-    if (!fs2.existsSync(COMPONENT_CONFIGS_DIR)) {
-      fs2.mkdirSync(COMPONENT_CONFIGS_DIR, { recursive: true });
+    if (!fs3.existsSync(COMPONENT_CONFIGS_DIR)) {
+      fs3.mkdirSync(COMPONENT_CONFIGS_DIR, { recursive: true });
     }
     for (const sourcePath of listComponentSourcePaths()) {
       const comp = componentNameFromFile(sourcePath);
@@ -1214,14 +1356,14 @@ ${lines.join("\n")}
     const legacy = [];
     const check = (dir) => {
       for (const name of ["_active.json", "_production.json"]) {
-        const p = path3.join(dir, name);
-        if (fs2.existsSync(p)) legacy.push(path3.relative(process.cwd(), p));
+        const p = path4.join(dir, name);
+        if (fs3.existsSync(p)) legacy.push(path4.relative(process.cwd(), p));
       }
     };
     check(COLORS_AND_TYPE_DIR);
-    if (fs2.existsSync(COMPONENT_CONFIGS_DIR)) {
-      for (const entry of fs2.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
-        if (entry.isDirectory()) check(path3.join(COMPONENT_CONFIGS_DIR, entry.name));
+    if (fs3.existsSync(COMPONENT_CONFIGS_DIR)) {
+      for (const entry of fs3.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
+        if (entry.isDirectory()) check(path4.join(COMPONENT_CONFIGS_DIR, entry.name));
       }
     }
     return legacy;
@@ -1229,19 +1371,19 @@ ${lines.join("\n")}
   function warnOnLegacyPointers(legacy, bakeHeld, warn) {
     if (legacy.length === 0) return;
     warn(
-      `[live-tokens] ${legacy.length} legacy pointer file(s) left from the pre-working-set data model, starting with ${legacy[0]}. They are no longer read. Run \`npx live-tokens migrate\` to heal the tree.` + (bakeHeld ? ` Until then this tree has named no production theme, so ${path3.basename(GENERATED_CSS_PATH)} is left exactly as it is rather than rebuilt from the default.` : "")
+      `[live-tokens] ${legacy.length} legacy pointer file(s) left from the pre-working-set data model, starting with ${legacy[0]}. They are no longer read. Run \`npx live-tokens migrate\` to heal the tree.` + (bakeHeld ? ` Until then this tree has named no production theme, so ${path4.basename(GENERATED_CSS_PATH)} is left exactly as it is rather than rebuilt from the default.` : "")
     );
   }
   function warnOnLegacyLayout(evidence, warn) {
     warn(
-      `[live-tokens] This project still uses the data layout from 0.47 and earlier: ${evidence}. Since 0.48 the whole-theme theme files live in \`themes/\` and the colors and type live in \`colors-and-type/\`. Nothing in the data directory was written, the editor cannot save, and ${path3.basename(GENERATED_CSS_PATH)} is left exactly as it is. Run \`npx live-tokens migrate\` to move the directories and heal the tree, then restart the dev server.`
+      `[live-tokens] This project still uses the data layout from 0.47 and earlier: ${evidence}. Since 0.48 the whole-theme theme files live in \`themes/\` and the colors and type live in \`colors-and-type/\`. Nothing in the data directory was written, the editor cannot save, and ${path4.basename(GENERATED_CSS_PATH)} is left exactly as it is. Run \`npx live-tokens migrate\` to move the directories and heal the tree, then restart the dev server.`
     );
   }
   function warnOnUnmigratedSketchStyles(warn) {
-    const legacyDir = path3.join(dataDirs.dataDir, "sketch-presets");
-    if (!fs2.existsSync(legacyDir)) return;
+    const legacyDir = path4.join(dataDirs.dataDir, "sketch-presets");
+    if (!fs3.existsSync(legacyDir)) return;
     warn(
-      `[live-tokens] Saved sketchstyles still live under the retired ${path3.basename(legacyDir)}/ directory name. Run \`npx live-tokens migrate\` to rename it to ${path3.basename(SKETCH_STYLES_DIR)}/; until then they will not show up in the Sketchstyle view.`
+      `[live-tokens] Saved sketchstyles still live under the retired ${path4.basename(legacyDir)}/ directory name. Run \`npx live-tokens migrate\` to rename it to ${path4.basename(SKETCH_STYLES_DIR)}/; until then they will not show up in the Sketchstyle view.`
     );
   }
   const diskThemeResolvers = {
@@ -1265,7 +1407,7 @@ ${lines.join("\n")}
     const resolved = themesResource.existingPath(fileName);
     if (resolved === null) return "missing";
     try {
-      if (isColorsAndTypeShaped(JSON.parse(fs2.readFileSync(resolved, "utf-8")))) {
+      if (isColorsAndTypeShaped(JSON.parse(fs3.readFileSync(resolved, "utf-8")))) {
         return "colors-and-type";
       }
     } catch {
@@ -1273,7 +1415,7 @@ ${lines.join("\n")}
     return "corrupt";
   }
   function notAThemeError(fileName) {
-    return `"${fileName}" is a colors-and-type file, not a theme. Before 0.48 those lived in themes/; move it to ${path3.basename(COLORS_AND_TYPE_DIR)}/ or delete it. To build a theme, use the theme skill "create-theme".`;
+    return `"${fileName}" is a colors-and-type file, not a theme. Before 0.48 those lived in themes/; move it to ${path4.basename(COLORS_AND_TYPE_DIR)}/ or delete it. To build a theme, use the theme skill "create-theme".`;
   }
   function respondUnreadableTheme(res, fileName, missingError) {
     switch (unreadableThemeReason(fileName)) {
@@ -1292,18 +1434,18 @@ ${lines.join("\n")}
   }
   function writeTheme(fileName, theme) {
     themesResource.ensureDir();
-    fs2.writeFileSync(themesResource.filePath(fileName), JSON.stringify(theme, null, 2));
+    fs3.writeFileSync(themesResource.filePath(fileName), JSON.stringify(theme, null, 2));
   }
   function migrateLocalThemes(warn) {
-    if (path3.resolve(THEMES_DIR) === path3.resolve(packageThemesDir)) return;
-    if (!fs2.existsSync(THEMES_DIR)) return;
-    for (const file of fs2.readdirSync(THEMES_DIR)) {
+    if (path4.resolve(THEMES_DIR) === path4.resolve(packageThemesDir)) return;
+    if (!fs3.existsSync(THEMES_DIR)) return;
+    for (const file of fs3.readdirSync(THEMES_DIR)) {
       if (!file.endsWith(".json") || file.startsWith("_")) continue;
       const fileName = file.slice(0, -".json".length);
       if (fileName === "default") continue;
       let raw;
       try {
-        raw = JSON.parse(fs2.readFileSync(path3.join(THEMES_DIR, file), "utf-8"));
+        raw = JSON.parse(fs3.readFileSync(path4.join(THEMES_DIR, file), "utf-8"));
       } catch {
         continue;
       }
@@ -1324,7 +1466,7 @@ ${lines.join("\n")}
   function ensureDefaultTheme(warn) {
     let existing = null;
     try {
-      existing = JSON.parse(fs2.readFileSync(themesResource.filePath("default"), "utf-8"));
+      existing = JSON.parse(fs3.readFileSync(themesResource.filePath("default"), "utf-8"));
     } catch {
     }
     if (isColorsAndTypeShaped(existing)) {
@@ -1361,9 +1503,9 @@ ${lines.join("\n")}
     themesResource.ensureDir();
     ensureDefaultTheme(warn);
     migrateLocalThemes(warn);
-    const productionPointerHeld = !fs2.existsSync(themesResource.productionPath) && listLegacyPointers().length > 0;
+    const productionPointerHeld = !fs3.existsSync(themesResource.productionPath) && listLegacyPointers().length > 0;
     if (productionPointerHeld) {
-      if (!fs2.existsSync(themesResource.activePath)) themesResource.setActiveName("default");
+      if (!fs3.existsSync(themesResource.activePath)) themesResource.setActiveName("default");
     } else {
       themesResource.ensureMeta();
     }
@@ -1442,8 +1584,8 @@ ${lines.join("\n")}
   }
   function clearAllWorking() {
     colorsAndTypeResource.clearWorking();
-    if (!fs2.existsSync(COMPONENT_CONFIGS_DIR)) return;
-    for (const entry of fs2.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
+    if (!fs3.existsSync(COMPONENT_CONFIGS_DIR)) return;
+    for (const entry of fs3.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
       if (entry.isDirectory()) componentResource(entry.name).clearWorking();
     }
   }
@@ -1487,6 +1629,9 @@ ${lines.join("\n")}
   const SKETCH_STYLE_BY_NAME_REGEX = new RegExp(`^${escapedBase}/sketch-styles/([a-z0-9\\-_]+)$`);
   const PRODUCTION_ROUTE = `${API_BASE}/production`;
   const EVENTS_ROUTE = `${API_BASE}/events`;
+  const A11Y_RUN_ROUTE = `${API_BASE}/a11y/run`;
+  const A11Y_REPORT_ROUTE = `${API_BASE}/a11y/report`;
+  const A11Y_CONFIRMED_ROUTE = `${API_BASE}/a11y/confirmed`;
   async function handleListColorsAndType(_ctx) {
     const files = colorsAndTypeResource.listNames().map((fileName) => {
       const data = colorsAndTypeResource.readJson(fileName);
@@ -1571,15 +1716,15 @@ ${lines.join("\n")}
       }
       const body = JSON.parse(await readBody(req));
       body.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs2.existsSync(filePath)) {
+      if (fs3.existsSync(filePath)) {
         try {
-          const existing = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+          const existing = JSON.parse(fs3.readFileSync(filePath, "utf-8"));
           if (existing.createdAt) body.createdAt = existing.createdAt;
         } catch {
         }
       }
       if (!body.createdAt) body.createdAt = body.updatedAt;
-      fs2.writeFileSync(filePath, JSON.stringify(body, null, 2));
+      fs3.writeFileSync(filePath, JSON.stringify(body, null, 2));
       jsonResponse(res, 200, { ok: true, fileName });
       return;
     }
@@ -1588,8 +1733,8 @@ ${lines.join("\n")}
         jsonResponse(res, 403, { error: "Cannot delete the default colors and type" });
         return;
       }
-      if (fs2.existsSync(filePath)) {
-        fs2.unlinkSync(filePath);
+      if (fs3.existsSync(filePath)) {
+        fs3.unlinkSync(filePath);
       } else if (colorsAndTypeResource.existingPath(fileName)) {
         jsonResponse(res, 403, {
           error: "Cannot delete colors and type shipped with the package. Saving it creates a local copy; deleting that copy restores the shipped version.",
@@ -1676,16 +1821,16 @@ ${lines.join("\n")}
       body.component = comp;
       body.name = body.name || name;
       body.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs2.existsSync(configPath)) {
+      if (fs3.existsSync(configPath)) {
         try {
-          const existing = JSON.parse(fs2.readFileSync(configPath, "utf-8"));
+          const existing = JSON.parse(fs3.readFileSync(configPath, "utf-8"));
           if (existing.createdAt) body.createdAt = existing.createdAt;
         } catch {
         }
       }
       if (!body.createdAt) body.createdAt = body.updatedAt;
       r.ensureDir();
-      fs2.writeFileSync(configPath, JSON.stringify(body, null, 2));
+      fs3.writeFileSync(configPath, JSON.stringify(body, null, 2));
       jsonResponse(res, 200, { ok: true, fileName: name });
       return;
     }
@@ -1694,7 +1839,7 @@ ${lines.join("\n")}
         jsonResponse(res, 403, { error: "Cannot delete default config" });
         return;
       }
-      if (fs2.existsSync(configPath)) fs2.unlinkSync(configPath);
+      if (fs3.existsSync(configPath)) fs3.unlinkSync(configPath);
       jsonResponse(res, 200, { ok: true });
       return;
     }
@@ -1702,7 +1847,7 @@ ${lines.join("\n")}
   async function handleListComponentConfigs({ params, res }) {
     const [comp] = params;
     const r = componentResource(comp);
-    if (!fs2.existsSync(r.dir)) {
+    if (!fs3.existsSync(r.dir)) {
       jsonResponse(res, 404, { error: "Component not found" });
       return;
     }
@@ -1790,9 +1935,9 @@ ${lines.join("\n")}
       const body = JSON.parse(await readBody(req));
       const { theme } = normalizeTheme(body, diskThemeResolvers);
       theme.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs2.existsSync(filePath)) {
+      if (fs3.existsSync(filePath)) {
         try {
-          const existing = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+          const existing = JSON.parse(fs3.readFileSync(filePath, "utf-8"));
           if (existing.createdAt) theme.createdAt = existing.createdAt;
         } catch {
         }
@@ -1814,7 +1959,7 @@ ${lines.join("\n")}
         });
         return;
       }
-      if (fs2.existsSync(filePath)) {
+      if (fs3.existsSync(filePath)) {
         const deletingActive = themesResource.getActiveName() === fileName;
         const liveColors = deletingActive ? resolveLiveColorsAndType(activeTheme()) : null;
         const liveComponents = {};
@@ -1824,7 +1969,8 @@ ${lines.join("\n")}
             if (resolved) liveComponents[comp] = resolved.data;
           }
         }
-        fs2.unlinkSync(filePath);
+        fs3.unlinkSync(filePath);
+        a11yRuns.forget(fileName);
         if (themesResource.existingPath(fileName) === null && deletingActive) {
           themesResource.setActiveName("default");
         }
@@ -1913,7 +2059,49 @@ data: ${JSON.stringify(state)}
 
 `);
     });
-    req.on("close", unsubscribe);
+    eventClients.add(res);
+    req.on("close", () => {
+      unsubscribe();
+      eventClients.delete(res);
+    });
+  }
+  const eventClients = /* @__PURE__ */ new Set();
+  const a11yRuns = a11yRunServer({
+    root: process.cwd(),
+    reportsDir: A11Y_REPORTS_DIR,
+    openTheme: () => themesResource.getActiveName(),
+    runCli: spawnCli(PACKAGE_CLI_PATH),
+    broadcast: (report) => {
+      const frame = `event: ${A11Y_EVENT}
+data: ${JSON.stringify(report)}
+
+`;
+      for (const client of eventClients) client.write(frame);
+    }
+  });
+  async function handleStartA11yRun({ req, res }) {
+    let body;
+    try {
+      body = JSON.parse(await readBody(req));
+    } catch {
+      body = void 0;
+    }
+    const answer = a11yRuns.start(body);
+    jsonResponse(res, answer.status, answer.body);
+  }
+  async function handleConfirmA11yReview({ req, res }) {
+    let body;
+    try {
+      body = JSON.parse(await readBody(req));
+    } catch {
+      body = void 0;
+    }
+    const answer = a11yRuns.confirm(body);
+    jsonResponse(res, answer.status, answer.body);
+  }
+  async function handleGetA11yReport({ res }) {
+    const answer = a11yRuns.report();
+    jsonResponse(res, answer.status, answer.body);
   }
   async function handleExportTheme({ params, res }) {
     const [fileName] = params;
@@ -2074,22 +2262,22 @@ data: ${JSON.stringify(state)}
       }
       body.name = String(body.name || fileName);
       body.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs2.existsSync(filePath)) {
+      if (fs3.existsSync(filePath)) {
         try {
-          const existing = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+          const existing = JSON.parse(fs3.readFileSync(filePath, "utf-8"));
           if (existing.createdAt) body.createdAt = existing.createdAt;
         } catch {
         }
       }
       if (!body.createdAt) body.createdAt = body.updatedAt;
       sketchStylesResource.ensureDir();
-      fs2.writeFileSync(filePath, JSON.stringify(body, null, 2));
+      fs3.writeFileSync(filePath, JSON.stringify(body, null, 2));
       jsonResponse(res, 200, { ok: true, fileName });
       return;
     }
     if (req.method === "DELETE") {
-      if (fs2.existsSync(filePath)) {
-        fs2.unlinkSync(filePath);
+      if (fs3.existsSync(filePath)) {
+        fs3.unlinkSync(filePath);
       } else if (sketchStylesResource.existingPath(fileName)) {
         jsonResponse(res, 403, {
           error: "Cannot delete a sketchstyle shipped with the package. Saving it creates a local copy; deleting that copy restores the shipped version.",
@@ -2186,12 +2374,24 @@ data: ${JSON.stringify(state)}
     { method: "DELETE", pattern: SKETCH_STYLE_BY_NAME_REGEX, handler: handleSketchStyleByName },
     { method: "POST", pattern: SKETCH_STYLE_BY_NAME_REGEX, handler: methodNotAllowed },
     { method: "GET", pattern: EVENTS_ROUTE, handler: handleEvents },
+    { method: "POST", pattern: A11Y_RUN_ROUTE, handler: handleStartA11yRun },
+    { method: "GET", pattern: A11Y_RUN_ROUTE, handler: methodNotAllowed },
+    { method: "PUT", pattern: A11Y_RUN_ROUTE, handler: methodNotAllowed },
+    { method: "DELETE", pattern: A11Y_RUN_ROUTE, handler: methodNotAllowed },
+    { method: "GET", pattern: A11Y_REPORT_ROUTE, handler: handleGetA11yReport },
+    { method: "PUT", pattern: A11Y_REPORT_ROUTE, handler: methodNotAllowed },
+    { method: "POST", pattern: A11Y_REPORT_ROUTE, handler: methodNotAllowed },
+    { method: "DELETE", pattern: A11Y_REPORT_ROUTE, handler: methodNotAllowed },
+    { method: "PUT", pattern: A11Y_CONFIRMED_ROUTE, handler: handleConfirmA11yReview },
+    { method: "GET", pattern: A11Y_CONFIRMED_ROUTE, handler: methodNotAllowed },
+    { method: "POST", pattern: A11Y_CONFIRMED_ROUTE, handler: methodNotAllowed },
+    { method: "DELETE", pattern: A11Y_CONFIRMED_ROUTE, handler: methodNotAllowed },
     { method: "PUT", pattern: PRODUCTION_ROUTE, handler: handleAdoptTheme },
     { method: "GET", pattern: PRODUCTION_ROUTE, handler: methodNotAllowed },
     { method: "POST", pattern: PRODUCTION_ROUTE, handler: methodNotAllowed },
     { method: "DELETE", pattern: PRODUCTION_ROUTE, handler: methodNotAllowed }
   ];
-  const isEditorOwnedJson = (file) => file.endsWith(".json") && path3.resolve(file).startsWith(dataDirs.dataDir + path3.sep);
+  const isEditorOwnedJson = (file) => file.endsWith(".json") && path4.resolve(file).startsWith(dataDirs.dataDir + path4.sep);
   let buildLogger = null;
   let buildChecked = false;
   let productionCssLogger = null;
@@ -2241,7 +2441,7 @@ data: ${JSON.stringify(state)}
         const { productionPointerHeld } = ensureThemesDir((msg) => server.config.logger.warn(msg));
         const openTheme = activeTheme();
         if (openTheme) pruneMatchingWorking(openTheme);
-        if (!productionPointerHeld || !fs2.existsSync(GENERATED_CSS_PATH)) regenerateTokensCss();
+        if (!productionPointerHeld || !fs3.existsSync(GENERATED_CSS_PATH)) regenerateTokensCss();
         if (opts.autoMigrate && !ISOLATED_DATA_DIR) {
           autoMigrateAdditive((msg) => server.config.logger.info(msg));
         }
@@ -2264,10 +2464,11 @@ data: ${JSON.stringify(state)}
         const handled = await dispatch(req, res, routes);
         if (!handled) next();
       });
+      server.httpServer?.once("close", () => a11yRuns.stop());
     },
     handleHotUpdate(ctx) {
       if (legacyLayout) return;
-      const normalized = path3.resolve(ctx.file);
+      const normalized = path4.resolve(ctx.file);
       if (!COMPONENTS_SCAN_DIRS.some((d) => normalized.startsWith(d))) return;
       if (!normalized.endsWith(".svelte")) return;
       if (!isThemeAwareComponent(normalized)) return;