eslint-plugin-ts-std-forge 0.1.0

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

@@ -0,0 +1,97 @@
+import { AST_NODE_TYPES, } from '@typescript-eslint/utils';
+import { buildImportFixes, getNamedImports, getTsStdForgeImport, } from './import-utils.mjs';
+export const preferIsNonNullObject = {
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Replace `typeof u === "object" && u !== null` with `isNonNullObject(u)` from ts-std-forge.',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            useIsNonNullObject: 'Replace the object/null check with `isNonNullObject()` from ts-std-forge.',
+        },
+    },
+    create: (context) => {
+        const sourceCode = context.sourceCode;
+        const program = sourceCode.ast;
+        const tsStdForgeImport = getTsStdForgeImport(program);
+        const mut_nodesToFix = [];
+        return {
+            LogicalExpression: (node) => {
+                const identifierName = getNonNullObjectIdentifierName(node);
+                if (identifierName === undefined)
+                    return;
+                mut_nodesToFix.push({ node, identifierName });
+            },
+            'Program:exit': () => {
+                const hasIsNonNullObjectImport = getNamedImports(tsStdForgeImport).includes('isNonNullObject');
+
+
+
+
+
+                for (const [index, { node, identifierName },] of mut_nodesToFix.entries()) {
+                    context.report({
+                        node,
+                        messageId: 'useIsNonNullObject',
+                        fix: (fixer) => {
+                            const replacement = `isNonNullObject(${identifierName})`;
+                            const importFixes = index === 0 && !hasIsNonNullObjectImport
+                                ? buildImportFixes(fixer, program, ['isNonNullObject'])
+                                : [];
+                            return [...importFixes, fixer.replaceText(node, replacement)];
+                        },
+                    });
+                }
+            },
+        };
+    },
+    defaultOptions: [],
+};
+const getNonNullObjectIdentifierName = (node) => {
+    if (node.operator !== '&&')
+        return undefined;
+    const leftIdentifierName = getTypeofObjectIdentifierName(node.left);
+    const rightIdentifierName = getNonNullCheckIdentifierName(node.right);
+    if (leftIdentifierName === undefined)
+        return undefined;
+    if (rightIdentifierName === undefined)
+        return undefined;
+    if (leftIdentifierName !== rightIdentifierName)
+        return undefined;
+    return leftIdentifierName;
+};
+const getTypeofObjectIdentifierName = (node) => {
+    if (node.type !== AST_NODE_TYPES.BinaryExpression)
+        return undefined;
+    if (node.operator !== '===')
+        return undefined;
+    const { left, right } = node;
+    if (left.type !== AST_NODE_TYPES.UnaryExpression)
+        return undefined;
+    if (left.operator !== 'typeof')
+        return undefined;
+    if (right.type !== AST_NODE_TYPES.Literal)
+        return undefined;
+    if (right.value !== 'object')
+        return undefined;
+    if (left.argument.type !== AST_NODE_TYPES.Identifier)
+        return undefined;
+    return left.argument.name;
+};
+const getNonNullCheckIdentifierName = (node) => {
+    if (node.type !== AST_NODE_TYPES.BinaryExpression)
+        return undefined;
+    if (node.operator !== '!==')
+        return undefined;
+    const { left, right } = node;
+    if (left.type !== AST_NODE_TYPES.Identifier)
+        return undefined;
+    if (right.type !== AST_NODE_TYPES.Literal)
+        return undefined;
+    if (right.value !== null)
+        return undefined;
+    return left.name;
+};
+//# 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,6 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type Options = readonly [];
+type MessageIds = 'useIsRecordAndHasKey' | 'useHasKey';
+export declare const preferIsRecordAndHasKey: TSESLint.RuleModule<MessageIds, Options>;
+export {};
+//# 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;AASlC,KAAK,OAAO,GAAG,SAAS,EAAE,CAAC;AAE3B,KAAK,UAAU,GAAG,sBAAsB,GAAG,WAAW,CAAC;AAEvD,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAuKjE,CAAC"}

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

