eslint-plugin-typefest 1.0.1

package/dist/_internal/rule-reporting.js

@@ -0,0 +1,89 @@
+import { registerProgramSettingsForContext } from "./plugin-settings.js";
+import { omitAutofixFromReportDescriptor } from "./report-adapter.js";
+/**
+ * Report using plugin-aware autofix policy handling.
+ */
+export const reportWithTypefestPolicy = ({ context, descriptor, }) => {
+    const settings = registerProgramSettingsForContext(context);
+    if (!settings.disableAllAutofixes) {
+        context.report(descriptor);
+        return;
+    }
+    context.report(omitAutofixFromReportDescriptor(descriptor));
+};
+/**
+ * Report a diagnostic with an optional direct fix.
+ *
+ * @remarks
+ * When `fix` is absent this reports only `messageId` + `node`.
+ */
+export const reportWithOptionalFix = ({ context, data, fix, messageId, node, }) => {
+    const descriptor = {
+        ...(data === undefined ? {} : { data }),
+        ...(fix === null ? {} : { fix }),
+        messageId,
+        node,
+    };
+    reportWithTypefestPolicy({
+        context,
+        descriptor,
+    });
+};
+/**
+ * Resolve one of three standardized reporting outcomes:
+ *
+ * - No fix (`messageId` only),
+ * - Direct autofix (`fix`), or
+ * - Suggestion-only (`suggest`).
+ */
+export function resolveAutofixOrSuggestionOutcome({ canAutofix, fix, }) {
+    if (fix === null) {
+        return {
+            kind: "no-fix",
+        };
+    }
+    if (canAutofix) {
+        return {
+            fix,
+            kind: "autofix",
+        };
+    }
+    return {
+        fix,
+        kind: "suggestion",
+    };
+}
+/**
+ * Report a previously resolved autofix/suggestion outcome.
+ *
+ * @remarks
+ * - Suggestion outcomes are reported with a single `suggest` entry.
+ * - Autofix and no-fix outcomes are delegated to {@link reportWithOptionalFix}.
+ */
+export const reportResolvedAutofixOrSuggestionOutcome = ({ context, data, messageId, node, outcome, suggestionMessageId, }) => {
+    if (outcome.kind === "suggestion") {
+        reportWithTypefestPolicy({
+            context,
+            descriptor: {
+                ...(data === undefined ? {} : { data }),
+                messageId,
+                node,
+                suggest: [
+                    {
+                        fix: outcome.fix,
+                        messageId: suggestionMessageId,
+                    },
+                ],
+            },
+        });
+        return;
+    }
+    reportWithOptionalFix({
+        context,
+        data,
+        fix: outcome.kind === "autofix" ? outcome.fix : null,
+        messageId,
+        node,
+    });
+};
+//# sourceMappingURL=rule-reporting.js.map

package/dist/_internal/rule-reporting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-reporting.js","sourceRoot":"","sources":["../../src/_internal/rule-reporting.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAsBtE;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAGtC,EACE,OAAO,EACP,UAAU,GAIZ,EAAQ,EAAE;IACR,MAAM,QAAQ,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAE5D,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE3B,OAAO;IACX,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAGnC,EACE,OAAO,EACP,IAAI,EACJ,GAAG,EACH,SAAS,EACT,IAAI,GAON,EAAQ,EAAE;IACR,MAAM,UAAU,GAA0C;QACtD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QAChC,SAAS;QACT,IAAI;KACP,CAAC;IAEF,wBAAwB,CAAC;QACrB,OAAO;QACP,UAAU;KACb,CAAC,CAAC;AACP,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAAC,EAC9C,UAAU,EACV,GAAG,GAC8B;IACjC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,OAAO;YACH,IAAI,EAAE,QAAQ;SACjB,CAAC;IACN,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACb,OAAO;YACH,GAAG;YACH,IAAI,EAAE,SAAS;SAClB,CAAC;IACN,CAAC;IAED,OAAO;QACH,GAAG;QACH,IAAI,EAAE,YAAY;KACrB,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAGtD,EACE,OAAO,EACP,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,OAAO,EACP,mBAAmB,GAQrB,EAAQ,EAAE;IACR,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,wBAAwB,CAAC;YACrB,OAAO;YACP,UAAU,EAAE;gBACR,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACvC,SAAS;gBACT,IAAI;gBACJ,OAAO,EAAE;oBACL;wBACI,GAAG,EAAE,OAAO,CAAC,GAAG;wBAChB,SAAS,EAAE,mBAAmB;qBACjC;iBACJ;aACJ;SACJ,CAAC,CAAC;QAEH,OAAO;IACX,CAAC;IAED,qBAAqB,CAAC;QAClB,OAAO;QACP,IAAI;QACJ,GAAG,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QACpD,SAAS;QACT,IAAI;KACP,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/_internal/rules-registry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @packageDocumentation
+ * Canonical runtime registry of all rule modules shipped by eslint-plugin-typefest.
+ */
+import type { TSESLint } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+/** Runtime rule module shape used by registry/preset builders. */
+export type RuleWithDocs = TSESLint.RuleModule<string, UnknownArray>;
+/** Pattern for unqualified rule names supported by `eslint-plugin-typefest`. */
+export type TypefestRuleNamePattern = `prefer-${string}`;
+/** Exported typed view consumed by the plugin entrypoint. */
+export declare const typefestRules: Readonly<Record<TypefestRuleNamePattern, RuleWithDocs>>;
+export default typefestRules;
+//# sourceMappingURL=rules-registry.d.ts.map

