eslint-rule-forge 0.2.0 → 0.3.1

package/README.md

@@ -23,15 +23,18 @@ dependencies.
 
 `x as T`, `x!`, `x satisfies T` and `<T>x` change a type and never a value.
 
-| Helper              | What it gives                                                                         |
-| :------------------ | :------------------------------------------------------------------------------------ |
-| `isTypeWrapper`     | whether a node is one of the four                                                     |
-| `skipTypeWrappers`  | the expression inside every wrapper around a node: judge syntax on this               |
-| `typeWrapperLayers` | the node and every expression inside its wrappers, outermost first: ask types of each |
-| `TypeWrapper`       | the four node types                                                                   |
-
-All of them take a readonly (`DeepReadonly<TSESTree.Node>`) or a mutable node
-and give back the same kind.
+| Helper                  | What it gives                                                                         |
+| :---------------------- | :------------------------------------------------------------------------------------ |
+| `isTypeWrapper`         | whether a node is one of the four                                                     |
+| `skipTypeWrappers`      | the expression inside every wrapper around a node: judge syntax on this               |
+| `typeWrapperLayers`     | the node and every expression inside its wrappers, outermost first: ask types of each |
+| `TypeWrapper`           | the four node types                                                                   |
+| `isIdentifierNamed`     | whether a node, read through its wrappers, is the identifier of a given name          |
+| `typeHoldsAtEveryLayer` | whether a check holds of the type at every layer, `false` without type information    |
+
+All of them but `typeHoldsAtEveryLayer` take a readonly
+(`DeepReadonly<TSESTree.Node>`) or a mutable node, and those that return a node
+give back the same kind.
 
 Judge syntax on what `skipTypeWrappers` returns, and write the fix from the
 original node, so that the wrapper is kept:
