miaoda-expo-devkit 0.1.1-beta.98 → 0.1.1-dev.development-build.1

package/dist/index.d.mts

@@ -1,111 +1,2 @@
-import { ErrorEvent, EventHint, Breadcrumb, BreadcrumbHint } from '@sentry/core';
 
-/**
- * Sentry Capture 模块
- *
- * 提供 Metro 符号化（MetroSymbolicator）和 Sentry 事件捕获（SentryCapture）。
- */
-
-/** Metro /symbolicate 接口的帧格式（请求与响应共用）。 */
-interface MetroFrame {
-    file: string;
-    lineNumber: number;
-    column: number;
-    methodName: string;
-}
-/** SentryCapture.onError 回调参数 */
-interface ErrorCaptureInfo {
-    message: string;
-    symbolicatedFrames: MetroFrame[] | null;
-    componentStack: string | null;
-    /** Sentry Mechanism.type，如 'onerror' / 'generic' / 'auto.function.react.error_boundary' */
-    mechanismType: string | null;
-}
-/** SentryCapture.onNetwork 回调参数 */
-interface NetworkCaptureInfo {
-    method: string | null;
-    url: string | null;
-    statusCode: number | null;
-}
-interface SentryCaptureOptions {
-    onError?: (info: ErrorCaptureInfo) => void;
-    onNetwork?: (info: NetworkCaptureInfo) => void;
-    /** 可注入 mock 实例以在单元测试中隔离网络依赖 */
-    symbolicator?: MetroSymbolicator;
-}
-/**
- * Metro 符号化器。
- * 将 bundle 行列号还原为源码位置（通过 Metro /symbolicate 接口）。
- *
- * @example
- * const sym = new MetroSymbolicator();
- *
- * @example
- * // 单测：注入 baseUrl 并 mock fetch
- * const sym = new MetroSymbolicator({ baseUrl: 'http://localhost:8081' });
- * global.fetch = jest.fn().mockResolvedValue({ ok: true, json: async () => ({ stack: [...] }) });
- */
-declare class MetroSymbolicator {
-    readonly baseUrl: string;
-    constructor({ baseUrl }?: {
-        baseUrl?: string;
-    });
-    /**
-     * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-     * web 平台使用相对路径；native 回退到 localhost:8081。
-     */
-    private static _getDefaultBaseUrl;
-    /**
-     * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-     *
-     * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-     *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-     *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-     *   JavaScriptCore(iOS)：methodName@url:line:col
-     *
-     * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-     */
-    parseErrorStack(stack: string): MetroFrame[];
-    /**
-     * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-     */
-    symbolicate(stack: MetroFrame[]): Promise<MetroFrame[] | null>;
-}
-/**
- * Sentry 事件捕获器。
- * 封装 beforeSend / beforeBreadcrumb 逻辑，通过注入的回调将事件数据交给调用方处理。
- *
- * @example
- * const capture = new SentryCapture({
- *   onError(info) { console.log(info.message, info.symbolicatedFrames); },
- *   onNetwork(info) { console.log(info.method, info.url, info.statusCode); },
- * });
- * Sentry.init({ dsn: '...', beforeSend: capture.beforeSend, beforeBreadcrumb: capture.beforeBreadcrumb });
- *
- * @example
- * // 单测：注入 mock symbolicator
- * const mockSym = { parseErrorStack: jest.fn(() => []), symbolicate: jest.fn(async () => null) };
- * const onError = jest.fn();
- * const capture = new SentryCapture({ onError, symbolicator: mockSym });
- * await capture.beforeSend(fakeEvent, { originalException: new Error('oops') });
- * expect(onError).toHaveBeenCalledWith(expect.objectContaining({ message: 'oops' }));
- */
-declare class SentryCapture {
-    private readonly onError;
-    private readonly onNetwork;
-    private readonly symbolicator;
-    constructor({ onError, onNetwork, symbolicator }?: SentryCaptureOptions);
-    /**
-     * Sentry beforeSend hook。
-     * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-     * 符号化完成后触发 onError 回调，原样返回 event。
-     */
-    beforeSend(event: ErrorEvent, hint: EventHint): Promise<ErrorEvent>;
-    /**
-     * Sentry beforeBreadcrumb hook。
-     * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-     */
-    beforeBreadcrumb(breadcrumb: Breadcrumb, _hint?: BreadcrumbHint): Breadcrumb;
-}
-
-export { type ErrorCaptureInfo, type MetroFrame, MetroSymbolicator, type NetworkCaptureInfo, SentryCapture, type SentryCaptureOptions };
+export {  }