@@ -0,0 +1,154 @@
+import { AST_NODE_TYPES, } from '@typescript-eslint/utils';
+import { SafeArray } from 'ts-std-forge';
+import * as ts from 'typescript';
+import { buildImportFixes, getNamedImports, getTsStdForgeImport, } from './import-utils.mjs';
+export const preferIsRecordAndHasKey = {
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Replace `Object.hasOwn(obj, key)` or `key in obj` with `isRecord(obj) && hasKey(obj, key)` from ts-std-forge',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            useIsRecordAndHasKey: 'Replace `{{original}}` with `isRecord({{objName}}) && hasKey({{objName}}, {{keyName}})` from ts-std-forge.',
+            useHasKey: 'Replace `{{original}}` with `hasKey({{objName}}, {{keyName}})` from ts-std-forge.',
+        },
+    },
+    create: (context) => {
+        const sourceCode = context.sourceCode;
+        const program = sourceCode.ast;
+        const tsStdForgeImport = getTsStdForgeImport(program);
+        const services = sourceCode.parserServices;
+        const checker = services?.program?.getTypeChecker();
+
+
+
+
+
+
+        const isKnownRecord = (
+
+        expression) => {
+            if (checker === undefined)
+                return false;
+            const tsNode = services?.esTreeNodeToTSNodeMap?.get(expression);
+            return (tsNode !== undefined &&
+                isAlreadyRecordType(checker, checker.getTypeAtLocation(tsNode)));
+        };
+        const mut_nodesToFix = [];
+        return {
+
+            CallExpression: (node) => {
+                if (node.callee.type !== AST_NODE_TYPES.MemberExpression ||
+                    node.callee.object.type !== AST_NODE_TYPES.Identifier ||
+                    node.callee.object.name !== 'Object' ||
+                    node.callee.property.type !== AST_NODE_TYPES.Identifier ||
+                    node.callee.property.name !== 'hasOwn') {
+                    return;
+                }
+
+                if (node.arguments.length !== 2)
+                    return;
+                const objArg = node.arguments[0];
+                const keyArg = node.arguments[1];
+                if (objArg === undefined || keyArg === undefined)
+                    return;
+
+                if (objArg.type === AST_NODE_TYPES.SpreadElement ||
+                    keyArg.type === AST_NODE_TYPES.SpreadElement) {
+                    return;
+                }
+                mut_nodesToFix.push({
+                    node,
+                    objExpression: objArg,
+                    keyExpression: keyArg,
+                });
+            },
+
+            BinaryExpression: (node) => {
+                if (node.operator !== 'in')
+                    return;
+                const keyExpression = node.left;
+                const objExpression = node.right;
+
+                if (keyExpression.type === AST_NODE_TYPES.PrivateIdentifier)
+                    return;
+                mut_nodesToFix.push({
+                    node,
+                    objExpression,
+                    keyExpression,
+                });
+            },
+            'Program:exit': () => {
+                const namedImports = getNamedImports(tsStdForgeImport);
+                const rewrites = mut_nodesToFix.map((entry) => ({
+                    ...entry,
+
+
+                    needsIsRecord: !isKnownRecord(entry.objExpression),
+                }));
+                const importsToAdd = [
+                    ...(rewrites.some(({ needsIsRecord }) => needsIsRecord) &&
+                        !namedImports.includes('isRecord')
+                        ? ['isRecord']
+                        : []),
+                    ...(namedImports.includes('hasKey') ? [] : ['hasKey']),
+                ];
+                for (const [index, { node, objExpression, keyExpression, needsIsRecord },] of rewrites.entries()) {
+                    const objText = sourceCode.getText(objExpression);
+                    const keyText = sourceCode.getText(keyExpression);
+                    const originalText = sourceCode.getText(node);
+                    context.report({
+                        node,
+                        messageId: needsIsRecord ? 'useIsRecordAndHasKey' : 'useHasKey',
+                        data: {
+                            original: originalText,
+                            objName: objText,
+                            keyName: keyText,
+                        },
+                        fix: (fixer) => {
+                            const replacement = needsIsRecord
+                                ? `(isRecord(${objText}) && hasKey(${objText}, ${keyText}))`
+                                : `hasKey(${objText}, ${keyText})`;
+
+
+
+                            const importFixes = index === 0 && importsToAdd.length > 0
+                                ? buildImportFixes(fixer, program, importsToAdd)
+                                : [];
+                            return [...importFixes, fixer.replaceText(node, replacement)];
+                        },
+                    });
+                }
+            },
+        };
+    },
+    defaultOptions: [],
+};
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+const isAlreadyRecordType = (
+
+checker, 
+
+type) => type.isUnion()
+    ? type.types.every((member) => isAlreadyRecordType(checker, member))
+    : checker.getIndexInfoOfType(type, ts.IndexKind.String) !== undefined &&
+        SafeArray.isEmpty(checker.getSignaturesOfType(type, ts.SignatureKind.Call)) &&
+        SafeArray.isEmpty(checker.getSignaturesOfType(type, ts.SignatureKind.Construct)) &&
+        !checker.isArrayType(type) &&
+        !checker.isTupleType(type);
+//# sourceMappingURL=prefer-is-record-and-has-key.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-is-record-and-has-key.mjs","sourceRoot":"","sources":["../../src/rules/prefer-is-record-and-has-key.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,CAAC,MAAM,uBAAuB,GAClC;IACE,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,8GAA8G;SACjH;QACD,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,oBAAoB,EAClB,4GAA4G;YAC9G,SAAS,EACP,mFAAmF;SACtF;KACF;IAED,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAEtC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC;QAE/B,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC;QAE3C,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAEpD;;;;;WAKG;QACH,MAAM,aAAa,GAAG;QACpB,8EAA8E;QAC9E,UAA+B,EACtB,EAAE;YACX,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YAExC,MAAM,MAAM,GAAG,QAAQ,EAAE,qBAAqB,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;YAEhE,OAAO,CACL,MAAM,KAAK,SAAS;gBACpB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAChE,CAAC;QACJ,CAAC,CAAC;QAEF,MAAM,cAAc,GAId,EAAE,CAAC;QAET,OAAO;YACL,iCAAiC;YACjC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE;gBACvB,IACE,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB;oBACpD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;oBACrD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;oBACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;oBACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EACtC,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,2CAA2C;gBAC3C,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAExC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAEjC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAEjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO;gBAEzD,mEAAmE;gBACnE,IACE,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,aAAa;oBAC5C,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,aAAa,EAC5C,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,cAAc,CAAC,IAAI,CAAC;oBAClB,IAAI;oBACJ,aAAa,EAAE,MAAM;oBACrB,aAAa,EAAE,MAAM;iBACtB,CAAC,CAAC;YACL,CAAC;YAED,oBAAoB;YACpB,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;oBAAE,OAAO;gBAEnC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC;gBAEhC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;gBAEjC,yEAAyE;gBACzE,IAAI,aAAa,CAAC,IAAI,KAAK,cAAc,CAAC,iBAAiB;oBAAE,OAAO;gBAEpE,cAAc,CAAC,IAAI,CAAC;oBAClB,IAAI;oBACJ,aAAa;oBACb,aAAa;iBACd,CAAC,CAAC;YACL,CAAC;YAED,cAAc,EAAE,GAAG,EAAE;gBACnB,MAAM,YAAY,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;gBAEvD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC9C,GAAG,KAAK;oBACR,kEAAkE;oBAClE,uDAAuD;oBACvD,aAAa,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC;iBACnD,CAAC,CAAC,CAAC;gBAEJ,MAAM,YAAY,GAAsB;oBACtC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC;wBACvD,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAChC,CAAC,CAAC,CAAC,UAAU,CAAC;wBACd,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;iBACvD,CAAC;gBAEF,KAAK,MAAM,CACT,KAAK,EACL,EAAE,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,EACtD,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;oBACxB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;oBAElD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;oBAElD,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAE9C,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI;wBACJ,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,WAAW;wBAC/D,IAAI,EAAE;4BACJ,QAAQ,EAAE,YAAY;4BACtB,OAAO,EAAE,OAAO;4BAChB,OAAO,EAAE,OAAO;yBACjB;wBACD,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;4BACb,MAAM,WAAW,GAAG,aAAa;gCAC/B,CAAC,CAAC,aAAa,OAAO,eAAe,OAAO,KAAK,OAAO,IAAI;gCAC5D,CAAC,CAAC,UAAU,OAAO,KAAK,OAAO,GAAG,CAAC;4BAErC,qDAAqD;4BACrD,6DAA6D;4BAC7D,uDAAuD;4BACvD,MAAM,WAAW,GACf,KAAK,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;gCACpC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC;gCAChD,CAAC,CAAC,EAAE,CAAC;4BAET,OAAO,CAAC,GAAG,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;wBAChE,CAAC;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IACD,cAAc,EAAE,EAAE;CACV,CAAC;AAEb;;;;;;;;;;;;;GAaG;AACH,MAAM,mBAAmB,GAAG;AAC1B,8EAA8E;AAC9E,OAAuB;AACvB,8EAA8E;AAC9E,IAAa,EACJ,EAAE,CACX,IAAI,CAAC,OAAO,EAAE;IACZ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,SAAS;QACnE,SAAS,CAAC,OAAO,CACf,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CACzD;QACD,SAAS,CAAC,OAAO,CACf,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAC9D;QACD,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAC1B,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC"}

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

