@csszyx/unplugin 0.14.4 → 0.15.0

package/dist/shared/unplugin.CqJS0BbD.mjs

@@ -0,0 +1,211 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+
+function sortStrings(values) {
+  return [...values].sort((a, b) => {
+    if (a < b) return -1;
+    if (a > b) return 1;
+    return 0;
+  });
+}
+
+const WINDOWS_PATH_SEPARATOR = String.fromCodePoint(92);
+function normalizePathSeparators(value) {
+  return value.split(WINDOWS_PATH_SEPARATOR).join("/");
+}
+
+const SAFELIST_HEADER = "# Auto-generated by csszyx \u2014 DO NOT EDIT\n# Tailwind scans this file for class names, one per line.\n";
+function renderSafelistFile(classNames) {
+  if (classNames.length === 0) {
+    return SAFELIST_HEADER;
+  }
+  return `${SAFELIST_HEADER}${classNames.join("\n")}
+`;
+}
+
+const SAFELIST_FILE = ".csszyx/csszyx-classes.txt";
+const LEGACY_SAFELIST_FILES = [
+  "csszyx-classes.html",
+  ".csszyx/next-loader-classes.html"
+];
+const LEGACY_HTML_MARKERS = [
+  "<!-- Auto-generated by csszyx",
+  "<!-- csszyx Next safelist",
+  "<!-- csszyx exact scanner candidates -->"
+];
+function removeLegacySafelists(rootDir, warn) {
+  for (const legacy of LEGACY_SAFELIST_FILES) {
+    const file = path.join(rootDir, legacy);
+    let content;
+    try {
+      content = fs.readFileSync(file, "utf8");
+    } catch {
+      continue;
+    }
+    if (!LEGACY_HTML_MARKERS.some((marker) => content.includes(marker))) continue;
+    try {
+      fs.rmSync(file, { force: true });
+    } catch (error) {
+      const { message } = error;
+      warn(`[csszyx] could not remove ${legacy}: ${message}. Delete it by hand.`);
+      continue;
+    }
+    warn(
+      `[csszyx] removed ${legacy}: the safelist now lives at ${SAFELIST_FILE}. Update any hand-written @source that named the old file, or drop it and list '@csszyx/unplugin/postcss' before '@tailwindcss/postcss' in postcss.config.`
+    );
+  }
+}
+const LEGACY_SAFELIST_BASENAMES = new Set(
+  LEGACY_SAFELIST_FILES.map((file) => path.posix.basename(file))
+);
+function isDanglingLegacySource(target, cssFile) {
+  if (!LEGACY_SAFELIST_BASENAMES.has(path.posix.basename(target))) return false;
+  return !fs.existsSync(path.resolve(path.dirname(cssFile), target));
+}
+function findLegacySourceDirective(code, cssFile) {
+  const withoutComments = stripCssBlockComments(code);
+  for (const match of withoutComments.matchAll(/@source\s+(["'])([^"']+)\1/g)) {
+    const target = match[2];
+    if (isDanglingLegacySource(target, cssFile)) {
+      return { directive: match[0], target };
+    }
+  }
+  return null;
+}
+const SKIPPED_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".csszyx",
+  "dist",
+  "build",
+  "out",
+  "coverage",
+  ".turbo",
+  ".vercel"
+]);
+const STYLESHEET_EXTENSIONS = /* @__PURE__ */ new Set([".css", ".pcss", ".postcss"]);
+function findLegacySourceStylesheet(rootDir) {
+  const pending = [rootDir];
+  while (pending.length > 0) {
+    const dir = pending.pop();
+    for (const entry of readDirectory(dir)) {
+      if (entry.isDirectory()) {
+        if (!isSkippedDirectory(entry.name)) pending.push(path.join(dir, entry.name));
+        continue;
+      }
+      const found = readLegacySourceDirective(dir, entry);
+      if (found !== null) return found;
+    }
+  }
+  return null;
+}
+function readDirectory(dir) {
+  try {
+    return fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+}
+function isSkippedDirectory(name) {
+  return SKIPPED_DIRS.has(name) || name.startsWith(".next");
+}
+function readLegacySourceDirective(dir, entry) {
+  if (!entry.isFile() || !STYLESHEET_EXTENSIONS.has(path.extname(entry.name))) return null;
+  const file = path.join(dir, entry.name);
+  const code = fs.readFileSync(file, "utf8");
+  if (!code.includes("@source")) return null;
+  const found = findLegacySourceDirective(code, file);
+  return found === null ? null : { file, ...found };
+}
+const ROOTS_WITHOUT_LEGACY_SOURCE = /* @__PURE__ */ new Set();
+function assertNoLegacySourceStylesheet(rootDir) {
+  if (ROOTS_WITHOUT_LEGACY_SOURCE.has(rootDir)) return;
+  const found = findLegacySourceStylesheet(rootDir);
+  if (found !== null) throw new Error(legacySourceMessage(found.file, found.target));
+  ROOTS_WITHOUT_LEGACY_SOURCE.add(rootDir);
+}
+const CSSZYX_POSTCSS_PLUGIN = "@csszyx/unplugin/postcss";
+const POSTCSS_CONFIG_FILES = [
+  ".postcssrc.json",
+  "postcss.config.json",
+  ".postcssrc.js",
+  "postcss.config.js",
+  "postcss.config.mjs",
+  "postcss.config.cjs"
+];
+function findPostcssConfigWithoutCsszyx(rootDir) {
+  const packageJson = path.join(rootDir, "package.json");
+  let postcssKey;
+  try {
+    postcssKey = JSON.parse(fs.readFileSync(packageJson, "utf8")).postcss;
+  } catch {
+    postcssKey = void 0;
+  }
+  if (postcssKey !== void 0) {
+    return JSON.stringify(postcssKey).includes(CSSZYX_POSTCSS_PLUGIN) ? null : packageJson;
+  }
+  for (const name of POSTCSS_CONFIG_FILES) {
+    const file = path.join(rootDir, name);
+    let text;
+    try {
+      text = fs.readFileSync(file, "utf8");
+    } catch {
+      continue;
+    }
+    return text.includes(CSSZYX_POSTCSS_PLUGIN) ? null : file;
+  }
+  return null;
+}
+function missingPostcssPluginMessage(configFile) {
+  return `[csszyx] ${configFile} does not list '@csszyx/unplugin/postcss'. Next.js reads the safelist only through that plugin: list it before '@tailwindcss/postcss', or no sz class gets CSS.`;
+}
+function legacySourceMessage(cssFile, target) {
+  return `[csszyx] ${cssFile}: @source "${target}" names the old safelist, which csszyx no longer writes. The safelist is now ${SAFELIST_FILE}, and csszyx adds the directive itself: remove this line. Vite, Rollup and webpack inject it; on Next.js list '@csszyx/unplugin/postcss' before '@tailwindcss/postcss' in postcss.config.`;
+}
+const TAILWIND_SPECIFIER = String.raw`["']tailwindcss(?:\/[^"']*)?["']`;
+const TAILWIND_IMPORT = new RegExp(String.raw`@import\s+${TAILWIND_SPECIFIER}`);
+function computeSafelistRelPath(rootDir, safelistFilename, cssId) {
+  const safelistPath = normalizePathSeparators(path.join(rootDir, safelistFilename));
+  const cssDir = normalizePathSeparators(path.dirname(cssId));
+  let relPath = path.posix.relative(cssDir, safelistPath);
+  if (!relPath.startsWith("./") && !relPath.startsWith("../")) {
+    relPath = `./${relPath}`;
+  }
+  return relPath;
+}
+function appendTailwindSourceDirective(code, relPath) {
+  const directive = `@source "${relPath}";`;
+  if (code.includes(directive)) {
+    return null;
+  }
+  const separator = code.length === 0 || code.endsWith("\n") ? "" : "\n";
+  return `${code}${separator}${directive}
+`;
+}
+function stripCssBlockComments(code) {
+  const SLASH = 47;
+  const STAR = 42;
+  let out = "";
+  let last = 0;
+  let i = 0;
+  const n = code.length;
+  while (i < n) {
+    if (code.codePointAt(i) === SLASH && code.codePointAt(i + 1) === STAR) {
+      out += code.slice(last, i);
+      i += 2;
+      while (i < n && !(code.codePointAt(i) === STAR && code.codePointAt(i + 1) === SLASH)) {
+        i++;
+      }
+      i += 2;
+      last = i;
+    } else {
+      i++;
+    }
+  }
+  return out + code.slice(last);
+}
+function cssImportsTailwind(code) {
+  return TAILWIND_IMPORT.test(stripCssBlockComments(code));
+}
+
+export { SAFELIST_FILE as S, appendTailwindSourceDirective as a, cssImportsTailwind as b, computeSafelistRelPath as c, removeLegacySafelists as d, assertNoLegacySourceStylesheet as e, findPostcssConfigWithoutCsszyx as f, stripCssBlockComments as g, findLegacySourceDirective as h, legacySourceMessage as l, missingPostcssPluginMessage as m, normalizePathSeparators as n, renderSafelistFile as r, sortStrings as s };

package/dist/shared/{unplugin.VtXstzEh.cjs → unplugin.DX3rYT4P.cjs}

@@ -2,6 +2,7 @@
 
 const path = require('node:path');
 const compiler = require('@csszyx/compiler');
+const safelistSource = require('./unplugin.KnDCM-sr.cjs');
 const fs = require('node:fs');
 const node_crypto = require('node:crypto');
 
@@ -20,11 +21,6 @@ function _interopNamespaceCompat(e) {
 const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
 const fs__namespace = /*#__PURE__*/_interopNamespaceCompat(fs);
 
-const WINDOWS_PATH_SEPARATOR = String.fromCodePoint(92);
-function normalizePathSeparators(value) {
-  return value.split(WINDOWS_PATH_SEPARATOR).join("/");
-}
-
 const TSCONFIG_CANDIDATES = ["tsconfig.json", "jsconfig.json", "tsconfig.app.json"];
 const MAX_EXTENDS_DEPTH = 8;
 function collectSpecifierAliases(rootDir, resolveAlias) {
@@ -115,12 +111,12 @@ function aliasedSpecifierBases(specifier, aliases) {
       continue;
     }
     if (!specifier.startsWith(alias.find)) continue;
-    bases.push(normalizePathSeparators(alias.replacement + specifier.slice(alias.find.length)));
+    bases.push(safelistSource.normalizePathSeparators(alias.replacement + specifier.slice(alias.find.length)));
   }
   return bases;
 }
 function absolute(directory, target) {
-  const resolved = normalizePathSeparators(path__namespace.resolve(directory, target));
+  const resolved = safelistSource.normalizePathSeparators(path__namespace.resolve(directory, target));
   const declaredTrailingSlash = target.endsWith("/") || target.endsWith("\\");
   return declaredTrailingSlash && !resolved.endsWith("/") ? `${resolved}/` : resolved;
 }
@@ -189,7 +185,7 @@ function recordSzObjectRegistryFile(registry, filePath, content) {
   );
 }
 function replaceEntriesOfKind(registry, filePath, kind, entries) {
-  const key = normalizePathSeparators(filePath);
+  const key = safelistSource.normalizePathSeparators(filePath);
   const byName = emptyNameIndex();
   for (const [name, recorded] of Object.entries(registry.get(key) ?? {})) {
     if (recorded.kind !== kind) byName[name] = recorded;
@@ -211,7 +207,7 @@ const EMITTED_EXTENSION_SOURCES = [
   [".cjs", [".cts"]]
 ];
 function recordCrossModuleForwards(index, filePath, content) {
-  const key = normalizePathSeparators(filePath);
+  const key = safelistSource.normalizePathSeparators(filePath);
   const forwards = compiler.extractCrossModuleForwards(content, filePath);
   if (forwards.length === 0) index.delete(key);
   else index.set(key, forwards);
@@ -321,7 +317,7 @@ function importedSpecifiersIn(source) {
 }
 function specifierBases(specifier, directory, aliases) {
   if (specifier.startsWith(".")) {
-    return [normalizePathSeparators(path__namespace.resolve(directory, specifier))];
+    return [safelistSource.normalizePathSeparators(path__namespace.resolve(directory, specifier))];
   }
   return aliasedSpecifierBases(specifier, aliases);
 }
@@ -574,7 +570,6 @@ exports.forwardVisitKey = forwardVisitKey;
 exports.importedSpecifiersIn = importedSpecifiersIn;
 exports.isReadableProviderFile = isReadableProviderFile;
 exports.mayExportSzvFactories = mayExportSzvFactories;
-exports.normalizePathSeparators = normalizePathSeparators;
 exports.readTransformCache = readTransformCache;
 exports.recordCrossModuleForwards = recordCrossModuleForwards;
 exports.recordResolvedEntry = recordResolvedEntry;

package/dist/shared/{unplugin.Cji6O5jv.cjs → unplugin.Dai5wlZ3.cjs}

@@ -5,7 +5,7 @@ const fs = require('node:fs');
 const node_crypto = require('node:crypto');
 const node_os = require('node:os');
 const lockfile = require('proper-lockfile');
-const htmlEscape = require('./unplugin.BkRah5Ot.cjs');
+const safelistSource = require('./unplugin.KnDCM-sr.cjs');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
@@ -29,9 +29,10 @@ const DEFAULT_RENAME_RETRIES = 5;
 const DEFAULT_RENAME_RETRY_DELAY_MS = 10;
 const DEFAULT_STALE_LOCK_MS = 3e4;
 const STALE_RECOVERY_DISABLED_MS = 2147483647;
-function resolveNextSafelistStatePaths(rootDir, cacheDir = ".csszyx/cache", outputFile = "csszyx-classes.html") {
+function resolveNextSafelistStatePaths(rootDir, cacheDir = ".csszyx/cache", outputFile = safelistSource.SAFELIST_FILE) {
   const resolvedCacheDir = path__namespace.resolve(rootDir, cacheDir);
   return {
+    rootDir: path__namespace.resolve(rootDir),
     cacheDir: resolvedCacheDir,
     shardsDir: path__namespace.join(resolvedCacheDir, "safelist-shards"),
     snapshotPath: path__namespace.join(resolvedCacheDir, "safelist.snapshot.json"),
@@ -62,13 +63,14 @@ function materializeNextSafelist(paths, options = {}) {
       recordsBySource.set(record.data.sourcePath, record);
     }
   }
-  const sortedSources = [...recordsBySource.values()].map(({ data }) => [data.sourcePath, htmlEscape.sortStrings(new Set(data.classes))]).sort(([left], [right]) => left.localeCompare(right));
-  const classNames = htmlEscape.sortStrings(new Set(sortedSources.flatMap(([, classSet]) => classSet)));
+  const sortedSources = [...recordsBySource.values()].map(({ data }) => [data.sourcePath, safelistSource.sortStrings(new Set(data.classes))]).sort(([left], [right]) => left.localeCompare(right));
+  const classNames = safelistSource.sortStrings(new Set(sortedSources.flatMap(([, classSet]) => classSet)));
   const snapshot = {
     version: 1,
     sources: sortedSources.map(([sourcePath, classSet]) => [sourcePath, classSet])
   };
-  atomicWriteFileSync(paths.outputPath, renderTailwindSourceHtml(classNames), options);
+  atomicWriteFileSync(paths.outputPath, safelistSource.renderSafelistFile(classNames), options);
+  safelistSource.removeLegacySafelists(paths.rootDir, console.warn);
   atomicWriteFileSync(paths.snapshotPath, `${JSON.stringify(snapshot, null, 2)}
 `, options);
   return {
@@ -100,14 +102,14 @@ function acquireNextSafelistStateLock(lockPath, pidOrOptions = {}) {
   } catch (error) {
     const existing2 = readLockMetadata(lockPath);
     if (existing2) {
-      throw new Error(formatLiveLockError(existing2));
+      throw new NextSafelistStateLockedError(existing2);
     }
     throw error;
   }
   const existing = readLockMetadata(lockPath);
   if (existing && isLockLive(existing, options)) {
     releaseAdvisory();
-    throw new Error(formatLiveLockError(existing));
+    throw new NextSafelistStateLockedError(existing);
   }
   try {
     atomicWriteFileSync(lockPath, `${JSON.stringify(metadata, null, 2)}
@@ -195,7 +197,7 @@ function sameClasses(left, right) {
 }
 function normalizeShardInput(input) {
   const sourcePath = path__namespace.resolve(input.sourcePath);
-  const classes = htmlEscape.sortStrings(
+  const classes = safelistSource.sortStrings(
     new Set(input.classes.map((className) => className.trim()).filter(Boolean))
   );
   const cacheKey = input.cacheKey ?? node_crypto.createHash("sha256").update(sourcePath).update("\0").update(input.sourceHash).digest("hex");
@@ -252,15 +254,6 @@ function normalizeShardRecord(filePath, data) {
     })
   };
 }
-function renderTailwindSourceHtml(classNames) {
-  if (classNames.length === 0) {
-    return "<!-- csszyx Next safelist: empty -->\n";
-  }
-  const structuralHtml = classNames.map((className) => `<div class="${htmlEscape.escapeHtmlAttribute(className)}"></div>`).join("\n");
-  const scannerCandidates = htmlEscape.renderTailwindScannerCandidates(classNames);
-  return `${structuralHtml}
-${scannerCandidates}`;
-}
 function createLockMetadata(options) {
   const now = new Date(options.now ?? Date.now()).toISOString();
   const pid = options.pid ?? process.pid;
@@ -357,6 +350,18 @@ function isProcessAlive(pid) {
     return false;
   }
 }
+class NextSafelistStateLockedError extends Error {
+  holder;
+  /**
+   * @param holder - metadata read from the lock file.
+   */
+  constructor(holder) {
+    super(formatLiveLockError(holder));
+    this.name = "NextSafelistStateLockedError";
+    this.holder = holder;
+  }
+}
+const NEXT_WATCH_LOCK_COMMAND = "csszyx next watch";
 function formatLiveLockError(metadata) {
   return [
     `csszyx Next safelist state is already locked by process ${metadata.pid}.`,
@@ -410,7 +415,7 @@ function stableStringify(value) {
 }
 function pickEnv(env, envKeys) {
   const selected = {};
-  for (const key of htmlEscape.sortStrings(new Set(envKeys))) {
+  for (const key of safelistSource.sortStrings(new Set(envKeys))) {
     const value = env[key];
     if (value !== void 0) {
       selected[key] = value;
@@ -535,6 +540,7 @@ function isNestedPackageRoot(parentRoot, candidateRoot) {
 
 function createNextStateContext(input) {
   const rootResolution = resolveNextAppRoot(input);
+  safelistSource.assertNoLegacySourceStylesheet(rootResolution.root);
   const cacheDir = resolveNextAppCacheDir(rootResolution.root, input.cacheDir);
   const identity = createNextCacheIdentity({
     root: rootResolution.root,
@@ -598,7 +604,7 @@ function runNextWatcherCycle(context, options = {}) {
   const lock = acquireNextSafelistStateLock(lockPath, {
     root: context.root,
     mode: context.manifestExpectation.mode,
-    command: "csszyx next watch",
+    command: NEXT_WATCH_LOCK_COMMAND,
     ...options.lockOptions
   });
   try {
@@ -632,6 +638,8 @@ function runNextWatcherCycle(context, options = {}) {
   }
 }
 
+exports.NEXT_WATCH_LOCK_COMMAND = NEXT_WATCH_LOCK_COMMAND;
+exports.NextSafelistStateLockedError = NextSafelistStateLockedError;
 exports.createNextStateContext = createNextStateContext;
 exports.readNextGenerationManifest = readNextGenerationManifest;
 exports.runNextWatcherCycle = runNextWatcherCycle;

package/dist/shared/{unplugin.DN95k991.mjs → unplugin.Dbc26ty6.mjs}

@@ -2,9 +2,9 @@ import { readFileSync } from 'node:fs';
 import * as path from 'node:path';
 import { extractCrossModuleForwards, extractCrossModuleRegistryEntries, ensureRustTransformAvailable, transformRust, transformWasm, transform } from '@csszyx/compiler';
 import { DEFAULT_IMPORTED_STATIC_SZ } from '@csszyx/types';
-import { c as collectSpecifierAliases, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, n as normalizePathSeparators, b as recordResolvedEntry, f as forwardVisitKey, M as MAX_FORWARD_HOPS, d as isReadableProviderFile, e as createTransformCacheKey, g as readTransformCache, w as writeTransformCache } from './unplugin.NlPvn5P4.mjs';
+import { c as collectSpecifierAliases, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, b as recordResolvedEntry, f as forwardVisitKey, M as MAX_FORWARD_HOPS, d as isReadableProviderFile, e as createTransformCacheKey, g as readTransformCache, w as writeTransformCache } from './unplugin.AGR7mihU.mjs';
+import { n as normalizePathSeparators, s as sortStrings } from './unplugin.CqJS0BbD.mjs';
 import { createHash } from 'node:crypto';
-import { s as sortStrings } from './unplugin.B3XoSRB8.mjs';
 
 function resolveImportedStaticSz(value) {
   return value ?? DEFAULT_IMPORTED_STATIC_SZ;

package/dist/shared/{unplugin.BU0O4IkX.mjs → unplugin.DmCOQc-b.mjs}

@@ -3,15 +3,16 @@ import * as fs from 'node:fs';
 import { createHash, randomUUID } from 'node:crypto';
 import { hostname } from 'node:os';
 import lockfile from 'proper-lockfile';
-import { s as sortStrings, e as escapeHtmlAttribute, r as renderTailwindScannerCandidates } from './unplugin.B3XoSRB8.mjs';
+import { S as SAFELIST_FILE, s as sortStrings, r as renderSafelistFile, d as removeLegacySafelists, e as assertNoLegacySourceStylesheet } from './unplugin.CqJS0BbD.mjs';
 
 const DEFAULT_RENAME_RETRIES = 5;
 const DEFAULT_RENAME_RETRY_DELAY_MS = 10;
 const DEFAULT_STALE_LOCK_MS = 3e4;
 const STALE_RECOVERY_DISABLED_MS = 2147483647;
-function resolveNextSafelistStatePaths(rootDir, cacheDir = ".csszyx/cache", outputFile = "csszyx-classes.html") {
+function resolveNextSafelistStatePaths(rootDir, cacheDir = ".csszyx/cache", outputFile = SAFELIST_FILE) {
   const resolvedCacheDir = path.resolve(rootDir, cacheDir);
   return {
+    rootDir: path.resolve(rootDir),
     cacheDir: resolvedCacheDir,
     shardsDir: path.join(resolvedCacheDir, "safelist-shards"),
     snapshotPath: path.join(resolvedCacheDir, "safelist.snapshot.json"),
@@ -48,7 +49,8 @@ function materializeNextSafelist(paths, options = {}) {
     version: 1,
     sources: sortedSources.map(([sourcePath, classSet]) => [sourcePath, classSet])
   };
-  atomicWriteFileSync(paths.outputPath, renderTailwindSourceHtml(classNames), options);
+  atomicWriteFileSync(paths.outputPath, renderSafelistFile(classNames), options);
+  removeLegacySafelists(paths.rootDir, console.warn);
   atomicWriteFileSync(paths.snapshotPath, `${JSON.stringify(snapshot, null, 2)}
 `, options);
   return {
@@ -80,14 +82,14 @@ function acquireNextSafelistStateLock(lockPath, pidOrOptions = {}) {
   } catch (error) {
     const existing2 = readLockMetadata(lockPath);
     if (existing2) {
-      throw new Error(formatLiveLockError(existing2));
+      throw new NextSafelistStateLockedError(existing2);
     }
     throw error;
   }
   const existing = readLockMetadata(lockPath);
   if (existing && isLockLive(existing, options)) {
     releaseAdvisory();
-    throw new Error(formatLiveLockError(existing));
+    throw new NextSafelistStateLockedError(existing);
   }
   try {
     atomicWriteFileSync(lockPath, `${JSON.stringify(metadata, null, 2)}
@@ -232,15 +234,6 @@ function normalizeShardRecord(filePath, data) {
     })
   };
 }
-function renderTailwindSourceHtml(classNames) {
-  if (classNames.length === 0) {
-    return "<!-- csszyx Next safelist: empty -->\n";
-  }
-  const structuralHtml = classNames.map((className) => `<div class="${escapeHtmlAttribute(className)}"></div>`).join("\n");
-  const scannerCandidates = renderTailwindScannerCandidates(classNames);
-  return `${structuralHtml}
-${scannerCandidates}`;
-}
 function createLockMetadata(options) {
   const now = new Date(options.now ?? Date.now()).toISOString();
   const pid = options.pid ?? process.pid;
@@ -337,6 +330,18 @@ function isProcessAlive(pid) {
     return false;
   }
 }
+class NextSafelistStateLockedError extends Error {
+  holder;
+  /**
+   * @param holder - metadata read from the lock file.
+   */
+  constructor(holder) {
+    super(formatLiveLockError(holder));
+    this.name = "NextSafelistStateLockedError";
+    this.holder = holder;
+  }
+}
+const NEXT_WATCH_LOCK_COMMAND = "csszyx next watch";
 function formatLiveLockError(metadata) {
   return [
     `csszyx Next safelist state is already locked by process ${metadata.pid}.`,
@@ -515,6 +520,7 @@ function isNestedPackageRoot(parentRoot, candidateRoot) {
 
 function createNextStateContext(input) {
   const rootResolution = resolveNextAppRoot(input);
+  assertNoLegacySourceStylesheet(rootResolution.root);
   const cacheDir = resolveNextAppCacheDir(rootResolution.root, input.cacheDir);
   const identity = createNextCacheIdentity({
     root: rootResolution.root,
@@ -578,7 +584,7 @@ function runNextWatcherCycle(context, options = {}) {
   const lock = acquireNextSafelistStateLock(lockPath, {
     root: context.root,
     mode: context.manifestExpectation.mode,
-    command: "csszyx next watch",
+    command: NEXT_WATCH_LOCK_COMMAND,
     ...options.lockOptions
   });
   try {
@@ -612,4 +618,4 @@ function runNextWatcherCycle(context, options = {}) {
   }
 }
 
-export { readNextGenerationManifest as a, createNextStateContext as c, runNextWatcherCycle as r, validateNextGenerationManifest as v, writeNextSafelistShard as w };
+export { NextSafelistStateLockedError as N, NEXT_WATCH_LOCK_COMMAND as a, readNextGenerationManifest as b, createNextStateContext as c, runNextWatcherCycle as r, validateNextGenerationManifest as v, writeNextSafelistShard as w };