miaoda-expo-devkit 0.1.1-dev.development-build.1 → 0.1.1-dev.development-build.2

package/README.md

@@ -19,7 +19,7 @@ Expo / React Native 开发环境工具集，通过 Metro 构建层注入以下
 - **expo-haptics stub** — Web 中提供 no-op 实现，触觉 API 调用时弹 Dialog 提示参数信息，native 不受影响
 - **expo-contacts stub** — Web / Expo Go 中提供 no-op 实现，联系人 API 调用时弹 Dialog 提示，Dev Build 透传真实模块
 - **expo-image-picker stub** — 桌面 Web 中 `launchCameraAsync` 通过 `getUserMedia` 打开摄像头预览弹窗（浏览器原生 `capture` 属性在 PC 端被忽略），移动端浏览器透传 expo 原实现，Native 不受影响
-- **devkit-lint** — 集成 Oxlint（18 条自定义规则）、Biome、TypeScript 类型检查、以及 `app.json` 字段合法性校验，一条命令完成项目全量静态检查
+- **devkit-lint** — 集成 Oxlint（22 条自定义规则）、Biome、TypeScript 类型检查、以及 `app.json` 字段合法性校验，一条命令完成项目全量静态检查
 
 ## 安装
 
@@ -865,11 +865,19 @@ pnpmfile:
 
 DevKit 当前管理以下补丁：
 
-- `@shopify/react-native-skia@2.4.18`
-- `expo@55.0.6`（固定 `expo-audio@55.0.6` 和 `expo-video@55.0.5` 的 Expo 兼容版本表）
-- `expo-modules-core@55.0.15`
-- `react-native-css-interop@0.2.6`
-- `react-native-reanimated@4.2.1`
+- `@expo/cli@55.0.16-55.0.22`（Metro HMR 批量编辑控制的服务端，含 AI 错误采集；另按 55.0.16–55.0.22 每个小版本提供独立补丁文件）
+- `expo@55.0.6`（HMR 批量编辑控制的客户端；并固定 `expo-audio@55.0.6` 和 `expo-video@55.0.5` 的 Expo 兼容版本表）
+- `metro-runtime@0.83.3`（HMRClient 透传 `miaoda-hmr-control` 控制消息）
+- `metro-file-map@0.83.3`（`miaodaFlushChanges` 文件监听栅栏，保证恢复时 watcher 已看到全部写入）
+- `react-native@0.83.2`（LogBox 错误页增强：错误标题映射与一键复制）
+- `expo-modules-core@55.0.15`（Android CMake 打包 worklets 原生库）
+- `react-native-reanimated@4.2.1`（Android 打包 `libworklets.so` 并关联 worklets 构建任务）
+- `react-native-worklets@0.7.4`（Babel 插件规范化 TypeScript 函数类型）
+
+前四个补丁共同实现 [Metro HMR 批量编辑控制](../../docs/metro-hmr-control.md)，须整体安装。
+
+`react-native-css-interop@0.2.7` 的 box-shadow fallthrough 已由上游修复，新模板不再需要 DevKit patch。
+为兼容升级 DevKit 的历史模板，DevKit 会在项目实际声明或 lockfile 中包含历史版本时注册已验证的 CSS interop（`0.2.6`）、Worklets（`0.7.2`）和 Skia（`@shopify/react-native-skia@2.4.18`，支持 `SKIA_DOWNLOAD_BASE_URL` 自定义二进制下载源）patch，由 pnpm 按实际安装版本匹配；新模板不会注册未使用的旧 patch。注册 patch 不会安装额外版本。历史项目升级后应重新生成并提交 lockfile。
 
 迁移历史项目时，hook 会计算同名本地 patch 的 SHA-256：已知模板 patch 会自动切换到 DevKit 内置文件；内容不同的项目定制 patch 会继续优先，并输出警告。项目中其他 `patchedDependencies` 不受影响。迁移后必须重新生成并提交 `pnpm-lock.yaml`。
 