package/dist/index.d.ts

@@ -1,111 +1,2 @@
-import { ErrorEvent, EventHint, Breadcrumb, BreadcrumbHint } from '@sentry/core';
 
-/**
- * Sentry Capture 模块
- *
- * 提供 Metro 符号化（MetroSymbolicator）和 Sentry 事件捕获（SentryCapture）。
- */
-
-/** Metro /symbolicate 接口的帧格式（请求与响应共用）。 */
-interface MetroFrame {
-    file: string;
-    lineNumber: number;
-    column: number;
-    methodName: string;
-}
-/** SentryCapture.onError 回调参数 */
-interface ErrorCaptureInfo {
-    message: string;
-    symbolicatedFrames: MetroFrame[] | null;
-    componentStack: string | null;
-    /** Sentry Mechanism.type，如 'onerror' / 'generic' / 'auto.function.react.error_boundary' */
-    mechanismType: string | null;
-}
-/** SentryCapture.onNetwork 回调参数 */
-interface NetworkCaptureInfo {
-    method: string | null;
-    url: string | null;
-    statusCode: number | null;
-}
-interface SentryCaptureOptions {
-    onError?: (info: ErrorCaptureInfo) => void;
-    onNetwork?: (info: NetworkCaptureInfo) => void;
-    /** 可注入 mock 实例以在单元测试中隔离网络依赖 */
-    symbolicator?: MetroSymbolicator;
-}
-/**
- * Metro 符号化器。
- * 将 bundle 行列号还原为源码位置（通过 Metro /symbolicate 接口）。
- *
- * @example
- * const sym = new MetroSymbolicator();
- *
- * @example
- * // 单测：注入 baseUrl 并 mock fetch
- * const sym = new MetroSymbolicator({ baseUrl: 'http://localhost:8081' });
- * global.fetch = jest.fn().mockResolvedValue({ ok: true, json: async () => ({ stack: [...] }) });
- */
-declare class MetroSymbolicator {
-    readonly baseUrl: string;
-    constructor({ baseUrl }?: {
-        baseUrl?: string;
-    });
-    /**
-     * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-     * web 平台使用相对路径；native 回退到 localhost:8081。
-     */
-    private static _getDefaultBaseUrl;
-    /**
-     * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-     *
-     * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-     *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-     *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-     *   JavaScriptCore(iOS)：methodName@url:line:col
-     *
-     * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-     */
-    parseErrorStack(stack: string): MetroFrame[];
-    /**
-     * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-     */
-    symbolicate(stack: MetroFrame[]): Promise<MetroFrame[] | null>;
-}
-/**
- * Sentry 事件捕获器。
- * 封装 beforeSend / beforeBreadcrumb 逻辑，通过注入的回调将事件数据交给调用方处理。
- *
- * @example
- * const capture = new SentryCapture({
- *   onError(info) { console.log(info.message, info.symbolicatedFrames); },
- *   onNetwork(info) { console.log(info.method, info.url, info.statusCode); },
- * });
- * Sentry.init({ dsn: '...', beforeSend: capture.beforeSend, beforeBreadcrumb: capture.beforeBreadcrumb });
- *
- * @example
- * // 单测：注入 mock symbolicator
- * const mockSym = { parseErrorStack: jest.fn(() => []), symbolicate: jest.fn(async () => null) };
- * const onError = jest.fn();
- * const capture = new SentryCapture({ onError, symbolicator: mockSym });
- * await capture.beforeSend(fakeEvent, { originalException: new Error('oops') });
- * expect(onError).toHaveBeenCalledWith(expect.objectContaining({ message: 'oops' }));
- */
-declare class SentryCapture {
-    private readonly onError;
-    private readonly onNetwork;
-    private readonly symbolicator;
-    constructor({ onError, onNetwork, symbolicator }?: SentryCaptureOptions);
-    /**
-     * Sentry beforeSend hook。
-     * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-     * 符号化完成后触发 onError 回调，原样返回 event。
-     */
-    beforeSend(event: ErrorEvent, hint: EventHint): Promise<ErrorEvent>;
-    /**
-     * Sentry beforeBreadcrumb hook。
-     * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-     */
-    beforeBreadcrumb(breadcrumb: Breadcrumb, _hint?: BreadcrumbHint): Breadcrumb;
-}
-
-export { type ErrorCaptureInfo, type MetroFrame, MetroSymbolicator, type NetworkCaptureInfo, SentryCapture, type SentryCaptureOptions };
+export {  }

