@spa-kit/eslint-plugin 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,94 @@
-# Temporary Holding Version
+# @spa-kit/eslint-plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Opt-in ESLint rules for spa-kit applications. This package is development tooling;
+it does not add lint dependencies to `@spa-kit/react-router`.
+
+## Setup
+
+Install ESLint, a TypeScript parser, and the plugin as development dependencies:
+
+```sh
+npm install --save-dev eslint @typescript-eslint/parser @spa-kit/eslint-plugin
+```
+
+ESLint 9 and 10 are supported. Use a Node.js version supported by your ESLint release.
+
+Add the rule to your flat configuration (`eslint.config.mjs`):
+
+```js
+import tsParser from "@typescript-eslint/parser";
+import spaKit from "@spa-kit/eslint-plugin";
+
+export default [
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: { ecmaFeatures: { jsx: true } },
+    },
+    plugins: { "@spa-kit": spaKit },
+    rules: {
+      "@spa-kit/require-preload-context": "error",
+    },
+  },
+];
+```
+
+If your configuration already selects a TypeScript parser, add only the plugin
+and rule entries. Installing or registering the plugin does not enable the rule.
+No TypeScript project or parser services are required.
+
+## `require-preload-context`
+
+Require a parameter type annotation on `preload` callbacks in route configurations
+passed to `createSpaRouter` from `@spa-kit/react-router`. This preserves inference
+of the preload return type in the sibling `render` callback.
+
+```tsx
+import { createSpaRouter } from "@spa-kit/react-router";
+import { WikiRoutes } from "./generated/WikiRoutes";
+import type { ViewContext } from "./generated/WikiRoutes";
+
+createSpaRouter(WikiRoutes, {
+  View: {
+    preload: ({ params }: ViewContext) => loadQuery(environment, Query, {
+      wikiId: params.wikiId,
+    }),
+    render: ({ preload }) => <ViewWikiPage queryRef={preload} />,
+  },
+  // Other generated routes omitted here.
+});
+```
+
+These callbacks are reported:
+
+```ts
+preload: ({ params }) => loadQuery(/* ... */)
+preload: context => prepare(context)
+preload({ params }) { return prepare(params); }
+```
+
+These are accepted:
+
+```ts
+preload: ({ params }: ViewContext) => prepare(params)
+preload(context: ViewContext) { return prepare(context.params); }
+preload: () => prepareWithoutInputs()
+```
+
+The rule recognizes renamed imports and namespace imports, and follows local
+`const` bindings for router aliases, configurations, route entries, and preload
+functions. It also checks local function declarations and statically known object
+spreads. Shadowed imports and unrelated functions named `createSpaRouter` are
+ignored. Shared callbacks are reported only once per file.
+
+The rule checks annotation presence, not the annotation's meaning. TypeScript
+checks compatibility with the generated route context and resource types. A type
+assertion on the function or a variable type does not replace the required
+annotation on its parameter.
+
+Imported callbacks/configurations, mutable bindings, dynamic property keys,
+factory calls, and cross-file re-exports are not resolved. Keep the configuration
+and annotated preload callback in the same file for enforcement. There are no
+options and no autofix: selecting and importing the generated context type is an
+application decision.

package/dist/index.cjs