@@ -0,0 +1,6 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type Options = readonly [];
+type MessageIds = 'useSafeArrayIsArray';
+export declare const preferSafeArrayIsArray: TSESLint.RuleModule<MessageIds, Options>;
+export {};
+//# sourceMappingURL=prefer-safe-array-is-array.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-safe-array-is-array.d.mts","sourceRoot":"","sources":["../../src/rules/prefer-safe-array-is-array.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAQlC,KAAK,OAAO,GAAG,SAAS,EAAE,CAAC;AAE3B,KAAK,UAAU,GAAG,qBAAqB,CAAC;AAExC,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAgEhE,CAAC"}

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

@@ -0,0 +1,68 @@
+import { AST_NODE_TYPES, } from '@typescript-eslint/utils';
+import { buildImportFixes, getNamedImports, getTsStdForgeImport, } from './import-utils.mjs';
+export const preferSafeArrayIsArray = {
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Replace `Array.isArray` with `SafeArray.isArray` from ts-std-forge.',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            useSafeArrayIsArray: 'Replace `Array.isArray` with `SafeArray.isArray` from ts-std-forge.',
+        },
+    },
+    create: (context) => {
+        const sourceCode = context.sourceCode;
+        const program = sourceCode.ast;
+        const tsStdForgeImport = getTsStdForgeImport(program);
+        const mut_nodesToFix = [];
+        return {
+            CallExpression: (node) => {
+                if (!isArrayIsArrayCall(node))
+                    return;
+                mut_nodesToFix.push(node);
+            },
+            'Program:exit': () => {
+                const hasSafeArrayImport = getNamedImports(tsStdForgeImport).includes('SafeArray');
+
+
+
+
+
+                for (const [index, node] of mut_nodesToFix.entries()) {
+                    context.report({
+                        node,
+                        messageId: 'useSafeArrayIsArray',
+                        fix: (fixer) => {
+                            const callee = node.callee;
+                            if (callee.type !== AST_NODE_TYPES.MemberExpression)
+                                return [];
+                            const replacement = `SafeArray.isArray${sourceCode.getText(node).slice(sourceCode.getText(callee).length)}`;
+                            const importFixes = index === 0 && !hasSafeArrayImport
+                                ? buildImportFixes(fixer, program, ['SafeArray'])
+                                : [];
+                            return [...importFixes, fixer.replaceText(node, replacement)];
+                        },
+                    });
+                }
+            },
+        };
+    },
+    defaultOptions: [],
+};
+const isArrayIsArrayCall = (node) => {
+    if (node.callee.type !== AST_NODE_TYPES.MemberExpression)
+        return false;
+    const { object, property } = node.callee;
+    if (object.type !== AST_NODE_TYPES.Identifier)
+        return false;
+    if (object.name !== 'Array')
+        return false;
+    if (property.type !== AST_NODE_TYPES.Identifier)
+        return false;
+    if (property.name !== 'isArray')
+        return false;
+    return true;
+};
+//# sourceMappingURL=prefer-safe-array-is-array.mjs.map

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

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

