eslint-plugin-typefest 1.0.1

package/dist/_internal/rule-catalog.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Catalog metadata for a single rule.
+ */
+export type TypefestRuleCatalogEntry = Readonly<{
+    ruleId: TypefestRuleCatalogId;
+    ruleName: TypefestRuleNamePattern;
+    ruleNumber: number;
+}>;
+/**
+ * Stable machine-friendly rule id format (for example: `R001`).
+ */
+export type TypefestRuleCatalogId = `R${string}`;
+/** Pattern for unqualified rule names supported by eslint-plugin-typefest. */
+type TypefestRuleNamePattern = `prefer-${string}`;
+/**
+ * Canonical catalog metadata entries in stable display/order form.
+ */
+export declare const typefestRuleCatalogEntries: readonly TypefestRuleCatalogEntry[];
+/**
+ * Fast lookup map for rule catalog metadata by rule name.
+ */
+export declare const typefestRuleCatalogByRuleName: Readonly<Partial<Record<TypefestRuleNamePattern, TypefestRuleCatalogEntry>>>;
+/**
+ * Resolve stable catalog metadata for a rule name.
+ *
+ * @throws When the rule is missing from the catalog.
+ */
+/**
+ * Resolve stable catalog metadata for a rule name when available.
+ */
+export declare const getRuleCatalogEntryForRuleNameOrNull: (ruleName: string) => null | TypefestRuleCatalogEntry;
+/**
+ * Resolve stable catalog metadata for a rule name.
+ *
+ * @throws When the rule is missing from the catalog.
+ */
+export declare const getRuleCatalogEntryForRuleName: (ruleName: string) => TypefestRuleCatalogEntry;
+/**
+ * Resolve stable catalog metadata by rule id.
+ */
+export declare const typefestRuleCatalogByRuleId: ReadonlyMap<TypefestRuleCatalogId, TypefestRuleCatalogEntry>;
+/**
+ * Resolve stable catalog metadata for a catalog id.
+ */
+export declare const getRuleCatalogEntryForRuleId: (ruleId: TypefestRuleCatalogId) => TypefestRuleCatalogEntry | undefined;
+/**
+ * Validate that catalog IDs are unique and sequential.
+ */
+export declare const validateRuleCatalogIntegrity: () => boolean;
+export {};
+//# sourceMappingURL=rule-catalog.d.ts.map

package/dist/_internal/rule-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-catalog.d.ts","sourceRoot":"","sources":["../../src/_internal/rule-catalog.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC5C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,MAAM,EAAE,CAAC;AAEjD,8EAA8E;AAC9E,KAAK,uBAAuB,GAAG,UAAU,MAAM,EAAE,CAAC;AA8FlD;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,wBAAwB,EASpE,CAAC;AAEP;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAChD,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC,CAAC,CAGrE,CAAC;AAEF;;;;GAIG;AACH;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAC7C,UAAU,MAAM,KACjB,IAAI,GAAG,wBAMT,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACvC,UAAU,MAAM,KACjB,wBAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAAW,CACjD,qBAAqB,EACrB,wBAAwB,CACiD,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,4BAA4B,GACrC,QAAQ,qBAAqB,KAC9B,wBAAwB,GAAG,SACa,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,4BAA4B,QAAO,OAsB/C,CAAC"}

package/dist/_internal/rule-catalog.js

