dtsgenerator 3.19.2 → 4.0.0

package/docs/dependency-modernization.md

@@ -0,0 +1,189 @@
+# Dependency modernization
+
+## Scope and responsibilities
+
+Update `horiuchi/dtsgenerator` and the six repositories under the `dtsgenerator`
+organization: `eslint-config`, `do-nothing`, `replace-namespace`, `single-quote`,
+`decorate-typename`, and `create`, including the latter's generated templates.
+
+Astra specifies the changes, coordinates implementation, reviews the resulting
+diffs, and verifies integration. Sol and Luna implement the changes.
+
+## Compatibility requirements
+
+- Support Node.js 22 and 24. The common engine range is
+  `^22.22.2 || >=24.15.0`, accommodating the latest package-name validator and
+  development tools. CI tests both supported LTS lines.
+- Preserve generated declarations byte for byte, including whitespace, comments,
+  ordering, quoting, and namespace transformations. Existing snapshots must not
+  be regenerated to hide dependency-induced differences.
+- Preserve CLI options, stdin/file/URL inputs, help output, exit behavior,
+  configuration precedence, and public CommonJS entry points.
+- Preserve plugin pre/post-processing contracts and the public `ts` re-export.
+- Retain centralized lint rules in `@dtsgenerator/eslint-config`; consumer files
+  contain only project-specific configuration and exceptions.
+- Preserve existing unrelated working-tree changes.
+
+## Dependency selection
+
+Use current stable versions compatible with the above contracts, updating the
+lockfiles as well as manifest ranges. Registry metadata was checked on
+2026-09-08. Do not use `--force` or `--legacy-peer-deps` to bypass incompatibility.
+
+TypeScript 7.0.2 is the current latest release, but does not provide the Compiler
+API required by this library and its plugins. Use the current JavaScript API
+release, `typescript@^6.0.3`, consistently across the ecosystem. The published
+`@typescript/typescript6` compatibility wrapper is unnecessary while the regular
+6.x package remains available. Keep `@types/node` on the latest 22.x release to
+avoid accidentally relying on APIs missing from the lower supported runtime.
+
+Keep the runtime YAML parser on `js-yaml@^4.3.2`, the current compatible 4.x
+release. Version 5.4.1 changes the default schema: merge keys stop expanding and
+timestamps stop becoming Dates (and therefore ISO strings after the existing
+deep-copy step). Its YAML 1.1 schema is not a drop-in replacement either: scalar
+syntax, sets, and complex mapping keys differ. Reimplementing the old parser's
+semantics would exceed this behavior-preserving update. Regression tests cover
+the observed merge and timestamp cases. A 5.x parser used internally by updated
+development tools does not change this library's runtime parser selection.
+
+The shared ESLint package migrates to a CommonJS-exported flat-config array.
+Consumers spread that array and append their overrides. Parser project discovery
+must work from each consumer's tsconfig. Retired rules are replaced by equivalent
+rules or explicit compatibility settings; dependency updates must not cause
+unrelated semantic refactors. New `lint`/format checks are separated from commands
+that intentionally fix files, so verification cannot rewrite source code.
+
+## Implementation sequence
+
+1. Capture the existing build/test results in isolated copies. Distinguish
+   installation or external-service failures from update regressions.
+2. Modernize and test the shared ESLint package using actual TypeScript fixtures.
+3. Update the main package and four plugins, including CI, release workflows,
+   Husky invocation, compiler configuration, and necessary compatibility edits.
+4. Update `create` and its templates; generate a fresh project and verify the
+   generated package, lint, build, tests, and hooks.
+5. Test both published dependency contracts and the locally packed updated
+   packages together before reflecting reviewed changes into the source repos.
+
+## Acceptance checks
+
+- Clean installation from the intended dependency graph; no invalid peers.
+- Build/type checks, lint checks, and existing test/coverage commands on Node.js
+  22 and 24, with exact pass/fail/skip counts recorded.
+- Existing generated-output snapshots remain unchanged.
+- Focused tests for actual dependency migration risks, particularly CLI parsing,
+  YAML semantics, file matching, URL handling, and plugin transformations.
+- Pack/install smoke tests load the CommonJS API and execute the CLI.
+- All four updated plugins run against the updated main package, not merely the
+  previously published package accidentally resolved from npm.
+- A freshly generated plugin can install, lint, build, and test.
+- CI uses the lockfile reproducibly via `npm ci`, with no subsequent unpinned
+  global npm update or redundant `npm install`.
+
+## Release boundary
+
+No tags are pushed as part of this change. `eslint-config` targeted 1.0.0
+because its configuration interface changes. `do-nothing` originally targeted
+3.0.0: its published 2.6.0 package requires exactly
+`dtsgenerator@3.19.0`, while the local repository already declares 3.19.2. The
+published peer constraint conflicts with the other test plugins and prevents a
+clean baseline installation. The corrected contract was published as 3.0.1
+rather than overriding an incompatible peer or reusing published metadata.
+Other package version fields remain unchanged pending a coordinated release;
+dropping old Node.js support must be called out when selecting release versions.
+
+Consumers' normal dependency ranges target the new shared configuration release.
+Before that release is published, integration checks must install its locally
+packed artifact in a temporary validation environment. Do not commit temporary
+absolute paths, localhost registry addresses, or pretend that an unpublished
+artifact was downloaded from the public registry. The main package also needs the
+new `do-nothing` artifact. The release notes must identify
+any installation prerequisite and the exact validation method used.
+
+After publishing each prerequisite package, refresh every consumer lockfile entry
+for that exact package from the artifact actually served by the public registry.
+Confirm that its version, dependency and peer metadata match the package being
+released, and that its `resolved` URL and `integrity` match the downloaded artifact
+and published `dist` metadata. Then run `npm ci` from a fresh cache in an isolated
+copy. A locally packed artifact
+may be used for pre-release integration testing, but its integrity must not be
+copied into a registry URL entry, and preloading it into an npm cache does not
+count as a public-registry installation check. As of 2026-09-18,
+`@dtsgenerator/eslint-config@1.0.0` and `@dtsgenerator/do-nothing@3.0.1` are
+published, and the consumer lockfiles have been refreshed from the public
+registry artifacts. The main lockfile entry for `do-nothing` records the
+published tarball URL and integrity.
+
+The main repository's test-plugin peers also cause npm to install the published
+`dtsgenerator@3.19.2` as a development dependency, with its older transitive
+dependencies (including TypeScript 5). This is distinct from the updated main
+package's runtime graph. Standard repository tests therefore do not alone prove
+that plugins use the updated main package or its TypeScript instance. A separate
+consumer installs the locally packed updated main and all four updated plugins,
+then runs their actual snapshot suites against that single installed main.
+Future coordinated version bumps must update these peer/development ranges
+together; do not remove this distinction by masking peer conflicts.
+
+## Baseline evidence
+
+The untouched working-tree source was built with the existing installed
+dependencies in an isolated directory. Node.js 22.23.2 and 24.20.0 each produced
+186 passing tests and one failing test. All 26 declaration-generation snapshots
+passed. The failing assertion hard-codes older plugin version strings in the
+configuration information output; it must be updated to verify the same format
+using the installed package metadata.
+
+Two setup limitations were isolated: the original lockfile cannot be cleanly
+installed due to the published `do-nothing` peer conflict described above, and
+plugins need the built main package resolvable from their module search path.
+Baseline verification used the existing dependencies and an isolated `NODE_PATH`
+mapping to the built baseline package. Network access was enabled for the existing
+external JSON Schema references. These results do not claim a successful baseline
+`npm ci`.
+
+## Verification results
+
+Verified with Node.js 22.23.2 and 24.20.0:
+
+| Package / scenario | Result on each runtime |
+| --- | --- |
+| Main package | Build, lint, format, 189 tests, coverage report pass; 93.21% line coverage |
+| Shared ESLint config | Configuration inspection and real TypeScript fixtures pass |
+| `do-nothing` | Build, lint, format, 4 tests and coverage pass |
+| `replace-namespace` | Build, lint, format, 3 tests and coverage pass |
+| `single-quote` | Build, lint, format, 1 test and coverage pass |
+| `decorate-typename` | Build, lint, format, 2 tests and coverage pass |
+| `create` CLI | 7 tests pass, including help, argument errors, naming and existing directories |
+| Freshly generated plugin | Install, format, lint, build and 4 tests pass; 100% coverage |
+
+All 40 pre-existing expected fixture files across the seven repositories are
+byte-identical. All 19 public declaration files emitted by the main package are
+also byte-identical to the baseline. Additional comparisons confirmed identical
+declarations and AST JSON for object, array and union schemas, and identical YAML
+parsing for merge keys, timestamps, scalar values, sets and complex keys.
+
+The generated project's actual Git configuration points `core.hooksPath` to
+`.husky/_`. Test-only npm wrappers supply local package artifacts during generated
+project integration; the production CLI has no new environment-variable switches
+for skipping installation or overriding its dependency specifications.
+
+Before the prerequisite releases, integration was checked using ordinary manifest
+ranges and registry URLs in the lockfiles, with the exact unpublished artifacts
+first added to an isolated npm cache. `npm ls --all` checked the resulting
+dependency graph. This was a pre-release graph check, not a successful
+public-registry-only installation. For the main package, npm regenerated the final
+lockfile after changing local artifact specs back to normal ranges, ensuring the
+published main package required by test-plugin peers and its transitive
+dependencies are recorded as well.
+
+These checks did not mean that a fresh public-registry-only install was possible
+before the prerequisite packages were published. After each publication, the
+consumer lockfiles and fresh-cache `npm ci` result must be verified again against
+the public registry. GitHub Actions workflows were updated but had not been
+executed on GitHub as part of the original local verification.
+
+Sources: [TypeScript 7 announcement](https://devblogs.microsoft.com/typescript/announcing-typescript-7-0/),
+[ESLint 10 migration](https://eslint.org/docs/latest/use/migrate-to-10.0.0),
+[js-yaml 5 migration](https://github.com/nodeca/js-yaml/blob/master/docs/migrate_v4_to_v5.md),
+[Node.js releases](https://nodejs.org/en/about/previous-releases), and the npm
+registry metadata for each selected version.

package/docs/npm-trusted-publishing.md

@@ -0,0 +1,60 @@
+# npm trusted publishing への移行
+
+リリースworkflowは、npmの長期トークンを使う方式からGitHub ActionsのOIDCを使うtrusted publishingへ移行する。GitHub Actions側に`NPM_TOKEN`などの新しいsecretを追加する必要はない。Node.js 24系に同梱されるnpm 11.5.1以降を使用し、`id-token: write`権限でnpmへ短時間だけ有効な認証情報を要求する。
+
+## npmでの設定
+
+各パッケージのnpmページで `Settings` → `Trusted Publisher` を開き、publisherとして `GitHub Actions` を選択する。次の値を登録する。
+
+| npmパッケージ | GitHub owner/repository | Workflow filename | Environment |
+| --- | --- | --- | --- |
+| `@dtsgenerator/eslint-config` | `dtsgenerator/eslint-config` | `release.yml` | 空欄 |
+| `@dtsgenerator/do-nothing` | `dtsgenerator/do-nothing` | `workflow-release.yaml` | 空欄 |
+| `@dtsgenerator/replace-namespace` | `dtsgenerator/replace-namespace` | `workflow-release.yaml` | 空欄 |
+| `@dtsgenerator/single-quote` | `dtsgenerator/single-quote` | `workflow-release.yaml` | 空欄 |
+| `@dtsgenerator/decorate-typename` | `dtsgenerator/decorate-typename` | `workflow-release.yaml` | 空欄 |
+| `dtsgenerator` | `horiuchi/dtsgenerator` | `workflow-release.yaml` | 空欄 |
+| `@dtsgenerator/create` | `dtsgenerator/create` | なし（手動リリース） | 対象外 |
+
+`create`が生成したプラグインでは、生成先の実際のGitHub owner/repositoryと`workflow-release.yaml`を登録し、Environmentは空欄にする。trusted publisherを登録できるのはnpmレジストリにすでに存在するパッケージだけなので、新規パッケージは最初にnpmへログインし、buildとtestを確認してから`npm publish --ignore-scripts`で一度だけ手動公開する。
+
+npmのtrusted publisher設定にある `Allow direct npm publish` を明示的に有効にする。新規設定ではstage publishが既定のため、この設定が無効なままでは現在のworkflowにある`npm publish`を実行できない。
+
+## 公開順序
+
+1. `@dtsgenerator/eslint-config`
+2. `@dtsgenerator/do-nothing`
+3. `@dtsgenerator/replace-namespace`、`@dtsgenerator/single-quote`、`@dtsgenerator/decorate-typename`、`dtsgenerator`
+4. `@dtsgenerator/create`（必要な場合は手動公開）
+
+`@dtsgenerator/eslint-config@1.0.0`と`@dtsgenerator/do-nothing@3.0.1`は
+2026-09-18時点で公開済みであり、両方のconsumer lockfileを公開registryの
+artifactから更新済みである。`dtsgenerator`を公開する前提パッケージの公開と
+lockfile更新は完了している。
+
+## 公開後のlockfile更新
+
+前提パッケージを公開するたびに、そのパッケージを参照するすべての
+`package-lock.json`を公開registryの実体に合わせて更新する。registryの
+version、dependencies、peerDependenciesが公開対象と一致することを確認する。
+さらに`dist.tarball`を取得して実体のhashを検証し、lockfileの`resolved`と
+`integrity`がそのartifactおよび`dist` metadataと一致することを確認する。
+その後、作業ツリーとは別のコピーと空のnpm cacheを使って`npm ci`を実行する。
+
+公開前の結合確認にローカルでpackしたartifactを使用しても、そのintegrityを
+registry URLのlock entryへ転記しない。ローカルartifactをcacheへ事前投入した
+検証は、公開registryだけを使ったinstall確認として扱わない。main lockfileの
+`@dtsgenerator/do-nothing` entryは、公開された3.0.1のtarball URLとintegrityに
+更新済みである。
+
+## workflowを実行する前の注意
+
+変更したworkflowを含むコミットを先にGitHubへpushする。失敗した古いrunを再実行しても、そのrunが参照していた古いYAMLが使われるためOIDCへの移行確認にはならない。タグで起動するworkflowでは、タグが移行済みコミットを指していることを確認してからpushする。
+
+ローカルで確認できるのはYAMLの構文と設定内容までである。npm UIでtrusted publisherを登録した後、GitHub Actionsから実際に公開し、OIDC認証が成功することを確認する。
+
+参考資料:
+
+- [npm trusted publishing](https://docs.npmjs.com/trusted-publishers/)
+- [npm trust](https://docs.npmjs.com/cli/v11/commands/npm-trust/)
+- [actions/setup-node advanced usage](https://github.com/actions/setup-node/blob/main/docs/advanced-usage.md)

package/eslint.config.cjs

@@ -0,0 +1,24 @@
+const shared = require('@dtsgenerator/eslint-config');
+
+module.exports = [
+    ...shared,
+    { ignores: ['test/snapshots/**'] },
+    { rules: { '@typescript-eslint/no-explicit-any': 'off' } },
+    {
+        files: ['**/*_test.ts'],
+        rules: {
+            '@typescript-eslint/ban-ts-comment': 'off',
+            '@typescript-eslint/no-empty-object-type': 'off',
+            '@typescript-eslint/no-explicit-any': 'off',
+            '@typescript-eslint/no-floating-promises': 'off',
+            '@typescript-eslint/no-implied-eval': 'off',
+            '@typescript-eslint/no-misused-promises': 'off',
+            '@typescript-eslint/no-unsafe-assignment': 'off',
+            '@typescript-eslint/no-unsafe-call': 'off',
+            '@typescript-eslint/no-unsafe-member-access': 'off',
+            '@typescript-eslint/no-unsafe-return': 'off',
+            '@typescript-eslint/no-require-imports': 'off',
+            '@typescript-eslint/unbound-method': 'off',
+        },
+    },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dtsgenerator",
-    "version": "3.19.2",
+    "version": "4.0.0",
     "description": "TypeScript d.ts file generator for JSON Schema file",
     "bin": {
         "dtsgen": "bin/dtsgen"
@@ -11,8 +11,10 @@
         "build": "tsc -p ./tsconfig-build.json",
         "clean": "rimraf dist/ build/ {src,test}/**/*.{js,js.map} *.tsbuildinfo",
         "compile": "tsc -p .",
-        "lint": "eslint --fix --report-unused-disable-directives --ext ts src/ test/",
-        "format": "prettier --cache --write 'src/**/*.ts' 'test/*.ts' 'test/core/*.ts'",
+        "lint": "eslint --report-unused-disable-directives src/ test/",
+        "lint:fix": "npm run lint -- --fix",
+        "format": "prettier --check 'src/**/*.ts' 'test/*.ts' 'test/core/*.ts'",
+        "format:fix": "prettier --cache --write 'src/**/*.ts' 'test/*.ts' 'test/core/*.ts'",
         "precompile": "npm run lint && npm run format",
         "prepublishOnly": "npm run build",
         "pretest": "npm run compile",
@@ -20,7 +22,7 @@
         "test": "nyc npm run do-test",
         "test:update-snapshot": "UPDATE_SNAPSHOT=1 npm run test",
         "coverage": "nyc report --reporter=lcov",
-        "prepare": "husky install"
+        "prepare": "husky"
     },
     "directories": {
         "test": "test/"
@@ -41,38 +43,37 @@
         "url": "https://github.com/horiuchi/dtsgenerator/issues"
     },
     "engines": {
-        "node": ">= 18.0"
+        "node": "^22.22.2 || >=24.15.0"
     },
     "dependencies": {
-        "commander": "^12.1.0",
-        "cross-fetch": "^4.0.0",
-        "debug": "^4.3.5",
-        "glob": "^10.4.1",
-        "http-proxy-agent": "^7.0.2",
-        "https-proxy-agent": "^7.0.4",
-        "js-yaml": "^4.1.0",
-        "tslib": "^2.6.3",
-        "typescript": "^5.4.5"
+        "commander": "^15.0.0",
+        "cross-fetch": "^4.1.0",
+        "debug": "^4.4.3",
+        "glob": "^13.0.6",
+        "http-proxy-agent": "^9.1.0",
+        "https-proxy-agent": "^9.1.0",
+        "js-yaml": "^4.3.2",
+        "tslib": "^2.8.1",
+        "typescript": "^6.0.3"
     },
     "devDependencies": {
-        "@dtsgenerator/do-nothing": "^2.6.0",
-        "@dtsgenerator/eslint-config": "^0.7.1",
+        "@dtsgenerator/do-nothing": "^3.0.1",
+        "@dtsgenerator/eslint-config": "^1.0.0",
         "@dtsgenerator/replace-namespace": "^1.6.0",
         "@dtsgenerator/single-quote": "^1.7.0",
         "@istanbuljs/nyc-config-typescript": "^1.0.2",
-        "@types/debug": "^4.1.12",
-        "@types/glob": "^8.1.0",
+        "@types/debug": "^4.1.13",
         "@types/js-yaml": "^4.0.9",
-        "@types/mocha": "^10.0.6",
-        "@types/node": "^18.19.34",
-        "cross-env": "^7.0.3",
-        "eslint": "^8.56.0",
-        "husky": "^9.0.11",
-        "lint-staged": "^15.2.5",
-        "mocha": "^10.4.0",
-        "nyc": "^17.0.0",
-        "prettier": "^3.3.1",
-        "rimraf": "^5.0.7",
+        "@types/mocha": "^10.0.10",
+        "@types/node": "^22.20.1",
+        "cross-env": "^10.1.0",
+        "eslint": "^10.10.0",
+        "husky": "^9.1.7",
+        "lint-staged": "^17.5.0",
+        "mocha": "^12.0.0",
+        "nyc": "^18.0.0",
+        "prettier": "^3.9.6",
+        "rimraf": "^6.1.3",
         "source-map-support": "^0.5.21",
         "ts-node": "^10.9.2"
     },

package/src/commandOptions.ts

@@ -40,7 +40,7 @@ function parse(options: CommandOptions, argv: string[]): commander.Command {
         return memo;
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-unsafe-assignment
     const pkg: { name: string; version: string } = require('../package.json');
 
     // <hoge> is required, [hoge] is optional
@@ -66,6 +66,7 @@ function parse(options: CommandOptions, argv: string[]): commander.Command {
             'for developer mode. output loaded config and plugin details only.',
         )
         .option('--output-ast', 'output TypeScript AST instead of d.ts file.')
+        .allowExcessArguments(true)
         .addHelpText(
             'afterAll',
             `

package/src/core/dtsGenerator.ts

@@ -263,12 +263,10 @@ export default class DtsGenerator {
     ): ts.DeclarationStatement {
         const content = schema.content;
         if (
-            /* eslint-disable @typescript-eslint/prefer-nullish-coalescing */
             content.$ref ||
             content.oneOf ||
             content.anyOf ||
             content.enum ||
-            /* eslint-enable @typescript-eslint/prefer-nullish-coalescing */
             'const' in content ||
             content.type !== 'object'
         ) {

package/src/core/jsonSchema.ts

@@ -322,8 +322,7 @@ export function searchAllSubSchema(
         ) => setSubIdToAnyObject(setSubIdToResponseV2, responses, keys);
         function setSubIdToResponseV2(
             response:
-                | OpenApisV2.SchemaJson.Definitions.ResponseValue
-                | undefined,
+                OpenApisV2.SchemaJson.Definitions.ResponseValue | undefined,
             keys: string[],
         ): void {
             if (response == null) {
@@ -331,10 +330,10 @@ export function searchAllSubSchema(
             }
             if ('schema' in response) {
                 const s = response.schema;
-                if (s != null && s.type === 'file') {
+                if (s?.type === 'file') {
                     return;
                 }
-                setSubId(s as JsonSchemaObject, keys);
+                setSubId(s, keys);
             }
         }
         function setSubIdToOperationV2(

package/src/core/jsonSchemaDraft04.ts

@@ -36,8 +36,7 @@ export namespace JsonSchemaDraft04 {
         dependencies?: Record<string, Schema | Schema.Definitions.StringArray>;
         enum?: any[];
         type?:
-            | Schema.Definitions.SimpleTypes
-            | Schema.Definitions.SimpleTypes[];
+            Schema.Definitions.SimpleTypes | Schema.Definitions.SimpleTypes[];
         format?: string;
         allOf?: Schema.Definitions.SchemaArray;
         anyOf?: Schema.Definitions.SchemaArray;
@@ -80,8 +79,7 @@ export namespace JsonSchemaDraft04 {
             export type Required = Definitions.StringArray;
             export type Title = string;
             export type Type =
-                | Definitions.SimpleTypes
-                | Definitions.SimpleTypes[];
+                Definitions.SimpleTypes | Definitions.SimpleTypes[];
             export type UniqueItems = boolean;
         }
     }

package/src/core/jsonSchemaDraft07.ts

@@ -38,8 +38,7 @@ export namespace JsonSchemaDraft07 {
         const?: any;
         enum?: any[];
         type?:
-            | Schema.Definitions.SimpleTypes
-            | Schema.Definitions.SimpleTypes[];
+            Schema.Definitions.SimpleTypes | Schema.Definitions.SimpleTypes[];
         format?: string;
         contentMediaType?: string;
         contentEncoding?: string;

package/src/core/openApiV2.ts

@@ -70,11 +70,7 @@ export namespace OpenApisV2 {
             }
             export type CollectionFormat = 'csv' | 'ssv' | 'tsv' | 'pipes';
             export type CollectionFormatWithMulti =
-                | 'csv'
-                | 'ssv'
-                | 'tsv'
-                | 'pipes'
-                | 'multi';
+                'csv' | 'ssv' | 'tsv' | 'pipes' | 'multi';
             /**
              * Contact information for the owners of the API.
              */
@@ -403,7 +399,7 @@ export namespace OpenApisV2 {
              */
             export type Paths = Record<string, PathItem>;
             export type Pattern =
-                JsonSchemaDraft04.Schema.Properties.Pattern /* regex */;
+                JsonSchemaDraft04.Schema.Properties.Pattern; /* regex */
             export interface PrimitivesItems {
                 type?: 'string' | 'number' | 'integer' | 'boolean' | 'array';
                 format?: string;
@@ -464,8 +460,9 @@ export namespace OpenApisV2 {
             }
             export interface Response {
                 description: string;
-                schema?: /* A deterministic version of a JSON Schema object. */
-                | Schema
+                schema?:
+                    /* A deterministic version of a JSON Schema object. */
+                    | Schema
                     | /* A deterministic version of a JSON Schema object. */ FileSchema;
                 headers?: Headers;
                 examples?: Examples;
@@ -503,11 +500,13 @@ export namespace OpenApisV2 {
                 minProperties?: JsonSchemaDraft04.Schema.Definitions.PositiveIntegerDefault0;
                 required?: JsonSchemaDraft04.Schema.Definitions.StringArray;
                 enum?: JsonSchemaDraft04.Schema.Properties.Enum;
-                additionalProperties?: /* A deterministic version of a JSON Schema object. */
-                Schema | boolean;
+                additionalProperties?:
+                    /* A deterministic version of a JSON Schema object. */
+                    Schema | boolean;
                 type?: JsonSchemaDraft04.Schema.Properties.Type;
-                items?: /* A deterministic version of a JSON Schema object. */
-                | Schema
+                items?:
+                    /* A deterministic version of a JSON Schema object. */
+                    | Schema
                     | [
                           /* A deterministic version of a JSON Schema object. */ Schema,
                           .../* A deterministic version of a JSON Schema object. */ Schema[],

package/src/core/openApiV3.ts

@@ -1,4 +1,4 @@
-/* eslint-disable @typescript-eslint/no-empty-interface */
+/* eslint-disable @typescript-eslint/no-empty-object-type */
 
 /* eslint-disable @typescript-eslint/no-namespace */
 import { JsonSchemaDraft07 } from './jsonSchemaDraft07';
@@ -272,8 +272,7 @@ export namespace OpenApisV3 {
                 ResponseOrReference
             >;
             export type SchemaOrReference =
-                | JsonSchemaDraft07.SchemaObject
-                | Reference;
+                JsonSchemaDraft07.SchemaObject | Reference;
             export type SchemasOrReferences = Record<string, SchemaOrReference>;
             /**
              * Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.  Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.  When a list of Security Requirement Objects is defined on the Open API object or Operation Object, only one of Security Requirement Objects in the list needs to be satisfied to authorize the request.
@@ -318,11 +317,7 @@ export namespace OpenApisV3 {
              * Any property starting with x- is valid.
              */
             export type SpecificationExtension =
-                | null
-                | number
-                | boolean
-                | string
-                | any[];
+                null | number | boolean | string | any[];
             export type Strings = Record<string, string>;
             /**
              * Adds metadata to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

package/src/core/type.ts

@@ -13,20 +13,16 @@ import SchemaId from './schemaId';
 
 // export `ts` for using the same version of TypeScript in all plugins.
 
+// eslint-disable-next-line @typescript-eslint/no-require-imports
 export import ts = require('typescript');
 
 // Schema types
 
 export type JsonSchema = JsonSchemaDraft04.Schema | JsonSchemaDraft07.Schema;
 export type JsonSchemaObject =
-    | JsonSchemaDraft04.Schema
-    | JsonSchemaDraft07.SchemaObject;
+    JsonSchemaDraft04.Schema | JsonSchemaDraft07.SchemaObject;
 export type SchemaType =
-    | 'Draft04'
-    | 'Draft07'
-    | '2019-09'
-    | '2020-12'
-    | 'Latest';
+    'Draft04' | 'Draft07' | '2019-09' | '2020-12' | 'Latest';
 export function isJsonSchemaDraft04(
     _content: JsonSchemaObject,
     type: SchemaType,

package/src/core/utils.ts

@@ -80,6 +80,7 @@ export function checkValidMIMEType(mime: string): boolean {
 
 export function mergeSchema(a: any, b: any): boolean {
     if ('$ref' in a || '$ref' in b) {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
         a.$ref = b.$ref || a.$ref;
         return false;
     }

package/src/utils.ts

@@ -16,6 +16,8 @@ export function readStream(
         let data = '';
         stream.on('data', (chunk) => (data += chunk));
         stream.on('end', () => resolve(data));
+        // Preserve the stream's original error object for callers.
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
         stream.on('error', (error) => reject(error));
     });
 }
@@ -88,22 +90,20 @@ export function readConfig(options: CommandOptions): PartialConfig {
         }
     }
 
-    if (pc.input == null) {
-        pc.input = {
-            files: [],
-            urls: [],
-            stdin: false,
-        };
-    }
+    pc.input ??= {
+        files: [],
+        urls: [],
+        stdin: false,
+    };
     if (options.files.length > 0) {
         pc.input.files = options.files;
-    } else if (pc.input.files == null) {
-        pc.input.files = [];
+    } else {
+        pc.input.files ??= [];
     }
     if (options.urls.length > 0) {
         pc.input.urls = options.urls;
-    } else if (pc.input.urls == null) {
-        pc.input.urls = [];
+    } else {
+        pc.input.urls ??= [];
     }
     if (options.stdin != null) {
         pc.input.stdin = options.stdin;

package/tsconfig.json

@@ -19,7 +19,6 @@
     // "removeComments": true,                /* Do not emit comments to output. */
     // "noEmit": true,                        /* Do not emit outputs. */
     "importHelpers": true,                    /* Import emit helpers from 'tslib'. */
-    "downlevelIteration": true,               /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
     // "isolatedModules": true,               /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
 
     /* Strict Type-Checking Options */
@@ -46,6 +45,7 @@
     // "rootDirs": [],                        /* List of root folders whose combined content represents the structure of the project at runtime. */
     // "typeRoots": [],                       /* List of folders to include type definitions from. */
     // "types": [],                           /* Type declaration files to be included in compilation. */
+    "types": ["node", "mocha"],
     // "allowSyntheticDefaultImports": true,  /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */
     "esModuleInterop": true,                  /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */
     // "preserveSymlinks": true,              /* Do not resolve the real path of symlinks. */

package/.eslintignore

@@ -1 +0,0 @@
-/test/snapshots