package/dist/rules/prefer-safe-array-length-guard.d.mts

@@ -0,0 +1,6 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type Options = readonly [];
+type MessageIds = 'useIsEmpty' | 'useIsNonEmpty';
+export declare const preferSafeArrayLengthGuard: TSESLint.RuleModule<MessageIds, Options>;
+export {};
+//# sourceMappingURL=prefer-safe-array-length-guard.d.mts.map

package/dist/rules/prefer-safe-array-length-guard.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-safe-array-length-guard.d.mts","sourceRoot":"","sources":["../../src/rules/prefer-safe-array-length-guard.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAQlC,KAAK,OAAO,GAAG,SAAS,EAAE,CAAC;AAE3B,KAAK,UAAU,GAAG,YAAY,GAAG,eAAe,CAAC;AAwCjD,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,UAAU,CAC1D,UAAU,EACV,OAAO,CAuGC,CAAC"}

package/dist/rules/prefer-safe-array-length-guard.mjs

@@ -0,0 +1,143 @@
+import { AST_NODE_TYPES, } from '@typescript-eslint/utils';
+import { buildImportFixes, getNamedImports, getTsStdForgeImport, } from './import-utils.mjs';
+
+
+
+
+
+
+
+
+
+
+const COMPARISONS = [
+    { operator: '===', bound: 0, guard: 'isEmpty' },
+    { operator: '!==', bound: 0, guard: 'isNonEmpty' },
+    { operator: '>', bound: 0, guard: 'isNonEmpty' },
+    { operator: '>=', bound: 1, guard: 'isNonEmpty' },
+];
+
+const FLIPPED = {
+    '===': '===',
+    '!==': '!==',
+    '>': '<',
+    '<': '>',
+    '>=': '<=',
+    '<=': '>=',
+};
+const MESSAGE_IDS = {
+    isEmpty: 'useIsEmpty',
+    isNonEmpty: 'useIsNonEmpty',
+};
+export const preferSafeArrayLengthGuard = {
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Replace an emptiness check on an array (`xs.length === 0`, `xs.length > 0`, `xs.length >= 1`, `xs.length !== 0`) with `SafeArray.isEmpty(xs)` / `SafeArray.isNonEmpty(xs)` from ts-std-forge.',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            useIsEmpty: 'Replace `{{original}}` with `SafeArray.isEmpty({{arrayName}})` from ts-std-forge: the comparison narrows nothing, the guard narrows to `readonly []`.',
+            useIsNonEmpty: 'Replace `{{original}}` with `SafeArray.isNonEmpty({{arrayName}})` from ts-std-forge: the comparison narrows nothing, so `{{arrayName}}[0]` stays `| undefined`.',
+        },
+    },
+    create: (context) => {
+        const sourceCode = context.sourceCode;
+        const program = sourceCode.ast;
+        const tsStdForgeImport = getTsStdForgeImport(program);
+        const services = sourceCode.parserServices;
+        const checker = services?.program?.getTypeChecker();
+
+
+
+
+
+        const isArrayLike = (
+
+        expression) => {
+            if (checker === undefined)
+                return false;
+            const tsNode = services?.esTreeNodeToTSNodeMap?.get(expression);
+            if (tsNode === undefined)
+                return false;
+            const type = checker.getTypeAtLocation(tsNode);
+            return checker.isArrayType(type) || checker.isTupleType(type);
+        };
+        const mut_nodesToFix = [];
+        return {
+            BinaryExpression: (node) => {
+                const matched = matchLengthComparison(node);
+                if (matched === undefined)
+                    return;
+                if (!isArrayLike(matched.arrayExpression))
+                    return;
+                mut_nodesToFix.push({ node, ...matched });
+            },
+            'Program:exit': () => {
+                const hasSafeArrayImport = getNamedImports(tsStdForgeImport).includes('SafeArray');
+
+
+
+
+
+                for (const [index, { node, arrayExpression, guard },] of mut_nodesToFix.entries()) {
+                    const arrayText = sourceCode.getText(arrayExpression);
+                    context.report({
+                        node,
+                        messageId: MESSAGE_IDS[guard],
+                        data: {
+                            original: sourceCode.getText(node),
+                            arrayName: arrayText,
+                        },
+                        fix: (fixer) => {
+                            const replacement = `SafeArray.${guard}(${arrayText})`;
+                            const importFixes = index === 0 && !hasSafeArrayImport
+                                ? buildImportFixes(fixer, program, ['SafeArray'])
+                                : [];
+                            return [...importFixes, fixer.replaceText(node, replacement)];
+                        },
+                    });
+                }
+            },
+        };
+    },
+    defaultOptions: [],
+};
+
+
+
+
+
+const matchLengthComparison = (
+
+
+
+node) => {
+    const { left, right } = node;
+    if (left.type === AST_NODE_TYPES.PrivateIdentifier)
+        return undefined;
+    const lengthOnLeft = isLengthAccess(left);
+    const lengthSide = lengthOnLeft ? left : right;
+    const boundSide = lengthOnLeft ? right : left;
+    if (!isLengthAccess(lengthSide))
+        return undefined;
+
+
+    if (boundSide.type !== AST_NODE_TYPES.Literal ||
+        typeof boundSide.value !== 'number') {
+        return undefined;
+    }
+    const operator = lengthOnLeft ? node.operator : FLIPPED[node.operator];
+    const matched = COMPARISONS.find((entry) => entry.operator === operator && entry.bound === boundSide.value);
+    return matched === undefined
+        ? undefined
+        : { arrayExpression: lengthSide.object, guard: matched.guard };
+};
+const isLengthAccess = (
+
+node) => node.type === AST_NODE_TYPES.MemberExpression &&
+    !node.computed &&
+    node.property.type === AST_NODE_TYPES.Identifier &&
+    node.property.name === 'length';
+//# sourceMappingURL=prefer-safe-array-length-guard.mjs.map

