@swiftuijs/twill-linter 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Saiya and twill contributors
+
+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

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# <img src="https://twill.evecalm.com/logo.png" alt="Twill hummingbird" align="right" width="40" height="40" /> Twill linter
 
-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.
+An ESLint 9/10 flat-config plugin for `.twill` and `.twillx`, with typescript-eslint rules, original-source diagnostics and conservative fixes.
+
+Install in your application:
+
+```sh
+pnpm add -D @swiftuijs/twill-linter eslint
+```
+
+`eslint.config.mjs`:
+
+```js
+import twill from '@swiftuijs/twill-linter';
+export default [
+  { ignores: ['**/dist/**'] },
+  ...twill.configs.recommended,
+  { languageOptions: { globals: { console: 'readonly' } } },
+];
+```
+
+```sh
+pnpm exec eslint src
+pnpm exec eslint src --fix
+```
+
+`recommended` supplies standard JS and typescript-eslint recommended rules. `recommendedTypeChecked` additionally supplies typed rules; Twill files need a nearby tsconfig and are checked against Twill's virtual TypeScript program. Native TS files use typescript-eslint's project service normally. Add ordinary framework/environment globals as with any ESLint project.
+
+`recommendedTypeChecked` also enables `@typescript-eslint/switch-exhaustiveness-check`. A switch over a discriminated union must explicitly cover each variant, even when it has a `default` branch. Adding a variant then exposes missing handlers in both Twill and native TS files. This check is opt-in linting, not a new compiler guarantee; run ESLint in CI to enforce it. Ordinary `recommended` does not require type information. See [practical patterns](https://twill.evecalm.com/patterns) for an example.
+
+The processor honors the project Twill/JSX settings. Generated-only diagnostics are suppressed. Fixes and suggestions are offered only when their ranges and replaced text map exactly to original source; fixes requiring compiler-generated syntax are withheld. `disposeProjects()` releases the cached typed projects when embedding the plugin in a long-lived process. The typed cache checks existing project/configuration file mtimes; restart linting after adding/deleting files to refresh discovered roots.
+
+For VS Code, use Microsoft's ESLint extension and add `twill-typescript` and `twill-tsx` to `eslint.validate`. The Twill VSIX supplies language IDs and TypeScript diagnostics; ESLint supplies lint rules and fixes.
+
+Custom rule overrides should also match the virtual TS/TSX files, as with other ESLint processors:
+
+```js
+{ files: ['**/*.{ts,tsx,twill,twillx}'], rules: { 'prefer-const': 'error' } }
+```
+
+Framework ESLint plugins can attach their ordinary TS/TSX rules to these virtual files. Keep ESLint formatting rules disabled and let Prettier handle layout; rewrites spanning generated syntax cannot always be mapped back safely.
+
+[Documentation](https://twill.evecalm.com/tooling) · [Issues](https://github.com/swiftuijs/twill/issues) · MIT licensed · Built by [forth.ink](https://forth.ink).

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { ESLint, Linter } from 'eslint';
+declare const plugin: ESLint.Plugin & {
+    configs: Record<string, Linter.Config[]>;
+};
+export declare const configs: Record<string, Linter.Config[]>;
+export declare const processors: Record<string, Linter.Processor>;
+export declare function disposeProjects(): void;
+export default plugin;

package/dist/index.js

@@ -0,0 +1,325 @@
+import { generatedPosition, originalPosition, transform } from "@swiftuijs/twill";
+import { TwillProject, virtualFilename } from "@swiftuijs/twill/project";
+import * as parser from "@typescript-eslint/parser";
+import typescriptPlugin from "@typescript-eslint/eslint-plugin";
+import js from "@eslint/js";
+import ts from "typescript";
+import { loadConfig } from "@swiftuijs/twill/config";
+import { dirname } from "node:path";
+import { statSync } from "node:fs";
+var package_default = {
+	name: "@swiftuijs/twill-linter",
+	version: "0.1.1",
+	type: "module",
+	license: "MIT",
+	repository: {
+		"type": "git",
+		"url": "git+https://github.com/swiftuijs/twill.git",
+		"directory": "packages/linter"
+	},
+	files: [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	exports: { ".": {
+		"types": "./dist/index.d.ts",
+		"import": "./dist/index.js"
+	} },
+	scripts: {
+		"build": "vite build",
+		"typecheck": "tsc --noEmit -p tsconfig.json",
+		"test:unit": "vitest run",
+		"test:watch": "vitest",
+		"test:coverage": "vitest run --coverage",
+		"test:package": "node tests/consumer.mjs",
+		"prepack": "pnpm run build",
+		"test": "pnpm run test:unit"
+	},
+	dependencies: {
+		"@swiftuijs/twill": "workspace:*",
+		"@typescript-eslint/parser": "^8.71.0",
+		"@typescript-eslint/eslint-plugin": "^8.71.0",
+		"@eslint/js": "catalog:",
+		"typescript": "catalog:"
+	},
+	devDependencies: {
+		"vite": "catalog:",
+		"vite-plugin-dts": "^5.1.2",
+		"@types/node": "catalog:",
+		"typescript": "catalog:",
+		"eslint": "catalog:",
+		"vitest": "catalog:",
+		"@vitest/coverage-v8": "catalog:"
+	},
+	engines: { "node": "^20.19.0 || >=22.12.0" },
+	publishConfig: { "access": "public" },
+	peerDependencies: { "eslint": "^9.0.0 || ^10.0.0" },
+	author: {
+		"name": "forth.ink",
+		"url": "https://forth.ink"
+	},
+	homepage: "https://twill.evecalm.com/",
+	bugs: { "url": "https://github.com/swiftuijs/twill/issues" },
+	keywords: [
+		"twill",
+		"eslint",
+		"eslint-plugin",
+		"typescript",
+		"linter"
+	],
+	description: "ESLint flat configurations for Twill with TypeScript rules, original-source diagnostics and safe fixes."
+};
+//#endregion
+//#region src/positions.ts
+/** Source-map lines use LF; ESLint positions also count CR and Unicode separators. */
+var SourcePositions = class {
+	native = [0];
+	mapped = [0];
+	constructor(text) {
+		const breaks = /\r\n|[\n\r\u2028\u2029]/g;
+		while (breaks.exec(text)) this.native.push(breaks.lastIndex);
+		for (let index = 0; index < text.length; index++) if (text[index] === "\n") this.mapped.push(index + 1);
+	}
+	position(starts, offset) {
+		let low = 0;
+		let high = starts.length;
+		while (low + 1 < high) {
+			const middle = low + high >>> 1;
+			if (starts[middle] <= offset) low = middle;
+			else high = middle;
+		}
+		return {
+			line: low,
+			character: offset - starts[low]
+		};
+	}
+	getLineAndCharacterOfPosition(offset) {
+		return this.position(this.native, offset);
+	}
+	getPositionOfLineAndCharacter(line, column) {
+		return this.native[line] + column;
+	}
+	mapPosition(offset) {
+		const position = this.position(this.mapped, offset);
+		return {
+			line: position.line + 1,
+			column: position.character
+		};
+	}
+	mapOffset(line, column) {
+		return this.mapped[line - 1] + column;
+	}
+};
+//#endregion
+//#region src/index.ts
+var pending = /* @__PURE__ */ new Map();
+var projects = /* @__PURE__ */ new Map();
+var normalize = (filename) => filename.replaceAll("\\", "/");
+var stamp = (filename) => {
+	try {
+		return statSync(filename).mtimeMs;
+	} catch {
+		return -1;
+	}
+};
+function projectFor(filename) {
+	const config = ts.findConfigFile(dirname(filename), ts.sys.fileExists);
+	if (!config) throw new Error("Typed Twill linting requires a tsconfig.json.");
+	let cached = projects.get(config);
+	if (cached && cached.project.configFiles.some((file) => cached.times.get(file) !== stamp(file))) {
+		cached.project.dispose();
+		projects.delete(config);
+		cached = void 0;
+	}
+	if (!cached) {
+		cached = {
+			project: new TwillProject(config),
+			times: /* @__PURE__ */ new Map()
+		};
+		for (const file of cached.project.configFiles) cached.times.set(file, stamp(file));
+		if (projects.size >= 8) {
+			const oldest = projects.keys().next().value;
+			projects.get(oldest).project.dispose();
+			projects.delete(oldest);
+		}
+		projects.set(config, cached);
+	}
+	for (const file of cached.project.sourceFiles()) {
+		const time = stamp(file);
+		if (cached.times.has(file) && cached.times.get(file) !== time) cached.project.refresh(file);
+		cached.times.set(file, time);
+	}
+	return cached.project;
+}
+function originalOffset(state, offset) {
+	const position = state.generated.mapPosition(offset);
+	const point = originalPosition(state.result, position.line, position.column);
+	return point.line == null || point.column == null ? void 0 : state.original.mapOffset(point.line, point.column);
+}
+function fix(state, value) {
+	if (!value) return void 0;
+	const [start, end] = value.range;
+	const offset = originalOffset(state, start);
+	if (offset === void 0) return void 0;
+	const position = state.original.mapPosition(offset);
+	const generated = generatedPosition(state.result, position.line, position.column);
+	if (generated.line == null || generated.column == null || state.generated.mapOffset(generated.line, generated.column) !== start || state.source.slice(offset, offset + end - start) !== state.result.code.slice(start, end)) return void 0;
+	return {
+		range: [offset, offset + end - start],
+		text: value.text
+	};
+}
+var processor = {
+	supportsAutofix: true,
+	preprocess(source, filename) {
+		filename = normalize(filename);
+		const state = {
+			source,
+			filename,
+			original: new SourcePositions(source)
+		};
+		pending.set(filename, state);
+		try {
+			const config = ts.findConfigFile(dirname(filename), ts.sys.fileExists);
+			state.result = transform(source, {
+				...loadConfig(config ? dirname(config) : dirname(filename)),
+				filename
+			});
+			state.generated = new SourcePositions(state.result.code);
+			return [{
+				text: state.result.code,
+				filename: filename.endsWith(".twillx") ? "source.tsx" : "source.ts"
+			}];
+		} catch (error) {
+			state.error = error;
+			return [];
+		}
+	},
+	postprocess(lists, filename) {
+		filename = normalize(filename);
+		const state = pending.get(filename);
+		pending.delete(filename);
+		state.project?.update(filename);
+		if (state.error) return [{
+			ruleId: null,
+			severity: 2,
+			fatal: true,
+			message: state.error.message,
+			line: state.error.line ?? 1,
+			column: (state.error.column ?? 0) + 1
+		}];
+		return lists.flat().flatMap((message) => {
+			if (!message.line || !message.column) return [message];
+			const generated = state.generated;
+			const start = generated.getPositionOfLineAndCharacter(message.line - 1, message.column - 1);
+			let offset = originalOffset(state, start);
+			let expressionSwitch = false;
+			if (message.ruleId === "@typescript-eslint/switch-exhaustiveness-check" && state.project && (offset === void 0 || state.result.code[start] !== state.source[offset])) {
+				const file = state.project.service.getProgram()?.getSourceFile(virtualFilename(filename));
+				const visit = (node) => {
+					if (ts.isSwitchStatement(node) && node.expression.getStart() === start) {
+						const sourceStart = originalOffset(state, node.getStart());
+						if (sourceStart !== void 0 && state.source.slice(sourceStart, sourceStart + 6) === "switch") {
+							offset = sourceStart;
+							expressionSwitch = true;
+						}
+					} else if (start >= node.getFullStart() && start < node.end) ts.forEachChild(node, visit);
+				};
+				if (file) visit(file);
+			}
+			if (offset === void 0 || !expressionSwitch && start < state.result.code.length && state.result.code[start] !== state.source[offset]) return [];
+			const position = state.original.getLineAndCharacterOfPosition(offset);
+			const endOffset = expressionSwitch ? offset + 6 : message.endLine && message.endColumn ? originalOffset(state, generated.getPositionOfLineAndCharacter(message.endLine - 1, message.endColumn - 1)) : void 0;
+			const end = endOffset === void 0 ? void 0 : state.original.getLineAndCharacterOfPosition(endOffset);
+			return [{
+				...message,
+				line: position.line + 1,
+				column: position.character + 1,
+				endLine: end && end.line + 1,
+				endColumn: end && end.character + 1,
+				fix: fix(state, message.fix),
+				suggestions: message.suggestions?.flatMap((suggestion) => {
+					const mapped = fix(state, suggestion.fix);
+					return mapped ? [{
+						...suggestion,
+						fix: mapped
+					}] : [];
+				})
+			}];
+		});
+	}
+};
+var virtualParser = {
+	meta: {
+		name: "@swiftuijs/twill-linter/parser",
+		version: package_default.version
+	},
+	parseForESLint(code, options) {
+		const original = normalize(options.filePath ?? "").replace(/\/(?:\d+_)?source\.tsx?$/, "");
+		const state = pending.get(original);
+		if (!state) return parser.parseForESLint(code, options);
+		if (!(options.projectService || options.project || options.programs)) return parser.parseForESLint(code, options);
+		const project = projectFor(original);
+		project.update(original, state.source);
+		state.project = project;
+		return parser.parseForESLint(code, {
+			...options,
+			filePath: virtualFilename(original),
+			projectService: false,
+			project: void 0,
+			programs: [project.service.getProgram()]
+		});
+	}
+};
+var plugin = {
+	meta: {
+		name: "@swiftuijs/twill-linter",
+		version: package_default.version
+	},
+	processors: { twill: processor },
+	configs: {}
+};
+var files = [
+	"**/*.ts",
+	"**/*.tsx",
+	"**/*.mts",
+	"**/*.cts"
+];
+function configuration(typed) {
+	const recommended = typescriptPlugin.configs[typed ? "flat/recommended-type-checked" : "flat/recommended"];
+	return [
+		js.configs.recommended,
+		{
+			files: ["**/*.twill", "**/*.twillx"],
+			plugins: { twill: plugin },
+			processor: "twill/twill"
+		},
+		...recommended.map((config) => ({
+			...config,
+			files,
+			languageOptions: {
+				...config.languageOptions,
+				parser: virtualParser,
+				...typed ? { parserOptions: { projectService: true } } : {}
+			}
+		})),
+		...typed ? [{
+			files,
+			rules: { "@typescript-eslint/switch-exhaustiveness-check": ["error", { considerDefaultExhaustiveForUnions: false }] }
+		}] : []
+	];
+}
+plugin.configs.recommended = configuration(false);
+plugin.configs.recommendedTypeChecked = configuration(true);
+var configs = plugin.configs;
+var processors = { twill: processor };
+function disposeProjects() {
+	for (const { project } of projects.values()) project.dispose();
+	projects.clear();
+	pending.clear();
+}
+//#endregion
+export { configs, plugin as default, disposeProjects, processors };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["files","metadata"],"sources":["../package.json","../src/positions.ts","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@swiftuijs/twill-linter\",\n  \"version\": \"0.1.1\",\n  \"type\": \"module\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/swiftuijs/twill.git\",\n    \"directory\": \"packages/linter\"\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"LICENSE\"\n  ],\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"vite build\",\n    \"typecheck\": \"tsc --noEmit -p tsconfig.json\",\n    \"test:unit\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage\",\n    \"test:package\": \"node tests/consumer.mjs\",\n    \"prepack\": \"pnpm run build\",\n    \"test\": \"pnpm run test:unit\"\n  },\n  \"dependencies\": {\n    \"@swiftuijs/twill\": \"workspace:*\",\n    \"@typescript-eslint/parser\": \"^8.71.0\",\n    \"@typescript-eslint/eslint-plugin\": \"^8.71.0\",\n    \"@eslint/js\": \"catalog:\",\n    \"typescript\": \"catalog:\"\n  },\n  \"devDependencies\": {\n    \"vite\": \"catalog:\",\n    \"vite-plugin-dts\": \"^5.1.2\",\n    \"@types/node\": \"catalog:\",\n    \"typescript\": \"catalog:\",\n    \"eslint\": \"catalog:\",\n    \"vitest\": \"catalog:\",\n    \"@vitest/coverage-v8\": \"catalog:\"\n  },\n  \"engines\": {\n    \"node\": \"^20.19.0 || >=22.12.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"peerDependencies\": {\n    \"eslint\": \"^9.0.0 || ^10.0.0\"\n  },\n  \"author\": {\n    \"name\": \"forth.ink\",\n    \"url\": \"https://forth.ink\"\n  },\n  \"homepage\": \"https://twill.evecalm.com/\",\n  \"bugs\": {\n    \"url\": \"https://github.com/swiftuijs/twill/issues\"\n  },\n  \"keywords\": [\n    \"twill\",\n    \"eslint\",\n    \"eslint-plugin\",\n    \"typescript\",\n    \"linter\"\n  ],\n  \"description\": \"ESLint flat configurations for Twill with TypeScript rules, original-source diagnostics and safe fixes.\"\n}\n","/** Source-map lines use LF; ESLint positions also count CR and Unicode separators. */\nexport class SourcePositions {\n  private native = [0];\n  private mapped = [0];\n\n  constructor(text: string) {\n    const breaks = /\\r\\n|[\\n\\r\\u2028\\u2029]/g;\n    while (breaks.exec(text)) this.native.push(breaks.lastIndex);\n    for (let index = 0; index < text.length; index++)\n      if (text[index] === '\\n') this.mapped.push(index + 1);\n  }\n\n  private position(starts: number[], offset: number) {\n    let low = 0;\n    let high = starts.length;\n    while (low + 1 < high) {\n      const middle = (low + high) >>> 1;\n      if (starts[middle]! <= offset) low = middle;\n      else high = middle;\n    }\n    return { line: low, character: offset - starts[low]! };\n  }\n\n  getLineAndCharacterOfPosition(offset: number) {\n    return this.position(this.native, offset);\n  }\n\n  getPositionOfLineAndCharacter(line: number, column: number) {\n    return this.native[line]! + column;\n  }\n\n  mapPosition(offset: number) {\n    const position = this.position(this.mapped, offset);\n    return { line: position.line + 1, column: position.character };\n  }\n\n  mapOffset(line: number, column: number) {\n    return this.mapped[line - 1]! + column;\n  }\n}\n","import {\n  transform,\n  originalPosition,\n  generatedPosition,\n  type TransformResult,\n} from '@swiftuijs/twill';\nimport { TwillProject, virtualFilename, sourceFilename } from '@swiftuijs/twill/project';\nimport * as parser from '@typescript-eslint/parser';\nimport typescriptPlugin from '@typescript-eslint/eslint-plugin';\nimport js from '@eslint/js';\nimport ts from 'typescript';\nimport { loadConfig } from '@swiftuijs/twill/config';\nimport { dirname, resolve } from 'node:path';\nimport { statSync } from 'node:fs';\nimport type { ESLint, Linter, Rule } from 'eslint';\nimport metadata from '../package.json' with { type: 'json' };\nimport { SourcePositions } from './positions.js';\n\ntype State = {\n  source: string;\n  filename: string;\n  result?: TransformResult;\n  error?: any;\n  original: SourcePositions;\n  generated?: SourcePositions;\n  project?: TwillProject;\n};\nconst pending = new Map<string, State>();\nconst projects = new Map<string, { project: TwillProject; times: Map<string, number> }>();\nconst normalize = (filename: string) => filename.replaceAll('\\\\', '/');\nconst stamp = (filename: string) => {\n  try {\n    return statSync(filename).mtimeMs;\n  } catch {\n    return -1;\n  }\n};\n\nfunction projectFor(filename: string) {\n  const config = ts.findConfigFile(dirname(filename), ts.sys.fileExists);\n  if (!config) throw new Error('Typed Twill linting requires a tsconfig.json.');\n  let cached = projects.get(config);\n  if (\n    cached &&\n    cached.project.configFiles.some((file) => cached!.times.get(file) !== stamp(file))\n  ) {\n    cached.project.dispose();\n    projects.delete(config);\n    cached = undefined;\n  }\n  if (!cached) {\n    cached = { project: new TwillProject(config), times: new Map() };\n    for (const file of cached.project.configFiles) cached.times.set(file, stamp(file));\n    if (projects.size >= 8) {\n      const oldest = projects.keys().next().value!;\n      projects.get(oldest)!.project.dispose();\n      projects.delete(oldest);\n    }\n    projects.set(config, cached);\n  }\n  for (const file of cached.project.sourceFiles()) {\n    const time = stamp(file);\n    if (cached.times.has(file) && cached.times.get(file) !== time) cached.project.refresh(file);\n    cached.times.set(file, time);\n  }\n  return cached.project;\n}\n\nfunction originalOffset(state: State, offset: number) {\n  const position = state.generated!.mapPosition(offset);\n  const point = originalPosition(state.result!, position.line, position.column);\n  return point.line == null || point.column == null\n    ? undefined\n    : state.original.mapOffset(point.line, point.column);\n}\nfunction fix(state: State, value: Rule.Fix | undefined): Rule.Fix | undefined {\n  if (!value) return undefined;\n  const [start, end] = value.range;\n  const offset = originalOffset(state, start);\n  if (offset === undefined) return undefined;\n  const position = state.original.mapPosition(offset);\n  const generated = generatedPosition(state.result!, position.line, position.column);\n  if (\n    generated.line == null ||\n    generated.column == null ||\n    state.generated!.mapOffset(generated.line, generated.column) !== start ||\n    state.source.slice(offset, offset + end - start) !== state.result!.code.slice(start, end)\n  )\n    return undefined;\n  return { range: [offset, offset + end - start], text: value.text };\n}\n\nconst processor: Linter.Processor = {\n  supportsAutofix: true,\n  preprocess(source, filename) {\n    filename = normalize(filename);\n    const state: State = {\n      source,\n      filename,\n      original: new SourcePositions(source),\n    };\n    pending.set(filename, state);\n    try {\n      // A project supplies the same inherited JSX settings as builds/checking.\n      const config = ts.findConfigFile(dirname(filename), ts.sys.fileExists);\n      state.result = transform(source, {\n        ...loadConfig(config ? dirname(config) : dirname(filename)),\n        filename,\n      });\n      state.generated = new SourcePositions(state.result.code);\n      return [\n        {\n          text: state.result.code,\n          filename: filename.endsWith('.twillx') ? 'source.tsx' : 'source.ts',\n        },\n      ];\n    } catch (error) {\n      state.error = error;\n      return [];\n    }\n  },\n  postprocess(lists, filename) {\n    filename = normalize(filename);\n    const state = pending.get(filename)!;\n    pending.delete(filename);\n    state.project?.update(filename);\n    if (state.error)\n      return [\n        {\n          ruleId: null,\n          severity: 2,\n          fatal: true,\n          message: state.error.message,\n          line: state.error.line ?? 1,\n          column: (state.error.column ?? 0) + 1,\n        },\n      ];\n    return lists.flat().flatMap((message) => {\n      if (!message.line || !message.column) return [message];\n      const generated = state.generated!;\n      const start = generated.getPositionOfLineAndCharacter(message.line - 1, message.column - 1);\n      let offset = originalOffset(state, start);\n      let expressionSwitch = false;\n      if (\n        message.ruleId === '@typescript-eslint/switch-exhaustiveness-check' &&\n        state.project &&\n        (offset === undefined || state.result!.code[start] !== state.source[offset])\n      ) {\n        // Expression subjects use a generated once-evaluated local. Report the\n        // missing union arm on the source-backed switch keyword instead.\n        const file = state.project.service.getProgram()?.getSourceFile(virtualFilename(filename));\n        const visit = (node: ts.Node) => {\n          if (ts.isSwitchStatement(node) && node.expression.getStart() === start) {\n            const sourceStart = originalOffset(state, node.getStart());\n            if (\n              sourceStart !== undefined &&\n              state.source.slice(sourceStart, sourceStart + 6) === 'switch'\n            ) {\n              offset = sourceStart;\n              expressionSwitch = true;\n            }\n          } else if (start >= node.getFullStart() && start < node.end) ts.forEachChild(node, visit);\n        };\n        if (file) visit(file);\n      }\n      if (\n        offset === undefined ||\n        (!expressionSwitch &&\n          start < state.result!.code.length &&\n          state.result!.code[start] !== state.source[offset])\n      )\n        return [];\n      const position = state.original.getLineAndCharacterOfPosition(offset);\n      const endOffset = expressionSwitch\n        ? offset + 6\n        : message.endLine && message.endColumn\n          ? originalOffset(\n              state,\n              generated.getPositionOfLineAndCharacter(message.endLine - 1, message.endColumn - 1),\n            )\n          : undefined;\n      const end =\n        endOffset === undefined\n          ? undefined\n          : state.original.getLineAndCharacterOfPosition(endOffset);\n      return [\n        {\n          ...message,\n          line: position.line + 1,\n          column: position.character + 1,\n          endLine: end && end.line + 1,\n          endColumn: end && end.character + 1,\n          fix: fix(state, message.fix),\n          suggestions: message.suggestions?.flatMap((suggestion) => {\n            const mapped = fix(state, suggestion.fix);\n            return mapped ? [{ ...suggestion, fix: mapped }] : [];\n          }),\n        },\n      ];\n    });\n  },\n};\n\nconst virtualParser = {\n  meta: { name: '@swiftuijs/twill-linter/parser', version: metadata.version },\n  parseForESLint(code: string, options: any) {\n    const original = normalize(options.filePath ?? '').replace(/\\/(?:\\d+_)?source\\.tsx?$/, '');\n    const state = pending.get(original);\n    if (!state) return parser.parseForESLint(code, options);\n    const typed = options.projectService || options.project || options.programs;\n    if (!typed) return parser.parseForESLint(code, options);\n    const project = projectFor(original);\n    project.update(original, state.source);\n    state.project = project;\n    return parser.parseForESLint(code, {\n      ...options,\n      filePath: virtualFilename(original),\n      projectService: false,\n      project: undefined,\n      programs: [project.service.getProgram()!],\n    });\n  },\n};\n\nconst plugin: ESLint.Plugin & { configs: Record<string, Linter.Config[]> } = {\n  meta: { name: '@swiftuijs/twill-linter', version: metadata.version },\n  processors: { twill: processor },\n  configs: {} as Record<string, Linter.Config[]>,\n};\nconst files = ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'];\nfunction configuration(typed: boolean): Linter.Config[] {\n  const recommended = typescriptPlugin.configs[\n    typed ? 'flat/recommended-type-checked' : 'flat/recommended'\n  ] as Linter.Config[];\n  return [\n    js.configs.recommended,\n    { files: ['**/*.twill', '**/*.twillx'], plugins: { twill: plugin }, processor: 'twill/twill' },\n    ...recommended.map((config) => ({\n      ...config,\n      files,\n      languageOptions: {\n        ...config.languageOptions,\n        parser: virtualParser,\n        ...(typed ? { parserOptions: { projectService: true } } : {}),\n      },\n    })),\n    ...(typed\n      ? [\n          {\n            files,\n            rules: {\n              '@typescript-eslint/switch-exhaustiveness-check': [\n                'error',\n                { considerDefaultExhaustiveForUnions: false },\n              ] satisfies Linter.RuleEntry,\n            },\n          },\n        ]\n      : []),\n  ];\n}\nplugin.configs.recommended = configuration(false);\nplugin.configs.recommendedTypeChecked = configuration(true);\nexport const configs: Record<string, Linter.Config[]> = plugin.configs;\nexport const processors: Record<string, Linter.Processor> = { twill: processor };\nexport function disposeProjects() {\n  for (const { project } of projects.values()) project.dispose();\n  projects.clear();\n  pending.clear();\n}\nexport default plugin;\n"],"mappings":"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"}

package/dist/positions.d.ts

@@ -0,0 +1,17 @@
+/** Source-map lines use LF; ESLint positions also count CR and Unicode separators. */
+export declare class SourcePositions {
+    private native;
+    private mapped;
+    constructor(text: string);
+    private position;
+    getLineAndCharacterOfPosition(offset: number): {
+        line: number;
+        character: number;
+    };
+    getPositionOfLineAndCharacter(line: number, column: number): number;
+    mapPosition(offset: number): {
+        line: number;
+        column: number;
+    };
+    mapOffset(line: number, column: number): number;
+}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@swiftuijs/twill-linter",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swiftuijs/twill.git",
+    "directory": "packages/linter"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@typescript-eslint/parser": "^8.71.0",
+    "@typescript-eslint/eslint-plugin": "^8.71.0",
+    "@eslint/js": "^9.39.5",
+    "typescript": "5.9.3",
+    "@swiftuijs/twill": "0.1.1"
+  },
+  "devDependencies": {
+    "vite": "^8.3.2",
+    "vite-plugin-dts": "^5.1.2",
+    "@types/node": "^26.6.4",
+    "typescript": "5.9.3",
+    "eslint": "^10.12.0",
+    "vitest": "^5.0.3",
+    "@vitest/coverage-v8": "^5.0.3"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0 || ^10.0.0"
+  },
+  "author": {
+    "name": "forth.ink",
+    "url": "https://forth.ink"
+  },
+  "homepage": "https://twill.evecalm.com/",
+  "bugs": {
+    "url": "https://github.com/swiftuijs/twill/issues"
+  },
+  "keywords": [
+    "twill",
+    "eslint",
+    "eslint-plugin",
+    "typescript",
+    "linter"
+  ],
+  "description": "ESLint flat configurations for Twill with TypeScript rules, original-source diagnostics and safe fixes.",
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test:unit": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:package": "node tests/consumer.mjs",
+    "test": "pnpm run test:unit"
+  }
 }