@csszyx/unplugin 0.14.4 → 0.15.0

package/dist/postcss.cjs

@@ -0,0 +1,124 @@
+'use strict';
+
+const path = require('node:path');
+const fs = require('node:fs');
+
+function _interopNamespaceCompat(e) {
+    if (e && typeof e === 'object' && 'default' in e) return e;
+    const n = Object.create(null);
+    if (e) {
+        for (const k in e) {
+            n[k] = e[k];
+        }
+    }
+    n.default = e;
+    return n;
+}
+
+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 SAFELIST_FILE = ".csszyx/csszyx-classes.txt";
+const DEFAULT_SAFELIST_FILES = [SAFELIST_FILE];
+const LEGACY_SAFELIST_FILES = [
+  "csszyx-classes.html",
+  ".csszyx/next-loader-classes.html"
+];
+const LEGACY_SAFELIST_BASENAMES = new Set(
+  LEGACY_SAFELIST_FILES.map((file) => path__namespace.posix.basename(file))
+);
+function isDanglingLegacySource(target, cssFile) {
+  if (!LEGACY_SAFELIST_BASENAMES.has(path__namespace.posix.basename(target))) return false;
+  return !fs__namespace.existsSync(path__namespace.resolve(path__namespace.dirname(cssFile), target));
+}
+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_PARAMS = new RegExp(`^${TAILWIND_SPECIFIER}`);
+function computeSafelistRelPath(rootDir, safelistFilename, cssId) {
+  const safelistPath = normalizePathSeparators(path__namespace.join(rootDir, safelistFilename));
+  const cssDir = normalizePathSeparators(path__namespace.dirname(cssId));
+  let relPath = path__namespace.posix.relative(cssDir, safelistPath);
+  if (!relPath.startsWith("./") && !relPath.startsWith("../")) {
+    relPath = `./${relPath}`;
+  }
+  return relPath;
+}
+function importParamsAreLocal(params) {
+  let target = params.trim();
+  if (target.startsWith("url(")) target = target.slice(4).trim();
+  if (target.startsWith('"') || target.startsWith("'")) target = target.slice(1);
+  return target.startsWith("./") || target.startsWith("../") || target.startsWith("/");
+}
+function importParamsNameTailwind(params) {
+  return TAILWIND_IMPORT_PARAMS.test(params.trim());
+}
+
+function rootMayReachTailwind(root) {
+  let found = false;
+  root.walkAtRules("import", (rule) => {
+    if (importParamsNameTailwind(rule.params) || importParamsAreLocal(rule.params)) {
+      found = true;
+      return false;
+    }
+    return void 0;
+  });
+  return found;
+}
+function existingSourcePaths(root, file) {
+  const paths = /* @__PURE__ */ new Set();
+  root.walkAtRules("source", (rule) => {
+    const match = /^["']([^"']*)["']$/.exec(rule.params.trim());
+    const target = match?.[1];
+    if (target === void 0) return;
+    if (isDanglingLegacySource(target, file)) {
+      throw new Error(legacySourceMessage(file, target));
+    }
+    paths.add(target);
+  });
+  return paths;
+}
+const csszyxPostcss = (options = {}) => {
+  const projectRoot = options.root ?? process.cwd();
+  const safelistFiles = options.safelistFiles ?? DEFAULT_SAFELIST_FILES;
+  return {
+    postcssPlugin: "csszyx",
+    Once(root, { AtRule, result }) {
+      const names = result.processor.plugins.map(
+        (plugin) => plugin.postcssPlugin
+      );
+      const tailwindAt = names.indexOf("tailwindcss");
+      if (tailwindAt !== -1 && tailwindAt < names.indexOf("csszyx")) {
+        throw new Error(
+          "[csszyx] '@csszyx/unplugin/postcss' is listed after '@tailwindcss/postcss'. Tailwind has already compiled the stylesheet by then, so the safelist is never read: list '@csszyx/unplugin/postcss' before '@tailwindcss/postcss'."
+        );
+      }
+      const file = root.source?.input.file;
+      if (file === void 0 || !rootMayReachTailwind(root)) return;
+      const present = existingSourcePaths(root, file);
+      for (const safelistFile of safelistFiles) {
+        const relPath = computeSafelistRelPath(projectRoot, safelistFile, file);
+        if (!present.has(relPath)) {
+          root.append(new AtRule({ name: "source", params: `"${relPath}"` }));
+        }
+        const absolute = path__namespace.resolve(projectRoot, safelistFile);
+        result.messages.push({
+          type: "dir-dependency",
+          plugin: "csszyx",
+          dir: path__namespace.dirname(absolute),
+          glob: path__namespace.basename(absolute),
+          parent: file
+        });
+      }
+    }
+  };
+};
+csszyxPostcss.postcss = true;
+
+module.exports = csszyxPostcss;