@@ -207,6 +210,22 @@ export const preferIsNullish: TSESLint.RuleModule<'preferIsNullish'> = {
 } as const;
 ```
 
+## Rule factories
+
+Rules that several plugins carry, differing only in the module whose functions
+the fix writes. Each factory takes the module name (and the namespace the
+function is reached through, where there is one) and returns a complete rule,
+so that a fix to the rule reaches every plugin that builds it.
+
+| Factory                         | The rule it builds                                                                                        |
+| :------------------------------ | :-------------------------------------------------------------------------------------------------------- |
+| `createPreferIsNonNullObject`   | `typeof u === 'object' && u !== null` → `isNonNullObject(u)`                                              |
+| `createPreferIsRecordAndHasKey` | `Object.hasOwn(obj, key)` and `key in obj` → `isRecord(obj) && hasKey(obj, key)`, or `hasKey` on a record |
+| `createPreferArrayIsArray`      | `Array.isArray` → `<namespace>.isArray`                                                                   |
+| `createPreferSafeParseInt`      | `parseInt(x)`, `parseInt(x, 10)` → `Result.unwrapOkOr(<namespace>.<method>(x), Number.NaN)`               |
+| `createPreferSafeParseFloat`    | `parseFloat(x)`, `Number.parseFloat(x)`, `Number(x)` → the same, for a `string` `x`                       |
+| `createNoSideEffectImport`      | removes `import '<module>';`, with the reason the caller gives                                            |
+
 ## License
 
 [Apache-2.0](https://github.com/noshiro-pf/mono/blob/main/libs/eslint-rule-forge/LICENSE)

package/dist/index.d.mts

@@ -2,5 +2,6 @@ export * from './bindings.mjs';
 export * from './imports.mjs';
 export * from './negation.mjs';
 export * from './parentheses.mjs';
+export * from './rules/index.mjs';
 export * from './type-wrappers.mjs';
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/index.mjs

@@ -2,5 +2,6 @@ export * from './bindings.mjs';
 export * from './imports.mjs';
 export * from './negation.mjs';
 export * from './parentheses.mjs';
+export * from './rules/index.mjs';
 export * from './type-wrappers.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/rules/index.d.mts

@@ -0,0 +1,6 @@
+export * from './no-side-effect-import.mjs';
+export * from './prefer-array-is-array.mjs';
+export * from './prefer-is-non-null-object.mjs';
+export * from './prefer-is-record-and-has-key.mjs';
+export * from './prefer-safe-parse.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/rules/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/rules/index.mts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yBAAyB,CAAC"}

package/dist/rules/index.mjs

@@ -0,0 +1,6 @@
+export * from './no-side-effect-import.mjs';
+export * from './prefer-array-is-array.mjs';
+export * from './prefer-is-non-null-object.mjs';
+export * from './prefer-is-record-and-has-key.mjs';
+export * from './prefer-safe-parse.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/rules/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/rules/index.mts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yBAAyB,CAAC"}

package/dist/rules/no-side-effect-import.d.mts

@@ -0,0 +1,18 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+/**
+ * Builds a rule that removes `import '<moduleName>';`, an import that binds no
+ * name. The rule matches the bare specifier exactly, so a subpath such as
+ * `<moduleName>/global` and every other module are left alone.
+ *
+ * Why such an import is wrong depends on the module — one with
+ * `sideEffects: false` loads for nothing, one with no runtime entry point fails
+ * to resolve — so the caller says it, in `description` and `message`, and
+ * chooses `type` accordingly.
+ */
+export declare const createNoSideEffectImport: ({ moduleName, type, description, message, }: Readonly<{
+    moduleName: string;
+    type: TSESLint.RuleMetaData<string, unknown>['type'];
+    description: string;
+    message: string;
+}>) => TSESLint.RuleModule<'removeSideEffectImport', readonly []>;
+//# sourceMappingURL=no-side-effect-import.d.mts.map

package/dist/rules/no-side-effect-import.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-side-effect-import.d.mts","sourceRoot":"","sources":["../../src/rules/no-side-effect-import.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,gDAKlC,QAAQ,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,KAAG,QAAQ,CAAC,UAAU,CAAC,wBAAwB,EAAE,SAAS,EAAE,CAwBjD,CAAC"}

package/dist/rules/no-side-effect-import.mjs

@@ -0,0 +1,45 @@
+
+
+
+
+
+
+
+
+
+
+export const createNoSideEffectImport = ({ moduleName, type, description, message, }) => ({
+    meta: {
+        type,
+        docs: { description },
+        fixable: 'code',
+        schema: [],
+        messages: { removeSideEffectImport: message },
+    },
+    create: (context) => ({
+        ImportDeclaration: (node) => {
+            if (node.source.value !== moduleName || node.specifiers.length > 0) {
+                return;
+            }
+            context.report({
+                node,
+                messageId: 'removeSideEffectImport',
+                fix: (fixer) => removeStatement(fixer, context.sourceCode, node),
+            });
+        },
+    }),
+    defaultOptions: [],
+});
+
+
+
+
+
+const removeStatement = (fixer, sourceCode, node) => {
+    const restOfLine = /^[^\S\n]*\n/u.exec(sourceCode.getText().slice(node.range[1]));
+    return fixer.removeRange([
+        node.range[0],
+        node.range[1] + (restOfLine?.[0].length ?? 0),
+    ]);
+};
+//# sourceMappingURL=no-side-effect-import.mjs.map

package/dist/rules/no-side-effect-import.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-side-effect-import.mjs","sourceRoot":"","sources":["../../src/rules/no-side-effect-import.mts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,EACvC,UAAU,EACV,IAAI,EACJ,WAAW,EACX,OAAO,GAMP,EAA8D,EAAE,CAChE,CAAC;IACC,IAAI,EAAE;QACJ,IAAI;QACJ,IAAI,EAAE,EAAE,WAAW,EAAE;QACrB,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE;KAC9C;IAED,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACpB,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnE,OAAO;YACT,CAAC;YAED,OAAO,CAAC,MAAM,CAAC;gBACb,IAAI;gBACJ,SAAS,EAAE,wBAAwB;gBACnC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC;aACjE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IACF,cAAc,EAAE,EAAE;CACnB,CAAU,CAAC;AAEd,uEAAuE;AAEvE;;;GAGG;AACH,MAAM,eAAe,GAAG,CACtB,KAAyB,EACzB,UAA+B,EAC/B,IAAmB,EACD,EAAE;IACpB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CACpC,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAC1C,CAAC;IAEF,OAAO,KAAK,CAAC,WAAW,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/rules/prefer-array-is-array.d.mts

@@ -0,0 +1,13 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+/**
+ * Builds a rule that replaces `Array.isArray` with `<namespace>.isArray`
+ * imported from `moduleName`. Only the callee is rewritten; the arguments stay
+ * as written.
+ */
+export declare const createPreferArrayIsArray: ({ moduleName, namespace, }: Readonly<{
+    /** The module that exports `namespace`. */
+    moduleName: string;
+    /** The exported namespace whose `isArray` replaces `Array.isArray`. */
+    namespace: string;
+}>) => TSESLint.RuleModule<'useIsArray', readonly []>;
+//# sourceMappingURL=prefer-array-is-array.d.mts.map

package/dist/rules/prefer-array-is-array.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-array-is-array.d.mts","sourceRoot":"","sources":["../../src/rules/prefer-array-is-array.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AASlC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,+BAGlC,QAAQ,CAAC;IACV,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,KAAG,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,SAAS,EAAE,CAuEjD,CAAC"}

package/dist/rules/prefer-array-is-array.mjs

@@ -0,0 +1,81 @@
+import { AST_NODE_TYPES, } from '@typescript-eslint/utils';
+import { buildNamedImportFix, getImportDeclarations, getNamedImports, } from '../imports.mjs';
+import { getRangeWithParens } from '../parentheses.mjs';
+import { isIdentifierNamed, skipTypeWrappers } from '../type-wrappers.mjs';
+
+
+
+
+
+export const createPreferArrayIsArray = ({ moduleName, namespace, }) => {
+    const replacement = `${namespace}.isArray`;
+    const text = `Replace \`Array.isArray\` with \`${replacement}\` from ${moduleName}.`;
+    return {
+        meta: {
+            type: 'suggestion',
+            docs: { description: text },
+            fixable: 'code',
+            schema: [],
+            messages: { useIsArray: text },
+        },
+        create: (context) => {
+            const sourceCode = context.sourceCode;
+            const program = sourceCode.ast;
+            const moduleImports = getImportDeclarations(program, moduleName);
+            const mut_nodesToFix = [];
+            return {
+                CallExpression: (node) => {
+                    if (!isArrayIsArrayCall(node)) {
+                        return;
+                    }
+                    mut_nodesToFix.push(node);
+                },
+                'Program:exit': () => {
+                    const hasNamespaceImport = getNamedImports(moduleImports).includes(namespace);
+
+
+
+
+
+                    for (const [index, node] of mut_nodesToFix.entries()) {
+                        context.report({
+                            node,
+                            messageId: 'useIsArray',
+                            fix: (fixer) => {
+                                const importFixes = index === 0 && !hasNamespaceImport
+                                    ? buildNamedImportFix(fixer, program, moduleName, [
+                                        namespace,
+                                    ])
+                                    : [];
+
+
+
+                                return [
+                                    ...importFixes,
+                                    fixer.replaceTextRange(getRangeWithParens(sourceCode, node.callee), replacement),
+                                ];
+                            },
+                        });
+                    }
+                },
+            };
+        },
+        defaultOptions: [],
+    };
+};
+
+
+
+
+
+const isArrayIsArrayCall = (
+
+node) => {
+    const callee = skipTypeWrappers(node.callee);
+    return (callee.type === AST_NODE_TYPES.MemberExpression &&
+        !callee.computed &&
+        isIdentifierNamed(callee.object, 'Array') &&
+        callee.property.type === AST_NODE_TYPES.Identifier &&
+        callee.property.name === 'isArray');
+};
+//# sourceMappingURL=prefer-array-is-array.mjs.map

