@weapp-tailwindcss/react-native 0.2.0 → 0.2.2

package/README.md

@@ -1,13 +1,17 @@
 # @weapp-tailwindcss/react-native
 
-面向 React Native 与 Expo 的 Tailwind CSS v4 编译器。它复用 `weapp-tailwindcss` 的 source 扫描与候选生成，将原始 CSS 编译为可序列化的 React Native style manifest，不引入 NativeWind 或 `react-native-css` 运行时。
+> English | [简体中文](./README.zh-CN.md)
 
-## Expo 配置
+A Tailwind CSS v4 compiler for React Native and Expo. It reuses source scanning and candidate generation from `weapp-tailwindcss`, then compiles CSS into a serializable React Native style manifest without adding NativeWind or a `react-native-css` runtime.
+
+## Installation
 
 ```bash
 pnpm add @weapp-tailwindcss/react-native tailwindcss
 ```
 
+## Expo and Metro
+
 ```js
 // metro.config.js
 const { getDefaultConfig } = require('expo/metro-config')
@@ -21,8 +25,23 @@ module.exports = withWeappTailwindcss(config, {
 })
 ```
 
-Expo 只需要配置一次 Metro。Metro 会扫描 source、生成精确候选集合和 manifest，并自动把 Babel JSX transform 注入原有 Expo transformer；不需要再维护第二份 `classNameSet`。非 Expo 或定制 Metro 场景仍可显式使用 `@weapp-tailwindcss/react-native/babel`。
+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`.
+
+## 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.
+
+## Public entry points
+
+The package exposes `compiler`, `tailwind`, `babel`, `metro`, `runtime`, and the platform-neutral `env` type entry. Custom Metro setups can compose these entry points directly.
+
+## Scope
+
+This package generates React Native style manifests. It does not emit Web CSS or mini-program WXSS and does not add NativeWind or a browser CSS runtime to the application.
 
-静态 `className` 会编译为预生成的 StyleSheet lookup，不在 render 中调用 `tw()`；动态值才使用 `tw(value)`。普通 inline `style` 覆盖 Tailwind class，`!important` class 覆盖 inline style。不支持的 CSS 声明会写入 manifest 的 `warnings`，不会静默产出错误的 RN style。
+## Documentation
 
-公开入口：`compiler`、`babel`、`metro`、`runtime`、`tailwind` 与中性类型入口 `env`。
+See the [React Native and Expo guide](https://tw.icebreaker.top/docs/quick-start/react-native-expo) for the complete setup.

package/README.zh-CN.md

@@ -0,0 +1,47 @@
+# @weapp-tailwindcss/react-native
+
+> [English](./README.md) | 简体中文
+
+面向 React Native 与 Expo 的 Tailwind CSS v4 编译器。它复用 `weapp-tailwindcss` 的源码扫描与候选生成，将 CSS 编译为可序列化的 React Native style manifest，不引入 NativeWind 或 `react-native-css` 运行时。
+
+## 安装
+
+```bash
+pnpm add @weapp-tailwindcss/react-native tailwindcss
+```
+
+## Expo 与 Metro
+
+```js
+// metro.config.js
+const { getDefaultConfig } = require('expo/metro-config')
+const { withWeappTailwindcss } = require('@weapp-tailwindcss/react-native/metro')
+
+const config = getDefaultConfig(__dirname)
+
+module.exports = withWeappTailwindcss(config, {
+  input: './global.css',
+  sourceGlobs: ['./src/**/*.{js,jsx,ts,tsx}'],
+})
+```
+
+Metro 会扫描源码、生成精确候选集合和 manifest，并把 Babel JSX transform 接入现有 Expo transformer。无需维护第二份 `classNameSet`。
+
+## 运行模型
+
+- 静态 `className` 编译为预生成的 StyleSheet lookup，不在 render 中调用 `tw()`。
+- 动态 class 才通过 `tw(value)` 在运行时解析。
+- 普通 inline `style` 覆盖 Tailwind class，`!important` class 覆盖 inline style。
+- 不支持的 CSS 声明会记录在 manifest `warnings` 中，不会静默生成错误样式。
+
+## 公开入口
+
+包提供 `compiler`、`tailwind`、`babel`、`metro`、`runtime` 与中性类型入口 `env`。非 Expo 或定制 Metro 场景可以显式组合这些入口。
+
+## 边界
+
+本包生成 React Native 样式清单，不输出 Web CSS 或小程序 WXSS，也不把 NativeWind 或浏览器 CSS 运行时引入应用。
+
+## 文档
+
+完整接入说明见 [React Native / Expo 指南](https://tw.icebreaker.top/zh-cn/docs/quick-start/react-native-expo)。

package/dist/babel.cjs

@@ -1,4 +1,4 @@
-const require_rolldown_runtime = require("./rolldown-runtime-D6vf50IK.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
 let _babel_types = require("@babel/types");
 _babel_types = require_rolldown_runtime.__toESM(_babel_types, 1);
 //#region src/babel.ts

package/dist/babel.d.ts

@@ -1,5 +1,5 @@
-import { PluginObject, PluginPass } from "@babel/core";
 import * as t from "@babel/types";
+import { PluginObject, PluginPass } from "@babel/core";
 //#region src/babel.d.ts
 interface WeappReactNativeBabelOptions {
   classNameSet?: Iterable<string> | undefined;

package/dist/compiler.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rolldown_runtime = require("./rolldown-runtime-D6vf50IK.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
 let postcss = require("postcss");
 postcss = require_rolldown_runtime.__toESM(postcss, 1);
 //#region src/compiler.ts

package/dist/metro-transformer.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rolldown_runtime = require("./rolldown-runtime-D6vf50IK.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
 const require_babel = require("./babel.cjs");
 const require_metro = require("./metro.cjs");
 let node_fs = require("node:fs");

package/dist/metro.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rolldown_runtime = require("./rolldown-runtime-D6vf50IK.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
 const require_compiler = require("./compiler.cjs");
 let node_fs = require("node:fs");
 node_fs = require_rolldown_runtime.__toESM(node_fs, 1);

package/dist/{rolldown-runtime-D6vf50IK.cjs → rolldown-runtime-VH7oDXx4.cjs}

@@ -15,7 +15,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@weapp-tailwindcss/react-native",
   "type": "module",
-  "version": "0.2.0",
-  "description": "Tailwind CSS 4 compiler and Expo Metro integration for React Native.",
+  "version": "0.2.2",
+  "description": "Tailwind CSS compiler and Expo Metro integration for cross-platform React Native apps. 面向跨端 React Native 应用的 Tailwind CSS 编译器与 Expo Metro 集成。",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -91,11 +91,13 @@
   },
   "dependencies": {
     "@babel/types": "^8.0.4",
-    "postcss": "^8.5.22",
-    "weapp-tailwindcss": "^5.2.3"
+    "postcss": "^8.5.26",
+    "weapp-tailwindcss": "^5.3.0"
   },
   "devDependencies": {
     "@babel/core": "^8.0.1",
+    "@types/react": "^19.2.18",
+    "react": "^19.2.8",
     "vitest": "^4.1.0"
   },
   "scripts": {