@weapp-tailwindcss/escape 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ice breaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @weapp-tailwindcss/escape
+
+> English | [简体中文](./README.zh-CN.md)
+
+Escape and unescape mini-program class names. This package is maintained in the weapp-tailwindcss monorepo and is published as `@weapp-tailwindcss/escape` with an independent version starting at 0.0.1. The implementation originates from `@weapp-core/escape@8.0.0`.
+
+```sh
+pnpm add @weapp-tailwindcss/escape
+```
+
+```ts
+import { escape, MappingChars2String, unescape } from '@weapp-tailwindcss/escape'
+
+const options = { map: MappingChars2String }
+const className = escape('hover:bg-red-500', options)
+const original = unescape(className, options)
+```
+
+Both ESM imports and CommonJS require are supported. `EscapeOptions` and `UnescapeOptions` accept `map` and `ignoreHead`; use the same options on both sides. Existing mappings and conversion semantics are unchanged by the migration.
+
+Exports include `escape`, `unescape`, `isAllowedClassName`, `isAsciiNumber`, `MappingChars2String`, `ComplexMappingChars2String`, their entry arrays, `SYMBOL_TABLE`, `MAX_ASCII_CHAR_CODE`, `toEscapeOptions`, `toUnescapeOptions`, and the corresponding TypeScript types.
+
+See [source provenance and release handover](./MIGRATION.md) and [maintenance boundaries](./AGENTS.md).

package/README.zh-CN.md

@@ -0,0 +1,23 @@
+# @weapp-tailwindcss/escape
+
+> [English](./README.md) | 简体中文
+
+小程序类名的 escape/unescape 基础包，现由 weapp-tailwindcss monorepo 维护，以 `@weapp-tailwindcss/escape` 发布，独立版本从 0.0.1 开始；实现来自 `@weapp-core/escape@8.0.0`。
+
+```sh
+pnpm add @weapp-tailwindcss/escape
+```
+
+```ts
+import { escape, MappingChars2String, unescape } from '@weapp-tailwindcss/escape'
+
+const options = { map: MappingChars2String }
+const className = escape('hover:bg-red-500', options)
+const original = unescape(className, options)
+```
+
+支持 ESM import 和 CommonJS require。`EscapeOptions`、`UnescapeOptions` 提供 `map` 和 `ignoreHead`，双向转换应使用一致配置。本次迁移保持已有映射和转换语义。
+
+导出包含 `escape`、`unescape`、`isAllowedClassName`、`isAsciiNumber`、`MappingChars2String`、`ComplexMappingChars2String` 及其 entries、`SYMBOL_TABLE`、`MAX_ASCII_CHAR_CODE`、`toEscapeOptions`、`toUnescapeOptions` 和相关 TypeScript 类型。
+
+源码来源、发布切换见[迁移记录](./MIGRATION.md)，跨包调用关系见[维护规则](./AGENTS.md)。

package/dist/index.cjs