@@ -0,0 +1,162 @@
+/**
+ * @packageDocumentation
+ * Stable catalog IDs for all plugin rules.
+ */
+import { objectFromEntries, setHas } from "ts-extras";
+/**
+ * Stable global ordering used for rule catalog IDs.
+ *
+ * @remarks
+ * Append new rules to preserve existing IDs.
+ */
+const orderedRuleNames = [
+    "prefer-ts-extras-array-at",
+    "prefer-ts-extras-array-concat",
+    "prefer-ts-extras-array-find",
+    "prefer-ts-extras-array-find-last",
+    "prefer-ts-extras-array-find-last-index",
+    "prefer-ts-extras-array-first",
+    "prefer-ts-extras-array-includes",
+    "prefer-ts-extras-array-join",
+    "prefer-ts-extras-array-last",
+    "prefer-ts-extras-as-writable",
+    "prefer-ts-extras-assert-defined",
+    "prefer-ts-extras-assert-error",
+    "prefer-ts-extras-assert-present",
+    "prefer-ts-extras-is-defined",
+    "prefer-ts-extras-is-defined-filter",
+    "prefer-ts-extras-is-empty",
+    "prefer-ts-extras-is-equal-type",
+    "prefer-ts-extras-is-finite",
+    "prefer-ts-extras-is-infinite",
+    "prefer-ts-extras-is-integer",
+    "prefer-ts-extras-is-present",
+    "prefer-ts-extras-is-present-filter",
+    "prefer-ts-extras-is-safe-integer",
+    "prefer-ts-extras-key-in",
+    "prefer-ts-extras-not",
+    "prefer-ts-extras-object-entries",
+    "prefer-ts-extras-object-from-entries",
+    "prefer-ts-extras-object-has-in",
+    "prefer-ts-extras-object-has-own",
+    "prefer-ts-extras-object-keys",
+    "prefer-ts-extras-object-values",
+    "prefer-ts-extras-safe-cast-to",
+    "prefer-ts-extras-set-has",
+    "prefer-ts-extras-string-split",
+    "prefer-type-fest-abstract-constructor",
+    "prefer-type-fest-arrayable",
+    "prefer-type-fest-async-return-type",
+    "prefer-type-fest-conditional-pick",
+    "prefer-type-fest-constructor",
+    "prefer-type-fest-except",
+    "prefer-type-fest-if",
+    "prefer-type-fest-iterable-element",
+    "prefer-type-fest-json-array",
+    "prefer-type-fest-json-object",
+    "prefer-type-fest-json-primitive",
+    "prefer-type-fest-json-value",
+    "prefer-type-fest-keys-of-union",
+    "prefer-type-fest-literal-union",
+    "prefer-type-fest-merge-exclusive",
+    "prefer-type-fest-non-empty-tuple",
+    "prefer-type-fest-omit-index-signature",
+    "prefer-type-fest-partial-deep",
+    "prefer-type-fest-primitive",
+    "prefer-type-fest-promisable",
+    "prefer-type-fest-readonly-deep",
+    "prefer-type-fest-require-all-or-none",
+    "prefer-type-fest-require-at-least-one",
+    "prefer-type-fest-require-exactly-one",
+    "prefer-type-fest-require-one-or-none",
+    "prefer-type-fest-required-deep",
+    "prefer-type-fest-schema",
+    "prefer-type-fest-set-non-nullable",
+    "prefer-type-fest-set-optional",
+    "prefer-type-fest-set-readonly",
+    "prefer-type-fest-set-required",
+    "prefer-type-fest-simplify",
+    "prefer-type-fest-tagged-brands",
+    "prefer-type-fest-tuple-of",
+    "prefer-type-fest-unknown-array",
+    "prefer-type-fest-unknown-map",
+    "prefer-type-fest-unknown-record",
+    "prefer-type-fest-unknown-set",
+    "prefer-type-fest-unwrap-tagged",
+    "prefer-type-fest-value-of",
+    "prefer-type-fest-writable",
+    "prefer-type-fest-writable-deep",
+];
+const toRuleCatalogId = (ruleNumber) => `R${String(ruleNumber).padStart(3, "0")}`;
+const isTypefestRuleNamePattern = (ruleName) => ruleName.startsWith("prefer-");
+/**
+ * Canonical catalog metadata entries in stable display/order form.
+ */
+export const typefestRuleCatalogEntries = orderedRuleNames.map((ruleName, index) => {
+    const ruleNumber = index + 1;
+    return {
+        ruleId: toRuleCatalogId(ruleNumber),
+        ruleName,
+        ruleNumber,
+    };
+});
+/**
+ * Fast lookup map for rule catalog metadata by rule name.
+ */
+export const typefestRuleCatalogByRuleName = objectFromEntries(typefestRuleCatalogEntries.map((entry) => [entry.ruleName, entry]));
+/**
+ * Resolve stable catalog metadata for a rule name.
+ *
+ * @throws When the rule is missing from the catalog.
+ */
+/**
+ * Resolve stable catalog metadata for a rule name when available.
+ */
+export const getRuleCatalogEntryForRuleNameOrNull = (ruleName) => {
+    if (!isTypefestRuleNamePattern(ruleName)) {
+        return null;
+    }
+    return typefestRuleCatalogByRuleName[ruleName] ?? null;
+};
+/**
+ * Resolve stable catalog metadata for a rule name.
+ *
+ * @throws When the rule is missing from the catalog.
+ */
+export const getRuleCatalogEntryForRuleName = (ruleName) => {
+    const catalogEntry = getRuleCatalogEntryForRuleNameOrNull(ruleName);
+    if (catalogEntry === null) {
+        throw new TypeError(`Rule '${ruleName}' is missing from the stable rule catalog.`);
+    }
+    return catalogEntry;
+};
+/**
+ * Resolve stable catalog metadata by rule id.
+ */
+export const typefestRuleCatalogByRuleId = new Map(typefestRuleCatalogEntries.map((entry) => [entry.ruleId, entry]));
+/**
+ * Resolve stable catalog metadata for a catalog id.
+ */
+export const getRuleCatalogEntryForRuleId = (ruleId) => typefestRuleCatalogByRuleId.get(ruleId);
+/**
+ * Validate that catalog IDs are unique and sequential.
+ */
+export const validateRuleCatalogIntegrity = () => {
+    const entries = typefestRuleCatalogEntries;
+    const seenRuleIds = new Set();
+    for (const [index, entry] of entries.entries()) {
+        if (setHas(seenRuleIds, entry.ruleId)) {
+            return false;
+        }
+        seenRuleIds.add(entry.ruleId);
+        const expectedRuleNumber = index + 1;
+        if (entry.ruleNumber !== expectedRuleNumber) {
+            return false;
+        }
+        if (entry.ruleId !== toRuleCatalogId(expectedRuleNumber)) {
+            return false;
+        }
+    }
+    return true;
+};
+//# sourceMappingURL=rule-catalog.js.map

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

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

