oxlint-plugin-vize 0.271.0 → 0.272.1

package/README.md

@@ -75,13 +75,14 @@ export default {
     vize: {
       helpLevel: "short",
       preset: "opinionated",
+      typeAware: true,
     },
   },
-  rules: configs.opinionated,
+  rules: configs.opinionatedWithTypeAware,
 };
 ```
 
-`configs.recommended`, `configs.essential`, `configs.ecosystem`, `configs.opinionated`, `configs.nuxt`, and `configs.all` intentionally skip Vize's unstable type-aware rules for now. If you explicitly want those experimental rules too, use `configs.recommendedWithTypeAware`, `configs.ecosystemWithTypeAware`, `configs.opinionatedWithTypeAware`, or `createVizeRuleConfig({ includeTypeAware: true, preset: ... })`.
+`configs.recommended`, `configs.essential`, `configs.ecosystem`, `configs.opinionated`, `configs.nuxt`, and `configs.all` intentionally skip Vize's unstable type-aware rules for now. If you explicitly want those experimental rules too, use `configs.recommendedWithTypeAware`, `configs.ecosystemWithTypeAware`, `configs.opinionatedWithTypeAware`, or `createVizeRuleConfig({ includeTypeAware: true, preset: ... })`. Set `settings.vize.typeAware: true` to run the shared full-file Patina pass with Corsa enabled; explicitly configured `vize/type/*` rules also opt in when they are queried one by one.
 
 You can pass Patina settings through `settings.vize`:
 
@@ -91,7 +92,9 @@ You can pass Patina settings through `settings.vize`:
     "vize": {
       "locale": "ja",
       "preset": "essential",
-      "helpLevel": "short"
+      "helpLevel": "short",
+      "typeAware": true,
+      "corsaPath": "./node_modules/.bin/tsgo"
     }
   }
 }
@@ -106,6 +109,8 @@ You can pass Patina settings through `settings.vize`:
 - Legacy aliases such as `"GeneralRecommended"`, `"Essential"`, `"Ecosystem"`, `"Incremental"`, `"Opinionated"`, `"Nuxt"`, and `"happy-path"` are still accepted for compatibility.
 - `helpLevel` accepts `"full"`, `"short"`, or `"none"`.
 - `helpLevel: "full"` only expands the Patina remediation text. It does not restore original-SFC formatter anchors or machine-readable range fidelity.
+- `typeAware: true` enables Corsa-backed `vize/type/*` rules during shared Patina passes.
+- `corsaPath` selects the Corsa or `tsgo` executable for type-aware linting. Omit it to use Vize's normal resolver.
 - `showHelp` is still accepted for backward compatibility, but `helpLevel` is the preferred setting.
 
 For example, this keeps Oxlint focused on correctness-only Vize diagnostics while still allowing your existing Oxlint rules to run unchanged:
@@ -145,7 +150,7 @@ vp exec oxlint-vize -c .oxlintrc.json -f stylish src
 - Formatter parity is not there yet. `stylish` is recommended for human-readable terminal output, while `json` and other machine-readable outputs are best treated as debugging aids for original template/style positions.
 - Oxlint core rules that need JavaScript bindings extracted from Vue templates, such as template-aware unused-variable checks, still depend on upstream work in [Oxc's Better Vue Support](https://github.com/oxc-project/oxc/issues/15761).
 - Vize's own SFC diagnostics can run through the plugin, but precise original-SFC ranges across all Oxlint formatters depend on the JS plugin reporting work tracked in [oxc-project/oxc#20465](https://github.com/oxc-project/oxc/issues/20465).
-- Type-aware Vize rules are experimental and excluded from the default exported configs. Opt into them explicitly with `configs.recommendedWithTypeAware`, `configs.opinionatedWithTypeAware`, or `createVizeRuleConfig({ includeTypeAware: true, preset: ... })`.
+- Type-aware Vize rules are experimental and excluded from the default exported configs. Opt into them explicitly with `configs.recommendedWithTypeAware`, `configs.opinionatedWithTypeAware`, or `createVizeRuleConfig({ includeTypeAware: true, preset: ... })`, and use `settings.vize.typeAware: true` when you want the shared full-file pass to run them eagerly.
 
 ## Current expectations
 

package/dist/index.mjs

@@ -101,7 +101,9 @@ function lintPatina(source, filename, settings, enabledRules) {
 		locale: settings.locale,
 		helpLevel: settings.helpLevel,
 		preset: settings.preset,
-		enabledRules: enabledRules ? [...enabledRules] : void 0
+		enabledRules: enabledRules ? [...enabledRules] : void 0,
+		typeAware: settings.typeAware,
+		corsaPath: settings.corsaPath
 	});
 }
 function getPatinaRules() {
@@ -142,6 +144,7 @@ const HELP_LEVELS = new Set([
 	"short",
 	"full"
 ]);
+const TYPE_AWARE_RULE_PREFIX$1 = "type/";
 const PRESET_ALIASES = new Map([
 	["generalrecommended", "general-recommended"],
 	["happypath", "general-recommended"],
@@ -172,12 +175,16 @@ function parseVizeSettings(vize) {
 	const helpLevel = vizeRecord.helpLevel;
 	const preset = vizeRecord.preset;
 	const showHelp = vizeRecord.showHelp;
+	const typeAware = vizeRecord.typeAware;
+	const corsaPath = vizeRecord.corsaPath;
 	const resolved = {};
 	if (typeof locale === "string") resolved.locale = locale;
 	if (typeof preset === "string") {
 		const normalizedPreset = normalizePreset(preset);
 		if (normalizedPreset) resolved.preset = normalizedPreset;
 	}
+	if (typeof typeAware === "boolean") resolved.typeAware = typeAware;
+	if (typeof corsaPath === "string") resolved.corsaPath = corsaPath;
 	if (typeof helpLevel === "string" && HELP_LEVELS.has(helpLevel)) {
 		resolved.helpLevel = helpLevel;
 		return resolved;
@@ -192,7 +199,17 @@ function isIncrementalPreset(settings) {
 	return getActivePreset(settings) === "incremental";
 }
 function getCacheKey(filename, settings) {
-	return `${filename}::${settings.locale ?? ""}::${settings.helpLevel ?? ""}::${getActivePreset(settings)}`;
+	return [
+		filename,
+		settings.locale ?? "",
+		settings.helpLevel ?? "",
+		getActivePreset(settings),
+		settings.typeAware ? "type-aware" : "",
+		settings.corsaPath ?? ""
+	].join("::");
+}
+function isTypeAwareRuleName(ruleName) {
+	return ruleName.startsWith(TYPE_AWARE_RULE_PREFIX$1);
 }
 function normalizePreset(value) {
 	return PRESET_ALIASES.get(value.replaceAll(/[-_\s]/gu, "").toLowerCase());
@@ -200,15 +217,19 @@ function normalizePreset(value) {
 if (import.meta.vitest) {
 	const { describe, expect, it } = import.meta.vitest;
 	describe("parseVizeSettings", () => {
-		it("reads locale, help level, and preset", () => {
+		it("reads locale, help level, preset, and type-aware settings", () => {
 			expect(parseVizeSettings({
 				locale: "ja",
 				helpLevel: "short",
-				preset: "essential"
+				preset: "essential",
+				typeAware: true,
+				corsaPath: "./node_modules/.bin/tsgo"
 			})).toEqual({
 				locale: "ja",
 				helpLevel: "short",
-				preset: "essential"
+				preset: "essential",
+				typeAware: true,
+				corsaPath: "./node_modules/.bin/tsgo"
 			});
 		});
 		it("normalizes preset aliases", () => {
@@ -234,7 +255,9 @@ if (import.meta.vitest) {
 				locale: 1,
 				showHelp: "no",
 				helpLevel: "verbose",
-				preset: "wide"
+				preset: "wide",
+				typeAware: "yes",
+				corsaPath: false
 			})).toEqual({});
 		});
 		it("ignores non-object vize settings", () => {
@@ -247,6 +270,7 @@ if (import.meta.vitest) {
 //#region src/file-state.ts
 const fileStateCache = /* @__PURE__ */ new Map();
 const EMPTY_DIAGNOSTICS = [];