@@ -0,0 +1,411 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/constants.ts
+const SYMBOL_TABLE = {
+	BACKQUOTE: "`",
+	TILDE: "~",
+	EXCLAM: "!",
+	AT: "@",
+	NUMBERSIGN: "#",
+	DOLLAR: "$",
+	PERCENT: "%",
+	CARET: "^",
+	AMPERSAND: "&",
+	ASTERISK: "*",
+	PARENLEFT: "(",
+	PARENRIGHT: ")",
+	MINUS: "-",
+	UNDERSCORE: "_",
+	EQUAL: "=",
+	PLUS: "+",
+	BRACKETLEFT: "[",
+	BRACELEFT: "{",
+	BRACKETRIGHT: "]",
+	BRACERIGHT: "}",
+	SEMICOLON: ";",
+	COLON: ":",
+	QUOTE: "'",
+	DOUBLEQUOTE: "\"",
+	BACKSLASH: "\\",
+	BAR: "|",
+	COMMA: ",",
+	LESS: "<",
+	PERIOD: ".",
+	GREATER: ">",
+	SLASH: "/",
+	QUESTION: "?",
+	SPACE: " ",
+	DOT: ".",
+	HASH: "#"
+};
+const ESCAPE_CHARACTER_CODES = [
+	["[", "b"],
+	["]", "B"],
+	["(", "p"],
+	[")", "P"],
+	["#", "h"],
+	["!", "e"],
+	["/", "f"],
+	["\\", "r"],
+	[".", "d"],
+	[":", "c"],
+	["%", "v"],
+	[",", "m"],
+	["'", "a"],
+	["\"", "q"],
+	["*", "x"],
+	["&", "n"],
+	["@", "t"],
+	["{", "k"],
+	["}", "K"],
+	["+", "u"],
+	[";", "j"],
+	["<", "l"],
+	["~", "w"],
+	["=", "z"],
+	[">", "g"],
+	["?", "Q"],
+	["^", "y"],
+	["`", "i"],
+	["|", "o"],
+	["$", "s"]
+];
+function buildMapping(prefix) {
+	return ESCAPE_CHARACTER_CODES.reduce((acc, [char, code]) => {
+		acc[char] = `${prefix}${code}`;
+		return acc;
+	}, {});
+}
+const SIMPLE_TOKEN_PREFIX = "_";
+const ComplexMappingChars2String = buildMapping("_c");
+const ComplexMappingChars2StringEntries = Object.entries(ComplexMappingChars2String);
+const MappingChars2String = buildMapping(SIMPLE_TOKEN_PREFIX);
+const MappingChars2StringEntries = Object.entries(MappingChars2String);
+const MAX_ASCII_CHAR_CODE = 127;
+//#endregion
+//#region src/mapping.ts
+const DEFAULT_ESCAPE_MAPPING = MappingChars2String;
+const COMPLEX_ESCAPE_MAPPING = ComplexMappingChars2String;
+new Set(Object.keys(DEFAULT_ESCAPE_MAPPING));
+const escapeMappingCache = /* @__PURE__ */ new WeakMap();
+const tokenBucketCache = /* @__PURE__ */ new WeakMap();
+const inverseMappingCache = /* @__PURE__ */ new WeakMap();
+function hasOwnKey(object, key) {
+	return Object.prototype.hasOwnProperty.call(object, key);
+}
+function createEscapeMapping(customMap) {
+	if (!customMap) return DEFAULT_ESCAPE_MAPPING;
+	if (customMap === DEFAULT_ESCAPE_MAPPING || customMap === COMPLEX_ESCAPE_MAPPING) return customMap;
+	const cached = escapeMappingCache.get(customMap);
+	if (cached) return cached;
+	if (Object.keys(customMap).length === 0) {
+		escapeMappingCache.set(customMap, DEFAULT_ESCAPE_MAPPING);
+		return DEFAULT_ESCAPE_MAPPING;
+	}
+	const merged = {
+		...DEFAULT_ESCAPE_MAPPING,
+		...customMap
+	};
+	escapeMappingCache.set(customMap, merged);
+	return merged;
+}
+function createUnescapeMapping(customMap) {
+	return customMap;
+}
+function buildInverseMapping(mapping) {
+	const inverse = {};
+	const tokens = /* @__PURE__ */ new Set();
+	for (const [key, value] of Object.entries(mapping)) {
+		inverse[value] = key;
+		tokens.add(value);
+	}
+	return {
+		inverse,
+		tokens: Array.from(tokens).sort((a, b) => b.length - a.length)
+	};
+}
+function createInverseMapping(mapping) {
+	const cached = inverseMappingCache.get(mapping);
+	if (cached) return cached;
+	const built = buildInverseMapping(mapping);
+	inverseMappingCache.set(mapping, built);
+	return built;
+}
+function createTokenBuckets(mapping, tokens) {
+	if (tokens.length === 0) return;
+	const cached = tokenBucketCache.get(mapping);
+	if (cached) return cached;
+	const buckets = tokens.reduce((acc, token) => {
+		if (!token) return acc;
+		const first = token[0];
+		if (!first) return acc;
+		const bucket = acc[first];
+		if (bucket) bucket.push(token);
+		else acc[first] = [token];
+		return acc;
+	}, {});
+	tokenBucketCache.set(mapping, buckets);
+	return buckets;
+}
+function primeInverseCache(mapping) {
+	inverseMappingCache.set(mapping, buildInverseMapping(mapping));
+}
+primeInverseCache(DEFAULT_ESCAPE_MAPPING);
+primeInverseCache(COMPLEX_ESCAPE_MAPPING);
+//#endregion
+//#region src/predicates.ts
+const DIGIT_MIN_CODE = 48;
+const DIGIT_MAX_CODE = 57;
+function isAsciiNumber(code) {
+	return code >= DIGIT_MIN_CODE && code <= DIGIT_MAX_CODE;
+}
+function isAllowedClassName(className) {
+	return /^[\w-]+$/.test(className);
+}
+//#endregion
+//#region src/escape.ts
+const HIGH_SURROGATE_MIN = 55296;
+const HIGH_SURROGATE_MAX = 56319;
+const LOW_SURROGATE_MIN = 56320;
+const LOW_SURROGATE_MAX = 57343;
+const DEFAULT_ESCAPE_TABLE = (() => {
+	const table = Array.from({ length: 128 });
+	for (const [char, token] of Object.entries(DEFAULT_ESCAPE_MAPPING)) table[char.codePointAt(0)] = token;
+	return table;
+})();
+function readCodePoint(str, index) {
+	const first = str.charCodeAt(index);
+	if (first < HIGH_SURROGATE_MIN || first > HIGH_SURROGATE_MAX || index + 1 >= str.length) return {
+		codePoint: first,
+		size: 1
+	};
+	const second = str.charCodeAt(index + 1);
+	if (second < LOW_SURROGATE_MIN || second > LOW_SURROGATE_MAX) return {
+		codePoint: first,
+		size: 1
+	};
+	return {
+		codePoint: (first - HIGH_SURROGATE_MIN << 10) + (second - LOW_SURROGATE_MIN) + 65536,
+		size: 2
+	};
+}
+function escapeLeadingCharacter(char, nextChar, ignoreHead) {
+	if (ignoreHead) return char;
+	if (isAsciiNumber(char.codePointAt(0))) return `_${char}`;
+	if (char === "-") {
+		if (!nextChar) return `_${char}`;
+		if (isAsciiNumber(nextChar.codePointAt(0))) return `_${char}`;
+	}
+	return char;
+}
+function escape(selectors, options) {
+	const length = selectors.length;
+	if (length === 0) return "";
+	const map = createEscapeMapping(options?.map);
+	const ignoreHead = options?.ignoreHead ?? false;
+	const usingDefaultMap = map === DEFAULT_ESCAPE_MAPPING;
+	let cursor = 0;
+	let lastUnchangedIndex = 0;
+	let buffer;
+	while (cursor < length) {
+		const { codePoint, size } = readCodePoint(selectors, cursor);
+		const isHead = cursor === 0;
+		let replacement;
+		if (codePoint > 127) replacement = `u_x${codePoint.toString(16)}_`;
+		else if (usingDefaultMap) {
+			if (isHead) {
+				const mapped = DEFAULT_ESCAPE_TABLE[codePoint];
+				if (mapped !== void 0) replacement = mapped;
+				else {
+					const nextIndex = cursor + size;
+					const next = nextIndex < length ? readCodePoint(selectors, nextIndex) : void 0;
+					const char = selectors[cursor];
+					const escapedHead = escapeLeadingCharacter(char, next ? selectors.slice(nextIndex, nextIndex + next.size) : void 0, ignoreHead);
+					if (escapedHead !== char) replacement = escapedHead;
+				}
+			} else {
+				const mapped = DEFAULT_ESCAPE_TABLE[codePoint];
+				if (mapped !== void 0) replacement = mapped;
+			}
+		} else {
+			const char = selectors[cursor];
+			const mapped = hasOwnKey(map, char) ? map[char] : void 0;
+			if (mapped !== void 0) replacement = mapped;
+			else if (isHead) {
+				const nextIndex = cursor + size;
+				const next = nextIndex < length ? readCodePoint(selectors, nextIndex) : void 0;
+				const escapedHead = escapeLeadingCharacter(char, next ? selectors.slice(nextIndex, nextIndex + next.size) : void 0, ignoreHead);
+				if (escapedHead !== char) replacement = escapedHead;
+			}
+		}
+		if (replacement !== void 0) {
+			if (!buffer) buffer = [];
+			if (lastUnchangedIndex !== cursor) buffer.push(selectors.slice(lastUnchangedIndex, cursor));
+			buffer.push(replacement);
+			lastUnchangedIndex = cursor + size;
+		}
+		cursor += size;
+	}
+	if (!buffer) return selectors;
+	if (lastUnchangedIndex < length) buffer.push(selectors.slice(lastUnchangedIndex));
+	return buffer.join("");
+}
+//#endregion
+//#region src/types.ts
+function toEscapeOptions(options) {
+	return options ?? {};
+}
+function toUnescapeOptions(options) {
+	return options ?? {};
+}
+//#endregion
+//#region src/unicode.ts
+const UNICODE_PREFIX = "u_x";
+const UNICODE_SUFFIX = "_";
+const HEX_RADIX = 16;
+function isHexDigit(char) {
+	const code = char.codePointAt(0);
+	return code >= 48 && code <= 57 || code >= 65 && code <= 70 || code >= 97 && code <= 102;
+}
+function decodeUnicodeSequence(value, index) {
+	if (!value.startsWith(UNICODE_PREFIX, index)) return;
+	let cursor = index + 3;
+	while (cursor < value.length) {
+		const nextChar = value[cursor];
+		if (!nextChar || !isHexDigit(nextChar)) break;
+		cursor += 1;
+	}
+	if (cursor === index + 3) return;
+	if (cursor >= value.length || value[cursor] !== UNICODE_SUFFIX) return;
+	const hex = value.slice(index + 3, cursor);
+	const codePoint = Number.parseInt(hex, HEX_RADIX);
+	if (Number.isNaN(codePoint) || codePoint <= 127 || codePoint > 1114111) return;
+	return {
+		char: String.fromCodePoint(codePoint),
+		length: cursor - index + 1
+	};
+}
+//#endregion
+//#region src/unescape.ts
+const ESCAPE_PREFIX_CODE = "_".codePointAt(0);
+const LOWER_U_CODE = "u".codePointAt(0);
+const DEFAULT_UNESCAPE_TABLE = (() => {
+	const inverse = {};
+	for (const [char, token] of Object.entries(DEFAULT_ESCAPE_MAPPING)) inverse[token] = char;
+	return inverse;
+})();
+function unescapeDefault(value, ignoreHead) {
+	const length = value.length;
+	const hasLeadingEscape = !ignoreHead && value[0] === "_";
+	const hasUnicodeMarker = value.includes("u_x");
+	if (!hasLeadingEscape && !hasUnicodeMarker) return value;
+	let cursor = 0;
+	let result = "";
+	while (cursor < length) {
+		const currentChar = value[cursor];
+		if (value.codePointAt(cursor) === LOWER_U_CODE) {
+			const decodedUnicode = decodeUnicodeSequence(value, cursor);
+			if (decodedUnicode) {
+				result += decodedUnicode.char;
+				cursor += decodedUnicode.length;
+				continue;
+			}
+		}
+		result += currentChar;
+		cursor++;
+	}
+	if (ignoreHead || result.length === 0 || !result.startsWith("_")) return result;
+	const nextChar = result[1];
+	if (!nextChar) return result.slice(1);
+	let shouldStrip = isAsciiNumber(nextChar.codePointAt(0));
+	if (!shouldStrip && nextChar === "-") {
+		const thirdChar = result[2];
+		shouldStrip = !thirdChar || isAsciiNumber(thirdChar.codePointAt(0));
+	}
+	return shouldStrip ? result.slice(1) : result;
+}
+function unescape(value, options) {
+	const length = value.length;
+	if (length === 0) return "";
+	const map = createUnescapeMapping(options?.map);
+	const ignoreHead = options?.ignoreHead ?? false;
+	if (!map) return unescapeDefault(value, ignoreHead);
+	const usingDefaultMap = map === DEFAULT_ESCAPE_MAPPING;
+	const { inverse, tokens } = usingDefaultMap ? {
+		inverse: {},
+		tokens: []
+	} : createInverseMapping(map);
+	const tokenBuckets = usingDefaultMap ? void 0 : createTokenBuckets(map, tokens);
+	let cursor = 0;
+	let lastUnchangedIndex = 0;
+	let buffer;
+	while (cursor < length) {
+		const currentCode = value.charCodeAt(cursor);
+		const currentChar = value[cursor];
+		let replacement;
+		let advance = 1;
+		if (replacement === void 0 && currentCode === LOWER_U_CODE) {
+			const decodedUnicode = decodeUnicodeSequence(value, cursor);
+			if (decodedUnicode) {
+				replacement = decodedUnicode.char;
+				advance = decodedUnicode.length;
+			}
+		}
+		if (replacement === void 0) {
+			if (usingDefaultMap && currentCode === ESCAPE_PREFIX_CODE) {
+				const mapped = DEFAULT_UNESCAPE_TABLE[value.slice(cursor, cursor + 2)];
+				if (mapped !== void 0) {
+					replacement = mapped;
+					advance = 2;
+				}
+			} else if (tokenBuckets) {
+				const bucket = tokenBuckets[currentChar];
+				if (bucket) {
+					for (const token of bucket) if (value.startsWith(token, cursor)) {
+						replacement = inverse[token];
+						advance = token.length;
+						break;
+					}
+				}
+			}
+		}
+		if (replacement !== void 0) {
+			if (!buffer) buffer = [];
+			if (lastUnchangedIndex !== cursor) buffer.push(value.slice(lastUnchangedIndex, cursor));
+			buffer.push(replacement);
+			lastUnchangedIndex = cursor + advance;
+			cursor += advance;
+			continue;
+		}
+		cursor += 1;
+	}
+	const result = buffer ? (() => {
+		if (lastUnchangedIndex < length) buffer.push(value.slice(lastUnchangedIndex));
+		return buffer.join("");
+	})() : value;
+	if (ignoreHead || result.length === 0 || !result.startsWith("_")) return result;
+	const nextChar = result[1];
+	if (!nextChar) return result.slice(1);
+	let shouldStrip = isAsciiNumber(nextChar.codePointAt(0));
+	if (!shouldStrip && nextChar === "-") {
+		const thirdChar = result[2];
+		shouldStrip = !thirdChar || isAsciiNumber(thirdChar.codePointAt(0));
+	}
+	return shouldStrip ? result.slice(1) : result;
+}
+//#endregion
+//#region src/index.ts
+const __areExportsLoaded = true;
+//#endregion
+exports.ComplexMappingChars2String = ComplexMappingChars2String;
+exports.ComplexMappingChars2StringEntries = ComplexMappingChars2StringEntries;
+exports.MAX_ASCII_CHAR_CODE = MAX_ASCII_CHAR_CODE;
+exports.MappingChars2String = MappingChars2String;
+exports.MappingChars2StringEntries = MappingChars2StringEntries;
+exports.SYMBOL_TABLE = SYMBOL_TABLE;
+exports.__areExportsLoaded = __areExportsLoaded;
+exports.escape = escape;
+exports.isAllowedClassName = isAllowedClassName;
+exports.isAsciiNumber = isAsciiNumber;
+exports.toEscapeOptions = toEscapeOptions;
+exports.toUnescapeOptions = toUnescapeOptions;
+exports.unescape = unescape;

