@tailwindcss-mangle/shared 1.2.7

package/README.md

@@ -0,0 +1,23 @@
+# @tailwindcss-mangle/shared
+
+The shared utils of tailwindcss-mangle
+
+## Install
+
+```bash
+<npm|yarn|pnpm> i @tailwindcss-mangle/shared
+```
+
+## Usage
+
+### ClassGenerator
+
+the class generator of tailwindcss-mangle
+
+### escapeStringRegexp
+
+### makeRegex
+
+### splitCode
+
+### defaultMangleClassFilter

package/dist/index.cjs

@@ -0,0 +1,202 @@
+'use strict';
+
+const preserveClassNames = [
+  // https://tailwindcss.com/docs/transition-timing-function start
+  // https://github.com/sonofmagic/tailwindcss-mangle/issues/21
+  "ease-out",
+  "ease-linear",
+  "ease-in",
+  "ease-in-out"
+  // https://tailwindcss.com/docs/transition-timing-function end
+];
+const preserveClassNamesMap = preserveClassNames.reduce((acc, cur) => {
+  acc[cur] = true;
+  return acc;
+}, {});
+const defaultMangleClassFilter = (className) => {
+  if (preserveClassNamesMap[className]) {
+    return false;
+  }
+  return /[:-]/.test(className);
+};
+function groupBy(arr, cb) {
+  if (!Array.isArray(arr)) {
+    throw new TypeError("expected an array for first argument");
+  }
+  if (typeof cb !== "function") {
+    throw new TypeError("expected a function for second argument");
+  }
+  const result = {};
+  for (const item of arr) {
+    const bucketCategory = cb(item);
+    const bucket = result[bucketCategory];
+    if (Array.isArray(bucket)) {
+      result[bucketCategory].push(item);
+    } else {
+      result[bucketCategory] = [item];
+    }
+  }
+  return result;
+}
+const acceptChars = [..."abcdefghijklmnopqrstuvwxyz"];
+function stripEscapeSequence(words) {
+  return words.replaceAll("\\", "");
+}
+const validate = (opts, classGenerator) => {
+  if (!opts.log)
+    return;
+  for (const className in classGenerator.newClassMap) {
+    const c = classGenerator.newClassMap[className];
+    if (c.usedBy.length > 0) {
+      continue;
+    }
+    if (/.+\.css:*$/.test(c.usedBy[0])) {
+      console.log(`The class name '${className}' is not used: defined at ${c.usedBy[0]}.`);
+    } else {
+      console.log(`The class name '${className}' is not defined: used at ${c.usedBy[0]}.`);
+    }
+  }
+};
+function isRegexp(value) {
+  return Object.prototype.toString.call(value) === "[object RegExp]";
+}
+function isMap(value) {
+  return Object.prototype.toString.call(value) === "[object Map]";
+}
+function regExpTest(arr = [], str) {
+  if (Array.isArray(arr)) {
+    for (const item of arr) {
+      if (typeof item === "string") {
+        if (item === str) {
+          return true;
+        }
+      } else if (isRegexp(item)) {
+        item.lastIndex = 0;
+        if (item.test(str)) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+  throw new TypeError("paramater 'arr' should be a Array of Regexp | String !");
+}
+
+class ClassGenerator {
+  constructor(opts = {}) {
+    this.newClassMap = {};
+    this.newClassSize = 0;
+    this.context = {};
+    this.opts = opts;
+    this.classPrefix = opts.classPrefix ?? "tw-";
+  }
+  defaultClassGenerate() {
+    const chars = [];
+    let rest = (this.newClassSize - this.newClassSize % acceptChars.length) / acceptChars.length;
+    if (rest > 0) {
+      while (true) {
+        rest -= 1;
+        const m = rest % acceptChars.length;
+        const c = acceptChars[m];
+        chars.push(c);
+        rest -= m;
+        if (rest === 0) {
+          break;
+        }
+        rest /= acceptChars.length;
+      }
+    }
+    const prefixIndex = this.newClassSize % acceptChars.length;
+    const newClassName = `${this.classPrefix}${acceptChars[prefixIndex]}${chars.join("")}`;
+    return newClassName;
+  }
+  ignoreClassName(className) {
+    return regExpTest(this.opts.ignoreClass, className);
+  }
+  includeFilePath(filePath) {
+    const { include } = this.opts;
+    return Array.isArray(include) ? regExpTest(include, filePath) : true;
+  }
+  excludeFilePath(filePath) {
+    const { exclude } = this.opts;
+    return Array.isArray(exclude) ? regExpTest(exclude, filePath) : false;
+  }
+  isFileIncluded(filePath) {
+    return this.includeFilePath(filePath) && !this.excludeFilePath(filePath);
+  }
+  transformCssClass(className) {
+    const key = stripEscapeSequence(className);
+    const cn = this.newClassMap[key];
+    if (cn)
+      return cn.name;
+    return className;
+  }
+  generateClassName(original) {
+    const opts = this.opts;
+    original = stripEscapeSequence(original);
+    const cn = this.newClassMap[original];
+    if (cn)
+      return cn;
+    let newClassName;
+    if (opts.customGenerate && typeof opts.customGenerate === "function") {
+      newClassName = opts.customGenerate(original, opts, this.context);
+    }
+    if (!newClassName) {
+      newClassName = this.defaultClassGenerate();
+    }
+    if (opts.reserveClassName && regExpTest(opts.reserveClassName, newClassName)) {
+      if (opts.log) {
+        console.log(`The class name has been reserved. ${newClassName}`);
+      }
+      this.newClassSize++;
+      return this.generateClassName(original);
+    }
+    if (opts.log) {
+      console.log(`Minify class name from ${original} to ${newClassName}`);
+    }
+    const newClass = {
+      name: newClassName,
+      usedBy: []
+    };
+    this.newClassMap[original] = newClass;
+    this.newClassSize++;
+    return newClass;
+  }
+}
+
+function escapeStringRegexp(str) {
+  if (typeof str !== "string") {
+    throw new TypeError("Expected a string");
+  }
+  return str.replaceAll(/[$()*+.?[\\\]^{|}]/g, "\\$&").replaceAll("-", "\\x2d");
+}
+function makeRegex(str, options = {
+  exact: true
+}) {
+  return new RegExp('(?<=^|[\\s"])' + escapeStringRegexp(str) + (options.exact ? '(?=$|[\\s"])' : ""), "g");
+}
+
+const validateFilterRE = /[\w%-?\u00A0-\uFFFF-]/;
+function isValidSelector(selector = "") {
+  return validateFilterRE.test(selector);
+}
+const splitCode = (code, options = { splitQuote: true }) => {
+  const regex = options.splitQuote ? /[\s"]+/ : /\s+/;
+  return code.split(regex).filter((x) => isValidSelector(x));
+};
+
+exports.ClassGenerator = ClassGenerator;
+exports.acceptChars = acceptChars;
+exports.defaultMangleClassFilter = defaultMangleClassFilter;
+exports.escapeStringRegexp = escapeStringRegexp;
+exports.groupBy = groupBy;
+exports.isMap = isMap;
+exports.isRegexp = isRegexp;
+exports.isValidSelector = isValidSelector;
+exports.makeRegex = makeRegex;
+exports.preserveClassNames = preserveClassNames;
+exports.regExpTest = regExpTest;
+exports.splitCode = splitCode;
+exports.stripEscapeSequence = stripEscapeSequence;
+exports.validate = validate;
+exports.validateFilterRE = validateFilterRE;

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+interface IClassGeneratorContextItem {
+    name: string;
+    usedBy: any[];
+}
+interface IClassGeneratorOptions {
+    reserveClassName?: (string | RegExp)[];
+    customGenerate?: (original: string, opts: IClassGeneratorOptions, context: Record<string, any>) => string | undefined;
+    log?: boolean;
+    exclude?: (string | RegExp)[];
+    include?: (string | RegExp)[];
+    ignoreClass?: (string | RegExp)[];
+    classPrefix?: string;
+}
+interface IClassGenerator {
+    newClassMap: Record<string, IClassGeneratorContextItem>;
+    newClassSize: number;
+    context: Record<string, any>;
+}
+
+declare class ClassGenerator implements IClassGenerator {
+    newClassMap: Record<string, IClassGeneratorContextItem>;
+    newClassSize: number;
+    context: Record<string, any>;
+    opts: IClassGeneratorOptions;
+    classPrefix: string;
+    constructor(opts?: IClassGeneratorOptions);
+    defaultClassGenerate(): string;
+    ignoreClassName(className: string): boolean;
+    includeFilePath(filePath: string): boolean;
+    excludeFilePath(filePath: string): boolean;
+    isFileIncluded(filePath: string): boolean;
+    transformCssClass(className: string): string;
+    generateClassName(original: string): IClassGeneratorContextItem;
+}
+
+declare function escapeStringRegexp(str: string): string;
+declare function makeRegex(str: string, options?: {
+    exact: boolean;
+}): RegExp;
+
+declare const validateFilterRE: RegExp;
+declare function isValidSelector(selector?: string): selector is string;
+declare const splitCode: (code: string, options?: {
+    splitQuote?: boolean;
+}) => string[];
+
+declare const preserveClassNames: string[];
+declare const defaultMangleClassFilter: (className: string) => boolean;
+declare function groupBy<T>(arr: T[], cb: (arg: T) => string): Record<string, T[]>;
+declare const acceptChars: string[];
+declare function stripEscapeSequence(words: string): string;
+declare const validate: (opts: IClassGeneratorOptions, classGenerator: IClassGenerator) => void;
+declare function isRegexp(value: unknown): boolean;
+declare function isMap(value: unknown): boolean;
+declare function regExpTest(arr: (string | RegExp)[] | undefined, str: string): boolean;
+
+export { ClassGenerator, IClassGenerator, IClassGeneratorContextItem, IClassGeneratorOptions, acceptChars, defaultMangleClassFilter, escapeStringRegexp, groupBy, isMap, isRegexp, isValidSelector, makeRegex, preserveClassNames, regExpTest, splitCode, stripEscapeSequence, validate, validateFilterRE };

package/dist/index.mjs

@@ -0,0 +1,186 @@
+const preserveClassNames = [
+  // https://tailwindcss.com/docs/transition-timing-function start
+  // https://github.com/sonofmagic/tailwindcss-mangle/issues/21
+  "ease-out",
+  "ease-linear",
+  "ease-in",
+  "ease-in-out"
+  // https://tailwindcss.com/docs/transition-timing-function end
+];
+const preserveClassNamesMap = preserveClassNames.reduce((acc, cur) => {
+  acc[cur] = true;
+  return acc;
+}, {});
+const defaultMangleClassFilter = (className) => {
+  if (preserveClassNamesMap[className]) {
+    return false;
+  }
+  return /[:-]/.test(className);
+};
+function groupBy(arr, cb) {
+  if (!Array.isArray(arr)) {
+    throw new TypeError("expected an array for first argument");
+  }
+  if (typeof cb !== "function") {
+    throw new TypeError("expected a function for second argument");
+  }
+  const result = {};
+  for (const item of arr) {
+    const bucketCategory = cb(item);
+    const bucket = result[bucketCategory];
+    if (Array.isArray(bucket)) {
+      result[bucketCategory].push(item);
+    } else {
+      result[bucketCategory] = [item];
+    }
+  }
+  return result;
+}
+const acceptChars = [..."abcdefghijklmnopqrstuvwxyz"];
+function stripEscapeSequence(words) {
+  return words.replaceAll("\\", "");
+}
+const validate = (opts, classGenerator) => {
+  if (!opts.log)
+    return;
+  for (const className in classGenerator.newClassMap) {
+    const c = classGenerator.newClassMap[className];
+    if (c.usedBy.length > 0) {
+      continue;
+    }
+    if (/.+\.css:*$/.test(c.usedBy[0])) {
+      console.log(`The class name '${className}' is not used: defined at ${c.usedBy[0]}.`);
+    } else {
+      console.log(`The class name '${className}' is not defined: used at ${c.usedBy[0]}.`);
+    }
+  }
+};
+function isRegexp(value) {
+  return Object.prototype.toString.call(value) === "[object RegExp]";
+}
+function isMap(value) {
+  return Object.prototype.toString.call(value) === "[object Map]";
+}
+function regExpTest(arr = [], str) {
+  if (Array.isArray(arr)) {
+    for (const item of arr) {
+      if (typeof item === "string") {
+        if (item === str) {
+          return true;
+        }
+      } else if (isRegexp(item)) {
+        item.lastIndex = 0;
+        if (item.test(str)) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+  throw new TypeError("paramater 'arr' should be a Array of Regexp | String !");
+}
+
+class ClassGenerator {
+  constructor(opts = {}) {
+    this.newClassMap = {};
+    this.newClassSize = 0;
+    this.context = {};
+    this.opts = opts;
+    this.classPrefix = opts.classPrefix ?? "tw-";
+  }
+  defaultClassGenerate() {
+    const chars = [];
+    let rest = (this.newClassSize - this.newClassSize % acceptChars.length) / acceptChars.length;
+    if (rest > 0) {
+      while (true) {
+        rest -= 1;
+        const m = rest % acceptChars.length;
+        const c = acceptChars[m];
+        chars.push(c);
+        rest -= m;
+        if (rest === 0) {
+          break;
+        }
+        rest /= acceptChars.length;
+      }
+    }
+    const prefixIndex = this.newClassSize % acceptChars.length;
+    const newClassName = `${this.classPrefix}${acceptChars[prefixIndex]}${chars.join("")}`;
+    return newClassName;
+  }
+  ignoreClassName(className) {
+    return regExpTest(this.opts.ignoreClass, className);
+  }
+  includeFilePath(filePath) {
+    const { include } = this.opts;
+    return Array.isArray(include) ? regExpTest(include, filePath) : true;
+  }
+  excludeFilePath(filePath) {
+    const { exclude } = this.opts;
+    return Array.isArray(exclude) ? regExpTest(exclude, filePath) : false;
+  }
+  isFileIncluded(filePath) {
+    return this.includeFilePath(filePath) && !this.excludeFilePath(filePath);
+  }
+  transformCssClass(className) {
+    const key = stripEscapeSequence(className);
+    const cn = this.newClassMap[key];
+    if (cn)
+      return cn.name;
+    return className;
+  }
+  generateClassName(original) {
+    const opts = this.opts;
+    original = stripEscapeSequence(original);
+    const cn = this.newClassMap[original];
+    if (cn)
+      return cn;
+    let newClassName;
+    if (opts.customGenerate && typeof opts.customGenerate === "function") {
+      newClassName = opts.customGenerate(original, opts, this.context);
+    }
+    if (!newClassName) {
+      newClassName = this.defaultClassGenerate();
+    }
+    if (opts.reserveClassName && regExpTest(opts.reserveClassName, newClassName)) {
+      if (opts.log) {
+        console.log(`The class name has been reserved. ${newClassName}`);
+      }
+      this.newClassSize++;
+      return this.generateClassName(original);
+    }
+    if (opts.log) {
+      console.log(`Minify class name from ${original} to ${newClassName}`);
+    }
+    const newClass = {
+      name: newClassName,
+      usedBy: []
+    };
+    this.newClassMap[original] = newClass;
+    this.newClassSize++;
+    return newClass;
+  }
+}
+
+function escapeStringRegexp(str) {
+  if (typeof str !== "string") {
+    throw new TypeError("Expected a string");
+  }
+  return str.replaceAll(/[$()*+.?[\\\]^{|}]/g, "\\$&").replaceAll("-", "\\x2d");
+}
+function makeRegex(str, options = {
+  exact: true
+}) {
+  return new RegExp('(?<=^|[\\s"])' + escapeStringRegexp(str) + (options.exact ? '(?=$|[\\s"])' : ""), "g");
+}
+
+const validateFilterRE = /[\w%-?\u00A0-\uFFFF-]/;
+function isValidSelector(selector = "") {
+  return validateFilterRE.test(selector);
+}
+const splitCode = (code, options = { splitQuote: true }) => {
+  const regex = options.splitQuote ? /[\s"]+/ : /\s+/;
+  return code.split(regex).filter((x) => isValidSelector(x));
+};
+
+export { ClassGenerator, acceptChars, defaultMangleClassFilter, escapeStringRegexp, groupBy, isMap, isRegexp, isValidSelector, makeRegex, preserveClassNames, regExpTest, splitCode, stripEscapeSequence, validate, validateFilterRE };

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@tailwindcss-mangle/shared",
+  "version": "1.2.7",
+  "description": "The shared utils of tailwindcss-mangle",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*",
+        "./dist/index.d.ts"
+      ]
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "tailwindcss",
+    "patch",
+    "core",
+    "mangle",
+    "shared",
+    "utils"
+  ],
+  "author": "SonOfMagic <qq1324318532@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "homepage": "https://github.com/sonofmagic/tailwindcss-mangle",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sonofmagic/tailwindcss-mangle.git"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "test": "vitest run",
+    "test:dev": "vitest"
+  }
+}