package/dist/_internal/rules-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-registry.d.ts","sourceRoot":"","sources":["../../src/_internal/rules-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA+E9C,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAErE,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG,UAAU,MAAM,EAAE,CAAC;AA0FzD,6DAA6D;AAC7D,eAAO,MAAM,aAAa,EAAE,QAAQ,CAChC,MAAM,CAAC,uBAAuB,EAAE,YAAY,CAAC,CACzB,CAAC;AAEzB,eAAe,aAAa,CAAC"}

package/dist/_internal/rules-registry.js

@@ -0,0 +1,165 @@
+/**
+ * @packageDocumentation
+ * Canonical runtime registry of all rule modules shipped by eslint-plugin-typefest.
+ */
+import preferTsExtrasArrayAtRule from "../rules/prefer-ts-extras-array-at.js";
+import preferTsExtrasArrayConcatRule from "../rules/prefer-ts-extras-array-concat.js";
+import preferTsExtrasArrayFindLastIndexRule from "../rules/prefer-ts-extras-array-find-last-index.js";
+import preferTsExtrasArrayFindLastRule from "../rules/prefer-ts-extras-array-find-last.js";
+import preferTsExtrasArrayFindRule from "../rules/prefer-ts-extras-array-find.js";
+import preferTsExtrasArrayFirstRule from "../rules/prefer-ts-extras-array-first.js";
+import preferTsExtrasArrayIncludesRule from "../rules/prefer-ts-extras-array-includes.js";
+import preferTsExtrasArrayJoinRule from "../rules/prefer-ts-extras-array-join.js";
+import preferTsExtrasArrayLastRule from "../rules/prefer-ts-extras-array-last.js";
+import preferTsExtrasAsWritableRule from "../rules/prefer-ts-extras-as-writable.js";
+import preferTsExtrasAssertDefinedRule from "../rules/prefer-ts-extras-assert-defined.js";
+import preferTsExtrasAssertErrorRule from "../rules/prefer-ts-extras-assert-error.js";
+import preferTsExtrasAssertPresentRule from "../rules/prefer-ts-extras-assert-present.js";
+import preferTsExtrasIsDefinedFilterRule from "../rules/prefer-ts-extras-is-defined-filter.js";
+import preferTsExtrasIsDefinedRule from "../rules/prefer-ts-extras-is-defined.js";
+import preferTsExtrasIsEmptyRule from "../rules/prefer-ts-extras-is-empty.js";
+import preferTsExtrasIsEqualTypeRule from "../rules/prefer-ts-extras-is-equal-type.js";
+import preferTsExtrasIsFiniteRule from "../rules/prefer-ts-extras-is-finite.js";
+import preferTsExtrasIsInfiniteRule from "../rules/prefer-ts-extras-is-infinite.js";
+import preferTsExtrasIsIntegerRule from "../rules/prefer-ts-extras-is-integer.js";
+import preferTsExtrasIsPresentFilterRule from "../rules/prefer-ts-extras-is-present-filter.js";
+import preferTsExtrasIsPresentRule from "../rules/prefer-ts-extras-is-present.js";
+import preferTsExtrasIsSafeIntegerRule from "../rules/prefer-ts-extras-is-safe-integer.js";
+import preferTsExtrasKeyInRule from "../rules/prefer-ts-extras-key-in.js";
+import preferTsExtrasNotRule from "../rules/prefer-ts-extras-not.js";
+import preferTsExtrasObjectEntriesRule from "../rules/prefer-ts-extras-object-entries.js";
+import preferTsExtrasObjectFromEntriesRule from "../rules/prefer-ts-extras-object-from-entries.js";
+import preferTsExtrasObjectHasInRule from "../rules/prefer-ts-extras-object-has-in.js";
+import preferTsExtrasObjectHasOwnRule from "../rules/prefer-ts-extras-object-has-own.js";
+import preferTsExtrasObjectKeysRule from "../rules/prefer-ts-extras-object-keys.js";
+import preferTsExtrasObjectValuesRule from "../rules/prefer-ts-extras-object-values.js";
+import preferTsExtrasSafeCastToRule from "../rules/prefer-ts-extras-safe-cast-to.js";
+import preferTsExtrasSetHasRule from "../rules/prefer-ts-extras-set-has.js";
+import preferTsExtrasStringSplitRule from "../rules/prefer-ts-extras-string-split.js";
+import preferTypeFestAbstractConstructorRule from "../rules/prefer-type-fest-abstract-constructor.js";
+import preferTypeFestArrayableRule from "../rules/prefer-type-fest-arrayable.js";
+import preferTypeFestAsyncReturnTypeRule from "../rules/prefer-type-fest-async-return-type.js";
+import preferTypeFestConditionalPickRule from "../rules/prefer-type-fest-conditional-pick.js";
+import preferTypeFestConstructorRule from "../rules/prefer-type-fest-constructor.js";
+import preferTypeFestExceptRule from "../rules/prefer-type-fest-except.js";
+import preferTypeFestIfRule from "../rules/prefer-type-fest-if.js";
+import preferTypeFestIterableElementRule from "../rules/prefer-type-fest-iterable-element.js";
+import preferTypeFestJsonArrayRule from "../rules/prefer-type-fest-json-array.js";
+import preferTypeFestJsonObjectRule from "../rules/prefer-type-fest-json-object.js";
+import preferTypeFestJsonPrimitiveRule from "../rules/prefer-type-fest-json-primitive.js";
+import preferTypeFestJsonValueRule from "../rules/prefer-type-fest-json-value.js";
+import preferTypeFestKeysOfUnionRule from "../rules/prefer-type-fest-keys-of-union.js";
+import preferTypeFestLiteralUnionRule from "../rules/prefer-type-fest-literal-union.js";
+import preferTypeFestMergeExclusiveRule from "../rules/prefer-type-fest-merge-exclusive.js";
+import preferTypeFestNonEmptyTupleRule from "../rules/prefer-type-fest-non-empty-tuple.js";
+import preferTypeFestOmitIndexSignatureRule from "../rules/prefer-type-fest-omit-index-signature.js";
+import preferTypeFestPartialDeepRule from "../rules/prefer-type-fest-partial-deep.js";
+import preferTypeFestPrimitiveRule from "../rules/prefer-type-fest-primitive.js";
+import preferTypeFestPromisableRule from "../rules/prefer-type-fest-promisable.js";
+import preferTypeFestReadonlyDeepRule from "../rules/prefer-type-fest-readonly-deep.js";
+import preferTypeFestRequireAllOrNoneRule from "../rules/prefer-type-fest-require-all-or-none.js";
+import preferTypeFestRequireAtLeastOneRule from "../rules/prefer-type-fest-require-at-least-one.js";
+import preferTypeFestRequireExactlyOneRule from "../rules/prefer-type-fest-require-exactly-one.js";
+import preferTypeFestRequireOneOrNoneRule from "../rules/prefer-type-fest-require-one-or-none.js";
+import preferTypeFestRequiredDeepRule from "../rules/prefer-type-fest-required-deep.js";
+import preferTypeFestSchemaRule from "../rules/prefer-type-fest-schema.js";
+import preferTypeFestSetNonNullableRule from "../rules/prefer-type-fest-set-non-nullable.js";
+import preferTypeFestSetOptionalRule from "../rules/prefer-type-fest-set-optional.js";
+import preferTypeFestSetReadonlyRule from "../rules/prefer-type-fest-set-readonly.js";
+import preferTypeFestSetRequiredRule from "../rules/prefer-type-fest-set-required.js";
+import preferTypeFestSimplifyRule from "../rules/prefer-type-fest-simplify.js";
+import preferTypeFestTaggedBrandsRule from "../rules/prefer-type-fest-tagged-brands.js";
+import preferTypeFestTupleOfRule from "../rules/prefer-type-fest-tuple-of.js";
+import preferTypeFestUnknownArrayRule from "../rules/prefer-type-fest-unknown-array.js";
+import preferTypeFestUnknownMapRule from "../rules/prefer-type-fest-unknown-map.js";
+import preferTypeFestUnknownRecordRule from "../rules/prefer-type-fest-unknown-record.js";
+import preferTypeFestUnknownSetRule from "../rules/prefer-type-fest-unknown-set.js";
+import preferTypeFestUnwrapTaggedRule from "../rules/prefer-type-fest-unwrap-tagged.js";
+import preferTypeFestValueOfRule from "../rules/prefer-type-fest-value-of.js";
+import preferTypeFestWritableDeepRule from "../rules/prefer-type-fest-writable-deep.js";
+import preferTypeFestWritableRule from "../rules/prefer-type-fest-writable.js";
+/**
+ * Runtime map of all rule modules keyed by unqualified rule name.
+ */
+const typefestRuleRegistry = {
+    "prefer-ts-extras-array-at": preferTsExtrasArrayAtRule,
+    "prefer-ts-extras-array-concat": preferTsExtrasArrayConcatRule,
+    "prefer-ts-extras-array-find": preferTsExtrasArrayFindRule,
+    "prefer-ts-extras-array-find-last": preferTsExtrasArrayFindLastRule,
+    "prefer-ts-extras-array-find-last-index": preferTsExtrasArrayFindLastIndexRule,
+    "prefer-ts-extras-array-first": preferTsExtrasArrayFirstRule,
+    "prefer-ts-extras-array-includes": preferTsExtrasArrayIncludesRule,
+    "prefer-ts-extras-array-join": preferTsExtrasArrayJoinRule,
+    "prefer-ts-extras-array-last": preferTsExtrasArrayLastRule,
+    "prefer-ts-extras-as-writable": preferTsExtrasAsWritableRule,
+    "prefer-ts-extras-assert-defined": preferTsExtrasAssertDefinedRule,
+    "prefer-ts-extras-assert-error": preferTsExtrasAssertErrorRule,
+    "prefer-ts-extras-assert-present": preferTsExtrasAssertPresentRule,
+    "prefer-ts-extras-is-defined": preferTsExtrasIsDefinedRule,
+    "prefer-ts-extras-is-defined-filter": preferTsExtrasIsDefinedFilterRule,
+    "prefer-ts-extras-is-empty": preferTsExtrasIsEmptyRule,
+    "prefer-ts-extras-is-equal-type": preferTsExtrasIsEqualTypeRule,
+    "prefer-ts-extras-is-finite": preferTsExtrasIsFiniteRule,
+    "prefer-ts-extras-is-infinite": preferTsExtrasIsInfiniteRule,
+    "prefer-ts-extras-is-integer": preferTsExtrasIsIntegerRule,
+    "prefer-ts-extras-is-present": preferTsExtrasIsPresentRule,
+    "prefer-ts-extras-is-present-filter": preferTsExtrasIsPresentFilterRule,
+    "prefer-ts-extras-is-safe-integer": preferTsExtrasIsSafeIntegerRule,
+    "prefer-ts-extras-key-in": preferTsExtrasKeyInRule,
+    "prefer-ts-extras-not": preferTsExtrasNotRule,
+    "prefer-ts-extras-object-entries": preferTsExtrasObjectEntriesRule,
+    "prefer-ts-extras-object-from-entries": preferTsExtrasObjectFromEntriesRule,
+    "prefer-ts-extras-object-has-in": preferTsExtrasObjectHasInRule,
+    "prefer-ts-extras-object-has-own": preferTsExtrasObjectHasOwnRule,
+    "prefer-ts-extras-object-keys": preferTsExtrasObjectKeysRule,
+    "prefer-ts-extras-object-values": preferTsExtrasObjectValuesRule,
+    "prefer-ts-extras-safe-cast-to": preferTsExtrasSafeCastToRule,
+    "prefer-ts-extras-set-has": preferTsExtrasSetHasRule,
+    "prefer-ts-extras-string-split": preferTsExtrasStringSplitRule,
+    "prefer-type-fest-abstract-constructor": preferTypeFestAbstractConstructorRule,
+    "prefer-type-fest-arrayable": preferTypeFestArrayableRule,
+    "prefer-type-fest-async-return-type": preferTypeFestAsyncReturnTypeRule,
+    "prefer-type-fest-conditional-pick": preferTypeFestConditionalPickRule,
+    "prefer-type-fest-constructor": preferTypeFestConstructorRule,
+    "prefer-type-fest-except": preferTypeFestExceptRule,
+    "prefer-type-fest-if": preferTypeFestIfRule,
+    "prefer-type-fest-iterable-element": preferTypeFestIterableElementRule,
+    "prefer-type-fest-json-array": preferTypeFestJsonArrayRule,
+    "prefer-type-fest-json-object": preferTypeFestJsonObjectRule,
+    "prefer-type-fest-json-primitive": preferTypeFestJsonPrimitiveRule,
+    "prefer-type-fest-json-value": preferTypeFestJsonValueRule,
+    "prefer-type-fest-keys-of-union": preferTypeFestKeysOfUnionRule,
+    "prefer-type-fest-literal-union": preferTypeFestLiteralUnionRule,
+    "prefer-type-fest-merge-exclusive": preferTypeFestMergeExclusiveRule,
+    "prefer-type-fest-non-empty-tuple": preferTypeFestNonEmptyTupleRule,
+    "prefer-type-fest-omit-index-signature": preferTypeFestOmitIndexSignatureRule,
+    "prefer-type-fest-partial-deep": preferTypeFestPartialDeepRule,
+    "prefer-type-fest-primitive": preferTypeFestPrimitiveRule,
+    "prefer-type-fest-promisable": preferTypeFestPromisableRule,
+    "prefer-type-fest-readonly-deep": preferTypeFestReadonlyDeepRule,
+    "prefer-type-fest-require-all-or-none": preferTypeFestRequireAllOrNoneRule,
+    "prefer-type-fest-require-at-least-one": preferTypeFestRequireAtLeastOneRule,
+    "prefer-type-fest-require-exactly-one": preferTypeFestRequireExactlyOneRule,
+    "prefer-type-fest-require-one-or-none": preferTypeFestRequireOneOrNoneRule,
+    "prefer-type-fest-required-deep": preferTypeFestRequiredDeepRule,
+    "prefer-type-fest-schema": preferTypeFestSchemaRule,
+    "prefer-type-fest-set-non-nullable": preferTypeFestSetNonNullableRule,
+    "prefer-type-fest-set-optional": preferTypeFestSetOptionalRule,
+    "prefer-type-fest-set-readonly": preferTypeFestSetReadonlyRule,
+    "prefer-type-fest-set-required": preferTypeFestSetRequiredRule,
+    "prefer-type-fest-simplify": preferTypeFestSimplifyRule,
+    "prefer-type-fest-tagged-brands": preferTypeFestTaggedBrandsRule,
+    "prefer-type-fest-tuple-of": preferTypeFestTupleOfRule,
+    "prefer-type-fest-unknown-array": preferTypeFestUnknownArrayRule,
+    "prefer-type-fest-unknown-map": preferTypeFestUnknownMapRule,
+    "prefer-type-fest-unknown-record": preferTypeFestUnknownRecordRule,
+    "prefer-type-fest-unknown-set": preferTypeFestUnknownSetRule,
+    "prefer-type-fest-unwrap-tagged": preferTypeFestUnwrapTaggedRule,
+    "prefer-type-fest-value-of": preferTypeFestValueOfRule,
+    "prefer-type-fest-writable": preferTypeFestWritableRule,
+    "prefer-type-fest-writable-deep": preferTypeFestWritableDeepRule,
+};
+/** Exported typed view consumed by the plugin entrypoint. */
+export const typefestRules = typefestRuleRegistry;
+export default typefestRules;
+//# sourceMappingURL=rules-registry.js.map