package/dist/index.d.cts

@@ -0,0 +1,72 @@
+//#region src/constants.d.ts
+export declare const SYMBOL_TABLE: {
+  readonly BACKQUOTE: "`";
+  readonly TILDE: "~";
+  readonly EXCLAM: "!";
+  readonly AT: "@";
+  readonly NUMBERSIGN: "#";
+  readonly DOLLAR: "$";
+  readonly PERCENT: "%";
+  readonly CARET: "^";
+  readonly AMPERSAND: "&";
+  readonly ASTERISK: "*";
+  readonly PARENLEFT: "(";
+  readonly PARENRIGHT: ")";
+  readonly MINUS: "-";
+  readonly UNDERSCORE: "_";
+  readonly EQUAL: "=";
+  readonly PLUS: "+";
+  readonly BRACKETLEFT: "[";
+  readonly BRACELEFT: "{";
+  readonly BRACKETRIGHT: "]";
+  readonly BRACERIGHT: "}";
+  readonly SEMICOLON: ";";
+  readonly COLON: ":";
+  readonly QUOTE: "'";
+  readonly DOUBLEQUOTE: "\"";
+  readonly BACKSLASH: "\\";
+  readonly BAR: "|";
+  readonly COMMA: ",";
+  readonly LESS: "<";
+  readonly PERIOD: ".";
+  readonly GREATER: ">";
+  readonly SLASH: "/";
+  readonly QUESTION: "?";
+  readonly SPACE: " ";
+  readonly DOT: ".";
+  readonly HASH: "#";
+};
+export type SYMBOL_TABLE_TYPE = typeof SYMBOL_TABLE;
+export type SYMBOL_TABLE_TYPE_VALUES = SYMBOL_TABLE_TYPE[keyof SYMBOL_TABLE_TYPE];
+export type MappingStringDictionary = Record<Exclude<SYMBOL_TABLE_TYPE_VALUES, '-' | '_' | ' '>, string>;
+export declare const ComplexMappingChars2String: MappingStringDictionary;
+export declare const ComplexMappingChars2StringEntries: [string, string][];
+export declare const MappingChars2String: MappingStringDictionary;
+export declare const MappingChars2StringEntries: [string, string][];
+export declare const MAX_ASCII_CHAR_CODE = 127;
+//#endregion
+//#region src/types.d.ts
+export interface EscapeOptions {
+  map?: Record<string, string>;
+  ignoreHead?: boolean;
+}
+export interface UnescapeOptions {
+  map?: Record<string, string>;
+  ignoreHead?: boolean;
+}
+export declare function toEscapeOptions(options?: EscapeOptions): EscapeOptions;
+export declare function toUnescapeOptions(options?: UnescapeOptions): UnescapeOptions;
+//#endregion
+//#region src/escape.d.ts
+export declare function escape(selectors: string, options?: EscapeOptions): string;
+//#endregion
+//#region src/predicates.d.ts
+export declare function isAsciiNumber(code: number): boolean;
+export declare function isAllowedClassName(className: string): boolean;
+//#endregion
+//#region src/unescape.d.ts
+export declare function unescape(value: string, options?: UnescapeOptions): string;
+//#endregion
+//#region src/index.d.ts
+export declare const __areExportsLoaded = true;
+//#endregion

