miaoda-expo-devkit 0.1.1-beta.39 → 0.1.1-beta.40

package/dist/metro.d.mts

@@ -119,6 +119,7 @@ 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 透传）
+ *   withExpoFileSystemStub      — Web：expo-file-system/legacy → stub（弹 Dialog 提示，原生透传）
  *   withEntryInjection          — 在 expo-router 启动前注入脚本（仅 __DEV__）
  *   withDevStubs                — 替换 Sentry DSN / 屏蔽 LogBox（仅 __DEV__）
  *   withRouteEndpoint           — 添加 /__routes 端点（仅 __DEV__）
@@ -295,6 +296,23 @@ declare function withExpoMediaLibraryStub(config: MetroConfig): MetroConfig;
  */
 declare function withExpoCalendarStub(config: MetroConfig): MetroConfig;
 
+/**
+ * withExpoFileSystemStub — Web 端将 expo-file-system/legacy 替换为 stub
+ *
+ * expo-file-system 的文件 API 在 Web 端不可用（底层 shim 方法均缺失）。
+ * stub 在运行时通过 Platform.OS 判断：
+ *   - Web：no-op（核心 API 弹 Dialog 提示，不崩溃）
+ *   - Expo Go / Development Build（原生）：透传真实 expo-file-system/legacy，功能完全正常
+ *
+ * 注意：此 wrapper 拦截 expo-file-system/legacy 子路径，不拦截新版 expo-file-system（File API）。
+ */
+
+/**
+ * @param config  Metro config 对象
+ * @returns       注入 resolveRequest 后的新 Metro config
+ */
+declare function withExpoFileSystemStub(config: MetroConfig): MetroConfig;
+
 /**
  * 将 Metro transformer 的 minifier 切换为 esbuild。
  *
@@ -320,4 +338,4 @@ declare function withEsbuildMinify(config: MetroConfig): MetroConfig;
 
 declare function withWasmSupport(config: MetroConfig): MetroConfig;
 
-export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWasmSupport, withWorkspaceNodeModules };
+export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoFileSystemStub, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWasmSupport, withWorkspaceNodeModules };

package/dist/metro.d.ts

@@ -119,6 +119,7 @@ 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 透传）
+ *   withExpoFileSystemStub      — Web：expo-file-system/legacy → stub（弹 Dialog 提示，原生透传）
  *   withEntryInjection          — 在 expo-router 启动前注入脚本（仅 __DEV__）
  *   withDevStubs                — 替换 Sentry DSN / 屏蔽 LogBox（仅 __DEV__）
  *   withRouteEndpoint           — 添加 /__routes 端点（仅 __DEV__）
@@ -295,6 +296,23 @@ declare function withExpoMediaLibraryStub(config: MetroConfig): MetroConfig;
  */
 declare function withExpoCalendarStub(config: MetroConfig): MetroConfig;
 
