miaoda-expo-devkit 0.1.1-beta.30 → 0.1.1-beta.32

package/README.md

@@ -7,6 +7,8 @@ Expo / React Native 开发环境工具集，通过 Metro 构建层注入以下
 - **Bundle 首部注入** — 在 expo-router 初始化之前执行自定义脚本
 - **HMR postMessage 控制** — 通过 `window.postMessage` 在运行时启动或停止 Fast Refresh
 - **LogBox 屏蔽** — web 平台禁用 Expo 全屏错误遮罩
+- **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 原生环境透传真实模块
 
 ## 安装
 
@@ -32,16 +34,16 @@ pnpm install
 ```js
 // metro.config.js
 const { getDefaultConfig } = require('expo/metro-config');
-const { withDevStubs, withEntryInjection } = require('miaoda-expo-devkit/metro');
+const { withDevkit } = require('miaoda-expo-devkit/metro');
 
-const config = getDefaultConfig(__dirname);
-module.exports = withEntryInjection(withDevStubs(config));
+module.exports = withDevkit(getDefaultConfig(__dirname));
 ```
 
-支持与其他 Metro wrapper 链式组合：
+`withDevkit` 已内置所有 wrapper（含 expo-notifications、expo-media-library stub），无需手动叠加。也可单独使用各 wrapper：
 
 ```js
-module.exports = withNativeWind(withEntryInjection(withDevStubs(config)), { input: './global.css' });
+const { withDevStubs, withEntryInjection, withExpoMediaLibraryStub } = require('miaoda-expo-devkit/metro');
+module.exports = withExpoMediaLibraryStub(withEntryInjection(withDevStubs(config)));
 ```
 
 ### Sentry 初始化
