@birdycom/omniacss-migrate 0.11.0 → 0.11.2

package/src/cli.mjs

@@ -1,139 +1,139 @@
-// File: packages/migrate/src/cli.mjs
-// OmniaCSS migrate CLI (used by bin/omniacss-migrate.mjs and `omniacss migrate`): scan | setup | codemod | build | css
-// Author: Serge Cools | Framework: OmniaCSS
-
-import path from "node:path";
-import fs from "node:fs/promises";
-import { parseArgs } from "node:util";
-import { loadProject } from "./project.mjs";
-import { scanDir, formatScan } from "./scan.mjs";
-import { runCodemod, formatCodemod } from "./codemod.mjs";
-import { planSetup, applySetup, formatPlan } from "./setup.mjs";
-import { compileToken } from "./resolve.mjs";
-
-export const HELP = `
-omniacss-migrate - switch from Tailwind CSS to OmniaCSS and keep your class names
-
-  omniacss-migrate scan <dir>                    coverage report: how many classes the compat layer supports
-  omniacss-migrate setup <project> [--write]     plan (default) or apply the switch (deps, vite/postcss config, CSS)
-  omniacss-migrate codemod <dir> [--write]       rewrite classes to native OmniaCSS names where 1:1 (dry run by default)
-  omniacss-migrate build [-c glob]... [-o file]  write the compat + core CSS once (no Vite/PostCSS needed)
-  omniacss-migrate css "<class>"                 print the CSS for one class
-
-Bootstrap 3/4/5 -> OmniaCSS + OmniaUI
-  omniacss-migrate bootstrap scan <dir>              report: what converts, what stays (grid), what needs a hand
-  omniacss-migrate bootstrap codemod <dir> --write   rewrite classes, swap the <link>, write bootstrap-compat.css
-
-Options
-  --write               apply changes (setup, codemod)
-  --top <n>             rows in the unsupported list (scan, codemod; default 40)
-  --json                machine readable output (scan)
-  --breakpoints <omnia|tailwind>   sm/md/lg values (default omnia)
-  --dark <class|media>  dark mode strategy (default: detected)
-  --tailwind <3|4>      naming flavor (default: detected)
-  --keep-brand-colors   keep literal brand colors from tailwind.config instead of mapping to Omnia tokens
-  --bs <3|4|5>          (bootstrap) Bootstrap version (default: detected)
-  --breakpoints exact   (bootstrap) keep Bootstrap's px breakpoints as min-[…]: variants instead of the nearest Omnia breakpoint
-  --compat <file>       (bootstrap) where to write the compat stylesheet (default bootstrap-compat.css)
-  --omnia-href, --omniaui-href, --compat-href   (bootstrap) stylesheet URLs that replace the Bootstrap <link>
-`;
-
-function parse(args) {
-  return parseArgs({
-  args, allowPositionals: true,
-  options: {
-    write: { type: "boolean" }, top: { type: "string" }, json: { type: "boolean" }, help: { type: "boolean", short: "h" },
-    breakpoints: { type: "string" }, dark: { type: "string" }, tailwind: { type: "string" }, "keep-brand-colors": { type: "boolean" },
-    content: { type: "string", short: "c", multiple: true }, output: { type: "string", short: "o" }, backup: { type: "boolean" },
-    bs: { type: "string" }, compat: { type: "string" }, "omnia-href": { type: "string" }, "omniaui-href": { type: "string" }, "compat-href": { type: "string" },
-  },
-  });
-}
-
-let values, positionals;
-
-function ctxOptions() {
-  return {
-    breakpoints: values.breakpoints, darkMode: values.dark, v4: values.tailwind ? Number(values.tailwind) >= 4 : undefined,
-    keepBrandColors: values["keep-brand-colors"],
-  };
-}
-
-export async function run(args = process.argv.slice(2)) {
-  ({ values, positionals } = parse(args));
-  const [command, target] = positionals;
-  if (!command || values.help || command === "help") { console.log(HELP); return; }
-  const cwd = process.cwd();
-  const dir = path.resolve(cwd, target || ".");
-  const top = Number(values.top || 40);
-
-  if (command === "bootstrap") {
-    const [, sub, where] = positionals;
-    if (!["scan", "codemod"].includes(sub)) { console.log(HELP); process.exitCode = 1; return; }
-    const { migrateBootstrap, formatBootstrap } = await import("./bootstrap/migrate.mjs");
-    const report = await migrateBootstrap(path.resolve(cwd, where || "."), {
-      write: sub === "codemod" && !!values.write, version: values.bs ? Number(values.bs) : undefined,
-      breakpoints: values.breakpoints === "exact" ? "exact" : "omnia", compatFile: values.compat,
-      omniaHref: values["omnia-href"], omniauiHref: values["omniaui-href"], compatHref: values["compat-href"],
-    });
-    console.log(formatBootstrap(report, { top }));
-    return;
-  }
-
-  if (command === "scan") {
-    const { ctx, info } = await loadProject(dir, ctxOptions());
-    const stats = await scanDir(dir, { ctx });
-    if (values.json) {
-      console.log(JSON.stringify({ dir, files: stats.files, occurrences: stats.occurrences, supported: stats.supported, coverage: +stats.coverage.toFixed(2),
-        unsupported: Object.fromEntries([...stats.unsupported].sort((a, b) => b[1] - a[1]).slice(0, top)) }, null, 2));
-    } else {
-      console.log(`Tailwind ${info.tailwindVersion ?? "?"} project, dark mode: ${ctx.darkMode}, ${info.themeVars.size} custom theme variables\n`);
-      console.log(formatScan(stats, { top }));
-    }
-    return;
-  }
-
-  if (command === "setup") {
-    const plan = await planSetup(dir, { keepBrandColors: values["keep-brand-colors"] });
-    if (values.write) await applySetup(plan, { backup: values.backup });
-    console.log(formatPlan(plan, dir, { write: !!values.write }));
-    return;
-  }
-
-  if (command === "codemod") {
-    const { ctx } = await loadProject(dir, { ...ctxOptions(), breakpoints: values.breakpoints || "omnia" });
-    const report = await runCodemod(dir, { ctx, write: !!values.write, cwd: dir });
-    console.log(formatCodemod(report, { top }));
-    return;
-  }
-
-  if (command === "build") {
-    const postcss = (await import("postcss")).default;
-    const plugin = (await import("./postcss.mjs")).default;
-    const output = values.output || "omnia-compat.css";
-    const content = values.content?.length ? values.content : undefined;
-    const input = '@import "tailwindcss";\n';
-    const result = await postcss([plugin({ cwd: dir, content, ...ctxOptionsForPlugin() })]).process(input, { from: path.join(dir, "entry.css") });
-    await fs.writeFile(path.resolve(cwd, output), result.css);
-    console.log(`Wrote ${output} (${(result.css.length / 1024).toFixed(1)} KB)`);
-    return;
-  }
-
-  if (command === "css") {
-    const { ctx } = await loadProject(cwd, ctxOptions());
-    for (const token of positionals.slice(1).length ? positionals.slice(1) : [target]) {
-      const css = compileToken(token, ctx);
-      console.log(css ?? `/* ${token}: not supported */`);
-    }
-    return;
-  }
-
-  console.error(`Unknown command: ${command}`);
-  console.log(HELP);
-  process.exitCode = 1;
-}
-
-function ctxOptionsForPlugin() {
-  return { breakpoints: values.breakpoints, darkMode: values.dark, tailwind: values.tailwind ? Number(values.tailwind) : undefined };
-}
-
+// File: packages/migrate/src/cli.mjs
+// OmniaCSS migrate CLI (used by bin/omniacss-migrate.mjs and `omniacss migrate`): scan | setup | codemod | build | css
+// Author: Serge Cools | Framework: OmniaCSS
+
+import path from "node:path";
+import fs from "node:fs/promises";
+import { parseArgs } from "node:util";
+import { loadProject } from "./project.mjs";
+import { scanDir, formatScan } from "./scan.mjs";
+import { runCodemod, formatCodemod } from "./codemod.mjs";
+import { planSetup, applySetup, formatPlan } from "./setup.mjs";
+import { compileToken } from "./resolve.mjs";
+
+export const HELP = `
+omniacss-migrate - switch from Tailwind CSS to OmniaCSS and keep your class names
+
+  omniacss-migrate scan <dir>                    coverage report: how many classes the compat layer supports
+  omniacss-migrate setup <project> [--write]     plan (default) or apply the switch (deps, vite/postcss config, CSS)
+  omniacss-migrate codemod <dir> [--write]       rewrite classes to native OmniaCSS names where 1:1 (dry run by default)
+  omniacss-migrate build [-c glob]... [-o file]  write the compat + core CSS once (no Vite/PostCSS needed)
+  omniacss-migrate css "<class>"                 print the CSS for one class
+
+Bootstrap 3/4/5 -> OmniaCSS + OmniaUI
+  omniacss-migrate bootstrap scan <dir>              report: what converts, what stays (grid), what needs a hand
+  omniacss-migrate bootstrap codemod <dir> --write   rewrite classes, swap the <link>, write bootstrap-compat.css
+
+Options
+  --write               apply changes (setup, codemod)
+  --top <n>             rows in the unsupported list (scan, codemod; default 40)
+  --json                machine readable output (scan)
+  --breakpoints <omnia|tailwind>   sm/md/lg values (default omnia)
+  --dark <class|media>  dark mode strategy (default: detected)
+  --tailwind <3|4>      naming flavor (default: detected)
+  --keep-brand-colors   keep literal brand colors from tailwind.config instead of mapping to Omnia tokens
+  --bs <3|4|5>          (bootstrap) Bootstrap version (default: detected)
+  --breakpoints exact   (bootstrap) keep Bootstrap's px breakpoints as min-[…]: variants instead of the nearest Omnia breakpoint
+  --compat <file>       (bootstrap) where to write the compat stylesheet (default bootstrap-compat.css)
+  --omnia-href, --omniaui-href, --compat-href   (bootstrap) stylesheet URLs that replace the Bootstrap <link>
+`;
+
+function parse(args) {
+  return parseArgs({
+  args, allowPositionals: true,
+  options: {
+    write: { type: "boolean" }, top: { type: "string" }, json: { type: "boolean" }, help: { type: "boolean", short: "h" },
+    breakpoints: { type: "string" }, dark: { type: "string" }, tailwind: { type: "string" }, "keep-brand-colors": { type: "boolean" },
+    content: { type: "string", short: "c", multiple: true }, output: { type: "string", short: "o" }, backup: { type: "boolean" },
+    bs: { type: "string" }, compat: { type: "string" }, "omnia-href": { type: "string" }, "omniaui-href": { type: "string" }, "compat-href": { type: "string" },
+  },
+  });
+}
+
+let values, positionals;
+
+function ctxOptions() {
+  return {
+    breakpoints: values.breakpoints, darkMode: values.dark, v4: values.tailwind ? Number(values.tailwind) >= 4 : undefined,
+    keepBrandColors: values["keep-brand-colors"],
+  };
+}
+
+export async function run(args = process.argv.slice(2)) {
+  ({ values, positionals } = parse(args));
+  const [command, target] = positionals;
+  if (!command || values.help || command === "help") { console.log(HELP); return; }
+  const cwd = process.cwd();
+  const dir = path.resolve(cwd, target || ".");
+  const top = Number(values.top || 40);
+
+  if (command === "bootstrap") {
+    const [, sub, where] = positionals;
+    if (!["scan", "codemod"].includes(sub)) { console.log(HELP); process.exitCode = 1; return; }
+    const { migrateBootstrap, formatBootstrap } = await import("./bootstrap/migrate.mjs");
+    const report = await migrateBootstrap(path.resolve(cwd, where || "."), {
+      write: sub === "codemod" && !!values.write, version: values.bs ? Number(values.bs) : undefined,
+      breakpoints: values.breakpoints === "exact" ? "exact" : "omnia", compatFile: values.compat,
+      omniaHref: values["omnia-href"], omniauiHref: values["omniaui-href"], compatHref: values["compat-href"],
+    });
+    console.log(formatBootstrap(report, { top }));
+    return;
+  }
+
+  if (command === "scan") {
+    const { ctx, info } = await loadProject(dir, ctxOptions());
+    const stats = await scanDir(dir, { ctx });
+    if (values.json) {
+      console.log(JSON.stringify({ dir, files: stats.files, occurrences: stats.occurrences, supported: stats.supported, coverage: +stats.coverage.toFixed(2),
+        unsupported: Object.fromEntries([...stats.unsupported].sort((a, b) => b[1] - a[1]).slice(0, top)) }, null, 2));
+    } else {
+      console.log(`Tailwind ${info.tailwindVersion ?? "?"} project, dark mode: ${ctx.darkMode}, ${info.themeVars.size} custom theme variables\n`);
+      console.log(formatScan(stats, { top }));
+    }
+    return;
+  }
+
+  if (command === "setup") {
+    const plan = await planSetup(dir, { keepBrandColors: values["keep-brand-colors"] });
+    if (values.write) await applySetup(plan, { backup: values.backup });
+    console.log(formatPlan(plan, dir, { write: !!values.write }));
+    return;
+  }
+
+  if (command === "codemod") {
+    const { ctx } = await loadProject(dir, { ...ctxOptions(), breakpoints: values.breakpoints || "omnia" });
+    const report = await runCodemod(dir, { ctx, write: !!values.write, cwd: dir });
+    console.log(formatCodemod(report, { top }));
+    return;
+  }
+
+  if (command === "build") {
+    const postcss = (await import("postcss")).default;
+    const plugin = (await import("./postcss.mjs")).default;
+    const output = values.output || "omnia-compat.css";
+    const content = values.content?.length ? values.content : undefined;
+    const input = '@import "tailwindcss";\n';
+    const result = await postcss([plugin({ cwd: dir, content, ...ctxOptionsForPlugin() })]).process(input, { from: path.join(dir, "entry.css") });
+    await fs.writeFile(path.resolve(cwd, output), result.css);
+    console.log(`Wrote ${output} (${(result.css.length / 1024).toFixed(1)} KB)`);
+    return;
+  }
+
+  if (command === "css") {
+    const { ctx } = await loadProject(cwd, ctxOptions());
+    for (const token of positionals.slice(1).length ? positionals.slice(1) : [target]) {
+      const css = compileToken(token, ctx);
+      console.log(css ?? `/* ${token}: not supported */`);
+    }
+    return;
+  }
+
+  console.error(`Unknown command: ${command}`);
+  console.log(HELP);
+  process.exitCode = 1;
+}
+
+function ctxOptionsForPlugin() {
+  return { breakpoints: values.breakpoints, darkMode: values.dark, tailwind: values.tailwind ? Number(values.tailwind) : undefined };
+}
+