package/dist/rules/prefer-array-is-array.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-array-is-array.mjs","sourceRoot":"","sources":["../../src/rules/prefer-array-is-array.mts"],"names":[],"mappings":"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"}

package/dist/rules/prefer-is-non-null-object.d.mts

@@ -0,0 +1,11 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+/**
+ * Builds a rule that replaces `typeof u === 'object' && u !== null`, in either
+ * order and anywhere in an `&&` chain, with `isNonNullObject(u)` imported from
+ * `moduleName`.
+ */
+export declare const createPreferIsNonNullObject: ({ moduleName, }: Readonly<{
+    /** The module that exports `isNonNullObject`. */
+    moduleName: string;
+}>) => TSESLint.RuleModule<'useIsNonNullObject', readonly []>;
+//# sourceMappingURL=prefer-is-non-null-object.d.mts.map

package/dist/rules/prefer-is-non-null-object.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-is-non-null-object.d.mts","sourceRoot":"","sources":["../../src/rules/prefer-is-non-null-object.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AASlC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,oBAErC,QAAQ,CAAC;IACV,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,KAAG,QAAQ,CAAC,UAAU,CAAC,oBAAoB,EAAE,SAAS,EAAE,CAwE7C,CAAC"}

package/dist/rules/prefer-is-non-null-object.mjs