package/dist/index.js

@@ -1,161 +1,2 @@
 "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/index.ts
-var src_exports = {};
-__export(src_exports, {
-  MetroSymbolicator: () => MetroSymbolicator,
-  SentryCapture: () => SentryCapture
-});
-module.exports = __toCommonJS(src_exports);
-
-// src/capture.ts
-var import_stacktrace_parser = require("stacktrace-parser");
-var import_react_native = require("react-native");
-var MetroSymbolicator = class _MetroSymbolicator {
-  constructor({ baseUrl } = {}) {
-    this.baseUrl = baseUrl ?? _MetroSymbolicator._getDefaultBaseUrl();
-  }
-  /**
-   * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-   * web 平台使用相对路径；native 回退到 localhost:8081。
-   */
-  static _getDefaultBaseUrl() {
-    try {
-      const scriptURL = import_react_native.NativeModules?.SourceCode?.scriptURL;
-      if (scriptURL) {
-        const url = new URL(scriptURL);
-        return `${url.protocol}//${url.host}`;
-      }
-    } catch (_) {
-    }
-    return import_react_native.Platform.OS === "web" ? "" : "http://localhost:8081";
-  }
-  /**
-   * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-   *
-   * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-   *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-   *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-   *   JavaScriptCore(iOS)：methodName@url:line:col
-   *
-   * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-   */
-  parseErrorStack(stack) {
-    return (0, import_stacktrace_parser.parse)(stack).filter(
-      (f) => f.file != null && f.lineNumber != null
-    ).map((f) => ({
-      file: f.file,
-      lineNumber: f.lineNumber,
-      column: f.column != null ? f.column - 1 : 0,
-      methodName: f.methodName === "<unknown>" ? "(anonymous)" : f.methodName
-    }));
-  }
-  /**
-   * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-   */
-  async symbolicate(stack) {
-    if (stack.length === 0) return null;
-    const endpoint = `${this.baseUrl}/symbolicate`;
-    try {
-      const res = await fetch(endpoint, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ stack })
-      });
-      if (!res.ok) {
-        console.warn(`[SentryCapture] /symbolicate returned ${res.status}`);
-        return null;
-      }
-      const data = await res.json();
-      return data.stack ?? null;
-    } catch (e) {
-      console.warn("[SentryCapture] symbolication failed:", e?.message ?? e);
-      return null;
-    }
-  }
-};
-var SentryCapture = class {
-  constructor({ onError, onNetwork, symbolicator } = {}) {
-    this.onError = onError;
-    this.onNetwork = onNetwork;
-    this.symbolicator = symbolicator ?? new MetroSymbolicator();
-    this.beforeSend = this.beforeSend.bind(this);
-    this.beforeBreadcrumb = this.beforeBreadcrumb.bind(this);
-  }
-  /**
-   * Sentry beforeSend hook。
-   * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-   * 符号化完成后触发 onError 回调，原样返回 event。
-   */
-  async beforeSend(event, hint) {
-    globalThis.__SENTRY_LAST_RAW__ = { event, hint };
-    const message = event.exception?.values?.[0]?.value ?? event.message ?? "(unknown)";
-    let symbolicatedFrames = null;
-    const originalException = hint?.originalException;
-    const rawStack = originalException instanceof Error && typeof originalException.stack === "string" ? originalException.stack : null;
-    if (rawStack !== null) {
-      const frames = this.symbolicator.parseErrorStack(rawStack);
-      if (frames.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(frames);
-      }
-    }
-    if (symbolicatedFrames === null) {
-      const sentryFrames = event.exception?.values?.[0]?.stacktrace?.frames ?? [];
-      const mapped = sentryFrames.filter(
-        (f) => f.filename != null && f.lineno != null
-      ).map(
-        (f) => ({
-          file: f.filename,
-          lineNumber: f.lineno,
-          column: f.colno ?? 0,
-          methodName: f.function ?? "(anonymous)"
-        })
-      );
-      if (mapped.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(mapped);
-      }
-    }
-    const componentStack = event.contexts?.react?.componentStack ?? null;
-    const mechanismType = event.exception?.values?.[0]?.mechanism?.type ?? null;
-    this.onError?.({ message, symbolicatedFrames, componentStack, mechanismType });
-    return event;
-  }
-  /**
-   * Sentry beforeBreadcrumb hook。
-   * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-   */
-  beforeBreadcrumb(breadcrumb, _hint) {
-    if (breadcrumb.type === "http") {
-      const data = breadcrumb.data;
-      this.onNetwork?.({
-        method: data?.method ?? null,
-        url: data?.url ?? null,
-        statusCode: data?.status_code ?? null
-      });
-    }
-    return breadcrumb;
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  MetroSymbolicator,
-  SentryCapture
-});
 //# sourceMappingURL=index.js.map