package/dist/postcss.d.cts

@@ -0,0 +1,42 @@
+import { PluginCreator } from 'postcss';
+
+/**
+ * PostCSS plugin that points a Tailwind stylesheet at csszyx's safelist.
+ *
+ * Every bundler csszyx has a plugin for injects the `@source` directive into
+ * the CSS entry itself. Next's Turbopack lane has no such hook: there csszyx
+ * only writes source files, and the stylesheet goes straight to
+ * `@tailwindcss/postcss`. This plugin is the one hook that lane does offer,
+ * so with it in `postcss.config` no project has to hand-write the directive.
+ *
+ * Order matters: `@tailwindcss/postcss` compiles the stylesheet in its own
+ * `Once`, so this plugin has to be listed BEFORE it. Next serialises the
+ * PostCSS config to a worker, so the plugin is referenced by package name
+ * (`'@csszyx/unplugin/postcss'`), never as a function.
+ */
+
+/** Options for {@link csszyxPostcss}. */
+interface CsszyxPostcssOptions {
+    /**
+     * Project root the safelist files are written under. Defaults to the
+     * working directory, which is the project directory under Next.
+     */
+    root?: string;
+    /**
+     * Safelist files to point at, relative to `root`. Defaults to every file
+     * csszyx writes; a file that does not exist yet costs nothing, Tailwind
+     * scans nothing for it and does not fail.
+     */
+    safelistFiles?: readonly string[];
+}
+/**
+ * Create the plugin.
+ *
+ * @param options - where the safelist files live.
+ * @returns a PostCSS plugin that appends one `@source` per safelist file to
+ *   any stylesheet importing tailwindcss, skipping paths already named.
+ */
+declare const csszyxPostcss: PluginCreator<CsszyxPostcssOptions>;
+
+export = csszyxPostcss;
+export type { CsszyxPostcssOptions };

package/dist/postcss.d.mts

@@ -0,0 +1,42 @@
+import { PluginCreator } from 'postcss';
+
+/**
+ * PostCSS plugin that points a Tailwind stylesheet at csszyx's safelist.
+ *
+ * Every bundler csszyx has a plugin for injects the `@source` directive into
+ * the CSS entry itself. Next's Turbopack lane has no such hook: there csszyx
+ * only writes source files, and the stylesheet goes straight to
+ * `@tailwindcss/postcss`. This plugin is the one hook that lane does offer,
+ * so with it in `postcss.config` no project has to hand-write the directive.
+ *
+ * Order matters: `@tailwindcss/postcss` compiles the stylesheet in its own
+ * `Once`, so this plugin has to be listed BEFORE it. Next serialises the
+ * PostCSS config to a worker, so the plugin is referenced by package name
+ * (`'@csszyx/unplugin/postcss'`), never as a function.
+ */
+
+/** Options for {@link csszyxPostcss}. */
+interface CsszyxPostcssOptions {
+    /**
+     * Project root the safelist files are written under. Defaults to the
+     * working directory, which is the project directory under Next.
+     */
+    root?: string;
+    /**
+     * Safelist files to point at, relative to `root`. Defaults to every file
+     * csszyx writes; a file that does not exist yet costs nothing, Tailwind
+     * scans nothing for it and does not fail.
+     */
+    safelistFiles?: readonly string[];
+}
+/**
+ * Create the plugin.
+ *
+ * @param options - where the safelist files live.
+ * @returns a PostCSS plugin that appends one `@source` per safelist file to
+ *   any stylesheet importing tailwindcss, skipping paths already named.
+ */
+declare const csszyxPostcss: PluginCreator<CsszyxPostcssOptions>;
+
+export { csszyxPostcss as default };
+export type { CsszyxPostcssOptions };

package/dist/postcss.mjs

