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

package/dist/rules/no-invalid-tabs-screen.js

@@ -0,0 +1,191 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/rules/no-invalid-tabs-screen.ts
+var no_invalid_tabs_screen_exports = {};
+__export(no_invalid_tabs_screen_exports, {
+  default: () => no_invalid_tabs_screen_default
+});
+module.exports = __toCommonJS(no_invalid_tabs_screen_exports);
+var import_node_fs = __toESM(require("fs"));
+var import_node_path = __toESM(require("path"));
+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"));
+    return raw?.expo?.router?.root ?? ".";
+  } catch {
+    return ".";
+  }
+}
+var ROUTE_EXTS = [".tsx", ".ts", ".jsx", ".js"];
+function resolveScreenName(name, appDir) {
+  for (const ext of ROUTE_EXTS) {
+    if (import_node_fs.default.existsSync(import_node_path.default.join(appDir, name + ext))) {
+      return { exists: true, suggestion: null };
+    }
+  }
+  for (const ext of ROUTE_EXTS) {
+    if (import_node_fs.default.existsSync(import_node_path.default.join(appDir, name, "index" + ext))) {
+      return { exists: false, suggestion: `${name}/index` };
+    }
+  }
+  return { exists: false, suggestion: null };
+}
+function getStringAttr(attrs, attrName) {
+  for (const attr of attrs) {
+    if (attr.type !== "JSXAttribute") continue;
+    const n = attr.name;
+    if (n.type !== "JSXIdentifier" || n.name !== attrName) continue;
+    const v = attr.value;
+    if (!v) continue;
+    if (v.type === "Literal") {
+      return String(v.value);
+    }
+    if (v.type === "JSXExpressionContainer") {
+      const expr = v.expression;
+      if (expr.type === "Literal") return String(expr.value);
+    }
+  }
+  return null;
+}
+function isHiddenTab(attrs) {
+  for (const attr of attrs) {
+    if (attr.type !== "JSXAttribute") continue;
+    const n = attr.name;
+    if (n.type !== "JSXIdentifier" || n.name !== "options") continue;
+    const v = attr.value;
+    if (!v) continue;
+    if (v.type !== "JSXExpressionContainer") continue;
+    const expr = v.expression;
+    if (!expr || expr.type !== "ObjectExpression") continue;
+    for (const prop of expr.properties ?? []) {
+      const p = prop;
+      if (p.type !== "Property") continue;
+      const key = p.key;
+      const keyName = key.type === "Identifier" ? key.name : String(key.value);
+      if (keyName !== "href") continue;
+      if (p.value.type === "Literal" && p.value.value === null) return true;
+    }
+  }
+  return false;
+}
+function hasTitle(attrs) {
+  for (const attr of attrs) {
+    if (attr.type !== "JSXAttribute") continue;
+    const n = attr.name;
+    if (n.type !== "JSXIdentifier" || n.name !== "options") continue;
+    const v = attr.value;
+    if (!v) continue;
+    if (v.type !== "JSXExpressionContainer") continue;
+    const expr = v.expression;
+    if (!expr || expr.type !== "ObjectExpression") continue;
+    for (const prop of expr.properties ?? []) {
+      const p = prop;
+      if (p.type !== "Property") continue;
+      const key = p.key;
+      const keyName = key.type === "Identifier" ? key.name : String(key.value);
+      if (keyName === "title") return true;
+    }
+  }
+  return false;
+}
+var noInvalidTabsScreenRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Validate Tabs.Screen name (must match an existing route file) and options (visible tabs must have a title)."
+    },
+    schema: [],
+    messages: {
+      nameNotFound: 'Tabs.Screen name="{{name}}" does not match any route file in the app directory.',
+      nameShouldBeIndex: 'Tabs.Screen name="{{name}}" should be "{{suggestion}}" (add /index suffix).',
+      missingTitle: 'Visible Tabs.Screen name="{{name}}" is missing options.title.'
+    }
+  },
+  create(context) {
+    const base = import_node_path.default.basename(context.filename);
+    if (!base.startsWith("_layout.")) return {};
+    const projectRoot = findProjectRoot(context.filename);
+    if (!projectRoot) return {};
+    const routerRoot = getRouterRoot(projectRoot);
+    const appDir = import_node_path.default.join(projectRoot, routerRoot, "app");
+    const layoutDir = import_node_path.default.dirname(context.filename);
+    return {
+      JSXOpeningElement(node) {
+        const nameNode = node.name;
+        if (nameNode.type !== "JSXMemberExpression" || nameNode.object?.type !== "JSXIdentifier" || nameNode.object?.name !== "Tabs" || nameNode.property?.type !== "JSXIdentifier" || nameNode.property?.name !== "Screen") {
+          return;
+        }
+        const attrs = node.attributes;
+        const name = getStringAttr(attrs, "name");
+        if (!name) return;
+        const nameRelToApp = import_node_path.default.relative(appDir, import_node_path.default.join(layoutDir, name));
+        const result = resolveScreenName(nameRelToApp, appDir);
+        if (!result.exists) {
+          if (result.suggestion) {
+            const suggestedNameRelToLayout = import_node_path.default.relative(layoutDir, import_node_path.default.join(appDir, result.suggestion));
+            const suggestion = suggestedNameRelToLayout.replace(/\\/g, "/");
+            context.report({
+              node,
+              messageId: "nameShouldBeIndex",
+              data: { name, suggestion }
+            });
+          } else {
+            context.report({
+              node,
+              messageId: "nameNotFound",
+              data: { name }
+            });
+          }
+        }
+        if (!isHiddenTab(attrs) && !hasTitle(attrs)) {
+          context.report({
+            node,
+            messageId: "missingTitle",
+            data: { name }
+          });
+        }
+      }
+    };
+  }
+};
+var plugin = {
+  meta: { name: "expo-router-layout" },
+  rules: { "no-invalid-tabs-screen": noInvalidTabsScreenRule }
+};
+var no_invalid_tabs_screen_default = plugin;
+module.exports = module.exports.default;