package/dist/index.d.mts

@@ -0,0 +1,72 @@
+//#region src/constants.d.ts
+export declare const SYMBOL_TABLE: {
+  readonly BACKQUOTE: "`";
+  readonly TILDE: "~";
+  readonly EXCLAM: "!";
+  readonly AT: "@";
+  readonly NUMBERSIGN: "#";
+  readonly DOLLAR: "$";
+  readonly PERCENT: "%";
+  readonly CARET: "^";
+  readonly AMPERSAND: "&";
+  readonly ASTERISK: "*";
+  readonly PARENLEFT: "(";
+  readonly PARENRIGHT: ")";
+  readonly MINUS: "-";
+  readonly UNDERSCORE: "_";
+  readonly EQUAL: "=";
+  readonly PLUS: "+";
+  readonly BRACKETLEFT: "[";
+  readonly BRACELEFT: "{";
+  readonly BRACKETRIGHT: "]";
+  readonly BRACERIGHT: "}";
+  readonly SEMICOLON: ";";
+  readonly COLON: ":";
+  readonly QUOTE: "'";
+  readonly DOUBLEQUOTE: "\"";
+  readonly BACKSLASH: "\\";
+  readonly BAR: "|";
+  readonly COMMA: ",";
+  readonly LESS: "<";
+  readonly PERIOD: ".";
+  readonly GREATER: ">";
+  readonly SLASH: "/";
+  readonly QUESTION: "?";
+  readonly SPACE: " ";
+  readonly DOT: ".";
+  readonly HASH: "#";
+};
+export type SYMBOL_TABLE_TYPE = typeof SYMBOL_TABLE;
+export type SYMBOL_TABLE_TYPE_VALUES = SYMBOL_TABLE_TYPE[keyof SYMBOL_TABLE_TYPE];
+export type MappingStringDictionary = Record<Exclude<SYMBOL_TABLE_TYPE_VALUES, '-' | '_' | ' '>, string>;
+export declare const ComplexMappingChars2String: MappingStringDictionary;
+export declare const ComplexMappingChars2StringEntries: [string, string][];
+export declare const MappingChars2String: MappingStringDictionary;
+export declare const MappingChars2StringEntries: [string, string][];
+export declare const MAX_ASCII_CHAR_CODE = 127;
+//#endregion
+//#region src/types.d.ts
+export interface EscapeOptions {
+  map?: Record<string, string>;
+  ignoreHead?: boolean;
+}
+export interface UnescapeOptions {
+  map?: Record<string, string>;
+  ignoreHead?: boolean;
+}
+export declare function toEscapeOptions(options?: EscapeOptions): EscapeOptions;
+export declare function toUnescapeOptions(options?: UnescapeOptions): UnescapeOptions;
+//#endregion
+//#region src/escape.d.ts
+export declare function escape(selectors: string, options?: EscapeOptions): string;
+//#endregion
+//#region src/predicates.d.ts
+export declare function isAsciiNumber(code: number): boolean;
+export declare function isAllowedClassName(className: string): boolean;
+//#endregion
+//#region src/unescape.d.ts
+export declare function unescape(value: string, options?: UnescapeOptions): string;
+//#endregion
+//#region src/index.d.ts
+export declare const __areExportsLoaded = true;
+//#endregion