package/dist/rules/prefer-safe-array-length-guard.mjs.map

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

package/dist/rules/prefer-safe-number-parse-integer.d.mts

@@ -0,0 +1,13 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type Options = readonly [];
+type MessageIds = 'useSafeNumberParseInteger';
+/**
+ * Detects `parseInt(x)` / `Number.parseInt(x, 10)` and replaces them with
+ * `Result.unwrapOkOr(SafeNumber.parseInteger(x), Number.NaN)` (ts-std-forge).
+ *
+ * Only base 10 is rewritten: `SafeNumber.parseInteger` takes no radix, so a
+ * call that passes another one means something the replacement cannot say.
+ */
+export declare const preferSafeNumberParseInteger: TSESLint.RuleModule<MessageIds, Options>;
+export {};
+//# sourceMappingURL=prefer-safe-number-parse-integer.d.mts.map

package/dist/rules/prefer-safe-number-parse-integer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-safe-number-parse-integer.d.mts","sourceRoot":"","sources":["../../src/rules/prefer-safe-number-parse-integer.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAQlC,KAAK,OAAO,GAAG,SAAS,EAAE,CAAC;AAE3B,KAAK,UAAU,GAAG,2BAA2B,CAAC;AAkB9C;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,UAAU,CAC5D,UAAU,EACV,OAAO,CAwHC,CAAC"}