package/dist/_internal/rule-docs-metadata.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @packageDocumentation
+ * Derivation helpers for canonical rule docs metadata.
+ */
+import type { TSESLint } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+import type { TypefestRuleNamePattern } from "./rules-registry.js";
+import { type TypefestConfigName, type TypefestConfigReference } from "./typefest-config-references.js";
+/** Normalized docs metadata derived for each rule. */
+export type RuleDocsMetadata = Readonly<{
+    description: string;
+    recommended: boolean;
+    requiresTypeChecking: boolean;
+    ruleId: string;
+    ruleNumber: number;
+    typefestConfigNames: readonly TypefestConfigName[];
+    typefestConfigReferences: readonly TypefestConfigReference[];
+    url: string;
+}>;
+/** Rule-name keyed metadata map derived from static docs contracts. */
+export type RuleDocsMetadataByName = Readonly<Record<TypefestRuleNamePattern, RuleDocsMetadata>>;
+/** Rule-map contract accepted by docs metadata derivation helpers. */
+type RuleMap = Readonly<Record<TypefestRuleNamePattern, TSESLint.RuleModule<string, Readonly<UnknownArray>>>>;
+/**
+ * Derive normalized docs metadata for all plugin rules.
+ */
+export declare const deriveRuleDocsMetadataByName: (rules: RuleMap) => RuleDocsMetadataByName;
+/**
+ * Derive a typed-rule set from normalized docs metadata.
+ */
+export declare const deriveTypeCheckedRuleNameSet: (ruleDocsMetadataByName: RuleDocsMetadataByName) => ReadonlySet<TypefestRuleNamePattern>;
+/**
+ * Derive canonical preset-membership map from normalized docs metadata.
+ */
+export declare const deriveRulePresetMembershipByRuleName: (ruleDocsMetadataByName: RuleDocsMetadataByName) => Readonly<Record<TypefestRuleNamePattern, readonly TypefestConfigName[]>>;
+export {};
+//# sourceMappingURL=rule-docs-metadata.d.ts.map