package/dist/_internal/rules-registry.js.map

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

package/dist/_internal/safe-type-operation.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @packageDocumentation
+ * Structured error handling for best-effort typed AST operations.
+ */
+/**
+ * Counter contract used by test-time debug instrumentation.
+ */
+export type SafeTypeOperationCounter<Reason extends string> = Readonly<{
+    getSnapshot: () => ReadonlyMap<Reason, number>;
+    onFailure: (failure: Readonly<{
+        error: unknown;
+        reason: Reason;
+    }>) => void;
+}>;
+/**
+ * Failure payload emitted when a safe typed operation throws.
+ */
+export type SafeTypeOperationFailure<Reason extends string> = Readonly<{
+    error: unknown;
+    reason: Reason;
+}>;
+/**
+ * Optional observer called whenever an operation fails.
+ */
+export type SafeTypeOperationFailureObserver<Reason extends string> = (failure: Readonly<SafeTypeOperationFailure<Reason>>) => void;
+/**
+ * Failure payload emitted when an observer itself throws.
+ */
+export type SafeTypeOperationObserverFailure<Reason extends string> = Readonly<{
+    failure: Readonly<SafeTypeOperationFailure<Reason>>;
+    observerError: unknown;
+    observerKind: "global" | "local";
+}>;
+/**
+ * Optional observer called when an operation failure observer throws.
+ */
+export type SafeTypeOperationObserverFailureObserver<Reason extends string> = (failure: Readonly<SafeTypeOperationObserverFailure<Reason>>) => void;
+/**
+ * Register a process-local observer for observer failures.
+ *
+ * @param observer - Callback invoked when a local/global failure observer
+ *   throws.
+ *
+ * @returns Unsubscribe callback to remove the observer.
+ */
+export declare const registerSafeTypeOperationObserverFailureObserver: (observer: SafeTypeOperationObserverFailureObserver<string>) => (() => void);
+/**
+ * Register a process-local failure observer for typed operations.
+ *
+ * @param observer - Callback invoked for each operation failure.
+ *
+ * @returns Unsubscribe callback to remove the observer.
+ */
+export declare const registerSafeTypeOperationFailureObserver: (observer: SafeTypeOperationFailureObserver<string>) => (() => void);
+/**
+ * Run one operation with a scoped failure observer that is always cleaned up.
+ *
+ * @param observer - Observer registered for the operation scope.
+ * @param operation - Synchronous operation to execute while observing failures.
+ *
+ * @returns Return value produced by `operation`.
+ */
+export declare const withSafeTypeOperationFailureObserver: <Result>(observer: SafeTypeOperationFailureObserver<string>, operation: () => Result) => Result;
+/**
+ * Result shape for safe typed operations.
+ */
+export type SafeTypeOperationResult<Result, Reason extends string> = Readonly<{
+    failure: SafeTypeOperationFailure<Reason>;
+    ok: false;
+}> | Readonly<{
+    ok: true;
+    value: Result;
+}>;
+/**
+ * Execute a typed operation with structured failure output instead of throws.
+ */
+export declare const safeTypeOperation: <Result, Reason extends string>({ onFailure, operation, reason, }: Readonly<{
+    onFailure?: SafeTypeOperationFailureObserver<Reason>;
+    operation: () => Result;
+    reason: Reason;
+}>) => SafeTypeOperationResult<Result, Reason>;
+/**
+ * Build a lightweight reason counter for debugging operation failures in tests.
+ *
+ * @param reasonsForTypeInference - Optional typed reason literals used to infer
+ *   the `Reason` generic without requiring explicit type parameters.
+ */
+export declare const createSafeTypeOperationCounter: <Reason extends string = never>(reasonsForTypeInference?: readonly Reason[]) => SafeTypeOperationCounter<Reason>;
+//# sourceMappingURL=safe-type-operation.d.ts.map