@@ -225,12 +227,22 @@ expect(onError).toHaveBeenCalledWith(
 
 ```
 metro.config.js
-  └─ withEntryInjection(withDevStubs(config))
+  └─ withDevkit(config)
        │
        ├─ withDevStubs → resolver.resolveRequest
        │    ├─ @sentry/react-native        →  dist/stubs/sentry-react-native-stub.js  （全平台）
        │    └─ @expo/log-box               →  dist/stubs/no-op-logbox.js              （仅 web）
        │
+       ├─ withExpoNotificationsStub → resolver.resolveRequest
+       │    └─ expo-notifications          →  dist/stubs/expo-notifications-stub.js   （仅 Android）
+       │         ├─ Expo Go：no-op + 调试 Alert（含参数校验）
+       │         └─ Dev Build：透传真实 expo-notifications
+       │
+       ├─ withExpoMediaLibraryStub → resolver.resolveRequest
+       │    └─ expo-media-library          →  dist/stubs/expo-media-library-stub.js   （全平台）
+       │         ├─ Expo Go / Web：no-op + Alert 提示（不崩溃）
+       │         └─ Dev Build（原生）：透传真实 expo-media-library
+       │
        └─ withEntryInjection → resolver.resolveRequest
             └─ expo-router/entry-classic   →  dist/stubs/expo-router-entry-stub.js
                  ├─ require('./entry-inject')           ← 注入脚本（bundle 首部执行）
@@ -262,11 +274,13 @@ sentry-react-native-stub.js
 | 子路径 | 文件 | 内容 |
 |---|---|---|
 | `.` | `dist/index.js` | `SentryCapture`、`MetroSymbolicator`、全部类型 |
-| `./metro` | `dist/metro.js` | `withDevStubs`、`withEntryInjection` |
+| `./metro` | `dist/metro.js` | `withDevkit`、`withDevStubs`、`withEntryInjection`、`withExpoNotificationsStub`、`withExpoMediaLibraryStub` 等 |
 | `./babel-plugin-jsx-source` | `dist/babel/plugin-jsx-source.js` | Babel 插件：为 JSX 注入 source 信息 |
 | `./babel-preset` | `dist/babel/preset.js` | Babel Preset：集成 jsx-source 和 lucide 插件 |
 | `./sentry-react-native-stub` | `dist/stubs/sentry-react-native-stub.js` | `@sentry/react-native` 模块替换 stub |
 | `./no-op-logbox` | `dist/stubs/no-op-logbox.js` | LogBox no-op stub |
+| `./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 |
 
 ---
 
@@ -389,6 +403,48 @@ LogBox no-op stub，用于 web 平台禁用 Expo 全屏错误遮罩。
 
 ---
 
+### expo-notifications-stub.js
+
+`expo-notifications` 模块替换 stub，由 `withExpoNotificationsStub()` 在 Metro 层注入（**仅 Android 平台**）。
+
+**背景：** Expo SDK 53 起，`expo-notifications` 的 Android native module 已从 Expo Go 中移除，直接 import 会在 Expo Go 启动时崩溃。
+
+**运行时行为：**
+- **Expo Go（Android）**：提供 no-op 实现，`requestPermissionsAsync`、`setNotificationChannelAsync`、`scheduleNotificationAsync` 等核心 API 调用时弹出带参数校验的调试 Alert
+- **Development Build（Android）**：透传真实 `expo-notifications`，功能完全正常
+- **iOS（任意）**：不经过此 stub，直接使用真实 `expo-notifications`
+
+**手动验证：** 在 `devkit-e2e` App 中扫码进入「Notification Stub 验证」页面，逐按钮触发并对照期望结果。
+
+---
+
+### expo-media-library-stub.js
+
+`expo-media-library` 模块替换 stub，由 `withExpoMediaLibraryStub()` 在 Metro 层注入（**全平台**）。
+
+**背景：** `expo-media-library` 依赖原生相册 API，在 Expo Go 和 Web 环境中不可用，调用 `saveToLibraryAsync` 等 API 会直接崩溃。
+
+**运行时行为：**
+- **Expo Go / Web**：提供 no-op 实现，以下 API 调用时弹出 Alert 提示（不崩溃）：
+  - `usePermissions()` — 返回 `{ status: 'undetermined', granted: false }`，`requestPermission()` 弹 Alert
+  - `requestPermissionsAsync()` / `getPermissionsAsync()` — 前者弹 Alert，后者静默返回 denied
+  - `saveToLibraryAsync(uri)` — 弹 Alert 显示操作和 URI（超 60 字符自动截断）
+  - `createAssetAsync(uri)` — 弹 Alert 并返回合法的伪资产对象
+  - 其他未知 API — Proxy 兜底，静默返回 `undefined`；以 `PermissionsAsync` 结尾的 API 返回 denied 结构
+- **Development Build（原生）**：透传真实 `expo-media-library`，功能完全正常
+
+**Alert 消息格式：**
+```
+保存到相册
+Expo Go 扫码预览不支持访问手机相册
+操作: 图片: file:///tmp/test.jpg
+发布为正式 App 后可正常使用
+```
+
+**手动验证：** 在 `devkit-e2e` App 中扫码进入「Media Library Stub 验证」页面，逐按钮触发并对照期望结果。
+
+---
+
 ## Babel 插件：jsx-source
 
 `babel-plugin-jsx-source` 为 JSX 元素注入 source 属性（文件路径、行列号），用于开发调试。通过 `dataSet` 对象注入，这是 React Web 可识别的数据通道。

package/dist/metro.d.mts

@@ -116,6 +116,7 @@ declare function withRouteEndpoint(config: MetroConfig, options: RouteEndpointOp
  *   withEsbuildMinify           — 将 Metro minifier 切换为 esbuild（仅生产构建生效）
  *   withLucideResolver          — 消除 lucide 子路径未在 exports 声明时的 warning
  *   withExpoNotificationsStub   — Android：expo-notifications → stub（Expo Go no-op，Dev Build 透传）
+ *   withExpoMediaLibraryStub    — Web / Expo Go：expo-media-library → stub（弹 Alert 提示，Dev Build 透传）
  *   withEntryInjection          — 在 expo-router 启动前注入脚本（仅 __DEV__）
  *   withDevStubs                — 替换 Sentry DSN / 屏蔽 LogBox（仅 __DEV__）
  *   withRouteEndpoint           — 添加 /__routes 端点（仅 __DEV__）
@@ -258,6 +259,23 @@ declare function withLucideResolver(config: MetroConfig, options?: WithLucideRes
  */
 declare function withExpoNotificationsStub(config: MetroConfig): MetroConfig;
 
+/**
+ * withExpoMediaLibraryStub — Web / Expo Go 将 expo-media-library 替换为 stub
+ *
+ * expo-media-library 依赖 native module，在 Web 和 Expo Go 中不可用。
+ * stub 在运行时通过 Platform.OS 和 isRunningInExpoGo() 判断：
+ *   - Web / Expo Go：no-op（核心 API 弹 Alert 提示，不崩溃）
+ *   - Development Build（原生）：透传真实 expo-media-library，功能完全正常
+ *
+ * 此 wrapper 需要在开发和生产构建中均生效，因为 native module 缺失是运行时问题。
+ */
+
+/**
+ * @param config  Metro config 对象
+ * @returns       注入 resolveRequest 后的新 Metro config
+ */
+declare function withExpoMediaLibraryStub(config: MetroConfig): MetroConfig;
+
 /**
  * 将 Metro transformer 的 minifier 切换为 esbuild。
  *
@@ -270,4 +288,4 @@ declare function withExpoNotificationsStub(config: MetroConfig): MetroConfig;
  */
 declare function withEsbuildMinify(config: MetroConfig): MetroConfig;
 
-export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWorkspaceNodeModules };
+export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWorkspaceNodeModules };

package/dist/metro.d.ts

@@ -116,6 +116,7 @@ declare function withRouteEndpoint(config: MetroConfig, options: RouteEndpointOp
  *   withEsbuildMinify           — 将 Metro minifier 切换为 esbuild（仅生产构建生效）
  *   withLucideResolver          — 消除 lucide 子路径未在 exports 声明时的 warning
  *   withExpoNotificationsStub   — Android：expo-notifications → stub（Expo Go no-op，Dev Build 透传）
+ *   withExpoMediaLibraryStub    — Web / Expo Go：expo-media-library → stub（弹 Alert 提示，Dev Build 透传）
  *   withEntryInjection          — 在 expo-router 启动前注入脚本（仅 __DEV__）
  *   withDevStubs                — 替换 Sentry DSN / 屏蔽 LogBox（仅 __DEV__）
  *   withRouteEndpoint           — 添加 /__routes 端点（仅 __DEV__）
@@ -258,6 +259,23 @@ declare function withLucideResolver(config: MetroConfig, options?: WithLucideRes
  */
 declare function withExpoNotificationsStub(config: MetroConfig): MetroConfig;
 
+/**
+ * withExpoMediaLibraryStub — Web / Expo Go 将 expo-media-library 替换为 stub
+ *
+ * expo-media-library 依赖 native module，在 Web 和 Expo Go 中不可用。
+ * stub 在运行时通过 Platform.OS 和 isRunningInExpoGo() 判断：
+ *   - Web / Expo Go：no-op（核心 API 弹 Alert 提示，不崩溃）
+ *   - Development Build（原生）：透传真实 expo-media-library，功能完全正常
+ *
+ * 此 wrapper 需要在开发和生产构建中均生效，因为 native module 缺失是运行时问题。
+ */
+
+/**
+ * @param config  Metro config 对象
+ * @returns       注入 resolveRequest 后的新 Metro config
+ */
+declare function withExpoMediaLibraryStub(config: MetroConfig): MetroConfig;
+
 /**
  * 将 Metro transformer 的 minifier 切换为 esbuild。
  *
@@ -270,4 +288,4 @@ declare function withExpoNotificationsStub(config: MetroConfig): MetroConfig;
  */
 declare function withEsbuildMinify(config: MetroConfig): MetroConfig;
 
-export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWorkspaceNodeModules };
+export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWorkspaceNodeModules };

package/dist/metro.js

@@ -36,6 +36,7 @@ __export(metro_exports, {
   withDevkit: () => withDevkit,
   withEntryInjection: () => withEntryInjection,
   withEsbuildMinify: () => withEsbuildMinify,
+  withExpoMediaLibraryStub: () => withExpoMediaLibraryStub,
   withExpoNotificationsStub: () => withExpoNotificationsStub,
   withLucideResolver: () => withLucideResolver,
   withNativeWind: () => withNativeWind,
@@ -283,7 +284,7 @@ function withCssInterop(config) {
 }
 
 // src/metro/withDevkit.ts
-var import_path9 = __toESM(require("path"));
+var import_path10 = __toESM(require("path"));
 
 // src/metro/withEsbuildMinify.ts
 function withEsbuildMinify(config) {
@@ -353,7 +354,7 @@ var EXPO_NOTIFICATIONS_STUB_PATH = import_path8.default.resolve(__dirname, "stub
 function withExpoNotificationsStub(config) {
   const upstream = config.resolver?.resolveRequest ?? null;
   const resolveRequest = (context, moduleName, platform) => {
-    if (platform === "android" && moduleName === "expo-notifications" && !context.originModulePath.includes(EXPO_NOTIFICATIONS_STUB_FILENAME)) {
+    if ((platform === "android" || platform === "web") && moduleName === "expo-notifications" && !context.originModulePath.includes(EXPO_NOTIFICATIONS_STUB_FILENAME)) {
       return { filePath: EXPO_NOTIFICATIONS_STUB_PATH, type: "sourceFile" };
     }
     if (upstream) return upstream(context, moduleName, platform);
@@ -362,6 +363,26 @@ function withExpoNotificationsStub(config) {
   return { ...config, resolver: { ...config.resolver, resolveRequest } };
 }
 
+// src/metro/withExpoMediaLibraryStub.ts
+var import_path9 = __toESM(require("path"));
+var EXPO_MEDIA_LIBRARY_STUB_FILENAME = "expo-media-library-stub.js";
+var EXPO_MEDIA_LIBRARY_STUB_PATH = import_path9.default.resolve(
+  __dirname,
+  "stubs",
+  EXPO_MEDIA_LIBRARY_STUB_FILENAME
+);
+function withExpoMediaLibraryStub(config) {
+  const upstream = config.resolver?.resolveRequest ?? null;
+  const resolveRequest = (context, moduleName, platform) => {
+    if (moduleName === "expo-media-library" && !context.originModulePath.includes(EXPO_MEDIA_LIBRARY_STUB_FILENAME)) {
+      return { filePath: EXPO_MEDIA_LIBRARY_STUB_PATH, type: "sourceFile" };
+    }
+    if (upstream) return upstream(context, moduleName, platform);
+    return context.resolveRequest(context, moduleName, platform);
+  };
+  return { ...config, resolver: { ...config.resolver, resolveRequest } };
+}
+
 // src/metro/withDevkit.ts
 function withDevkit(config, options = {}) {
   const projectRoot = config.projectRoot ?? process.cwd();
@@ -371,10 +392,11 @@ function withDevkit(config, options = {}) {
   config = withEsbuildMinify(config);
   config = withLucideResolver(config);
   config = withExpoNotificationsStub(config);
+  config = withExpoMediaLibraryStub(config);
   if (typeof __DEV__ !== "undefined" && __DEV__) {
     config = withEntryInjection(config);
     config = withDevStubs(config);
-    config = withRouteEndpoint(config, { appDir: import_path9.default.join(projectRoot, "src", "app") });
+    config = withRouteEndpoint(config, { appDir: import_path10.default.join(projectRoot, "src", "app") });
   }
   return withNativeWind(config, { input, inlineRem: 16 });
 }
@@ -394,6 +416,7 @@ try {
   withDevkit,
   withEntryInjection,
   withEsbuildMinify,
+  withExpoMediaLibraryStub,
   withExpoNotificationsStub,
   withLucideResolver,
   withNativeWind,

package/dist/metro.mjs

@@ -244,7 +244,7 @@ function withCssInterop(config) {
 }
 
 // src/metro/withDevkit.ts
-import path9 from "path";
+import path10 from "path";
 
 // src/metro/withEsbuildMinify.ts
 function withEsbuildMinify(config) {
@@ -314,7 +314,7 @@ var EXPO_NOTIFICATIONS_STUB_PATH = path8.resolve(__dirname, "stubs", EXPO_NOTIFI
 function withExpoNotificationsStub(config) {
   const upstream = config.resolver?.resolveRequest ?? null;
   const resolveRequest = (context, moduleName, platform) => {
-    if (platform === "android" && moduleName === "expo-notifications" && !context.originModulePath.includes(EXPO_NOTIFICATIONS_STUB_FILENAME)) {
+    if ((platform === "android" || platform === "web") && moduleName === "expo-notifications" && !context.originModulePath.includes(EXPO_NOTIFICATIONS_STUB_FILENAME)) {
       return { filePath: EXPO_NOTIFICATIONS_STUB_PATH, type: "sourceFile" };
     }
     if (upstream) return upstream(context, moduleName, platform);
@@ -323,6 +323,26 @@ function withExpoNotificationsStub(config) {
   return { ...config, resolver: { ...config.resolver, resolveRequest } };
 }
 
+// src/metro/withExpoMediaLibraryStub.ts
+import path9 from "path";
+var EXPO_MEDIA_LIBRARY_STUB_FILENAME = "expo-media-library-stub.js";
+var EXPO_MEDIA_LIBRARY_STUB_PATH = path9.resolve(
+  __dirname,
+  "stubs",
+  EXPO_MEDIA_LIBRARY_STUB_FILENAME
+);
+function withExpoMediaLibraryStub(config) {
+  const upstream = config.resolver?.resolveRequest ?? null;
+  const resolveRequest = (context, moduleName, platform) => {
+    if (moduleName === "expo-media-library" && !context.originModulePath.includes(EXPO_MEDIA_LIBRARY_STUB_FILENAME)) {
+      return { filePath: EXPO_MEDIA_LIBRARY_STUB_PATH, type: "sourceFile" };
+    }
+    if (upstream) return upstream(context, moduleName, platform);
+    return context.resolveRequest(context, moduleName, platform);
+  };
+  return { ...config, resolver: { ...config.resolver, resolveRequest } };
+}
+
 // src/metro/withDevkit.ts
 function withDevkit(config, options = {}) {
   const projectRoot = config.projectRoot ?? process.cwd();
@@ -332,10 +352,11 @@ function withDevkit(config, options = {}) {
   config = withEsbuildMinify(config);
   config = withLucideResolver(config);
   config = withExpoNotificationsStub(config);
+  config = withExpoMediaLibraryStub(config);
   if (typeof __DEV__ !== "undefined" && __DEV__) {
     config = withEntryInjection(config);
     config = withDevStubs(config);
-    config = withRouteEndpoint(config, { appDir: path9.join(projectRoot, "src", "app") });
+    config = withRouteEndpoint(config, { appDir: path10.join(projectRoot, "src", "app") });
   }
   return withNativeWind(config, { input, inlineRem: 16 });
 }
@@ -354,6 +375,7 @@ export {
   withDevkit,
   withEntryInjection,
   withEsbuildMinify,
+  withExpoMediaLibraryStub,
   withExpoNotificationsStub,
   withLucideResolver,
   withNativeWind,

package/dist/stubs/expo-media-library-stub.js

@@ -0,0 +1,108 @@
+"use strict";
+var import_react_native = require("react-native");
+var import_expo = require("expo");
+var import_web_stub_dialog = require("./web-stub-dialog");
+if (import_react_native.Platform.OS !== "web" && !(0, import_expo.isRunningInExpoGo)()) {
+  module.exports = require("expo-media-library");
+} else {
+  let showStubAlert = function(title, detail) {
+    if (import_react_native.Platform.OS === "web") {
+      (0, import_web_stub_dialog.showWebStubDialog)({ title, details: [detail] });
+    } else {
+      import_react_native.Alert.alert(
+        title,
+        ["\u79D2\u54D2\u626B\u7801\u9884\u89C8\u4E0D\u652F\u6301\u8BBF\u95EE\u624B\u673A\u76F8\u518C", `\u64CD\u4F5C: ${detail}`, "", "\u53D1\u5E03\u4E3A\u6B63\u5F0F App \u540E\u53EF\u6B63\u5E38\u4F7F\u7528"].join("\n"),
+        [{ text: "\u77E5\u9053\u4E86" }]
+      );
+    }
+  }, usePermissions = function() {
+    const [permission, setPermission] = useState(UNDETERMINED_PERMISSION);
+    const requestPermission = useCallback(async () => {
+      showStubAlert("\u8BF7\u6C42\u76F8\u518C\u6743\u9650", "\u8BFB\u5199\u624B\u673A\u76F8\u518C");
+      setPermission(DENIED_PERMISSION);
+      return DENIED_PERMISSION;
+    }, []);
+    const getPermission = useCallback(async () => permission, [permission]);
+    return [permission, requestPermission, getPermission];
+  };
+  var showStubAlert2 = showStubAlert, usePermissions2 = usePermissions;
+  const UNDETERMINED_PERMISSION = {
+    status: "undetermined",
+    granted: false,
+    canAskAgain: true,
+    expires: "never"
+  };
+  const DENIED_PERMISSION = {
+    status: "denied",
+    granted: false,
+    canAskAgain: false,
+    expires: "never"
+  };
+  const { useState, useCallback } = require("react");
+  const saveToLibraryAsync = async (uri) => {
+    const uriStr = typeof uri === "string" ? uri.length > 60 ? uri.slice(0, 60) + "\u2026" : uri : String(uri);
+    showStubAlert("\u4FDD\u5B58\u5230\u76F8\u518C", `\u56FE\u7247: ${uriStr}`);
+  };
+  const createAssetAsync = async (uri) => {
+    const uriStr = typeof uri === "string" ? uri.slice(0, 60) : String(uri);
+    showStubAlert("\u521B\u5EFA\u5A92\u4F53\u8D44\u4EA7", `\u6587\u4EF6: ${uriStr}`);
+    return {
+      id: "stub",
+      filename: "stub.jpg",
+      uri: String(uri),
+      mediaType: "photo",
+      mediaSubtypes: [],
+      width: 0,
+      height: 0,
+      creationTime: 0,
+      modificationTime: 0,
+      duration: 0
+    };
+  };
+  const requestPermissionsAsync = async () => {
+    showStubAlert("\u8BF7\u6C42\u76F8\u518C\u6743\u9650", "\u8BFB\u5199\u624B\u673A\u76F8\u518C");
+    return DENIED_PERMISSION;
+  };
+  const getPermissionsAsync = async () => DENIED_PERMISSION;
+  const enums = {
+    PermissionStatus: {
+      GRANTED: "granted",
+      DENIED: "denied",
+      UNDETERMINED: "undetermined",
+      LIMITED: "limited"
+    },
+    MediaType: {
+      photo: "photo",
+      video: "video",
+      audio: "audio",
+      unknown: "unknown"
+    },
+    SortBy: {
+      default: "default",
+      creationTime: "creationTime",
+      modificationTime: "modificationTime",
+      mediaType: "mediaType",
+      width: "width",
+      height: "height",
+      duration: "duration"
+    }
+  };
+  const coreHandlers = {
+    usePermissions,
+    saveToLibraryAsync,
+    createAssetAsync,
+    requestPermissionsAsync,
+    getPermissionsAsync
+  };
+  const noopPermission = async () => DENIED_PERMISSION;
+  const noop = async () => void 0;
+  module.exports = new Proxy(enums, {
+    get(target, key) {
+      if (key in target) return target[key];
+      if (key in coreHandlers) return coreHandlers[key];
+      if (key.endsWith("PermissionsAsync")) return noopPermission;
+      return noop;
+    }
+  });
+}
+//# sourceMappingURL=expo-media-library-stub.js.map

package/dist/stubs/expo-notifications-stub.js

@@ -1,10 +1,19 @@
 "use strict";
 var import_expo = require("expo");
 var import_react_native = require("react-native");
-if (!(0, import_expo.isRunningInExpoGo)()) {
+var import_web_stub_dialog = require("./web-stub-dialog");
+if (import_react_native.Platform.OS !== "web" && !(0, import_expo.isRunningInExpoGo)()) {
   module.exports = require("expo-notifications");
 } else {
   let showDetailedAlert = function(apiName, lines, isValid, errors) {
+    if (import_react_native.Platform.OS === "web") {
+      (0, import_web_stub_dialog.showWebStubDialog)({
+        title: apiName,
+        details: lines,
+        errors: !isValid && errors && errors.length > 0 ? errors : void 0
+      });
+      return;
+    }
     const statusLine = isValid ? "\u79D2\u54D2\u901A\u77E5\u60A8 \u6D88\u606F\u63A8\u9001\u9A8C\u8BC1\u901A\u8FC7" : "\u9A8C\u8BC1\u672A\u901A\u8FC7";
     const parts = [statusLine, "", ...lines];
     if (!isValid && errors && errors.length > 0) {

package/dist/stubs/web-stub-dialog.js

@@ -0,0 +1,156 @@
+"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);
+var web_stub_dialog_exports = {};
+__export(web_stub_dialog_exports, {
+  showWebStubDialog: () => showWebStubDialog
+});
+module.exports = __toCommonJS(web_stub_dialog_exports);
+const DIALOG_ID = "__devkit_stub_dialog__";
+const STYLES = {
+  backdrop: `
+    position: fixed;
+    inset: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background: rgba(0,0,0,0.55);
+    z-index: 99999;
+    padding: 24px;
+    box-sizing: border-box;
+  `,
+  card: `
+    background: #1e1e1e;
+    border-radius: 14px;
+    padding: 20px 24px 16px;
+    max-width: 380px;
+    width: 100%;
+    box-shadow: 0 8px 32px rgba(0,0,0,0.5);
+    display: flex;
+    flex-direction: column;
+    gap: 0;
+  `,
+  badge: `
+    display: inline-block;
+    font-size: 11px;
+    font-weight: 600;
+    letter-spacing: 0.5px;
+    color: #00E676;
+    background: rgba(0,230,118,0.12);
+    border-radius: 6px;
+    padding: 2px 8px;
+    margin-bottom: 10px;
+    font-family: system-ui, sans-serif;
+  `,
+  title: `
+    font-size: 16px;
+    font-weight: 700;
+    color: #ffffff;
+    margin: 0 0 12px;
+    font-family: system-ui, sans-serif;
+    line-height: 1.3;
+  `,
+  body: `
+    font-size: 13px;
+    color: #aaaaaa;
+    font-family: system-ui, sans-serif;
+    line-height: 1.6;
+    margin: 0 0 16px;
+    white-space: pre-wrap;
+  `,
+  highlight: `
+    color: #e0e0e0;
+    font-family: ui-monospace, monospace;
+    font-size: 12px;
+    background: rgba(255,255,255,0.06);
+    border-radius: 6px;
+    padding: 8px 10px;
+    margin: 0 0 16px;
+    white-space: pre-wrap;
+    word-break: break-all;
+  `,
+  footer: `
+    font-size: 12px;
+    color: #666;
+    font-family: system-ui, sans-serif;
+    margin: 0 0 16px;
+  `,
+  button: `
+    align-self: flex-end;
+    background: #00E676;
+    color: #121212;
+    border: none;
+    border-radius: 8px;
+    padding: 8px 20px;
+    font-size: 14px;
+    font-weight: 700;
+    font-family: system-ui, sans-serif;
+    cursor: pointer;
+    transition: opacity 0.15s;
+  `
+};
+function showWebStubDialog(opts) {
+  if (typeof document === "undefined") return;
+  document.getElementById(DIALOG_ID)?.remove();
+  const backdrop = document.createElement("div");
+  backdrop.id = DIALOG_ID;
+  backdrop.setAttribute("style", STYLES.backdrop);
+  const card = document.createElement("div");
+  card.setAttribute("style", STYLES.card);
+  const badge = document.createElement("span");
+  badge.setAttribute("style", STYLES.badge);
+  badge.textContent = "\u79D2\u54D2\u9884\u89C8\u6A21\u5F0F";
+  const titleEl = document.createElement("p");
+  titleEl.setAttribute("style", STYLES.title);
+  titleEl.textContent = opts.title;
+  const bodyEl = document.createElement("p");
+  bodyEl.setAttribute("style", STYLES.body);
+  bodyEl.textContent = "\u6B64\u529F\u80FD\u5728\u79D2\u54D2\u9884\u89C8\u4E2D\u4E0D\u53EF\u7528\uFF0C\u53D1\u5E03\u4E3A\u6B63\u5F0F App \u540E\u53EF\u6B63\u5E38\u4F7F\u7528\u3002";
+  const detailEl = document.createElement("div");
+  detailEl.setAttribute("style", STYLES.highlight);
+  detailEl.textContent = opts.details.join("\n");
+  card.appendChild(badge);
+  card.appendChild(titleEl);
+  card.appendChild(bodyEl);
+  card.appendChild(detailEl);
+  if (opts.errors && opts.errors.length > 0) {
+    const errEl = document.createElement("p");
+    errEl.setAttribute(
+      "style",
+      STYLES.footer + "color: #ff5252;"
+    );
+    errEl.textContent = "\u53C2\u6570\u95EE\u9898: " + opts.errors.join(" / ");
+    card.appendChild(errEl);
+  }
+  const btn = document.createElement("button");
+  btn.setAttribute("style", STYLES.button);
+  btn.textContent = "\u77E5\u9053\u4E86";
+  const close = () => backdrop.remove();
+  btn.addEventListener("click", close);
+  backdrop.addEventListener("click", (e) => {
+    if (e.target === backdrop) close();
+  });
+  card.appendChild(btn);
+  backdrop.appendChild(card);
+  document.body.appendChild(backdrop);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  showWebStubDialog
+});
+//# sourceMappingURL=web-stub-dialog.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-expo-devkit",
-  "version": "0.1.1-beta.30",
+  "version": "0.1.1-beta.32",
   "description": "Expo 应用开发工具集：Sentry DSN 替换 stub、错误/网络捕获、Metro 符号化",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -45,6 +45,7 @@
     "./sentry-react-native-stub": "./dist/stubs/sentry-react-native-stub.js",
     "./no-op-logbox": "./dist/stubs/no-op-logbox.js",
     "./expo-notifications-stub": "./dist/stubs/expo-notifications-stub.js",
+    "./expo-media-library-stub": "./dist/stubs/expo-media-library-stub.js",
     "./rules/no-undeclared-expo-plugin": "./dist/rules/no-undeclared-expo-plugin.js",
     "./rules/no-unused-expo-plugin": "./dist/rules/no-unused-expo-plugin.js",
     "./rules/no-unstable-expo-router": "./dist/rules/no-unstable-expo-router.js",

package/pnpm-config.json

@@ -1,8 +1,3 @@
 {
-  "blockedPackages": [
-    {
-      "name": "expo-media-library",
-      "reason": "Use \"expo-image-picker\" instead — it covers most image/video picking needs with simpler permissions. Only use expo-media-library if you need to save files to the album or browse the full library."
-    }
-  ]
+  "blockedPackages": []
 }