@@ -0,0 +1,107 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+
+const WINDOWS_PATH_SEPARATOR = String.fromCodePoint(92);
+function normalizePathSeparators(value) {
+  return value.split(WINDOWS_PATH_SEPARATOR).join("/");
+}
+
+const SAFELIST_FILE = ".csszyx/csszyx-classes.txt";
+const DEFAULT_SAFELIST_FILES = [SAFELIST_FILE];
+const LEGACY_SAFELIST_FILES = [
+  "csszyx-classes.html",
+  ".csszyx/next-loader-classes.html"
+];
+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 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_PARAMS = new RegExp(`^${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 importParamsAreLocal(params) {
+  let target = params.trim();
+  if (target.startsWith("url(")) target = target.slice(4).trim();
+  if (target.startsWith('"') || target.startsWith("'")) target = target.slice(1);
+  return target.startsWith("./") || target.startsWith("../") || target.startsWith("/");
+}
+function importParamsNameTailwind(params) {
+  return TAILWIND_IMPORT_PARAMS.test(params.trim());
+}
+
+function rootMayReachTailwind(root) {
+  let found = false;
+  root.walkAtRules("import", (rule) => {
+    if (importParamsNameTailwind(rule.params) || importParamsAreLocal(rule.params)) {
+      found = true;
+      return false;
+    }
+    return void 0;
+  });
+  return found;
+}
+function existingSourcePaths(root, file) {
+  const paths = /* @__PURE__ */ new Set();
+  root.walkAtRules("source", (rule) => {
+    const match = /^["']([^"']*)["']$/.exec(rule.params.trim());
+    const target = match?.[1];
+    if (target === void 0) return;
+    if (isDanglingLegacySource(target, file)) {
+      throw new Error(legacySourceMessage(file, target));
+    }
+    paths.add(target);
+  });
+  return paths;
+}
+const csszyxPostcss = (options = {}) => {
+  const projectRoot = options.root ?? process.cwd();
+  const safelistFiles = options.safelistFiles ?? DEFAULT_SAFELIST_FILES;
+  return {
+    postcssPlugin: "csszyx",
+    Once(root, { AtRule, result }) {
+      const names = result.processor.plugins.map(
+        (plugin) => plugin.postcssPlugin
+      );
+      const tailwindAt = names.indexOf("tailwindcss");
+      if (tailwindAt !== -1 && tailwindAt < names.indexOf("csszyx")) {
+        throw new Error(
+          "[csszyx] '@csszyx/unplugin/postcss' is listed after '@tailwindcss/postcss'. Tailwind has already compiled the stylesheet by then, so the safelist is never read: list '@csszyx/unplugin/postcss' before '@tailwindcss/postcss'."
+        );
+      }
+      const file = root.source?.input.file;
+      if (file === void 0 || !rootMayReachTailwind(root)) return;
+      const present = existingSourcePaths(root, file);
+      for (const safelistFile of safelistFiles) {
+        const relPath = computeSafelistRelPath(projectRoot, safelistFile, file);
+        if (!present.has(relPath)) {
+          root.append(new AtRule({ name: "source", params: `"${relPath}"` }));
+        }
+        const absolute = path.resolve(projectRoot, safelistFile);
+        result.messages.push({
+          type: "dir-dependency",
+          plugin: "csszyx",
+          dir: path.dirname(absolute),
+          glob: path.basename(absolute),
+          parent: file
+        });
+      }
+    }
+  };
+};
+csszyxPostcss.postcss = true;
+
+export { csszyxPostcss as default };

package/dist/shared/{unplugin.NlPvn5P4.mjs → unplugin.AGR7mihU.mjs}

@@ -1,14 +1,10 @@
 import * as path from 'node:path';
 import { extractCrossModuleRegistryEntries, extractCrossModuleForwards } from '@csszyx/compiler';
+import { n as normalizePathSeparators } from './unplugin.CqJS0BbD.mjs';
 import * as fs from 'node:fs';
 import { existsSync, statSync } from 'node:fs';
 import { createHash, randomUUID } from 'node:crypto';
 
-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) {
@@ -549,4 +545,4 @@ function evictMemoryCacheToBudget(cache, totalCodeChars, maxEntries, maxCodeChar
   return total;
 }
 
-export { MAX_FORWARD_HOPS as M, resolveProviderPathWith as a, recordResolvedEntry as b, collectSpecifierAliases as c, isReadableProviderFile as d, createTransformCacheKey as e, forwardVisitKey as f, readTransformCache as g, recordSzvRegistryFile as h, importedSpecifiersIn as i, recordCrossModuleForwards as j, recordSzObjectRegistryFile as k, resolveCrossModuleStaticsFor as l, evictOldTransformCacheEntries as m, normalizePathSeparators as n, mayExportSzvFactories as o, evictMemoryCacheToBudget as p, resolveProviderPath as q, resolveTransformCacheDir as r, specifierBases as s, writeTransformCache as w };
+export { MAX_FORWARD_HOPS as M, resolveProviderPathWith as a, recordResolvedEntry as b, collectSpecifierAliases as c, isReadableProviderFile as d, createTransformCacheKey as e, forwardVisitKey as f, readTransformCache as g, evictOldTransformCacheEntries as h, importedSpecifiersIn as i, recordSzvRegistryFile as j, recordCrossModuleForwards as k, recordSzObjectRegistryFile as l, mayExportSzvFactories as m, resolveCrossModuleStaticsFor as n, resolveProviderPath as o, evictMemoryCacheToBudget as p, resolveTransformCacheDir as r, specifierBases as s, writeTransformCache as w };