eslint-plugin-typefest 1.0.1

package/dist/_internal/normalize-expression-text.js

@@ -0,0 +1,182 @@
+import { isDefined, objectHasOwn, objectKeys } from "ts-extras";
+import { setContainsValue } from "./set-membership.js";
+/**
+ * ESTree metadata keys ignored during structural-equivalence checks.
+ */
+const ignoredPropertyKeys = new Set([
+    "end",
+    "loc",
+    "parent",
+    "range",
+    "start",
+]);
+/**
+ * Maximum recursive depth allowed during structural node-value comparisons.
+ *
+ * @remarks
+ * This guard avoids stack-overflow crashes on pathological, adversarially deep
+ * AST/type structures. Returning `false` in that case preserves lint-process
+ * stability by failing closed for autofix-equivalence checks.
+ */
+const MAX_NODE_VALUE_COMPARISON_DEPTH = 256;
+/**
+ * Check whether a value is object-like for structural comparisons.
+ */
+const isComparableRecord = (value) => typeof value === "object" && value !== null;
+/**
+ * Return stable comparable keys after stripping metadata properties.
+ */
+const getComparableKeys = (value) => objectKeys(value).filter((key) => !setContainsValue(ignoredPropertyKeys, key));
+/**
+ * Read comparable keys with per-comparison caching to reduce repeated
+ * key-filter allocations during deep traversals.
+ *
+ * @param value - Object candidate being compared.
+ * @param comparableKeysByObject - Per-comparison key cache.
+ *
+ * @returns Comparable key list with ESTree metadata keys removed.
+ */
+const getCachedComparableKeys = (value, comparableKeysByObject) => {
+    const existingComparableKeys = comparableKeysByObject.get(value);
+    if (isDefined(existingComparableKeys)) {
+        return existingComparableKeys;
+    }
+    const comparableKeys = getComparableKeys(value);
+    comparableKeysByObject.set(value, comparableKeys);
+    return comparableKeys;
+};
+/**
+ * Unwrap transparent TypeScript expression wrappers.
+ *
+ * @param expression - Expression to normalize.
+ *
+ * @returns The innermost wrapped expression.
+ */
+const unwrapTransparentExpression = (expression) => {
+    let currentExpression = expression;
+    const visitedExpressions = new Set();
+    while (true) {
+        if (setContainsValue(visitedExpressions, currentExpression)) {
+            return currentExpression;
+        }
+        visitedExpressions.add(currentExpression);
+        if (currentExpression.type === "TSAsExpression") {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        if (currentExpression.type === "TSNonNullExpression") {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        if (currentExpression.type === "TSSatisfiesExpression") {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        if (currentExpression.type === "TSTypeAssertion") {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        return currentExpression;
+    }
+};
+/**
+ * Records a compared object pair and reports whether that pair was already
+ * visited.
+ *
+ * @param left - Left-side object in the comparison pair.
+ * @param right - Right-side object in the comparison pair.
+ * @param seenPairs - Weakly-held pair-tracking cache for cycle-safe traversal.
+ *
+ * @returns `true` when this exact pair has already been processed.
+ */
+const markAndCheckSeenPair = (left, right, seenPairs) => {
+    const seenRightNodes = seenPairs.get(left);
+    if (isDefined(seenRightNodes) && seenRightNodes.has(right)) {
+        return true;
+    }
+    if (isDefined(seenRightNodes)) {
+        seenRightNodes.add(right);
+    }
+    else {
+        seenPairs.set(left, new WeakSet([right]));
+    }
+    return false;
+};
+/**
+ * Deep structural comparison that is resilient to cycles and ESTree metadata
+ * fields.
+ *
+ * @param left - Left-side value.
+ * @param right - Right-side value.
+ * @param seenPairs - Pair cache used to break recursive cycles.
+ *
+ * @returns `true` when the values are structurally equivalent after metadata
+ *   normalization.
+ */
+const areEquivalentNodeValues = (left, right, seenPairs = new WeakMap(), comparableKeysByObject = new WeakMap(), depth = 0) => {
+    if (depth >= MAX_NODE_VALUE_COMPARISON_DEPTH) {
+        return false;
+    }
+    if (Object.is(left, right)) {
+        return true;
+    }
+    if (typeof left !== typeof right) {
+        return false;
+    }
+    if (left === null || right === null) {
+        return false;
+    }
+    if (Array.isArray(left) || Array.isArray(right)) {
+        if (!Array.isArray(left) || !Array.isArray(right)) {
+            return false;
+        }
+        if (markAndCheckSeenPair(left, right, seenPairs)) {
+            return true;
+        }
+        if (left.length !== right.length) {
+            return false;
+        }
+        return left.every((value, index) => areEquivalentNodeValues(value, right[index], seenPairs, comparableKeysByObject, depth + 1));
+    }
+    if (!isComparableRecord(left) || !isComparableRecord(right)) {
+        return false;
+    }
+    if (markAndCheckSeenPair(left, right, seenPairs)) {
+        return true;
+    }
+    const leftKeys = getCachedComparableKeys(left, comparableKeysByObject);
+    const rightKeys = getCachedComparableKeys(right, comparableKeysByObject);
+    const rightKeySet = new Set(rightKeys);
+    if (leftKeys.length !== rightKeys.length) {
+        return false;
+    }
+    if (leftKeys.some((key) => !setContainsValue(rightKeySet, key))) {
+        return false;
+    }
+    return leftKeys.every((key) => {
+        if (!objectHasOwn(left, key) || !objectHasOwn(right, key)) {
+            return false;
+        }
+        return areEquivalentNodeValues(left[key], right[key], seenPairs, comparableKeysByObject, depth + 1);
+    });
+};
+/**
+ * Compare two expressions for structural equivalence after unwrapping
+ * transparent TypeScript wrappers.
+ *
+ * @param left - Left-hand expression.
+ * @param right - Right-hand expression.
+ *
+ * @returns `true` when both expressions are structurally equivalent.
+ */
+export const areEquivalentExpressions = (left, right) => areEquivalentNodeValues(unwrapTransparentExpression(left), unwrapTransparentExpression(right));
+/**
+ * Compare two type nodes for structural equivalence.
+ *
+ * @param left - Left-hand type node.
+ * @param right - Right-hand type node.
+ *
+ * @returns `true` when both type nodes are structurally equivalent.
+ */
+export const areEquivalentTypeNodes = (left, right) => areEquivalentNodeValues(left, right);
+//# sourceMappingURL=normalize-expression-text.js.map

package/dist/_internal/normalize-expression-text.js.map

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

package/dist/_internal/nullish-comparison.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @packageDocumentation
+ * Shared helpers for parsing and flattening nullish comparison expressions.
+ */
+import type { TSESTree } from "@typescript-eslint/utils";
+/**
+ * Normalized representation of one binary comparison against null/undefined.
+ */
+export type NullishComparison = Readonly<{
+    comparedExpression: TSESTree.Expression;
+    kind: NullishComparisonKind;
+    operator: NullishComparisonOperator;
+}>;
+/** Nullish literal kinds supported by comparison extraction. */
+export type NullishComparisonKind = "null" | "undefined";
+/** Operators supported by nullish comparison extraction. */
+export type NullishComparisonOperator = "!=" | "!==" | "==" | "===";
+/**
+ * Flatten a logical-expression tree for one specific operator.
+ *
+ * @param options - Expression and logical operator to flatten.
+ *
+ * @returns Left-to-right list of terms participating in that operator chain.
+ */
+export declare const flattenLogicalTerms: ({ expression, operator, }: Readonly<{
+    expression: Readonly<TSESTree.Expression>;
+    operator: "&&" | "||";
+}>) => readonly TSESTree.Expression[];
+/**
+ * Narrow a list of expressions to an exact two-term tuple.
+ */
+export declare const isExpressionPair: (terms: readonly Readonly<TSESTree.Expression>[]) => terms is readonly [TSESTree.Expression, TSESTree.Expression];
+/**
+ * Extract a normalized nullish comparison from an expression.
+ */
+export declare const getNullishComparison: ({ allowedOperators, allowTypeofComparedIdentifierForUndefined, comparedIdentifierName, expression, isGlobalUndefinedIdentifier, }: Readonly<{
+    allowedOperators?: readonly NullishComparisonOperator[];
+    allowTypeofComparedIdentifierForUndefined?: boolean;
+    comparedIdentifierName?: string;
+    expression: Readonly<TSESTree.Expression>;
+    isGlobalUndefinedIdentifier: (expression: Readonly<TSESTree.Expression>) => boolean;
+}>) => null | NullishComparison;
+//# sourceMappingURL=nullish-comparison.d.ts.map

package/dist/_internal/nullish-comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullish-comparison.d.ts","sourceRoot":"","sources":["../../src/_internal/nullish-comparison.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACrC,kBAAkB,EAAE,QAAQ,CAAC,UAAU,CAAC;IACxC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,yBAAyB,CAAC;CACvC,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,WAAW,CAAC;AAEzD,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;AAUpE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,2BAGjC,QAAQ,CAAC;IACR,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB,CAAC,KAAG,SAAS,QAAQ,CAAC,UAAU,EAuBhC,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GACzB,OAAO,SAAS,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,KAChD,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAChB,CAAC;AAiD/C;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,mIAMlC,QAAQ,CAAC;IACR,gBAAgB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,yCAAyC,CAAC,EAAE,OAAO,CAAC;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC1C,2BAA2B,EAAE,CACzB,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,KACxC,OAAO,CAAC;CAChB,CAAC,KAAG,IAAI,GAAG,iBA+GX,CAAC"}

package/dist/_internal/nullish-comparison.js

@@ -0,0 +1,147 @@
+import { arrayIncludes, isDefined } from "ts-extras";
+/** Default accepted operators for nullish comparison parsing. */
+const defaultNullishComparisonOperators = [
+    "!=",
+    "!==",
+    "==",
+    "===",
+];
+/**
+ * Flatten a logical-expression tree for one specific operator.
+ *
+ * @param options - Expression and logical operator to flatten.
+ *
+ * @returns Left-to-right list of terms participating in that operator chain.
+ */
+export const flattenLogicalTerms = ({ expression, operator, }) => {
+    const flattenedTerms = [];
+    const pendingTerms = [expression];
+    while (pendingTerms.length > 0) {
+        const currentTerm = pendingTerms.pop();
+        if (!currentTerm) {
+            continue;
+        }
+        if (currentTerm.type === "LogicalExpression" &&
+            currentTerm.operator === operator) {
+            pendingTerms.push(currentTerm.right, currentTerm.left);
+            continue;
+        }
+        flattenedTerms.push(currentTerm);
+    }
+    return flattenedTerms;
+};
+const STRICT_NULLISH_TERM_COUNT = 2;
+/**
+ * Narrow a list of expressions to an exact two-term tuple.
+ */
+export const isExpressionPair = (terms) => terms.length === STRICT_NULLISH_TERM_COUNT;
+/**
+ * Check whether an expression is the literal `null`.
+ */
+const isNullLiteral = (expression) => expression.type === "Literal" && expression.value === null;
+/**
+ * Check whether an expression is the string literal `"undefined"`.
+ */
+const isUndefinedStringLiteral = (expression) => expression.type === "Literal" && expression.value === "undefined";
+/**
+ * Check whether an expression is `typeof <identifierName>`.
+ */
+const isTypeofIdentifierExpression = (expression, identifierName) => expression.type === "UnaryExpression" &&
+    expression.operator === "typeof" &&
+    expression.argument.type === "Identifier" &&
+    expression.argument.name === identifierName;
+/**
+ * Narrow a binary-operator string to supported nullish comparison operators.
+ */
+const isAllowedNullishComparisonOperator = (operator) => operator === "!=" ||
+    operator === "!==" ||
+    operator === "==" ||
+    operator === "===";
+/**
+ * Narrow an ESTree expression-like union to regular expressions (excluding
+ * private identifiers).
+ */
+const isExpressionNode = (expression) => expression.type !== "PrivateIdentifier";
+/**
+ * Extract a normalized nullish comparison from an expression.
+ */
+export const getNullishComparison = ({ allowedOperators = defaultNullishComparisonOperators, allowTypeofComparedIdentifierForUndefined = false, comparedIdentifierName, expression, isGlobalUndefinedIdentifier, }) => {
+    if (expression.type !== "BinaryExpression") {
+        return null;
+    }
+    if (!isAllowedNullishComparisonOperator(expression.operator)) {
+        return null;
+    }
+    if (allowedOperators !== defaultNullishComparisonOperators &&
+        !arrayIncludes(allowedOperators, expression.operator)) {
+        return null;
+    }
+    const matchesComparedExpression = (candidateExpression) => !isDefined(comparedIdentifierName) ||
+        (candidateExpression.type === "Identifier" &&
+            candidateExpression.name === comparedIdentifierName);
+    if (isNullLiteral(expression.right) &&
+        isExpressionNode(expression.left) &&
+        matchesComparedExpression(expression.left)) {
+        return {
+            comparedExpression: expression.left,
+            kind: "null",
+            operator: expression.operator,
+        };
+    }
+    if (isExpressionNode(expression.left) &&
+        isNullLiteral(expression.left) &&
+        isExpressionNode(expression.right) &&
+        matchesComparedExpression(expression.right)) {
+        return {
+            comparedExpression: expression.right,
+            kind: "null",
+            operator: expression.operator,
+        };
+    }
+    if (expression.right.type === "Identifier" &&
+        isGlobalUndefinedIdentifier(expression.right) &&
+        isExpressionNode(expression.left) &&
+        matchesComparedExpression(expression.left)) {
+        return {
+            comparedExpression: expression.left,
+            kind: "undefined",
+            operator: expression.operator,
+        };
+    }
+    if (expression.left.type === "Identifier" &&
+        isGlobalUndefinedIdentifier(expression.left) &&
+        isExpressionNode(expression.right) &&
+        matchesComparedExpression(expression.right)) {
+        return {
+            comparedExpression: expression.right,
+            kind: "undefined",
+            operator: expression.operator,
+        };
+    }
+    if (!isDefined(comparedIdentifierName) ||
+        !allowTypeofComparedIdentifierForUndefined) {
+        return null;
+    }
+    if (isExpressionNode(expression.left) &&
+        isExpressionNode(expression.right) &&
+        isTypeofIdentifierExpression(expression.left, comparedIdentifierName) &&
+        isUndefinedStringLiteral(expression.right)) {
+        return {
+            comparedExpression: expression.left.argument,
+            kind: "undefined",
+            operator: expression.operator,
+        };
+    }
+    if (isExpressionNode(expression.right) &&
+        isExpressionNode(expression.left) &&
+        isTypeofIdentifierExpression(expression.right, comparedIdentifierName) &&
+        isUndefinedStringLiteral(expression.left)) {
+        return {
+            comparedExpression: expression.right.argument,
+            kind: "undefined",
+            operator: expression.operator,
+        };
+    }
+    return null;
+};
+//# sourceMappingURL=nullish-comparison.js.map

package/dist/_internal/nullish-comparison.js.map

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

package/dist/_internal/plugin-settings.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @packageDocumentation
+ * Parsing and memoization helpers for plugin-level runtime settings.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+/**
+ * Normalized per-program settings consumed by fix-generation helpers.
+ */
+type ProgramSettings = {
+    disableAllAutofixes: boolean;
+    disableImportInsertionFixes: boolean;
+};
+/**
+ * Register parsed plugin settings for the current file program.
+ *
+ * @param context - Active ESLint rule context.
+ *
+ * @returns Memoized immutable settings for the context's program node.
+ */
+export declare const registerProgramSettingsForContext: (context: Readonly<TSESLint.RuleContext<string, UnknownArray>>) => Readonly<ProgramSettings>;
+/**
+ * Determine whether import insertion autofixes are globally disabled for the
+ * file containing the provided node.
+ *
+ * @param node - AST node used to resolve the enclosing Program.
+ *
+ * @returns `true` when import insertion fixes should be suppressed.
+ */
+export declare const isImportInsertionFixesDisabledForNode: (node: Readonly<TSESTree.Node>) => boolean;
+export {};
+//# sourceMappingURL=plugin-settings.d.ts.map

package/dist/_internal/plugin-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-settings.d.ts","sourceRoot":"","sources":["../../src/_internal/plugin-settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,WAAW,CAAC;AAe1D;;GAEG;AACH,KAAK,eAAe,GAAG;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,2BAA2B,EAAE,OAAO,CAAC;CACxC,CAAC;AA0FF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,GAC1C,SAAS,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,KAC9D,QAAQ,CAAC,eAAe,CA2B1B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,GAC9C,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAC9B,OASF,CAAC"}

package/dist/_internal/plugin-settings.js

@@ -0,0 +1,118 @@
+import { isPresent, objectHasOwn } from "ts-extras";
+import { getProgramNode } from "./ast-node.js";
+/** Top-level `settings` key for this plugin. */
+const TYPEFEST_SETTINGS_KEY = "typefest";
+/** Flag that disables all plugin autofix behavior. */
+const DISABLE_ALL_AUTOFIXES_KEY = "disableAllAutofixes";
+/** Flag that disables import-insertion fix helpers only. */
+const DISABLE_IMPORT_INSERTION_FIXES_KEY = "disableImportInsertionFixes";
+/**
+ * Cache of parsed settings keyed by the Program node for the active file.
+ */
+const settingsByProgram = new WeakMap();
+/**
+ * Narrow an unknown value to a JSON-object-like record.
+ *
+ * @param value - Value to narrow.
+ *
+ * @returns `true` when the value is a non-null, non-array object.
+ */
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+ * Extract the `settings.typefest` object when present and valid.
+ *
+ * @param settings - ESLint settings value from rule context.
+ *
+ * @returns Parsed `settings.typefest` object when valid; otherwise `null`.
+ */
+const getTypefestSettings = (settings) => {
+    if (!isObject(settings)) {
+        return null;
+    }
+    const typefestSettings = settings[TYPEFEST_SETTINGS_KEY];
+    return isObject(typefestSettings) ? typefestSettings : null;
+};
+/**
+ * Read a strict boolean flag (`true`) from a JSON object by key.
+ *
+ * @param object - Source settings object.
+ * @param key - Flag key to read.
+ *
+ * @returns `true` only when the key exists and equals literal `true`.
+ */
+const readBooleanFlag = (object, key) => objectHasOwn(object, key) && object[key] === true;
+/**
+ * Reads the import-insertion disable flag from plugin settings.
+ *
+ * @param settings - ESLint settings value from rule context.
+ *
+ * @returns `true` when import insertion fixes are explicitly disabled.
+ */
+const readDisableImportInsertionFixesFromSettings = (settings) => {
+    const typefestSettings = getTypefestSettings(settings);
+    if (!isPresent(typefestSettings)) {
+        return false;
+    }
+    return readBooleanFlag(typefestSettings, DISABLE_IMPORT_INSERTION_FIXES_KEY);
+};
+/**
+ * Reads the global autofix disable flag from plugin settings.
+ *
+ * @param settings - ESLint settings value from rule context.
+ *
+ * @returns `true` when all plugin autofixes are explicitly disabled.
+ */
+const readDisableAllAutofixesFromSettings = (settings) => {
+    const typefestSettings = getTypefestSettings(settings);
+    if (!isPresent(typefestSettings)) {
+        return false;
+    }
+    return readBooleanFlag(typefestSettings, DISABLE_ALL_AUTOFIXES_KEY);
+};
+/**
+ * Guard values suitable for WeakMap object keys.
+ */
+const isWeakMapKeyObject = (value) => typeof value === "object" && value !== null;
+/**
+ * Register parsed plugin settings for the current file program.
+ *
+ * @param context - Active ESLint rule context.
+ *
+ * @returns Memoized immutable settings for the context's program node.
+ */
+export const registerProgramSettingsForContext = (context) => {
+    const programNode = context.sourceCode.ast;
+    const disableAllAutofixes = readDisableAllAutofixesFromSettings(context.settings);
+    const disableImportInsertionFixes = disableAllAutofixes ||
+        readDisableImportInsertionFixesFromSettings(context.settings);
+    const parsedSettings = Object.freeze({
+        disableAllAutofixes,
+        disableImportInsertionFixes,
+    });
+    if (!isWeakMapKeyObject(programNode)) {
+        return parsedSettings;
+    }
+    const existingProgramSettings = settingsByProgram.get(programNode);
+    if (isPresent(existingProgramSettings)) {
+        return existingProgramSettings;
+    }
+    settingsByProgram.set(programNode, parsedSettings);
+    return parsedSettings;
+};
+/**
+ * Determine whether import insertion autofixes are globally disabled for the
+ * file containing the provided node.
+ *
+ * @param node - AST node used to resolve the enclosing Program.
+ *
+ * @returns `true` when import insertion fixes should be suppressed.
+ */
+export const isImportInsertionFixesDisabledForNode = (node) => {
+    const programNode = getProgramNode(node);
+    if (!isPresent(programNode)) {
+        return false;
+    }
+    const settings = settingsByProgram.get(programNode);
+    return settings?.disableImportInsertionFixes === true;
+};
+//# sourceMappingURL=plugin-settings.js.map

package/dist/_internal/plugin-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-settings.js","sourceRoot":"","sources":["../../src/_internal/plugin-settings.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,gDAAgD;AAChD,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEzC,sDAAsD;AACtD,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAExD,4DAA4D;AAC5D,MAAM,kCAAkC,GAAG,6BAA6B,CAAC;AAUzE;;GAEG;AACH,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAqC,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAiC,EAAE,CAC/D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,CACxB,QAAiB,EACU,EAAE;IAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAEzD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,eAAe,GAAG,CAAC,MAA4B,EAAE,GAAW,EAAW,EAAE,CAC3E,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,2CAA2C,GAAG,CAChD,QAAiB,EACV,EAAE;IACT,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,eAAe,CAClB,gBAAgB,EAChB,kCAAkC,CACrC,CAAC;AACN,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,mCAAmC,GAAG,CAAC,QAAiB,EAAW,EAAE;IACvE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,eAAe,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;AACxE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC7C,OAA6D,EACpC,EAAE;IAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;IAE3C,MAAM,mBAAmB,GAAG,mCAAmC,CAC3D,OAAO,CAAC,QAAQ,CACnB,CAAC;IACF,MAAM,2BAA2B,GAC7B,mBAAmB;QACnB,2CAA2C,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElE,MAAM,cAAc,GAA8B,MAAM,CAAC,MAAM,CAAC;QAC5D,mBAAmB;QACnB,2BAA2B;KAC9B,CAAC,CAAC;IAEH,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACnE,IAAI,SAAS,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACrC,OAAO,uBAAuB,CAAC;IACnC,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAEnD,OAAO,cAAc,CAAC;AAC1B,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CACjD,IAA6B,EACtB,EAAE;IACT,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEpD,OAAO,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAC;AAC1D,CAAC,CAAC"}

package/dist/_internal/report-adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @packageDocumentation
+ * Explicit report-adapter utilities for rule-level autofix policy handling.
+ */
+import type { TSESLint } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+/**
+ * Report callback type for a given message/options pair.
+ */
+type ReportCallback<MessageIds extends string, Options extends Readonly<UnknownArray>> = TSESLint.RuleContext<MessageIds, Options>["report"];
+/**
+ * Canonical report descriptor type for a given message/options pair.
+ */
+type ReportDescriptor<MessageIds extends string, Options extends Readonly<UnknownArray>> = Parameters<ReportCallback<MessageIds, Options>>[0];
+/**
+ * Remove top-level autofix from a report descriptor while preserving all other
+ * fields (including suggestions).
+ */
+export declare const omitAutofixFromReportDescriptor: <MessageIds extends string, Options extends Readonly<UnknownArray>>(descriptor: Readonly<ReportDescriptor<MessageIds, Options>>) => ReportDescriptor<MessageIds, Options>;
+/**
+ * Build a report callback that enforces no-top-level-autofix semantics.
+ */
+export declare const createReportWithoutAutofixes: <MessageIds extends string, Options extends Readonly<UnknownArray>>(report: ReportCallback<MessageIds, Options>) => ReportCallback<MessageIds, Options>;
+export {};
+//# sourceMappingURL=report-adapter.d.ts.map

package/dist/_internal/report-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-adapter.d.ts","sourceRoot":"","sources":["../../src/_internal/report-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C;;GAEG;AACH,KAAK,cAAc,CACf,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,IACtC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;AAExD;;GAEG;AACH,KAAK,gBAAgB,CACjB,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,IACtC,UAAU,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAwBvD;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GACxC,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,EAEtC,YAAY,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,KAC5D,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAYtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,GACpC,UAAU,SAAS,MAAM,EAAE,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,EAC9D,QAAQ,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,KAC5C,cAAc,CAAC,UAAU,EAAE,OAAO,CAGpC,CAAC"}

package/dist/_internal/report-adapter.js

@@ -0,0 +1,36 @@
+import { isDefined, objectHasOwn } from "ts-extras";
+/**
+ * Determine whether a report descriptor has a callable own data-property `fix`
+ * value that can be safely omitted.
+ */
+const hasCallableOwnFixDataProperty = (descriptor) => {
+    const ownFixDescriptor = Object.getOwnPropertyDescriptor(descriptor, "fix");
+    if (!isDefined(ownFixDescriptor)) {
+        return false;
+    }
+    if (!objectHasOwn(ownFixDescriptor, "value")) {
+        return false;
+    }
+    return typeof ownFixDescriptor.value === "function";
+};
+/**
+ * Remove top-level autofix from a report descriptor while preserving all other
+ * fields (including suggestions).
+ */
+export const omitAutofixFromReportDescriptor = (descriptor) => {
+    if (!hasCallableOwnFixDataProperty(descriptor)) {
+        return descriptor;
+    }
+    const descriptorWithoutFix = {
+        ...descriptor,
+    };
+    delete descriptorWithoutFix.fix;
+    return descriptorWithoutFix;
+};
+/**
+ * Build a report callback that enforces no-top-level-autofix semantics.
+ */
+export const createReportWithoutAutofixes = (report) => (descriptor) => {
+    report(omitAutofixFromReportDescriptor(descriptor));
+};
+//# sourceMappingURL=report-adapter.js.map

package/dist/_internal/report-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-adapter.js","sourceRoot":"","sources":["../../src/_internal/report-adapter.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAkBpD;;;GAGG;AACH,MAAM,6BAA6B,GAAG,CAIlC,UAA2D,EACpD,EAAE;IACT,MAAM,gBAAgB,GAAG,MAAM,CAAC,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC5E,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,gBAAgB,CAAC,KAAK,KAAK,UAAU,CAAC;AACxD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAI3C,UAA2D,EACtB,EAAE;IACvC,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,MAAM,oBAAoB,GAAG;QACzB,GAAG,UAAU;KAChB,CAAC;IAEF,OAAO,oBAAoB,CAAC,GAAG,CAAC;IAEhC,OAAO,oBAAoB,CAAC;AAChC,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACrC,CACI,MAA2C,EACR,EAAE,CACzC,CAAC,UAAU,EAAE,EAAE;IACX,MAAM,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC,CAAC;AACxD,CAAC,CAAC"}