@@ -0,0 +1,192 @@
+import { AST_NODE_TYPES, } from '@typescript-eslint/utils';
+import { buildNamedImportFix, getImportDeclarations, getNamedImports, } from '../imports.mjs';
+import { getRangeWithParens, parenthesesDepth } from '../parentheses.mjs';
+import { skipTypeWrappers } from '../type-wrappers.mjs';
+
+
+
+
+
+export const createPreferIsNonNullObject = ({ moduleName, }) => ({
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: `Replace \`typeof u === "object" && u !== null\`, in either order and anywhere in an \`&&\` chain, with \`isNonNullObject(u)\` from ${moduleName}.`,
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            useIsNonNullObject: `Replace the object/null check with \`isNonNullObject()\` from ${moduleName}.`,
+        },
+    },
+    create: (context) => {
+        const sourceCode = context.sourceCode;
+        const program = sourceCode.ast;
+        const moduleImports = getImportDeclarations(program, moduleName);
+        const mut_pairsToFix = [];
+        return {
+            LogicalExpression: (node) => {
+
+                if (node.operator !== '&&' || isChainOperand(sourceCode, node)) {
+                    return;
+                }
+                mut_pairsToFix.push(...findNonNullObjectPairs(sourceCode, node));
+            },
+            'Program:exit': () => {
+                const hasIsNonNullObjectImport = getNamedImports(moduleImports).includes('isNonNullObject');
+
+
+
+
+
+                for (const [index, { range, identifierName },] of mut_pairsToFix.entries()) {
+                    context.report({
+                        loc: {
+                            start: sourceCode.getLocFromIndex(range[0]),
+                            end: sourceCode.getLocFromIndex(range[1]),
+                        },
+                        messageId: 'useIsNonNullObject',
+                        fix: (fixer) => {
+                            const replacement = `isNonNullObject(${identifierName})`;
+                            const importFixes = index === 0 && !hasIsNonNullObjectImport
+                                ? buildNamedImportFix(fixer, program, moduleName, [
+                                    'isNonNullObject',
+                                ])
+                                : [];
+                            return [
+                                ...importFixes,
+                                fixer.replaceTextRange(range, replacement),
+                            ];
+                        },
+                    });
+                }
+            },
+        };
+    },
+    defaultOptions: [],
+});
+
+
+
+
+const isChainOperand = (
+
+sourceCode, 
+
+node) => node.parent.type === AST_NODE_TYPES.LogicalExpression &&
+    node.parent.operator === '&&' &&
+    parenthesesDepth(sourceCode, node) === 0;
+
+
+
+
+
+
+const findNonNullObjectPairs = (
+
+sourceCode, 
+
+node) => {
+    const operands = chainOperands(sourceCode, node);
+    const pairsFrom = (index) => {
+        const first = operands[index];
+        const second = operands[index + 1];
+        if (first === undefined || second === undefined) {
+            return [];
+        }
+        const identifierName = pairIdentifierName(first, second) ?? pairIdentifierName(second, first);
+        return identifierName === undefined
+            ? pairsFrom(index + 1)
+            : [
+                {
+                    range: [
+                        getRangeWithParens(sourceCode, first)[0],
+                        getRangeWithParens(sourceCode, second)[1],
+                    ],
+                    identifierName,
+                },
+                ...pairsFrom(index + 2),
+            ];
+    };
+    return pairsFrom(0);
+};
+
+
+
+
+const chainOperands = (
+
+sourceCode, 
+
+node) => [node.left, node.right].flatMap((operand) => operand.type === AST_NODE_TYPES.LogicalExpression &&
+    operand.operator === '&&' &&
+    parenthesesDepth(sourceCode, operand) === 0
+    ? chainOperands(sourceCode, operand)
+    : [operand]);
+
+
+
+
+
+
+const pairIdentifierName = (
+
+typeofCheck, 
+
+nullCheck) => {
+    const identifierName = getTypeofObjectIdentifierName(skipTypeWrappers(typeofCheck));
+    return identifierName !== undefined &&
+        identifierName ===
+            getNonNullCheckIdentifierName(skipTypeWrappers(nullCheck))
+        ? identifierName
+        : undefined;
+};
+
+const getTypeofObjectIdentifierName = (
+
+node) => {
+    if (node.type !== AST_NODE_TYPES.BinaryExpression ||
+        node.operator !== '===') {
+        return undefined;
+    }
+    const left = skipTypeWrappers(node.left);
+    const right = skipTypeWrappers(node.right);
+    const typeofSide = isLiteralOf(right, 'object')
+        ? left
+        : isLiteralOf(left, 'object')
+            ? right
+            : undefined;
+    if (typeofSide?.type !== AST_NODE_TYPES.UnaryExpression ||
+        typeofSide.operator !== 'typeof') {
+        return undefined;
+    }
+    const argument = skipTypeWrappers(typeofSide.argument);
+    return argument.type === AST_NODE_TYPES.Identifier
+        ? argument.name
+        : undefined;
+};
+
+
+
+
+
+const getNonNullCheckIdentifierName = (
+
+node) => {
+    if (node.type !== AST_NODE_TYPES.BinaryExpression ||
+        (node.operator !== '!==' && node.operator !== '!=')) {
+        return undefined;
+    }
+    const left = skipTypeWrappers(node.left);
+    const right = skipTypeWrappers(node.right);
+    const checked = isLiteralOf(right, null)
+        ? left
+        : isLiteralOf(left, null)
+            ? right
+            : undefined;
+    return checked?.type === AST_NODE_TYPES.Identifier ? checked.name : undefined;
+};
+const isLiteralOf = (
+
+node, value) => node.type === AST_NODE_TYPES.Literal && node.value === value;
+//# sourceMappingURL=prefer-is-non-null-object.mjs.map

