@jesscss/lint 2.0.0-alpha.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Matthew Dean
+
+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/lib/index.cjs

@@ -0,0 +1,331 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+let glob = require("glob");
+let _jesscss_diagnostics_core = require("@jesscss/diagnostics-core");
+let styles_config = require("styles-config");
+//#region src/rules.ts
+const PARSE_SYNTAX_ERROR_CODE = "parse/syntax-error";
+const STABLE_LINT_RULE_SET_VERSION = 1;
+const RECOMMENDED_DIAGNOSTICS = {
+	[PARSE_SYNTAX_ERROR_CODE]: "error",
+	[_jesscss_diagnostics_core.LINT_CODES.emptyRules]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.unknownProperties]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.unknownAtRules]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.duplicateProperties]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.hexColorLength]: "error",
+	[_jesscss_diagnostics_core.LINT_CODES.zeroUnits]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.unsupportedSassForm]: "warn"
+};
+const COMPARISON_DIAGNOSTICS = {
+	[_jesscss_diagnostics_core.LINT_CODES.emptyRules]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.unknownProperties]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.unknownAtRules]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.duplicateProperties]: "warn",
+	[_jesscss_diagnostics_core.LINT_CODES.hexColorLength]: "error",
+	[_jesscss_diagnostics_core.LINT_CODES.zeroUnits]: "warn"
+};
+const STABLE_LINT_RULES = [
+	{
+		code: PARSE_SYNTAX_ERROR_CODE,
+		title: "Syntax error",
+		tier: "syntax",
+		defaultPolicy: "error",
+		comparison: "jess-only",
+		notes: "Parser diagnostic surfaced through lint policy; Stylelint reports parser errors through its own parser path."
+	},
+	{
+		code: _jesscss_diagnostics_core.LINT_CODES.emptyRules,
+		title: "Empty rules",
+		tier: "maintainability",
+		defaultPolicy: "warn",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "block-no-empty",
+		notes: "Flags empty qualified rules after Jess dialect parsing."
+	},
+	{
+		code: _jesscss_diagnostics_core.LINT_CODES.unknownProperties,
+		title: "Unknown properties",
+		tier: "css-validity",
+		defaultPolicy: "warn",
+		comparison: "stylelint-near",
+		stylelintRule: "property-no-unknown",
+		notes: "Uses Jess language metadata and suppresses dialect variables, custom properties, vendor-prefixed properties, and interpolated names."
+	},
+	{
+		code: _jesscss_diagnostics_core.LINT_CODES.unknownAtRules,
+		title: "Unknown at-rules",
+		tier: "css-validity",
+		defaultPolicy: "warn",
+		comparison: "stylelint-near",
+		stylelintRule: "at-rule-no-unknown",
+		notes: "Uses Jess language metadata plus dialect at-rule allow-lists."
+	},
+	{
+		code: _jesscss_diagnostics_core.LINT_CODES.duplicateProperties,
+		title: "Duplicate properties",
+		tier: "maintainability",
+		defaultPolicy: "warn",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "declaration-block-no-duplicate-properties",
+		notes: "Flags duplicate declaration names in the same parsed block."
+	},
+	{
+		code: _jesscss_diagnostics_core.LINT_CODES.hexColorLength,
+		title: "Invalid hex colors",
+		tier: "css-validity",
+		defaultPolicy: "error",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "color-no-invalid-hex",
+		notes: "Flags hex color literals whose digit count is not valid CSS."
+	},
+	{
+		code: _jesscss_diagnostics_core.LINT_CODES.zeroUnits,
+		title: "Zero length units",
+		tier: "style-suggestion",
+		defaultPolicy: "warn",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "length-zero-no-unit",
+		notes: "Flags zero values with length units; non-length units such as percentages and time are left alone."
+	},
+	{
+		code: _jesscss_diagnostics_core.LINT_CODES.unsupportedSassForm,
+		title: "Unsupported Sass forms",
+		tier: "dialect-support",
+		defaultPolicy: "warn",
+		comparison: "jess-only",
+		notes: "Jess dialect support diagnostic shared with the language service."
+	}
+];
+const RECOMMENDED_LINT_CONFIG = {
+	reportSyntax: true,
+	diagnostics: RECOMMENDED_DIAGNOSTICS
+};
+const STYLELINT_COMPARISON_LINT_CONFIG = {
+	reportSyntax: false,
+	diagnostics: COMPARISON_DIAGNOSTICS
+};
+function recommendedLintDiagnostics() {
+	return { ...RECOMMENDED_DIAGNOSTICS };
+}
+function stylelintComparisonDiagnostics() {
+	return { ...COMPARISON_DIAGNOSTICS };
+}
+//#endregion
+//#region src/index.ts
+const DEFAULT_FILE_PATTERNS = ["**/*.{css,less,scss,jess}"];
+var SourceLineIndex = class {
+	#source;
+	#lineStarts;
+	#lines;
+	constructor(source) {
+		this.#source = source;
+		this.#lineStarts = [0];
+		for (let i = 0; i < source.length; i++) if (source.charCodeAt(i) === 10) this.#lineStarts.push(i + 1);
+		this.#lines = source.split(/\r?\n/);
+	}
+	lineColAt(offset) {
+		const end = Math.min(Math.max(0, offset), this.#source.length);
+		let low = 0;
+		let high = this.#lineStarts.length - 1;
+		while (low <= high) {
+			const mid = Math.floor((low + high) / 2);
+			if ((this.#lineStarts[mid] ?? 0) <= end) low = mid + 1;
+			else high = mid - 1;
+		}
+		const lineIndex = Math.max(0, high);
+		return {
+			line: lineIndex + 1,
+			column: end - (this.#lineStarts[lineIndex] ?? 0) + 1
+		};
+	}
+	extractRelevantLines(line, contextLines = 1) {
+		if (this.#source.length === 0) return;
+		const target = Math.max(1, Math.min(line, this.#lines.length));
+		const start = Math.max(1, target - contextLines);
+		const end = Math.min(this.#lines.length, target + contextLines);
+		const result = {};
+		for (let i = start; i <= end; i++) result[i] = this.#lines[i - 1] ?? "";
+		return result;
+	}
+};
+function lintConfigFromStylesConfig(config) {
+	return config?.lint;
+}
+function mergeLintConfig(base, override) {
+	return {
+		...base,
+		...override,
+		diagnostics: {
+			...base?.diagnostics,
+			...override?.diagnostics
+		}
+	};
+}
+async function resolveLintConfig(options) {
+	const cwd = options.cwd ?? process.cwd();
+	return mergeLintConfig(mergeLintConfig(RECOMMENDED_LINT_CONFIG, lintConfigFromStylesConfig(options.stylesConfig ?? (options.configFile ? await (0, styles_config.loadConfigFromPath)(options.configFile) : await (0, styles_config.loadConfig)(cwd)))), options.lintConfig);
+}
+function languageFromPath(filePath, fallback) {
+	if (fallback) return fallback;
+	const ext = node_path.default.extname(filePath ?? "").toLowerCase();
+	if (ext === ".less") return "less";
+	if (ext === ".scss") return "scss";
+	if (ext === ".jess") return "jess";
+	return "css";
+}
+function applyPolicy(diagnostics, config, options) {
+	const out = [];
+	for (const diagnostic of diagnostics) {
+		if (options.syntaxOnly === true && diagnostic.phase !== "parse") continue;
+		if (config.reportSyntax === false && diagnostic.phase === "parse") continue;
+		const policy = config.diagnostics?.[diagnostic.code];
+		if (policy === void 0 || policy === "off") continue;
+		out.push({
+			...diagnostic,
+			severity: policy === "error" ? "error" : policy === "warn" ? "warning" : diagnostic.defaultSeverity
+		});
+	}
+	return out;
+}
+function toErrorDiagnostic(diagnostic, lines) {
+	const start = lines.lineColAt(diagnostic.start);
+	const end = lines.lineColAt(diagnostic.end);
+	return {
+		code: diagnostic.code,
+		phase: diagnostic.phase,
+		message: diagnostic.message,
+		reason: diagnostic.reason,
+		fix: diagnostic.fix,
+		filePath: diagnostic.filePath,
+		line: start.line,
+		column: start.column,
+		endLine: end.line,
+		endColumn: end.column,
+		lines: lines.extractRelevantLines(start.line)
+	};
+}
+function toWarningDiagnostic(diagnostic, lines) {
+	const start = lines.lineColAt(diagnostic.start);
+	const end = lines.lineColAt(diagnostic.end);
+	return {
+		code: diagnostic.code,
+		phase: diagnostic.phase,
+		message: diagnostic.message,
+		reason: diagnostic.reason,
+		fix: diagnostic.fix,
+		filePath: diagnostic.filePath,
+		line: start.line,
+		column: start.column,
+		endLine: end.line,
+		endColumn: end.column,
+		lines: lines.extractRelevantLines(start.line)
+	};
+}
+function toLintResult(source, filePath, diagnostics, includeLegacyDiagnostics) {
+	if (!includeLegacyDiagnostics) return {
+		filePath,
+		diagnostics,
+		errors: [],
+		warnings: []
+	};
+	const lines = new SourceLineIndex(source);
+	const errors = [];
+	const warnings = [];
+	for (const diagnostic of diagnostics) if (diagnostic.severity === "error") errors.push(toErrorDiagnostic(diagnostic, lines));
+	else warnings.push(toWarningDiagnostic(diagnostic, lines));
+	return {
+		filePath,
+		diagnostics,
+		errors,
+		warnings
+	};
+}
+async function lintText(input, options = {}) {
+	const lintConfig = await resolveLintConfig(options);
+	const language = languageFromPath(input.filePath, input.language ?? options.language);
+	const collected = (0, _jesscss_diagnostics_core.collectTolerantDiagnostics)({
+		source: input.source,
+		filePath: input.filePath,
+		language
+	});
+	return toLintResult(input.source, input.filePath, applyPolicy(collected.diagnostics, lintConfig, options), options.includeLegacyDiagnostics === true);
+}
+function patternsOf(value) {
+	if (value === void 0) return [];
+	return typeof value === "string" ? [value] : [...value];
+}
+async function lintFiles(patterns, options = {}) {
+	const cwd = options.cwd ?? process.cwd();
+	const lintConfig = await resolveLintConfig(options);
+	const inputPatterns = typeof patterns === "string" ? [patterns] : [...patterns];
+	const configuredPatterns = patternsOf(lintConfig.files);
+	const files = await (0, glob.glob)(inputPatterns.length > 0 ? inputPatterns : configuredPatterns.length > 0 ? configuredPatterns : DEFAULT_FILE_PATTERNS, {
+		cwd,
+		absolute: true,
+		nodir: true,
+		ignore: patternsOf(lintConfig.ignoreFiles)
+	});
+	files.sort();
+	const results = [];
+	for (const filePath of files) {
+		const source = await (0, node_fs_promises.readFile)(filePath, "utf8");
+		const collected = (0, _jesscss_diagnostics_core.collectTolerantDiagnostics)({
+			source,
+			filePath,
+			language: languageFromPath(filePath, options.language)
+		});
+		results.push(toLintResult(source, filePath, applyPolicy(collected.diagnostics, lintConfig, options), options.includeLegacyDiagnostics === true));
+	}
+	const errorCount = results.reduce((sum, result) => sum + result.diagnostics.filter((diagnostic) => diagnostic.severity === "error").length, 0);
+	const warningCount = results.reduce((sum, result) => sum + result.diagnostics.filter((diagnostic) => diagnostic.severity !== "error").length, 0);
+	return {
+		results,
+		errorCount,
+		warningCount,
+		errored: errorCount > 0 || options.maxWarnings !== void 0 && warningCount > options.maxWarnings
+	};
+}
+function formatLintResult(result) {
+	const lines = [];
+	for (const file of result.results) for (const diagnostic of file.diagnostics) {
+		const loc = `${file.filePath ?? "<input>"}:${diagnostic.start}`;
+		lines.push(`${loc} ${diagnostic.severity} ${diagnostic.code} ${diagnostic.message}`);
+	}
+	lines.push(`Linted ${result.results.length} file(s): ${result.errorCount} error(s), ${result.warningCount} warning(s)`);
+	return lines.join("\n");
+}
+//#endregion
+exports.PARSE_SYNTAX_ERROR_CODE = PARSE_SYNTAX_ERROR_CODE;
+exports.RECOMMENDED_LINT_CONFIG = RECOMMENDED_LINT_CONFIG;
+exports.STABLE_LINT_RULES = STABLE_LINT_RULES;
+exports.STABLE_LINT_RULE_SET_VERSION = STABLE_LINT_RULE_SET_VERSION;
+exports.STYLELINT_COMPARISON_LINT_CONFIG = STYLELINT_COMPARISON_LINT_CONFIG;
+exports.formatLintResult = formatLintResult;
+exports.lintFiles = lintFiles;
+exports.lintText = lintText;
+exports.recommendedLintDiagnostics = recommendedLintDiagnostics;
+exports.stylelintComparisonDiagnostics = stylelintComparisonDiagnostics;

package/lib/index.d.ts

@@ -0,0 +1,38 @@
+import { type DiagnosticSeverityName, type JessLanguage, type SourceDiagnostic } from '@jesscss/diagnostics-core';
+import { type ErrorDiagnostic, type WarningDiagnostic } from '@jesscss/core';
+import type { LintConfig, LintSeverity, StylesConfig } from 'styles-config';
+export type { LintConfig, LintSeverity };
+export { PARSE_SYNTAX_ERROR_CODE, RECOMMENDED_LINT_CONFIG, STABLE_LINT_RULES, STABLE_LINT_RULE_SET_VERSION, STYLELINT_COMPARISON_LINT_CONFIG, recommendedLintDiagnostics, stylelintComparisonDiagnostics, type LintRuleComparisonKind, type LintRuleTier, type StableLintRule } from './rules.js';
+export interface LintOptions {
+    readonly cwd?: string;
+    readonly configFile?: string;
+    readonly stylesConfig?: StylesConfig;
+    readonly lintConfig?: LintConfig;
+    readonly language?: JessLanguage;
+    readonly maxWarnings?: number;
+    readonly syntaxOnly?: boolean;
+    readonly includeLegacyDiagnostics?: boolean;
+}
+export interface LintTextInput {
+    readonly source: string;
+    readonly filePath?: string;
+    readonly language?: JessLanguage;
+}
+export interface LintDiagnostic extends SourceDiagnostic {
+    readonly severity: DiagnosticSeverityName;
+}
+export interface LintResult {
+    readonly filePath?: string;
+    readonly diagnostics: readonly LintDiagnostic[];
+    readonly errors: readonly ErrorDiagnostic[];
+    readonly warnings: readonly WarningDiagnostic[];
+}
+export interface LintRunResult {
+    readonly results: readonly LintResult[];
+    readonly errored: boolean;
+    readonly warningCount: number;
+    readonly errorCount: number;
+}
+export declare function lintText(input: LintTextInput, options?: LintOptions): Promise<LintResult>;
+export declare function lintFiles(patterns: string | readonly string[], options?: LintOptions): Promise<LintRunResult>;
+export declare function formatLintResult(result: LintRunResult): string;

package/lib/index.js

@@ -0,0 +1,298 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { glob } from "glob";
+import { LINT_CODES, collectTolerantDiagnostics } from "@jesscss/diagnostics-core";
+import { loadConfig, loadConfigFromPath } from "styles-config";
+//#region src/rules.ts
+const PARSE_SYNTAX_ERROR_CODE = "parse/syntax-error";
+const STABLE_LINT_RULE_SET_VERSION = 1;
+const RECOMMENDED_DIAGNOSTICS = {
+	[PARSE_SYNTAX_ERROR_CODE]: "error",
+	[LINT_CODES.emptyRules]: "warn",
+	[LINT_CODES.unknownProperties]: "warn",
+	[LINT_CODES.unknownAtRules]: "warn",
+	[LINT_CODES.duplicateProperties]: "warn",
+	[LINT_CODES.hexColorLength]: "error",
+	[LINT_CODES.zeroUnits]: "warn",
+	[LINT_CODES.unsupportedSassForm]: "warn"
+};
+const COMPARISON_DIAGNOSTICS = {
+	[LINT_CODES.emptyRules]: "warn",
+	[LINT_CODES.unknownProperties]: "warn",
+	[LINT_CODES.unknownAtRules]: "warn",
+	[LINT_CODES.duplicateProperties]: "warn",
+	[LINT_CODES.hexColorLength]: "error",
+	[LINT_CODES.zeroUnits]: "warn"
+};
+const STABLE_LINT_RULES = [
+	{
+		code: PARSE_SYNTAX_ERROR_CODE,
+		title: "Syntax error",
+		tier: "syntax",
+		defaultPolicy: "error",
+		comparison: "jess-only",
+		notes: "Parser diagnostic surfaced through lint policy; Stylelint reports parser errors through its own parser path."
+	},
+	{
+		code: LINT_CODES.emptyRules,
+		title: "Empty rules",
+		tier: "maintainability",
+		defaultPolicy: "warn",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "block-no-empty",
+		notes: "Flags empty qualified rules after Jess dialect parsing."
+	},
+	{
+		code: LINT_CODES.unknownProperties,
+		title: "Unknown properties",
+		tier: "css-validity",
+		defaultPolicy: "warn",
+		comparison: "stylelint-near",
+		stylelintRule: "property-no-unknown",
+		notes: "Uses Jess language metadata and suppresses dialect variables, custom properties, vendor-prefixed properties, and interpolated names."
+	},
+	{
+		code: LINT_CODES.unknownAtRules,
+		title: "Unknown at-rules",
+		tier: "css-validity",
+		defaultPolicy: "warn",
+		comparison: "stylelint-near",
+		stylelintRule: "at-rule-no-unknown",
+		notes: "Uses Jess language metadata plus dialect at-rule allow-lists."
+	},
+	{
+		code: LINT_CODES.duplicateProperties,
+		title: "Duplicate properties",
+		tier: "maintainability",
+		defaultPolicy: "warn",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "declaration-block-no-duplicate-properties",
+		notes: "Flags duplicate declaration names in the same parsed block."
+	},
+	{
+		code: LINT_CODES.hexColorLength,
+		title: "Invalid hex colors",
+		tier: "css-validity",
+		defaultPolicy: "error",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "color-no-invalid-hex",
+		notes: "Flags hex color literals whose digit count is not valid CSS."
+	},
+	{
+		code: LINT_CODES.zeroUnits,
+		title: "Zero length units",
+		tier: "style-suggestion",
+		defaultPolicy: "warn",
+		comparison: "stylelint-equivalent",
+		stylelintRule: "length-zero-no-unit",
+		notes: "Flags zero values with length units; non-length units such as percentages and time are left alone."
+	},
+	{
+		code: LINT_CODES.unsupportedSassForm,
+		title: "Unsupported Sass forms",
+		tier: "dialect-support",
+		defaultPolicy: "warn",
+		comparison: "jess-only",
+		notes: "Jess dialect support diagnostic shared with the language service."
+	}
+];
+const RECOMMENDED_LINT_CONFIG = {
+	reportSyntax: true,
+	diagnostics: RECOMMENDED_DIAGNOSTICS
+};
+const STYLELINT_COMPARISON_LINT_CONFIG = {
+	reportSyntax: false,
+	diagnostics: COMPARISON_DIAGNOSTICS
+};
+function recommendedLintDiagnostics() {
+	return { ...RECOMMENDED_DIAGNOSTICS };
+}
+function stylelintComparisonDiagnostics() {
+	return { ...COMPARISON_DIAGNOSTICS };
+}
+//#endregion
+//#region src/index.ts
+const DEFAULT_FILE_PATTERNS = ["**/*.{css,less,scss,jess}"];
+var SourceLineIndex = class {
+	#source;
+	#lineStarts;
+	#lines;
+	constructor(source) {
+		this.#source = source;
+		this.#lineStarts = [0];
+		for (let i = 0; i < source.length; i++) if (source.charCodeAt(i) === 10) this.#lineStarts.push(i + 1);
+		this.#lines = source.split(/\r?\n/);
+	}
+	lineColAt(offset) {
+		const end = Math.min(Math.max(0, offset), this.#source.length);
+		let low = 0;
+		let high = this.#lineStarts.length - 1;
+		while (low <= high) {
+			const mid = Math.floor((low + high) / 2);
+			if ((this.#lineStarts[mid] ?? 0) <= end) low = mid + 1;
+			else high = mid - 1;
+		}
+		const lineIndex = Math.max(0, high);
+		return {
+			line: lineIndex + 1,
+			column: end - (this.#lineStarts[lineIndex] ?? 0) + 1
+		};
+	}
+	extractRelevantLines(line, contextLines = 1) {
+		if (this.#source.length === 0) return;
+		const target = Math.max(1, Math.min(line, this.#lines.length));
+		const start = Math.max(1, target - contextLines);
+		const end = Math.min(this.#lines.length, target + contextLines);
+		const result = {};
+		for (let i = start; i <= end; i++) result[i] = this.#lines[i - 1] ?? "";
+		return result;
+	}
+};
+function lintConfigFromStylesConfig(config) {
+	return config?.lint;
+}
+function mergeLintConfig(base, override) {
+	return {
+		...base,
+		...override,
+		diagnostics: {
+			...base?.diagnostics,
+			...override?.diagnostics
+		}
+	};
+}
+async function resolveLintConfig(options) {
+	const cwd = options.cwd ?? process.cwd();
+	return mergeLintConfig(mergeLintConfig(RECOMMENDED_LINT_CONFIG, lintConfigFromStylesConfig(options.stylesConfig ?? (options.configFile ? await loadConfigFromPath(options.configFile) : await loadConfig(cwd)))), options.lintConfig);
+}
+function languageFromPath(filePath, fallback) {
+	if (fallback) return fallback;
+	const ext = path.extname(filePath ?? "").toLowerCase();
+	if (ext === ".less") return "less";
+	if (ext === ".scss") return "scss";
+	if (ext === ".jess") return "jess";
+	return "css";
+}
+function applyPolicy(diagnostics, config, options) {
+	const out = [];
+	for (const diagnostic of diagnostics) {
+		if (options.syntaxOnly === true && diagnostic.phase !== "parse") continue;
+		if (config.reportSyntax === false && diagnostic.phase === "parse") continue;
+		const policy = config.diagnostics?.[diagnostic.code];
+		if (policy === void 0 || policy === "off") continue;
+		out.push({
+			...diagnostic,
+			severity: policy === "error" ? "error" : policy === "warn" ? "warning" : diagnostic.defaultSeverity
+		});
+	}
+	return out;
+}
+function toErrorDiagnostic(diagnostic, lines) {
+	const start = lines.lineColAt(diagnostic.start);
+	const end = lines.lineColAt(diagnostic.end);
+	return {
+		code: diagnostic.code,
+		phase: diagnostic.phase,
+		message: diagnostic.message,
+		reason: diagnostic.reason,
+		fix: diagnostic.fix,
+		filePath: diagnostic.filePath,
+		line: start.line,
+		column: start.column,
+		endLine: end.line,
+		endColumn: end.column,
+		lines: lines.extractRelevantLines(start.line)
+	};
+}
+function toWarningDiagnostic(diagnostic, lines) {
+	const start = lines.lineColAt(diagnostic.start);
+	const end = lines.lineColAt(diagnostic.end);
+	return {
+		code: diagnostic.code,
+		phase: diagnostic.phase,
+		message: diagnostic.message,
+		reason: diagnostic.reason,
+		fix: diagnostic.fix,
+		filePath: diagnostic.filePath,
+		line: start.line,
+		column: start.column,
+		endLine: end.line,
+		endColumn: end.column,
+		lines: lines.extractRelevantLines(start.line)
+	};
+}
+function toLintResult(source, filePath, diagnostics, includeLegacyDiagnostics) {
+	if (!includeLegacyDiagnostics) return {
+		filePath,
+		diagnostics,
+		errors: [],
+		warnings: []
+	};
+	const lines = new SourceLineIndex(source);
+	const errors = [];
+	const warnings = [];
+	for (const diagnostic of diagnostics) if (diagnostic.severity === "error") errors.push(toErrorDiagnostic(diagnostic, lines));
+	else warnings.push(toWarningDiagnostic(diagnostic, lines));
+	return {
+		filePath,
+		diagnostics,
+		errors,
+		warnings
+	};
+}
+async function lintText(input, options = {}) {
+	const lintConfig = await resolveLintConfig(options);
+	const language = languageFromPath(input.filePath, input.language ?? options.language);
+	const collected = collectTolerantDiagnostics({
+		source: input.source,
+		filePath: input.filePath,
+		language
+	});
+	return toLintResult(input.source, input.filePath, applyPolicy(collected.diagnostics, lintConfig, options), options.includeLegacyDiagnostics === true);
+}
+function patternsOf(value) {
+	if (value === void 0) return [];
+	return typeof value === "string" ? [value] : [...value];
+}
+async function lintFiles(patterns, options = {}) {
+	const cwd = options.cwd ?? process.cwd();
+	const lintConfig = await resolveLintConfig(options);
+	const inputPatterns = typeof patterns === "string" ? [patterns] : [...patterns];
+	const configuredPatterns = patternsOf(lintConfig.files);
+	const files = await glob(inputPatterns.length > 0 ? inputPatterns : configuredPatterns.length > 0 ? configuredPatterns : DEFAULT_FILE_PATTERNS, {
+		cwd,
+		absolute: true,
+		nodir: true,
+		ignore: patternsOf(lintConfig.ignoreFiles)
+	});
+	files.sort();
+	const results = [];
+	for (const filePath of files) {
+		const source = await readFile(filePath, "utf8");
+		const collected = collectTolerantDiagnostics({
+			source,
+			filePath,
+			language: languageFromPath(filePath, options.language)
+		});
+		results.push(toLintResult(source, filePath, applyPolicy(collected.diagnostics, lintConfig, options), options.includeLegacyDiagnostics === true));
+	}
+	const errorCount = results.reduce((sum, result) => sum + result.diagnostics.filter((diagnostic) => diagnostic.severity === "error").length, 0);
+	const warningCount = results.reduce((sum, result) => sum + result.diagnostics.filter((diagnostic) => diagnostic.severity !== "error").length, 0);
+	return {
+		results,
+		errorCount,
+		warningCount,
+		errored: errorCount > 0 || options.maxWarnings !== void 0 && warningCount > options.maxWarnings
+	};
+}
+function formatLintResult(result) {
+	const lines = [];
+	for (const file of result.results) for (const diagnostic of file.diagnostics) {
+		const loc = `${file.filePath ?? "<input>"}:${diagnostic.start}`;
+		lines.push(`${loc} ${diagnostic.severity} ${diagnostic.code} ${diagnostic.message}`);
+	}
+	lines.push(`Linted ${result.results.length} file(s): ${result.errorCount} error(s), ${result.warningCount} warning(s)`);
+	return lines.join("\n");
+}
+//#endregion
+export { PARSE_SYNTAX_ERROR_CODE, RECOMMENDED_LINT_CONFIG, STABLE_LINT_RULES, STABLE_LINT_RULE_SET_VERSION, STYLELINT_COMPARISON_LINT_CONFIG, formatLintResult, lintFiles, lintText, recommendedLintDiagnostics, stylelintComparisonDiagnostics };

package/lib/rules.d.ts

@@ -0,0 +1,19 @@
+import type { LintConfig, LintSeverity } from 'styles-config';
+export declare const PARSE_SYNTAX_ERROR_CODE = "parse/syntax-error";
+export declare const STABLE_LINT_RULE_SET_VERSION = 1;
+export type LintRuleComparisonKind = 'stylelint-equivalent' | 'stylelint-near' | 'jess-only';
+export type LintRuleTier = 'syntax' | 'css-validity' | 'maintainability' | 'style-suggestion' | 'dialect-support';
+export interface StableLintRule {
+    readonly code: string;
+    readonly title: string;
+    readonly tier: LintRuleTier;
+    readonly defaultPolicy: LintSeverity;
+    readonly comparison: LintRuleComparisonKind;
+    readonly stylelintRule?: string;
+    readonly notes: string;
+}
+export declare const STABLE_LINT_RULES: readonly StableLintRule[];
+export declare const RECOMMENDED_LINT_CONFIG: LintConfig;
+export declare const STYLELINT_COMPARISON_LINT_CONFIG: LintConfig;
+export declare function recommendedLintDiagnostics(): Record<string, LintSeverity>;
+export declare function stylelintComparisonDiagnostics(): Record<string, LintSeverity>;

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@jesscss/lint",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Jess stylesheet lint policy and reporting",
+  "version": "2.0.0-alpha.11",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "main": "lib/index.cjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "dependencies": {
+    "glob": "^10.2.1",
+    "@jesscss/core": "2.0.0-alpha.11",
+    "styles-config": "2.0.0-alpha.11",
+    "@jesscss/diagnostics-core": "2.0.0-alpha.11"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "postcss-less": "~6.0.0",
+    "stylelint": "~17.14.1",
+    "typescript": "~5.8.2",
+    "vitest": "^4.1.0"
+  },
+  "author": "Matthew Dean <matthew-dean@users.noreply.github.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jesscss/jess/issues"
+  },
+  "homepage": "https://github.com/jesscss/jess#readme",
+  "module": "lib/index.js",
+  "scripts": {
+    "build": "pnpm compile",
+    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck",
+    "bench:stylelint": "pnpm build && node test/stylelint-comparison-bench.mjs",
+    "test": "vitest --watch=false",
+    "lint": "eslint '**/*.{js,ts}'"
+  }
+}