@stylelint/language-server 1.0.0

package/build/server/stylelint/load-stylelint.js

@@ -0,0 +1,173 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+// eslint-disable-next-line @typescript-eslint/no-implied-eval -- Needed to access dynamic import from CommonJS modules.
+const realDynamicImport = new Function('specifier', '"use strict"; return import(specifier);');
+let dynamicImportImpl = realDynamicImport;
+const getModulePath = (specifier, requireFn) => {
+    if (specifier.startsWith('file://')) {
+        return { modulePath: specifier, isResolved: true };
+    }
+    try {
+        return { modulePath: requireFn.resolve(specifier), isResolved: true };
+    }
+    catch {
+        return { modulePath: specifier, isResolved: false };
+    }
+};
+const isPathSpecifier = (value) => value.startsWith('file://') ||
+    path.isAbsolute(value) ||
+    value.startsWith('./') ||
+    value.startsWith('../');
+const toFsPath = (target) => target.startsWith('file://') ? fileURLToPath(target) : target;
+const normalizePackageTarget = (packageRoot, target) => {
+    if (target.startsWith('file://')) {
+        return target;
+    }
+    if (path.isAbsolute(target)) {
+        return target;
+    }
+    return path.join(packageRoot, target);
+};
+const resolveExportTarget = (value) => {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            const resolved = resolveExportTarget(entry);
+            if (resolved) {
+                return resolved;
+            }
+        }
+        return undefined;
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        const priorityKeys = ['import', 'module', 'default'];
+        for (const key of priorityKeys) {
+            if (!(key in record)) {
+                continue;
+            }
+            const resolved = resolveExportTarget(record[key]);
+            if (resolved) {
+                return resolved;
+            }
+        }
+        for (const [key, child] of Object.entries(record)) {
+            if (priorityKeys.includes(key) || key === 'require' || key === 'types') {
+                continue;
+            }
+            const resolved = resolveExportTarget(child);
+            if (resolved) {
+                return resolved;
+            }
+        }
+    }
+    return undefined;
+};
+const resolvePreferredEsmEntry = async (modulePath, packageRootFinder) => {
+    const packageRoot = await packageRootFinder.find(path.resolve(toFsPath(modulePath)));
+    if (!packageRoot) {
+        return undefined;
+    }
+    try {
+        const manifestPath = path.join(packageRoot, 'package.json');
+        const manifest = JSON.parse(await fs.readFile(manifestPath, 'utf8'));
+        const rootExport = typeof manifest.exports === 'object' && !Array.isArray(manifest.exports)
+            ? (manifest.exports['.'] ?? manifest.exports)
+            : manifest.exports;
+        const exportTarget = resolveExportTarget(rootExport);
+        if (exportTarget) {
+            return normalizePackageTarget(packageRoot, exportTarget);
+        }
+        if (typeof manifest.module === 'string') {
+            return normalizePackageTarget(packageRoot, manifest.module);
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+};
+const loadESMStylelint = async (target, treatAsPath = true) => {
+    const specifier = treatAsPath && !target.startsWith('file://')
+        ? pathToFileURL(path.resolve(target)).href
+        : target;
+    const namespace = (await dynamicImportImpl(specifier));
+    const stylelint = namespace.default ?? namespace;
+    if (!stylelint) {
+        throw new Error(`Failed to import Stylelint from ${target}.`);
+    }
+    return { stylelint, moduleType: 'esm' };
+};
+/**
+ * Loads the Stylelint module, supporting both CommonJS and ESM builds.
+ * @param specifier Path or specifier that can be resolved by the provided require function.
+ * @param requireFn Custom require implementation, defaults to the global require.
+ * @param resolvedPath Optional pre-resolved module path used when falling back to ESM imports.
+ */
+export const loadStylelint = async (packageRootFinder, specifier, requireFn, resolvedPath) => {
+    const { modulePath, isResolved } = resolvedPath
+        ? { modulePath: resolvedPath, isResolved: true }
+        : getModulePath(specifier, requireFn);
+    const hasResolvedPath = isResolved || isPathSpecifier(modulePath);
+    const preferredEsmEntry = hasResolvedPath
+        ? await resolvePreferredEsmEntry(modulePath, packageRootFinder)
+        : undefined;
+    const seenTargets = new Set();
+    const importTargets = [];
+    const addImportTarget = (target, treatAsPath) => {
+        if (!target) {
+            return;
+        }
+        const key = `${treatAsPath ? 'path' : 'spec'}:${target}`;
+        if (seenTargets.has(key)) {
+            return;
+        }
+        seenTargets.add(key);
+        importTargets.push({ target, treatAsPath });
+    };
+    addImportTarget(preferredEsmEntry, true);
+    if (isPathSpecifier(specifier)) {
+        addImportTarget(specifier, true);
+    }
+    const resolvedImportTarget = resolvedPath ?? (hasResolvedPath ? modulePath : undefined);
+    addImportTarget(resolvedImportTarget, true);
+    let firstImportError;
+    for (const { target, treatAsPath } of importTargets) {
+        try {
+            return await loadESMStylelint(target, treatAsPath);
+        }
+        catch (error) {
+            if (!firstImportError) {
+                firstImportError = error;
+            }
+        }
+    }
+    try {
+        return {
+            stylelint: requireFn(specifier),
+            moduleType: 'cjs',
+        };
+    }
+    catch (requireError) {
+        if (firstImportError) {
+            // eslint-disable-next-line @typescript-eslint/only-throw-error
+            throw firstImportError;
+        }
+        throw requireError;
+    }
+};
+/**
+ * Internal hooks used by the unit tests to control the dynamic import helper.
+ */
+export const __loadStylelintTestApi = {
+    setDynamicImport(mock) {
+        dynamicImportImpl = mock;
+    },
+    resetDynamicImport() {
+        dynamicImportImpl = realDynamicImport;
+    },
+};
+//# sourceMappingURL=load-stylelint.js.map

package/build/server/stylelint/load-stylelint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-stylelint.js","sourceRoot":"","sources":["../../../src/server/stylelint/load-stylelint.ts"],"names":[],"mappings":"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"}

package/build/server/stylelint/process-linter-result.d.ts

@@ -0,0 +1,32 @@
+import type { Logger } from 'winston';
+import type { RuleCustomization } from '../types.js';
+import { type LintDiagnostics, type LinterResult, type MultiFileLintDiagnostics, type RuleMetadataSource } from './types.js';
+/**
+ * Processes the results of a Stylelint lint run.
+ *
+ * If Stylelint reported any warnings, they are converted to Diagnostics and
+ * returned. If the lint results contain raw output in the `code` property, it
+ * is also returned, along with any formatted report (`report`) or any legacy
+ * autofixed code (`output`).
+ *
+ * Throws an `InvalidOptionError` for any invalid option warnings reported by
+ * Stylelint.
+ * @param ruleMetadataSource Rule metadata source for documentation links.
+ * @param linterResult The results returned by Stylelint.
+ * @param logger The logger to use.
+ * @param ruleCustomizations Optional rule customizations for severity overrides.
+ */
+export declare function processLinterResult(ruleMetadataSource: RuleMetadataSource | undefined, linterResult: LinterResult, logger: Logger, ruleCustomizations?: RuleCustomization[]): LintDiagnostics;
+/**
+ * Processes the results of a multi-file Stylelint lint run.
+ *
+ * Each result is expected to have a `source` property containing the absolute
+ * file path of the linted file. Results without a source are skipped. The
+ * returned map is keyed by file path.
+ *
+ * @param ruleMetadataSource Rule metadata source for documentation links.
+ * @param linterResult The results returned by Stylelint.
+ * @param logger The logger to use.
+ * @param ruleCustomizations Optional rule customizations for severity overrides.
+ */
+export declare function processMultiFileLinterResult(ruleMetadataSource: RuleMetadataSource | undefined, linterResult: LinterResult, logger: Logger, ruleCustomizations?: RuleCustomization[]): MultiFileLintDiagnostics;

package/build/server/stylelint/process-linter-result.js

@@ -0,0 +1,129 @@
+import * as crypto from 'crypto';
+import { InvalidOptionError, } from './types.js';
+import { warningToDiagnostic } from './warning-to-diagnostic.js';
+/**
+ * Returns a unique key for a diagnostic.
+ * @param diagnostic The diagnostic to get a key for.
+ */
+function getDiagnosticKey(diagnostic) {
+    const range = diagnostic.range;
+    let message = '';
+    if (diagnostic.message) {
+        const hash = crypto.createHash('sha256');
+        hash.update(diagnostic.message);
+        message = hash.digest('base64');
+    }
+    return `[${range.start.line},${range.start.character},${range.end.line},${range.end.character}]-${diagnostic.code}-${message}`;
+}
+/**
+ * Resolves the rule metadata record from a linter result, falling back to
+ * the built-in rule metadata source when necessary.
+ */
+function resolveRuleMetadata(linterResult, ruleMetadataSource) {
+    if (linterResult.ruleMetadata) {
+        return linterResult.ruleMetadata;
+    }
+    if (ruleMetadataSource) {
+        // Create built-in rule metadata lookup for backwards compatibility.
+        return new Proxy({}, {
+            get: (_, key) => ruleMetadataSource.get(key),
+        });
+    }
+    return undefined;
+}
+/**
+ * Converts a single Stylelint lint result into diagnostics.
+ */
+function processSingleLintResult(result, logger, ruleMetadata, ruleCustomizations) {
+    if (result.ignored) {
+        return { diagnostics: [] };
+    }
+    if (result.invalidOptionWarnings.length !== 0) {
+        throw new InvalidOptionError(result.invalidOptionWarnings);
+    }
+    const diagnostics = [];
+    const warningsMap = new Map();
+    for (const warning of result.warnings) {
+        const diagnostic = warningToDiagnostic(warning, logger, ruleMetadata, ruleCustomizations);
+        // Only add diagnostic if it wasn't suppressed.
+        if (diagnostic !== null) {
+            diagnostics.push(diagnostic);
+            warningsMap.set(getDiagnosticKey(diagnostic), warning);
+        }
+    }
+    const getWarning = (diagnostic) => {
+        const key = getDiagnosticKey(diagnostic);
+        return warningsMap.get(key) ?? null;
+    };
+    return { diagnostics, getWarning };
+}
+/**
+ * Processes the results of a Stylelint lint run.
+ *
+ * If Stylelint reported any warnings, they are converted to Diagnostics and
+ * returned. If the lint results contain raw output in the `code` property, it
+ * is also returned, along with any formatted report (`report`) or any legacy
+ * autofixed code (`output`).
+ *
+ * Throws an `InvalidOptionError` for any invalid option warnings reported by
+ * Stylelint.
+ * @param ruleMetadataSource Rule metadata source for documentation links.
+ * @param linterResult The results returned by Stylelint.
+ * @param logger The logger to use.
+ * @param ruleCustomizations Optional rule customizations for severity overrides.
+ */
+export function processLinterResult(ruleMetadataSource, linterResult, logger, ruleCustomizations) {
+    const { results } = linterResult;
+    if (results.length === 0) {
+        return { diagnostics: [] };
+    }
+    const firstResult = results[0];
+    if (firstResult.ignored) {
+        return { diagnostics: [] };
+    }
+    const ruleMetadata = resolveRuleMetadata(linterResult, ruleMetadataSource);
+    const lintDiagnostics = processSingleLintResult(firstResult, logger, ruleMetadata, ruleCustomizations);
+    let hasReport = false;
+    if ('report' in linterResult && typeof linterResult.report === 'string') {
+        lintDiagnostics.report = linterResult.report;
+        hasReport = true;
+    }
+    let hasModernFixes = false;
+    if ('code' in linterResult && typeof linterResult.code === 'string') {
+        lintDiagnostics.code = linterResult.code;
+        hasModernFixes = true;
+    }
+    if (!hasModernFixes && !hasReport && 'output' in linterResult) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        const { output: legacyOutput } = linterResult;
+        if (typeof legacyOutput === 'string' && legacyOutput.length > 0) {
+            lintDiagnostics.output = legacyOutput;
+        }
+    }
+    return lintDiagnostics;
+}
+/**
+ * Processes the results of a multi-file Stylelint lint run.
+ *
+ * Each result is expected to have a `source` property containing the absolute
+ * file path of the linted file. Results without a source are skipped. The
+ * returned map is keyed by file path.
+ *
+ * @param ruleMetadataSource Rule metadata source for documentation links.
+ * @param linterResult The results returned by Stylelint.
+ * @param logger The logger to use.
+ * @param ruleCustomizations Optional rule customizations for severity overrides.
+ */
+export function processMultiFileLinterResult(ruleMetadataSource, linterResult, logger, ruleCustomizations) {
+    const { results } = linterResult;
+    const multiFileResult = new Map();
+    const ruleMetadata = resolveRuleMetadata(linterResult, ruleMetadataSource);
+    for (const result of results) {
+        if (!result.source || result.ignored) {
+            continue;
+        }
+        multiFileResult.set(result.source, processSingleLintResult(result, logger, ruleMetadata, ruleCustomizations));
+    }
+    return multiFileResult;
+}
+//# sourceMappingURL=process-linter-result.js.map

package/build/server/stylelint/process-linter-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-linter-result.js","sourceRoot":"","sources":["../../../src/server/stylelint/process-linter-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAIjC,OAAO,EACN,kBAAkB,GAOlB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;GAGG;AACH,SAAS,gBAAgB,CAAC,UAA0B;IACnD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAC/B,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEzC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,UAAU,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;AAChI,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC3B,YAA0B,EAC1B,kBAAkD;IAElD,IAAI,YAAY,CAAC,YAAY,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC,YAAY,CAAC;IAClC,CAAC;IAED,IAAI,kBAAkB,EAAE,CAAC;QACxB,oEAAoE;QACpE,OAAO,IAAI,KAAK,CACf,EAAE,EACF;YACC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC;SACpD,CACD,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC/B,MAAkB,EAClB,MAAc,EACd,YAA0C,EAC1C,kBAAwC;IAExC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE/C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;QAE1F,+CAA+C;QAC/C,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACF,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,UAA0B,EAAkB,EAAE;QACjE,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAEzC,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAClC,kBAAkD,EAClD,YAA0B,EAC1B,MAAc,EACd,kBAAwC;IAExC,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC;IAEjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE/B,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,uBAAuB,CAC9C,WAAW,EACX,MAAM,EACN,YAAY,EACZ,kBAAkB,CAClB,CAAC;IAEF,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,IAAI,QAAQ,IAAI,YAAY,IAAI,OAAO,YAAY,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzE,eAAe,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QAC7C,SAAS,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,IAAI,MAAM,IAAI,YAAY,IAAI,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrE,eAAe,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QACzC,cAAc,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,IAAI,QAAQ,IAAI,YAAY,EAAE,CAAC;QAC/D,4DAA4D;QAC5D,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,YAMhC,CAAC;QAEF,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,eAAe,CAAC,MAAM,GAAG,YAAY,CAAC;QACvC,CAAC;IACF,CAAC;IAED,OAAO,eAAe,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAC3C,kBAAkD,EAClD,YAA0B,EAC1B,MAAc,EACd,kBAAwC;IAExC,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC;IACjC,MAAM,eAAe,GAA6B,IAAI,GAAG,EAAE,CAAC;IAC5D,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IAE3E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,SAAS;QACV,CAAC;QAED,eAAe,CAAC,GAAG,CAClB,MAAM,CAAC,MAAM,EACb,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,CAAC,CACzE,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACxB,CAAC"}

package/build/server/stylelint/types.d.ts

@@ -0,0 +1,143 @@
+import type stylelint from 'stylelint';
+import type LSP from 'vscode-languageserver-protocol';
+import type { RuleCustomization } from '../types.js';
+export type Stylelint = typeof stylelint;
+export type ConfigurationError = Error & {
+    code: 78;
+};
+export type RuleMetadataSnapshot = Record<string, stylelint.RuleMeta | undefined>;
+/**
+ * A Stylelint warning.
+ */
+export type Warning = stylelint.Warning & {
+    /** URL for the rule documentation. Available in Stylelint 16.7+. */
+    url?: string;
+};
+export type RuleMetadataSource = {
+    get(ruleName: string): stylelint.RuleMeta | undefined;
+};
+/**
+ * Minimal subset of a Stylelint lint result required by the language server.
+ */
+export type LintResult = {
+    source?: string;
+    warnings: Warning[];
+    invalidOptionWarnings: stylelint.LintResult['invalidOptionWarnings'];
+    ignored?: boolean;
+};
+/**
+ * Minimal subset of a Stylelint linter result required by the language server.
+ */
+export type LinterResult = {
+    results: LintResult[];
+    report?: string;
+    code?: string;
+    output?: string;
+    ruleMetadata?: stylelint.LinterResult['ruleMetadata'];
+};
+/**
+ * Diagnostics for a lint run.
+ */
+export type LintDiagnostics = {
+    /**
+     * The diagnostics, each corresponding to a warning or error emitted by
+     * Stylelint.
+     */
+    diagnostics: LSP.Diagnostic[];
+    /**
+     * Formatted report returned by Stylelint, if any.
+     */
+    report?: string;
+    /**
+     * Autofixed code returned by Stylelint when linting source text with `fix`
+     * enabled.
+     */
+    code?: string;
+    /**
+     * Raw output from Stylelint, if any. Deprecated in Stylelint 16 in favour of
+     * `report` and `code`.
+     */
+    output?: string;
+    /**
+     * Gets the original warning from the given diagnostic.
+     */
+    getWarning?: (diagnostic: LSP.Diagnostic) => Warning | null;
+};
+/**
+ * Diagnostics for a multi-file lint run, keyed by file URI.
+ */
+export type MultiFileLintDiagnostics = Map<string, LintDiagnostics>;
+/**
+ * Disable report rule names.
+ */
+export declare enum DisableReportRuleNames {
+    Needless = "--report-needless-disables",
+    InvalidScope = "--report-invalid-scope-disables",
+    Descriptionless = "--report-descriptionless-disables",
+    Illegal = "reportDisables"
+}
+/**
+ * Stylelint runner options.
+ */
+export type RunnerOptions = {
+    config?: stylelint.Config | null;
+    configBasedir?: string;
+    configFile?: string;
+    customSyntax?: string;
+    ignoreDisables?: boolean;
+    ignorePath?: string;
+    packageManager?: PackageManager;
+    reportDescriptionlessDisables?: boolean;
+    reportInvalidScopeDisables?: boolean;
+    reportNeedlessDisables?: boolean;
+    snippet?: string[];
+    stylelintPath?: string;
+    validate?: string[];
+    rules?: {
+        customizations?: RuleCustomization[];
+    };
+    lintFilesGlob?: string;
+};
+/**
+ * Error thrown when a rule's option is invalid.
+ */
+export declare class InvalidOptionError extends Error {
+    reasons: string[];
+    constructor(warnings: {
+        text: string;
+    }[]);
+}
+/**
+ * Creates a rule metadata source from a Stylelint instance.
+ */
+export declare function createRuleMetadataSourceFromStylelint(stylelintInstance?: Stylelint): RuleMetadataSource | undefined;
+/**
+ * Creates a rule metadata source from a snapshot.
+ */
+export declare function createRuleMetadataSourceFromSnapshot(snapshot?: RuleMetadataSnapshot): RuleMetadataSource | undefined;
+/**
+ * Package manager identifiers.
+ */
+export type PackageManager = 'npm' | 'yarn' | 'pnpm';
+/**
+ * Options for resolving the Stylelint package.
+ */
+export type ResolverOptions = {
+    packageManager?: PackageManager;
+    stylelintPath?: string;
+};
+/**
+ * Stylelint package resolution result.
+ */
+export type StylelintResolutionResult = {
+    /** Absolute path to the resolved Stylelint entry file or package directory. */
+    entryPath: string;
+    /** Absolute path to the Stylelint package root (falls back to entryPath when unknown). */
+    resolvedPath: string;
+    /** Package version if known. */
+    version?: string;
+};
+/**
+ * A tracer function that can be used to log messages.
+ */
+export type TracerFn = (message: string, verbose?: string) => void;

package/build/server/stylelint/types.js

@@ -0,0 +1,47 @@
+/**
+ * Disable report rule names.
+ */
+export var DisableReportRuleNames;
+(function (DisableReportRuleNames) {
+    DisableReportRuleNames["Needless"] = "--report-needless-disables";
+    DisableReportRuleNames["InvalidScope"] = "--report-invalid-scope-disables";
+    DisableReportRuleNames["Descriptionless"] = "--report-descriptionless-disables";
+    DisableReportRuleNames["Illegal"] = "reportDisables";
+})(DisableReportRuleNames || (DisableReportRuleNames = {}));
+/**
+ * Error thrown when a rule's option is invalid.
+ */
+export class InvalidOptionError extends Error {
+    reasons;
+    constructor(warnings) {
+        const reasons = warnings.map((warning) => warning.text);
+        super(reasons.join('\n'));
+        this.reasons = reasons;
+    }
+}
+/**
+ * Creates a rule metadata source from a Stylelint instance.
+ */
+export function createRuleMetadataSourceFromStylelint(stylelintInstance) {
+    if (!stylelintInstance) {
+        return undefined;
+    }
+    return {
+        get: (ruleName) => {
+            const rules = stylelintInstance.rules;
+            return rules?.[ruleName]?.meta;
+        },
+    };
+}
+/**
+ * Creates a rule metadata source from a snapshot.
+ */
+export function createRuleMetadataSourceFromSnapshot(snapshot) {
+    if (!snapshot) {
+        return undefined;
+    }
+    return {
+        get: (ruleName) => snapshot[ruleName],
+    };
+}
+//# sourceMappingURL=types.js.map

package/build/server/stylelint/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/stylelint/types.ts"],"names":[],"mappings":"AA+EA;;GAEG;AACH,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IACjC,iEAAuC,CAAA;IACvC,0EAAgD,CAAA;IAChD,+EAAqD,CAAA;IACrD,oDAA0B,CAAA;AAC3B,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC;AAyBD;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC5C,OAAO,CAAW;IAElB,YAAY,QAA4B;QACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAExD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,qCAAqC,CACpD,iBAA6B;IAE7B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO;QACN,GAAG,EAAE,CAAC,QAAgB,EAAE,EAAE;YACzB,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAEpB,CAAC;YAEb,OAAO,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChC,CAAC;KACD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC,CACnD,QAA+B;IAE/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO;QACN,GAAG,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAC7C,CAAC;AACH,CAAC"}

package/build/server/stylelint/warning-to-diagnostic.d.ts

@@ -0,0 +1,46 @@
+import type stylelint from 'stylelint';
+import { Diagnostic } from 'vscode-languageserver-types';
+import type { RuleCustomization } from '../types.js';
+import type { Logger } from 'winston';
+import type { Warning } from './types.js';
+/**
+ * Converts a Stylelint warning to an LSP Diagnostic.
+ *
+ * @example
+ * ```js
+ * const [result] = await stylelint.lint({
+ *   code: 'a { color: red; }',
+ *   config: { rules: { 'color-named': 'never' } }
+ * });
+ *
+ * const [warning] = result.warnings;
+ * // {
+ * //   rule: 'color-named',
+ * //   text: 'Unexpected named color "red" (color-named)',
+ * //   severity: 'error',
+ * //   line: 1,
+ * //   column: 12
+ * // }
+ *
+ * const diagnostic = warningToDiagnostic(warning);
+ * // {
+ * //   message: 'Unexpected named color "red" (color-named)',
+ * //   severity: 1,
+ * //   source: 'Stylelint',
+ * //   range: {
+ * //     start: {
+ * //       line: 0,
+ * //       character: 11
+ * //     },
+ * //     end: {
+ * //       line: 0,
+ * //       character: 11
+ * //     }
+ * //   }
+ * // }
+ * ```
+ * @param warning The warning to convert.
+ * @param ruleMetadata Available Stylelint rules.
+ * @param ruleCustomizations Optional rule customizations for severity overrides.
+ */
+export declare function warningToDiagnostic(warning: Warning, logger: Logger, ruleMetadata?: stylelint.LinterResult['ruleMetadata'], ruleCustomizations?: RuleCustomization[]): Diagnostic | null;