@@ -0,0 +1,161 @@
+'use strict';
+
+// package.json
+var name = "@spa-kit/eslint-plugin";
+var version = "0.1.0";
+
+// src/rules/requirePreloadContext.ts
+var wrappers = /* @__PURE__ */ new Set(["TSAsExpression", "TSSatisfiesExpression", "TSTypeAssertion", "TSNonNullExpression"]);
+function unwrap(node) {
+  let current = node;
+  while (wrappers.has(current.type) && current.expression) {
+    current = current.expression;
+  }
+  return current;
+}
+function propertyName(node, computed) {
+  if (!computed && node.type === "Identifier") {
+    return node.name;
+  }
+  if (node.type === "Literal" && typeof node.value === "string") {
+    return node.value;
+  }
+  return void 0;
+}
+var requirePreloadContext = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require an explicit parameter type on route preloads to preserve render inference"
+    },
+    schema: [],
+    messages: {
+      missingContext: "Annotate the preload parameter with its generated route context type to preserve render inference."
+    }
+  },
+  create(context) {
+    const source = context.sourceCode;
+    const reported = /* @__PURE__ */ new Set();
+    function variableFor(node) {
+      if (node.type !== "Identifier") {
+        return void 0;
+      }
+      let scope = source.getScope(node);
+      while (scope) {
+        const variable = scope.set.get(node.name);
+        if (variable) {
+          return variable;
+        }
+        scope = scope.upper;
+      }
+      return void 0;
+    }
+    function resolve(node, seen = /* @__PURE__ */ new Set()) {
+      const value = unwrap(node);
+      if (seen.has(value) || value.type !== "Identifier") {
+        return value;
+      }
+      seen.add(value);
+      const variable = variableFor(value);
+      const definition = variable?.defs[0];
+      if (definition?.type === "FunctionName" && definition.node.type === "FunctionDeclaration") {
+        return definition.node;
+      }
+      if (definition?.type === "Variable" && definition.parent?.kind === "const" && definition.node.init) {
+        return resolve(definition.node.init, seen);
+      }
+      return value;
+    }
+    function isRouterImport(node, namespace) {
+      const definition = variableFor(node)?.defs[0];
+      if (definition?.type !== "ImportBinding" || definition.parent.source.value !== "@spa-kit/react-router") {
+        return false;
+      }
+      const specifier = definition.node;
+      if (namespace) {
+        return specifier.type === "ImportNamespaceSpecifier";
+      }
+      return specifier.type === "ImportSpecifier" && propertyName(specifier.imported, false) === "createSpaRouter";
+    }
+    function isRouterCall(callee) {
+      const value = resolve(callee);
+      if (value.type === "Identifier") {
+        return isRouterImport(value, false);
+      }
+      return value.type === "MemberExpression" && propertyName(value.property, value.computed) === "createSpaRouter" && isRouterImport(resolve(value.object), true);
+    }
+    function checkPreload(node) {
+      const callback = resolve(node);
+      if (callback.type !== "ArrowFunctionExpression" && callback.type !== "FunctionExpression" && callback.type !== "FunctionDeclaration") {
+        return;
+      }
+      const parameter = callback.params.find((param) => param.type !== "Identifier" || param.name !== "this");
+      if (!parameter) {
+        return;
+      }
+      const input = parameter.type === "AssignmentPattern" ? parameter.left : parameter;
+      if (!input.typeAnnotation && !reported.has(input)) {
+        reported.add(input);
+        context.report({ node: input, messageId: "missingContext" });
+      }
+    }
+    function properties(node, seen = /* @__PURE__ */ new Set()) {
+      const object = resolve(node);
+      if (object.type !== "ObjectExpression" || seen.has(object)) {
+        return void 0;
+      }
+      const path = new Set(seen).add(object);
+      const result = /* @__PURE__ */ new Map();
+      for (const property of object.properties) {
+        if (property.type === "SpreadElement") {
+          const spread = properties(property.argument, path);
+          if (spread) {
+            for (const [name2, value] of spread) result.set(name2, value);
+          } else {
+            result.clear();
+          }
+          continue;
+        }
+        if (property.type === "Property") {
+          const name2 = propertyName(property.key, property.computed);
+          if (name2 === void 0) {
+            result.clear();
+          } else if (property.kind === "init") {
+            result.set(name2, property.value);
+          } else {
+            result.delete(name2);
+          }
+        }
+      }
+      return result;
+    }
+    return {
+      CallExpression(node) {
+        if (!isRouterCall(node.callee)) {
+          return;
+        }
+        const config = node.arguments[1];
+        if (!config || config.type === "SpreadElement") {
+          return;
+        }
+        for (const routeConfig of properties(config)?.values() ?? []) {
+          const callback = properties(routeConfig)?.get("preload");
+          if (callback) checkPreload(callback);
+        }
+      }
+    };
+  }
+};
+
+// src/index.ts
+var plugin = {
+  meta: { name, version },
+  rules: {
+    "require-preload-context": requirePreloadContext
+  }
+};
+var index_default = plugin;
+
+module.exports = index_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../package.json","../src/rules/requirePreloadContext.ts","../src/index.ts"],"names":["name"],"mappings":"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","file":"index.cjs","sourcesContent":["{\n  \"name\": \"@spa-kit/eslint-plugin\",\n  \"version\": \"0.1.0\",\n  \"description\": \"Opt-in ESLint rules for spa-kit applications\",\n  \"author\": \"Casey McGuire\",\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    }\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"typecheck:test\": \"tsc --project tsconfig.test.json\"\n  },\n  \"peerDependencies\": {\n    \"eslint\": \"^9.0.0 || ^10.0.0\"\n  },\n  \"devDependencies\": {\n    \"eslint\": \"^10.12.0\",\n    \"@typescript-eslint/parser\": \"^8.71.1\"\n  },\n  \"engines\": {\n    \"node\": \">=18.18.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  }\n}\n","import type { Rule } from \"eslint\";\n\n// ESLint's core node types describe JavaScript. These are the additional fields\n// used from the TypeScript ESTree parser; no type-checker services are needed.\ntype TypeScriptNode = Rule.Node & {\n  expression?: Rule.Node;\n  typeAnnotation?: unknown;\n};\n\nconst wrappers = new Set([\"TSAsExpression\", \"TSSatisfiesExpression\", \"TSTypeAssertion\", \"TSNonNullExpression\"]);\n\nfunction unwrap(node: Rule.Node): Rule.Node {\n  let current = node as TypeScriptNode;\n  while (wrappers.has(current.type) && current.expression) {\n    current = current.expression as TypeScriptNode;\n  }\n  return current;\n}\n\nfunction propertyName(node: Rule.Node, computed: boolean): string | undefined {\n  if (!computed && node.type === \"Identifier\") {\n    return node.name;\n  }\n  if (node.type === \"Literal\" && typeof node.value === \"string\") {\n    return node.value;\n  }\n  return undefined;\n}\n\n/** Require explicit generated context annotations on route preload inputs. */\nexport const requirePreloadContext: Rule.RuleModule = {\n  meta: {\n    type: \"problem\",\n    docs: {\n      description: \"Require an explicit parameter type on route preloads to preserve render inference\",\n    },\n    schema: [],\n    messages: {\n      missingContext: \"Annotate the preload parameter with its generated route context type to preserve render inference.\",\n    },\n  },\n  create(context) {\n    const source = context.sourceCode;\n    const reported = new Set<Rule.Node>();\n\n    function variableFor(node: Rule.Node) {\n      if (node.type !== \"Identifier\") {\n        return undefined;\n      }\n      let scope: ReturnType<typeof source.getScope> | null = source.getScope(node);\n      while (scope) {\n        const variable = scope.set.get(node.name);\n        if (variable) {\n          return variable;\n        }\n        scope = scope.upper;\n      }\n      return undefined;\n    }\n\n    // Follow immutable bindings in this file only. Imported values, mutable\n    // bindings, and dynamically constructed configurations are intentionally opaque.\n    function resolve(node: Rule.Node, seen = new Set<Rule.Node>()): Rule.Node {\n      const value = unwrap(node);\n      if (seen.has(value) || value.type !== \"Identifier\") {\n        return value;\n      }\n      seen.add(value);\n      const variable = variableFor(value);\n      const definition = variable?.defs[0];\n      if (definition?.type === \"FunctionName\" && definition.node.type === \"FunctionDeclaration\") {\n        return definition.node as Rule.Node;\n      }\n      if (definition?.type === \"Variable\" && definition.parent?.kind === \"const\" && definition.node.init) {\n        return resolve(definition.node.init as Rule.Node, seen);\n      }\n      return value;\n    }\n\n    function isRouterImport(node: Rule.Node, namespace: boolean): boolean {\n      const definition = variableFor(node)?.defs[0];\n      if (definition?.type !== \"ImportBinding\" || definition.parent.source.value !== \"@spa-kit/react-router\") {\n        return false;\n      }\n      const specifier = definition.node;\n      if (namespace) {\n        return specifier.type === \"ImportNamespaceSpecifier\";\n      }\n      return specifier.type === \"ImportSpecifier\" &&\n        propertyName(specifier.imported as Rule.Node, false) === \"createSpaRouter\";\n    }\n\n    function isRouterCall(callee: Rule.Node): boolean {\n      const value = resolve(callee);\n      if (value.type === \"Identifier\") {\n        return isRouterImport(value, false);\n      }\n      return value.type === \"MemberExpression\" &&\n        propertyName(value.property as Rule.Node, value.computed) === \"createSpaRouter\" &&\n        isRouterImport(resolve(value.object as Rule.Node), true);\n    }\n\n    function checkPreload(node: Rule.Node) {\n      const callback = resolve(node);\n      if (callback.type !== \"ArrowFunctionExpression\" && callback.type !== \"FunctionExpression\" &&\n          callback.type !== \"FunctionDeclaration\") {\n        return;\n      }\n      // A TypeScript `this` parameter is erased and is not the route context.\n      const parameter = callback.params.find((param) => param.type !== \"Identifier\" || param.name !== \"this\");\n      if (!parameter) {\n        return;\n      }\n      const input = (parameter.type === \"AssignmentPattern\" ? parameter.left : parameter) as TypeScriptNode;\n      if (!input.typeAnnotation && !reported.has(input)) {\n        reported.add(input);\n        context.report({ node: input, messageId: \"missingContext\" });\n      }\n    }\n\n    function properties(node: Rule.Node, seen = new Set<Rule.Node>()): Map<string, Rule.Node> | undefined {\n      const object = resolve(node);\n      if (object.type !== \"ObjectExpression\" || seen.has(object)) {\n        return undefined;\n      }\n      const path = new Set(seen).add(object);\n      const result = new Map<string, Rule.Node>();\n      for (const property of object.properties) {\n        if (property.type === \"SpreadElement\") {\n          const spread = properties(property.argument as Rule.Node, path);\n          if (spread) {\n            for (const [name, value] of spread) result.set(name, value);\n          } else {\n            // An opaque spread may replace any preceding property.\n            result.clear();\n          }\n          continue;\n        }\n        if (property.type === \"Property\") {\n          const name = propertyName(property.key as Rule.Node, property.computed);\n          if (name === undefined) {\n            result.clear();\n          } else if (property.kind === \"init\") {\n            result.set(name, property.value as Rule.Node);\n          } else {\n            result.delete(name);\n          }\n        }\n      }\n      return result;\n    }\n\n    return {\n      CallExpression(node) {\n        if (!isRouterCall(node.callee as Rule.Node)) {\n          return;\n        }\n        const config = node.arguments[1];\n        if (!config || config.type === \"SpreadElement\") {\n          return;\n        }\n        for (const routeConfig of properties(config as Rule.Node)?.values() ?? []) {\n          const callback = properties(routeConfig)?.get(\"preload\");\n          if (callback) checkPreload(callback);\n        }\n      },\n    };\n  },\n};\n","import type { ESLint } from \"eslint\";\nimport { name, version } from \"../package.json\";\nimport { requirePreloadContext } from \"./rules/requirePreloadContext.js\";\n\n/** Opt-in ESLint rules for spa-kit consumers. */\nconst plugin: ESLint.Plugin = {\n  meta: { name, version },\n  rules: {\n    \"require-preload-context\": requirePreloadContext,\n  },\n};\n\nexport default plugin;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+import { ESLint } from 'eslint';
+
+/** Opt-in ESLint rules for spa-kit consumers. */
+declare const plugin: ESLint.Plugin;
+
+export { plugin as default };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { ESLint } from 'eslint';
+
+/** Opt-in ESLint rules for spa-kit consumers. */
+declare const plugin: ESLint.Plugin;
+
+export { plugin as default };

package/dist/index.js

@@ -0,0 +1,159 @@
+// package.json
+var name = "@spa-kit/eslint-plugin";
+var version = "0.1.0";
+
+// src/rules/requirePreloadContext.ts
+var wrappers = /* @__PURE__ */ new Set(["TSAsExpression", "TSSatisfiesExpression", "TSTypeAssertion", "TSNonNullExpression"]);
+function unwrap(node) {
+  let current = node;
+  while (wrappers.has(current.type) && current.expression) {
+    current = current.expression;
+  }
+  return current;
+}
+function propertyName(node, computed) {
+  if (!computed && node.type === "Identifier") {
+    return node.name;
+  }
+  if (node.type === "Literal" && typeof node.value === "string") {
+    return node.value;
+  }
+  return void 0;
+}
+var requirePreloadContext = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require an explicit parameter type on route preloads to preserve render inference"
+    },
+    schema: [],
+    messages: {
+      missingContext: "Annotate the preload parameter with its generated route context type to preserve render inference."
+    }
+  },
+  create(context) {
+    const source = context.sourceCode;
+    const reported = /* @__PURE__ */ new Set();
+    function variableFor(node) {
+      if (node.type !== "Identifier") {
+        return void 0;
+      }
+      let scope = source.getScope(node);
+      while (scope) {
+        const variable = scope.set.get(node.name);
+        if (variable) {
+          return variable;
+        }
+        scope = scope.upper;
+      }
+      return void 0;
+    }
+    function resolve(node, seen = /* @__PURE__ */ new Set()) {
+      const value = unwrap(node);
+      if (seen.has(value) || value.type !== "Identifier") {
+        return value;
+      }
+      seen.add(value);
+      const variable = variableFor(value);
+      const definition = variable?.defs[0];
+      if (definition?.type === "FunctionName" && definition.node.type === "FunctionDeclaration") {
+        return definition.node;
+      }
+      if (definition?.type === "Variable" && definition.parent?.kind === "const" && definition.node.init) {
+        return resolve(definition.node.init, seen);
+      }
+      return value;
+    }
+    function isRouterImport(node, namespace) {
+      const definition = variableFor(node)?.defs[0];
+      if (definition?.type !== "ImportBinding" || definition.parent.source.value !== "@spa-kit/react-router") {
+        return false;
+      }
+      const specifier = definition.node;
+      if (namespace) {
+        return specifier.type === "ImportNamespaceSpecifier";
+      }
+      return specifier.type === "ImportSpecifier" && propertyName(specifier.imported, false) === "createSpaRouter";
+    }
+    function isRouterCall(callee) {
+      const value = resolve(callee);
+      if (value.type === "Identifier") {
+        return isRouterImport(value, false);
+      }
+      return value.type === "MemberExpression" && propertyName(value.property, value.computed) === "createSpaRouter" && isRouterImport(resolve(value.object), true);
+    }
+    function checkPreload(node) {
+      const callback = resolve(node);
+      if (callback.type !== "ArrowFunctionExpression" && callback.type !== "FunctionExpression" && callback.type !== "FunctionDeclaration") {
+        return;
+      }
+      const parameter = callback.params.find((param) => param.type !== "Identifier" || param.name !== "this");
+      if (!parameter) {
+        return;
+      }
+      const input = parameter.type === "AssignmentPattern" ? parameter.left : parameter;
+      if (!input.typeAnnotation && !reported.has(input)) {
+        reported.add(input);
+        context.report({ node: input, messageId: "missingContext" });
+      }
+    }
+    function properties(node, seen = /* @__PURE__ */ new Set()) {
+      const object = resolve(node);
+      if (object.type !== "ObjectExpression" || seen.has(object)) {
+        return void 0;
+      }
+      const path = new Set(seen).add(object);
+      const result = /* @__PURE__ */ new Map();
+      for (const property of object.properties) {
+        if (property.type === "SpreadElement") {
+          const spread = properties(property.argument, path);
+          if (spread) {
+            for (const [name2, value] of spread) result.set(name2, value);
+          } else {
+            result.clear();
+          }
+          continue;
+        }
+        if (property.type === "Property") {
+          const name2 = propertyName(property.key, property.computed);
+          if (name2 === void 0) {
+            result.clear();
+          } else if (property.kind === "init") {
+            result.set(name2, property.value);
+          } else {
+            result.delete(name2);
+          }
+        }
+      }
+      return result;
+    }
+    return {
+      CallExpression(node) {
+        if (!isRouterCall(node.callee)) {
+          return;
+        }
+        const config = node.arguments[1];
+        if (!config || config.type === "SpreadElement") {
+          return;
+        }
+        for (const routeConfig of properties(config)?.values() ?? []) {
+          const callback = properties(routeConfig)?.get("preload");
+          if (callback) checkPreload(callback);
+        }
+      }
+    };
+  }
+};
+
+// src/index.ts
+var plugin = {
+  meta: { name, version },
+  rules: {
+    "require-preload-context": requirePreloadContext
+  }
+};
+var index_default = plugin;
+
+export { index_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../package.json","../src/rules/requirePreloadContext.ts","../src/index.ts"],"names":["name"],"mappings":";AACE,IAAA,IAAA,GAAQ,wBAAA;AACR,IAAA,OAAA,GAAW,OAAA;;;ACOb,IAAM,QAAA,uBAAe,GAAA,CAAI,CAAC,kBAAkB,uBAAA,EAAyB,iBAAA,EAAmB,qBAAqB,CAAC,CAAA;AAE9G,SAAS,OAAO,IAAA,EAA4B;AAC1C,EAAA,IAAI,OAAA,GAAU,IAAA;AACd,EAAA,OAAO,SAAS,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAA,IAAK,QAAQ,UAAA,EAAY;AACvD,IAAA,OAAA,GAAU,OAAA,CAAQ,UAAA;AAAA,EACpB;AACA,EAAA,OAAO,OAAA;AACT;AAEA,SAAS,YAAA,CAAa,MAAiB,QAAA,EAAuC;AAC5E,EAAA,IAAI,CAAC,QAAA,IAAY,IAAA,CAAK,IAAA,KAAS,YAAA,EAAc;AAC3C,IAAA,OAAO,IAAA,CAAK,IAAA;AAAA,EACd;AACA,EAAA,IAAI,KAAK,IAAA,KAAS,SAAA,IAAa,OAAO,IAAA,CAAK,UAAU,QAAA,EAAU;AAC7D,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,EACd;AACA,EAAA,OAAO,MAAA;AACT;AAGO,IAAM,qBAAA,GAAyC;AAAA,EACpD,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,SAAA;AAAA,IACN,IAAA,EAAM;AAAA,MACJ,WAAA,EAAa;AAAA,KACf;AAAA,IACA,QAAQ,EAAC;AAAA,IACT,QAAA,EAAU;AAAA,MACR,cAAA,EAAgB;AAAA;AAClB,GACF;AAAA,EACA,OAAO,OAAA,EAAS;AACd,IAAA,MAAM,SAAS,OAAA,CAAQ,UAAA;AACvB,IAAA,MAAM,QAAA,uBAAe,GAAA,EAAe;AAEpC,IAAA,SAAS,YAAY,IAAA,EAAiB;AACpC,MAAA,IAAI,IAAA,CAAK,SAAS,YAAA,EAAc;AAC9B,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,IAAI,KAAA,GAAmD,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA;AAC3E,MAAA,OAAO,KAAA,EAAO;AACZ,QAAA,MAAM,QAAA,GAAW,KAAA,CAAM,GAAA,CAAI,GAAA,CAAI,KAAK,IAAI,CAAA;AACxC,QAAA,IAAI,QAAA,EAAU;AACZ,UAAA,OAAO,QAAA;AAAA,QACT;AACA,QAAA,KAAA,GAAQ,KAAA,CAAM,KAAA;AAAA,MAChB;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAIA,IAAA,SAAS,OAAA,CAAQ,IAAA,EAAiB,IAAA,mBAAO,IAAI,KAAe,EAAc;AACxE,MAAA,MAAM,KAAA,GAAQ,OAAO,IAAI,CAAA;AACzB,MAAA,IAAI,KAAK,GAAA,CAAI,KAAK,CAAA,IAAK,KAAA,CAAM,SAAS,YAAA,EAAc;AAClD,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,IAAA,CAAK,IAAI,KAAK,CAAA;AACd,MAAA,MAAM,QAAA,GAAW,YAAY,KAAK,CAAA;AAClC,MAAA,MAAM,UAAA,GAAa,QAAA,EAAU,IAAA,CAAK,CAAC,CAAA;AACnC,MAAA,IAAI,YAAY,IAAA,KAAS,cAAA,IAAkB,UAAA,CAAW,IAAA,CAAK,SAAS,qBAAA,EAAuB;AACzF,QAAA,OAAO,UAAA,CAAW,IAAA;AAAA,MACpB;AACA,MAAA,IAAI,UAAA,EAAY,SAAS,UAAA,IAAc,UAAA,CAAW,QAAQ,IAAA,KAAS,OAAA,IAAW,UAAA,CAAW,IAAA,CAAK,IAAA,EAAM;AAClG,QAAA,OAAO,OAAA,CAAQ,UAAA,CAAW,IAAA,CAAK,IAAA,EAAmB,IAAI,CAAA;AAAA,MACxD;AACA,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,SAAS,cAAA,CAAe,MAAiB,SAAA,EAA6B;AACpE,MAAA,MAAM,UAAA,GAAa,WAAA,CAAY,IAAI,CAAA,EAAG,KAAK,CAAC,CAAA;AAC5C,MAAA,IAAI,YAAY,IAAA,KAAS,eAAA,IAAmB,WAAW,MAAA,CAAO,MAAA,CAAO,UAAU,uBAAA,EAAyB;AACtG,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,MAAM,YAAY,UAAA,CAAW,IAAA;AAC7B,MAAA,IAAI,SAAA,EAAW;AACb,QAAA,OAAO,UAAU,IAAA,KAAS,0BAAA;AAAA,MAC5B;AACA,MAAA,OAAO,UAAU,IAAA,KAAS,iBAAA,IACxB,aAAa,SAAA,CAAU,QAAA,EAAuB,KAAK,CAAA,KAAM,iBAAA;AAAA,IAC7D;AAEA,IAAA,SAAS,aAAa,MAAA,EAA4B;AAChD,MAAA,MAAM,KAAA,GAAQ,QAAQ,MAAM,CAAA;AAC5B,MAAA,IAAI,KAAA,CAAM,SAAS,YAAA,EAAc;AAC/B,QAAA,OAAO,cAAA,CAAe,OAAO,KAAK,CAAA;AAAA,MACpC;AACA,MAAA,OAAO,KAAA,CAAM,IAAA,KAAS,kBAAA,IACpB,YAAA,CAAa,MAAM,QAAA,EAAuB,KAAA,CAAM,QAAQ,CAAA,KAAM,qBAC9D,cAAA,CAAe,OAAA,CAAQ,KAAA,CAAM,MAAmB,GAAG,IAAI,CAAA;AAAA,IAC3D;AAEA,IAAA,SAAS,aAAa,IAAA,EAAiB;AACrC,MAAA,MAAM,QAAA,GAAW,QAAQ,IAAI,CAAA;AAC7B,MAAA,IAAI,QAAA,CAAS,SAAS,yBAAA,IAA6B,QAAA,CAAS,SAAS,oBAAA,IACjE,QAAA,CAAS,SAAS,qBAAA,EAAuB;AAC3C,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,SAAA,GAAY,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,CAAC,KAAA,KAAU,KAAA,CAAM,IAAA,KAAS,YAAA,IAAgB,KAAA,CAAM,IAAA,KAAS,MAAM,CAAA;AACtG,MAAA,IAAI,CAAC,SAAA,EAAW;AACd,QAAA;AAAA,MACF;AACA,MAAA,MAAM,KAAA,GAAS,SAAA,CAAU,IAAA,KAAS,mBAAA,GAAsB,UAAU,IAAA,GAAO,SAAA;AACzE,MAAA,IAAI,CAAC,KAAA,CAAM,cAAA,IAAkB,CAAC,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA,EAAG;AACjD,QAAA,QAAA,CAAS,IAAI,KAAK,CAAA;AAClB,QAAA,OAAA,CAAQ,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,kBAAkB,CAAA;AAAA,MAC7D;AAAA,IACF;AAEA,IAAA,SAAS,UAAA,CAAW,IAAA,EAAiB,IAAA,mBAAO,IAAI,KAAe,EAAuC;AACpG,MAAA,MAAM,MAAA,GAAS,QAAQ,IAAI,CAAA;AAC3B,MAAA,IAAI,OAAO,IAAA,KAAS,kBAAA,IAAsB,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,EAAG;AAC1D,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,MAAM,OAAO,IAAI,GAAA,CAAI,IAAI,CAAA,CAAE,IAAI,MAAM,CAAA;AACrC,MAAA,MAAM,MAAA,uBAAa,GAAA,EAAuB;AAC1C,MAAA,KAAA,MAAW,QAAA,IAAY,OAAO,UAAA,EAAY;AACxC,QAAA,IAAI,QAAA,CAAS,SAAS,eAAA,EAAiB;AACrC,UAAA,MAAM,MAAA,GAAS,UAAA,CAAW,QAAA,CAAS,QAAA,EAAuB,IAAI,CAAA;AAC9D,UAAA,IAAI,MAAA,EAAQ;AACV,YAAA,KAAA,MAAW,CAACA,OAAM,KAAK,CAAA,IAAK,QAAQ,MAAA,CAAO,GAAA,CAAIA,OAAM,KAAK,CAAA;AAAA,UAC5D,CAAA,MAAO;AAEL,YAAA,MAAA,CAAO,KAAA,EAAM;AAAA,UACf;AACA,UAAA;AAAA,QACF;AACA,QAAA,IAAI,QAAA,CAAS,SAAS,UAAA,EAAY;AAChC,UAAA,MAAMA,KAAAA,GAAO,YAAA,CAAa,QAAA,CAAS,GAAA,EAAkB,SAAS,QAAQ,CAAA;AACtE,UAAA,IAAIA,UAAS,MAAA,EAAW;AACtB,YAAA,MAAA,CAAO,KAAA,EAAM;AAAA,UACf,CAAA,MAAA,IAAW,QAAA,CAAS,IAAA,KAAS,MAAA,EAAQ;AACnC,YAAA,MAAA,CAAO,GAAA,CAAIA,KAAAA,EAAM,QAAA,CAAS,KAAkB,CAAA;AAAA,UAC9C,CAAA,MAAO;AACL,YAAA,MAAA,CAAO,OAAOA,KAAI,CAAA;AAAA,UACpB;AAAA,QACF;AAAA,MACF;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAEA,IAAA,OAAO;AAAA,MACL,eAAe,IAAA,EAAM;AACnB,QAAA,IAAI,CAAC,YAAA,CAAa,IAAA,CAAK,MAAmB,CAAA,EAAG;AAC3C,UAAA;AAAA,QACF;AACA,QAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA;AAC/B,QAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,IAAA,KAAS,eAAA,EAAiB;AAC9C,UAAA;AAAA,QACF;AACA,QAAA,KAAA,MAAW,eAAe,UAAA,CAAW,MAAmB,GAAG,MAAA,EAAO,IAAK,EAAC,EAAG;AACzE,UAAA,MAAM,QAAA,GAAW,UAAA,CAAW,WAAW,CAAA,EAAG,IAAI,SAAS,CAAA;AACvD,UAAA,IAAI,QAAA,eAAuB,QAAQ,CAAA;AAAA,QACrC;AAAA,MACF;AAAA,KACF;AAAA,EACF;AACF,CAAA;;;ACnKA,IAAM,MAAA,GAAwB;AAAA,EAC5B,IAAA,EAAM,EAAE,IAAA,EAAM,OAAA,EAAQ;AAAA,EACtB,KAAA,EAAO;AAAA,IACL,yBAAA,EAA2B;AAAA;AAE/B,CAAA;AAEA,IAAO,aAAA,GAAQ","file":"index.js","sourcesContent":["{\n  \"name\": \"@spa-kit/eslint-plugin\",\n  \"version\": \"0.1.0\",\n  \"description\": \"Opt-in ESLint rules for spa-kit applications\",\n  \"author\": \"Casey McGuire\",\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    }\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"typecheck:test\": \"tsc --project tsconfig.test.json\"\n  },\n  \"peerDependencies\": {\n    \"eslint\": \"^9.0.0 || ^10.0.0\"\n  },\n  \"devDependencies\": {\n    \"eslint\": \"^10.12.0\",\n    \"@typescript-eslint/parser\": \"^8.71.1\"\n  },\n  \"engines\": {\n    \"node\": \">=18.18.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  }\n}\n","import type { Rule } from \"eslint\";\n\n// ESLint's core node types describe JavaScript. These are the additional fields\n// used from the TypeScript ESTree parser; no type-checker services are needed.\ntype TypeScriptNode = Rule.Node & {\n  expression?: Rule.Node;\n  typeAnnotation?: unknown;\n};\n\nconst wrappers = new Set([\"TSAsExpression\", \"TSSatisfiesExpression\", \"TSTypeAssertion\", \"TSNonNullExpression\"]);\n\nfunction unwrap(node: Rule.Node): Rule.Node {\n  let current = node as TypeScriptNode;\n  while (wrappers.has(current.type) && current.expression) {\n    current = current.expression as TypeScriptNode;\n  }\n  return current;\n}\n\nfunction propertyName(node: Rule.Node, computed: boolean): string | undefined {\n  if (!computed && node.type === \"Identifier\") {\n    return node.name;\n  }\n  if (node.type === \"Literal\" && typeof node.value === \"string\") {\n    return node.value;\n  }\n  return undefined;\n}\n\n/** Require explicit generated context annotations on route preload inputs. */\nexport const requirePreloadContext: Rule.RuleModule = {\n  meta: {\n    type: \"problem\",\n    docs: {\n      description: \"Require an explicit parameter type on route preloads to preserve render inference\",\n    },\n    schema: [],\n    messages: {\n      missingContext: \"Annotate the preload parameter with its generated route context type to preserve render inference.\",\n    },\n  },\n  create(context) {\n    const source = context.sourceCode;\n    const reported = new Set<Rule.Node>();\n\n    function variableFor(node: Rule.Node) {\n      if (node.type !== \"Identifier\") {\n        return undefined;\n      }\n      let scope: ReturnType<typeof source.getScope> | null = source.getScope(node);\n      while (scope) {\n        const variable = scope.set.get(node.name);\n        if (variable) {\n          return variable;\n        }\n        scope = scope.upper;\n      }\n      return undefined;\n    }\n\n    // Follow immutable bindings in this file only. Imported values, mutable\n    // bindings, and dynamically constructed configurations are intentionally opaque.\n    function resolve(node: Rule.Node, seen = new Set<Rule.Node>()): Rule.Node {\n      const value = unwrap(node);\n      if (seen.has(value) || value.type !== \"Identifier\") {\n        return value;\n      }\n      seen.add(value);\n      const variable = variableFor(value);\n      const definition = variable?.defs[0];\n      if (definition?.type === \"FunctionName\" && definition.node.type === \"FunctionDeclaration\") {\n        return definition.node as Rule.Node;\n      }\n      if (definition?.type === \"Variable\" && definition.parent?.kind === \"const\" && definition.node.init) {\n        return resolve(definition.node.init as Rule.Node, seen);\n      }\n      return value;\n    }\n\n    function isRouterImport(node: Rule.Node, namespace: boolean): boolean {\n      const definition = variableFor(node)?.defs[0];\n      if (definition?.type !== \"ImportBinding\" || definition.parent.source.value !== \"@spa-kit/react-router\") {\n        return false;\n      }\n      const specifier = definition.node;\n      if (namespace) {\n        return specifier.type === \"ImportNamespaceSpecifier\";\n      }\n      return specifier.type === \"ImportSpecifier\" &&\n        propertyName(specifier.imported as Rule.Node, false) === \"createSpaRouter\";\n    }\n\n    function isRouterCall(callee: Rule.Node): boolean {\n      const value = resolve(callee);\n      if (value.type === \"Identifier\") {\n        return isRouterImport(value, false);\n      }\n      return value.type === \"MemberExpression\" &&\n        propertyName(value.property as Rule.Node, value.computed) === \"createSpaRouter\" &&\n        isRouterImport(resolve(value.object as Rule.Node), true);\n    }\n\n    function checkPreload(node: Rule.Node) {\n      const callback = resolve(node);\n      if (callback.type !== \"ArrowFunctionExpression\" && callback.type !== \"FunctionExpression\" &&\n          callback.type !== \"FunctionDeclaration\") {\n        return;\n      }\n      // A TypeScript `this` parameter is erased and is not the route context.\n      const parameter = callback.params.find((param) => param.type !== \"Identifier\" || param.name !== \"this\");\n      if (!parameter) {\n        return;\n      }\n      const input = (parameter.type === \"AssignmentPattern\" ? parameter.left : parameter) as TypeScriptNode;\n      if (!input.typeAnnotation && !reported.has(input)) {\n        reported.add(input);\n        context.report({ node: input, messageId: \"missingContext\" });\n      }\n    }\n\n    function properties(node: Rule.Node, seen = new Set<Rule.Node>()): Map<string, Rule.Node> | undefined {\n      const object = resolve(node);\n      if (object.type !== \"ObjectExpression\" || seen.has(object)) {\n        return undefined;\n      }\n      const path = new Set(seen).add(object);\n      const result = new Map<string, Rule.Node>();\n      for (const property of object.properties) {\n        if (property.type === \"SpreadElement\") {\n          const spread = properties(property.argument as Rule.Node, path);\n          if (spread) {\n            for (const [name, value] of spread) result.set(name, value);\n          } else {\n            // An opaque spread may replace any preceding property.\n            result.clear();\n          }\n          continue;\n        }\n        if (property.type === \"Property\") {\n          const name = propertyName(property.key as Rule.Node, property.computed);\n          if (name === undefined) {\n            result.clear();\n          } else if (property.kind === \"init\") {\n            result.set(name, property.value as Rule.Node);\n          } else {\n            result.delete(name);\n          }\n        }\n      }\n      return result;\n    }\n\n    return {\n      CallExpression(node) {\n        if (!isRouterCall(node.callee as Rule.Node)) {\n          return;\n        }\n        const config = node.arguments[1];\n        if (!config || config.type === \"SpreadElement\") {\n          return;\n        }\n        for (const routeConfig of properties(config as Rule.Node)?.values() ?? []) {\n          const callback = properties(routeConfig)?.get(\"preload\");\n          if (callback) checkPreload(callback);\n        }\n      },\n    };\n  },\n};\n","import type { ESLint } from \"eslint\";\nimport { name, version } from \"../package.json\";\nimport { requirePreloadContext } from \"./rules/requirePreloadContext.js\";\n\n/** Opt-in ESLint rules for spa-kit consumers. */\nconst plugin: ESLint.Plugin = {\n  meta: { name, version },\n  rules: {\n    \"require-preload-context\": requirePreloadContext,\n  },\n};\n\nexport default plugin;\n"]}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@spa-kit/eslint-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Opt-in ESLint rules for spa-kit applications",
+  "author": "Casey McGuire",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "typecheck:test": "tsc --project tsconfig.test.json"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0 || ^10.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^10.12.0",
+    "@typescript-eslint/parser": "^8.71.1"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}