ts-openapi-codegen 2.1.0-beta.7 → 2.1.0-beta.9

package/dist/common/utils/eslintFix.js

@@ -33,13 +33,70 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.eslintFix = eslintFix;
+exports.eslintFixBatch = eslintFixBatch;
 const Consts_1 = require("../Consts");
 const LoggerMessages_1 = require("../LoggerMessages");
-/**
- * Dynamically resolves the ESLint module from the user's project.
- * Returns null if ESLint is not installed.
- */
+const codegenTempDir_1 = require("./codegenTempDir");
+const fileSystemHelpers_1 = require("./fileSystemHelpers");
+const pathHelpers_1 = require("./pathHelpers");
+const prepareTempEslintConfig_1 = require("./prepareTempEslintConfig");
+const prepareTempTsConfig_1 = require("./prepareTempTsConfig");
+const DEFAULT_BATCH_SIZE = 50;
+/** JSON report filename (eslint-fix-report.json) written to the project root after batch ESLint fix. */
+const ESLINT_FIX_REPORT_FILE = 'eslint-fix-report.json';
+function getBatchSize(batchSize) {
+    if (batchSize !== undefined && batchSize > 0) {
+        return batchSize;
+    }
+    const fromEnv = Number(process.env.ESLINT_FIX_BATCH_SIZE);
+    if (Number.isFinite(fromEnv) && fromEnv > 0) {
+        return fromEnv;
+    }
+    return DEFAULT_BATCH_SIZE;
+}
+function* chunkArray(items, size) {
+    for (let index = 0; index < items.length; index += size) {
+        yield items.slice(index, index + size);
+    }
+}
+function createEmptyReport() {
+    return {
+        summary: {
+            totalFiles: 0,
+            errorCount: 0,
+            warningCount: 0,
+            fixableErrorCount: 0,
+            fixableWarningCount: 0,
+        },
+        files: [],
+    };
+}
+function mergeLintResults(report, results) {
+    for (const result of results) {
+        const messages = [];
+        for (const message of result.messages) {
+            messages.push({
+                filePath: result.filePath,
+                ruleId: message.ruleId ?? null,
+                line: message.line ?? 0,
+                column: message.column ?? 0,
+                message: message.message ?? '',
+                severity: message.severity ?? 1,
+            });
+        }
+        if (messages.length > 0) {
+            report.files.push({
+                filePath: result.filePath,
+                messages,
+            });
+        }
+        report.summary.totalFiles += 1;
+        report.summary.errorCount += result.errorCount ?? 0;
+        report.summary.warningCount += result.warningCount ?? 0;
+        report.summary.fixableErrorCount += result.fixableErrorCount ?? 0;
+        report.summary.fixableWarningCount += result.fixableWarningCount ?? 0;
+    }
+}
 async function tryImportESLint() {
     try {
         const mod = await Promise.resolve().then(() => __importStar(require('eslint')));
@@ -49,30 +106,79 @@ async function tryImportESLint() {
         return null;
     }
 }
+async function writeEslintFixReport(report, cwd) {
+    const reportPath = (0, pathHelpers_1.resolveHelper)(cwd, ESLINT_FIX_REPORT_FILE);
+    await fileSystemHelpers_1.fileSystemHelpers.writeFile(reportPath, `${JSON.stringify(report, null, 2)}\n`);
+    return reportPath;
+}
 /**
- * Runs ESLint --fix on the given file using the user's project ESLint config.
- * Silently skips if ESLint is not installed.
- * Logs an error and re-throws if ESLint fails during the fix.
+ * Runs ESLint --fix in memory-safe batches on an explicit file list.
+ *
+ * Creates temporary configs under .openapi-codegen/, lints in chunks, applies fixes,
+ * writes eslint-fix-report.json, then removes temp files. Does not use projectService.
+ *
+ * @param options - File paths, globs, and host project config paths.
+ * @returns Lint report, or null when there are no files or ESLint is not installed.
  */
-async function eslintFix(filePath) {
+async function eslintFixBatch(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const uniqueFiles = [...new Set(options.files.map(file => (0, pathHelpers_1.resolveHelper)(cwd, file)))].sort();
+    if (uniqueFiles.length === 0) {
+        return null;
+    }
     const eslintModule = await tryImportESLint();
     if (!eslintModule) {
         Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_NOT_INSTALLED);
-        return;
+        return null;
     }
+    const report = createEmptyReport();
+    const batchSize = getBatchSize(options.batchSize);
     try {
-        const eslint = new eslintModule.ESLint({ fix: true });
-        const results = await eslint.lintFiles([filePath]);
-        await eslintModule.ESLint.outputFixes(results);
-        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_FIX_APPLIED(filePath));
+        const tempTsconfigPath = await (0, prepareTempTsConfig_1.prepareTempTsConfig)({
+            baseTsconfigPath: options.tsconfigPath,
+            includeGlobs: options.includeGlobs,
+            cwd,
+        });
+        const tempEslintPath = await (0, prepareTempEslintConfig_1.prepareTempEslintConfig)({
+            eslintConfigPath: options.eslintConfigPath,
+            tempTsconfigPath,
+            cwd,
+        });
+        const eslint = new eslintModule.ESLint({
+            cwd,
+            fix: true,
+            overrideConfigFile: tempEslintPath,
+        });
+        for (const chunk of chunkArray(uniqueFiles, batchSize)) {
+            try {
+                const results = await eslint.lintFiles(chunk);
+                await eslintModule.ESLint.outputFixes(results);
+                mergeLintResults(report, results);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_BATCH_CHUNK_FAILED(message));
+            }
+        }
+        const reportPath = await writeEslintFixReport(report, cwd);
+        if (report.summary.errorCount > 0 || report.summary.warningCount > 0) {
+            Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_BATCH_COMPLETED_WITH_ISSUES(report.summary.errorCount, report.summary.warningCount, reportPath));
+        }
+        else {
+            Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_BATCH_COMPLETED(reportPath));
+        }
+        return report;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         Consts_1.APP_LOGGER.errorWithHint({
             code: LoggerMessages_1.LOGGER_ERROR_CODES.ESLINT_FIX_FAILED,
-            message: LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_FIX_FAILED(filePath, message),
+            message: LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_BATCH_FAILED(message),
             error,
         });
         throw error;
     }