+const TYPE_AWARE_RUNTIME_RULE = "type/corsa-runtime";
 function getFileState(context) {
 	const settings = getVizeSettings(context);
 	const resolvedSource = resolveWorkaroundSource(fs.readFileSync(context.physicalFilename, "utf8"), context.physicalFilename);
@@ -262,35 +286,56 @@ function getFileState(context) {
 		sfcBlocks: void 0,
 		scriptMap: void 0,
 		allDiagnosticsByRule: null,
+		allDiagnosticsIncludesTypeAware: false,
 		partialDiagnosticsByRule: /* @__PURE__ */ new Map(),
-		requestedRules: /* @__PURE__ */ new Set()
+		requestedRules: /* @__PURE__ */ new Set(),
+		reportedTypeAwareRuntimeDiagnostic: false
 	};
 	fileStateCache.set(cacheKey, state);
 	return state;
 }
 function getDiagnosticsForRule(context, state, ruleName) {
-	if (state.allDiagnosticsByRule) return state.allDiagnosticsByRule.get(ruleName) ?? EMPTY_DIAGNOSTICS;
+	if (state.allDiagnosticsByRule) {
+		if (isTypeAwareRuleName(ruleName) && !state.allDiagnosticsIncludesTypeAware) {
+			const settings = getVizeSettings(context);
+			state.allDiagnosticsByRule = indexDiagnosticsByRule(lintPatina(state.source, state.filename, {
+				...settings,
+				typeAware: true
+			}).diagnostics);
+			state.allDiagnosticsIncludesTypeAware = true;
+		}
+		return diagnosticsForRule(state, state.allDiagnosticsByRule, ruleName);
+	}
 	const cached = state.partialDiagnosticsByRule.get(ruleName);
 	if (cached) return cached;
 	const settings = getVizeSettings(context);
+	const ruleSettings = isTypeAwareRuleName(ruleName) ? {
+		...settings,
+		typeAware: true
+	} : settings;
 	if (isIncrementalPreset(settings)) {
-		const diagnostics = lintPatina(state.source, state.filename, settings, [ruleName]).diagnostics;
-		const ruleDiagnostics = indexDiagnosticsByRule(diagnostics).get(ruleName) ?? EMPTY_DIAGNOSTICS;
+		const diagnostics = lintPatina(state.source, state.filename, ruleSettings, [ruleName]).diagnostics;
+		const ruleDiagnostics = diagnosticsForRule(state, indexDiagnosticsByRule(diagnostics), ruleName);
 		state.partialDiagnosticsByRule.set(ruleName, ruleDiagnostics);
 		return ruleDiagnostics;
 	}
 	if (state.requestedRules.size === 0) {
 		state.requestedRules.add(ruleName);
-		const diagnostics = lintPatina(state.source, state.filename, settings, [ruleName]).diagnostics;
-		const ruleDiagnostics = indexDiagnosticsByRule(diagnostics).get(ruleName) ?? EMPTY_DIAGNOSTICS;
+		const diagnostics = lintPatina(state.source, state.filename, ruleSettings, [ruleName]).diagnostics;
+		const ruleDiagnostics = diagnosticsForRule(state, indexDiagnosticsByRule(diagnostics), ruleName);
 		state.partialDiagnosticsByRule.set(ruleName, ruleDiagnostics);
 		return ruleDiagnostics;
 	}
 	state.requestedRules.add(ruleName);
-	const allDiagnostics = lintPatina(state.source, state.filename, settings).diagnostics;
+	const fullPassTypeAware = settings.typeAware === true || Array.from(state.requestedRules).some(isTypeAwareRuleName);
+	const allDiagnostics = lintPatina(state.source, state.filename, {
+		...settings,
+		typeAware: fullPassTypeAware
+	}).diagnostics;
 	state.allDiagnosticsByRule = indexDiagnosticsByRule(allDiagnostics);
+	state.allDiagnosticsIncludesTypeAware = fullPassTypeAware;
 	state.partialDiagnosticsByRule.clear();
-	return state.allDiagnosticsByRule.get(ruleName) ?? EMPTY_DIAGNOSTICS;
+	return diagnosticsForRule(state, state.allDiagnosticsByRule, ruleName);
 }
 function getScriptMap(state) {
 	if (state.scriptMap !== void 0) return state.scriptMap;
@@ -319,6 +364,15 @@ function indexDiagnosticsByRule(diagnostics) {
 	}
 	return grouped;
 }