package/dist/_internal/safe-type-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-type-operation.d.ts","sourceRoot":"","sources":["../../src/_internal/safe-type-operation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,MAAM,SAAS,MAAM,IAAI,QAAQ,CAAC;IACnE,WAAW,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,SAAS,EAAE,CACP,OAAO,EAAE,QAAQ,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC,KACD,IAAI,CAAC;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,MAAM,SAAS,MAAM,IAAI,QAAQ,CAAC;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gCAAgC,CAAC,MAAM,SAAS,MAAM,IAAI,CAClE,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,KAClD,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,gCAAgC,CAAC,MAAM,SAAS,MAAM,IAAI,QAAQ,CAAC;IAC3E,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC;CACpC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,wCAAwC,CAAC,MAAM,SAAS,MAAM,IAAI,CAC1E,OAAO,EAAE,QAAQ,CAAC,gCAAgC,CAAC,MAAM,CAAC,CAAC,KAC1D,IAAI,CAAC;AA0DV;;;;;;;GAOG;AACH,eAAO,MAAM,gDAAgD,GACzD,UAAU,wCAAwC,CAAC,MAAM,CAAC,KAC3D,CAAC,MAAM,IAAI,CAMb,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wCAAwC,GACjD,UAAU,gCAAgC,CAAC,MAAM,CAAC,KACnD,CAAC,MAAM,IAAI,CAMb,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oCAAoC,GAAI,MAAM,EACvD,UAAU,gCAAgC,CAAC,MAAM,CAAC,EAClD,WAAW,MAAM,MAAM,KACxB,MAQF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,MAAM,EAAE,MAAM,SAAS,MAAM,IAC3D,QAAQ,CAAC;IACL,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,EAAE,EAAE,KAAK,CAAC;CACb,CAAC,GACF,QAAQ,CAAC;IACL,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAET;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,EAAE,MAAM,SAAS,MAAM,EAAE,mCAI9D,QAAQ,CAAC;IACR,SAAS,CAAC,EAAE,gCAAgC,CAAC,MAAM,CAAC,CAAC;IACrD,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC,KAAG,uBAAuB,CAAC,MAAM,EAAE,MAAM,CA6B1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GAAI,MAAM,SAAS,MAAM,GAAG,KAAK,EACxE,0BAAyB,SAAS,MAAM,EAAO,KAChD,wBAAwB,CAAC,MAAM,CAgBjC,CAAC"}