+    finally {
+        await (0, codegenTempDir_1.cleanupCodegenTempDir)(cwd);
+    }
 }

package/dist/common/utils/format.d.ts

@@ -1,3 +1,3 @@
 import { BuiltInParserName, LiteralUnion } from 'prettier';
-export declare function format(input: string, parser?: LiteralUnion<BuiltInParserName>, useProjectConfig?: boolean): Promise<string>;
+export declare function format(input: string, parser?: LiteralUnion<BuiltInParserName>, prettierConfigPath?: string): Promise<string>;
 //# sourceMappingURL=format.d.ts.map

package/dist/common/utils/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/common/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA4B,YAAY,EAA6C,MAAM,UAAU,CAAC;AAiBhI,wBAAsB,MAAM,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,EACxC,gBAAgB,CAAC,EAAE,OAAO,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6BjB"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/common/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA4B,YAAY,EAA6C,MAAM,UAAU,CAAC;AAmBhI,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsClI"}

package/dist/common/utils/format.js

@@ -4,6 +4,8 @@ exports.format = format;
 const prettier_1 = require("prettier");
 const Consts_1 = require("../Consts");
 const LoggerMessages_1 = require("../LoggerMessages");
+const fileSystemHelpers_1 = require("./fileSystemHelpers");
+const pathHelpers_1 = require("./pathHelpers");
 const BUILTIN_PRETTIER_OPTIONS = {
     tabWidth: 4,
     printWidth: 120,
@@ -15,21 +17,31 @@ const BUILTIN_PRETTIER_OPTIONS = {
     arrowParens: 'avoid',
     endOfLine: 'auto',
 };
-async function format(input, parser, useProjectConfig) {
+async function format(input, parser, prettierConfigPath) {
     let options = { ...BUILTIN_PRETTIER_OPTIONS, parser: parser ?? 'typescript' };
-    if (useProjectConfig) {
-        try {
-            const resolved = await (0, prettier_1.resolveConfig)(process.cwd(), { useCache: false });
-            if (resolved) {
-                Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_PROJECT_CONFIG_RESOLVED(process.cwd()));
-                options = { ...resolved, parser: parser ?? resolved.parser ?? 'typescript' };
+    if (prettierConfigPath) {
+        const absoluteConfigPath = (0, pathHelpers_1.resolveHelper)(process.cwd(), prettierConfigPath);
+        const configExists = await fileSystemHelpers_1.fileSystemHelpers.exists(absoluteConfigPath);
+        if (configExists) {
+            try {
+                const resolved = await (0, prettier_1.resolveConfig)(absoluteConfigPath, { config: absoluteConfigPath, useCache: false });
+                if (resolved) {
+                    Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_CONFIG_RESOLVED(absoluteConfigPath));
+                    options = {
+                        ...resolved,
+                        parser: parser ?? resolved.parser ?? 'typescript',
+                    };
+                }
+                else {
+                    Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_CONFIG_NOT_FOUND(prettierConfigPath));
+                }
             }
-            else {
-                Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_PROJECT_CONFIG_NOT_FOUND);
+            catch {
+                Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_CONFIG_NOT_FOUND(prettierConfigPath));
             }
         }
-        catch {
-            Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_PROJECT_CONFIG_NOT_FOUND);
+        else {
+            Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_CONFIG_NOT_FOUND(prettierConfigPath));
         }
     }
     try {

package/dist/common/utils/jsonPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonPath.d.ts","sourceRoot":"","sources":["../../../src/common/utils/jsonPath.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,eAAO,MAAM,UAAU,GAAI,UAAU,eAAe,EAAE,KAAG,MAcxD,CAAC;AAIF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAM,EAQlD,CAAC"}
+{"version":3,"file":"jsonPath.d.ts","sourceRoot":"","sources":["../../../src/common/utils/jsonPath.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,eAAO,MAAM,UAAU,GAAI,UAAU,eAAe,EAAE,KAAG,MAaxD,CAAC;AAIF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAM,EAQlD,CAAC"}

package/dist/common/utils/prepareTempEslintConfig.d.ts

@@ -0,0 +1,18 @@
+/** Options for {@link prepareTempEslintConfig}. */
+export interface PrepareTempEslintConfigOptions {
+    /** Path to the host project's ESLint config file. */
+    eslintConfigPath: string;
+    /** Absolute path to the temporary tsconfig from {@link prepareTempTsConfig}. */
+    tempTsconfigPath: string;
+    /** Project root (defaults to process.cwd()). */
+    cwd?: string;
+}
+/**
+ * Writes an ESLint flat-config wrapper that imports the host config and points type-aware rules
+ * at the temporary tsconfig.
+ *
+ * @param options - Host ESLint config path and temporary tsconfig path.
+ * @returns Absolute path to .openapi-codegen/eslint.config.codegen.mjs.
+ */
+export declare function prepareTempEslintConfig(options: PrepareTempEslintConfigOptions): Promise<string>;
+//# sourceMappingURL=prepareTempEslintConfig.d.ts.map

package/dist/common/utils/prepareTempEslintConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareTempEslintConfig.d.ts","sourceRoot":"","sources":["../../../src/common/utils/prepareTempEslintConfig.ts"],"names":[],"mappings":"AAOA,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC3C,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCtG"}

package/dist/common/utils/prepareTempEslintConfig.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareTempEslintConfig = prepareTempEslintConfig;
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+const codegenTempDir_1 = require("./codegenTempDir");
+const fileSystemHelpers_1 = require("./fileSystemHelpers");
+const pathHelpers_1 = require("./pathHelpers");
+/**
+ * Writes an ESLint flat-config wrapper that imports the host config and points type-aware rules
+ * at the temporary tsconfig.
+ *
+ * @param options - Host ESLint config path and temporary tsconfig path.
+ * @returns Absolute path to .openapi-codegen/eslint.config.codegen.mjs.
+ */
+async function prepareTempEslintConfig(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await (0, codegenTempDir_1.ensureCodegenTempDir)(cwd);
+    const absoluteUserConfig = (0, pathHelpers_1.resolveHelper)(cwd, options.eslintConfigPath);
+    const userConfigUrl = (0, node_url_1.pathToFileURL)(absoluteUserConfig).href;
+    const tsconfigFileName = node_path_1.default.basename(options.tempTsconfigPath);
+    const wrapperPath = node_path_1.default.join((0, codegenTempDir_1.getCodegenTempDir)(cwd), 'eslint.config.codegen.mjs');
+    const content = `import userConfig from ${JSON.stringify(userConfigUrl)};
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const tempTsconfigPath = path.join(__dirname, ${JSON.stringify(tsconfigFileName)});
+
+function normalizeConfigs(config) {
+    if (!config) {
+        return [];
+    }
+    return Array.isArray(config) ? config : [config];
+}
+
+export default [
+    ...normalizeConfigs(userConfig),
+    {
+        files: ['**/*.{ts,tsx}'],
+        languageOptions: {
+            parserOptions: {
+                project: tempTsconfigPath,
+                tsconfigRootDir: ${JSON.stringify(cwd)},
+            },
+        },
+    },
+];
+`;
+    await fileSystemHelpers_1.fileSystemHelpers.writeFile(wrapperPath, content);
+    return wrapperPath;
+}

package/dist/common/utils/prepareTempTsConfig.d.ts

@@ -0,0 +1,23 @@
+/** Options for {@link prepareTempTsConfig}. */
+export interface PrepareTempTsConfigOptions {
+    /** Path to the host project's base tsconfig.json. */
+    baseTsconfigPath: string;
+    /**
+     * Narrow include globs for generated output only (e.g. ./generated/models/.../*.ts).
+     * Replaces the base tsconfig include; the base include is not merged.
+     */
+    includeGlobs: string[];
+    /** Project root (defaults to process.cwd()). */
+    cwd?: string;
+}
+/**
+ * Builds a temporary tsconfig for type-aware ESLint without loading the whole repository.
+ *
+ * Reads compilerOptions from the base tsconfig, then writes .openapi-codegen/tsconfig.eslint.json
+ * with a replaced include, noEmit, skipLibCheck, and incremental: false.
+ *
+ * @param options - Base tsconfig path and narrow include globs.
+ * @returns Absolute path to the written temporary tsconfig file.
+ */
+export declare function prepareTempTsConfig(options: PrepareTempTsConfigOptions): Promise<string>;
+//# sourceMappingURL=prepareTempTsConfig.d.ts.map

package/dist/common/utils/prepareTempTsConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareTempTsConfig.d.ts","sourceRoot":"","sources":["../../../src/common/utils/prepareTempTsConfig.ts"],"names":[],"mappings":"AAyEA,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACvC,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC9F"}

package/dist/common/utils/prepareTempTsConfig.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareTempTsConfig = prepareTempTsConfig;
+const node_path_1 = __importDefault(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const codegenTempDir_1 = require("./codegenTempDir");
+const fileSystemHelpers_1 = require("./fileSystemHelpers");
+const pathHelpers_1 = require("./pathHelpers");
+/** Parsed CompilerOptions may include fields that are not valid in tsconfig.json. */
+const INTERNAL_COMPILER_OPTION_KEYS = new Set(['configFilePath']);
+function isWritableCompilerOptionKey(key) {
+    return !INTERNAL_COMPILER_OPTION_KEYS.has(key);
+}
+/** Maps parsed numeric enum values back to tsconfig.json string literals. */
+function serializeEnumCompilerOption(key, value) {
+    switch (key) {
+        case 'target':
+            return typescript_1.default.ScriptTarget[value] ?? value;
+        case 'module':
+            return typescript_1.default.ModuleKind[value] ?? value;
+        case 'moduleResolution':
+            return typescript_1.default.ModuleResolutionKind[value] ?? value;
+        case 'jsx':
+            return typescript_1.default.JsxEmit[value] ?? value;
+        case 'newLine':
+            return typescript_1.default.NewLineKind[value] ?? value;
+        default:
+            return value;
+    }
+}
+/** Maps parsed CompilerOptions to a JSON-serializable tsconfig fragment. */
+function compilerOptionsToJson(options) {
+    const json = {};
+    const source = options;
+    for (const [key, value] of Object.entries(source)) {
+        if (value === undefined || !isWritableCompilerOptionKey(key)) {
+            continue;
+        }
+        if (typeof value === 'number') {
+            json[key] = serializeEnumCompilerOption(key, value);
+            continue;
+        }
+        json[key] = value;
+    }
+    return json;
+}
+/**
+ * Builds JSON-safe compilerOptions: parsed values (extends resolved) plus raw literals
+ * from the base file (preserves lib/types paths as written in tsconfig.json).
+ */
+function mergeCompilerOptionsForJson(rawCompilerOptions, parsedOptions) {
+    const json = compilerOptionsToJson(parsedOptions);
+    const rawSource = rawCompilerOptions;
+    if (rawSource) {
+        for (const [key, value] of Object.entries(rawSource)) {
+            if (value !== undefined && isWritableCompilerOptionKey(key)) {
+                json[key] = value;
+            }
+        }
+    }
+    return json;
+}
+/**
+ * Builds a temporary tsconfig for type-aware ESLint without loading the whole repository.
+ *
+ * Reads compilerOptions from the base tsconfig, then writes .openapi-codegen/tsconfig.eslint.json
+ * with a replaced include, noEmit, skipLibCheck, and incremental: false.
+ *
+ * @param options - Base tsconfig path and narrow include globs.
+ * @returns Absolute path to the written temporary tsconfig file.
+ */
+async function prepareTempTsConfig(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const absoluteBase = (0, pathHelpers_1.resolveHelper)(cwd, options.baseTsconfigPath);
+    const baseDir = node_path_1.default.dirname(absoluteBase);
+    const configFile = typescript_1.default.readConfigFile(absoluteBase, typescript_1.default.sys.readFile);
+    if (configFile.error) {
+        const message = typescript_1.default.formatDiagnostic(configFile.error, {
+            getCanonicalFileName: f => f,
+            getCurrentDirectory: () => cwd,
+            getNewLine: () => '\n',
+        });
+        throw new Error(`Failed to read tsconfig at "${absoluteBase}": ${message}`);
+    }
+    const parsedBase = typescript_1.default.parseJsonConfigFileContent(configFile.config, typescript_1.default.sys, baseDir, undefined, absoluteBase);
+    const include = options.includeGlobs.length > 0 ? options.includeGlobs.map(glob => (node_path_1.default.isAbsolute(glob) ? glob : node_path_1.default.join(cwd, glob))) : ['**/*.ts'];
+    const rawCompilerOptions = configFile.config.compilerOptions;
+    const tempConfig = {
+        compilerOptions: {
+            ...mergeCompilerOptionsForJson(rawCompilerOptions, parsedBase.options),
+            noEmit: true,
+            skipLibCheck: true,
+            incremental: false,
+        },
+        include,
+        exclude: ['node_modules', '**/node_modules/**'],
+    };
+    await (0, codegenTempDir_1.ensureCodegenTempDir)(cwd);
+    const tempPath = node_path_1.default.join((0, codegenTempDir_1.getCodegenTempDir)(cwd), 'tsconfig.eslint.json');
+    await fileSystemHelpers_1.fileSystemHelpers.writeFile(tempPath, `${JSON.stringify(tempConfig, null, 2)}\n`);
+    return tempPath;
+}

package/dist/core/Context.d.ts.map

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

package/dist/core/Context.js

@@ -223,17 +223,13 @@ class Context {
             return ref;
         // Prefer explicit parent if provided
         if (parentSourceFile) {
-            const normalizedParent = (0, path_1.isAbsolute)(parentSourceFile)
-                ? parentSourceFile
-                : (0, pathHelpers_1.resolveHelper)(this.specRoot, parentSourceFile);
+            const normalizedParent = (0, path_1.isAbsolute)(parentSourceFile) ? parentSourceFile : (0, pathHelpers_1.resolveHelper)(this.specRoot, parentSourceFile);
             return (0, normalizeRef_1.normalizeRef)(ref, normalizedParent);
         }
         // If we can fall back to entry file, normalize relative refs against it
         if (this.entryFile) {
             const parsed = (0, parseRef_1.parseRef)(ref);
-            if (parsed.type === parseRef_1.RefType.LOCAL_FRAGMENT ||
-                parsed.type === parseRef_1.RefType.EXTERNAL_FILE ||
-                parsed.type === parseRef_1.RefType.EXTERNAL_FILE_FRAGMENT) {
+            if (parsed.type === parseRef_1.RefType.LOCAL_FRAGMENT || parsed.type === parseRef_1.RefType.EXTERNAL_FILE || parsed.type === parseRef_1.RefType.EXTERNAL_FILE_FRAGMENT) {
                 return (0, normalizeRef_1.normalizeRef)(ref, this.entryFile);
             }
         }

package/dist/core/OpenApiClient.d.ts

@@ -1,9 +1,15 @@
 import { TRawOptions } from '../common/TRawOptions';
 import { WriteClient } from './WriteClient';
+/**
+ * Оркестратор генерации OpenAPI-клиента: парсинг спецификации, применение diff-отчёта и запись артефактов.
+ */
 export declare class OpenApiClient {
     private static readonly CACHE_FINGERPRINT_VERSION;
     private static readonly DEFAULT_CACHE_FILENAME;
     private _writeClient;
+    /** ESLint paths from top-level rawOptions (not per items[] entry). */
+    private eslintFixOptions;
+    /** Экземпляр WriteClient для записи сгенерированных файлов. */
     get writeClient(): WriteClient;
     private normalizeOptions;
     private addDefaultValues;
@@ -19,8 +25,17 @@ export declare class OpenApiClient {
     private getCacheKey;
     private getCacheFingerprint;
     private filesExist;
+    /**
+     * Runs batch ESLint fix after combineAndWrite / combineAndWrightSimple when both paths are set.
+     * Warns and skips when only one path is provided; always clears the WriteClient lint registry.
+     */
+    private runBatchEslintFixIfEnabled;
     private loadDiffReportIfNeeded;
     private applyDiffReportIfNeeded;
+    /**
+     * Запускает генерацию клиента по опциям CLI или конфигурации.
+     * @param rawOptions сырые опции генерации
+     */
     generate(rawOptions: TRawOptions): Promise<void>;
 }
 //# sourceMappingURL=OpenApiClient.d.ts.map

package/dist/core/OpenApiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAyBtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAiC;IAC/E,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAgFxB,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,cAAc;YAaR,mBAAmB;YASnB,2BAA2B;YA+B3B,oBAAoB;IA2DlC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,+BAA+B;YAiBzB,cAAc;IA0L5B,OAAO,CAAC,WAAW;YAaL,mBAAmB;YAiCnB,UAAU;YAUV,sBAAsB;IASpC,OAAO,CAAC,uBAAuB;IAczB,QAAQ,CAAC,UAAU,EAAE,WAAW;CAWzC"}
+{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AA2BtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAiC;IAC/E,OAAO,CAAC,YAAY,CAA4B;IAChD,sEAAsE;IACtE,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,+DAA+D;IAC/D,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAkFxB,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,cAAc;YAaR,mBAAmB;YASnB,2BAA2B;YA+B3B,oBAAoB;IA8DlC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,+BAA+B;YAiBzB,cAAc;IA0L5B,OAAO,CAAC,WAAW;YAaL,mBAAmB;YAiCnB,UAAU;IAUxB;;;OAGG;YACW,0BAA0B;YAwC1B,sBAAsB;IASpC,OAAO,CAAC,uBAAuB;IAe/B;;;OAGG;IACG,QAAQ,CAAC,UAAU,EAAE,WAAW;CAYzC"}