package/dist/_internal/rule-docs-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-docs-metadata.d.ts","sourceRoot":"","sources":["../../src/_internal/rule-docs-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,WAAW,CAAC;AAU7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAE/B,MAAM,iCAAiC,CAAC;AAEzC,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,wBAAwB,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC7D,GAAG,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,uEAAuE;AACvE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CACzC,MAAM,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CACpD,CAAC;AAEF,sEAAsE;AACtE,KAAK,OAAO,GAAG,QAAQ,CACnB,MAAM,CACF,uBAAuB,EACvB,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CACtD,CACJ,CAAC;AAiOF;;GAEG;AACH,eAAO,MAAM,4BAA4B,GACrC,OAAO,OAAO,KACf,sBAmCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,GACrC,wBAAwB,sBAAsB,KAC/C,WAAW,CAAC,uBAAuB,CAkBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAC7C,wBAAwB,sBAAsB,KAC/C,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAuBzE,CAAC"}

package/dist/_internal/rule-docs-metadata.js

@@ -0,0 +1,192 @@
+import { arrayIncludes, isDefined, isEmpty, isInteger, objectEntries, } from "ts-extras";
+import { createRuleDocsUrl } from "./rule-docs-url.js";
+import { isTypefestConfigReference, typefestConfigReferenceToName, } from "./typefest-config-references.js";
+const RULE_ID_PREFIX = "R";
+const RULE_ID_LENGTH = 4;
+const RULE_ID_DIGIT_START_INDEX = 1;
+const RULE_ID_DIGIT_END_INDEX = 4;
+const ASCII_ZERO_CODE_POINT = 48;
+const ASCII_NINE_CODE_POINT = 57;
+/**
+ * Guard dynamic rule ids to the canonical `R###` identifier contract.
+ */
+const isRuleIdInCanonicalFormat = (value) => {
+    if (value.length !== RULE_ID_LENGTH || !value.startsWith(RULE_ID_PREFIX)) {
+        return false;
+    }
+    for (let index = RULE_ID_DIGIT_START_INDEX; index < RULE_ID_DIGIT_END_INDEX; index += 1) {
+        const codePoint = value.codePointAt(index);
+        if (!isDefined(codePoint)) {
+            return false;
+        }
+        if (codePoint < ASCII_ZERO_CODE_POINT ||
+            codePoint > ASCII_NINE_CODE_POINT) {
+            return false;
+        }
+    }
+    return true;
+};
+/**
+ * Guard dynamic values to object-shaped records.
+ */
+const isUnknownRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+ * Guard dynamic rule ids to the plugin naming contract.
+ */
+const isTypefestRuleNamePattern = (value) => value.startsWith("prefer-");
+/**
+ * Convert rule docs `typefestConfigs` into a normalized, deduped reference
+ * list.
+ */
+const normalizeTypefestConfigReferences = (ruleName, typefestConfigs) => {
+    const candidates = typeof typefestConfigs === "string"
+        ? [typefestConfigs]
+        : [...typefestConfigs];
+    const references = [];
+    for (const candidate of candidates) {
+        if (!isTypefestConfigReference(candidate)) {
+            throw new TypeError(`Rule '${ruleName}' has invalid docs.typefestConfigs reference '${String(candidate)}'.`);
+        }
+        if (arrayIncludes(references, candidate)) {
+            continue;
+        }
+        references.push(candidate);
+    }
+    if (isEmpty(references)) {
+        throw new TypeError(`Rule '${ruleName}' must declare at least one docs.typefestConfigs reference.`);
+    }
+    return references;
+};
+/**
+ * Validate and narrow dynamic `meta.docs` values to the plugin docs contract.
+ */
+const getRuleDocsContract = (ruleName, docs) => {
+    if (!isUnknownRecord(docs)) {
+        throw new TypeError(`Rule '${ruleName}' must declare meta.docs.`);
+    }
+    const description = docs["description"];
+    const recommended = docs["recommended"];
+    const requiresTypeChecking = docs["requiresTypeChecking"];
+    const ruleId = docs["ruleId"];
+    const ruleNumber = docs["ruleNumber"];
+    const typefestConfigs = docs["typefestConfigs"];
+    const url = docs["url"];
+    if (typeof description !== "string" || description.trim().length === 0) {
+        throw new TypeError(`Rule '${ruleName}' must declare a non-empty docs.description.`);
+    }
+    if (typeof url !== "string" || url.trim().length === 0) {
+        throw new TypeError(`Rule '${ruleName}' must declare a non-empty docs.url.`);
+    }
+    const expectedRuleDocsUrl = createRuleDocsUrl(ruleName);
+    if (url !== expectedRuleDocsUrl) {
+        throw new TypeError(`Rule '${ruleName}' must declare docs.url as '${expectedRuleDocsUrl}'.`);
+    }
+    if (typeof recommended !== "boolean") {
+        throw new TypeError(`Rule '${ruleName}' must declare boolean docs.recommended.`);
+    }
+    if (typeof requiresTypeChecking !== "boolean") {
+        throw new TypeError(`Rule '${ruleName}' must declare boolean docs.requiresTypeChecking.`);
+    }
+    if (typeof ruleId !== "string" ||
+        !isRuleIdInCanonicalFormat(ruleId) ||
+        ruleId.trim().length === 0) {
+        throw new TypeError(`Rule '${ruleName}' must declare docs.ruleId using the 'R###' format.`);
+    }
+    if (typeof ruleNumber !== "number" ||
+        !isInteger(ruleNumber) ||
+        ruleNumber < 1) {
+        throw new TypeError(`Rule '${ruleName}' must declare positive integer docs.ruleNumber.`);
+    }
+    if (typeof typefestConfigs === "string") {
+        if (!isTypefestConfigReference(typefestConfigs)) {
+            throw new TypeError(`Rule '${ruleName}' has invalid docs.typefestConfigs reference '${typefestConfigs}'.`);
+        }
+        return {
+            description,
+            recommended,
+            requiresTypeChecking,
+            ruleId,
+            ruleNumber,
+            typefestConfigs,
+            url,
+        };
+    }
+    if (!Array.isArray(typefestConfigs)) {
+        throw new TypeError(`Rule '${ruleName}' must declare docs.typefestConfigs as a preset reference or array.`);
+    }
+    const normalizedTypefestConfigs = [];
+    for (const candidate of typefestConfigs) {
+        if (typeof candidate !== "string" ||
+            !isTypefestConfigReference(candidate)) {
+            throw new TypeError(`Rule '${ruleName}' has invalid docs.typefestConfigs reference '${String(candidate)}'.`);
+        }
+        normalizedTypefestConfigs.push(candidate);
+    }
+    return {
+        description,
+        recommended,
+        requiresTypeChecking,
+        ruleId,
+        ruleNumber,
+        typefestConfigs: normalizedTypefestConfigs,
+        url,
+    };
+};
+/**
+ * Derive normalized docs metadata for all plugin rules.
+ */
+export const deriveRuleDocsMetadataByName = (rules) => {
+    const metadataByRuleName = {};
+    for (const [ruleName, ruleModule] of objectEntries(rules)) {
+        if (!isTypefestRuleNamePattern(ruleName)) {
+            throw new TypeError(`Unexpected rule id '${ruleName}' while deriving docs metadata.`);
+        }
+        const ruleDocs = getRuleDocsContract(ruleName, ruleModule.meta?.docs);
+        const typefestConfigReferences = normalizeTypefestConfigReferences(ruleName, ruleDocs.typefestConfigs);
+        const typefestConfigNames = typefestConfigReferences.map((reference) => typefestConfigReferenceToName[reference]);
+        metadataByRuleName[ruleName] = {
+            description: ruleDocs.description,
+            recommended: ruleDocs.recommended,
+            requiresTypeChecking: ruleDocs.requiresTypeChecking,
+            ruleId: ruleDocs.ruleId,
+            ruleNumber: ruleDocs.ruleNumber,
+            typefestConfigNames,
+            typefestConfigReferences,
+            url: ruleDocs.url,
+        };
+    }
+    return metadataByRuleName;
+};
+/**
+ * Derive a typed-rule set from normalized docs metadata.
+ */
+export const deriveTypeCheckedRuleNameSet = (ruleDocsMetadataByName) => {
+    const ruleNames = [];
+    for (const [ruleName, metadata] of objectEntries(ruleDocsMetadataByName)) {
+        if (!metadata.requiresTypeChecking) {
+            continue;
+        }
+        if (!isTypefestRuleNamePattern(ruleName)) {
+            throw new TypeError(`Unexpected rule id '${ruleName}' while deriving typed-rule metadata.`);
+        }
+        ruleNames.push(ruleName);
+    }
+    return new Set(ruleNames);
+};
+/**
+ * Derive canonical preset-membership map from normalized docs metadata.
+ */
+export const deriveRulePresetMembershipByRuleName = (ruleDocsMetadataByName) => {
+    const membershipByRuleName = {};
+    for (const [ruleName, metadata] of objectEntries(ruleDocsMetadataByName)) {
+        if (!isTypefestRuleNamePattern(ruleName)) {
+            throw new TypeError(`Unexpected rule id '${ruleName}' while deriving preset membership.`);
+        }
+        membershipByRuleName[ruleName] = metadata.typefestConfigNames;
+    }
+    if (isEmpty(objectEntries(membershipByRuleName))) {
+        throw new TypeError("Rule metadata derivation produced no membership entries.");
+    }
+    return membershipByRuleName;
+};
+//# sourceMappingURL=rule-docs-metadata.js.map