package/dist/_internal/safe-type-operation.js

@@ -0,0 +1,147 @@
+/**
+ * @packageDocumentation
+ * Structured error handling for best-effort typed AST operations.
+ */
+/**
+ * Shared observer set for operation failures across rule modules.
+ *
+ * @remarks
+ * Observers are intentionally process-local and opt-in; they exist for
+ * diagnostics and test instrumentation only.
+ */
+const safeTypeOperationFailureObservers = new Set();
+/**
+ * Shared observer set for local/global observer failures.
+ */
+const safeTypeOperationObserverFailureObservers = new Set();
+/**
+ * Notify all registered observer-failure observers.
+ *
+ * @param failure - Observer-failure payload.
+ */
+const notifySafeTypeOperationObserverFailureObservers = (failure) => {
+    for (const observer of safeTypeOperationObserverFailureObservers) {
+        try {
+            observer(failure);
+        }
+        catch {
+            // Observer-failure observers are diagnostics only; never rethrow.
+        }
+    }
+};
+/**
+ * Notify all registered global failure observers.
+ *
+ * @param failure - Failure payload emitted by a typed operation.
+ */
+const notifySafeTypeOperationFailureObservers = (failure) => {
+    for (const observer of safeTypeOperationFailureObservers) {
+        try {
+            observer(failure);
+        }
+        catch (observerError) {
+            notifySafeTypeOperationObserverFailureObservers({
+                failure,
+                observerError,
+                observerKind: "global",
+            });
+        }
+    }
+};
+/**
+ * Register a process-local observer for observer failures.
+ *
+ * @param observer - Callback invoked when a local/global failure observer
+ *   throws.
+ *
+ * @returns Unsubscribe callback to remove the observer.
+ */
+export const registerSafeTypeOperationObserverFailureObserver = (observer) => {
+    safeTypeOperationObserverFailureObservers.add(observer);
+    return () => {
+        safeTypeOperationObserverFailureObservers.delete(observer);
+    };
+};
+/**
+ * Register a process-local failure observer for typed operations.
+ *
+ * @param observer - Callback invoked for each operation failure.
+ *
+ * @returns Unsubscribe callback to remove the observer.
+ */
+export const registerSafeTypeOperationFailureObserver = (observer) => {
+    safeTypeOperationFailureObservers.add(observer);
+    return () => {
+        safeTypeOperationFailureObservers.delete(observer);
+    };
+};
+/**
+ * Run one operation with a scoped failure observer that is always cleaned up.
+ *
+ * @param observer - Observer registered for the operation scope.
+ * @param operation - Synchronous operation to execute while observing failures.
+ *
+ * @returns Return value produced by `operation`.
+ */
+export const withSafeTypeOperationFailureObserver = (observer, operation) => {
+    const unsubscribe = registerSafeTypeOperationFailureObserver(observer);
+    try {
+        return operation();
+    }
+    finally {
+        unsubscribe();
+    }
+};
+/**
+ * Execute a typed operation with structured failure output instead of throws.
+ */
+export const safeTypeOperation = ({ onFailure, operation, reason, }) => {
+    try {
+        return {
+            ok: true,
+            value: operation(),
+        };
+    }
+    catch (error) {
+        const failure = {
+            error,
+            reason,
+        };
+        try {
+            onFailure?.(failure);
+        }
+        catch (observerError) {
+            notifySafeTypeOperationObserverFailureObservers({
+                failure,
+                observerError,
+                observerKind: "local",
+            });
+        }
+        notifySafeTypeOperationFailureObservers(failure);
+        return {
+            failure,
+            ok: false,
+        };
+    }
+};
+/**
+ * Build a lightweight reason counter for debugging operation failures in tests.
+ *
+ * @param reasonsForTypeInference - Optional typed reason literals used to infer
+ *   the `Reason` generic without requiring explicit type parameters.
+ */
+export const createSafeTypeOperationCounter = (reasonsForTypeInference = []) => {
+    const counts = new Map();
+    for (const reason of reasonsForTypeInference) {
+        counts.set(reason, counts.get(reason) ?? 0);
+    }
+    const onFailure = (failure) => {
+        const previousCount = counts.get(failure.reason) ?? 0;
+        counts.set(failure.reason, previousCount + 1);
+    };
+    return {
+        getSnapshot: () => new Map(counts),
+        onFailure,
+    };
+};
+//# sourceMappingURL=safe-type-operation.js.map

