@definitelytyped/eslint-plugin 0.0.197 → 0.0.198

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @definitelytyped/eslint-plugin
 
+## 0.0.198
+
+### Patch Changes
+
+- 414ae487: Move npm-naming lint rule from tslint to eslint
+- Updated dependencies [414ae487]
+  - @definitelytyped/dts-critic@0.0.192
+
 ## 0.0.197
 
 ### Patch Changes

package/dist/configs/all.js

@@ -135,7 +135,11 @@ exports.all = {
                 warnOnUnsupportedTypeScriptVersion: false,
             },
             rules: {
-                ...Object.fromEntries(Object.keys(rules_1.rules).map((name) => [`@definitelytyped/${name}`, "error"])),
+                ...Object.fromEntries(Object.keys(rules_1.rules)
+                    // npm-naming is only enabled within dtslint.
+                    // Leave it out of the preset so editors / he tests don't hit the network.
+                    .filter((name) => name !== "npm-naming")
+                    .map((name) => [`@definitelytyped/${name}`, "error"])),
                 "unicode-bom": ["error", "never"],
                 "@typescript-eslint/ban-ts-comment": [
                     "error",

package/dist/configs/all.js.map

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

package/dist/rules/index.d.ts

@@ -17,6 +17,7 @@ export declare const rules: {
     "no-single-declare-module": import("../util").RuleModule<never[], "oneModuleDeclaration">;
     "no-old-dt-header": import("../util").RuleModule<never[], "noOldDTHeader">;
     "no-import-of-dev-dependencies": import("../util").RuleModule<never[], "noImportOfDevDependencies" | "noReferenceOfDevDependencies">;
+    "npm-naming": import("../util").RuleModule<[import("./npm-naming/types").NpmNamingOptions], "error">;
     expect: import("../util").RuleModule<[{
         versionsToTest?: {
             readonly versionName: string;

package/dist/rules/index.js

@@ -19,6 +19,7 @@ const strictExportDeclareModifiers = require("./strict-export-declare-modifiers"
 const noSingleDeclareModule = require("./no-single-declare-module");
 const noOldDTHeader = require("./no-old-dt-header");
 const noImportOfDevDependencies = require("./no-import-of-dev-dependencies");
+const npmNaming = require("./npm-naming");
 const expect = require("./expect");
 exports.rules = {
     "export-just-namespace": exportJustNamespace,
@@ -39,6 +40,7 @@ exports.rules = {
     "no-single-declare-module": noSingleDeclareModule,
     "no-old-dt-header": noOldDTHeader,
     "no-import-of-dev-dependencies": noImportOfDevDependencies,
+    "npm-naming": npmNaming,
     expect,
 };
 //# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":";;;AAAA,+DAAgE;AAChE,6CAA8C;AAC9C,qDAAsD;AACtD,+CAAgD;AAChD,uDAAwD;AACxD,wEAAyE;AACzE,sFAAuF;AACvF,uEAAwE;AACxE,iDAAkD;AAClD,2EAA4E;AAC5E,mEAAoE;AACpE,qDAAsD;AACtD,mEAAoE;AACpE,4DAA6D;AAC7D,kFAAmF;AACnF,oEAAqE;AACrE,oDAAqD;AACrD,6EAA8E;AAC9E,mCAAoC;AAEvB,QAAA,KAAK,GAAG;IACnB,uBAAuB,EAAE,mBAAmB;IAC5C,cAAc,EAAE,UAAU;IAC1B,kBAAkB,EAAE,cAAc;IAClC,eAAe,EAAE,WAAW;IAC5B,mBAAmB,EAAE,eAAe;IACpC,4BAA4B,EAAE,uBAAuB;IACrD,oCAAoC,EAAE,6BAA6B;IACnE,4BAA4B,EAAE,sBAAsB;IACpD,gBAAgB,EAAE,YAAY;IAC9B,8BAA8B,EAAE,wBAAwB;IACxD,yBAAyB,EAAE,qBAAqB;IAChD,kBAAkB,EAAE,cAAc;IAClC,yBAAyB,EAAE,qBAAqB;IAChD,qBAAqB,EAAE,kBAAkB;IACzC,iCAAiC,EAAE,4BAA4B;IAC/D,0BAA0B,EAAE,qBAAqB;IACjD,kBAAkB,EAAE,aAAa;IACjC,+BAA+B,EAAE,yBAAyB;IAC1D,MAAM;CACP,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":";;;AAAA,+DAAgE;AAChE,6CAA8C;AAC9C,qDAAsD;AACtD,+CAAgD;AAChD,uDAAwD;AACxD,wEAAyE;AACzE,sFAAuF;AACvF,uEAAwE;AACxE,iDAAkD;AAClD,2EAA4E;AAC5E,mEAAoE;AACpE,qDAAsD;AACtD,mEAAoE;AACpE,4DAA6D;AAC7D,kFAAmF;AACnF,oEAAqE;AACrE,oDAAqD;AACrD,6EAA8E;AAC9E,0CAA2C;AAC3C,mCAAoC;AAEvB,QAAA,KAAK,GAAG;IACnB,uBAAuB,EAAE,mBAAmB;IAC5C,cAAc,EAAE,UAAU;IAC1B,kBAAkB,EAAE,cAAc;IAClC,eAAe,EAAE,WAAW;IAC5B,mBAAmB,EAAE,eAAe;IACpC,4BAA4B,EAAE,uBAAuB;IACrD,oCAAoC,EAAE,6BAA6B;IACnE,4BAA4B,EAAE,sBAAsB;IACpD,gBAAgB,EAAE,YAAY;IAC9B,8BAA8B,EAAE,wBAAwB;IACxD,yBAAyB,EAAE,qBAAqB;IAChD,kBAAkB,EAAE,cAAc;IAClC,yBAAyB,EAAE,qBAAqB;IAChD,qBAAqB,EAAE,kBAAkB;IACzC,iCAAiC,EAAE,4BAA4B;IAC/D,0BAA0B,EAAE,qBAAqB;IACjD,kBAAkB,EAAE,aAAa;IACjC,+BAA+B,EAAE,yBAAyB;IAC1D,YAAY,EAAE,SAAS;IACvB,MAAM;CACP,CAAC"}

package/dist/rules/npm-naming/types.d.ts

@@ -0,0 +1,10 @@
+import { ExportErrorKind, Mode } from "@definitelytyped/dts-critic";
+export type CodeRawOptionError = [ExportErrorKind, boolean];
+export interface CodeRawOptions {
+    mode: Mode.Code;
+    errors: CodeRawOptionError[];
+}
+export interface NameOnlyRawOptions {
+    mode: Mode.NameOnly;
+}
+export type NpmNamingOptions = CodeRawOptions | NameOnlyRawOptions;

package/dist/rules/npm-naming/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/rules/npm-naming/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rules/npm-naming/types.ts"],"names":[],"mappings":""}

package/dist/rules/npm-naming.d.ts

@@ -0,0 +1,3 @@
+import { NpmNamingOptions } from "./npm-naming/types";
+declare const rule: import("../util").RuleModule<[NpmNamingOptions], "error">;
+export = rule;

package/dist/rules/npm-naming.js

@@ -0,0 +1,180 @@
+"use strict";
+const dts_critic_1 = require("@definitelytyped/dts-critic");
+const suggestions_1 = require("../suggestions");
+const util_1 = require("../util");
+function parseEnabledErrors(errors) {
+    const enabledChecks = [];
+    for (const tuple of errors) {
+        const error = (0, dts_critic_1.parseExportErrorKind)(tuple[0]);
+        if (error) {
+            enabledChecks.push([error, tuple[1]]);
+        }
+    }
+    return enabledChecks;
+}
+function parseRawOptions(rawOptions) {
+    switch (rawOptions.mode) {
+        case dts_critic_1.Mode.Code:
+            return { ...rawOptions, errors: new Map(parseEnabledErrors(rawOptions.errors)) };
+        case dts_critic_1.Mode.NameOnly:
+            return rawOptions;
+    }
+}
+const enabledSuggestions = [dts_critic_1.ErrorKind.JsPropertyNotInDts, dts_critic_1.ErrorKind.JsSignatureNotInDts];
+function toOptionsWithSuggestions(options) {
+    if (options.mode === dts_critic_1.Mode.NameOnly) {
+        return options;
+    }
+    const optionsWithSuggestions = { mode: options.mode, errors: new Map(options.errors) };
+    for (const err of enabledSuggestions) {
+        optionsWithSuggestions.errors.set(err, true);
+    }
+    return optionsWithSuggestions;
+}
+function eslintDisableOption(error) {
+    switch (error) {
+        case dts_critic_1.ErrorKind.NoMatchingNpmPackage:
+        case dts_critic_1.ErrorKind.NoMatchingNpmVersion:
+        case dts_critic_1.ErrorKind.NonNpmHasMatchingPackage:
+            return `"off"`;
+        case dts_critic_1.ErrorKind.NoDefaultExport:
+        case dts_critic_1.ErrorKind.NeedsExportEquals:
+        case dts_critic_1.ErrorKind.JsSignatureNotInDts:
+        case dts_critic_1.ErrorKind.JsPropertyNotInDts:
+        case dts_critic_1.ErrorKind.DtsSignatureNotInJs:
+        case dts_critic_1.ErrorKind.DtsPropertyNotInJs:
+            return JSON.stringify(["error", { mode: dts_critic_1.Mode.Code, errors: [[error, false]] }]);
+    }
+}
+const rule = (0, util_1.createRule)({
+    name: "npm-naming",
+    defaultOptions: [
+        {
+            mode: dts_critic_1.Mode.NameOnly,
+        },
+    ],
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Ensure that package name and DefinitelyTyped header match npm package info.",
+        },
+        messages: {
+            error: `{{ error }}
+If you won't fix this error now or you think this error is wrong,
+you can disable this check by adding the following options to your project's .eslintrc.json file under "rules":
+
+    "@definitelytyped/npm-naming": {{ option }}`,
+        },
+        schema: [
+            {
+                oneOf: [
+                    {
+                        additionalProperties: false,
+                        properties: {
+                            mode: {
+                                type: "string",
+                                enum: [dts_critic_1.Mode.NameOnly],
+                            },
+                        },
+                        type: "object",
+                    },
+                    {
+                        additionalProperties: false,
+                        type: "object",
+                        properties: {
+                            mode: {
+                                type: "string",
+                                enum: [dts_critic_1.Mode.Code],
+                            },
+                            errors: {
+                                type: "array",
+                                items: {
+                                    type: "array",
+                                    items: [
+                                        {
+                                            description: "Name of the check.",
+                                            type: "string",
+                                            enum: [dts_critic_1.ErrorKind.NeedsExportEquals, dts_critic_1.ErrorKind.NoDefaultExport],
+                                        },
+                                        {
+                                            description: "Whether the check is enabled or disabled.",
+                                            type: "boolean",
+                                        },
+                                    ],
+                                    minItems: 2,
+                                    maxItems: 2,
+                                },
+                            },
+                        },
+                    },
+                ],
+            },
+        ],
+    },
+    create(context, [rawOptions]) {
+        if (!(0, util_1.isMainFile)(context.filename, /*allowNested*/ false)) {
+            return {};
+        }
+        const options = parseRawOptions(rawOptions);
+        const optionsWithSuggestions = toOptionsWithSuggestions(options);
+        const diagnostics = (0, dts_critic_1.dtsCritic)(context.filename, /* sourcePath */ undefined, optionsWithSuggestions);
+        const errors = filterErrors(diagnostics);
+        for (const error of errors) {
+            switch (error.kind) {
+                case dts_critic_1.ErrorKind.NoMatchingNpmPackage:
+                case dts_critic_1.ErrorKind.NoMatchingNpmVersion:
+                case dts_critic_1.ErrorKind.NonNpmHasMatchingPackage:
+                case dts_critic_1.ErrorKind.DtsPropertyNotInJs:
+                case dts_critic_1.ErrorKind.DtsSignatureNotInJs:
+                case dts_critic_1.ErrorKind.JsPropertyNotInDts:
+                case dts_critic_1.ErrorKind.JsSignatureNotInDts:
+                case dts_critic_1.ErrorKind.NeedsExportEquals:
+                case dts_critic_1.ErrorKind.NoDefaultExport:
+                    context.report({
+                        data: {
+                            error: error.message,
+                            option: eslintDisableOption(error.kind),
+                        },
+                        loc: error.position
+                            ? {
+                                start: context.sourceCode.getLocFromIndex(error.position.start),
+                                end: context.sourceCode.getLocFromIndex(error.position.start + error.position.length),
+                            }
+                            : {
+                                end: {
+                                    line: 2,
+                                    column: 0,
+                                },
+                                start: {
+                                    line: 1,
+                                    column: 0,
+                                },
+                            },
+                        messageId: "error",
+                    });
+                    break;
+            }
+        }
+        return {};
+        function filterErrors(diagnostics) {
+            const errors = [];
+            diagnostics.forEach((diagnostic) => {
+                var _a, _b;
+                if (isSuggestion(diagnostic)) {
+                    (0, suggestions_1.addSuggestion)(context.filename, "npm-naming", diagnostic.message, (_a = diagnostic.position) === null || _a === void 0 ? void 0 : _a.start, (_b = diagnostic.position) === null || _b === void 0 ? void 0 : _b.length);
+                }
+                else {
+                    errors.push(diagnostic);
+                }
+            });
+            return errors;
+        }
+        function isSuggestion(diagnostic) {
+            return (options.mode === dts_critic_1.Mode.Code &&
+                enabledSuggestions.includes(diagnostic.kind) &&
+                !options.errors.get(diagnostic.kind));
+        }
+    },
+});
+module.exports = rule;
+//# sourceMappingURL=npm-naming.js.map

package/dist/rules/npm-naming.js.map

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

package/dist/suggestions.d.ts

@@ -0,0 +1,4 @@
+/**
+ *  A rule should call this function to provide a suggestion instead of a lint failure.
+ */
+export declare function addSuggestion(fileName: string, ruleName: string, message: string, start?: number, width?: number): void;

package/dist/suggestions.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addSuggestion = void 0;
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const suggestionsDir = path.join(os.homedir(), ".dts", "suggestions");
+// Packages for which suggestions were already added in this run of dtslint.
+const existingPackages = new Set();
+/**
+ *  A rule should call this function to provide a suggestion instead of a lint failure.
+ */
+function addSuggestion(fileName, ruleName, message, start, width) {
+    const suggestion = {
+        fileName,
+        ruleName,
+        message,
+        start,
+        width,
+    };
+    const packageName = dtPackageName(fileName);
+    if (!packageName) {
+        return;
+    }
+    let flag = "a";
+    if (!existingPackages.has(packageName)) {
+        flag = "w";
+        existingPackages.add(packageName);
+    }
+    try {
+        if (!fs.existsSync(suggestionsDir)) {
+            fs.mkdirSync(suggestionsDir, { recursive: true });
+        }
+        fs.writeFileSync(path.join(suggestionsDir, packageName + ".txt"), flag === "a" ? "\n" + formatSuggestion(suggestion) : formatSuggestion(suggestion), { flag, encoding: "utf8" });
+    }
+    catch (e) {
+        console.log(`Could not write suggestions for package ${packageName}. ${e.message || ""}`);
+    }
+}
+exports.addSuggestion = addSuggestion;
+const dtPath = path.join("DefinitelyTyped", "types");
+function dtPackageName(filePath) {
+    const dtIndex = filePath.indexOf(dtPath);
+    if (dtIndex === -1) {
+        return undefined;
+    }
+    const basePath = filePath.substr(dtIndex + dtPath.length);
+    const dirs = basePath.split(path.sep).filter((dir) => dir !== "");
+    if (dirs.length === 0) {
+        return undefined;
+    }
+    const packageName = dirs[0];
+    // Check if this is an old version of a package.
+    if (dirs.length > 1 && /^v\d+(\.\d+)?$/.test(dirs[1])) {
+        return packageName + dirs[1];
+    }
+    return packageName;
+}
+function formatSuggestion(suggestion) {
+    return JSON.stringify(suggestion, /*replacer*/ undefined, 0);
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":";;;AAAA,yBAA0B;AAC1B,yBAA0B;AAC1B,6BAA8B;AAE9B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AAUtE,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAC;AAEnC;;GAEG;AACH,SAAgB,aAAa,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAe,EAAE,KAAc,EAAE,KAAc;IAC/G,MAAM,UAAU,GAAe;QAC7B,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,KAAK;QACL,KAAK;KACN,CAAC;IAEF,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,WAAW,EAAE;QAChB,OAAO;KACR;IACD,IAAI,IAAI,GAAG,GAAG,CAAC;IACf,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;QACtC,IAAI,GAAG,GAAG,CAAC;QACX,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;KACnC;IACD,IAAI;QACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE;YAClC,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;SACnD;QACD,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,MAAM,CAAC,EAC/C,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACjF,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAC3B,CAAC;KACH;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,GAAG,CAAC,2CAA2C,WAAW,KAAM,CAAW,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;KACtG;AACH,CAAC;AA9BD,sCA8BC;AAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAErD,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE;QAClB,OAAO,SAAS,CAAC;KAClB;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACrB,OAAO,SAAS,CAAC;KAClB;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,gDAAgD;IAChD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QACrD,OAAO,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KAC9B;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAsB;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/util.d.ts

@@ -20,3 +20,4 @@ export interface PackageJSON {
 }
 export declare function findTypesPackage(file: string): TypesPackageInfo | undefined;
 export declare function getImportSource(node: TSESTree.ImportDeclaration | TSESTree.TSImportEqualsDeclaration): TSESTree.StringLiteral | undefined;
+export declare function isMainFile(fileName: string, allowNested: boolean): boolean;

package/dist/util.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getImportSource = exports.findTypesPackage = exports.findUp = exports.commentsMatching = exports.getTypesPackageForDeclarationFile = exports.createRule = void 0;
+exports.isMainFile = exports.getImportSource = exports.findTypesPackage = exports.findUp = exports.commentsMatching = exports.getTypesPackageForDeclarationFile = exports.createRule = void 0;
 const utils_1 = require("@definitelytyped/utils");
 const utils_2 = require("@typescript-eslint/utils");
 const path_1 = __importDefault(require("path"));
@@ -79,4 +79,22 @@ function getImportSource(node) {
     return undefined;
 }
 exports.getImportSource = getImportSource;
+function isMainFile(fileName, allowNested) {
+    // Linter may be run with cwd of the package. We want `index.d.ts` but not `submodule/index.d.ts` to match.
+    if (fileName === "index.d.ts") {
+        return true;
+    }
+    if (path_1.default.basename(fileName) !== "index.d.ts") {
+        return false;
+    }
+    let parent = path_1.default.dirname(fileName);
+    // May be a directory for an older version, e.g. `v0`.
+    // Note a types redirect `foo/ts3.1` should not have its own header.
+    if (allowNested && /^v(0\.)?\d+$/.test(path_1.default.basename(parent))) {
+        parent = path_1.default.dirname(parent);
+    }
+    // Allow "types/foo/index.d.ts", not "types/foo/utils/index.d.ts"
+    return path_1.default.basename(path_1.default.dirname(parent)) === "types";
+}
+exports.isMainFile = isMainFile;
 //# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/docs/rules/npm-naming.md

@@ -0,0 +1,137 @@
+# npm-naming
+
+(This rule is specific to DefinitelyTyped.)
+
+## Name checks
+In 'name-only' mode, checks that the name of the type package matches a source package on npm.
+
+---
+
+**Bad**:
+
+```ts
+// Type definitions for browser-only-package 1.2
+```
+
+* If the package is really browser-only, you have to mark it with "non-npm package".
+* If the package actually has a matching npm package, you must use that name.
+
+**Good**:
+
+```ts
+// Type definitions for non-npm package browser-only-package 1.2
+```
+
+---
+
+**Bad**:
+
+```ts
+// Type definitions for some-package 101.1
+```
+
+* The version number in the header must actually exist on npm for the source package.
+
+**Good**:
+
+```ts
+// Type definitions for some-package 10.1
+```
+
+## Code checks
+
+In 'code' mode, in addition to the name checks, this rule also checks that the source JavaScript code matches the declaration file for npm packages.
+
+---
+
+**Bad**:
+
+`foo/index.d.ts`:
+
+```ts
+declare function f(): void;
+export default f;
+```
+
+`foo/index.js`:
+
+```js
+module.exports = function () {
+};
+```
+
+* A CommonJs module.exports assignment is not really an export default, and the d.ts should use the [`export =`](https://www.typescriptlang.org/docs/handbook/modules.html#export--and-import--require) syntax.
+* `export default` can only be used to export a CommonJs `module.exports =` when you have `esModuleInterop` turned on, which not everybody does.
+
+**Good**:
+
+`foo/index.d.ts`:
+
+```ts
+declare function f(): void;
+export = f;
+```
+
+---
+
+**Bad**:
+
+`foo/index.d.ts`:
+
+```ts
+export class C {}
+```
+
+`foo/index.js`:
+
+```js
+module.exports = class C {}
+```
+
+* The CommonJs module is a class, which means it can be constructed, like this:
+```js
+var C = require('foo');
+var x = new C();
+```
+However, the way `class C` is exported in the d.ts file (using an export declaration) means it can only be used like this:
+```ts
+var foo = require('foo');
+var x = new foo.C(); 
+```
+
+* The d.ts should use [`export =`](https://www.typescriptlang.org/docs/handbook/modules.html#export--and-import--require)
+syntax to match the CommonJs module behavior.
+
+**Good**:
+
+`foo/index.d.ts`:
+
+```ts
+declare class C {}
+export = C;
+```
+
+* If you need to use `export =` syntax as in the example above, and the source JavaScript also exports some properties,
+you might need to use [*declaration merging*](https://www.typescriptlang.org/docs/handbook/declaration-merging.html#merging-namespaces-with-classes-functions-and-enums) in your d.ts. Example:
+
+**JavaScript**:
+
+`foo/index.js`:
+
+```js
+function foo() {};
+foo.bar = "Exported property";
+module.exports = foo; // module.exports is a function, but it also has a property called `bar`
+```
+
+**Declaration**:
+
+`foo/index.d.ts`:
+
+```ts
+declare function foo(): void;
+declare namespace foo {
+    var bar: string;
+}
+export = foo;
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@definitelytyped/eslint-plugin",
-  "version": "0.0.197",
+  "version": "0.0.198",
   "description": "ESLint rules for DefinitelyTyped",
   "main": "./dist/index.js",
   "publishConfig": {
@@ -20,6 +20,7 @@
   "dependencies": {
     "@typescript-eslint/types": "^6.11.0",
     "@typescript-eslint/utils": "^6.11.0",
+    "@definitelytyped/dts-critic": "0.0.192",
     "@definitelytyped/utils": "0.0.188"
   },
   "peerDependencies": {
@@ -31,6 +32,7 @@
   },
   "devDependencies": {
     "@definitelytyped/eslint-plugin": "link:./",
+    "@typescript-eslint/rule-tester": "^6.11.0",
     "@types/eslint": "^8.44.7",
     "glob": "^10.3.10",
     "jest-file-snapshot": "^0.5.0",

package/src/configs/all.ts

@@ -135,7 +135,13 @@ export const all: Linter.BaseConfig = {
         warnOnUnsupportedTypeScriptVersion: false,
       },
       rules: {
-        ...Object.fromEntries(Object.keys(rules).map((name) => [`@definitelytyped/${name}`, "error"])),
+        ...Object.fromEntries(
+          Object.keys(rules)
+            // npm-naming is only enabled within dtslint.
+            // Leave it out of the preset so editors / he tests don't hit the network.
+            .filter((name) => name !== "npm-naming")
+            .map((name) => [`@definitelytyped/${name}`, "error"]),
+        ),
         "unicode-bom": ["error", "never"],
         "@typescript-eslint/ban-ts-comment": [
           "error",

package/src/rules/index.ts

@@ -16,6 +16,7 @@ import strictExportDeclareModifiers = require("./strict-export-declare-modifiers
 import noSingleDeclareModule = require("./no-single-declare-module");
 import noOldDTHeader = require("./no-old-dt-header");
 import noImportOfDevDependencies = require("./no-import-of-dev-dependencies");
+import npmNaming = require("./npm-naming");
 import expect = require("./expect");
 
 export const rules = {
@@ -37,5 +38,6 @@ export const rules = {
   "no-single-declare-module": noSingleDeclareModule,
   "no-old-dt-header": noOldDTHeader,
   "no-import-of-dev-dependencies": noImportOfDevDependencies,
+  "npm-naming": npmNaming,
   expect,
 };

package/src/rules/npm-naming/types.ts

@@ -0,0 +1,14 @@
+import { ExportErrorKind, Mode } from "@definitelytyped/dts-critic";
+
+export type CodeRawOptionError = [ExportErrorKind, boolean];
+
+export interface CodeRawOptions {
+  mode: Mode.Code;
+  errors: CodeRawOptionError[];
+}
+
+export interface NameOnlyRawOptions {
+  mode: Mode.NameOnly;
+}
+
+export type NpmNamingOptions = CodeRawOptions | NameOnlyRawOptions;