package/dist/index.mjs

@@ -1,133 +1 @@
-// src/capture.ts
-import { parse as parseStackTrace } from "stacktrace-parser";
-import { NativeModules, Platform } from "react-native";
-var MetroSymbolicator = class _MetroSymbolicator {
-  constructor({ baseUrl } = {}) {
-    this.baseUrl = baseUrl ?? _MetroSymbolicator._getDefaultBaseUrl();
-  }
-  /**
-   * 从 NativeModules.SourceCode.scriptURL 推断 Metro server base URL。
-   * web 平台使用相对路径；native 回退到 localhost:8081。
-   */
-  static _getDefaultBaseUrl() {
-    try {
-      const scriptURL = NativeModules?.SourceCode?.scriptURL;
-      if (scriptURL) {
-        const url = new URL(scriptURL);
-        return `${url.protocol}//${url.host}`;
-      }
-    } catch (_) {
-    }
-    return Platform.OS === "web" ? "" : "http://localhost:8081";
-  }
-  /**
-   * 解析 Error.stack 字符串为 Metro 所需的帧数组。
-   *
-   * 使用 stacktrace-parser 覆盖各 JS 引擎的格式：
-   *   V8/Node.js/Hermes(新)：at methodName (url:line:col)
-   *   Gecko/Firefox/Hermes(旧)：methodName@url:line:col
-   *   JavaScriptCore(iOS)：methodName@url:line:col
-   *
-   * 无法符号化的帧（file 或 lineNumber 为 null）会被过滤掉。
-   */
-  parseErrorStack(stack) {
-    return parseStackTrace(stack).filter(
-      (f) => f.file != null && f.lineNumber != null
-    ).map((f) => ({
-      file: f.file,
-      lineNumber: f.lineNumber,
-      column: f.column != null ? f.column - 1 : 0,
-      methodName: f.methodName === "<unknown>" ? "(anonymous)" : f.methodName
-    }));
-  }
-  /**
-   * 将帧列表发送到 Metro /symbolicate，返回符号化后的帧数组。
-   */
-  async symbolicate(stack) {
-    if (stack.length === 0) return null;
-    const endpoint = `${this.baseUrl}/symbolicate`;
-    try {
-      const res = await fetch(endpoint, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ stack })
-      });
-      if (!res.ok) {
-        console.warn(`[SentryCapture] /symbolicate returned ${res.status}`);
-        return null;
-      }
-      const data = await res.json();
-      return data.stack ?? null;
-    } catch (e) {
-      console.warn("[SentryCapture] symbolication failed:", e?.message ?? e);
-      return null;
-    }
-  }
-};
-var SentryCapture = class {
-  constructor({ onError, onNetwork, symbolicator } = {}) {
-    this.onError = onError;
-    this.onNetwork = onNetwork;
-    this.symbolicator = symbolicator ?? new MetroSymbolicator();
-    this.beforeSend = this.beforeSend.bind(this);
-    this.beforeBreadcrumb = this.beforeBreadcrumb.bind(this);
-  }
-  /**
-   * Sentry beforeSend hook。
-   * 优先使用原始 Error.stack 进行符号化；若无法获取则回退到 Sentry 事件帧。
-   * 符号化完成后触发 onError 回调，原样返回 event。
-   */
-  async beforeSend(event, hint) {
-    globalThis.__SENTRY_LAST_RAW__ = { event, hint };
-    const message = event.exception?.values?.[0]?.value ?? event.message ?? "(unknown)";
-    let symbolicatedFrames = null;
-    const originalException = hint?.originalException;
-    const rawStack = originalException instanceof Error && typeof originalException.stack === "string" ? originalException.stack : null;
-    if (rawStack !== null) {
-      const frames = this.symbolicator.parseErrorStack(rawStack);
-      if (frames.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(frames);
-      }
-    }
-    if (symbolicatedFrames === null) {
-      const sentryFrames = event.exception?.values?.[0]?.stacktrace?.frames ?? [];
-      const mapped = sentryFrames.filter(
-        (f) => f.filename != null && f.lineno != null
-      ).map(
-        (f) => ({
-          file: f.filename,
-          lineNumber: f.lineno,
-          column: f.colno ?? 0,
-          methodName: f.function ?? "(anonymous)"
-        })
-      );
-      if (mapped.length > 0) {
-        symbolicatedFrames = await this.symbolicator.symbolicate(mapped);
-      }
-    }
-    const componentStack = event.contexts?.react?.componentStack ?? null;
-    const mechanismType = event.exception?.values?.[0]?.mechanism?.type ?? null;
-    this.onError?.({ message, symbolicatedFrames, componentStack, mechanismType });
-    return event;
-  }
-  /**
-   * Sentry beforeBreadcrumb hook。
-   * 识别 HTTP 类型的 breadcrumb，触发 onNetwork 回调，原样返回 breadcrumb。
-   */
-  beforeBreadcrumb(breadcrumb, _hint) {
-    if (breadcrumb.type === "http") {
-      const data = breadcrumb.data;
-      this.onNetwork?.({
-        method: data?.method ?? null,
-        url: data?.url ?? null,
-        statusCode: data?.status_code ?? null
-      });
-    }
-    return breadcrumb;
-  }
-};
-export {
-  MetroSymbolicator,
-  SentryCapture
-};
 //# sourceMappingURL=index.mjs.map