package/dist/_internal/safe-type-operation.js.map

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

package/dist/_internal/scope-resolution.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @packageDocumentation
+ * Context/source-code scope-resolution helpers.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+/**
+ * Resolve the lexical scope for a node via modern SourceCode APIs.
+ *
+ * @remarks
+ * ESLint v9+ exposes scope lookups via `context.sourceCode.getScope(node)`.
+ * This helper intentionally does not use legacy `context.getScope()`.
+ *
+ * @param context - Active rule context.
+ * @param node - Node used as the scope lookup anchor.
+ *
+ * @returns Scope when available; otherwise `null`.
+ */
+export declare const getScopeFromContextSourceCode: <MessageIds extends string, Options extends Readonly<UnknownArray>>(context: Readonly<TSESLint.RuleContext<MessageIds, Options>>, node: Readonly<TSESTree.Node>) => null | Readonly<TSESLint.Scope.Scope>;
+//# sourceMappingURL=scope-resolution.d.ts.map

package/dist/_internal/scope-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolution.d.ts","sourceRoot":"","sources":["../../src/_internal/scope-resolution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQ9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,GACtC,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,EAEtC,SAAS,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,EAC5D,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAC9B,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAUtC,CAAC"}

package/dist/_internal/scope-resolution.js

@@ -0,0 +1,21 @@
+import { safeCastTo } from "ts-extras";
+/**
+ * Resolve the lexical scope for a node via modern SourceCode APIs.
+ *
+ * @remarks
+ * ESLint v9+ exposes scope lookups via `context.sourceCode.getScope(node)`.
+ * This helper intentionally does not use legacy `context.getScope()`.
+ *
+ * @param context - Active rule context.
+ * @param node - Node used as the scope lookup anchor.
+ *
+ * @returns Scope when available; otherwise `null`.
+ */
+export const getScopeFromContextSourceCode = (context, node) => {
+    const sourceCodeMaybeWithScope = safeCastTo(context.sourceCode);
+    if (typeof sourceCodeMaybeWithScope?.getScope !== "function") {
+        return null;
+    }
+    return sourceCodeMaybeWithScope.getScope(node);
+};
+//# sourceMappingURL=scope-resolution.js.map