package/src/codemod.mjs

@@ -1,82 +1,82 @@
-// File: packages/migrate/src/codemod.mjs
-// Codemod: rewrite Tailwind-style class names to native OmniaCSS classes where the declarations are identical.
-// Everything else is left untouched and reported. Dry-run unless `write` is true.
-// Author: Serge Cools | Framework: OmniaCSS
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import { classStrings, walk, DEFAULT_EXTENSIONS } from "./extract.mjs";
-import { isClassString, makeKind } from "./scan.mjs";
-import { loadOmniaIndex, nativeFor } from "./native.mjs";
-
-export const MANIFEST = "omniacss-migrate.manifest.json";
-
-/**
- * @param {string} dir
- * @param {{ ctx: object, write?: boolean, extensions?: string[], cwd?: string }} o
- */
-export async function runCodemod(dir, o) {
-  const { ctx, write = false } = o;
-  const index = loadOmniaIndex(o.cwd || dir);
-  const kind = makeKind(ctx);
-  const memo = new Map();
-  const map = (t) => { if (!memo.has(t)) memo.set(t, nativeFor(t, ctx, index)); return memo.get(t); };
-  const files = await walk(dir, { extensions: o.extensions || DEFAULT_EXTENSIONS });
-  const report = { dir, write, files: [], total: 0, rewritten: 0, unchanged: 0, leftovers: new Map(), collisions: new Map(), mapping: new Map() };
-  for (const file of files) {
-    let text;
-    try { text = await fs.readFile(file, "utf8"); } catch { continue; }
-    const edits = [];
-    for (const s of classStrings(text)) {
-      if (!s.words.length) continue;
-      const kinds = s.words.map(kind);
-      if (!isClassString(kinds, s.hinted)) continue;
-      s.spans.forEach((sp, i) => {
-        if (kinds[i] !== "supported") return;
-        report.total++;
-        const r = map(sp.token);
-        if (r?.native && r.native !== sp.token) {
-          edits.push({ ...sp, to: r.native });
-          report.rewritten++;
-          report.mapping.set(sp.token, r.native);
-        } else if (r?.collision) {
-          report.collisions.set(sp.token, (report.collisions.get(sp.token) || 0) + 1);
-          report.leftovers.set(sp.token, (report.leftovers.get(sp.token) || 0) + 1);
-        } else if (r?.native) report.unchanged++;
-        else report.leftovers.set(sp.token, (report.leftovers.get(sp.token) || 0) + 1);
-      });
-    }
-    if (!edits.length) continue;
-    let out = text;
-    for (const e of edits.sort((a, b) => b.start - a.start)) out = out.slice(0, e.start) + e.to + out.slice(e.end);
-    report.files.push({ file, changes: edits.length, sample: edits.slice(0, 5).map((e) => `${e.token} -> ${e.to}`) });
-    if (write) await fs.writeFile(file, out);
-  }
-  const native = new Set(report.mapping.values());
-  const manifestFile = path.join(o.manifestDir || dir, MANIFEST);
-  if (write && native.size) {
-    const prev = JSON.parse(await fs.readFile(manifestFile, "utf8").catch(() => "{}"));
-    for (const t of prev.native || []) native.add(t);
-    const ambiguous = [...native].filter((t) => report.leftovers.has(t));
-    await fs.writeFile(manifestFile, JSON.stringify({ note: "Written by omniacss-migrate codemod: native OmniaCSS classes the compat layer must not emit.", native: [...native].sort(), ambiguous }, null, 1) + "\n");
-    report.manifestFile = manifestFile;
-  }
-  report.ambiguous = [...native].filter((t) => report.leftovers.has(t));
-  return report;
-}
-
-export function formatCodemod(r, { top = 25 } = {}) {
-  const pct = r.total ? ((r.rewritten / r.total) * 100).toFixed(1) : "0";
-  const lines = [];
-  lines.push(`${r.write ? "Rewrote" : "Dry run, would rewrite"} ${r.rewritten} of ${r.total} class occurrences (${pct}%) in ${r.files.length} files under ${r.dir}`);
-  for (const f of r.files.slice(0, 15)) lines.push(`  ${f.file}  (${f.changes})  e.g. ${f.sample.slice(0, 3).join(", ")}`);
-  if (r.files.length > 15) lines.push(`  ... and ${r.files.length - 15} more files`);
-  const left = [...r.leftovers.entries()].sort((a, b) => b[1] - a[1]);
-  lines.push("", `Left as they are (no 1:1 native class): ${left.reduce((n, [, c]) => n + c, 0)} occurrences, ${left.length} unique`);
-  for (const [t, n] of left.slice(0, top)) lines.push(`  ${String(n).padStart(5)}  ${t}${r.collisions.has(t) ? "   (name exists in OmniaCSS with different meaning)" : ""}`);
-  if (r.manifestFile) lines.push("", `Wrote ${r.manifestFile}: the compat layer skips these native classes so names never collide.`);
-  if (r.ambiguous?.length) lines.push(`Ambiguous (both a native class and a Tailwind-style leftover): ${r.ambiguous.slice(0, 10).join(", ")}`);
-  lines.push("", "Note: leftover classes keep working only while the compat layer (@birdycom/omniacss-migrate/postcss) stays enabled.");
-  if (!r.write) lines.push("Run again with --write to apply.");
-  return lines.join("\n");
-}
+// File: packages/migrate/src/codemod.mjs
+// Codemod: rewrite Tailwind-style class names to native OmniaCSS classes where the declarations are identical.
+// Everything else is left untouched and reported. Dry-run unless `write` is true.
+// Author: Serge Cools | Framework: OmniaCSS
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { classStrings, walk, DEFAULT_EXTENSIONS } from "./extract.mjs";
+import { isClassString, makeKind } from "./scan.mjs";
+import { loadOmniaIndex, nativeFor } from "./native.mjs";
+
+export const MANIFEST = "omniacss-migrate.manifest.json";
+
+/**
+ * @param {string} dir
+ * @param {{ ctx: object, write?: boolean, extensions?: string[], cwd?: string }} o
+ */
+export async function runCodemod(dir, o) {
+  const { ctx, write = false } = o;
+  const index = loadOmniaIndex(o.cwd || dir);
+  const kind = makeKind(ctx);
+  const memo = new Map();
+  const map = (t) => { if (!memo.has(t)) memo.set(t, nativeFor(t, ctx, index)); return memo.get(t); };
+  const files = await walk(dir, { extensions: o.extensions || DEFAULT_EXTENSIONS });
+  const report = { dir, write, files: [], total: 0, rewritten: 0, unchanged: 0, leftovers: new Map(), collisions: new Map(), mapping: new Map() };
+  for (const file of files) {
+    let text;
+    try { text = await fs.readFile(file, "utf8"); } catch { continue; }
+    const edits = [];
+    for (const s of classStrings(text)) {
+      if (!s.words.length) continue;
+      const kinds = s.words.map(kind);
+      if (!isClassString(kinds, s.hinted)) continue;
+      s.spans.forEach((sp, i) => {
+        if (kinds[i] !== "supported") return;
+        report.total++;
+        const r = map(sp.token);
+        if (r?.native && r.native !== sp.token) {
+          edits.push({ ...sp, to: r.native });
+          report.rewritten++;
+          report.mapping.set(sp.token, r.native);
+        } else if (r?.collision) {
+          report.collisions.set(sp.token, (report.collisions.get(sp.token) || 0) + 1);
+          report.leftovers.set(sp.token, (report.leftovers.get(sp.token) || 0) + 1);
+        } else if (r?.native) report.unchanged++;
+        else report.leftovers.set(sp.token, (report.leftovers.get(sp.token) || 0) + 1);
+      });
+    }
+    if (!edits.length) continue;
+    let out = text;
+    for (const e of edits.sort((a, b) => b.start - a.start)) out = out.slice(0, e.start) + e.to + out.slice(e.end);
+    report.files.push({ file, changes: edits.length, sample: edits.slice(0, 5).map((e) => `${e.token} -> ${e.to}`) });
+    if (write) await fs.writeFile(file, out);
+  }
+  const native = new Set(report.mapping.values());
+  const manifestFile = path.join(o.manifestDir || dir, MANIFEST);
+  if (write && native.size) {
+    const prev = JSON.parse(await fs.readFile(manifestFile, "utf8").catch(() => "{}"));
+    for (const t of prev.native || []) native.add(t);
+    const ambiguous = [...native].filter((t) => report.leftovers.has(t));
+    await fs.writeFile(manifestFile, JSON.stringify({ note: "Written by omniacss-migrate codemod: native OmniaCSS classes the compat layer must not emit.", native: [...native].sort(), ambiguous }, null, 1) + "\n");
+    report.manifestFile = manifestFile;
+  }
+  report.ambiguous = [...native].filter((t) => report.leftovers.has(t));
+  return report;
+}
+
+export function formatCodemod(r, { top = 25 } = {}) {
+  const pct = r.total ? ((r.rewritten / r.total) * 100).toFixed(1) : "0";
+  const lines = [];
+  lines.push(`${r.write ? "Rewrote" : "Dry run, would rewrite"} ${r.rewritten} of ${r.total} class occurrences (${pct}%) in ${r.files.length} files under ${r.dir}`);
+  for (const f of r.files.slice(0, 15)) lines.push(`  ${f.file}  (${f.changes})  e.g. ${f.sample.slice(0, 3).join(", ")}`);
+  if (r.files.length > 15) lines.push(`  ... and ${r.files.length - 15} more files`);
+  const left = [...r.leftovers.entries()].sort((a, b) => b[1] - a[1]);
+  lines.push("", `Left as they are (no 1:1 native class): ${left.reduce((n, [, c]) => n + c, 0)} occurrences, ${left.length} unique`);
+  for (const [t, n] of left.slice(0, top)) lines.push(`  ${String(n).padStart(5)}  ${t}${r.collisions.has(t) ? "   (name exists in OmniaCSS with different meaning)" : ""}`);
+  if (r.manifestFile) lines.push("", `Wrote ${r.manifestFile}: the compat layer skips these native classes so names never collide.`);
+  if (r.ambiguous?.length) lines.push(`Ambiguous (both a native class and a Tailwind-style leftover): ${r.ambiguous.slice(0, 10).join(", ")}`);
+  lines.push("", "Note: leftover classes keep working only while the compat layer (@birdycom/omniacss-migrate/postcss) stays enabled.");
+  if (!r.write) lines.push("Run again with --write to apply.");
+  return lines.join("\n");
+}