package/dist/rules/prefer-safe-number-parse-integer.mjs

@@ -0,0 +1,109 @@
+import { AST_NODE_TYPES, } from '@typescript-eslint/utils';
+import * as ts from 'typescript';
+import { buildImportFixes, getNamedImports, getTsStdForgeImport, } from './import-utils.mjs';
+
+
+
+
+
+
+
+const isStringType = (type) => {
+    const parts = type.isUnion() ? type.types : [type];
+    return (parts.length > 0 &&
+        parts.every((t) => (t.flags & ts.TypeFlags.StringLike) !== 0));
+};
+
+
+
+
+
+
+
+export const preferSafeNumberParseInteger = {
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Replace `parseInt(x)` or `Number.parseInt(x, 10)` with `Result.unwrapOkOr(SafeNumber.parseInteger(x), Number.NaN)` from ts-std-forge.',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            useSafeNumberParseInteger: 'Replace `{{original}}` with `Result.unwrapOkOr(SafeNumber.parseInteger({{argName}}), Number.NaN)` from ts-std-forge.',
+        },
+    },
+    create: (context) => {
+        const sourceCode = context.sourceCode;
+        const program = sourceCode.ast;
+        const tsStdForgeImport = getTsStdForgeImport(program);
+        const services = sourceCode.parserServices;
+        const mut_nodesToFix = [];
+        return {
+            CallExpression: (node) => {
+                const { callee } = node;
+
+                const isGlobalParseInt = callee.type === AST_NODE_TYPES.Identifier &&
+                    callee.name === 'parseInt';
+                const isNumberParseInt = callee.type === AST_NODE_TYPES.MemberExpression &&
+                    !callee.computed &&
+                    callee.object.type === AST_NODE_TYPES.Identifier &&
+                    callee.object.name === 'Number' &&
+                    callee.property.type === AST_NODE_TYPES.Identifier &&
+                    callee.property.name === 'parseInt';
+                if (!isGlobalParseInt && !isNumberParseInt)
+                    return;
+                const args = node.arguments;
+                const firstArg = args[0];
+                if (firstArg === undefined)
+                    return;
+
+                if (firstArg.type === AST_NODE_TYPES.SpreadElement)
+                    return;
+
+                if (args.length >= 2) {
+                    const radix = args[1];
+                    if (radix?.type !== AST_NODE_TYPES.Literal || radix.value !== 10) {
+                        return;
+                    }
+                }
+
+
+
+                if (services?.program == null)
+                    return;
+                const checker = services.program.getTypeChecker();
+                const tsNode = services.esTreeNodeToTSNodeMap?.get(firstArg);
+                if (tsNode === undefined)
+                    return;
+                const argType = checker.getTypeAtLocation(tsNode);
+                if (!isStringType(argType))
+                    return;
+                mut_nodesToFix.push({ node, argExpression: firstArg });
+            },
+            'Program:exit': () => {
+                const namedImports = getNamedImports(tsStdForgeImport);
+                const missingImports = ['Result', 'SafeNumber'].filter((name) => !namedImports.includes(name));
+                for (const [index, { node, argExpression },] of mut_nodesToFix.entries()) {
+                    const argText = sourceCode.getText(argExpression);
+                    context.report({
+                        node,
+                        messageId: 'useSafeNumberParseInteger',
+                        data: {
+                            original: sourceCode.getText(node),
+                            argName: argText,
+                        },
+                        fix: (fixer) => {
+                            const core = `Result.unwrapOkOr(SafeNumber.parseInteger(${argText}), Number.NaN)`;
+                            const importFixes = index === 0 && missingImports.length > 0
+                                ? buildImportFixes(fixer, program, missingImports)
+                                : [];
+                            return [...importFixes, fixer.replaceText(node, core)];
+                        },
+                    });
+                }
+            },
+        };
+    },
+    defaultOptions: [],
+};
+//# sourceMappingURL=prefer-safe-number-parse-integer.mjs.map