miaoda-expo-devkit 0.1.1-beta.46 → 0.1.1-beta.48

package/README.md

@@ -10,6 +10,7 @@ Expo / React Native 开发环境工具集，通过 Metro 构建层注入以下
 - **expo-notifications stub** — Expo Go（Android）中提供 no-op 实现，核心 API 调用时弹出带参数校验的调试 Alert，Dev Build 透传真实模块
 - **expo-media-library stub** — Expo Go / Web 中提供 no-op 实现，`saveToLibraryAsync`、`createAssetAsync`、权限请求等 API 调用时弹出 Alert 提示，Dev Build 原生环境透传真实模块
 - **expo-calendar stub** — Expo Go / Web 中提供 no-op 实现，`getEventsAsync`、`createEventAsync`、`getCalendarsAsync`、权限请求等核心 API 调用时弹出 Alert 提示并校验参数，Dev Build 原生环境透传真实模块
+- **async-storage local repo 注入** — Expo Config Plugin，修复 `@react-native-async-storage/async-storage` v3.x 构建时找不到 `storage-android` AAR 的问题（上游 PR #1279 合并前的临时方案）
 
 ## 安装
 
@@ -30,6 +31,26 @@ pnpm install
 
 ## 使用
 
+### Expo Config Plugin（async-storage v3）
+
+`@react-native-async-storage/async-storage` v3.x 将 `storage-android` AAR 打包在本地 `local_repo` 目录，未发布至 Maven Central，需在 `android/build.gradle` 中手动注册路径。此 Plugin 在 `expo prebuild` 时自动完成注入。
+
+在 `app.json` 中注册：
+
+```json
+{
+  "expo": {
+    "plugins": [
+      "miaoda-expo-devkit/plugin-async-storage-local-repo"
+    ]
+  }
+}
+```
+
+> 上游 PR [#1279](https://github.com/react-native-async-storage/async-storage/pull/1279) 合并并发版后可移除此 Plugin。
+
+---
+
 ### Metro 配置
 
 ```js
@@ -288,6 +309,7 @@ sentry-react-native-stub.js
 | `./expo-notifications-stub` | `dist/stubs/expo-notifications-stub.js` | `expo-notifications` Expo Go Android stub |
 | `./expo-media-library-stub` | `dist/stubs/expo-media-library-stub.js` | `expo-media-library` Expo Go / Web stub |
 | `./expo-calendar-stub` | `dist/stubs/expo-calendar-stub.js` | `expo-calendar` Expo Go / Web stub |
+| `./plugin-async-storage-local-repo` | `dist/plugins/with-async-storage-local-repo.js` | Expo Config Plugin：注入 async-storage v3 本地 Maven 仓库路径 |
 
 ---
 

package/dist/metro.d.mts

@@ -339,36 +339,46 @@ declare function withEsbuildMinify(config: MetroConfig): MetroConfig;
 declare function withWasmSupport(config: MetroConfig): MetroConfig;
 
 /**
- * withTransformLogger — Metro bundle 整体耗时日志
+ * withTransformLogger — Metro bundle 整体耗时日志 + 单文件 transform 耗时日志
  *
- * 通过 unstable_perfLoggerFactory 收集每次 bundle 请求的性能数据，写入 JSONL 文件。
- * 该回调在主进程执行，不受 --max-workers 多进程影响。
+ * 写入两类 JSONL 条目：
  *
- * 激活条件（两者同时满足）：
- *   1. 环境变量 METRO_TRANSFORM_LOG 设置为目标文件路径
- *   2. 当前处于开发模式（__DEV__ === true），expo export 生产构建时不记录
- *
- * 每行格式（一次 bundle 请求写一条）：
+ * 1. BUNDLING_REQUEST — 每次完整 bundle 请求写一条（通过 unstable_perfLoggerFactory）
  *   {
- *     "type": "BUNDLING_REQUEST",   // START_UP | BUNDLING_REQUEST | HMR
+ *     "type": "BUNDLING_REQUEST",
  *     "status": "SUCCESS",          // SUCCESS | FAIL | CANCEL
  *     "duration_ms": 1234,
  *     "bundle_url": "index.bundle",
  *     "initial_build": true,        // true=首次构建 false=增量更新
- *     "graph_node_count": 220,      // 模块数量
- *     "bundle_length": 512000,      // bundle 字节数
- *     "points": {                   // 各阶段耗时（ms，从 start 计算）
+ *     "graph_node_count": 220,
+ *     "bundle_length": 512000,
+ *     "points": {
  *       "resolvingAndTransformingDependencies_start": 5,
  *       "resolvingAndTransformingDependencies_end": 980,
  *       "serializingBundle_start": 981,
  *       "serializingBundle_end": 1200
  *     },
- *     "t": 1234567890               // bundle 完成时的时间戳
+ *     "t": 1234567890
  *   }
+ *
+ * 2. TRANSFORM_FILE — 每个 cache miss 的文件写一条（通过 metro-core Logger）
+ *   {
+ *     "type": "TRANSFORM_FILE",
+ *     "file": "src/components/Button.tsx",
+ *     "duration_ms": 45,
+ *     "t": 1234567890
+ *   }
+ *   注意：缓存命中的文件不会触发此条目。
+ *
+ * 激活条件（两者同时满足）：
+ *   1. 环境变量 METRO_TRANSFORM_LOG 设置为目标文件路径
+ *   2. 当前处于开发模式（__DEV__ === true），expo export 生产构建时不记录
  */
 
 /**
- * 在开发模式下，若 METRO_TRANSFORM_LOG 已设置，则注入 unstable_perfLoggerFactory。
+ * 在开发模式下，若 METRO_TRANSFORM_LOG 已设置，则注入：
+ *   - unstable_perfLoggerFactory（整体 bundle 耗时）
+ *   - metro-core Logger 监听器（单文件 transform 耗时，仅 cache miss）
  */
 declare function withTransformLogger(config: MetroConfig): MetroConfig;
 

package/dist/metro.d.ts

@@ -339,36 +339,46 @@ declare function withEsbuildMinify(config: MetroConfig): MetroConfig;
 declare function withWasmSupport(config: MetroConfig): MetroConfig;
 
 /**
- * withTransformLogger — Metro bundle 整体耗时日志
+ * withTransformLogger — Metro bundle 整体耗时日志 + 单文件 transform 耗时日志
  *
- * 通过 unstable_perfLoggerFactory 收集每次 bundle 请求的性能数据，写入 JSONL 文件。
- * 该回调在主进程执行，不受 --max-workers 多进程影响。
+ * 写入两类 JSONL 条目：
  *
- * 激活条件（两者同时满足）：
- *   1. 环境变量 METRO_TRANSFORM_LOG 设置为目标文件路径
- *   2. 当前处于开发模式（__DEV__ === true），expo export 生产构建时不记录
- *
- * 每行格式（一次 bundle 请求写一条）：
+ * 1. BUNDLING_REQUEST — 每次完整 bundle 请求写一条（通过 unstable_perfLoggerFactory）
  *   {
- *     "type": "BUNDLING_REQUEST",   // START_UP | BUNDLING_REQUEST | HMR
+ *     "type": "BUNDLING_REQUEST",
  *     "status": "SUCCESS",          // SUCCESS | FAIL | CANCEL
  *     "duration_ms": 1234,
  *     "bundle_url": "index.bundle",
  *     "initial_build": true,        // true=首次构建 false=增量更新
- *     "graph_node_count": 220,      // 模块数量
- *     "bundle_length": 512000,      // bundle 字节数
- *     "points": {                   // 各阶段耗时（ms，从 start 计算）
+ *     "graph_node_count": 220,
+ *     "bundle_length": 512000,
+ *     "points": {
  *       "resolvingAndTransformingDependencies_start": 5,
  *       "resolvingAndTransformingDependencies_end": 980,
  *       "serializingBundle_start": 981,
  *       "serializingBundle_end": 1200
  *     },
- *     "t": 1234567890               // bundle 完成时的时间戳
+ *     "t": 1234567890
  *   }
+ *
+ * 2. TRANSFORM_FILE — 每个 cache miss 的文件写一条（通过 metro-core Logger）
+ *   {
+ *     "type": "TRANSFORM_FILE",
+ *     "file": "src/components/Button.tsx",
+ *     "duration_ms": 45,
+ *     "t": 1234567890
+ *   }
+ *   注意：缓存命中的文件不会触发此条目。
+ *
+ * 激活条件（两者同时满足）：
+ *   1. 环境变量 METRO_TRANSFORM_LOG 设置为目标文件路径
+ *   2. 当前处于开发模式（__DEV__ === true），expo export 生产构建时不记录
  */
 
 /**
- * 在开发模式下，若 METRO_TRANSFORM_LOG 已设置，则注入 unstable_perfLoggerFactory。
+ * 在开发模式下，若 METRO_TRANSFORM_LOG 已设置，则注入：
+ *   - unstable_perfLoggerFactory（整体 bundle 耗时）
+ *   - metro-core Logger 监听器（单文件 transform 耗时，仅 cache miss）
  */
 declare function withTransformLogger(config: MetroConfig): MetroConfig;
 

package/dist/metro.js

@@ -443,6 +443,7 @@ function withWasmSupport(config) {
 // src/metro/withTransformLogger.ts
 var import_node_fs = __toESM(require("fs"));
 var import_node_path = __toESM(require("path"));
+var import_metro_core = require("metro-core");
 function installPerfLogger(logFile, existingFactory) {
   const dir = import_node_path.default.dirname(logFile);
   if (!import_node_fs.default.existsSync(dir)) {
@@ -490,11 +491,28 @@ function installPerfLogger(logFile, existingFactory) {
     return logger;
   };
 }
+var fileLoggerInstalled = false;
+function installFileLogger(logFile) {
+  if (fileLoggerInstalled) return;
+  fileLoggerInstalled = true;
+  import_metro_core.Logger.on("log", (entry) => {
+    if (entry.action_name === "Transforming file" && entry.action_phase === "end") {
+      const line = JSON.stringify({
+        type: "TRANSFORM_FILE",
+        file: entry.file_name,
+        duration_ms: entry.duration_ms,
+        t: Date.now()
+      });
+      import_node_fs.default.appendFileSync(logFile, line + "\n");
+    }
+  });
+}
 function withTransformLogger(config) {
   const logFile = process.env["METRO_TRANSFORM_LOG"];
   if (!logFile) return config;
   const isDev = typeof __DEV__ !== "undefined" ? __DEV__ : process.env["NODE_ENV"] !== "production";
   if (!isDev) return config;
+  installFileLogger(logFile);
   return {
     ...config,
     unstable_perfLoggerFactory: installPerfLogger(logFile, config.unstable_perfLoggerFactory)

package/dist/metro.mjs

@@ -399,6 +399,7 @@ function withWasmSupport(config) {
 // src/metro/withTransformLogger.ts
 import fs4 from "fs";
 import path12 from "path";
+import { Logger } from "metro-core";
 function installPerfLogger(logFile, existingFactory) {
   const dir = path12.dirname(logFile);
   if (!fs4.existsSync(dir)) {
@@ -446,11 +447,28 @@ function installPerfLogger(logFile, existingFactory) {
     return logger;
   };
 }
+var fileLoggerInstalled = false;
+function installFileLogger(logFile) {
+  if (fileLoggerInstalled) return;
+  fileLoggerInstalled = true;
+  Logger.on("log", (entry) => {
+    if (entry.action_name === "Transforming file" && entry.action_phase === "end") {
+      const line = JSON.stringify({
+        type: "TRANSFORM_FILE",
+        file: entry.file_name,
+        duration_ms: entry.duration_ms,
+        t: Date.now()
+      });
+      fs4.appendFileSync(logFile, line + "\n");
+    }
+  });
+}
 function withTransformLogger(config) {
   const logFile = process.env["METRO_TRANSFORM_LOG"];
   if (!logFile) return config;
   const isDev = typeof __DEV__ !== "undefined" ? __DEV__ : process.env["NODE_ENV"] !== "production";
   if (!isDev) return config;
+  installFileLogger(logFile);
   return {
     ...config,
     unstable_perfLoggerFactory: installPerfLogger(logFile, config.unstable_perfLoggerFactory)

package/dist/plugins/with-async-storage-local-repo.js

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugins/with-async-storage-local-repo.ts
+var with_async_storage_local_repo_exports = {};
+__export(with_async_storage_local_repo_exports, {
+  default: () => with_async_storage_local_repo_default
+});
+module.exports = __toCommonJS(with_async_storage_local_repo_exports);
+var import_config_plugins = require("@expo/config-plugins");
+var MAVEN_BLOCK = `        maven {
+            // @react-native-async-storage/async-storage v3 \u5C06 storage-android AAR
+            // \u6253\u5305\u5728\u672C\u5730 local_repo \u4E2D\uFF0C\u672A\u53D1\u5E03\u81F3 Maven Central\uFF0C\u9700\u624B\u52A8\u6CE8\u518C\u8DEF\u5F84\u3002
+            // \u5F85\u4E0A\u6E38 PR #1279 \u5408\u5E76\u53D1\u7248\u540E\u53EF\u79FB\u9664\u6B64\u63D2\u4EF6\u3002
+            url = uri("../node_modules/@react-native-async-storage/async-storage/android/local_repo")
+        }`;
+var withAsyncStorageLocalRepo = (config) => {
+  return (0, import_config_plugins.withProjectBuildGradle)(config, (config2) => {
+    if (config2.modResults.contents.includes("async-storage/android/local_repo")) {
+      return config2;
+    }
+    config2.modResults.contents = config2.modResults.contents.replace(
+      /allprojects\s*\{[^}]*repositories\s*\{/,
+      (match) => `${match}
+${MAVEN_BLOCK}`
+    );
+    return config2;
+  });
+};
+var with_async_storage_local_repo_default = withAsyncStorageLocalRepo;

package/dist/rules/no-inline-box-shadow-string.js

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/rules/no-inline-box-shadow-string.ts
+var no_inline_box_shadow_string_exports = {};
+__export(no_inline_box_shadow_string_exports, {
+  default: () => no_inline_box_shadow_string_default
+});
+module.exports = __toCommonJS(no_inline_box_shadow_string_exports);
+var noInlineBoxShadowStringRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow boxShadow string in inline style objects. NativeWind drops all styles including backgroundColor on Android when a function-style prop contains a boxShadow string."
+    },
+    schema: [],
+    messages: {
+      noInlineBoxShadowString: 'boxShadow string in inline style is not supported by NativeWind on Android \u2014 it causes backgroundColor and other styles to be lost. Use the object form instead: boxShadow: [{ offsetX: 0, offsetY: 4, blurRadius: 12, color: "rgba(33,150,243,0.35)" }], or replace with elevation + shadowColor for Android.'
+    }
+  },
+  create(context) {
+    return {
+      // 匹配所有属性键为 boxShadow 且值为字符串字面量的节点。
+      // 覆盖两种写法：
+      //   style={{ boxShadow: '...' }}
+      //   style={({ pressed }) => ({ boxShadow: '...' })}
+      Property(node) {
+        if (node.key.type === "Identifier" && node.key.name === "boxShadow" && node.value.type === "Literal" && typeof node.value.value === "string") {
+          context.report({ node, messageId: "noInlineBoxShadowString" });
+        }
+      }
+    };
+  }
+};
+var plugin = {
+  meta: { name: "no-inline-box-shadow-string" },
+  rules: { "no-inline-box-shadow-string": noInlineBoxShadowStringRule }
+};
+var no_inline_box_shadow_string_default = plugin;
+module.exports = module.exports.default;

package/dist/stubs/lgui-control.js

@@ -218,6 +218,9 @@ class EditorController {
         case "editor-delete":
           this.deleteActiveNode();
           break;
+        case "editor-text-update":
+          this.updateActiveNodeText(e);
+          break;
       }
     };
   }
@@ -360,6 +363,16 @@ class EditorController {
     this.activeNode = null;
     postToParent("iframe-node-clear");
   }
+  /**
+   * 更新选中元素的文本内容
+   */
+  updateActiveNodeText(e) {
+    if (!this.activeNode) return;
+    const text = e.data.value;
+    if (typeof text !== "string") return;
+    const node = this.activeNode;
+    node.innerHTML = text;
+  }
 }
 let controller = null;
 function onGlobalMessage(e) {

package/oxlint-config.json

@@ -10,7 +10,8 @@
     { "name": "expo-router-layout", "specifier": "miaoda-expo-devkit/rules/no-invalid-tabs-screen" },
     { "name": "expo-router-dynamic-tab", "specifier": "miaoda-expo-devkit/rules/no-unregistered-dynamic-tab-route" },
     { "name": "rn-pressable", "specifier": "miaoda-expo-devkit/rules/no-pressable-without-on-press" },
-    { "name": "expo-video-compat", "specifier": "miaoda-expo-devkit/rules/no-expo-video-compat" }
+    { "name": "expo-video-compat", "specifier": "miaoda-expo-devkit/rules/no-expo-video-compat" },
+    { "name": "rn-style", "specifier": "miaoda-expo-devkit/rules/no-inline-box-shadow-string" }
   ],
 
   "categories": {
@@ -27,6 +28,7 @@
     "expo-router-dynamic-tab/no-unregistered-dynamic-tab-route": "error",
     "rn-pressable/no-pressable-without-on-press": "error",
     "expo-video-compat/no-expo-video-compat": "warn",
+    "rn-style/no-inline-box-shadow-string": "error",
 
     "expo/no-dynamic-env-var": "error",
     "expo/no-env-var-destructuring": "error",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-expo-devkit",
-  "version": "0.1.1-beta.46",
+  "version": "0.1.1-beta.48",
   "description": "Expo 应用开发工具集：Sentry DSN 替换 stub、错误/网络捕获、Metro 符号化",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -58,6 +58,8 @@
     "./rules/no-expo-audio-compat": "./dist/rules/no-expo-audio-compat.js",
     "./rules/no-pressable-without-on-press": "./dist/rules/no-pressable-without-on-press.js",
     "./rules/no-expo-video-compat": "./dist/rules/no-expo-video-compat.js",
+    "./rules/no-inline-box-shadow-string": "./dist/rules/no-inline-box-shadow-string.js",
+    "./plugin-async-storage-local-repo": "./dist/plugins/with-async-storage-local-repo.js",
     "./biome": "./biome-config.json",
     "./oxlint": "./oxlint-config.json",
     "./tsconfig-base": "./tsconfig-base.json"
@@ -79,10 +81,12 @@
     "stacktrace-parser": "^0.1.11"
   },
   "peerDependencies": {
+    "@expo/config-plugins": ">=8.0.0",
     "@sentry/core": "^10.38.0",
     "@sentry/react-native": ">=8.0.0",
     "metro": ">=0.80.0",
     "metro-config": ">=0.80.0",
+    "metro-core": ">=0.80.0",
     "metro-resolver": ">=0.80.0",
     "nativewind": ">=4.0.0",
     "react-native": ">=0.79.0",
@@ -90,6 +94,9 @@
     "typescript": ">=5.0.0"
   },
   "peerDependenciesMeta": {
+    "@expo/config-plugins": {
+      "optional": true
+    },
     "@sentry/core": {
       "optional": true
     },
@@ -102,6 +109,9 @@
     "metro-config": {
       "optional": true
     },
+    "metro-core": {
+      "optional": true
+    },
     "metro-resolver": {
       "optional": true
     },