package/dist/metro.d.mts

@@ -58,9 +58,10 @@ declare function withNativeWind(config: MetroConfig, options?: any): MetroConfig
 /**
  * withEntryInjection — 在 expo-router 启动前注入脚本
  *
- * 拦截 expo-router/entry-classic 的解析，重定向到 expo-router-entry-stub.js。
- * stub 先 require entry-inject.js，再 require expo-router/entry-classic，
- * 使注入脚本在 expo-router renderRootComponent 之前执行。
+ * 拦截 expo-router/entry-classic 的解析，重定向到平台对应的入口 stub。
+ * Web 使用 expo-router-entry-stub.js；iOS/Android 使用
+ * expo-router-entry-native-stub.js。入口 stub 会在 expo-router 注册应用前
+ * 执行 DevKit 的公共运行时初始化。
  *
  * 拦截 entry-classic 而非 entry 本身：expo-router/entry 通过 <script src="...entry.bundle">
  * 直接加载，不经过 resolveRequest；其内部的 import 'expo-router/entry-classic' 才经过 resolveRequest。
@@ -120,9 +121,10 @@ declare function withRouteEndpoint(config: MetroConfig, options: RouteEndpointOp
  *   withExpoNotificationsStub   — Android：expo-notifications → stub（Expo Go no-op，Dev Build 透传）
  *   withExpoMediaLibraryStub    — Web / Expo Go：expo-media-library → stub（弹 Alert 提示，Dev Build 透传）
  *   withExpoCalendarStub        — Web / Expo Go：expo-calendar → stub（弹 Alert 提示，Dev Build 透传）
+ *   withExpoNativeWechatStub    — Web / Expo Go：expo-native-wechat → stub（弹 Dialog/Alert 提示，Dev Build 透传）
  *   withExpoFileSystemStub      — Web：expo-file-system/legacy → stub（弹 Dialog 提示，原生透传）
  *   withExpoImagePickerStub     — Web 桌面：launchCameraAsync 用 getUserMedia 唤起摄像头
- *   withEntryInjection          — 在 expo-router 启动前注入脚本（仅 __DEV__）
+ *   withEntryInjection          — 在 expo-router 启动前注入公共运行时策略（仅 __DEV__）
  *   withDevStubs                — 替换 Sentry DSN / 屏蔽 LogBox（仅 __DEV__）
  *   withRouteEndpoint           — 添加 /__routes 端点（仅 __DEV__）
  *   withNativeWind              — NativeWind 支持（含缓存路径修复）
@@ -306,6 +308,24 @@ declare function withExpoMediaLibraryStub(config: MetroConfig): MetroConfig;
  */
 declare function withExpoCalendarStub(config: MetroConfig): MetroConfig;
 