package/dist/rules/no-unregistered-dynamic-tab-route.js

@@ -0,0 +1,173 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/rules/no-unregistered-dynamic-tab-route.ts
+var no_unregistered_dynamic_tab_route_exports = {};
+__export(no_unregistered_dynamic_tab_route_exports, {
+  default: () => no_unregistered_dynamic_tab_route_default
+});
+module.exports = __toCommonJS(no_unregistered_dynamic_tab_route_exports);
+var import_node_fs = __toESM(require("fs"));
+var import_node_path = __toESM(require("path"));
+var ROUTE_EXTS = /* @__PURE__ */ new Set([".tsx", ".ts", ".jsx", ".js"]);
+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")
+    );
+    return raw?.expo?.router?.root ?? ".";
+  } catch {
+    return ".";
+  }
+}
+function collectRoutesNeedingHide(layoutDir) {
+  const results = [];
+  function scan(dir) {
+    for (const entry of import_node_fs.default.readdirSync(dir, { withFileTypes: true })) {
+      const fullPath = import_node_path.default.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        scan(fullPath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      const ext = import_node_path.default.extname(entry.name);
+      if (!ROUTE_EXTS.has(ext)) continue;
+      const basename = import_node_path.default.basename(entry.name, ext);
+      if (basename.startsWith("_") || basename.startsWith("+")) continue;
+      const rel = import_node_path.default.relative(layoutDir, fullPath).replace(/\\/g, "/").slice(0, -ext.length);
+      const segments = rel.split("/");
+      const lastSeg = segments[segments.length - 1];
+      const isDynamic = rel.includes("[");
+      const isNonIndexSubRoute = segments.length >= 2 && lastSeg !== "index";
+      if (isDynamic || isNonIndexSubRoute) {
+        results.push(rel);
+      }
+    }
+  }
+  if (import_node_fs.default.existsSync(layoutDir)) scan(layoutDir);
+  return results;
+}
+function getStringAttr(attrs, attrName) {
+  for (const attr of attrs) {
+    if (attr.type !== "JSXAttribute") continue;
+    const n = attr.name;
+    if (n.type !== "JSXIdentifier" || n.name !== attrName) continue;
+    const v = attr.value;
+    if (!v) continue;
+    if (v.type === "Literal") {
+      return String(v.value);
+    }
+    if (v.type === "JSXExpressionContainer") {
+      const expr = v.expression;
+      if (expr.type === "Literal") return String(expr.value);
+    }
+  }
+  return null;
+}
+function isHiddenTab(attrs) {
+  for (const attr of attrs) {
+    if (attr.type !== "JSXAttribute") continue;
+    const n = attr.name;
+    if (n.type !== "JSXIdentifier" || n.name !== "options") continue;
+    const v = attr.value;
+    if (!v || v.type !== "JSXExpressionContainer") continue;
+    const expr = v.expression;
+    if (!expr || expr.type !== "ObjectExpression") continue;
+    for (const prop of expr.properties ?? []) {
+      const p = prop;
+      if (p.type !== "Property") continue;
+      const keyName = p.key.type === "Identifier" ? p.key.name : String(p.key.value);
+      if (keyName !== "href") continue;
+      if (p.value.type === "Literal" && p.value.value === null) return true;
+    }
+  }
+  return false;
+}
+var noUnregisteredDynamicTabRouteRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: 'Dynamic routes and non-index sub-routes inside a Tabs layout must be hidden with <Tabs.Screen name="..." options={{ href: null }} />.'
+    },
+    schema: [],
+    messages: {
+      missingHiddenScreen: 'Route "{{name}}" must be hidden \u2014 add <Tabs.Screen name="{{name}}" options={href_null} /> where href_null is { href: null }.'
+    }
+  },
+  create(context) {
+    const base = import_node_path.default.basename(context.filename);
+    if (!base.startsWith("_layout.")) return {};
+    const projectRoot = findProjectRoot(context.filename);
+    if (!projectRoot) return {};
+    const routerRoot = getRouterRoot(projectRoot);
+    const appDir = import_node_path.default.join(projectRoot, routerRoot, "app");
+    const layoutDir = import_node_path.default.dirname(context.filename);
+    if (import_node_path.default.relative(appDir, layoutDir).startsWith("..")) return {};
+    const hiddenNames = /* @__PURE__ */ new Set();
+    return {
+      JSXOpeningElement(node) {
+        const nameNode = node.name;
+        if (nameNode.type !== "JSXMemberExpression" || nameNode.object?.type !== "JSXIdentifier" || nameNode.object?.name !== "Tabs" || nameNode.property?.type !== "JSXIdentifier" || nameNode.property?.name !== "Screen") {
+          return;
+        }
+        const attrs = node.attributes;
+        const screenName = getStringAttr(attrs, "name");
+        if (screenName && isHiddenTab(attrs)) {
+          hiddenNames.add(screenName);
+        }
+      },
+      "Program:exit"() {
+        const routes = collectRoutesNeedingHide(layoutDir);
+        for (const name of routes) {
+          if (!hiddenNames.has(name)) {
+            context.report({
+              loc: { start: { line: 1, column: 0 }, end: { line: 1, column: 0 } },
+              messageId: "missingHiddenScreen",
+              data: { name }
+            });
+          }
+        }
+      }
+    };
+  }
+};
+var plugin = {
+  meta: { name: "expo-router-layout" },
+  rules: { "no-unregistered-dynamic-tab-route": noUnregisteredDynamicTabRouteRule }
+};
+var no_unregistered_dynamic_tab_route_default = plugin;
+module.exports = module.exports.default;