@@ -879,7 +887,7 @@ DevKit 当前管理以下补丁：
 pnpm --dir packages/devkit test:patches
 ```
 
-该命令会自动构建并打包 DevKit，在临时项目中模拟 pnpm 安装 Config Dependency 后的目录布局，安装受支持版本范围内的目标依赖，检查 10 个托管补丁及 lockfile，然后执行 frozen-lockfile 复装，并运行真实 Metro 文件监听、HTTP 控制接口和 `/hot` WebSocket 回归，最后清理临时目录。它不会运行 Expo Prebuild、Gradle 或 Android 编译。
+该命令会自动构建并打包 DevKit，在临时项目中模拟 pnpm 安装 Config Dependency 后的目录布局，安装受支持版本范围内的目标依赖，检查 11 个托管补丁（18 个补丁文件，覆盖 18 个包版本，含 CSS interop、Worklets、Skia 的历史 legacy 版本）及 lockfile，然后执行 frozen-lockfile 复装，并运行真实 Metro 文件监听、HTTP 控制接口和 `/hot` WebSocket 回归，最后清理临时目录。它不会运行 Expo Prebuild、Gradle 或 Android 编译。
 
 ### 本地编辑 pnpm 补丁
 

package/dist/babel/plugin-lucide-react-native.js

@@ -14623,7 +14623,7 @@ function buildAliasMap(moduleDir, pkgRoot) {
   if (import_node_fs.default.existsSync(cjsBundle)) {
     const content = import_node_fs.default.readFileSync(cjsBundle, "utf-8");
     const varToExportNames = /* @__PURE__ */ new Map();
-    const re = /^exports\.(\w+)\s*=\s*(\w+);/gm;
+    const re = /^exports\.(\w+)\s*=\s*(\w+)(?:\.\w+)?;/gm;
     let m;
     while ((m = re.exec(content)) !== null) {
       const [, exportName, varName] = m;

package/dist/rules/no-bare-web-crypto.js

@@ -0,0 +1,235 @@
+"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-bare-web-crypto.ts
+var no_bare_web_crypto_exports = {};
+__export(no_bare_web_crypto_exports, {
+  default: () => no_bare_web_crypto_default
+});
+module.exports = __toCommonJS(no_bare_web_crypto_exports);
+var HOST_GLOBALS = /* @__PURE__ */ new Set(["globalThis", "global", "window"]);
+var TRANSPARENT_WRAPPERS = /* @__PURE__ */ new Set([
+  "TSAsExpression",
+  "TSSatisfiesExpression",
+  "TSTypeAssertion",
+  "TSNonNullExpression",
+  "TSInstantiationExpression",
+  "ChainExpression",
+  "ParenthesizedExpression"
+]);
+var WEB_ONLY_FILE = /\.web\.[jt]sx?$/;
+var NODE_CONFIG_FILE = /(?:^|[/\\])[^/\\]*\.config\.[cm]?[jt]s$/;
+var CRYPTO = "crypto";
+function unwrap(node) {
+  let cur = node ?? null;
+  while (cur && TRANSPARENT_WRAPPERS.has(cur.type)) {
+    cur = cur.expression ?? null;
+  }
+  return cur;
+}
+function cryptoRefName(node) {
+  const n = unwrap(node);
+  if (!n) return null;
+  if (n.type === "Identifier" && n.name === CRYPTO) {
+    return CRYPTO;
+  }
+  if (n.type === "MemberExpression" && !n.computed) {
+    const obj = unwrap(n.object);
+    const prop = n.property;
+    if (obj?.type === "Identifier" && obj.name !== void 0 && HOST_GLOBALS.has(obj.name) && prop?.type === "Identifier" && prop.name === CRYPTO) {
+      return `${obj.name}.${CRYPTO}`;
+    }
+  }
+  return null;
+}
+function patternBindsCrypto(pattern) {
+  const p = unwrap(pattern);
+  if (!p) return false;
+  switch (p.type) {
+    case "Identifier":
+      return p.name === CRYPTO;
+    case "ObjectPattern":
+      return (p.properties ?? []).some((prop) => {
+        const q = unwrap(prop);
+        if (!q) return false;
+        if (q.type === "Property") return patternBindsCrypto(q.value);
+        if (q.type === "RestElement") return patternBindsCrypto(q.argument);
+        return patternBindsCrypto(q);
+      });
+    case "ArrayPattern":
+      return (p.elements ?? []).some(patternBindsCrypto);
+    case "AssignmentPattern":
+      return patternBindsCrypto(p.left);
+    case "RestElement":
+      return patternBindsCrypto(p.argument);
+    case "TSParameterProperty":
+      return patternBindsCrypto(p.parameter);
+    default:
+      return false;
+  }
+}
+function eachNode(root, visit) {
+  const seen = /* @__PURE__ */ new Set();
+  const stack = [root];
+  while (stack.length > 0) {
+    const node = stack.pop();
+    if (seen.has(node)) continue;
+    seen.add(node);
+    visit(node);
+    for (const key of Object.keys(node)) {
+      if (key === "parent") continue;
+      const child = node[key];
+      if (Array.isArray(child)) {
+        for (const item of child) {
+          if (item && typeof item === "object") stack.push(item);
+        }
+      } else if (child && typeof child === "object") {
+        stack.push(child);
+      }
+    }
+  }
+}
+function fileDeclaresCrypto(program) {
+  let found = false;
+  eachNode(program, (node) => {
+    if (found) return;
+    switch (node.type) {
+      case "ImportDeclaration":
+        found = (node.specifiers ?? []).some((s) => s?.local?.name === CRYPTO);
+        break;
+      case "TSImportEqualsDeclaration":
+        found = node.id?.name === CRYPTO;
+        break;
+      case "VariableDeclarator":
+        found = patternBindsCrypto(node.id);
+        break;
+      case "FunctionDeclaration":
+      case "FunctionExpression":
+        found = node.id?.name === CRYPTO || (node.params ?? []).some(patternBindsCrypto);
+        break;
+      case "ArrowFunctionExpression":
+        found = (node.params ?? []).some(patternBindsCrypto);
+        break;
+      case "ClassDeclaration":
+      case "ClassExpression":
+        found = node.id?.name === CRYPTO;
+        break;
+      case "CatchClause":
+        found = patternBindsCrypto(node.param);
+        break;
+      default:
+        break;
+    }
+  });
+  return found;
+}
+function renderExpr(member, refName) {
+  if (member.computed) {
+    const prop2 = unwrap(member.property);
+    if (prop2?.type === "Literal" && typeof prop2.value === "string") {
+      return `${refName}['${prop2.value}']`;
+    }
+    return `${refName}[\u2026]`;
+  }
+  const prop = member.property;
+  if (prop?.type === "Identifier" && prop.name) {
+    return `${refName}.${prop.name}`;
+  }
+  return refName;
+}
+var noBareWebCryptoRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow the browser global `crypto` (crypto.randomUUID / getRandomValues / subtle); it does not exist in the React Native Hermes runtime and crashes on Android/iOS while web preview looks fine. Use expo-crypto instead."
+    },
+    schema: [],
+    messages: {
+      noGlobalCrypto: "'{{expr}}' uses the browser global `crypto`, which does NOT exist in the React Native (Hermes) runtime \u2014 this crashes on Android/iOS at runtime, while TypeScript and web preview both look fine. Do NOT work around it with `typeof crypto` guards or Math.random fallbacks \u2014 on native those silently take a degraded branch. Use Expo's official module instead: import * as Crypto from 'expo-crypto'; Crypto.randomUUID(), Crypto.getRandomValues(...), Crypto.digestAsync(...)."
+    }
+  },
+  create(context) {
+    const filename = typeof context.filename === "string" ? context.filename : "";
+    const skipFile = WEB_ONLY_FILE.test(filename) || NODE_CONFIG_FILE.test(filename);
+    let exempt = skipFile;
+    let program = null;
+    let bindingChecked = false;
+    let bindingExempt = false;
+    function suppressed() {
+      if (exempt) return true;
+      if (!bindingChecked) {
+        bindingChecked = true;
+        bindingExempt = program !== null && fileDeclaresCrypto(program);
+      }
+      return bindingExempt;
+    }
+    return {
+      Program(node) {
+        if (skipFile) return;
+        program = node;
+        for (const stmt of program.body ?? []) {
+          if (stmt?.type === "ExpressionStatement" && stmt.directive === "use dom") {
+            exempt = true;
+            return;
+          }
+        }
+      },
+      // crypto.randomUUID() / crypto.subtle.digest() / crypto?.x / crypto['x'] /
+      // globalThis.crypto.randomUUID() / window.crypto.getRandomValues() 等成员访问
+      MemberExpression(node) {
+        const member = node;
+        const ref = cryptoRefName(member.object);
+        if (!ref || suppressed()) return;
+        context.report({
+          node,
+          messageId: "noGlobalCrypto",
+          data: { expr: renderExpr(member, ref) }
+        });
+      },
+      // const c = crypto / const { randomUUID } = crypto / const c = window.crypto 等读取
+      VariableDeclarator(node) {
+        const decl = node;
+        const ref = cryptoRefName(decl.init);
+        if (!ref || suppressed()) return;
+        context.report({
+          node: decl.init,
+          messageId: "noGlobalCrypto",
+          data: { expr: ref }
+        });
+      },
+      // { ...crypto } / [ ...crypto ] / f(...crypto)
+      SpreadElement(node) {
+        const spread = node;
+        const ref = cryptoRefName(spread.argument);
+        if (!ref || suppressed()) return;
+        context.report({
+          node: spread.argument,
+          messageId: "noGlobalCrypto",
+          data: { expr: ref }
+        });
+      }
+    };
+  }
+};
+var plugin = {
+  meta: { name: "no-bare-web-crypto" },
+  rules: { "no-bare-web-crypto": noBareWebCryptoRule }
+};
+var no_bare_web_crypto_default = plugin;
+module.exports = module.exports.default;