package/dist/_internal/scope-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolution.js","sourceRoot":"","sources":["../../src/_internal/scope-resolution.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAMvC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAIzC,OAA4D,EAC5D,IAA6B,EACQ,EAAE;IACvC,MAAM,wBAAwB,GAAG,UAAU,CAEzC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtB,IAAI,OAAO,wBAAwB,EAAE,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/_internal/scope-variable.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @packageDocumentation
+ * Scope-chain helpers for reliable variable-resolution checks.
+ */
+import type { TSESLint } from "@typescript-eslint/utils";
+/**
+ * Resolve a variable binding by walking the current scope and all parent
+ * scopes.
+ *
+ * @param scope - Initial scope to inspect.
+ * @param variableName - Identifier name to resolve.
+ *
+ * @returns Matched variable binding from the nearest scope chain; otherwise
+ *   `null`.
+ */
+export declare const getVariableInScopeChain: (scope: Readonly<null | Readonly<TSESLint.Scope.Scope>>, variableName: string) => null | TSESLint.Scope.Variable;
+//# sourceMappingURL=scope-variable.d.ts.map

package/dist/_internal/scope-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-variable.d.ts","sourceRoot":"","sources":["../../src/_internal/scope-variable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAChC,OAAO,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EACtD,cAAc,MAAM,KACrB,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,QAwBxB,CAAC"}