+/**
+ * withExpoNativeWechatStub — Web 平台将 expo-native-wechat 替换为 stub
+ *
+ * expo-native-wechat 的 module.ts 在 import 时无条件调用
+ * requireNativeModule('ExpoNativeWechat')，Web 环境下没有该 native module 会直接抛错。
+ *
+ * stub 运行时行为：
+ *   - Web：no-op，设置/查询类 API 静默返回占位值，业务动作类 API（分享、
+ *     支付、授权等）弹出 Dialog 提示当前环境不支持并 reject
+ *   - Development Build（原生）：透传真实 expo-native-wechat，功能完全正常
+ */
+
+/**
+ * @param config  Metro config 对象
+ * @returns       注入 resolveRequest 后的新 Metro config
+ */
+declare function withExpoNativeWechatStub(config: MetroConfig): MetroConfig;
+
 /**
  * withExpoFileSystemStub — Web 端将 expo-file-system 系列模块替换为 stub
  *
@@ -500,4 +520,4 @@ interface PersistentCacheOptions {
 }
 declare function withPersistentCache(config: MetroConfig, options?: PersistentCacheOptions): MetroConfig;
 
-export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type PersistentCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoCameraRecordStub, withExpoContactsStub, withExpoFileSystemStub, withExpoHapticsStub, withExpoImagePickerStub, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withPersistentCache, withRouteEndpoint, withTransformLogger, withWasmSupport, withWorkspaceNodeModules };
+export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type PersistentCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoCameraRecordStub, withExpoContactsStub, withExpoFileSystemStub, withExpoHapticsStub, withExpoImagePickerStub, withExpoMediaLibraryStub, withExpoNativeWechatStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withPersistentCache, withRouteEndpoint, withTransformLogger, withWasmSupport, withWorkspaceNodeModules };

package/dist/metro.d.ts

@@ -58,9 +58,10 @@ declare function withNativeWind(config: MetroConfig, options?: any): MetroConfig
 /**
  * withEntryInjection — 在 expo-router 启动前注入脚本
  *
- * 拦截 expo-router/entry-classic 的解析，重定向到 expo-router-entry-stub.js。
- * stub 先 require entry-inject.js，再 require expo-router/entry-classic，
- * 使注入脚本在 expo-router renderRootComponent 之前执行。
+ * 拦截 expo-router/entry-classic 的解析，重定向到平台对应的入口 stub。
+ * Web 使用 expo-router-entry-stub.js；iOS/Android 使用
+ * expo-router-entry-native-stub.js。入口 stub 会在 expo-router 注册应用前
+ * 执行 DevKit 的公共运行时初始化。
  *
  * 拦截 entry-classic 而非 entry 本身：expo-router/entry 通过 <script src="...entry.bundle">
  * 直接加载，不经过 resolveRequest；其内部的 import 'expo-router/entry-classic' 才经过 resolveRequest。
@@ -120,9 +121,10 @@ declare function withRouteEndpoint(config: MetroConfig, options: RouteEndpointOp
  *   withExpoNotificationsStub   — Android：expo-notifications → stub（Expo Go no-op，Dev Build 透传）
  *   withExpoMediaLibraryStub    — Web / Expo Go：expo-media-library → stub（弹 Alert 提示，Dev Build 透传）
  *   withExpoCalendarStub        — Web / Expo Go：expo-calendar → stub（弹 Alert 提示，Dev Build 透传）
+ *   withExpoNativeWechatStub    — Web / Expo Go：expo-native-wechat → stub（弹 Dialog/Alert 提示，Dev Build 透传）
  *   withExpoFileSystemStub      — Web：expo-file-system/legacy → stub（弹 Dialog 提示，原生透传）
  *   withExpoImagePickerStub     — Web 桌面：launchCameraAsync 用 getUserMedia 唤起摄像头
- *   withEntryInjection          — 在 expo-router 启动前注入脚本（仅 __DEV__）
+ *   withEntryInjection          — 在 expo-router 启动前注入公共运行时策略（仅 __DEV__）
  *   withDevStubs                — 替换 Sentry DSN / 屏蔽 LogBox（仅 __DEV__）
  *   withRouteEndpoint           — 添加 /__routes 端点（仅 __DEV__）
  *   withNativeWind              — NativeWind 支持（含缓存路径修复）
@@ -306,6 +308,24 @@ declare function withExpoMediaLibraryStub(config: MetroConfig): MetroConfig;
  */
 declare function withExpoCalendarStub(config: MetroConfig): MetroConfig;
 
