@ts-kizuna/eslint-plugin 1.49.5

package/LICENSE.MD

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Sondre Ørland
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @ts-kizuna/eslint-plugin
+
+`@ts-kizuna/eslint-plugin` catches ts-kizuna mistakes in your editor, as you type. These are things the type system cannot express on its own.
+
+## Installation
+
+```sh
+pnpm add -D @ts-kizuna/eslint-plugin
+```
+
+## Usage
+
+Add the recommended config to your `eslint.config.js`:
+
+```js
+import kizuna from '@ts-kizuna/eslint-plugin';
+
+export default [kizuna.configs.recommended];
+```
+
+## Documentation
+
+[ESLint plugin](https://ts-kizuna.com/docs/eslint)

package/dist/index.cjs

@@ -0,0 +1,257 @@
+//#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
+let _typescript_eslint_parser = require("@typescript-eslint/parser");
+_typescript_eslint_parser = __toESM(_typescript_eslint_parser, 1);
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+let _typescript_eslint_utils = require("@typescript-eslint/utils");
+let typescript = require("typescript");
+typescript = __toESM(typescript, 1);
+let _ts_kizuna_core_authoring_names = require("@ts-kizuna/core/authoring-names");
+//#region package.json
+var name = "@ts-kizuna/eslint-plugin";
+var version = "1.49.4";
+//#endregion
+//#region src/schema-violations.ts
+/**
+* A JSDoc inline tag, `{@link …}`, `{@linkcode …}`, any `{@tag}`.
+*/
+const JSDOC_INLINE_TAG = /\{@[a-zA-Z][\w-]*/;
+/**
+* Walks a schema expression, following `z.object` shapes, nested objects, and identifier
+* references to other schemas (across files), and returns every issue it carries, each
+* paired with the node it sits on. The walk is bounded by a visited set so cycles end.
+*/
+const collectSchemaIssues = (root, resolve) => {
+	const violations = [];
+	const reported = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	const add = (issue, node, viaReference) => {
+		const key = `${issue}@${node.getSourceFile().fileName}:${node.pos}`;
+		if (reported.has(key)) return;
+		reported.add(key);
+		violations.push({
+			issue,
+			node,
+			viaReference
+		});
+	};
+	const checkFieldJsDoc = (property, viaReference) => {
+		const deprecatedTags = typescript.default.getJSDocTags(property).filter((tag) => tag.tagName.text === "deprecated");
+		if (deprecatedTags.length > 1) add("duplicate-deprecated", property, viaReference);
+		for (const tag of deprecatedTags) if (JSDOC_INLINE_TAG.test(typescript.default.getTextOfJSDocComment(tag.comment) ?? "")) add("jsdoc-tag", property, viaReference);
+	};
+	const walk = (node, viaReference) => {
+		if (typescript.default.isPropertyAccessExpression(node) && node.name.text === "coerce" && typescript.default.isIdentifier(node.expression) && node.expression.text === "z") add("coerce", node, viaReference);
+		if (typescript.default.isObjectLiteralExpression(node)) {
+			for (const property of node.properties) if (typescript.default.isPropertyAssignment(property) || typescript.default.isShorthandPropertyAssignment(property)) checkFieldJsDoc(property, viaReference);
+		}
+		if (typescript.default.isIdentifier(node)) {
+			const target = resolve(node);
+			if (target && !visited.has(target)) {
+				visited.add(target);
+				walk(target, true);
+			}
+		}
+		typescript.default.forEachChild(node, (child) => walk(child, viaReference));
+	};
+	visited.add(root);
+	walk(root, false);
+	return violations;
+};
+//#endregion
+//#region src/rules/no-unsupported-schema.ts
+const SCHEMA_KEYS = new Set([
+	"body",
+	"query",
+	"pathParams",
+	"headers"
+]);
+const createCheckerResolver = (checker) => (identifier) => {
+	const symbol = checker.getSymbolAtLocation(identifier);
+	if (!symbol) return void 0;
+	return (symbol.flags & typescript.default.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol).declarations?.find(typescript.default.isVariableDeclaration)?.initializer;
+};
+const createSourceResolver = () => {
+	const sourceFileCache = /* @__PURE__ */ new Map();
+	const optionsCache = /* @__PURE__ */ new Map();
+	const readSourceFile = (fileName) => {
+		if (sourceFileCache.has(fileName)) return sourceFileCache.get(fileName);
+		const text = typescript.default.sys.readFile(fileName);
+		const sourceFile = text === void 0 ? void 0 : typescript.default.createSourceFile(fileName, text, typescript.default.ScriptTarget.Latest, true);
+		sourceFileCache.set(fileName, sourceFile);
+		return sourceFile;
+	};
+	const compilerOptionsFor = (containingFile) => {
+		const configPath = typescript.default.findConfigFile(node_path.dirname(containingFile), typescript.default.sys.fileExists);
+		const key = configPath ?? "";
+		const cached = optionsCache.get(key);
+		if (cached) return cached;
+		const options = configPath ? typescript.default.parseJsonConfigFileContent(typescript.default.readConfigFile(configPath, typescript.default.sys.readFile).config, typescript.default.sys, node_path.dirname(configPath)).options : {
+			allowJs: true,
+			moduleResolution: typescript.default.ModuleResolutionKind.Bundler
+		};
+		optionsCache.set(key, options);
+		return options;
+	};
+	const constNamed = (sourceFile, name) => {
+		for (const statement of sourceFile.statements) {
+			if (!typescript.default.isVariableStatement(statement)) continue;
+			for (const declaration of statement.declarationList.declarations) if (typescript.default.isIdentifier(declaration.name) && declaration.name.text === name && declaration.initializer) return declaration.initializer;
+		}
+	};
+	const importedFrom = (sourceFile, name) => {
+		for (const statement of sourceFile.statements) {
+			if (!typescript.default.isImportDeclaration(statement) || !typescript.default.isStringLiteral(statement.moduleSpecifier)) continue;
+			const named = statement.importClause?.namedBindings;
+			if (!named || !typescript.default.isNamedImports(named)) continue;
+			for (const element of named.elements) if (element.name.text === name) return {
+				specifier: statement.moduleSpecifier.text,
+				exportedName: (element.propertyName ?? element.name).text
+			};
+		}
+	};
+	return (identifier) => {
+		const sourceFile = identifier.getSourceFile();
+		const local = constNamed(sourceFile, identifier.text);
+		if (local) return local;
+		const imported = importedFrom(sourceFile, identifier.text);
+		if (!imported) return void 0;
+		const resolved = typescript.default.resolveModuleName(imported.specifier, sourceFile.fileName, compilerOptionsFor(sourceFile.fileName), typescript.default.sys).resolvedModule?.resolvedFileName;
+		if (!resolved) return void 0;
+		const target = readSourceFile(resolved);
+		return target ? constNamed(target, imported.exportedName) : void 0;
+	};
+};
+const MESSAGE_IDS = {
+	coerce: ["coerce", "coerceReference"],
+	"jsdoc-tag": ["jsdocTag", "jsdocTagReference"],
+	"duplicate-deprecated": ["duplicateDeprecated", "duplicateDeprecatedReference"]
+};
+const calleeName = (node) => {
+	const { callee } = node;
+	if (callee.type === "Identifier") return callee.name;
+	if (callee.type === "MemberExpression" && callee.property.type === "Identifier") return callee.property.name;
+};
+const schemaNodesOf = (call) => {
+	const name = calleeName(call);
+	if (name === _ts_kizuna_core_authoring_names.AUTHORING_NAMES.model) {
+		const config = call.arguments[0];
+		if (config?.type !== "ObjectExpression") return [];
+		const schema = config.properties.find((property) => property.type === "Property" && property.key.type === "Identifier" && property.key.name === "schema");
+		return schema ? [schema.value] : [];
+	}
+	if (name !== _ts_kizuna_core_authoring_names.AUTHORING_NAMES.routes && name !== _ts_kizuna_core_authoring_names.AUTHORING_NAMES.contract) return [];
+	const nodes = [];
+	const visit = (node) => {
+		if (node.type === "Property") {
+			const isSchemaField = node.key.type === "Identifier" && SCHEMA_KEYS.has(node.key.name);
+			const isStatusResponse = node.key.type === "Literal" && typeof node.key.value === "number";
+			if (isSchemaField || isStatusResponse) nodes.push(node.value);
+		}
+		for (const [key, child] of Object.entries(node)) {
+			if (key === "parent") continue;
+			if (Array.isArray(child)) child.forEach((item) => item?.type && visit(item));
+			else if (child?.type) visit(child);
+		}
+	};
+	for (const argument of call.arguments) visit(argument);
+	return nodes;
+};
+const noUnsupportedSchema = _typescript_eslint_utils.ESLintUtils.RuleCreator.withoutDocs({
+	meta: {
+		type: "problem",
+		docs: { description: "Disallow constructs unsupported by ts-kizuna (z.coerce, @deprecated with JSDoc tags) in contract and model schemas, including imported ones." },
+		messages: {
+			coerce: "z.coerce is not supported in a ts-kizuna schema. kizuna coerces query, path, and header params automatically, use z.number(), z.date(), or z.bigint() instead.",
+			jsdocTag: "This @deprecated message uses JSDoc inline tags like {@link}. kizuna surfaces deprecation text verbatim to generated clients that cannot parse it, use plain text instead (backticks are fine).",
+			duplicateDeprecated: "This field has more than one @deprecated tag. kizuna serializes only the first and silently drops the rest, collapse them into a single message.",
+			coerceReference: "This schema uses z.coerce, which ts-kizuna does not support. kizuna coerces query, path, and header params automatically, use z.number(), z.date(), or z.bigint() instead.",
+			jsdocTagReference: "This schema has a @deprecated message with JSDoc inline tags like {@link}. kizuna surfaces deprecation text verbatim to generated clients that cannot parse it, use plain text instead (backticks are fine).",
+			duplicateDeprecatedReference: "This schema has a field with more than one @deprecated tag. kizuna serializes only the first and silently drops the rest, collapse them into a single message."
+		},
+		schema: []
+	},
+	defaultOptions: [],
+	create(context) {
+		const services = _typescript_eslint_utils.ESLintUtils.getParserServices(context, true);
+		const resolve = services.program ? createCheckerResolver(services.program.getTypeChecker()) : createSourceResolver();
+		const reported = /* @__PURE__ */ new Set();
+		return { CallExpression(call) {
+			for (const schemaNode of schemaNodesOf(call)) {
+				const tsNode = services.esTreeNodeToTSNodeMap.get(schemaNode);
+				for (const { issue, node, viaReference } of collectSchemaIssues(tsNode, resolve)) {
+					const reportNode = (viaReference ? void 0 : services.tsNodeToESTreeNodeMap.get(node)) ?? schemaNode;
+					const messageId = MESSAGE_IDS[issue][viaReference ? 1 : 0];
+					const key = `${messageId}@${reportNode.range[0]}`;
+					if (reported.has(key)) continue;
+					reported.add(key);
+					context.report({
+						node: reportNode,
+						messageId
+					});
+				}
+			}
+		} };
+	}
+});
+//#endregion
+//#region src/index.ts
+const plugin = {
+	meta: {
+		name,
+		version,
+		namespace: "@ts-kizuna"
+	},
+	rules: { "no-unsupported-schema": noUnsupportedSchema }
+};
+/**
+* Flat config enabling every ts-kizuna rule.
+*
+* ```js
+* import kizuna from '@ts-kizuna/eslint-plugin';
+*
+* export default [kizuna.configs.recommended];
+* ```
+*/
+const recommended = {
+	name: "@ts-kizuna/recommended",
+	files: [
+		"**/*.ts",
+		"**/*.cts",
+		"**/*.mts",
+		"**/*.tsx"
+	],
+	plugins: { "@ts-kizuna": plugin },
+	languageOptions: {
+		parser: _typescript_eslint_parser.default,
+		parserOptions: { jsDocParsingMode: "all" }
+	},
+	rules: { "@ts-kizuna/no-unsupported-schema": "error" }
+};
+const eslintPlugin = {
+	...plugin,
+	configs: { recommended }
+};
+//#endregion
+module.exports = eslintPlugin;

package/dist/index.d.cts

@@ -0,0 +1,9 @@
+import { ESLint, Linter } from "eslint";
+
+//#region src/index.d.ts
+declare const eslintPlugin: ESLint.Plugin & {
+  configs: {
+    recommended: Linter.Config;
+  };
+};
+export = eslintPlugin;

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+import { ESLint, Linter } from "eslint";
+
+//#region src/index.d.ts
+declare const eslintPlugin: ESLint.Plugin & {
+  configs: {
+    recommended: Linter.Config;
+  };
+};
+//#endregion
+export { eslintPlugin as default };

package/dist/index.mjs

@@ -0,0 +1,232 @@
+import parser from "@typescript-eslint/parser";
+import * as path from "node:path";
+import { ESLintUtils } from "@typescript-eslint/utils";
+import ts from "typescript";
+import { AUTHORING_NAMES } from "@ts-kizuna/core/authoring-names";
+//#region package.json
+var name = "@ts-kizuna/eslint-plugin";
+var version = "1.49.4";
+//#endregion
+//#region src/schema-violations.ts
+/**
+* A JSDoc inline tag, `{@link …}`, `{@linkcode …}`, any `{@tag}`.
+*/
+const JSDOC_INLINE_TAG = /\{@[a-zA-Z][\w-]*/;
+/**
+* Walks a schema expression, following `z.object` shapes, nested objects, and identifier
+* references to other schemas (across files), and returns every issue it carries, each
+* paired with the node it sits on. The walk is bounded by a visited set so cycles end.
+*/
+const collectSchemaIssues = (root, resolve) => {
+	const violations = [];
+	const reported = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	const add = (issue, node, viaReference) => {
+		const key = `${issue}@${node.getSourceFile().fileName}:${node.pos}`;
+		if (reported.has(key)) return;
+		reported.add(key);
+		violations.push({
+			issue,
+			node,
+			viaReference
+		});
+	};
+	const checkFieldJsDoc = (property, viaReference) => {
+		const deprecatedTags = ts.getJSDocTags(property).filter((tag) => tag.tagName.text === "deprecated");
+		if (deprecatedTags.length > 1) add("duplicate-deprecated", property, viaReference);
+		for (const tag of deprecatedTags) if (JSDOC_INLINE_TAG.test(ts.getTextOfJSDocComment(tag.comment) ?? "")) add("jsdoc-tag", property, viaReference);
+	};
+	const walk = (node, viaReference) => {
+		if (ts.isPropertyAccessExpression(node) && node.name.text === "coerce" && ts.isIdentifier(node.expression) && node.expression.text === "z") add("coerce", node, viaReference);
+		if (ts.isObjectLiteralExpression(node)) {
+			for (const property of node.properties) if (ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property)) checkFieldJsDoc(property, viaReference);
+		}
+		if (ts.isIdentifier(node)) {
+			const target = resolve(node);
+			if (target && !visited.has(target)) {
+				visited.add(target);
+				walk(target, true);
+			}
+		}
+		ts.forEachChild(node, (child) => walk(child, viaReference));
+	};
+	visited.add(root);
+	walk(root, false);
+	return violations;
+};
+//#endregion
+//#region src/rules/no-unsupported-schema.ts
+const SCHEMA_KEYS = new Set([
+	"body",
+	"query",
+	"pathParams",
+	"headers"
+]);
+const createCheckerResolver = (checker) => (identifier) => {
+	const symbol = checker.getSymbolAtLocation(identifier);
+	if (!symbol) return void 0;
+	return (symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol).declarations?.find(ts.isVariableDeclaration)?.initializer;
+};
+const createSourceResolver = () => {
+	const sourceFileCache = /* @__PURE__ */ new Map();
+	const optionsCache = /* @__PURE__ */ new Map();
+	const readSourceFile = (fileName) => {
+		if (sourceFileCache.has(fileName)) return sourceFileCache.get(fileName);
+		const text = ts.sys.readFile(fileName);
+		const sourceFile = text === void 0 ? void 0 : ts.createSourceFile(fileName, text, ts.ScriptTarget.Latest, true);
+		sourceFileCache.set(fileName, sourceFile);
+		return sourceFile;
+	};
+	const compilerOptionsFor = (containingFile) => {
+		const configPath = ts.findConfigFile(path.dirname(containingFile), ts.sys.fileExists);
+		const key = configPath ?? "";
+		const cached = optionsCache.get(key);
+		if (cached) return cached;
+		const options = configPath ? ts.parseJsonConfigFileContent(ts.readConfigFile(configPath, ts.sys.readFile).config, ts.sys, path.dirname(configPath)).options : {
+			allowJs: true,
+			moduleResolution: ts.ModuleResolutionKind.Bundler
+		};
+		optionsCache.set(key, options);
+		return options;
+	};
+	const constNamed = (sourceFile, name) => {
+		for (const statement of sourceFile.statements) {
+			if (!ts.isVariableStatement(statement)) continue;
+			for (const declaration of statement.declarationList.declarations) if (ts.isIdentifier(declaration.name) && declaration.name.text === name && declaration.initializer) return declaration.initializer;
+		}
+	};
+	const importedFrom = (sourceFile, name) => {
+		for (const statement of sourceFile.statements) {
+			if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) continue;
+			const named = statement.importClause?.namedBindings;
+			if (!named || !ts.isNamedImports(named)) continue;
+			for (const element of named.elements) if (element.name.text === name) return {
+				specifier: statement.moduleSpecifier.text,
+				exportedName: (element.propertyName ?? element.name).text
+			};
+		}
+	};
+	return (identifier) => {
+		const sourceFile = identifier.getSourceFile();
+		const local = constNamed(sourceFile, identifier.text);
+		if (local) return local;
+		const imported = importedFrom(sourceFile, identifier.text);
+		if (!imported) return void 0;
+		const resolved = ts.resolveModuleName(imported.specifier, sourceFile.fileName, compilerOptionsFor(sourceFile.fileName), ts.sys).resolvedModule?.resolvedFileName;
+		if (!resolved) return void 0;
+		const target = readSourceFile(resolved);
+		return target ? constNamed(target, imported.exportedName) : void 0;
+	};
+};
+const MESSAGE_IDS = {
+	coerce: ["coerce", "coerceReference"],
+	"jsdoc-tag": ["jsdocTag", "jsdocTagReference"],
+	"duplicate-deprecated": ["duplicateDeprecated", "duplicateDeprecatedReference"]
+};
+const calleeName = (node) => {
+	const { callee } = node;
+	if (callee.type === "Identifier") return callee.name;
+	if (callee.type === "MemberExpression" && callee.property.type === "Identifier") return callee.property.name;
+};
+const schemaNodesOf = (call) => {
+	const name = calleeName(call);
+	if (name === AUTHORING_NAMES.model) {
+		const config = call.arguments[0];
+		if (config?.type !== "ObjectExpression") return [];
+		const schema = config.properties.find((property) => property.type === "Property" && property.key.type === "Identifier" && property.key.name === "schema");
+		return schema ? [schema.value] : [];
+	}
+	if (name !== AUTHORING_NAMES.routes && name !== AUTHORING_NAMES.contract) return [];
+	const nodes = [];
+	const visit = (node) => {
+		if (node.type === "Property") {
+			const isSchemaField = node.key.type === "Identifier" && SCHEMA_KEYS.has(node.key.name);
+			const isStatusResponse = node.key.type === "Literal" && typeof node.key.value === "number";
+			if (isSchemaField || isStatusResponse) nodes.push(node.value);
+		}
+		for (const [key, child] of Object.entries(node)) {
+			if (key === "parent") continue;
+			if (Array.isArray(child)) child.forEach((item) => item?.type && visit(item));
+			else if (child?.type) visit(child);
+		}
+	};
+	for (const argument of call.arguments) visit(argument);
+	return nodes;
+};
+const noUnsupportedSchema = ESLintUtils.RuleCreator.withoutDocs({
+	meta: {
+		type: "problem",
+		docs: { description: "Disallow constructs unsupported by ts-kizuna (z.coerce, @deprecated with JSDoc tags) in contract and model schemas, including imported ones." },
+		messages: {
+			coerce: "z.coerce is not supported in a ts-kizuna schema. kizuna coerces query, path, and header params automatically, use z.number(), z.date(), or z.bigint() instead.",
+			jsdocTag: "This @deprecated message uses JSDoc inline tags like {@link}. kizuna surfaces deprecation text verbatim to generated clients that cannot parse it, use plain text instead (backticks are fine).",
+			duplicateDeprecated: "This field has more than one @deprecated tag. kizuna serializes only the first and silently drops the rest, collapse them into a single message.",
+			coerceReference: "This schema uses z.coerce, which ts-kizuna does not support. kizuna coerces query, path, and header params automatically, use z.number(), z.date(), or z.bigint() instead.",
+			jsdocTagReference: "This schema has a @deprecated message with JSDoc inline tags like {@link}. kizuna surfaces deprecation text verbatim to generated clients that cannot parse it, use plain text instead (backticks are fine).",
+			duplicateDeprecatedReference: "This schema has a field with more than one @deprecated tag. kizuna serializes only the first and silently drops the rest, collapse them into a single message."
+		},
+		schema: []
+	},
+	defaultOptions: [],
+	create(context) {
+		const services = ESLintUtils.getParserServices(context, true);
+		const resolve = services.program ? createCheckerResolver(services.program.getTypeChecker()) : createSourceResolver();
+		const reported = /* @__PURE__ */ new Set();
+		return { CallExpression(call) {
+			for (const schemaNode of schemaNodesOf(call)) {
+				const tsNode = services.esTreeNodeToTSNodeMap.get(schemaNode);
+				for (const { issue, node, viaReference } of collectSchemaIssues(tsNode, resolve)) {
+					const reportNode = (viaReference ? void 0 : services.tsNodeToESTreeNodeMap.get(node)) ?? schemaNode;
+					const messageId = MESSAGE_IDS[issue][viaReference ? 1 : 0];
+					const key = `${messageId}@${reportNode.range[0]}`;
+					if (reported.has(key)) continue;
+					reported.add(key);
+					context.report({
+						node: reportNode,
+						messageId
+					});
+				}
+			}
+		} };
+	}
+});
+//#endregion
+//#region src/index.ts
+const plugin = {
+	meta: {
+		name,
+		version,
+		namespace: "@ts-kizuna"
+	},
+	rules: { "no-unsupported-schema": noUnsupportedSchema }
+};
+/**
+* Flat config enabling every ts-kizuna rule.
+*
+* ```js
+* import kizuna from '@ts-kizuna/eslint-plugin';
+*
+* export default [kizuna.configs.recommended];
+* ```
+*/
+const recommended = {
+	name: "@ts-kizuna/recommended",
+	files: [
+		"**/*.ts",
+		"**/*.cts",
+		"**/*.mts",
+		"**/*.tsx"
+	],
+	plugins: { "@ts-kizuna": plugin },
+	languageOptions: {
+		parser,
+		parserOptions: { jsDocParsingMode: "all" }
+	},
+	rules: { "@ts-kizuna/no-unsupported-schema": "error" }
+};
+const eslintPlugin = {
+	...plugin,
+	configs: { recommended }
+};
+//#endregion
+export { eslintPlugin as default };

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@ts-kizuna/eslint-plugin",
+  "version": "1.49.5",
+  "description": "ESLint rules for ts-kizuna contracts, flagging Zod schemas it cannot represent",
+  "keywords": [
+    "ts-kizuna",
+    "typescript",
+    "zod",
+    "openapi",
+    "contract-first",
+    "type-safe",
+    "rest",
+    "api",
+    "eslint",
+    "eslintplugin",
+    "eslint-plugin",
+    "lint"
+  ],
+  "license": "MIT",
+  "homepage": "https://ts-kizuna.com/docs/eslint",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ts-kizuna/kizuna.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "bugs": "https://github.com/ts-kizuna/kizuna/issues",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "kizuna": {
+    "entries": {
+      ".": "server"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@typescript-eslint/parser": "^8.0.0",
+    "@typescript-eslint/utils": "^8.0.0"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0",
+    "typescript": ">=5.0.0",
+    "@ts-kizuna/core": "1.49.5"
+  },
+  "devDependencies": {
+    "eslint": "^9.39.4",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.6.3",
+    "zod": "^4.0.0",
+    "@ts-kizuna/core": "1.49.5"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format esm,cjs --dts --clean --external eslint --external typescript --external @typescript-eslint/utils --external @typescript-eslint/parser --external @ts-kizuna/core",
+    "typecheck": "tsc --noEmit"
+  }
+}