package/dist/_internal/scope-variable.js

@@ -0,0 +1,30 @@
+import { resolveFirstValueInLinkedStructure } from "./cycle-safe-linked-search.js";
+/**
+ * Resolve a variable binding by walking the current scope and all parent
+ * scopes.
+ *
+ * @param scope - Initial scope to inspect.
+ * @param variableName - Identifier name to resolve.
+ *
+ * @returns Matched variable binding from the nearest scope chain; otherwise
+ *   `null`.
+ */
+export const getVariableInScopeChain = (scope, variableName) => {
+    const lookupResult = resolveFirstValueInLinkedStructure({
+        getNextNode: (currentScope) => currentScope.upper,
+        resolveValue: (currentScope) => {
+            const variable = currentScope.set.get(variableName);
+            return variable === undefined
+                ? {
+                    found: false,
+                }
+                : {
+                    found: true,
+                    value: variable,
+                };
+        },
+        startNode: scope,
+    });
+    return lookupResult.found ? lookupResult.value : null;
+};
+//# sourceMappingURL=scope-variable.js.map

package/dist/_internal/scope-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-variable.js","sourceRoot":"","sources":["../../src/_internal/scope-variable.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACnC,KAAsD,EACtD,YAAoB,EACU,EAAE;IAChC,MAAM,YAAY,GAAG,kCAAkC,CAGrD;QACE,WAAW,EAAE,CACT,YAA4C,EACP,EAAE,CAAC,YAAY,CAAC,KAAK;QAC9D,YAAY,EAAE,CAAC,YAA4C,EAAE,EAAE;YAC3D,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAEpD,OAAO,QAAQ,KAAK,SAAS;gBACzB,CAAC,CAAC;oBACI,KAAK,EAAE,KAAK;iBACf;gBACH,CAAC,CAAC;oBACI,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,QAAQ;iBAClB,CAAC;QACZ,CAAC;QACD,SAAS,EAAE,KAAK;KACnB,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC,CAAC"}