+/**
+ * withExpoNativeWechatStub — Web 平台将 expo-native-wechat 替换为 stub
+ *
+ * expo-native-wechat 的 module.ts 在 import 时无条件调用
+ * requireNativeModule('ExpoNativeWechat')，Web 环境下没有该 native module 会直接抛错。
+ *
+ * stub 运行时行为：
+ *   - Web：no-op，设置/查询类 API 静默返回占位值，业务动作类 API（分享、
+ *     支付、授权等）弹出 Dialog 提示当前环境不支持并 reject
+ *   - Development Build（原生）：透传真实 expo-native-wechat，功能完全正常
+ */
+
+/**
+ * @param config  Metro config 对象
+ * @returns       注入 resolveRequest 后的新 Metro config
+ */
+declare function withExpoNativeWechatStub(config: MetroConfig): MetroConfig;
+
 /**
  * withExpoFileSystemStub — Web 端将 expo-file-system 系列模块替换为 stub
  *
@@ -500,4 +520,4 @@ interface PersistentCacheOptions {
 }
 declare function withPersistentCache(config: MetroConfig, options?: PersistentCacheOptions): MetroConfig;
 
-export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type PersistentCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoCameraRecordStub, withExpoContactsStub, withExpoFileSystemStub, withExpoHapticsStub, withExpoImagePickerStub, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withPersistentCache, withRouteEndpoint, withTransformLogger, withWasmSupport, withWorkspaceNodeModules };
+export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type PersistentCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoCameraRecordStub, withExpoContactsStub, withExpoFileSystemStub, withExpoHapticsStub, withExpoImagePickerStub, withExpoMediaLibraryStub, withExpoNativeWechatStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withPersistentCache, withRouteEndpoint, withTransformLogger, withWasmSupport, withWorkspaceNodeModules };