package/dist/_internal/rule-docs-metadata.js.map

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

package/dist/_internal/rule-docs-url.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @packageDocumentation
+ * Canonical rule documentation URL helpers.
+ */
+/** Stable docs host/prefix for generated rule docs links. */
+export declare const RULE_DOCS_URL_BASE: "https://nick2bad4u.github.io/eslint-plugin-typefest/docs/rules/";
+/**
+ * Build the canonical documentation URL for one rule id.
+ *
+ * @param ruleName - Rule id (for example `prefer-ts-extras-array-at`).
+ *
+ * @returns Canonical docs URL for the rule page.
+ */
+export declare const createRuleDocsUrl: (ruleName: string) => string;
+//# sourceMappingURL=rule-docs-url.d.ts.map

package/dist/_internal/rule-docs-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-docs-url.d.ts","sourceRoot":"","sources":["../../src/_internal/rule-docs-url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,EAC3B,iEAA0E,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,MACf,CAAC"}

package/dist/_internal/rule-docs-url.js

@@ -0,0 +1,15 @@
+/**
+ * @packageDocumentation
+ * Canonical rule documentation URL helpers.
+ */
+/** Stable docs host/prefix for generated rule docs links. */
+export const RULE_DOCS_URL_BASE = "https://nick2bad4u.github.io/eslint-plugin-typefest/docs/rules/";
+/**
+ * Build the canonical documentation URL for one rule id.
+ *
+ * @param ruleName - Rule id (for example `prefer-ts-extras-array-at`).
+ *
+ * @returns Canonical docs URL for the rule page.
+ */
+export const createRuleDocsUrl = (ruleName) => `${RULE_DOCS_URL_BASE}${ruleName}`;
+//# sourceMappingURL=rule-docs-url.js.map

