@weapp-tailwindcss/react-native 0.2.4 → 0.2.6

package/README.md

@@ -27,12 +27,19 @@ module.exports = withWeappTailwindcss(config, {
 
 Metro scans sources, builds the exact candidate set and manifest, and connects the Babel JSX transform to the existing Expo transformer. You do not need to maintain a second `classNameSet`.
 
+`withWeappTailwindcss` accepts `projectRoot`, `input`, `css`, `manifest`, `classSet`, `sourceGlobs`, and `watchFiles`. See the [React Native / Expo configuration reference](https://tw.icebreaker.top/docs/config/react-native) for the full field list, manifest shape, and non-Expo Metro usage.
+
+On Android and iOS, the Metro integration resolves `react` and `react-native` from the app `projectRoot`. This keeps linked workspace packages from bundling a second React Native runtime that does not match the native binary. Expo's normal platform resolver remains unchanged on Web.
+
 ## Runtime model
 
 - Static `className` values compile to pre-generated StyleSheet lookups without calling `tw()` during render.
 - Dynamic class values are resolved through `tw(value)` at runtime.
 - Regular inline `style` overrides Tailwind classes, while `!important` classes override inline styles.
 - Unsupported CSS declarations are recorded in manifest `warnings` instead of producing incorrect native styles silently.
+- The compiler only emits React Native style properties it recognizes; browser-only or unknown declarations never pass through to `StyleSheet.create`.
+- `dark:`, `ios:`, `android:`, and `native:` are conditional native variants. State, responsive, structural, and other browser selector variants are reported as unsupported instead of being applied unconditionally.
+- Static StyleSheet IDs are stable across unrelated class additions and CSS value changes, so Metro CSS HMR cannot redirect an existing Babel lookup to another rule.
 
 ## Public entry points
 
@@ -45,3 +52,5 @@ This package generates React Native style manifests. It does not emit Web CSS or
 ## Documentation
 
 See the [React Native and Expo guide](https://tw.icebreaker.top/docs/quick-start/react-native-expo) for the complete setup.
+
+The repository compatibility lab reuses the 118-case Tailwind catalog across Expo Web, Android, and iOS. Run `pnpm e2e:react-native:all` for the complete gate, or use `pnpm e2e:react-native-compatibility`, `pnpm e2e:react-native:web`, `pnpm e2e:react-native:android`, and `pnpm e2e:react-native:ios` separately to reproduce its static, runtime, screenshot, and separate TSX/CSS HMR gates. Use `pnpm e2e:react-native:update` only when intentionally refreshing static evidence.

package/README.zh-CN.md

@@ -27,12 +27,19 @@ module.exports = withWeappTailwindcss(config, {
 
 Metro 会扫描源码、生成精确候选集合和 manifest，并把 Babel JSX transform 接入现有 Expo transformer。无需维护第二份 `classNameSet`。
 
+`withWeappTailwindcss` 支持 `projectRoot`、`input`、`css`、`manifest`、`classSet`、`sourceGlobs` 和 `watchFiles`。完整字段、manifest 结构和非 Expo Metro 用法见 [React Native / Expo 配置参考](https://tw.icebreaker.top/zh-cn/docs/config/react-native)。
+
+在 Android 与 iOS 上，Metro 集成会从应用 `projectRoot` 解析 `react` 和 `react-native`，避免 linked workspace 包把与原生二进制不一致的第二份 React Native runtime 打入 bundle。Web 端继续保留 Expo 原有的平台 resolver 行为。
+
 ## 运行模型
 
 - 静态 `className` 编译为预生成的 StyleSheet lookup，不在 render 中调用 `tw()`。
 - 动态 class 才通过 `tw(value)` 在运行时解析。
 - 普通 inline `style` 覆盖 Tailwind class，`!important` class 覆盖 inline style。
 - 不支持的 CSS 声明会记录在 manifest `warnings` 中，不会静默生成错误样式。
+- 编译器只输出明确识别的 React Native style 属性；浏览器专属或未知声明不会透传到 `StyleSheet.create`。
+- `dark:`、`ios:`、`android:`、`native:` 是原生条件变体；状态、响应式、结构等浏览器 selector 变体会明确报告为不支持，不会被错误地无条件应用。
+- 静态 StyleSheet ID 在无关 class 增删和 CSS 值变化时保持稳定，Metro CSS HMR 不会让已有 Babel lookup 串到其他规则。
 
 ## 公开入口
 
@@ -45,3 +52,5 @@ Metro 会扫描源码、生成精确候选集合和 manifest，并把 Babel JSX
 ## 文档
 
 完整接入说明见 [React Native / Expo 指南](https://tw.icebreaker.top/zh-cn/docs/quick-start/react-native-expo)。
+
+仓库兼容性实验室在 Expo Web、Android、iOS 三端复用同一份 118 项 Tailwind catalog。运行 `pnpm e2e:react-native:all` 可执行完整三端门禁；也可分别运行 `pnpm e2e:react-native-compatibility`、`pnpm e2e:react-native:web`、`pnpm e2e:react-native:android` 和 `pnpm e2e:react-native:ios` 复现静态、运行时、截图以及独立的 TSX/CSS HMR 门禁。只有明确要刷新静态证据时才运行 `pnpm e2e:react-native:update`。

package/dist/compiler.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+let node_crypto = require("node:crypto");
 let postcss = require("postcss");
 postcss = require_rolldown_runtime.__toESM(postcss, 1);
 //#region src/compiler.ts
@@ -61,6 +62,27 @@ const NUMERIC_PROPERTIES = /* @__PURE__ */ new Set([
 	"width",
 	"zIndex"
 ]);
+const STRING_PROPERTIES = /* @__PURE__ */ new Set([
+	"alignContent",
+	"alignItems",
+	"alignSelf",
+	"borderStyle",
+	"direction",
+	"display",
+	"flexDirection",
+	"flexWrap",
+	"fontFamily",
+	"fontStyle",
+	"fontWeight",
+	"justifyContent",
+	"overflow",
+	"position",
+	"textAlign",
+	"textDecorationLine",
+	"textDecorationStyle",
+	"textTransform",
+	"writingDirection"
+]);
 const SHORTHANDS = {
 	margin: [
 		"marginTop",
@@ -94,6 +116,45 @@ const UNSUPPORTED_PROPERTIES = /* @__PURE__ */ new Set([
 function decodeCssIdentifier(value) {
 	return value.replace(/\\([0-9a-f]{1,6})\s?/gi, (_, code) => String.fromCodePoint(Number.parseInt(code, 16))).replace(/\\(.)/g, "$1");
 }
+function splitClassName(className) {
+	const parts = [];
+	let current = "";
+	let bracketDepth = 0;
+	let escaped = false;
+	for (const character of className) {
+		if (escaped) {
+			current += character;
+			escaped = false;
+			continue;
+		}
+		if (character === "\\") {
+			current += character;
+			escaped = true;
+			continue;
+		}
+		if (character === "[") bracketDepth += 1;
+		if (character === "]") bracketDepth = Math.max(0, bracketDepth - 1);
+		if (character === ":" && bracketDepth === 0) {
+			parts.push(current);
+			current = "";
+			continue;
+		}
+		current += character;
+	}
+	parts.push(current);
+	return parts;
+}
+function baseClassName(className) {
+	return splitClassName(className).at(-1);
+}
+function unsupportedVariant(className) {
+	return splitClassName(className).slice(0, -1).find((variant) => ![
+		"dark",
+		"ios",
+		"android",
+		"native"
+	].includes(variant));
+}
 function propertyName(property) {
 	return {
 		"padding-inline": "paddingHorizontal",
@@ -115,6 +176,8 @@ function splitValue(value) {
 }
 function parseNumber(value, variables) {
 	const resolved = resolveVariables(value, variables);
+	const fraction = resolved.match(/^(-?(?:\d+\.\d+|\d+|\.\d+))\s*\/\s*(-?(?:\d+\.\d+|\d+|\.\d+))$/);
+	if (fraction && Number(fraction[2]) !== 0) return Number(fraction[1]) / Number(fraction[2]);
 	const calculated = resolved.match(/^calc\(\s*(-?(?:\d+\.\d+|\d+|\.\d+))(px|rem|em|%)?\s*\*\s*(-?(?:\d+\.\d+|\d+|\.\d+))\s*\)$/);
 	if (calculated) {
 		const base = parseNumber(`${calculated[1]}${calculated[2] ?? ""}`, variables);
@@ -210,11 +273,15 @@ function parseValue(property, value, variables) {
 		const color = resolveVariables(trimmed, variables);
 		return isColor(color) ? normalizeColor(color) : void 0;
 	}
-	if (NUMERIC_PROPERTIES.has(property)) return parseNumber(trimmed, variables);
+	if (NUMERIC_PROPERTIES.has(property)) {
+		const number = parseNumber(trimmed, variables);
+		if (property === "opacity" && typeof number === "string" && number.endsWith("%")) return Number.parseFloat(number) / 100;
+		return number;
+	}
 	if (property === "transform") return parseTransform(trimmed, variables);
 	if (property === "boxShadow") return parseShadow(trimmed, variables);
 	if (property === "display" && !["flex", "none"].includes(trimmed)) return;
-	return trimmed;
+	return STRING_PROPERTIES.has(property) ? trimmed : void 0;
 }
 function expandDeclaration(property, value, variables) {
 	if (property === "margin" || property === "padding") {
@@ -250,7 +317,7 @@ function walkClasses(selector) {
 }
 function variantForClass(className) {
 	const result = {};
-	for (const variant of className.split(":").slice(0, -1)) {
+	for (const variant of splitClassName(className).slice(0, -1)) {
 		if (variant === "dark") result.colorScheme = "dark";
 		if (variant === "ios" || variant === "android" || variant === "native") result.platform = variant;
 	}
@@ -266,7 +333,7 @@ function atRuleVariant(node) {
 }
 function addNativeVariantRules(manifest, candidates) {
 	for (const candidate of candidates) {
-		const parts = candidate.split(":");
+		const parts = splitClassName(candidate);
 		if (parts.length < 2) continue;
 		const base = parts.at(-1);
 		if (!base || manifest.rules[candidate] || !manifest.rules[base]) continue;
@@ -300,6 +367,15 @@ function addWarning(warnings, warning) {
 	if (!warnings.some((item) => item.message === warning.message && item.property === warning.property && item.className === warning.className)) warnings.push(warning);
 }
 function compileRule(rule, className, variables, warnings, order) {
+	const unsupported = unsupportedVariant(className);
+	if (unsupported) {
+		addWarning(warnings, {
+			className,
+			property: "variant",
+			message: `不支持将 ${unsupported}: 变体编译为 React Native 条件样式`
+		});
+		return [];
+	}
 	const styles = {
 		normal: {},
 		important: {}
@@ -311,8 +387,7 @@ function compileRule(rule, className, variables, warnings, order) {
 		const value = decl.value.replace(/\s*!important\s*$/i, "");
 		const expanded = expandDeclaration(property, value, variables);
 		if (!expanded || Object.values(expanded).includes(void 0)) {
-			const variableReference = /var\((--[\w-]+)/.exec(value)?.[1];
-			if (!variableReference || !variables[variableReference]) addWarning(warnings, {
+			addWarning(warnings, {
 				className,
 				property,
 				message: `不支持将 ${decl.prop}: ${value} 编译为 React Native style`
@@ -340,9 +415,9 @@ function finalizeNativeManifest(manifest) {
 	const styleSheet = {};
 	const styleEntries = {};
 	const staticLookup = {};
-	let nextId = 0;
-	for (const [className, rules] of Object.entries(manifest.rules)) for (const rule of rules) {
-		const id = rule.id ?? `s${nextId++}`;
+	for (const [className, rules] of Object.entries(manifest.rules)) for (const [index, rule] of rules.entries()) {
+		const identity = `${className}\0${index}\0${rule.colorScheme ?? ""}\0${rule.platform ?? ""}\0${rule.important ? "important" : "normal"}`;
+		const id = rule.id ?? `s${(0, node_crypto.createHash)("sha256").update(identity).digest("hex").slice(0, 12)}`;
 		rule.id = id;
 		styleSheet[id] = rule.style;
 		styleEntries[id] = rule;
@@ -379,5 +454,6 @@ function compileNativeStylesheet(css, options = {}) {
 }
 //#endregion
 exports.addNativeVariantRules = addNativeVariantRules;
+exports.baseClassName = baseClassName;
 exports.compileNativeStylesheet = compileNativeStylesheet;
 exports.finalizeNativeManifest = finalizeNativeManifest;

package/dist/compiler.d.ts

@@ -1,8 +1,9 @@
 import { o as NativeStyleManifest, t as CompileNativeStylesheetOptions } from "./types-BTxnqaRV.js";
 //#region src/compiler.d.ts
+declare function baseClassName(className: string): string | undefined;
 declare function addNativeVariantRules(manifest: NativeStyleManifest, candidates: Iterable<string>): void;
 /** 为 manifest 生成稳定的 StyleSheet ID 和 Babel 静态 lookup。 */
 declare function finalizeNativeManifest(manifest: NativeStyleManifest): NativeStyleManifest;
 declare function compileNativeStylesheet(css: string, options?: CompileNativeStylesheetOptions): NativeStyleManifest;
 //#endregion
-export { addNativeVariantRules, compileNativeStylesheet, finalizeNativeManifest };
+export { addNativeVariantRules, baseClassName, compileNativeStylesheet, finalizeNativeManifest };

package/dist/compiler.js

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import postcss from "postcss";
 //#region src/compiler.ts
 const CLASS_SELECTOR_RE = /\.((?:\\.|[^\s.#:[>+~])+)/g;
@@ -58,6 +59,27 @@ const NUMERIC_PROPERTIES = /* @__PURE__ */ new Set([
 	"width",
 	"zIndex"
 ]);
+const STRING_PROPERTIES = /* @__PURE__ */ new Set([
+	"alignContent",
+	"alignItems",
+	"alignSelf",
+	"borderStyle",
+	"direction",
+	"display",
+	"flexDirection",
+	"flexWrap",
+	"fontFamily",
+	"fontStyle",
+	"fontWeight",
+	"justifyContent",
+	"overflow",
+	"position",
+	"textAlign",
+	"textDecorationLine",
+	"textDecorationStyle",
+	"textTransform",
+	"writingDirection"
+]);
 const SHORTHANDS = {
 	margin: [
 		"marginTop",
@@ -91,6 +113,45 @@ const UNSUPPORTED_PROPERTIES = /* @__PURE__ */ new Set([
 function decodeCssIdentifier(value) {
 	return value.replace(/\\([0-9a-f]{1,6})\s?/gi, (_, code) => String.fromCodePoint(Number.parseInt(code, 16))).replace(/\\(.)/g, "$1");
 }
+function splitClassName(className) {
+	const parts = [];
+	let current = "";
+	let bracketDepth = 0;
+	let escaped = false;
+	for (const character of className) {
+		if (escaped) {
+			current += character;
+			escaped = false;
+			continue;
+		}
+		if (character === "\\") {
+			current += character;
+			escaped = true;
+			continue;
+		}
+		if (character === "[") bracketDepth += 1;
+		if (character === "]") bracketDepth = Math.max(0, bracketDepth - 1);
+		if (character === ":" && bracketDepth === 0) {
+			parts.push(current);
+			current = "";
+			continue;
+		}
+		current += character;
+	}
+	parts.push(current);
+	return parts;
+}
+function baseClassName(className) {
+	return splitClassName(className).at(-1);
+}
+function unsupportedVariant(className) {
+	return splitClassName(className).slice(0, -1).find((variant) => ![
+		"dark",
+		"ios",
+		"android",
+		"native"
+	].includes(variant));
+}
 function propertyName(property) {
 	return {
 		"padding-inline": "paddingHorizontal",
@@ -112,6 +173,8 @@ function splitValue(value) {
 }
 function parseNumber(value, variables) {
 	const resolved = resolveVariables(value, variables);
+	const fraction = resolved.match(/^(-?(?:\d+\.\d+|\d+|\.\d+))\s*\/\s*(-?(?:\d+\.\d+|\d+|\.\d+))$/);
+	if (fraction && Number(fraction[2]) !== 0) return Number(fraction[1]) / Number(fraction[2]);
 	const calculated = resolved.match(/^calc\(\s*(-?(?:\d+\.\d+|\d+|\.\d+))(px|rem|em|%)?\s*\*\s*(-?(?:\d+\.\d+|\d+|\.\d+))\s*\)$/);
 	if (calculated) {
 		const base = parseNumber(`${calculated[1]}${calculated[2] ?? ""}`, variables);
@@ -207,11 +270,15 @@ function parseValue(property, value, variables) {
 		const color = resolveVariables(trimmed, variables);
 		return isColor(color) ? normalizeColor(color) : void 0;
 	}
-	if (NUMERIC_PROPERTIES.has(property)) return parseNumber(trimmed, variables);
+	if (NUMERIC_PROPERTIES.has(property)) {
+		const number = parseNumber(trimmed, variables);
+		if (property === "opacity" && typeof number === "string" && number.endsWith("%")) return Number.parseFloat(number) / 100;
+		return number;
+	}
 	if (property === "transform") return parseTransform(trimmed, variables);
 	if (property === "boxShadow") return parseShadow(trimmed, variables);
 	if (property === "display" && !["flex", "none"].includes(trimmed)) return;
-	return trimmed;
+	return STRING_PROPERTIES.has(property) ? trimmed : void 0;
 }
 function expandDeclaration(property, value, variables) {
 	if (property === "margin" || property === "padding") {
@@ -247,7 +314,7 @@ function walkClasses(selector) {
 }
 function variantForClass(className) {
 	const result = {};
-	for (const variant of className.split(":").slice(0, -1)) {
+	for (const variant of splitClassName(className).slice(0, -1)) {
 		if (variant === "dark") result.colorScheme = "dark";
 		if (variant === "ios" || variant === "android" || variant === "native") result.platform = variant;
 	}
@@ -263,7 +330,7 @@ function atRuleVariant(node) {
 }
 function addNativeVariantRules(manifest, candidates) {
 	for (const candidate of candidates) {
-		const parts = candidate.split(":");
+		const parts = splitClassName(candidate);
 		if (parts.length < 2) continue;
 		const base = parts.at(-1);
 		if (!base || manifest.rules[candidate] || !manifest.rules[base]) continue;
@@ -297,6 +364,15 @@ function addWarning(warnings, warning) {
 	if (!warnings.some((item) => item.message === warning.message && item.property === warning.property && item.className === warning.className)) warnings.push(warning);
 }
 function compileRule(rule, className, variables, warnings, order) {
+	const unsupported = unsupportedVariant(className);
+	if (unsupported) {
+		addWarning(warnings, {
+			className,
+			property: "variant",
+			message: `不支持将 ${unsupported}: 变体编译为 React Native 条件样式`
+		});
+		return [];
+	}
 	const styles = {
 		normal: {},
 		important: {}
@@ -308,8 +384,7 @@ function compileRule(rule, className, variables, warnings, order) {
 		const value = decl.value.replace(/\s*!important\s*$/i, "");
 		const expanded = expandDeclaration(property, value, variables);
 		if (!expanded || Object.values(expanded).includes(void 0)) {
-			const variableReference = /var\((--[\w-]+)/.exec(value)?.[1];
-			if (!variableReference || !variables[variableReference]) addWarning(warnings, {
+			addWarning(warnings, {
 				className,
 				property,
 				message: `不支持将 ${decl.prop}: ${value} 编译为 React Native style`
@@ -337,9 +412,9 @@ function finalizeNativeManifest(manifest) {
 	const styleSheet = {};
 	const styleEntries = {};
 	const staticLookup = {};
-	let nextId = 0;
-	for (const [className, rules] of Object.entries(manifest.rules)) for (const rule of rules) {
-		const id = rule.id ?? `s${nextId++}`;
+	for (const [className, rules] of Object.entries(manifest.rules)) for (const [index, rule] of rules.entries()) {
+		const identity = `${className}\0${index}\0${rule.colorScheme ?? ""}\0${rule.platform ?? ""}\0${rule.important ? "important" : "normal"}`;
+		const id = rule.id ?? `s${createHash("sha256").update(identity).digest("hex").slice(0, 12)}`;
 		rule.id = id;
 		styleSheet[id] = rule.style;
 		styleEntries[id] = rule;
@@ -375,4 +450,4 @@ function compileNativeStylesheet(css, options = {}) {
 	});
 }
 //#endregion
-export { addNativeVariantRules, compileNativeStylesheet, finalizeNativeManifest };
+export { addNativeVariantRules, baseClassName, compileNativeStylesheet, finalizeNativeManifest };

package/dist/env.cjs

@@ -1 +0,0 @@
-require("react-native");

package/dist/env.d.ts

@@ -1,4 +1,3 @@
-import "react-native";
 //#region src/env.d.ts
 /** 供业务组件复用的 React Native className 属性。 */
 interface NativeClassNameProps {

package/dist/env.js

@@ -1,2 +1 @@
-import "react-native";
 export {};

package/dist/metro-transformer.cjs

@@ -4,27 +4,35 @@ const require_babel = require("./babel.cjs");
 const require_metro = require("./metro.cjs");
 let node_fs = require("node:fs");
 node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
 let node_module = require("node:module");
 let _babel_core = require("@babel/core");
 //#region src/metro-transformer.ts
 const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
 async function transform(config, projectRoot, filename, data, options) {
 	const virtualCode = await require_metro.getVirtualModuleCodeAsync(filename);
-	if (virtualCode) return {
-		output: [{
-			type: "js/module",
-			data: {
-				code: virtualCode,
-				map: null
-			}
-		}],
-		dependencies: []
-	};
 	const metroId = config.weappTailwindcssMetroId;
 	const manifestPath = config.weappTailwindcssManifestPath;
-	const manifest = (metroId ? await require_metro.getRegisteredManifest(metroId) : void 0) ?? (manifestPath ? readManifest(manifestPath) : void 0);
-	let source = data;
-	if (manifest && /\.(?:[cm]?[jt]sx?|flow)$/i.test(filename) && !filename.replaceAll("\\", "/").includes("/node_modules/")) {
+	const manifestReadyPath = config.weappTailwindcssManifestReadyPath;
+	const virtualModulePath = config.weappTailwindcssVirtualModulePath;
+	const projectManifestPaths = require_metro.getManifestPathsForProjectRoot(projectRoot);
+	const manifest = (metroId ? await require_metro.getRegisteredManifest(metroId) : void 0) ?? (manifestPath ? await require_metro.getRegisteredManifestByPath(manifestPath) : void 0) ?? await require_metro.getRegisteredManifestByProjectRoot(projectRoot) ?? await readManifest(manifestPath ?? projectManifestPaths.manifestPath, manifestReadyPath ?? projectManifestPaths.manifestReadyPath);
+	if (node_process.default.env.WEAPP_TW_RN_DEBUG === "1" && !filename.replaceAll("\\", "/").includes("/node_modules/")) console.error(`[react-native-debug] ${JSON.stringify({
+		filename,
+		projectRoot,
+		configKeys: Object.keys(config).filter((key) => key.startsWith("weappTailwindcss")),
+		manifestPath,
+		manifestReadyPath,
+		virtualModulePath,
+		virtualCode: Boolean(virtualCode),
+		manifestClasses: manifest?.classSet.length ?? null,
+		manifestReady: manifestReadyPath ? node_fs.default.existsSync(manifestReadyPath) : null,
+		inputBytes: data.byteLength
+	})}`);
+	let source = virtualCode ? Buffer.from(virtualCode) : data;
+	if (!virtualCode && manifest && virtualModulePath === filename) source = Buffer.from(node_fs.default.readFileSync(filename));
+	if (!virtualCode && manifest && /\.(?:[cm]?[jt]sx?|flow)$/i.test(filename) && !filename.replaceAll("\\", "/").includes("/node_modules/")) {
 		const transformed = (0, _babel_core.transformSync)(data.toString(), {
 			filename,
 			configFile: false,
@@ -41,9 +49,18 @@ async function transform(config, projectRoot, filename, data, options) {
 	const originalPath = config.weappTailwindcssOriginalTransformerPath;
 	return (originalPath ? require$1(originalPath) : require$1("metro-react-native-babel-transformer")).transform(config, projectRoot, filename, source, options);
 }
-function readManifest(filename) {
+async function readManifest(filename, readyPath) {
+	if (readyPath) {
+		const deadline = Date.now() + 12e4;
+		while (Date.now() < deadline) try {
+			await node_fs.default.promises.access(readyPath);
+			break;
+		} catch {
+			await new Promise((resolve) => setTimeout(resolve, 25));
+		}
+	}
 	try {
-		return JSON.parse(node_fs.default.readFileSync(filename, "utf8"));
+		return JSON.parse(await node_fs.default.promises.readFile(filename, "utf8"));
 	} catch {
 		return;
 	}

package/dist/metro-transformer.js

@@ -1,27 +1,34 @@
 import weappReactNativeBabel from "./babel.js";
-import { getRegisteredManifest, getVirtualModuleCodeAsync } from "./metro.js";
+import { getManifestPathsForProjectRoot, getRegisteredManifest, getRegisteredManifestByPath, getRegisteredManifestByProjectRoot, getVirtualModuleCodeAsync } from "./metro.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
+import process from "node:process";
 import { transformSync } from "@babel/core";
 //#region src/metro-transformer.ts
 const require = createRequire(import.meta.url);
 async function transform(config, projectRoot, filename, data, options) {
 	const virtualCode = await getVirtualModuleCodeAsync(filename);
-	if (virtualCode) return {
-		output: [{
-			type: "js/module",
-			data: {
-				code: virtualCode,
-				map: null
-			}
-		}],
-		dependencies: []
-	};
 	const metroId = config.weappTailwindcssMetroId;
 	const manifestPath = config.weappTailwindcssManifestPath;
-	const manifest = (metroId ? await getRegisteredManifest(metroId) : void 0) ?? (manifestPath ? readManifest(manifestPath) : void 0);
-	let source = data;
-	if (manifest && /\.(?:[cm]?[jt]sx?|flow)$/i.test(filename) && !filename.replaceAll("\\", "/").includes("/node_modules/")) {
+	const manifestReadyPath = config.weappTailwindcssManifestReadyPath;
+	const virtualModulePath = config.weappTailwindcssVirtualModulePath;
+	const projectManifestPaths = getManifestPathsForProjectRoot(projectRoot);
+	const manifest = (metroId ? await getRegisteredManifest(metroId) : void 0) ?? (manifestPath ? await getRegisteredManifestByPath(manifestPath) : void 0) ?? await getRegisteredManifestByProjectRoot(projectRoot) ?? await readManifest(manifestPath ?? projectManifestPaths.manifestPath, manifestReadyPath ?? projectManifestPaths.manifestReadyPath);
+	if (process.env.WEAPP_TW_RN_DEBUG === "1" && !filename.replaceAll("\\", "/").includes("/node_modules/")) console.error(`[react-native-debug] ${JSON.stringify({
+		filename,
+		projectRoot,
+		configKeys: Object.keys(config).filter((key) => key.startsWith("weappTailwindcss")),
+		manifestPath,
+		manifestReadyPath,
+		virtualModulePath,
+		virtualCode: Boolean(virtualCode),
+		manifestClasses: manifest?.classSet.length ?? null,
+		manifestReady: manifestReadyPath ? fs.existsSync(manifestReadyPath) : null,
+		inputBytes: data.byteLength
+	})}`);
+	let source = virtualCode ? Buffer.from(virtualCode) : data;
+	if (!virtualCode && manifest && virtualModulePath === filename) source = Buffer.from(fs.readFileSync(filename));
+	if (!virtualCode && manifest && /\.(?:[cm]?[jt]sx?|flow)$/i.test(filename) && !filename.replaceAll("\\", "/").includes("/node_modules/")) {
 		const transformed = transformSync(data.toString(), {
 			filename,
 			configFile: false,
@@ -38,9 +45,18 @@ async function transform(config, projectRoot, filename, data, options) {
 	const originalPath = config.weappTailwindcssOriginalTransformerPath;
 	return (originalPath ? require(originalPath) : require("metro-react-native-babel-transformer")).transform(config, projectRoot, filename, source, options);
 }
-function readManifest(filename) {
+async function readManifest(filename, readyPath) {
+	if (readyPath) {
+		const deadline = Date.now() + 12e4;
+		while (Date.now() < deadline) try {
+			await fs.promises.access(readyPath);
+			break;
+		} catch {
+			await new Promise((resolve) => setTimeout(resolve, 25));
+		}
+	}
 	try {
-		return JSON.parse(fs.readFileSync(filename, "utf8"));
+		return JSON.parse(await fs.promises.readFile(filename, "utf8"));
 	} catch {
 		return;
 	}

package/dist/metro.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
 const require_compiler = require("./compiler.cjs");
+let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
 let node_os = require("node:os");
@@ -13,7 +14,24 @@ let node_url = require("node:url");
 //#region src/metro.ts
 const VIRTUAL_MANIFEST_MODULE = "@weapp-tailwindcss/react-native/virtual";
 const registry = /* @__PURE__ */ new Map();
+const appRootSingletonModules = /* @__PURE__ */ new Set(["react", "react-native"]);
 let nextId = 0;
+function packageNameFromModuleId(moduleName) {
+	const segments = moduleName.split("/");
+	return moduleName.startsWith("@") ? segments.slice(0, 2).join("/") : segments[0];
+}
+function shouldResolveFromAppRoot(moduleName, platform) {
+	return platform !== "web" && appRootSingletonModules.has(packageNameFromModuleId(moduleName));
+}
+/** 为 Metro worker 提供不依赖进程内 registry 的 manifest 入口。 */
+function getManifestPathsForProjectRoot(projectRoot) {
+	const projectKey = (0, node_crypto.createHash)("sha256").update(node_path.default.resolve(projectRoot)).digest("hex").slice(0, 24);
+	const base = node_path.default.join(node_os.default.tmpdir(), "weapp-tailwindcss-native", `project-${projectKey}`);
+	return {
+		manifestPath: `${base}.manifest.json`,
+		manifestReadyPath: `${base}.manifest.ready`
+	};
+}
 function resolveInput(input, projectRoot) {
 	return input ? node_path.default.resolve(projectRoot, input) : void 0;
 }
@@ -34,6 +52,12 @@ function writeVirtualModule(entry) {
 	node_fs.default.writeFileSync(entry.virtualPath, virtualModuleCode(entry.manifest), "utf8");
 	node_fs.default.writeFileSync(entry.manifestPath, JSON.stringify(entry.manifest), "utf8");
 }
+function markManifestPending(entry) {
+	node_fs.default.rmSync(entry.manifestReadyPath, { force: true });
+}
+function markManifestReady(entry) {
+	node_fs.default.writeFileSync(entry.manifestReadyPath, `${entry.version}\n`, "utf8");
+}
 async function compileOptions(options, projectRoot) {
 	if (options.manifest) return options.manifest;
 	if (options.input) {
@@ -50,28 +74,38 @@ async function compileOptions(options, projectRoot) {
 function register(options) {
 	const id = `weapp-tailwindcss-native-${nextId++}`;
 	const projectRoot = node_path.default.resolve(options.projectRoot ?? node_process.default.cwd());
+	const manifestPaths = getManifestPathsForProjectRoot(projectRoot);
 	const entry = {
 		version: 0,
 		manifest: options.manifest ?? (options.css ? require_compiler.compileNativeStylesheet(options.css, { classSet: options.classSet }) : emptyManifest()),
+		projectRoot,
 		virtualPath: node_path.default.join(node_os.default.tmpdir(), "weapp-tailwindcss-native", `${id}.js`),
-		manifestPath: node_path.default.join(node_os.default.tmpdir(), "weapp-tailwindcss-native", `${id}.manifest.json`),
+		manifestPath: manifestPaths.manifestPath,
+		manifestReadyPath: manifestPaths.manifestReadyPath,
 		ready: Promise.resolve(),
 		refresh: async () => {}
 	};
 	registry.set(id, entry);
+	markManifestPending(entry);
 	writeVirtualModule(entry);
 	let generation = 0;
 	entry.refresh = async () => {
 		const currentGeneration = ++generation;
+		markManifestPending(entry);
 		const manifest = await compileOptions(options, projectRoot);
 		if (currentGeneration === generation) {
 			entry.manifest = manifest;
 			entry.version++;
 			writeVirtualModule(entry);
+			markManifestReady(entry);
 		}
 	};
 	entry.ready = entry.refresh().catch((error) => {
-		entry.manifest.warnings.push({ message: `生成 React Native manifest 失败：${error instanceof Error ? error.message : String(error)}` });
+		const message = `生成 React Native manifest 失败：${error instanceof Error ? error.message : String(error)}`;
+		entry.manifest.warnings.push({ message });
+		if (node_process.default.env.WEAPP_TW_RN_DEBUG === "1") console.error(`[react-native-debug] ${message}`);
+		writeVirtualModule(entry);
+		markManifestReady(entry);
 	});
 	const sourceRoots = (options.sourceGlobs ?? []).map((pattern) => pattern.split(/[*{[]/, 1)[0]?.replace(/[/\\]$/, "")).filter(Boolean);
 	[
@@ -106,6 +140,21 @@ async function getRegisteredManifest(id) {
 	await registered.ready;
 	return registered.manifest;
 }
+/** 等待并读取由 Metro 配置注册的 manifest 文件，兼容未透传自定义 Metro id 的 transformer。 */
+async function getRegisteredManifestByPath(filename) {
+	for (const entry of registry.values()) if (entry.manifestPath === filename) {
+		await entry.ready;
+		return entry.manifest;
+	}
+}
+/** 按 Metro 传入的项目根目录读取当前注册项，兼容 transformer 未透传自定义字段的实现。 */
+async function getRegisteredManifestByProjectRoot(projectRoot) {
+	const resolvedRoot = node_path.default.resolve(projectRoot);
+	const entry = [...registry.values()].filter((entry) => entry.projectRoot === resolvedRoot).at(-1);
+	if (!entry) return;
+	await entry.ready;
+	return entry.manifest;
+}
 function getVirtualModuleCode(filename) {
 	const registered = getRegisteredVirtualModule(filename);
 	if (!registered) return;
@@ -128,7 +177,12 @@ function withWeappTailwindcss(config, options = {}) {
 			type: "sourceFile",
 			filePath: entry.virtualPath
 		};
-		return originalResolver?.(context, moduleName, platform) ?? context.resolveRequest?.(context, moduleName, platform);
+		const resolverContext = context;
+		const anchoredContext = resolverContext.originModulePath === entry.virtualPath || shouldResolveFromAppRoot(moduleName, platform) ? {
+			...resolverContext,
+			originModulePath: node_path.default.join(entry.projectRoot, "package.json")
+		} : resolverContext;
+		return originalResolver?.(anchoredContext, moduleName, platform) ?? resolverContext.resolveRequest?.(anchoredContext, moduleName, platform);
 	};
 	return {
 		...resolvedConfig,
@@ -138,7 +192,9 @@ function withWeappTailwindcss(config, options = {}) {
 			...resolvedConfig.transformer,
 			weappTailwindcssMetroId: id,
 			weappTailwindcssOriginalTransformerPath: resolvedConfig.transformerPath,
-			weappTailwindcssManifestPath: entry.manifestPath
+			weappTailwindcssManifestPath: entry.manifestPath,
+			weappTailwindcssManifestReadyPath: entry.manifestReadyPath,
+			weappTailwindcssVirtualModulePath: entry.virtualPath
 		},
 		resolver: {
 			...resolvedConfig.resolver,
@@ -149,7 +205,10 @@ function withWeappTailwindcss(config, options = {}) {
 }
 //#endregion
 exports.VIRTUAL_MANIFEST_MODULE = VIRTUAL_MANIFEST_MODULE;
+exports.getManifestPathsForProjectRoot = getManifestPathsForProjectRoot;
 exports.getRegisteredManifest = getRegisteredManifest;
+exports.getRegisteredManifestByPath = getRegisteredManifestByPath;
+exports.getRegisteredManifestByProjectRoot = getRegisteredManifestByProjectRoot;
 exports.getRegisteredVirtualModule = getRegisteredVirtualModule;
 exports.getVirtualModuleCode = getVirtualModuleCode;
 exports.getVirtualModuleCodeAsync = getVirtualModuleCodeAsync;

package/dist/metro.d.ts

@@ -25,15 +25,27 @@ interface WeappReactNativeMetroOptions {
 interface RegisteredManifest {
   version: number;
   manifest: NativeStyleManifest;
+  projectRoot: string;
   virtualPath: string;
   manifestPath: string;
+  manifestReadyPath: string;
   ready: Promise<void>;
   refresh: () => Promise<void>;
 }
+interface NativeManifestPaths {
+  manifestPath: string;
+  manifestReadyPath: string;
+}
+/** 为 Metro worker 提供不依赖进程内 registry 的 manifest 入口。 */
+declare function getManifestPathsForProjectRoot(projectRoot: string): NativeManifestPaths;
 declare function getRegisteredVirtualModule(filename: string): RegisteredManifest | undefined;
 declare function getRegisteredManifest(id: string): Promise<NativeStyleManifest | undefined>;
+/** 等待并读取由 Metro 配置注册的 manifest 文件，兼容未透传自定义 Metro id 的 transformer。 */
+declare function getRegisteredManifestByPath(filename: string): Promise<NativeStyleManifest | undefined>;
+/** 按 Metro 传入的项目根目录读取当前注册项，兼容 transformer 未透传自定义字段的实现。 */
+declare function getRegisteredManifestByProjectRoot(projectRoot: string): Promise<NativeStyleManifest | undefined>;
 declare function getVirtualModuleCode(filename: string): string | undefined;
 declare function getVirtualModuleCodeAsync(filename: string): Promise<string | undefined>;
 declare function withWeappTailwindcss<T extends MetroConfigLike>(config: T | Promise<T> | (() => T | Promise<T>), options?: WeappReactNativeMetroOptions): T | Promise<T>;
 //#endregion
-export { MetroConfigLike, VIRTUAL_MANIFEST_MODULE, WeappReactNativeMetroOptions, getRegisteredManifest, getRegisteredVirtualModule, getVirtualModuleCode, getVirtualModuleCodeAsync, withWeappTailwindcss };
+export { MetroConfigLike, NativeManifestPaths, VIRTUAL_MANIFEST_MODULE, WeappReactNativeMetroOptions, getManifestPathsForProjectRoot, getRegisteredManifest, getRegisteredManifestByPath, getRegisteredManifestByProjectRoot, getRegisteredVirtualModule, getVirtualModuleCode, getVirtualModuleCodeAsync, withWeappTailwindcss };

package/dist/metro.js

@@ -1,4 +1,5 @@
 import { compileNativeStylesheet } from "./compiler.js";
+import { createHash } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -7,7 +8,24 @@ import { fileURLToPath } from "node:url";
 //#region src/metro.ts
 const VIRTUAL_MANIFEST_MODULE = "@weapp-tailwindcss/react-native/virtual";
 const registry = /* @__PURE__ */ new Map();
+const appRootSingletonModules = /* @__PURE__ */ new Set(["react", "react-native"]);
 let nextId = 0;
+function packageNameFromModuleId(moduleName) {
+	const segments = moduleName.split("/");
+	return moduleName.startsWith("@") ? segments.slice(0, 2).join("/") : segments[0];
+}
+function shouldResolveFromAppRoot(moduleName, platform) {
+	return platform !== "web" && appRootSingletonModules.has(packageNameFromModuleId(moduleName));
+}
+/** 为 Metro worker 提供不依赖进程内 registry 的 manifest 入口。 */
+function getManifestPathsForProjectRoot(projectRoot) {
+	const projectKey = createHash("sha256").update(path.resolve(projectRoot)).digest("hex").slice(0, 24);
+	const base = path.join(os.tmpdir(), "weapp-tailwindcss-native", `project-${projectKey}`);
+	return {
+		manifestPath: `${base}.manifest.json`,
+		manifestReadyPath: `${base}.manifest.ready`
+	};
+}
 function resolveInput(input, projectRoot) {
 	return input ? path.resolve(projectRoot, input) : void 0;
 }
@@ -28,6 +46,12 @@ function writeVirtualModule(entry) {
 	fs.writeFileSync(entry.virtualPath, virtualModuleCode(entry.manifest), "utf8");
 	fs.writeFileSync(entry.manifestPath, JSON.stringify(entry.manifest), "utf8");
 }
+function markManifestPending(entry) {
+	fs.rmSync(entry.manifestReadyPath, { force: true });
+}
+function markManifestReady(entry) {
+	fs.writeFileSync(entry.manifestReadyPath, `${entry.version}\n`, "utf8");
+}
 async function compileOptions(options, projectRoot) {
 	if (options.manifest) return options.manifest;
 	if (options.input) {
@@ -44,28 +68,38 @@ async function compileOptions(options, projectRoot) {
 function register(options) {
 	const id = `weapp-tailwindcss-native-${nextId++}`;
 	const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+	const manifestPaths = getManifestPathsForProjectRoot(projectRoot);
 	const entry = {
 		version: 0,
 		manifest: options.manifest ?? (options.css ? compileNativeStylesheet(options.css, { classSet: options.classSet }) : emptyManifest()),
+		projectRoot,
 		virtualPath: path.join(os.tmpdir(), "weapp-tailwindcss-native", `${id}.js`),
-		manifestPath: path.join(os.tmpdir(), "weapp-tailwindcss-native", `${id}.manifest.json`),
+		manifestPath: manifestPaths.manifestPath,
+		manifestReadyPath: manifestPaths.manifestReadyPath,
 		ready: Promise.resolve(),
 		refresh: async () => {}
 	};
 	registry.set(id, entry);
+	markManifestPending(entry);
 	writeVirtualModule(entry);
 	let generation = 0;
 	entry.refresh = async () => {
 		const currentGeneration = ++generation;
+		markManifestPending(entry);
 		const manifest = await compileOptions(options, projectRoot);
 		if (currentGeneration === generation) {
 			entry.manifest = manifest;
 			entry.version++;
 			writeVirtualModule(entry);
+			markManifestReady(entry);
 		}
 	};
 	entry.ready = entry.refresh().catch((error) => {
-		entry.manifest.warnings.push({ message: `生成 React Native manifest 失败：${error instanceof Error ? error.message : String(error)}` });
+		const message = `生成 React Native manifest 失败：${error instanceof Error ? error.message : String(error)}`;
+		entry.manifest.warnings.push({ message });
+		if (process.env.WEAPP_TW_RN_DEBUG === "1") console.error(`[react-native-debug] ${message}`);
+		writeVirtualModule(entry);
+		markManifestReady(entry);
 	});
 	const sourceRoots = (options.sourceGlobs ?? []).map((pattern) => pattern.split(/[*{[]/, 1)[0]?.replace(/[/\\]$/, "")).filter(Boolean);
 	[
@@ -100,6 +134,21 @@ async function getRegisteredManifest(id) {
 	await registered.ready;
 	return registered.manifest;
 }
+/** 等待并读取由 Metro 配置注册的 manifest 文件，兼容未透传自定义 Metro id 的 transformer。 */
+async function getRegisteredManifestByPath(filename) {
+	for (const entry of registry.values()) if (entry.manifestPath === filename) {
+		await entry.ready;
+		return entry.manifest;
+	}
+}
+/** 按 Metro 传入的项目根目录读取当前注册项，兼容 transformer 未透传自定义字段的实现。 */
+async function getRegisteredManifestByProjectRoot(projectRoot) {
+	const resolvedRoot = path.resolve(projectRoot);
+	const entry = [...registry.values()].filter((entry) => entry.projectRoot === resolvedRoot).at(-1);
+	if (!entry) return;
+	await entry.ready;
+	return entry.manifest;
+}
 function getVirtualModuleCode(filename) {
 	const registered = getRegisteredVirtualModule(filename);
 	if (!registered) return;
@@ -122,7 +171,12 @@ function withWeappTailwindcss(config, options = {}) {
 			type: "sourceFile",
 			filePath: entry.virtualPath
 		};
-		return originalResolver?.(context, moduleName, platform) ?? context.resolveRequest?.(context, moduleName, platform);
+		const resolverContext = context;
+		const anchoredContext = resolverContext.originModulePath === entry.virtualPath || shouldResolveFromAppRoot(moduleName, platform) ? {
+			...resolverContext,
+			originModulePath: path.join(entry.projectRoot, "package.json")
+		} : resolverContext;
+		return originalResolver?.(anchoredContext, moduleName, platform) ?? resolverContext.resolveRequest?.(anchoredContext, moduleName, platform);
 	};
 	return {
 		...resolvedConfig,
@@ -132,7 +186,9 @@ function withWeappTailwindcss(config, options = {}) {
 			...resolvedConfig.transformer,
 			weappTailwindcssMetroId: id,
 			weappTailwindcssOriginalTransformerPath: resolvedConfig.transformerPath,
-			weappTailwindcssManifestPath: entry.manifestPath
+			weappTailwindcssManifestPath: entry.manifestPath,
+			weappTailwindcssManifestReadyPath: entry.manifestReadyPath,
+			weappTailwindcssVirtualModulePath: entry.virtualPath
 		},
 		resolver: {
 			...resolvedConfig.resolver,
@@ -142,4 +198,4 @@ function withWeappTailwindcss(config, options = {}) {
 	};
 }
 //#endregion
-export { VIRTUAL_MANIFEST_MODULE, getRegisteredManifest, getRegisteredVirtualModule, getVirtualModuleCode, getVirtualModuleCodeAsync, withWeappTailwindcss };
+export { VIRTUAL_MANIFEST_MODULE, getManifestPathsForProjectRoot, getRegisteredManifest, getRegisteredManifestByPath, getRegisteredManifestByProjectRoot, getRegisteredVirtualModule, getVirtualModuleCode, getVirtualModuleCodeAsync, withWeappTailwindcss };

package/dist/tailwind.cjs

@@ -1,12 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
 const require_compiler = require("./compiler.cjs");
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
 let weapp_tailwindcss_generator = require("weapp-tailwindcss/generator");
 //#region src/tailwind.ts
 /**
 * 使用 weapp-tailwindcss 的 Tailwind v4 generator 生成原始 CSS，再编译为 RN manifest。
 */
 async function generateNativeStylesheet(options = {}) {
-	const source = await (0, weapp_tailwindcss_generator.resolveTailwindV4Source)(options);
+	const source = await (0, weapp_tailwindcss_generator.resolveTailwindV4Source)({
+		...options,
+		projectRoot: options.projectRoot ?? node_process.default.cwd()
+	});
 	const generator = (0, weapp_tailwindcss_generator.createWeappTailwindcssGenerator)(source);
 	const sourcePatterns = options.sourceGlobs?.map((pattern) => ({
 		base: source.projectRoot,
@@ -15,7 +21,7 @@ async function generateNativeStylesheet(options = {}) {
 	}));
 	const generatorCandidates = new Set(options.candidates ?? []);
 	for (const candidate of generatorCandidates) {
-		const base = candidate.split(":").at(-1);
+		const base = require_compiler.baseClassName(candidate);
 		if (base && /^(?:ios|android|native):/.test(candidate)) generatorCandidates.add(base);
 	}
 	let generated = await generator.generate({
@@ -25,7 +31,7 @@ async function generateNativeStylesheet(options = {}) {
 	});
 	const platformBases = /* @__PURE__ */ new Set();
 	for (const candidate of generated.rawCandidates ?? []) {
-		const base = candidate.split(":").at(-1);
+		const base = require_compiler.baseClassName(candidate);
 		if (base && /^(?:ios|android|native):/.test(candidate) && !generated.classSet.has(base)) platformBases.add(base);
 	}
 	if (platformBases.size) generated = await generator.generate({
@@ -36,7 +42,7 @@ async function generateNativeStylesheet(options = {}) {
 	const classSet = new Set(generated.classSet);
 	const requestedCandidates = new Set(options.candidates ?? []);
 	for (const candidate of generated.rawCandidates ?? []) {
-		const base = candidate.split(":").at(-1);
+		const base = require_compiler.baseClassName(candidate);
 		if (base && generated.classSet.has(base) && /^(?:dark|ios|android|native):/.test(candidate)) requestedCandidates.add(candidate);
 	}
 	for (const candidate of requestedCandidates) classSet.add(candidate);

package/dist/tailwind.d.ts

@@ -2,6 +2,10 @@ import { o as NativeStyleManifest } from "./types-BTxnqaRV.js";
 import { TailwindV4SourceOptions } from "weapp-tailwindcss/generator";
 //#region src/tailwind.d.ts
 interface GenerateNativeStylesheetOptions extends TailwindV4SourceOptions {
+  /** Tailwind source 扫描根目录；用于 workspace 示例和 Metro 项目。 */
+  projectRoot?: string | undefined;
+  /** Tailwind CSS 入口文件；相对路径会按 projectRoot 解析。 */
+  cssEntries?: string[] | undefined;
   candidates?: Iterable<string> | undefined;
   sourceGlobs?: string[] | undefined;
 }

package/dist/tailwind.js

@@ -1,11 +1,15 @@
-import { addNativeVariantRules, compileNativeStylesheet, finalizeNativeManifest } from "./compiler.js";
+import { addNativeVariantRules, baseClassName, compileNativeStylesheet, finalizeNativeManifest } from "./compiler.js";
+import process from "node:process";
 import { createWeappTailwindcssGenerator, resolveTailwindV4Source } from "weapp-tailwindcss/generator";
 //#region src/tailwind.ts
 /**
 * 使用 weapp-tailwindcss 的 Tailwind v4 generator 生成原始 CSS，再编译为 RN manifest。
 */
 async function generateNativeStylesheet(options = {}) {
-	const source = await resolveTailwindV4Source(options);
+	const source = await resolveTailwindV4Source({
+		...options,
+		projectRoot: options.projectRoot ?? process.cwd()
+	});
 	const generator = createWeappTailwindcssGenerator(source);
 	const sourcePatterns = options.sourceGlobs?.map((pattern) => ({
 		base: source.projectRoot,
@@ -14,7 +18,7 @@ async function generateNativeStylesheet(options = {}) {
 	}));
 	const generatorCandidates = new Set(options.candidates ?? []);
 	for (const candidate of generatorCandidates) {
-		const base = candidate.split(":").at(-1);
+		const base = baseClassName(candidate);
 		if (base && /^(?:ios|android|native):/.test(candidate)) generatorCandidates.add(base);
 	}
 	let generated = await generator.generate({
@@ -24,7 +28,7 @@ async function generateNativeStylesheet(options = {}) {
 	});
 	const platformBases = /* @__PURE__ */ new Set();
 	for (const candidate of generated.rawCandidates ?? []) {
-		const base = candidate.split(":").at(-1);
+		const base = baseClassName(candidate);
 		if (base && /^(?:ios|android|native):/.test(candidate) && !generated.classSet.has(base)) platformBases.add(base);
 	}
 	if (platformBases.size) generated = await generator.generate({
@@ -35,7 +39,7 @@ async function generateNativeStylesheet(options = {}) {
 	const classSet = new Set(generated.classSet);
 	const requestedCandidates = new Set(options.candidates ?? []);
 	for (const candidate of generated.rawCandidates ?? []) {
-		const base = candidate.split(":").at(-1);
+		const base = baseClassName(candidate);
 		if (base && generated.classSet.has(base) && /^(?:dark|ios|android|native):/.test(candidate)) requestedCandidates.add(candidate);
 	}
 	for (const candidate of requestedCandidates) classSet.add(candidate);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-tailwindcss/react-native",
   "type": "module",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Tailwind CSS compiler and Expo Metro integration for cross-platform React Native apps. 面向跨端 React Native 应用的 Tailwind CSS 编译器与 Expo Metro 集成。",
   "license": "MIT",
   "repository": {
@@ -92,7 +92,7 @@
   "dependencies": {
     "@babel/types": "^8.0.4",
     "postcss": "^8.5.26",
-    "weapp-tailwindcss": "5.3.2"
+    "weapp-tailwindcss": "5.3.4"
   },
   "devDependencies": {
     "@babel/core": "^8.0.1",