@csszyx/unplugin 0.14.5 → 0.15.1

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 };