package/src/core.mjs

@@ -1,67 +1,67 @@
-// File: packages/migrate/src/core.mjs
-// Bridge to @birdycom/omniacss: the on-demand engine that emits tokens + Omnia-native classes.
-// Author: Serge Cools | Framework: OmniaCSS
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import { createRequire } from "node:module";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-const here = path.dirname(fileURLToPath(import.meta.url));
-let enginePromise;
-
-/** Load @birdycom/omniacss/engine (installed package first, monorepo sibling as fallback). */
-export function loadEngine(cwd = process.cwd()) {
-  enginePromise ||= (async () => {
-    const tries = [
-      () => createRequire(path.join(cwd, "package.json")).resolve("@birdycom/omniacss/engine"),
-      () => createRequire(import.meta.url).resolve("@birdycom/omniacss/engine"),
-      () => path.resolve(here, "../../core/src/engine.mjs"),
-    ];
-    for (const t of tries) {
-      try { const p = t(); await fs.access(p); return await import(pathToFileURL(p).href); } catch { /* next */ }
-    }
-    throw new Error("@birdycom/omniacss-migrate: cannot find @birdycom/omniacss. Install it with: npm install @birdycom/omniacss");
-  })();
-  return enginePromise;
-}
-
-const cache = new Map();
-let classNames, classNamesFor;
-
-/** Every class name that exists in the full Omnia CSS (cached): lets us ignore unrelated words in the content. */
-export function omniaClassNames(full) {
-  if (classNames && classNamesFor === full.length) return classNames;
-  classNames = new Set();
-  for (const m of full.matchAll(/\.((?:\\.|[A-Za-z0-9_-])+)/g)) classNames.add(m[1].replace(/\\(.)/g, "$1"));
-  classNamesFor = full.length;
-  return classNames;
-}
-
-/**
- * Omnia core CSS for a project: tokens (every var(--color-*) the compat output uses) plus the Omnia-native
- * classes found in the content. Classes the compat layer resolves are excluded, so a Tailwind-style `p-4`
- * never collides with Omnia's own `p-4`.
- * @param {{ candidates: Set<string>, compatCss: string, exclude: Set<string>, cwd?: string, layer?: string|false, mode?: true|"tokens" }} o
- */
-export async function buildCoreCss({ candidates, compatCss, exclude, cwd, layer = "omnia", mode = true }) {
-  const engine = await loadEngine(cwd);
-  const full = mode === true ? await engine.loadFullCss() : await fs.readFile(path.join(engine.DIST, "oc-colors.css"), "utf8");
-  const set = new Set();
-  if (mode === true) {
-    const known = omniaClassNames(full);
-    for (const c of candidates) if (known.has(c) && !exclude.has(c)) set.add(c);
-  }
-  const key = `${layer}|${mode}|${hash(compatCss)}|${[...set].sort().join(" ")}`;
-  if (cache.has(key)) return cache.get(key);
-  const css = engine.generate(full, set, { layer, referencedBy: [compatCss] });
-  cache.clear();
-  cache.set(key, css);
-  return css;
-}
-
-function hash(s) {
-  let h = 5381;
-  for (let i = 0; i < s.length; i++) h = ((h << 5) + h + s.charCodeAt(i)) | 0;
-  return h;
-}
+// File: packages/migrate/src/core.mjs
+// Bridge to @birdycom/omniacss: the on-demand engine that emits tokens + Omnia-native classes.
+// Author: Serge Cools | Framework: OmniaCSS
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+let enginePromise;
+
+/** Load @birdycom/omniacss/engine (installed package first, monorepo sibling as fallback). */
+export function loadEngine(cwd = process.cwd()) {
+  enginePromise ||= (async () => {
+    const tries = [
+      () => createRequire(path.join(cwd, "package.json")).resolve("@birdycom/omniacss/engine"),
+      () => createRequire(import.meta.url).resolve("@birdycom/omniacss/engine"),
+      () => path.resolve(here, "../../core/src/engine.mjs"),
+    ];
+    for (const t of tries) {
+      try { const p = t(); await fs.access(p); return await import(pathToFileURL(p).href); } catch { /* next */ }
+    }
+    throw new Error("@birdycom/omniacss-migrate: cannot find @birdycom/omniacss. Install it with: npm install @birdycom/omniacss");
+  })();
+  return enginePromise;
+}
+
+const cache = new Map();
+let classNames, classNamesFor;
+
+/** Every class name that exists in the full Omnia CSS (cached): lets us ignore unrelated words in the content. */
+export function omniaClassNames(full) {
+  if (classNames && classNamesFor === full.length) return classNames;
+  classNames = new Set();
+  for (const m of full.matchAll(/\.((?:\\.|[A-Za-z0-9_-])+)/g)) classNames.add(m[1].replace(/\\(.)/g, "$1"));
+  classNamesFor = full.length;
+  return classNames;
+}
+
+/**
+ * Omnia core CSS for a project: tokens (every var(--color-*) the compat output uses) plus the Omnia-native
+ * classes found in the content. Classes the compat layer resolves are excluded, so a Tailwind-style `p-4`
+ * never collides with Omnia's own `p-4`.
+ * @param {{ candidates: Set<string>, compatCss: string, exclude: Set<string>, cwd?: string, layer?: string|false, mode?: true|"tokens" }} o
+ */
+export async function buildCoreCss({ candidates, compatCss, exclude, cwd, layer = "omnia", mode = true }) {
+  const engine = await loadEngine(cwd);
+  const full = mode === true ? await engine.loadFullCss() : await fs.readFile(path.join(engine.DIST, "oc-colors.css"), "utf8");
+  const set = new Set();
+  if (mode === true) {
+    const known = omniaClassNames(full);
+    for (const c of candidates) if (known.has(c) && !exclude.has(c)) set.add(c);
+  }
+  const key = `${layer}|${mode}|${hash(compatCss)}|${[...set].sort().join(" ")}`;
+  if (cache.has(key)) return cache.get(key);
+  const css = engine.generate(full, set, { layer, referencedBy: [compatCss] });
+  cache.clear();
+  cache.set(key, css);
+  return css;
+}
+
+function hash(s) {
+  let h = 5381;
+  for (let i = 0; i < s.length; i++) h = ((h << 5) + h + s.charCodeAt(i)) | 0;
+  return h;
+}