+function diagnosticsForRule(state, diagnosticsByRule, ruleName) {
+	const directDiagnostics = diagnosticsByRule.get(ruleName);
+	if (directDiagnostics && directDiagnostics.length > 0) return directDiagnostics;
+	if (!isTypeAwareRuleName(ruleName) || state.reportedTypeAwareRuntimeDiagnostic) return EMPTY_DIAGNOSTICS;
+	const runtimeDiagnostics = diagnosticsByRule.get(TYPE_AWARE_RUNTIME_RULE);
+	if (!runtimeDiagnostics || runtimeDiagnostics.length === 0) return EMPTY_DIAGNOSTICS;
+	state.reportedTypeAwareRuntimeDiagnostic = true;
+	return runtimeDiagnostics;
+}
 //#endregion
 //#region src/format.ts
 const helpTextCache = /* @__PURE__ */ new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxlint-plugin-vize",
-  "version": "0.271.0",
+  "version": "0.272.1",
   "description": "Oxlint JS plugin bridge for Vize Patina",
   "keywords": [
     "lint",
@@ -44,21 +44,21 @@
   "devDependencies": {
     "@tsdown/css": "0.22.0",
     "@types/node": "25.9.2",
-    "@vizejs/native": "0.271.0",
+    "@vizejs/native": "0.272.1",
     "tsdown": "0.22.0",
     "typescript": "6.0.3",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.1.21",
     "vite-plus": "0.1.21"
   },
   "optionalDependencies": {
-    "@vizejs/native-darwin-arm64": "0.271.0",
-    "@vizejs/native-darwin-x64": "0.271.0",
-    "@vizejs/native-linux-arm64-gnu": "0.271.0",
-    "@vizejs/native-linux-arm64-musl": "0.271.0",
-    "@vizejs/native-linux-x64-gnu": "0.271.0",
-    "@vizejs/native-linux-x64-musl": "0.271.0",
-    "@vizejs/native-win32-arm64-msvc": "0.271.0",
-    "@vizejs/native-win32-x64-msvc": "0.271.0"
+    "@vizejs/native-darwin-arm64": "0.272.1",
+    "@vizejs/native-darwin-x64": "0.272.1",
+    "@vizejs/native-linux-arm64-gnu": "0.272.1",
+    "@vizejs/native-linux-arm64-musl": "0.272.1",
+    "@vizejs/native-linux-x64-gnu": "0.272.1",
+    "@vizejs/native-linux-x64-musl": "0.272.1",
+    "@vizejs/native-win32-arm64-msvc": "0.272.1",
+    "@vizejs/native-win32-x64-msvc": "0.272.1"
   },
   "engines": {
     "node": "^22 || >= 24"