package/dist/rules/prefer-is-non-null-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-is-non-null-object.mjs","sourceRoot":"","sources":["../../src/rules/prefer-is-non-null-object.mts"],"names":[],"mappings":"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"}

package/dist/rules/prefer-is-record-and-has-key.d.mts

@@ -0,0 +1,11 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+/**
+ * Builds a rule that replaces `Object.hasOwn(obj, key)` and `key in obj` with
+ * `isRecord(obj) && hasKey(obj, key)` imported from `moduleName`, or with
+ * `hasKey(obj, key)` alone when `obj` is already a record.
+ */
+export declare const createPreferIsRecordAndHasKey: ({ moduleName, }: Readonly<{
+    /** The module that exports `isRecord` and `hasKey`. */
+    moduleName: string;
+}>) => TSESLint.RuleModule<'useIsRecordAndHasKey' | 'useHasKey', readonly []>;
+//# sourceMappingURL=prefer-is-record-and-has-key.d.mts.map

package/dist/rules/prefer-is-record-and-has-key.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-is-record-and-has-key.d.mts","sourceRoot":"","sources":["../../src/rules/prefer-is-record-and-has-key.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAclC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,oBAEvC,QAAQ,CAAC;IACV,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,KAAG,QAAQ,CAAC,UAAU,CAAC,sBAAsB,GAAG,WAAW,EAAE,SAAS,EAAE,CAqN7D,CAAC"}