+/**
+ * withExpoFileSystemStub — Web 端将 expo-file-system/legacy 替换为 stub
+ *
+ * expo-file-system 的文件 API 在 Web 端不可用（底层 shim 方法均缺失）。
+ * stub 在运行时通过 Platform.OS 判断：
+ *   - Web：no-op（核心 API 弹 Dialog 提示，不崩溃）
+ *   - Expo Go / Development Build（原生）：透传真实 expo-file-system/legacy，功能完全正常
+ *
+ * 注意：此 wrapper 拦截 expo-file-system/legacy 子路径，不拦截新版 expo-file-system（File API）。
+ */
+
+/**
+ * @param config  Metro config 对象
+ * @returns       注入 resolveRequest 后的新 Metro config
+ */
+declare function withExpoFileSystemStub(config: MetroConfig): MetroConfig;
+
 /**
  * 将 Metro transformer 的 minifier 切换为 esbuild。
  *
@@ -320,4 +338,4 @@ declare function withEsbuildMinify(config: MetroConfig): MetroConfig;
 
 declare function withWasmSupport(config: MetroConfig): MetroConfig;
 
-export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWasmSupport, withWorkspaceNodeModules };
+export { type DevkitOptions, type InjectOptions, type PatchNativeWindCacheOptions, type RouteEndpointOptions, patchNativeWindCachePath, withCssInterop, withDevStubs, withDevkit, withEntryInjection, withEsbuildMinify, withExpoCalendarStub, withExpoFileSystemStub, withExpoMediaLibraryStub, withExpoNotificationsStub, withLucideResolver, withNativeWind, withRouteEndpoint, withWasmSupport, withWorkspaceNodeModules };

package/dist/metro.js

@@ -37,6 +37,7 @@ __export(metro_exports, {
   withEntryInjection: () => withEntryInjection,
   withEsbuildMinify: () => withEsbuildMinify,
   withExpoCalendarStub: () => withExpoCalendarStub,
+  withExpoFileSystemStub: () => withExpoFileSystemStub,
   withExpoMediaLibraryStub: () => withExpoMediaLibraryStub,
   withExpoNotificationsStub: () => withExpoNotificationsStub,
   withLucideResolver: () => withLucideResolver,
@@ -286,7 +287,7 @@ function withCssInterop(config) {
 }
 
 // src/metro/withDevkit.ts
-var import_path11 = __toESM(require("path"));
+var import_path12 = __toESM(require("path"));
 
 // src/metro/withEsbuildMinify.ts
 function withEsbuildMinify(config) {
@@ -405,6 +406,26 @@ function withExpoCalendarStub(config) {
   return { ...config, resolver: { ...config.resolver, resolveRequest } };
 }
 
+// src/metro/withExpoFileSystemStub.ts
+var import_path11 = __toESM(require("path"));
+var EXPO_FILE_SYSTEM_STUB_FILENAME = "expo-file-system-stub.js";
+var EXPO_FILE_SYSTEM_STUB_PATH = import_path11.default.resolve(
+  __dirname,
+  "stubs",
+  EXPO_FILE_SYSTEM_STUB_FILENAME
+);
+function withExpoFileSystemStub(config) {
+  const upstream = config.resolver?.resolveRequest ?? null;
+  const resolveRequest = (context, moduleName, platform) => {
+    if (moduleName === "expo-file-system/legacy" && !context.originModulePath.includes(EXPO_FILE_SYSTEM_STUB_FILENAME)) {
+      return { filePath: EXPO_FILE_SYSTEM_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/withWasmSupport.ts
 function withWasmSupport(config) {
   const existing = config.resolver?.assetExts ?? [];
@@ -430,10 +451,11 @@ function withDevkit(config, options = {}) {
   config = withExpoNotificationsStub(config);
   config = withExpoMediaLibraryStub(config);
   config = withExpoCalendarStub(config);
+  config = withExpoFileSystemStub(config);
   if (typeof __DEV__ !== "undefined" && __DEV__) {
     config = withEntryInjection(config);
     config = withDevStubs(config);
-    config = withRouteEndpoint(config, { appDir: import_path11.default.join(projectRoot, "src", "app") });
+    config = withRouteEndpoint(config, { appDir: import_path12.default.join(projectRoot, "src", "app") });
   }
   return withNativeWind(config, { input, inlineRem: 16 });
 }
@@ -454,6 +476,7 @@ try {
   withEntryInjection,
   withEsbuildMinify,
   withExpoCalendarStub,
+  withExpoFileSystemStub,
   withExpoMediaLibraryStub,
   withExpoNotificationsStub,
   withLucideResolver,

package/dist/metro.mjs

@@ -244,7 +244,7 @@ function withCssInterop(config) {
 }
 
 // src/metro/withDevkit.ts
-import path11 from "path";
+import path12 from "path";
 
 // src/metro/withEsbuildMinify.ts
 function withEsbuildMinify(config) {
@@ -363,6 +363,26 @@ function withExpoCalendarStub(config) {
   return { ...config, resolver: { ...config.resolver, resolveRequest } };
 }
 
+// src/metro/withExpoFileSystemStub.ts
+import path11 from "path";
+var EXPO_FILE_SYSTEM_STUB_FILENAME = "expo-file-system-stub.js";
+var EXPO_FILE_SYSTEM_STUB_PATH = path11.resolve(
+  __dirname,
+  "stubs",
+  EXPO_FILE_SYSTEM_STUB_FILENAME
+);
+function withExpoFileSystemStub(config) {
+  const upstream = config.resolver?.resolveRequest ?? null;
+  const resolveRequest = (context, moduleName, platform) => {
+    if (moduleName === "expo-file-system/legacy" && !context.originModulePath.includes(EXPO_FILE_SYSTEM_STUB_FILENAME)) {
+      return { filePath: EXPO_FILE_SYSTEM_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/withWasmSupport.ts
 function withWasmSupport(config) {
   const existing = config.resolver?.assetExts ?? [];
@@ -388,10 +408,11 @@ function withDevkit(config, options = {}) {
   config = withExpoNotificationsStub(config);
   config = withExpoMediaLibraryStub(config);
   config = withExpoCalendarStub(config);
+  config = withExpoFileSystemStub(config);
   if (typeof __DEV__ !== "undefined" && __DEV__) {
     config = withEntryInjection(config);
     config = withDevStubs(config);
-    config = withRouteEndpoint(config, { appDir: path11.join(projectRoot, "src", "app") });
+    config = withRouteEndpoint(config, { appDir: path12.join(projectRoot, "src", "app") });
   }
   return withNativeWind(config, { input, inlineRem: 16 });
 }
@@ -411,6 +432,7 @@ export {
   withEntryInjection,
   withEsbuildMinify,
   withExpoCalendarStub,
+  withExpoFileSystemStub,
   withExpoMediaLibraryStub,
   withExpoNotificationsStub,
   withLucideResolver,

package/dist/rules/no-duplicate-expo-router-url.js

@@ -34,10 +34,20 @@ __export(no_duplicate_expo_router_url_exports, {
 });
 module.exports = __toCommonJS(no_duplicate_expo_router_url_exports);
 var import_node_fs = __toESM(require("fs"));
+var import_node_path2 = __toESM(require("path"));
+
+// src/rules/utils.ts
 var import_node_path = __toESM(require("path"));
+var import_package_up = require("package-up");
+function findProjectRoot(startPath) {
+  const pkgPath = (0, import_package_up.packageUpSync)({ cwd: import_node_path.default.dirname(startPath) });
+  return pkgPath ? import_node_path.default.dirname(pkgPath) : null;
+}
+
+// src/rules/no-duplicate-expo-router-url.ts
 var ROUTE_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".ts", ".jsx", ".js"]);
 function fileToUrl(relPath) {
-  const ext = import_node_path.default.extname(relPath);
+  const ext = import_node_path2.default.extname(relPath);
   if (!ROUTE_EXTENSIONS.has(ext)) return null;
   const normalized = relPath.replace(/\\/g, "/");
   let p = normalized.slice(0, -ext.length);
@@ -50,17 +60,9 @@ function fileToUrl(relPath) {
   if (p.endsWith("/index")) return "/" + p.slice(0, -6);
   return "/" + p;
 }
-function findProjectRoot(startPath) {
-  let dir = import_node_path.default.dirname(startPath);
-  while (dir !== import_node_path.default.dirname(dir)) {
-    if (import_node_fs.default.existsSync(import_node_path.default.join(dir, "package.json"))) return dir;
-    dir = import_node_path.default.dirname(dir);
-  }
-  return null;
-}
 function getRouterRoot(projectRoot) {
   try {
-    const raw = JSON.parse(import_node_fs.default.readFileSync(import_node_path.default.join(projectRoot, "app.json"), "utf-8"));
+    const raw = JSON.parse(import_node_fs.default.readFileSync(import_node_path2.default.join(projectRoot, "app.json"), "utf-8"));
     return raw?.expo?.router?.root ?? ".";
   } catch {
     return ".";
@@ -72,11 +74,11 @@ function buildUrlMap(appDir) {
   const urlMap = /* @__PURE__ */ new Map();
   function scanDir(dir) {
     for (const entry of import_node_fs.default.readdirSync(dir, { withFileTypes: true })) {
-      const fullPath = import_node_path.default.join(dir, entry.name);
+      const fullPath = import_node_path2.default.join(dir, entry.name);
       if (entry.isDirectory()) {
         scanDir(fullPath);
       } else if (entry.isFile()) {
-        const rel = import_node_path.default.relative(appDir, fullPath);
+        const rel = import_node_path2.default.relative(appDir, fullPath);
         const url = fileToUrl(rel);
         if (url !== null) {
           const existing = urlMap.get(url) ?? [];
@@ -107,8 +109,8 @@ var noDuplicateExpoRouterUrlRule = {
         const projectRoot = findProjectRoot(context.filename);
         if (!projectRoot) return;
         const routerRoot = getRouterRoot(projectRoot);
-        const appDir = import_node_path.default.join(projectRoot, routerRoot, "app");
-        const rel = import_node_path.default.relative(appDir, context.filename).replace(/\\/g, "/");
+        const appDir = import_node_path2.default.join(projectRoot, routerRoot, "app");
+        const rel = import_node_path2.default.relative(appDir, context.filename).replace(/\\/g, "/");
         if (rel.startsWith("..")) return;
         const url = fileToUrl(rel);
         if (url === null) return;