package/dist/index.mjs

@@ -0,0 +1,398 @@
+//#region src/constants.ts
+const SYMBOL_TABLE = {
+	BACKQUOTE: "`",
+	TILDE: "~",
+	EXCLAM: "!",
+	AT: "@",
+	NUMBERSIGN: "#",
+	DOLLAR: "$",
+	PERCENT: "%",
+	CARET: "^",
+	AMPERSAND: "&",
+	ASTERISK: "*",
+	PARENLEFT: "(",
+	PARENRIGHT: ")",
+	MINUS: "-",
+	UNDERSCORE: "_",
+	EQUAL: "=",
+	PLUS: "+",
+	BRACKETLEFT: "[",
+	BRACELEFT: "{",
+	BRACKETRIGHT: "]",
+	BRACERIGHT: "}",
+	SEMICOLON: ";",
+	COLON: ":",
+	QUOTE: "'",
+	DOUBLEQUOTE: "\"",
+	BACKSLASH: "\\",
+	BAR: "|",
+	COMMA: ",",
+	LESS: "<",
+	PERIOD: ".",
+	GREATER: ">",
+	SLASH: "/",
+	QUESTION: "?",
+	SPACE: " ",
+	DOT: ".",
+	HASH: "#"
+};
+const ESCAPE_CHARACTER_CODES = [
+	["[", "b"],
+	["]", "B"],
+	["(", "p"],
+	[")", "P"],
+	["#", "h"],
+	["!", "e"],
+	["/", "f"],
+	["\\", "r"],
+	[".", "d"],
+	[":", "c"],
+	["%", "v"],
+	[",", "m"],
+	["'", "a"],
+	["\"", "q"],
+	["*", "x"],
+	["&", "n"],
+	["@", "t"],
+	["{", "k"],
+	["}", "K"],
+	["+", "u"],
+	[";", "j"],
+	["<", "l"],
+	["~", "w"],
+	["=", "z"],
+	[">", "g"],
+	["?", "Q"],
+	["^", "y"],
+	["`", "i"],
+	["|", "o"],
+	["$", "s"]
+];
+function buildMapping(prefix) {
+	return ESCAPE_CHARACTER_CODES.reduce((acc, [char, code]) => {
+		acc[char] = `${prefix}${code}`;
+		return acc;
+	}, {});
+}
+const SIMPLE_TOKEN_PREFIX = "_";
+const ComplexMappingChars2String = buildMapping("_c");
+const ComplexMappingChars2StringEntries = Object.entries(ComplexMappingChars2String);
+const MappingChars2String = buildMapping(SIMPLE_TOKEN_PREFIX);
+const MappingChars2StringEntries = Object.entries(MappingChars2String);
+const MAX_ASCII_CHAR_CODE = 127;
+//#endregion
+//#region src/mapping.ts
+const DEFAULT_ESCAPE_MAPPING = MappingChars2String;
+const COMPLEX_ESCAPE_MAPPING = ComplexMappingChars2String;
+new Set(Object.keys(DEFAULT_ESCAPE_MAPPING));
+const escapeMappingCache = /* @__PURE__ */ new WeakMap();
+const tokenBucketCache = /* @__PURE__ */ new WeakMap();
+const inverseMappingCache = /* @__PURE__ */ new WeakMap();
+function hasOwnKey(object, key) {
+	return Object.prototype.hasOwnProperty.call(object, key);
+}
+function createEscapeMapping(customMap) {
+	if (!customMap) return DEFAULT_ESCAPE_MAPPING;
+	if (customMap === DEFAULT_ESCAPE_MAPPING || customMap === COMPLEX_ESCAPE_MAPPING) return customMap;
+	const cached = escapeMappingCache.get(customMap);
+	if (cached) return cached;
+	if (Object.keys(customMap).length === 0) {
+		escapeMappingCache.set(customMap, DEFAULT_ESCAPE_MAPPING);
+		return DEFAULT_ESCAPE_MAPPING;
+	}
+	const merged = {
+		...DEFAULT_ESCAPE_MAPPING,
+		...customMap
+	};
+	escapeMappingCache.set(customMap, merged);
+	return merged;
+}
+function createUnescapeMapping(customMap) {
+	return customMap;
+}
+function buildInverseMapping(mapping) {
+	const inverse = {};
+	const tokens = /* @__PURE__ */ new Set();
+	for (const [key, value] of Object.entries(mapping)) {
+		inverse[value] = key;
+		tokens.add(value);
+	}
+	return {
+		inverse,
+		tokens: Array.from(tokens).sort((a, b) => b.length - a.length)
+	};
+}
+function createInverseMapping(mapping) {
+	const cached = inverseMappingCache.get(mapping);
+	if (cached) return cached;
+	const built = buildInverseMapping(mapping);
+	inverseMappingCache.set(mapping, built);
+	return built;
+}
+function createTokenBuckets(mapping, tokens) {
+	if (tokens.length === 0) return;
+	const cached = tokenBucketCache.get(mapping);
+	if (cached) return cached;
+	const buckets = tokens.reduce((acc, token) => {
+		if (!token) return acc;
+		const first = token[0];
+		if (!first) return acc;
+		const bucket = acc[first];
+		if (bucket) bucket.push(token);
+		else acc[first] = [token];
+		return acc;
+	}, {});
+	tokenBucketCache.set(mapping, buckets);
+	return buckets;
+}
+function primeInverseCache(mapping) {
+	inverseMappingCache.set(mapping, buildInverseMapping(mapping));
+}
+primeInverseCache(DEFAULT_ESCAPE_MAPPING);
+primeInverseCache(COMPLEX_ESCAPE_MAPPING);
+//#endregion
+//#region src/predicates.ts
+const DIGIT_MIN_CODE = 48;
+const DIGIT_MAX_CODE = 57;
+function isAsciiNumber(code) {
+	return code >= DIGIT_MIN_CODE && code <= DIGIT_MAX_CODE;
+}
+function isAllowedClassName(className) {
+	return /^[\w-]+$/.test(className);
+}
+//#endregion
+//#region src/escape.ts
+const HIGH_SURROGATE_MIN = 55296;
+const HIGH_SURROGATE_MAX = 56319;
+const LOW_SURROGATE_MIN = 56320;
+const LOW_SURROGATE_MAX = 57343;
+const DEFAULT_ESCAPE_TABLE = (() => {
+	const table = Array.from({ length: 128 });
+	for (const [char, token] of Object.entries(DEFAULT_ESCAPE_MAPPING)) table[char.codePointAt(0)] = token;
+	return table;
+})();
+function readCodePoint(str, index) {
+	const first = str.charCodeAt(index);
+	if (first < HIGH_SURROGATE_MIN || first > HIGH_SURROGATE_MAX || index + 1 >= str.length) return {
+		codePoint: first,
+		size: 1
+	};
+	const second = str.charCodeAt(index + 1);
+	if (second < LOW_SURROGATE_MIN || second > LOW_SURROGATE_MAX) return {
+		codePoint: first,
+		size: 1
+	};
+	return {
+		codePoint: (first - HIGH_SURROGATE_MIN << 10) + (second - LOW_SURROGATE_MIN) + 65536,
+		size: 2
+	};
+}
+function escapeLeadingCharacter(char, nextChar, ignoreHead) {
+	if (ignoreHead) return char;
+	if (isAsciiNumber(char.codePointAt(0))) return `_${char}`;
+	if (char === "-") {
+		if (!nextChar) return `_${char}`;
+		if (isAsciiNumber(nextChar.codePointAt(0))) return `_${char}`;
+	}
+	return char;
+}
+function escape(selectors, options) {
+	const length = selectors.length;
+	if (length === 0) return "";
+	const map = createEscapeMapping(options?.map);
+	const ignoreHead = options?.ignoreHead ?? false;
+	const usingDefaultMap = map === DEFAULT_ESCAPE_MAPPING;
+	let cursor = 0;
+	let lastUnchangedIndex = 0;
+	let buffer;
+	while (cursor < length) {
+		const { codePoint, size } = readCodePoint(selectors, cursor);
+		const isHead = cursor === 0;
+		let replacement;
+		if (codePoint > 127) replacement = `u_x${codePoint.toString(16)}_`;
+		else if (usingDefaultMap) {
+			if (isHead) {
+				const mapped = DEFAULT_ESCAPE_TABLE[codePoint];
+				if (mapped !== void 0) replacement = mapped;
+				else {
+					const nextIndex = cursor + size;
+					const next = nextIndex < length ? readCodePoint(selectors, nextIndex) : void 0;
+					const char = selectors[cursor];
+					const escapedHead = escapeLeadingCharacter(char, next ? selectors.slice(nextIndex, nextIndex + next.size) : void 0, ignoreHead);
+					if (escapedHead !== char) replacement = escapedHead;
+				}
+			} else {
+				const mapped = DEFAULT_ESCAPE_TABLE[codePoint];
+				if (mapped !== void 0) replacement = mapped;
+			}
+		} else {
+			const char = selectors[cursor];
+			const mapped = hasOwnKey(map, char) ? map[char] : void 0;
+			if (mapped !== void 0) replacement = mapped;
+			else if (isHead) {
+				const nextIndex = cursor + size;
+				const next = nextIndex < length ? readCodePoint(selectors, nextIndex) : void 0;
+				const escapedHead = escapeLeadingCharacter(char, next ? selectors.slice(nextIndex, nextIndex + next.size) : void 0, ignoreHead);
+				if (escapedHead !== char) replacement = escapedHead;
+			}
+		}
+		if (replacement !== void 0) {
+			if (!buffer) buffer = [];
+			if (lastUnchangedIndex !== cursor) buffer.push(selectors.slice(lastUnchangedIndex, cursor));
+			buffer.push(replacement);
+			lastUnchangedIndex = cursor + size;
+		}
+		cursor += size;
+	}
+	if (!buffer) return selectors;
+	if (lastUnchangedIndex < length) buffer.push(selectors.slice(lastUnchangedIndex));
+	return buffer.join("");
+}
+//#endregion
+//#region src/types.ts
+function toEscapeOptions(options) {
+	return options ?? {};
+}
+function toUnescapeOptions(options) {
+	return options ?? {};
+}
+//#endregion
+//#region src/unicode.ts
+const UNICODE_PREFIX = "u_x";
+const UNICODE_SUFFIX = "_";
+const HEX_RADIX = 16;
+function isHexDigit(char) {
+	const code = char.codePointAt(0);
+	return code >= 48 && code <= 57 || code >= 65 && code <= 70 || code >= 97 && code <= 102;
+}
+function decodeUnicodeSequence(value, index) {
+	if (!value.startsWith(UNICODE_PREFIX, index)) return;
+	let cursor = index + 3;
+	while (cursor < value.length) {
+		const nextChar = value[cursor];
+		if (!nextChar || !isHexDigit(nextChar)) break;
+		cursor += 1;
+	}
+	if (cursor === index + 3) return;
+	if (cursor >= value.length || value[cursor] !== UNICODE_SUFFIX) return;
+	const hex = value.slice(index + 3, cursor);
+	const codePoint = Number.parseInt(hex, HEX_RADIX);
+	if (Number.isNaN(codePoint) || codePoint <= 127 || codePoint > 1114111) return;
+	return {
+		char: String.fromCodePoint(codePoint),
+		length: cursor - index + 1
+	};
+}
+//#endregion
+//#region src/unescape.ts
+const ESCAPE_PREFIX_CODE = "_".codePointAt(0);
+const LOWER_U_CODE = "u".codePointAt(0);
+const DEFAULT_UNESCAPE_TABLE = (() => {
+	const inverse = {};
+	for (const [char, token] of Object.entries(DEFAULT_ESCAPE_MAPPING)) inverse[token] = char;
+	return inverse;
+})();
+function unescapeDefault(value, ignoreHead) {
+	const length = value.length;
+	const hasLeadingEscape = !ignoreHead && value[0] === "_";
+	const hasUnicodeMarker = value.includes("u_x");
+	if (!hasLeadingEscape && !hasUnicodeMarker) return value;
+	let cursor = 0;
+	let result = "";
+	while (cursor < length) {
+		const currentChar = value[cursor];
+		if (value.codePointAt(cursor) === LOWER_U_CODE) {
+			const decodedUnicode = decodeUnicodeSequence(value, cursor);
+			if (decodedUnicode) {
+				result += decodedUnicode.char;
+				cursor += decodedUnicode.length;
+				continue;
+			}
+		}
+		result += currentChar;
+		cursor++;
+	}
+	if (ignoreHead || result.length === 0 || !result.startsWith("_")) return result;
+	const nextChar = result[1];
+	if (!nextChar) return result.slice(1);
+	let shouldStrip = isAsciiNumber(nextChar.codePointAt(0));
+	if (!shouldStrip && nextChar === "-") {
+		const thirdChar = result[2];
+		shouldStrip = !thirdChar || isAsciiNumber(thirdChar.codePointAt(0));
+	}
+	return shouldStrip ? result.slice(1) : result;
+}
+function unescape(value, options) {
+	const length = value.length;
+	if (length === 0) return "";
+	const map = createUnescapeMapping(options?.map);
+	const ignoreHead = options?.ignoreHead ?? false;
+	if (!map) return unescapeDefault(value, ignoreHead);
+	const usingDefaultMap = map === DEFAULT_ESCAPE_MAPPING;
+	const { inverse, tokens } = usingDefaultMap ? {
+		inverse: {},
+		tokens: []
+	} : createInverseMapping(map);
+	const tokenBuckets = usingDefaultMap ? void 0 : createTokenBuckets(map, tokens);
+	let cursor = 0;
+	let lastUnchangedIndex = 0;
+	let buffer;
+	while (cursor < length) {
+		const currentCode = value.charCodeAt(cursor);
+		const currentChar = value[cursor];
+		let replacement;
+		let advance = 1;
+		if (replacement === void 0 && currentCode === LOWER_U_CODE) {
+			const decodedUnicode = decodeUnicodeSequence(value, cursor);
+			if (decodedUnicode) {
+				replacement = decodedUnicode.char;
+				advance = decodedUnicode.length;
+			}
+		}
+		if (replacement === void 0) {
+			if (usingDefaultMap && currentCode === ESCAPE_PREFIX_CODE) {
+				const mapped = DEFAULT_UNESCAPE_TABLE[value.slice(cursor, cursor + 2)];
+				if (mapped !== void 0) {
+					replacement = mapped;
+					advance = 2;
+				}
+			} else if (tokenBuckets) {
+				const bucket = tokenBuckets[currentChar];
+				if (bucket) {
+					for (const token of bucket) if (value.startsWith(token, cursor)) {
+						replacement = inverse[token];
+						advance = token.length;
+						break;
+					}
+				}
+			}
+		}
+		if (replacement !== void 0) {
+			if (!buffer) buffer = [];
+			if (lastUnchangedIndex !== cursor) buffer.push(value.slice(lastUnchangedIndex, cursor));
+			buffer.push(replacement);
+			lastUnchangedIndex = cursor + advance;
+			cursor += advance;
+			continue;
+		}
+		cursor += 1;
+	}
+	const result = buffer ? (() => {
+		if (lastUnchangedIndex < length) buffer.push(value.slice(lastUnchangedIndex));
+		return buffer.join("");
+	})() : value;
+	if (ignoreHead || result.length === 0 || !result.startsWith("_")) return result;
+	const nextChar = result[1];
+	if (!nextChar) return result.slice(1);
+	let shouldStrip = isAsciiNumber(nextChar.codePointAt(0));
+	if (!shouldStrip && nextChar === "-") {
+		const thirdChar = result[2];
+		shouldStrip = !thirdChar || isAsciiNumber(thirdChar.codePointAt(0));
+	}
+	return shouldStrip ? result.slice(1) : result;
+}
+//#endregion
+//#region src/index.ts
+const __areExportsLoaded = true;
+//#endregion
+export { ComplexMappingChars2String, ComplexMappingChars2StringEntries, MAX_ASCII_CHAR_CODE, MappingChars2String, MappingChars2StringEntries, SYMBOL_TABLE, __areExportsLoaded, escape, isAllowedClassName, isAsciiNumber, toEscapeOptions, toUnescapeOptions, unescape };

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@weapp-tailwindcss/escape",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "escape class name in weapp",
+  "author": "ice breaker <1324318532@qq.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/sonofmagic/weapp-tailwindcss/tree/main/packages/escape#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sonofmagic/weapp-tailwindcss.git",
+    "directory": "packages/escape"
+  },
+  "bugs": {
+    "url": "https://github.com/sonofmagic/weapp-tailwindcss/issues"
+  },
+  "keywords": [
+    "weapp",
+    "escape",
+    "css"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --update=none",
+    "test:dev": "vitest",
+    "test:types": "tsdown && tsd --files test/types.test-d.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false",
+    "tsd": "tsd --files test/types.test-d.ts",
+    "lint": "eslint .",
+    "test:package": "node scripts/verify-package.mjs",
+    "bench": "vitest bench --run"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "escape-published": "npm:@weapp-core/escape@8.0.0"
+  }
+}