package/oxlint-config.json

@@ -6,7 +6,9 @@
     { "name": "expo-router", "specifier": "miaoda-expo-devkit/rules/no-unstable-expo-router" },
     { "name": "rn-web", "specifier": "miaoda-expo-devkit/rules/no-rn-alert" },
     { "name": "expo-router-url", "specifier": "miaoda-expo-devkit/rules/no-duplicate-expo-router-url" },
-    { "name": "css-import", "specifier": "miaoda-expo-devkit/rules/no-missing-css-import" }
+    { "name": "css-import", "specifier": "miaoda-expo-devkit/rules/no-missing-css-import" },
+    { "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" }
   ],
 
   "categories": {
@@ -19,6 +21,8 @@
     "rn-web/no-rn-alert": "error",
     "expo-router-url/no-duplicate-expo-router-url": "error",
     "css-import/no-missing-css-import": "error",
+    "expo-router-layout/no-invalid-tabs-screen": "error",
+    "expo-router-dynamic-tab/no-unregistered-dynamic-tab-route": "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.29",
+  "version": "0.1.1-beta.30",
   "description": "Expo 应用开发工具集：Sentry DSN 替换 stub、错误/网络捕获、Metro 符号化",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -51,6 +51,8 @@
     "./rules/no-rn-alert": "./dist/rules/no-rn-alert.js",
     "./rules/no-duplicate-expo-router-url": "./dist/rules/no-duplicate-expo-router-url.js",
     "./rules/no-missing-css-import": "./dist/rules/no-missing-css-import.js",
+    "./rules/no-invalid-tabs-screen": "./dist/rules/no-invalid-tabs-screen.js",
+    "./rules/no-unregistered-dynamic-tab-route": "./dist/rules/no-unregistered-dynamic-tab-route.js",
     "./biome": "./biome-config.json",
     "./oxlint": "./oxlint-config.json",
     "./tsconfig-base": "./tsconfig-base.json"