@stll/oxlint-plugin 0.1.0 → 0.2.0

package/dist/require-loader-prefetch.cjs

@@ -0,0 +1,187 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region \0rolldown/runtime.js
+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 __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+const require_utils = require("./utils.cjs");
+let _oxlint_plugins = require("@oxlint/plugins");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+//#region src/require-loader-prefetch.ts
+const CREATE_FILE_ROUTE = "createFileRoute";
+const SUSPENSE_HOOK = "useSuspenseQuery";
+const LOADER_KEY = "loader";
+const isCreateFileRouteCall = (callee) => require_utils.isIdentifier(callee, CREATE_FILE_ROUTE);
+const isCreateFileRouteOptionsCall = (callee) => callee?.type === "CallExpression" && isCreateFileRouteCall(callee.callee);
+const isSuspenseCallee = (callee) => {
+	if (require_utils.isIdentifier(callee, SUSPENSE_HOOK)) return true;
+	return callee?.type === "MemberExpression" && callee.computed === false && require_utils.isIdentifier(callee.property, SUSPENSE_HOOK);
+};
+const suspenseFactoryName = (node) => {
+	if (!isSuspenseCallee(node.callee)) return null;
+	const arg = require_utils.unwrapExpression(node.arguments?.[0]);
+	if (arg?.type === "CallExpression" && require_utils.isIdentifier(arg.callee)) return arg.callee.name;
+	if (require_utils.isIdentifier(arg)) return arg.name;
+	return null;
+};
+const isInsideLoader = (node) => {
+	let current = node.parent;
+	while (current) {
+		if (current.type === "Property" && require_utils.getPropertyName(current.key) === LOADER_KEY) return true;
+		current = current.parent;
+	}
+	return false;
+};
+const ROUTES_SEGMENT = "/routes/";
+const COLOCATED_DIR_RE = /\/-[^/]+\//;
+const isColocatedRouteImport = (source) => source.startsWith("@/routes/") && COLOCATED_DIR_RE.test(source);
+const resolveColocatedImportBase = (filename, source) => {
+	const normalizedFilename = filename.replaceAll("\\", "/");
+	const routesIndex = normalizedFilename.lastIndexOf(ROUTES_SEGMENT);
+	if (routesIndex === -1) return null;
+	const aliasRoot = normalizedFilename.slice(0, routesIndex);
+	return node_path.default.join(aliasRoot, source.slice(2));
+};
+const readColocatedFile = (basePath) => {
+	for (const extension of [".tsx", ".ts"]) try {
+		return (0, node_fs.readFileSync)(`${basePath}${extension}`, "utf-8");
+	} catch {}
+	return null;
+};
+const CHILD_SUSPENSE_RE = /useSuspenseQuery\(\s*([A-Za-z_$][\w$]*)\s*([(),])/g;
+const suspenseFactoriesInSource = (sourceText) => {
+	const factories = /* @__PURE__ */ new Set();
+	for (const match of sourceText.matchAll(CHILD_SUSPENSE_RE)) {
+		const factory = match[1];
+		if (factory !== void 0) factories.add(factory);
+	}
+	return factories;
+};
+var require_loader_prefetch_default = (0, _oxlint_plugins.eslintCompatPlugin)({
+	meta: { name: "require-loader-prefetch" },
+	rules: { "require-loader-prefetch": {
+		meta: {
+			type: "problem",
+			messages: {
+				missingLoaderPrefetch: "Route component calls useSuspenseQuery({{factory}}(...)) but the route defines no `loader`, so this query fetches only after the component mounts and suspends — an extra sequential network round on cold navigation. Prefetch the same query options in the route `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query, so the fetch starts during navigation and useSuspenseQuery consumes the warm cache.",
+				factoryNotPrefetched: "Route component calls useSuspenseQuery({{factory}}(...)) but the route `loader` never references {{factory}}, so this query still fetches on mount — an extra sequential network round on cold navigation. Prefetch {{factory}}(...) in the `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query; useSuspenseQuery in the component then consumes the warm cache.",
+				childMissingLoaderPrefetch: "Route imports {{importPath}}, whose component calls useSuspenseQuery({{factory}}(...)), but the route defines no `loader`, so this query fetches only after the child component mounts and suspends — an extra sequential network round on cold navigation. Prefetch the same query options in the route `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query, so the fetch starts during navigation and useSuspenseQuery in the child component consumes the warm cache.",
+				childFactoryNotPrefetched: "Route imports {{importPath}}, whose component calls useSuspenseQuery({{factory}}(...)), but the route `loader` never references {{factory}}, so this query still fetches on mount — an extra sequential network round on cold navigation. Prefetch {{factory}}(...) in the `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query; useSuspenseQuery in the child component then consumes the warm cache."
+			}
+		},
+		createOnce(context) {
+			let isRouteFile = false;
+			let routeOptions = null;
+			const suspenseCalls = [];
+			const referencedInLoader = /* @__PURE__ */ new Set();
+			const colocatedImports = [];
+			return {
+				before() {
+					isRouteFile = false;
+					routeOptions = null;
+					suspenseCalls.length = 0;
+					referencedInLoader.clear();
+					colocatedImports.length = 0;
+				},
+				CallExpression(node) {
+					const callee = node.callee;
+					if (isCreateFileRouteCall(callee)) isRouteFile = true;
+					if (isCreateFileRouteOptionsCall(callee)) {
+						isRouteFile = true;
+						const optionsArg = node.arguments?.[0];
+						if (routeOptions === null && optionsArg?.type === "ObjectExpression") routeOptions = optionsArg;
+					}
+					const factory = suspenseFactoryName(node);
+					if (factory !== null) suspenseCalls.push({
+						node,
+						factory
+					});
+				},
+				Identifier(node) {
+					if (isInsideLoader(node)) referencedInLoader.add(node.name);
+				},
+				ImportDeclaration(node) {
+					if (require_utils.isStringLiteral(node.source) && isColocatedRouteImport(node.source.value)) colocatedImports.push({
+						node,
+						source: node.source.value
+					});
+				},
+				"Program:exit"() {
+					if (!isRouteFile || routeOptions === null) return;
+					const hasLoader = (Array.isArray(routeOptions.properties) ? routeOptions.properties : []).some((prop) => prop.type === "Property" && require_utils.getPropertyName(prop.key) === LOADER_KEY);
+					for (const { node, factory } of suspenseCalls) {
+						if (!hasLoader) {
+							context.report({
+								node,
+								messageId: "missingLoaderPrefetch",
+								data: { factory }
+							});
+							continue;
+						}
+						if (!referencedInLoader.has(factory)) context.report({
+							node,
+							messageId: "factoryNotPrefetched",
+							data: { factory }
+						});
+					}
+					if (colocatedImports.length === 0) return;
+					const filename = context.filename ?? context.getFilename?.();
+					if (typeof filename !== "string") return;
+					for (const { node, source } of colocatedImports) {
+						const basePath = resolveColocatedImportBase(filename, source);
+						if (basePath === null) continue;
+						const childSource = readColocatedFile(basePath);
+						if (childSource === null) continue;
+						for (const factory of suspenseFactoriesInSource(childSource)) {
+							if (!hasLoader) {
+								context.report({
+									node,
+									messageId: "childMissingLoaderPrefetch",
+									data: {
+										factory,
+										importPath: source
+									}
+								});
+								continue;
+							}
+							if (!referencedInLoader.has(factory)) context.report({
+								node,
+								messageId: "childFactoryNotPrefetched",
+								data: {
+									factory,
+									importPath: source
+								}
+							});
+						}
+					}
+				}
+			};
+		}
+	} }
+});
+//#endregion
+exports.default = require_loader_prefetch_default;
+
+//# sourceMappingURL=require-loader-prefetch.cjs.map

package/dist/require-loader-prefetch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-loader-prefetch.cjs","names":["isIdentifier","unwrapExpression","getPropertyName","path","isStringLiteral"],"sources":["../src/require-loader-prefetch.ts"],"sourcesContent":["// Require route loaders to prefetch the queries their component suspends on.\n//\n// A route component that calls `useSuspenseQuery(someOptions(...))` without the\n// route loader prefetching that same query forces a render-fetch waterfall: on\n// a cold visit the router resolves the route, the component mounts, suspends,\n// and only THEN starts the fetch — an extra sequential network round on every\n// cold navigation. TanStack Router loaders (`loader:` in `createFileRoute`\n// options) start the fetch during navigation, in parallel with code-split\n// chunk loading, via the helpers in `apps/web/src/lib/react-query.ts`\n// (`ensureRouteQueryData` for critical/blocking data, `prefetchRouteQuery` for\n// non-blocking warmup). With the loader priming the cache, `useSuspenseQuery`\n// in the component consumes a warm cache instead of opening a new round.\n//\n// Single-file AST analysis, scoped to route files (`createFileRoute(...)`):\n//   - Flags `useSuspenseQuery(factory(...))` / `useSuspenseQuery(factory)` when\n//     the route has no `loader`.\n//   - Flags the same when a `loader` exists but never references the factory\n//     identifier (any reference inside the loader body counts — typically\n//     inside `ensureRouteQueryData` / `prefetchRouteQuery`).\n//\n// Cross-file, one-hop check for colocated route components: the single-file\n// analysis above is blind to a `useSuspenseQuery(factory(...))` call living in\n// a sibling file imported by the route (the codebase convention for colocated,\n// non-route-generating files is a dash-prefixed directory next to the route,\n// e.g. `-components/`, `-hooks/`, `-queries/`, imported via the `@/routes/...`\n// alias — TanStack Router excludes `-`-prefixed paths from route generation).\n// A real instance of this shipped on `/settings/account/connections` before\n// being caught by the e2e depth guard: the page component had no\n// `useSuspenseQuery` of its own, it all lived in a child card component.\n//\n// To close that gap without a real module resolver: once a file is confirmed\n// to be a route file with an inline options object (the same precondition the\n// single-file check already requires), each `@/routes/.../-<dir>/...` import\n// it declares is resolved to an absolute path by reusing the *linted file's\n// own* path up to its `/routes/` segment as the alias root (mirrors the\n// `\"@/*\": [\"./src/*\"]` tsconfig path). The resolved file is read once — bounded\n// to that one hop, its own imports are never followed — and scanned with a\n// regex for the same two `useSuspenseQuery(...)` shapes the AST check\n// recognizes. Any factory it finds is checked against the route's `loader`\n// exactly like an in-file suspense call would be.\n//\n// Safe (not flagged):\n//   - `useSuspenseQuery` whose argument is a member expression or other shape\n//     the rule can't statically attribute to a factory identifier (in-file or\n//     in a colocated import).\n//   - `useSuspenseQuery` in a non-route file (no `createFileRoute`) — including\n//     when that file is itself a route's colocated component and is linted\n//     directly rather than through the importing route.\n//   - A route whose loader references the factory identifier.\n//   - A colocated import that isn't under a dash-prefixed directory, or that\n//     can't be read as a sibling `.tsx`/`.ts` file (no fs read is attempted\n//     unless the file is already a confirmed route file with such an import).\n//\n// Known limitation: the child-file scan is a raw-text regex, not a second AST\n// parse, so it does not strip comments or string literals. A comment or\n// string in the colocated file that happens to spell out\n// `useSuspenseQuery(identifier(` / `useSuspenseQuery(identifier)` verbatim\n// would false-positive. Judged an acceptable, rare edge case for the\n// bounded/cheap scan this rule relies on; do not write that literal pattern\n// in prose comments inside `-components`/`-hooks`/`-queries` files.\n\nimport { eslintCompatPlugin, type Ranged } from \"@oxlint/plugins\";\nimport { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport {\n  getPropertyName,\n  isIdentifier,\n  isStringLiteral,\n  unwrapExpression,\n} from \"./utils.ts\";\n\nconst CREATE_FILE_ROUTE = \"createFileRoute\";\nconst SUSPENSE_HOOK = \"useSuspenseQuery\";\nconst LOADER_KEY = \"loader\";\n\nconst isCreateFileRouteCall = (callee) =>\n  isIdentifier(callee, CREATE_FILE_ROUTE);\n\n// `createFileRoute(\"...\")({ ... })` — the outer call whose callee is itself the\n// `createFileRoute(\"...\")` call. The first argument is the route options object.\nconst isCreateFileRouteOptionsCall = (callee) =>\n  callee?.type === \"CallExpression\" && isCreateFileRouteCall(callee.callee);\n\nconst isSuspenseCallee = (callee) => {\n  if (isIdentifier(callee, SUSPENSE_HOOK)) {\n    return true;\n  }\n  return (\n    callee?.type === \"MemberExpression\" &&\n    callee.computed === false &&\n    isIdentifier(callee.property, SUSPENSE_HOOK)\n  );\n};\n\n// Resolve the factory identifier a `useSuspenseQuery` call depends on:\n//   useSuspenseQuery(factory(...)) -> \"factory\"\n//   useSuspenseQuery(factory)      -> \"factory\"\n// Returns null for any other argument shape (member expressions, object\n// literals, etc.) so the rule never guesses.\nconst suspenseFactoryName = (node) => {\n  if (!isSuspenseCallee(node.callee)) {\n    return null;\n  }\n  const arg = unwrapExpression(node.arguments?.[0]);\n  if (arg?.type === \"CallExpression\" && isIdentifier(arg.callee)) {\n    return arg.callee.name;\n  }\n  if (isIdentifier(arg)) {\n    return arg.name;\n  }\n  return null;\n};\n\nconst isInsideLoader = (node) => {\n  let current = node.parent;\n  while (current) {\n    if (\n      current.type === \"Property\" &&\n      getPropertyName(current.key) === LOADER_KEY\n    ) {\n      return true;\n    }\n    current = current.parent;\n  }\n  return false;\n};\n\nconst ROUTES_SEGMENT = \"/routes/\";\nconst COLOCATED_DIR_RE = /\\/-[^/]+\\//;\n\n// A colocated, non-route-generating import: under `@/routes/...` and through\n// a dash-prefixed directory (`-components/`, `-hooks/`, `-queries/`, ...).\nconst isColocatedRouteImport = (source) =>\n  source.startsWith(\"@/routes/\") && COLOCATED_DIR_RE.test(source);\n\n// Resolve a `@/routes/...` specifier to an absolute path by reusing the\n// currently-linted file's own path up to its `/routes/` segment as the alias\n// root — mirrors the `\"@/*\": [\"./src/*\"]` tsconfig path without a real module\n// resolver. Returns null if the linted file isn't itself under a `routes`\n// directory (shouldn't happen for a confirmed route file, but fails closed).\nconst resolveColocatedImportBase = (filename, source) => {\n  // Windows gives `context.filename` with backslashes, which would make\n  // `lastIndexOf(ROUTES_SEGMENT)` miss; normalize to forward slashes first\n  // (valid path input on Windows, and `join` below normalizes the output).\n  const normalizedFilename = filename.replaceAll(\"\\\\\", \"/\");\n  const routesIndex = normalizedFilename.lastIndexOf(ROUTES_SEGMENT);\n  if (routesIndex === -1) {\n    return null;\n  }\n  const aliasRoot = normalizedFilename.slice(0, routesIndex);\n  return path.join(aliasRoot, source.slice(\"@/\".length));\n};\n\n// Bounded, one-hop read: try the two extensions a colocated TS/TSX import can\n// resolve to. No further imports of the child file are followed.\nconst readColocatedFile = (basePath) => {\n  for (const extension of [\".tsx\", \".ts\"]) {\n    try {\n      return readFileSync(`${basePath}${extension}`, \"utf-8\");\n    } catch {\n      // Try the next extension; if neither exists this is a shape the\n      // simplified alias resolution can't handle (e.g. a directory index) —\n      // acceptable since this is a best-effort bounded check, not a resolver.\n    }\n  }\n  return null;\n};\n\n// Regex counterpart of `suspenseFactoryName`, scanning raw source text for\n// the same two argument shapes: `useSuspenseQuery(factory(...))` and\n// `useSuspenseQuery(factory)`. The character right after the identifier\n// disambiguates them from a member-expression argument the AST check would\n// also decline to attribute (e.g. `useSuspenseQuery(factory.options())`).\nconst CHILD_SUSPENSE_RE = /useSuspenseQuery\\(\\s*([A-Za-z_$][\\w$]*)\\s*([(),])/g;\n\nconst suspenseFactoriesInSource = (sourceText: string): Set<string> => {\n  const factories = new Set<string>();\n  for (const match of sourceText.matchAll(CHILD_SUSPENSE_RE)) {\n    const factory = match[1];\n    if (factory !== undefined) {\n      factories.add(factory);\n    }\n  }\n  return factories;\n};\n\nexport default eslintCompatPlugin({\n  meta: { name: \"require-loader-prefetch\" },\n  rules: {\n    \"require-loader-prefetch\": {\n      meta: {\n        type: \"problem\",\n        messages: {\n          missingLoaderPrefetch:\n            \"Route component calls useSuspenseQuery({{factory}}(...)) but the \" +\n            \"route defines no `loader`, so this query fetches only after the \" +\n            \"component mounts and suspends — an extra sequential network round \" +\n            \"on cold navigation. Prefetch the same query options in the route \" +\n            \"`loader` via ensureRouteQueryData (blocking, critical data) or \" +\n            \"prefetchRouteQuery (non-blocking) from @/lib/react-query, so the \" +\n            \"fetch starts during navigation and useSuspenseQuery consumes the \" +\n            \"warm cache.\",\n          factoryNotPrefetched:\n            \"Route component calls useSuspenseQuery({{factory}}(...)) but the \" +\n            \"route `loader` never references {{factory}}, so this query still \" +\n            \"fetches on mount — an extra sequential network round on cold \" +\n            \"navigation. Prefetch {{factory}}(...) in the `loader` via \" +\n            \"ensureRouteQueryData (blocking, critical data) or \" +\n            \"prefetchRouteQuery (non-blocking) from @/lib/react-query; \" +\n            \"useSuspenseQuery in the component then consumes the warm cache.\",\n          childMissingLoaderPrefetch:\n            \"Route imports {{importPath}}, whose component calls \" +\n            \"useSuspenseQuery({{factory}}(...)), but the route defines no \" +\n            \"`loader`, so this query fetches only after the child component \" +\n            \"mounts and suspends — an extra sequential network round on cold \" +\n            \"navigation. Prefetch the same query options in the route \" +\n            \"`loader` via ensureRouteQueryData (blocking, critical data) or \" +\n            \"prefetchRouteQuery (non-blocking) from @/lib/react-query, so the \" +\n            \"fetch starts during navigation and useSuspenseQuery in the child \" +\n            \"component consumes the warm cache.\",\n          childFactoryNotPrefetched:\n            \"Route imports {{importPath}}, whose component calls \" +\n            \"useSuspenseQuery({{factory}}(...)), but the route `loader` never \" +\n            \"references {{factory}}, so this query still fetches on mount — \" +\n            \"an extra sequential network round on cold navigation. Prefetch \" +\n            \"{{factory}}(...) in the `loader` via ensureRouteQueryData \" +\n            \"(blocking, critical data) or prefetchRouteQuery (non-blocking) \" +\n            \"from @/lib/react-query; useSuspenseQuery in the child component \" +\n            \"then consumes the warm cache.\",\n        },\n      },\n      createOnce(context) {\n        let isRouteFile = false;\n        let routeOptions: { properties: unknown } | null = null;\n        const suspenseCalls: { factory: string; node: Ranged }[] = [];\n        const referencedInLoader = new Set();\n        const colocatedImports: { node: Ranged; source: string }[] = [];\n\n        return {\n          before() {\n            isRouteFile = false;\n            routeOptions = null;\n            suspenseCalls.length = 0;\n            referencedInLoader.clear();\n            colocatedImports.length = 0;\n          },\n          CallExpression(node) {\n            const callee = node.callee;\n\n            if (isCreateFileRouteCall(callee)) {\n              isRouteFile = true;\n            }\n\n            if (isCreateFileRouteOptionsCall(callee)) {\n              isRouteFile = true;\n              const optionsArg = node.arguments?.[0];\n              if (\n                routeOptions === null &&\n                optionsArg?.type === \"ObjectExpression\"\n              ) {\n                routeOptions = optionsArg;\n              }\n            }\n\n            const factory = suspenseFactoryName(node);\n            if (factory !== null) {\n              suspenseCalls.push({ node, factory });\n            }\n          },\n\n          Identifier(node) {\n            if (isInsideLoader(node)) {\n              referencedInLoader.add(node.name);\n            }\n          },\n\n          ImportDeclaration(node) {\n            if (\n              isStringLiteral(node.source) &&\n              isColocatedRouteImport(node.source.value)\n            ) {\n              colocatedImports.push({ node, source: node.source.value });\n            }\n          },\n\n          \"Program:exit\"() {\n            // Only route files with an inline options object are analyzable;\n            // a non-inline options argument can't be statically inspected.\n            if (!isRouteFile || routeOptions === null) {\n              return;\n            }\n\n            const properties = Array.isArray(routeOptions.properties)\n              ? routeOptions.properties\n              : [];\n            const hasLoader = properties.some(\n              (prop) =>\n                prop.type === \"Property\" &&\n                getPropertyName(prop.key) === LOADER_KEY,\n            );\n\n            for (const { node, factory } of suspenseCalls) {\n              if (!hasLoader) {\n                context.report({\n                  node,\n                  messageId: \"missingLoaderPrefetch\",\n                  data: { factory },\n                });\n                continue;\n              }\n\n              if (!referencedInLoader.has(factory)) {\n                context.report({\n                  node,\n                  messageId: \"factoryNotPrefetched\",\n                  data: { factory },\n                });\n              }\n            }\n\n            if (colocatedImports.length === 0) {\n              return;\n            }\n\n            const filename = context.filename ?? context.getFilename?.();\n            if (typeof filename !== \"string\") {\n              return;\n            }\n\n            for (const { node, source } of colocatedImports) {\n              const basePath = resolveColocatedImportBase(filename, source);\n              if (basePath === null) {\n                continue;\n              }\n\n              const childSource = readColocatedFile(basePath);\n              if (childSource === null) {\n                continue;\n              }\n\n              for (const factory of suspenseFactoriesInSource(childSource)) {\n                if (!hasLoader) {\n                  context.report({\n                    node,\n                    messageId: \"childMissingLoaderPrefetch\",\n                    data: { factory, importPath: source },\n                  });\n                  continue;\n                }\n\n                if (!referencedInLoader.has(factory)) {\n                  context.report({\n                    node,\n                    messageId: \"childFactoryNotPrefetched\",\n                    data: { factory, importPath: source },\n                  });\n                }\n              }\n            }\n          },\n        };\n      },\n    },\n  },\n});\n"],"mappings":"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"}

package/dist/require-loader-prefetch.d.cts

@@ -0,0 +1,4 @@
+//#region src/require-loader-prefetch.d.ts
+declare const _default: import("@oxlint/plugins").Plugin;
+export = _default;
+//# sourceMappingURL=require-loader-prefetch.d.cts.map

package/dist/require-loader-prefetch.d.mts

@@ -0,0 +1,5 @@
+//#region src/require-loader-prefetch.d.ts
+declare const _default: import("@oxlint/plugins").Plugin;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=require-loader-prefetch.d.mts.map

package/dist/require-loader-prefetch.mjs

@@ -0,0 +1,160 @@
+import { a as isStringLiteral, i as isIdentifier, o as unwrapExpression, r as getPropertyName } from "./utils.mjs";
+import { eslintCompatPlugin } from "@oxlint/plugins";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+//#region src/require-loader-prefetch.ts
+const CREATE_FILE_ROUTE = "createFileRoute";
+const SUSPENSE_HOOK = "useSuspenseQuery";
+const LOADER_KEY = "loader";
+const isCreateFileRouteCall = (callee) => isIdentifier(callee, CREATE_FILE_ROUTE);
+const isCreateFileRouteOptionsCall = (callee) => callee?.type === "CallExpression" && isCreateFileRouteCall(callee.callee);
+const isSuspenseCallee = (callee) => {
+	if (isIdentifier(callee, SUSPENSE_HOOK)) return true;
+	return callee?.type === "MemberExpression" && callee.computed === false && isIdentifier(callee.property, SUSPENSE_HOOK);
+};
+const suspenseFactoryName = (node) => {
+	if (!isSuspenseCallee(node.callee)) return null;
+	const arg = unwrapExpression(node.arguments?.[0]);
+	if (arg?.type === "CallExpression" && isIdentifier(arg.callee)) return arg.callee.name;
+	if (isIdentifier(arg)) return arg.name;
+	return null;
+};
+const isInsideLoader = (node) => {
+	let current = node.parent;
+	while (current) {
+		if (current.type === "Property" && getPropertyName(current.key) === LOADER_KEY) return true;
+		current = current.parent;
+	}
+	return false;
+};
+const ROUTES_SEGMENT = "/routes/";
+const COLOCATED_DIR_RE = /\/-[^/]+\//;
+const isColocatedRouteImport = (source) => source.startsWith("@/routes/") && COLOCATED_DIR_RE.test(source);
+const resolveColocatedImportBase = (filename, source) => {
+	const normalizedFilename = filename.replaceAll("\\", "/");
+	const routesIndex = normalizedFilename.lastIndexOf(ROUTES_SEGMENT);
+	if (routesIndex === -1) return null;
+	const aliasRoot = normalizedFilename.slice(0, routesIndex);
+	return path.join(aliasRoot, source.slice(2));
+};
+const readColocatedFile = (basePath) => {
+	for (const extension of [".tsx", ".ts"]) try {
+		return readFileSync(`${basePath}${extension}`, "utf-8");
+	} catch {}
+	return null;
+};
+const CHILD_SUSPENSE_RE = /useSuspenseQuery\(\s*([A-Za-z_$][\w$]*)\s*([(),])/g;
+const suspenseFactoriesInSource = (sourceText) => {
+	const factories = /* @__PURE__ */ new Set();
+	for (const match of sourceText.matchAll(CHILD_SUSPENSE_RE)) {
+		const factory = match[1];
+		if (factory !== void 0) factories.add(factory);
+	}
+	return factories;
+};
+var require_loader_prefetch_default = eslintCompatPlugin({
+	meta: { name: "require-loader-prefetch" },
+	rules: { "require-loader-prefetch": {
+		meta: {
+			type: "problem",
+			messages: {
+				missingLoaderPrefetch: "Route component calls useSuspenseQuery({{factory}}(...)) but the route defines no `loader`, so this query fetches only after the component mounts and suspends — an extra sequential network round on cold navigation. Prefetch the same query options in the route `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query, so the fetch starts during navigation and useSuspenseQuery consumes the warm cache.",
+				factoryNotPrefetched: "Route component calls useSuspenseQuery({{factory}}(...)) but the route `loader` never references {{factory}}, so this query still fetches on mount — an extra sequential network round on cold navigation. Prefetch {{factory}}(...) in the `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query; useSuspenseQuery in the component then consumes the warm cache.",
+				childMissingLoaderPrefetch: "Route imports {{importPath}}, whose component calls useSuspenseQuery({{factory}}(...)), but the route defines no `loader`, so this query fetches only after the child component mounts and suspends — an extra sequential network round on cold navigation. Prefetch the same query options in the route `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query, so the fetch starts during navigation and useSuspenseQuery in the child component consumes the warm cache.",
+				childFactoryNotPrefetched: "Route imports {{importPath}}, whose component calls useSuspenseQuery({{factory}}(...)), but the route `loader` never references {{factory}}, so this query still fetches on mount — an extra sequential network round on cold navigation. Prefetch {{factory}}(...) in the `loader` via ensureRouteQueryData (blocking, critical data) or prefetchRouteQuery (non-blocking) from @/lib/react-query; useSuspenseQuery in the child component then consumes the warm cache."
+			}
+		},
+		createOnce(context) {
+			let isRouteFile = false;
+			let routeOptions = null;
+			const suspenseCalls = [];
+			const referencedInLoader = /* @__PURE__ */ new Set();
+			const colocatedImports = [];
+			return {
+				before() {
+					isRouteFile = false;
+					routeOptions = null;
+					suspenseCalls.length = 0;
+					referencedInLoader.clear();
+					colocatedImports.length = 0;
+				},
+				CallExpression(node) {
+					const callee = node.callee;
+					if (isCreateFileRouteCall(callee)) isRouteFile = true;
+					if (isCreateFileRouteOptionsCall(callee)) {
+						isRouteFile = true;
+						const optionsArg = node.arguments?.[0];
+						if (routeOptions === null && optionsArg?.type === "ObjectExpression") routeOptions = optionsArg;
+					}
+					const factory = suspenseFactoryName(node);
+					if (factory !== null) suspenseCalls.push({
+						node,
+						factory
+					});
+				},
+				Identifier(node) {
+					if (isInsideLoader(node)) referencedInLoader.add(node.name);
+				},
+				ImportDeclaration(node) {
+					if (isStringLiteral(node.source) && isColocatedRouteImport(node.source.value)) colocatedImports.push({
+						node,
+						source: node.source.value
+					});
+				},
+				"Program:exit"() {
+					if (!isRouteFile || routeOptions === null) return;
+					const hasLoader = (Array.isArray(routeOptions.properties) ? routeOptions.properties : []).some((prop) => prop.type === "Property" && getPropertyName(prop.key) === LOADER_KEY);
+					for (const { node, factory } of suspenseCalls) {
+						if (!hasLoader) {
+							context.report({
+								node,
+								messageId: "missingLoaderPrefetch",
+								data: { factory }
+							});
+							continue;
+						}
+						if (!referencedInLoader.has(factory)) context.report({
+							node,
+							messageId: "factoryNotPrefetched",
+							data: { factory }
+						});
+					}
+					if (colocatedImports.length === 0) return;
+					const filename = context.filename ?? context.getFilename?.();
+					if (typeof filename !== "string") return;
+					for (const { node, source } of colocatedImports) {
+						const basePath = resolveColocatedImportBase(filename, source);
+						if (basePath === null) continue;
+						const childSource = readColocatedFile(basePath);
+						if (childSource === null) continue;
+						for (const factory of suspenseFactoriesInSource(childSource)) {
+							if (!hasLoader) {
+								context.report({
+									node,
+									messageId: "childMissingLoaderPrefetch",
+									data: {
+										factory,
+										importPath: source
+									}
+								});
+								continue;
+							}
+							if (!referencedInLoader.has(factory)) context.report({
+								node,
+								messageId: "childFactoryNotPrefetched",
+								data: {
+									factory,
+									importPath: source
+								}
+							});
+						}
+					}
+				}
+			};
+		}
+	} }
+});
+//#endregion
+export { require_loader_prefetch_default as default };
+
+//# sourceMappingURL=require-loader-prefetch.mjs.map

package/dist/require-loader-prefetch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-loader-prefetch.mjs","names":[],"sources":["../src/require-loader-prefetch.ts"],"sourcesContent":["// Require route loaders to prefetch the queries their component suspends on.\n//\n// A route component that calls `useSuspenseQuery(someOptions(...))` without the\n// route loader prefetching that same query forces a render-fetch waterfall: on\n// a cold visit the router resolves the route, the component mounts, suspends,\n// and only THEN starts the fetch — an extra sequential network round on every\n// cold navigation. TanStack Router loaders (`loader:` in `createFileRoute`\n// options) start the fetch during navigation, in parallel with code-split\n// chunk loading, via the helpers in `apps/web/src/lib/react-query.ts`\n// (`ensureRouteQueryData` for critical/blocking data, `prefetchRouteQuery` for\n// non-blocking warmup). With the loader priming the cache, `useSuspenseQuery`\n// in the component consumes a warm cache instead of opening a new round.\n//\n// Single-file AST analysis, scoped to route files (`createFileRoute(...)`):\n//   - Flags `useSuspenseQuery(factory(...))` / `useSuspenseQuery(factory)` when\n//     the route has no `loader`.\n//   - Flags the same when a `loader` exists but never references the factory\n//     identifier (any reference inside the loader body counts — typically\n//     inside `ensureRouteQueryData` / `prefetchRouteQuery`).\n//\n// Cross-file, one-hop check for colocated route components: the single-file\n// analysis above is blind to a `useSuspenseQuery(factory(...))` call living in\n// a sibling file imported by the route (the codebase convention for colocated,\n// non-route-generating files is a dash-prefixed directory next to the route,\n// e.g. `-components/`, `-hooks/`, `-queries/`, imported via the `@/routes/...`\n// alias — TanStack Router excludes `-`-prefixed paths from route generation).\n// A real instance of this shipped on `/settings/account/connections` before\n// being caught by the e2e depth guard: the page component had no\n// `useSuspenseQuery` of its own, it all lived in a child card component.\n//\n// To close that gap without a real module resolver: once a file is confirmed\n// to be a route file with an inline options object (the same precondition the\n// single-file check already requires), each `@/routes/.../-<dir>/...` import\n// it declares is resolved to an absolute path by reusing the *linted file's\n// own* path up to its `/routes/` segment as the alias root (mirrors the\n// `\"@/*\": [\"./src/*\"]` tsconfig path). The resolved file is read once — bounded\n// to that one hop, its own imports are never followed — and scanned with a\n// regex for the same two `useSuspenseQuery(...)` shapes the AST check\n// recognizes. Any factory it finds is checked against the route's `loader`\n// exactly like an in-file suspense call would be.\n//\n// Safe (not flagged):\n//   - `useSuspenseQuery` whose argument is a member expression or other shape\n//     the rule can't statically attribute to a factory identifier (in-file or\n//     in a colocated import).\n//   - `useSuspenseQuery` in a non-route file (no `createFileRoute`) — including\n//     when that file is itself a route's colocated component and is linted\n//     directly rather than through the importing route.\n//   - A route whose loader references the factory identifier.\n//   - A colocated import that isn't under a dash-prefixed directory, or that\n//     can't be read as a sibling `.tsx`/`.ts` file (no fs read is attempted\n//     unless the file is already a confirmed route file with such an import).\n//\n// Known limitation: the child-file scan is a raw-text regex, not a second AST\n// parse, so it does not strip comments or string literals. A comment or\n// string in the colocated file that happens to spell out\n// `useSuspenseQuery(identifier(` / `useSuspenseQuery(identifier)` verbatim\n// would false-positive. Judged an acceptable, rare edge case for the\n// bounded/cheap scan this rule relies on; do not write that literal pattern\n// in prose comments inside `-components`/`-hooks`/`-queries` files.\n\nimport { eslintCompatPlugin, type Ranged } from \"@oxlint/plugins\";\nimport { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport {\n  getPropertyName,\n  isIdentifier,\n  isStringLiteral,\n  unwrapExpression,\n} from \"./utils.ts\";\n\nconst CREATE_FILE_ROUTE = \"createFileRoute\";\nconst SUSPENSE_HOOK = \"useSuspenseQuery\";\nconst LOADER_KEY = \"loader\";\n\nconst isCreateFileRouteCall = (callee) =>\n  isIdentifier(callee, CREATE_FILE_ROUTE);\n\n// `createFileRoute(\"...\")({ ... })` — the outer call whose callee is itself the\n// `createFileRoute(\"...\")` call. The first argument is the route options object.\nconst isCreateFileRouteOptionsCall = (callee) =>\n  callee?.type === \"CallExpression\" && isCreateFileRouteCall(callee.callee);\n\nconst isSuspenseCallee = (callee) => {\n  if (isIdentifier(callee, SUSPENSE_HOOK)) {\n    return true;\n  }\n  return (\n    callee?.type === \"MemberExpression\" &&\n    callee.computed === false &&\n    isIdentifier(callee.property, SUSPENSE_HOOK)\n  );\n};\n\n// Resolve the factory identifier a `useSuspenseQuery` call depends on:\n//   useSuspenseQuery(factory(...)) -> \"factory\"\n//   useSuspenseQuery(factory)      -> \"factory\"\n// Returns null for any other argument shape (member expressions, object\n// literals, etc.) so the rule never guesses.\nconst suspenseFactoryName = (node) => {\n  if (!isSuspenseCallee(node.callee)) {\n    return null;\n  }\n  const arg = unwrapExpression(node.arguments?.[0]);\n  if (arg?.type === \"CallExpression\" && isIdentifier(arg.callee)) {\n    return arg.callee.name;\n  }\n  if (isIdentifier(arg)) {\n    return arg.name;\n  }\n  return null;\n};\n\nconst isInsideLoader = (node) => {\n  let current = node.parent;\n  while (current) {\n    if (\n      current.type === \"Property\" &&\n      getPropertyName(current.key) === LOADER_KEY\n    ) {\n      return true;\n    }\n    current = current.parent;\n  }\n  return false;\n};\n\nconst ROUTES_SEGMENT = \"/routes/\";\nconst COLOCATED_DIR_RE = /\\/-[^/]+\\//;\n\n// A colocated, non-route-generating import: under `@/routes/...` and through\n// a dash-prefixed directory (`-components/`, `-hooks/`, `-queries/`, ...).\nconst isColocatedRouteImport = (source) =>\n  source.startsWith(\"@/routes/\") && COLOCATED_DIR_RE.test(source);\n\n// Resolve a `@/routes/...` specifier to an absolute path by reusing the\n// currently-linted file's own path up to its `/routes/` segment as the alias\n// root — mirrors the `\"@/*\": [\"./src/*\"]` tsconfig path without a real module\n// resolver. Returns null if the linted file isn't itself under a `routes`\n// directory (shouldn't happen for a confirmed route file, but fails closed).\nconst resolveColocatedImportBase = (filename, source) => {\n  // Windows gives `context.filename` with backslashes, which would make\n  // `lastIndexOf(ROUTES_SEGMENT)` miss; normalize to forward slashes first\n  // (valid path input on Windows, and `join` below normalizes the output).\n  const normalizedFilename = filename.replaceAll(\"\\\\\", \"/\");\n  const routesIndex = normalizedFilename.lastIndexOf(ROUTES_SEGMENT);\n  if (routesIndex === -1) {\n    return null;\n  }\n  const aliasRoot = normalizedFilename.slice(0, routesIndex);\n  return path.join(aliasRoot, source.slice(\"@/\".length));\n};\n\n// Bounded, one-hop read: try the two extensions a colocated TS/TSX import can\n// resolve to. No further imports of the child file are followed.\nconst readColocatedFile = (basePath) => {\n  for (const extension of [\".tsx\", \".ts\"]) {\n    try {\n      return readFileSync(`${basePath}${extension}`, \"utf-8\");\n    } catch {\n      // Try the next extension; if neither exists this is a shape the\n      // simplified alias resolution can't handle (e.g. a directory index) —\n      // acceptable since this is a best-effort bounded check, not a resolver.\n    }\n  }\n  return null;\n};\n\n// Regex counterpart of `suspenseFactoryName`, scanning raw source text for\n// the same two argument shapes: `useSuspenseQuery(factory(...))` and\n// `useSuspenseQuery(factory)`. The character right after the identifier\n// disambiguates them from a member-expression argument the AST check would\n// also decline to attribute (e.g. `useSuspenseQuery(factory.options())`).\nconst CHILD_SUSPENSE_RE = /useSuspenseQuery\\(\\s*([A-Za-z_$][\\w$]*)\\s*([(),])/g;\n\nconst suspenseFactoriesInSource = (sourceText: string): Set<string> => {\n  const factories = new Set<string>();\n  for (const match of sourceText.matchAll(CHILD_SUSPENSE_RE)) {\n    const factory = match[1];\n    if (factory !== undefined) {\n      factories.add(factory);\n    }\n  }\n  return factories;\n};\n\nexport default eslintCompatPlugin({\n  meta: { name: \"require-loader-prefetch\" },\n  rules: {\n    \"require-loader-prefetch\": {\n      meta: {\n        type: \"problem\",\n        messages: {\n          missingLoaderPrefetch:\n            \"Route component calls useSuspenseQuery({{factory}}(...)) but the \" +\n            \"route defines no `loader`, so this query fetches only after the \" +\n            \"component mounts and suspends — an extra sequential network round \" +\n            \"on cold navigation. Prefetch the same query options in the route \" +\n            \"`loader` via ensureRouteQueryData (blocking, critical data) or \" +\n            \"prefetchRouteQuery (non-blocking) from @/lib/react-query, so the \" +\n            \"fetch starts during navigation and useSuspenseQuery consumes the \" +\n            \"warm cache.\",\n          factoryNotPrefetched:\n            \"Route component calls useSuspenseQuery({{factory}}(...)) but the \" +\n            \"route `loader` never references {{factory}}, so this query still \" +\n            \"fetches on mount — an extra sequential network round on cold \" +\n            \"navigation. Prefetch {{factory}}(...) in the `loader` via \" +\n            \"ensureRouteQueryData (blocking, critical data) or \" +\n            \"prefetchRouteQuery (non-blocking) from @/lib/react-query; \" +\n            \"useSuspenseQuery in the component then consumes the warm cache.\",\n          childMissingLoaderPrefetch:\n            \"Route imports {{importPath}}, whose component calls \" +\n            \"useSuspenseQuery({{factory}}(...)), but the route defines no \" +\n            \"`loader`, so this query fetches only after the child component \" +\n            \"mounts and suspends — an extra sequential network round on cold \" +\n            \"navigation. Prefetch the same query options in the route \" +\n            \"`loader` via ensureRouteQueryData (blocking, critical data) or \" +\n            \"prefetchRouteQuery (non-blocking) from @/lib/react-query, so the \" +\n            \"fetch starts during navigation and useSuspenseQuery in the child \" +\n            \"component consumes the warm cache.\",\n          childFactoryNotPrefetched:\n            \"Route imports {{importPath}}, whose component calls \" +\n            \"useSuspenseQuery({{factory}}(...)), but the route `loader` never \" +\n            \"references {{factory}}, so this query still fetches on mount — \" +\n            \"an extra sequential network round on cold navigation. Prefetch \" +\n            \"{{factory}}(...) in the `loader` via ensureRouteQueryData \" +\n            \"(blocking, critical data) or prefetchRouteQuery (non-blocking) \" +\n            \"from @/lib/react-query; useSuspenseQuery in the child component \" +\n            \"then consumes the warm cache.\",\n        },\n      },\n      createOnce(context) {\n        let isRouteFile = false;\n        let routeOptions: { properties: unknown } | null = null;\n        const suspenseCalls: { factory: string; node: Ranged }[] = [];\n        const referencedInLoader = new Set();\n        const colocatedImports: { node: Ranged; source: string }[] = [];\n\n        return {\n          before() {\n            isRouteFile = false;\n            routeOptions = null;\n            suspenseCalls.length = 0;\n            referencedInLoader.clear();\n            colocatedImports.length = 0;\n          },\n          CallExpression(node) {\n            const callee = node.callee;\n\n            if (isCreateFileRouteCall(callee)) {\n              isRouteFile = true;\n            }\n\n            if (isCreateFileRouteOptionsCall(callee)) {\n              isRouteFile = true;\n              const optionsArg = node.arguments?.[0];\n              if (\n                routeOptions === null &&\n                optionsArg?.type === \"ObjectExpression\"\n              ) {\n                routeOptions = optionsArg;\n              }\n            }\n\n            const factory = suspenseFactoryName(node);\n            if (factory !== null) {\n              suspenseCalls.push({ node, factory });\n            }\n          },\n\n          Identifier(node) {\n            if (isInsideLoader(node)) {\n              referencedInLoader.add(node.name);\n            }\n          },\n\n          ImportDeclaration(node) {\n            if (\n              isStringLiteral(node.source) &&\n              isColocatedRouteImport(node.source.value)\n            ) {\n              colocatedImports.push({ node, source: node.source.value });\n            }\n          },\n\n          \"Program:exit\"() {\n            // Only route files with an inline options object are analyzable;\n            // a non-inline options argument can't be statically inspected.\n            if (!isRouteFile || routeOptions === null) {\n              return;\n            }\n\n            const properties = Array.isArray(routeOptions.properties)\n              ? routeOptions.properties\n              : [];\n            const hasLoader = properties.some(\n              (prop) =>\n                prop.type === \"Property\" &&\n                getPropertyName(prop.key) === LOADER_KEY,\n            );\n\n            for (const { node, factory } of suspenseCalls) {\n              if (!hasLoader) {\n                context.report({\n                  node,\n                  messageId: \"missingLoaderPrefetch\",\n                  data: { factory },\n                });\n                continue;\n              }\n\n              if (!referencedInLoader.has(factory)) {\n                context.report({\n                  node,\n                  messageId: \"factoryNotPrefetched\",\n                  data: { factory },\n                });\n              }\n            }\n\n            if (colocatedImports.length === 0) {\n              return;\n            }\n\n            const filename = context.filename ?? context.getFilename?.();\n            if (typeof filename !== \"string\") {\n              return;\n            }\n\n            for (const { node, source } of colocatedImports) {\n              const basePath = resolveColocatedImportBase(filename, source);\n              if (basePath === null) {\n                continue;\n              }\n\n              const childSource = readColocatedFile(basePath);\n              if (childSource === null) {\n                continue;\n              }\n\n              for (const factory of suspenseFactoriesInSource(childSource)) {\n                if (!hasLoader) {\n                  context.report({\n                    node,\n                    messageId: \"childMissingLoaderPrefetch\",\n                    data: { factory, importPath: source },\n                  });\n                  continue;\n                }\n\n                if (!referencedInLoader.has(factory)) {\n                  context.report({\n                    node,\n                    messageId: \"childFactoryNotPrefetched\",\n                    data: { factory, importPath: source },\n                  });\n                }\n              }\n            }\n          },\n        };\n      },\n    },\n  },\n});\n"],"mappings":"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"}

package/dist/utils.cjs

@@ -25,6 +25,13 @@ const unwrapExpression = (node) => {
 	if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ChainExpression") return unwrapExpression(node.expression);
 	return node;
 };
+const getImportedName = (specifier) => {
+	if (!isAstNode(specifier) || specifier.type !== "ImportSpecifier") return null;
+	const imported = specifier.imported;
+	if (isIdentifier(imported)) return imported.name;
+	if (isStringLiteral(imported)) return imported.value;
+	return null;
+};
 //#endregion
 Object.defineProperty(exports, "getCalleeName", {
 	enumerable: true,
@@ -32,6 +39,12 @@ Object.defineProperty(exports, "getCalleeName", {
 		return getCalleeName;
 	}
 });
+Object.defineProperty(exports, "getImportedName", {
+	enumerable: true,
+	get: function() {
+		return getImportedName;
+	}
+});
 Object.defineProperty(exports, "getPropertyName", {
 	enumerable: true,
 	get: function() {
@@ -44,6 +57,12 @@ Object.defineProperty(exports, "isIdentifier", {
 		return isIdentifier;
 	}
 });
+Object.defineProperty(exports, "isStringLiteral", {
+	enumerable: true,
+	get: function() {
+		return isStringLiteral;
+	}
+});
 Object.defineProperty(exports, "unwrapExpression", {
 	enumerable: true,
 	get: function() {

package/dist/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["// Shared AST helpers for the rules in this folder.\n//\n// Oxlint plugin AST nodes are passed in untyped. Each helper narrows from\n// `unknown` so rule files can call them without per-call type ceremony or\n// shared type-import boilerplate.\n\nimport type { Ranged } from \"@oxlint/plugins\";\n\nexport type AstNode = Ranged & { type: string } & Record<string, unknown>;\n\ntype FilenameContext = {\n  filename?: string;\n  getFilename?: () => string;\n};\n\nexport const filenameForContext = (context: FilenameContext): string =>\n  (context.filename ?? context.getFilename?.() ?? \"\").replaceAll(\"\\\\\", \"/\");\n\nexport const isAstNode = (node: unknown): node is AstNode =>\n  typeof node === \"object\" &&\n  node !== null &&\n  \"type\" in node &&\n  typeof (node as { type: unknown }).type === \"string\" &&\n  \"range\" in node;\n\nexport const isIdentifier = (\n  node: unknown,\n  name?: string,\n): node is AstNode & { type: \"Identifier\"; name: string } => {\n  if (!isAstNode(node) || node.type !== \"Identifier\") {\n    return false;\n  }\n  if (typeof node.name !== \"string\") {\n    return false;\n  }\n  return name === undefined || node.name === name;\n};\n\nexport const isStringLiteral = (\n  node: unknown,\n): node is AstNode & { type: \"Literal\"; value: string } =>\n  isAstNode(node) && node.type === \"Literal\" && typeof node.value === \"string\";\n\n// Resolve the static name of a Property or MemberExpression key:\n// Identifier.name or string-Literal.value. Returns null for computed keys\n// driven by a non-literal expression.\nexport const getPropertyName = (node: unknown): string | null => {\n  if (isIdentifier(node)) {\n    return node.name;\n  }\n  if (isStringLiteral(node)) {\n    return node.value;\n  }\n  return null;\n};\n\n// Match `<object>.<property>` member access where both halves are\n// Identifiers and the access is not computed.\nexport const isMemberAccess = (\n  node: unknown,\n  object: string,\n  property: string,\n): boolean =>\n  isAstNode(node) &&\n  node.type === \"MemberExpression\" &&\n  node.computed === false &&\n  isIdentifier(node.object, object) &&\n  isIdentifier(node.property, property);\n\n// Match `CallExpression` whose callee is an Identifier with the given name.\nexport const isCallTo = (node: unknown, name: string): boolean =>\n  isAstNode(node) &&\n  node.type === \"CallExpression\" &&\n  isIdentifier(node.callee, name);\n\n// Resolve the dot-notation name of a callee: an Identifier, or a\n// non-computed MemberExpression chain (e.g. `t.String`, `Schema.is`,\n// `process.stderr.write`). Returns null when the chain is computed\n// or the property name itself can't be resolved.\n//\n// If the chain is rooted at a non-Identifier expression (e.g. `foo().bar`),\n// returns the bare property name (\"bar\") rather than null. Callers that\n// match the result against a fixed allowlist must consider whether they\n// need to distinguish `foo().createSafeHandler` from `createSafeHandler`.\nexport const getCalleeName = (callee: unknown): string | null => {\n  if (isIdentifier(callee)) {\n    return callee.name;\n  }\n  if (!isAstNode(callee) || callee.type !== \"MemberExpression\") {\n    return null;\n  }\n  if (callee.computed !== false) {\n    return null;\n  }\n  const objectName = getCalleeName(callee.object);\n  const propertyName = getPropertyName(callee.property);\n  if (propertyName === null) {\n    return null;\n  }\n  return objectName === null ? propertyName : `${objectName}.${propertyName}`;\n};\n\n// Peel TS-only wrapping nodes so a shape check sees the underlying\n// expression. Returns the original node when no wrapping is present.\nexport const unwrapExpression = (node: unknown): AstNode | null => {\n  if (!isAstNode(node)) {\n    return null;\n  }\n  if (\n    node.type === \"TSAsExpression\" ||\n    node.type === \"TSSatisfiesExpression\" ||\n    node.type === \"ChainExpression\"\n  ) {\n    return unwrapExpression(node.expression);\n  }\n  return node;\n};\n\n// Resolve an ImportSpecifier's imported binding name (Identifier.name or\n// string-Literal.value). Returns null when the specifier shape is unexpected.\nexport const getImportedName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  const imported = specifier.imported;\n  if (isIdentifier(imported)) {\n    return imported.name;\n  }\n  if (isStringLiteral(imported)) {\n    return imported.value;\n  }\n  return null;\n};\n\n// Resolve an ImportSpecifier's local binding name. This differs from\n// getImportedName for aliased imports such as `import { source as local }`.\nexport const getImportLocalName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  return isIdentifier(specifier.local) ? specifier.local.name : null;\n};\n"],"mappings":";AAkBA,MAAa,aAAa,SACxB,OAAO,SAAS,YAChB,SAAS,QACT,UAAU,QACV,OAAQ,KAA2B,SAAS,YAC5C,WAAW;AAEb,MAAa,gBACX,MACA,SAC2D;CAC3D,IAAI,CAAC,UAAU,IAAI,KAAK,KAAK,SAAS,cACpC,OAAO;CAET,IAAI,OAAO,KAAK,SAAS,UACvB,OAAO;CAET,OAAO,SAAS,KAAA,KAAa,KAAK,SAAS;AAC7C;AAEA,MAAa,mBACX,SAEA,UAAU,IAAI,KAAK,KAAK,SAAS,aAAa,OAAO,KAAK,UAAU;AAKtE,MAAa,mBAAmB,SAAiC;CAC/D,IAAI,aAAa,IAAI,GACnB,OAAO,KAAK;CAEd,IAAI,gBAAgB,IAAI,GACtB,OAAO,KAAK;CAEd,OAAO;AACT;AA8BA,MAAa,iBAAiB,WAAmC;CAC/D,IAAI,aAAa,MAAM,GACrB,OAAO,OAAO;CAEhB,IAAI,CAAC,UAAU,MAAM,KAAK,OAAO,SAAS,oBACxC,OAAO;CAET,IAAI,OAAO,aAAa,OACtB,OAAO;CAET,MAAM,aAAa,cAAc,OAAO,MAAM;CAC9C,MAAM,eAAe,gBAAgB,OAAO,QAAQ;CACpD,IAAI,iBAAiB,MACnB,OAAO;CAET,OAAO,eAAe,OAAO,eAAe,GAAG,WAAW,GAAG;AAC/D;AAIA,MAAa,oBAAoB,SAAkC;CACjE,IAAI,CAAC,UAAU,IAAI,GACjB,OAAO;CAET,IACE,KAAK,SAAS,oBACd,KAAK,SAAS,2BACd,KAAK,SAAS,mBAEd,OAAO,iBAAiB,KAAK,UAAU;CAEzC,OAAO;AACT"}
+{"version":3,"file":"utils.cjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["// Shared AST helpers for the rules in this folder.\n//\n// Oxlint plugin AST nodes are passed in untyped. Each helper narrows from\n// `unknown` so rule files can call them without per-call type ceremony or\n// shared type-import boilerplate.\n\nimport type { Ranged } from \"@oxlint/plugins\";\n\nexport type AstNode = Ranged & { type: string } & Record<string, unknown>;\n\ntype FilenameContext = {\n  filename?: string;\n  getFilename?: () => string;\n};\n\nexport const filenameForContext = (context: FilenameContext): string =>\n  (context.filename ?? context.getFilename?.() ?? \"\").replaceAll(\"\\\\\", \"/\");\n\nexport const isAstNode = (node: unknown): node is AstNode =>\n  typeof node === \"object\" &&\n  node !== null &&\n  \"type\" in node &&\n  typeof (node as { type: unknown }).type === \"string\" &&\n  \"range\" in node;\n\nexport const isIdentifier = (\n  node: unknown,\n  name?: string,\n): node is AstNode & { type: \"Identifier\"; name: string } => {\n  if (!isAstNode(node) || node.type !== \"Identifier\") {\n    return false;\n  }\n  if (typeof node.name !== \"string\") {\n    return false;\n  }\n  return name === undefined || node.name === name;\n};\n\nexport const isStringLiteral = (\n  node: unknown,\n): node is AstNode & { type: \"Literal\"; value: string } =>\n  isAstNode(node) && node.type === \"Literal\" && typeof node.value === \"string\";\n\n// Resolve the static name of a Property or MemberExpression key:\n// Identifier.name or string-Literal.value. Returns null for computed keys\n// driven by a non-literal expression.\nexport const getPropertyName = (node: unknown): string | null => {\n  if (isIdentifier(node)) {\n    return node.name;\n  }\n  if (isStringLiteral(node)) {\n    return node.value;\n  }\n  return null;\n};\n\n// Match `<object>.<property>` member access where both halves are\n// Identifiers and the access is not computed.\nexport const isMemberAccess = (\n  node: unknown,\n  object: string,\n  property: string,\n): boolean =>\n  isAstNode(node) &&\n  node.type === \"MemberExpression\" &&\n  node.computed === false &&\n  isIdentifier(node.object, object) &&\n  isIdentifier(node.property, property);\n\n// Match `CallExpression` whose callee is an Identifier with the given name.\nexport const isCallTo = (node: unknown, name: string): boolean =>\n  isAstNode(node) &&\n  node.type === \"CallExpression\" &&\n  isIdentifier(node.callee, name);\n\n// Resolve the dot-notation name of a callee: an Identifier, or a\n// non-computed MemberExpression chain (e.g. `t.String`, `Schema.is`,\n// `process.stderr.write`). Returns null when the chain is computed\n// or the property name itself can't be resolved.\n//\n// If the chain is rooted at a non-Identifier expression (e.g. `foo().bar`),\n// returns the bare property name (\"bar\") rather than null. Callers that\n// match the result against a fixed allowlist must consider whether they\n// need to distinguish `foo().createSafeHandler` from `createSafeHandler`.\nexport const getCalleeName = (callee: unknown): string | null => {\n  if (isIdentifier(callee)) {\n    return callee.name;\n  }\n  if (!isAstNode(callee) || callee.type !== \"MemberExpression\") {\n    return null;\n  }\n  if (callee.computed !== false) {\n    return null;\n  }\n  const objectName = getCalleeName(callee.object);\n  const propertyName = getPropertyName(callee.property);\n  if (propertyName === null) {\n    return null;\n  }\n  return objectName === null ? propertyName : `${objectName}.${propertyName}`;\n};\n\n// Peel TS-only wrapping nodes so a shape check sees the underlying\n// expression. Returns the original node when no wrapping is present.\nexport const unwrapExpression = (node: unknown): AstNode | null => {\n  if (!isAstNode(node)) {\n    return null;\n  }\n  if (\n    node.type === \"TSAsExpression\" ||\n    node.type === \"TSSatisfiesExpression\" ||\n    node.type === \"ChainExpression\"\n  ) {\n    return unwrapExpression(node.expression);\n  }\n  return node;\n};\n\n// Resolve an ImportSpecifier's imported binding name (Identifier.name or\n// string-Literal.value). Returns null when the specifier shape is unexpected.\nexport const getImportedName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  const imported = specifier.imported;\n  if (isIdentifier(imported)) {\n    return imported.name;\n  }\n  if (isStringLiteral(imported)) {\n    return imported.value;\n  }\n  return null;\n};\n\n// Resolve an ImportSpecifier's local binding name. This differs from\n// getImportedName for aliased imports such as `import { source as local }`.\nexport const getImportLocalName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  return isIdentifier(specifier.local) ? specifier.local.name : null;\n};\n"],"mappings":";AAkBA,MAAa,aAAa,SACxB,OAAO,SAAS,YAChB,SAAS,QACT,UAAU,QACV,OAAQ,KAA2B,SAAS,YAC5C,WAAW;AAEb,MAAa,gBACX,MACA,SAC2D;CAC3D,IAAI,CAAC,UAAU,IAAI,KAAK,KAAK,SAAS,cACpC,OAAO;CAET,IAAI,OAAO,KAAK,SAAS,UACvB,OAAO;CAET,OAAO,SAAS,KAAA,KAAa,KAAK,SAAS;AAC7C;AAEA,MAAa,mBACX,SAEA,UAAU,IAAI,KAAK,KAAK,SAAS,aAAa,OAAO,KAAK,UAAU;AAKtE,MAAa,mBAAmB,SAAiC;CAC/D,IAAI,aAAa,IAAI,GACnB,OAAO,KAAK;CAEd,IAAI,gBAAgB,IAAI,GACtB,OAAO,KAAK;CAEd,OAAO;AACT;AA8BA,MAAa,iBAAiB,WAAmC;CAC/D,IAAI,aAAa,MAAM,GACrB,OAAO,OAAO;CAEhB,IAAI,CAAC,UAAU,MAAM,KAAK,OAAO,SAAS,oBACxC,OAAO;CAET,IAAI,OAAO,aAAa,OACtB,OAAO;CAET,MAAM,aAAa,cAAc,OAAO,MAAM;CAC9C,MAAM,eAAe,gBAAgB,OAAO,QAAQ;CACpD,IAAI,iBAAiB,MACnB,OAAO;CAET,OAAO,eAAe,OAAO,eAAe,GAAG,WAAW,GAAG;AAC/D;AAIA,MAAa,oBAAoB,SAAkC;CACjE,IAAI,CAAC,UAAU,IAAI,GACjB,OAAO;CAET,IACE,KAAK,SAAS,oBACd,KAAK,SAAS,2BACd,KAAK,SAAS,mBAEd,OAAO,iBAAiB,KAAK,UAAU;CAEzC,OAAO;AACT;AAIA,MAAa,mBAAmB,cAAsC;CACpE,IAAI,CAAC,UAAU,SAAS,KAAK,UAAU,SAAS,mBAC9C,OAAO;CAET,MAAM,WAAW,UAAU;CAC3B,IAAI,aAAa,QAAQ,GACvB,OAAO,SAAS;CAElB,IAAI,gBAAgB,QAAQ,GAC1B,OAAO,SAAS;CAElB,OAAO;AACT"}

package/dist/utils.mjs

@@ -25,7 +25,14 @@ const unwrapExpression = (node) => {
 	if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ChainExpression") return unwrapExpression(node.expression);
 	return node;
 };
+const getImportedName = (specifier) => {
+	if (!isAstNode(specifier) || specifier.type !== "ImportSpecifier") return null;
+	const imported = specifier.imported;
+	if (isIdentifier(imported)) return imported.name;
+	if (isStringLiteral(imported)) return imported.value;
+	return null;
+};
 //#endregion
-export { unwrapExpression as i, getPropertyName as n, isIdentifier as r, getCalleeName as t };
+export { isStringLiteral as a, isIdentifier as i, getImportedName as n, unwrapExpression as o, getPropertyName as r, getCalleeName as t };
 
 //# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["// Shared AST helpers for the rules in this folder.\n//\n// Oxlint plugin AST nodes are passed in untyped. Each helper narrows from\n// `unknown` so rule files can call them without per-call type ceremony or\n// shared type-import boilerplate.\n\nimport type { Ranged } from \"@oxlint/plugins\";\n\nexport type AstNode = Ranged & { type: string } & Record<string, unknown>;\n\ntype FilenameContext = {\n  filename?: string;\n  getFilename?: () => string;\n};\n\nexport const filenameForContext = (context: FilenameContext): string =>\n  (context.filename ?? context.getFilename?.() ?? \"\").replaceAll(\"\\\\\", \"/\");\n\nexport const isAstNode = (node: unknown): node is AstNode =>\n  typeof node === \"object\" &&\n  node !== null &&\n  \"type\" in node &&\n  typeof (node as { type: unknown }).type === \"string\" &&\n  \"range\" in node;\n\nexport const isIdentifier = (\n  node: unknown,\n  name?: string,\n): node is AstNode & { type: \"Identifier\"; name: string } => {\n  if (!isAstNode(node) || node.type !== \"Identifier\") {\n    return false;\n  }\n  if (typeof node.name !== \"string\") {\n    return false;\n  }\n  return name === undefined || node.name === name;\n};\n\nexport const isStringLiteral = (\n  node: unknown,\n): node is AstNode & { type: \"Literal\"; value: string } =>\n  isAstNode(node) && node.type === \"Literal\" && typeof node.value === \"string\";\n\n// Resolve the static name of a Property or MemberExpression key:\n// Identifier.name or string-Literal.value. Returns null for computed keys\n// driven by a non-literal expression.\nexport const getPropertyName = (node: unknown): string | null => {\n  if (isIdentifier(node)) {\n    return node.name;\n  }\n  if (isStringLiteral(node)) {\n    return node.value;\n  }\n  return null;\n};\n\n// Match `<object>.<property>` member access where both halves are\n// Identifiers and the access is not computed.\nexport const isMemberAccess = (\n  node: unknown,\n  object: string,\n  property: string,\n): boolean =>\n  isAstNode(node) &&\n  node.type === \"MemberExpression\" &&\n  node.computed === false &&\n  isIdentifier(node.object, object) &&\n  isIdentifier(node.property, property);\n\n// Match `CallExpression` whose callee is an Identifier with the given name.\nexport const isCallTo = (node: unknown, name: string): boolean =>\n  isAstNode(node) &&\n  node.type === \"CallExpression\" &&\n  isIdentifier(node.callee, name);\n\n// Resolve the dot-notation name of a callee: an Identifier, or a\n// non-computed MemberExpression chain (e.g. `t.String`, `Schema.is`,\n// `process.stderr.write`). Returns null when the chain is computed\n// or the property name itself can't be resolved.\n//\n// If the chain is rooted at a non-Identifier expression (e.g. `foo().bar`),\n// returns the bare property name (\"bar\") rather than null. Callers that\n// match the result against a fixed allowlist must consider whether they\n// need to distinguish `foo().createSafeHandler` from `createSafeHandler`.\nexport const getCalleeName = (callee: unknown): string | null => {\n  if (isIdentifier(callee)) {\n    return callee.name;\n  }\n  if (!isAstNode(callee) || callee.type !== \"MemberExpression\") {\n    return null;\n  }\n  if (callee.computed !== false) {\n    return null;\n  }\n  const objectName = getCalleeName(callee.object);\n  const propertyName = getPropertyName(callee.property);\n  if (propertyName === null) {\n    return null;\n  }\n  return objectName === null ? propertyName : `${objectName}.${propertyName}`;\n};\n\n// Peel TS-only wrapping nodes so a shape check sees the underlying\n// expression. Returns the original node when no wrapping is present.\nexport const unwrapExpression = (node: unknown): AstNode | null => {\n  if (!isAstNode(node)) {\n    return null;\n  }\n  if (\n    node.type === \"TSAsExpression\" ||\n    node.type === \"TSSatisfiesExpression\" ||\n    node.type === \"ChainExpression\"\n  ) {\n    return unwrapExpression(node.expression);\n  }\n  return node;\n};\n\n// Resolve an ImportSpecifier's imported binding name (Identifier.name or\n// string-Literal.value). Returns null when the specifier shape is unexpected.\nexport const getImportedName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  const imported = specifier.imported;\n  if (isIdentifier(imported)) {\n    return imported.name;\n  }\n  if (isStringLiteral(imported)) {\n    return imported.value;\n  }\n  return null;\n};\n\n// Resolve an ImportSpecifier's local binding name. This differs from\n// getImportedName for aliased imports such as `import { source as local }`.\nexport const getImportLocalName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  return isIdentifier(specifier.local) ? specifier.local.name : null;\n};\n"],"mappings":";AAkBA,MAAa,aAAa,SACxB,OAAO,SAAS,YAChB,SAAS,QACT,UAAU,QACV,OAAQ,KAA2B,SAAS,YAC5C,WAAW;AAEb,MAAa,gBACX,MACA,SAC2D;CAC3D,IAAI,CAAC,UAAU,IAAI,KAAK,KAAK,SAAS,cACpC,OAAO;CAET,IAAI,OAAO,KAAK,SAAS,UACvB,OAAO;CAET,OAAO,SAAS,KAAA,KAAa,KAAK,SAAS;AAC7C;AAEA,MAAa,mBACX,SAEA,UAAU,IAAI,KAAK,KAAK,SAAS,aAAa,OAAO,KAAK,UAAU;AAKtE,MAAa,mBAAmB,SAAiC;CAC/D,IAAI,aAAa,IAAI,GACnB,OAAO,KAAK;CAEd,IAAI,gBAAgB,IAAI,GACtB,OAAO,KAAK;CAEd,OAAO;AACT;AA8BA,MAAa,iBAAiB,WAAmC;CAC/D,IAAI,aAAa,MAAM,GACrB,OAAO,OAAO;CAEhB,IAAI,CAAC,UAAU,MAAM,KAAK,OAAO,SAAS,oBACxC,OAAO;CAET,IAAI,OAAO,aAAa,OACtB,OAAO;CAET,MAAM,aAAa,cAAc,OAAO,MAAM;CAC9C,MAAM,eAAe,gBAAgB,OAAO,QAAQ;CACpD,IAAI,iBAAiB,MACnB,OAAO;CAET,OAAO,eAAe,OAAO,eAAe,GAAG,WAAW,GAAG;AAC/D;AAIA,MAAa,oBAAoB,SAAkC;CACjE,IAAI,CAAC,UAAU,IAAI,GACjB,OAAO;CAET,IACE,KAAK,SAAS,oBACd,KAAK,SAAS,2BACd,KAAK,SAAS,mBAEd,OAAO,iBAAiB,KAAK,UAAU;CAEzC,OAAO;AACT"}
+{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["// Shared AST helpers for the rules in this folder.\n//\n// Oxlint plugin AST nodes are passed in untyped. Each helper narrows from\n// `unknown` so rule files can call them without per-call type ceremony or\n// shared type-import boilerplate.\n\nimport type { Ranged } from \"@oxlint/plugins\";\n\nexport type AstNode = Ranged & { type: string } & Record<string, unknown>;\n\ntype FilenameContext = {\n  filename?: string;\n  getFilename?: () => string;\n};\n\nexport const filenameForContext = (context: FilenameContext): string =>\n  (context.filename ?? context.getFilename?.() ?? \"\").replaceAll(\"\\\\\", \"/\");\n\nexport const isAstNode = (node: unknown): node is AstNode =>\n  typeof node === \"object\" &&\n  node !== null &&\n  \"type\" in node &&\n  typeof (node as { type: unknown }).type === \"string\" &&\n  \"range\" in node;\n\nexport const isIdentifier = (\n  node: unknown,\n  name?: string,\n): node is AstNode & { type: \"Identifier\"; name: string } => {\n  if (!isAstNode(node) || node.type !== \"Identifier\") {\n    return false;\n  }\n  if (typeof node.name !== \"string\") {\n    return false;\n  }\n  return name === undefined || node.name === name;\n};\n\nexport const isStringLiteral = (\n  node: unknown,\n): node is AstNode & { type: \"Literal\"; value: string } =>\n  isAstNode(node) && node.type === \"Literal\" && typeof node.value === \"string\";\n\n// Resolve the static name of a Property or MemberExpression key:\n// Identifier.name or string-Literal.value. Returns null for computed keys\n// driven by a non-literal expression.\nexport const getPropertyName = (node: unknown): string | null => {\n  if (isIdentifier(node)) {\n    return node.name;\n  }\n  if (isStringLiteral(node)) {\n    return node.value;\n  }\n  return null;\n};\n\n// Match `<object>.<property>` member access where both halves are\n// Identifiers and the access is not computed.\nexport const isMemberAccess = (\n  node: unknown,\n  object: string,\n  property: string,\n): boolean =>\n  isAstNode(node) &&\n  node.type === \"MemberExpression\" &&\n  node.computed === false &&\n  isIdentifier(node.object, object) &&\n  isIdentifier(node.property, property);\n\n// Match `CallExpression` whose callee is an Identifier with the given name.\nexport const isCallTo = (node: unknown, name: string): boolean =>\n  isAstNode(node) &&\n  node.type === \"CallExpression\" &&\n  isIdentifier(node.callee, name);\n\n// Resolve the dot-notation name of a callee: an Identifier, or a\n// non-computed MemberExpression chain (e.g. `t.String`, `Schema.is`,\n// `process.stderr.write`). Returns null when the chain is computed\n// or the property name itself can't be resolved.\n//\n// If the chain is rooted at a non-Identifier expression (e.g. `foo().bar`),\n// returns the bare property name (\"bar\") rather than null. Callers that\n// match the result against a fixed allowlist must consider whether they\n// need to distinguish `foo().createSafeHandler` from `createSafeHandler`.\nexport const getCalleeName = (callee: unknown): string | null => {\n  if (isIdentifier(callee)) {\n    return callee.name;\n  }\n  if (!isAstNode(callee) || callee.type !== \"MemberExpression\") {\n    return null;\n  }\n  if (callee.computed !== false) {\n    return null;\n  }\n  const objectName = getCalleeName(callee.object);\n  const propertyName = getPropertyName(callee.property);\n  if (propertyName === null) {\n    return null;\n  }\n  return objectName === null ? propertyName : `${objectName}.${propertyName}`;\n};\n\n// Peel TS-only wrapping nodes so a shape check sees the underlying\n// expression. Returns the original node when no wrapping is present.\nexport const unwrapExpression = (node: unknown): AstNode | null => {\n  if (!isAstNode(node)) {\n    return null;\n  }\n  if (\n    node.type === \"TSAsExpression\" ||\n    node.type === \"TSSatisfiesExpression\" ||\n    node.type === \"ChainExpression\"\n  ) {\n    return unwrapExpression(node.expression);\n  }\n  return node;\n};\n\n// Resolve an ImportSpecifier's imported binding name (Identifier.name or\n// string-Literal.value). Returns null when the specifier shape is unexpected.\nexport const getImportedName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  const imported = specifier.imported;\n  if (isIdentifier(imported)) {\n    return imported.name;\n  }\n  if (isStringLiteral(imported)) {\n    return imported.value;\n  }\n  return null;\n};\n\n// Resolve an ImportSpecifier's local binding name. This differs from\n// getImportedName for aliased imports such as `import { source as local }`.\nexport const getImportLocalName = (specifier: unknown): string | null => {\n  if (!isAstNode(specifier) || specifier.type !== \"ImportSpecifier\") {\n    return null;\n  }\n  return isIdentifier(specifier.local) ? specifier.local.name : null;\n};\n"],"mappings":";AAkBA,MAAa,aAAa,SACxB,OAAO,SAAS,YAChB,SAAS,QACT,UAAU,QACV,OAAQ,KAA2B,SAAS,YAC5C,WAAW;AAEb,MAAa,gBACX,MACA,SAC2D;CAC3D,IAAI,CAAC,UAAU,IAAI,KAAK,KAAK,SAAS,cACpC,OAAO;CAET,IAAI,OAAO,KAAK,SAAS,UACvB,OAAO;CAET,OAAO,SAAS,KAAA,KAAa,KAAK,SAAS;AAC7C;AAEA,MAAa,mBACX,SAEA,UAAU,IAAI,KAAK,KAAK,SAAS,aAAa,OAAO,KAAK,UAAU;AAKtE,MAAa,mBAAmB,SAAiC;CAC/D,IAAI,aAAa,IAAI,GACnB,OAAO,KAAK;CAEd,IAAI,gBAAgB,IAAI,GACtB,OAAO,KAAK;CAEd,OAAO;AACT;AA8BA,MAAa,iBAAiB,WAAmC;CAC/D,IAAI,aAAa,MAAM,GACrB,OAAO,OAAO;CAEhB,IAAI,CAAC,UAAU,MAAM,KAAK,OAAO,SAAS,oBACxC,OAAO;CAET,IAAI,OAAO,aAAa,OACtB,OAAO;CAET,MAAM,aAAa,cAAc,OAAO,MAAM;CAC9C,MAAM,eAAe,gBAAgB,OAAO,QAAQ;CACpD,IAAI,iBAAiB,MACnB,OAAO;CAET,OAAO,eAAe,OAAO,eAAe,GAAG,WAAW,GAAG;AAC/D;AAIA,MAAa,oBAAoB,SAAkC;CACjE,IAAI,CAAC,UAAU,IAAI,GACjB,OAAO;CAET,IACE,KAAK,SAAS,oBACd,KAAK,SAAS,2BACd,KAAK,SAAS,mBAEd,OAAO,iBAAiB,KAAK,UAAU;CAEzC,OAAO;AACT;AAIA,MAAa,mBAAmB,cAAsC;CACpE,IAAI,CAAC,UAAU,SAAS,KAAK,UAAU,SAAS,mBAC9C,OAAO;CAET,MAAM,WAAW,UAAU;CAC3B,IAAI,aAAa,QAAQ,GACvB,OAAO,SAAS;CAElB,IAAI,gBAAgB,QAAQ,GAC1B,OAAO,SAAS;CAElB,OAAO;AACT"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stll/oxlint-plugin",
-  "version": "0.1.0",
-  "description": "Portable static-safety rules for Oxlint consumers.",
+  "version": "0.2.0",
+  "description": "Portable static-safety and route-query rules for Oxlint consumers.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -69,6 +69,28 @@
         "default": "./dist/no-unsafe-inner-html.cjs"
       },
       "default": "./dist/no-unsafe-inner-html.mjs"
+    },
+    "./no-raw-route-query-client": {
+      "import": {
+        "types": "./dist/no-raw-route-query-client.d.mts",
+        "default": "./dist/no-raw-route-query-client.mjs"
+      },
+      "require": {
+        "types": "./dist/no-raw-route-query-client.d.cts",
+        "default": "./dist/no-raw-route-query-client.cjs"
+      },
+      "default": "./dist/no-raw-route-query-client.mjs"
+    },
+    "./require-loader-prefetch": {
+      "import": {
+        "types": "./dist/require-loader-prefetch.d.mts",
+        "default": "./dist/require-loader-prefetch.mjs"
+      },
+      "require": {
+        "types": "./dist/require-loader-prefetch.d.cts",
+        "default": "./dist/require-loader-prefetch.cjs"
+      },
+      "default": "./dist/require-loader-prefetch.mjs"
     }
   },
   "publishConfig": {
@@ -82,6 +104,7 @@
   "devDependencies": {
     "@oxlint/plugins": "1.75.0",
     "@stll/typescript-config": "workspace:*",
+    "@types/node": "25.9.1",
     "oxfmt": "0.48.0",
     "typescript": "7.0.2"
   },