package/dist/_internal/rule-docs-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-docs-url.js","sourceRoot":"","sources":["../../src/_internal/rule-docs-url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAC3B,iEAA0E,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAU,EAAE,CAC1D,GAAG,kBAAkB,GAAG,QAAQ,EAAE,CAAC"}

package/dist/_internal/rule-reporting.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @packageDocumentation
+ * Shared helpers for consistent rule reporting with optional fixes and
+ * suggestion fallbacks.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+/**
+ * Resolution result for optional fix/suggestion reporting.
+ */
+export type AutofixOrSuggestionOutcome = Readonly<{
+    fix: TSESLint.ReportFixFunction;
+    kind: "autofix";
+}> | Readonly<{
+    fix: TSESLint.ReportFixFunction;
+    kind: "suggestion";
+}> | Readonly<{
+    kind: "no-fix";
+}>;
+/** Input shape for {@link resolveAutofixOrSuggestionOutcome}. */
+type AutofixOrSuggestionResolutionInput = Readonly<{
+    canAutofix: boolean;
+    fix: null | TSESLint.ReportFixFunction;
+}>;
+/** Concrete report descriptor type for a rule context. */
+type ReportDescriptor<MessageIds extends string, Options extends Readonly<UnknownArray>> = Parameters<TSESLint.RuleContext<MessageIds, Options>["report"]>[0];
+/**
+ * Report using plugin-aware autofix policy handling.
+ */
+export declare const reportWithTypefestPolicy: <MessageIds extends string, Options extends Readonly<UnknownArray>>({ context, descriptor, }: Readonly<{
+    context: Readonly<TSESLint.RuleContext<MessageIds, Options>>;
+    descriptor: ReportDescriptor<MessageIds, Options>;
+}>) => void;
+/**
+ * Report a diagnostic with an optional direct fix.
+ *
+ * @remarks
+ * When `fix` is absent this reports only `messageId` + `node`.
+ */
+export declare const reportWithOptionalFix: <MessageIds extends string, Options extends Readonly<UnknownArray>>({ context, data, fix, messageId, node, }: Readonly<{
+    context: Readonly<TSESLint.RuleContext<MessageIds, Options>>;
+    data?: ReportDescriptor<MessageIds, Options>["data"];
+    fix: null | TSESLint.ReportFixFunction;
+    messageId: MessageIds;
+    node: TSESTree.Node;
+}>) => void;
+/**
+ * Resolve one of three standardized reporting outcomes:
+ *
+ * - No fix (`messageId` only),
+ * - Direct autofix (`fix`), or
+ * - Suggestion-only (`suggest`).
+ */
+export declare function resolveAutofixOrSuggestionOutcome({ canAutofix, fix, }: AutofixOrSuggestionResolutionInput): AutofixOrSuggestionOutcome;
+/**
+ * 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 declare const reportResolvedAutofixOrSuggestionOutcome: <MessageIds extends string, Options extends Readonly<UnknownArray>>({ context, data, messageId, node, outcome, suggestionMessageId, }: Readonly<{
+    context: Readonly<TSESLint.RuleContext<MessageIds, Options>>;
+    data?: ReportDescriptor<MessageIds, Options>["data"];
+    messageId: MessageIds;
+    node: TSESTree.Node;
+    outcome: AutofixOrSuggestionOutcome;
+    suggestionMessageId: MessageIds;
+}>) => void;
+export {};
+//# sourceMappingURL=rule-reporting.d.ts.map

package/dist/_internal/rule-reporting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-reporting.d.ts","sourceRoot":"","sources":["../../src/_internal/rule-reporting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAK9C;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAChC,QAAQ,CAAC;IAAE,GAAG,EAAE,QAAQ,CAAC,iBAAiB,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC9D,QAAQ,CAAC;IAAE,GAAG,EAAE,QAAQ,CAAC,iBAAiB,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,GACjE,QAAQ,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAEnC,iEAAiE;AACjE,KAAK,kCAAkC,GAAG,QAAQ,CAAC;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAC;CAC1C,CAAC,CAAC;AAEH,0DAA0D;AAC1D,KAAK,gBAAgB,CACjB,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,IACtC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACjC,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,EACxC,0BAGC,QAAQ,CAAC;IACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,UAAU,EAAE,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;CACrD,CAAC,KAAG,IAUJ,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAC9B,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,EACxC,0CAMC,QAAQ,CAAC;IACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,EAAE,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IACrD,GAAG,EAAE,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IACvC,SAAS,EAAE,UAAU,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;CACvB,CAAC,KAAG,IAYJ,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,EAC9C,UAAU,EACV,GAAG,GACN,EAAE,kCAAkC,GAAG,0BAA0B,CAkBjE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wCAAwC,GACjD,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,EACxC,mEAOC,QAAQ,CAAC;IACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,EAAE,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IACrD,SAAS,EAAE,UAAU,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,OAAO,EAAE,0BAA0B,CAAC;IACpC,mBAAmB,EAAE,UAAU,CAAC;CACnC,CAAC,KAAG,IA2BJ,CAAC"}