ts-openapi-codegen 2.0.0 → 2.1.0-beta.10

package/dist/common/utils/eslintFix.js

@@ -0,0 +1,184 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eslintFixBatch = eslintFixBatch;
+const Consts_1 = require("../Consts");
+const LoggerMessages_1 = require("../LoggerMessages");
+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')));
+        return mod;
+    }
+    catch {
+        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 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 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 null;
+    }
+    const report = createEmptyReport();
+    const batchSize = getBatchSize(options.batchSize);
+    try {
+        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_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>): 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,EAA2B,YAAY,EAAE,MAAM,UAAU,CAAC;AAEpF,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrG"}
+{"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

@@ -2,23 +2,59 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.format = format;
 const prettier_1 = require("prettier");
-async function format(input, parser) {
+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,
+    useTabs: false,
+    singleQuote: true,
+    quoteProps: 'as-needed',
+    trailingComma: 'all',
+    bracketSpacing: true,
+    arrowParens: 'avoid',
+    endOfLine: 'auto',
+};
+async function format(input, parser, prettierConfigPath) {
+    let options = { ...BUILTIN_PRETTIER_OPTIONS, parser: 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));
+                }
+            }
+            catch {
+                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_CONFIG_NOT_FOUND(prettierConfigPath));
+        }
+    }
     try {
-        const formatedCode = await (0, prettier_1.format)(input, {
-            parser: parser ?? 'typescript',
-            tabWidth: 4,
-            printWidth: 120,
-            useTabs: false,
-            singleQuote: true,
-            quoteProps: 'as-needed',
-            trailingComma: 'all',
-            bracketSpacing: true,
-            arrowParens: 'avoid',
-            endOfLine: 'auto',
-        });
+        const formatedCode = await (0, prettier_1.format)(input, options);
         return formatedCode;
     }
-    catch {
-        throw new Error('Could not to format the value via prettier');
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        Consts_1.APP_LOGGER.errorWithHint({
+            code: LoggerMessages_1.LOGGER_ERROR_CODES.PRETTIER_FORMAT_FAILED,
+            message: LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_FORMAT_FAILED('(generated content)', message),
+            error,
+        });
+        throw new Error(`Could not format the value via prettier: ${message}`);
     }
 }

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

@@ -0,0 +1,5 @@
+type JsonPathSegment = string | number;
+export declare const toJsonPath: (segments: JsonPathSegment[]) => string;
+export declare const parseJsonPath: (path: string) => string[];
+export {};
+//# sourceMappingURL=jsonPath.d.ts.map

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

@@ -0,0 +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,MAaxD,CAAC;AAIF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAM,EAQlD,CAAC"}

package/dist/common/utils/jsonPath.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJsonPath = exports.toJsonPath = void 0;
+const toJsonPath = (segments) => {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return segments.reduce((path, seg) => {
+        const segment = String(seg);
+        const needsBrackets = segment.includes('.') || segment.includes('/') || segment.includes('-') || segment.includes('[') || segment.includes(']');
+        if (segment === '') {
+            return path;
+        }
+        return path + (needsBrackets ? `['${segment}']` : `.${segment}`);
+    }, '$');
+};
+exports.toJsonPath = toJsonPath;
+const JSON_PATH_SEGMENT_REGEX = /\[['"]([^'"]+)['"]\]|\.([A-Za-z0-9_$]+)/g;
+const parseJsonPath = (path) => {
+    const segments = [];
+    JSON_PATH_SEGMENT_REGEX.lastIndex = 0;
+    let match;
+    while ((match = JSON_PATH_SEGMENT_REGEX.exec(path)) !== null) {
+        segments.push(match[1] ?? match[2]);
+    }
+    return segments.filter(segment => segment.length > 0);
+};
+exports.parseJsonPath = parseJsonPath;

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

@@ -1,4 +1,5 @@
 import { JSONSchema4Type, JSONSchema6Type, JSONSchema7Type } from 'json-schema';
+import { OpenApiGeneratorPlugin, SchemaTypeOverrideContext } from './plugins/GeneratorPlugin.model';
 import { OutputPaths } from './types/base/OutputPaths.model';
 import { PrefixArtifacts } from './types/base/PrefixArtifacts.model';
 import { $Root } from './types/base/Root.model';
@@ -7,6 +8,7 @@ type TContextProps = {
     output: OutputPaths;
     prefix?: PrefixArtifacts;
     sortByRequired?: boolean;
+    plugins?: OpenApiGeneratorPlugin[];
 };
 type RefsLike = {
     values: (...args: any[]) => Record<string, any>;
@@ -32,10 +34,11 @@ export declare class Context {
     private _output;
     prefix: PrefixArtifacts;
     private _sortByRequired;
+    private _plugins;
     private specRoot;
     private entryFile?;
     private virtualFiles;
-    constructor({ input, output, prefix, sortByRequired }: TContextProps);
+    constructor({ input, output, prefix, sortByRequired, plugins }: TContextProps);
     addRefs(refs: RefsLike): Context;
     values(...types: string[]): Record<string, any>;
     get($ref: string, parentSourceFile?: string): JSONSchema4Type | JSONSchema6Type | JSONSchema7Type;
@@ -45,6 +48,10 @@ export declare class Context {
     get output(): OutputPaths;
     get sortByRequired(): boolean;
     get root(): $Root | undefined;
+    /**
+     * Resolves custom type override for schema via registered plugins.
+     */
+    resolveSchemaTypeOverride(schema: Record<string, any>, context: SchemaTypeOverrideContext): string | undefined;
     private canonicalizeRef;
     private mapSourceToOutput;
     private walkSchemaForFragments;

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

@@ -1 +1 @@
-{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/core/Context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIhF,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAMhD,KAAK,aAAa,GAAG;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;IAC7E,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EAAE,CAAC;IACpC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,UAAU,WAAW;IACjB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE/C;;GAEG;AACH,qBAAa,OAAO;IAChB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAc;IACtB,MAAM,EAAE,eAAe,CAI5B;IAEF,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA6B;gBAErC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,aAAa;IAmB7D,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAKhC,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAO/C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe;IAQjG,KAAK,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAOnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO;IAQxD,QAAQ,IAAI,MAAM;IAOzB,IAAW,MAAM,gBAKhB;IAED,IAAW,cAAc,YAExB;IAED,IAAW,IAAI,IAAI,KAAK,GAAG,SAAS,CAEnC;IAED,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,sBAAsB;IA+BvB,wBAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM;IAuC/D,eAAe,IAAI,cAAc;IAIjC,mBAAmB,IAAI,MAAM,EAAE;IAgB/B,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GACpE;QACI,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,GACD,SAAS;IAef,OAAO,CAAC,qBAAqB;CAyBhC"}
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/core/Context.ts"],"names":[],"mappings":"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"}

package/dist/core/Context.js

@@ -20,10 +20,11 @@ class Context {
         type: 'T',
     };
     _sortByRequired = false;
+    _plugins = [];
     specRoot;
     entryFile;
     virtualFiles = new Map();
-    constructor({ input, output, prefix, sortByRequired }) {
+    constructor({ input, output, prefix, sortByRequired, plugins }) {
         this._output = output;
         this._refs = {};
         if ((0, isString_1.isString)(input)) {
@@ -38,6 +39,7 @@ class Context {
         if (sortByRequired !== undefined && sortByRequired !== null) {
             this._sortByRequired = sortByRequired;
         }
+        this._plugins = plugins || [];
         return this;
     }
     addRefs(refs) {
@@ -88,6 +90,18 @@ class Context {
     get root() {
         return this._root;
     }
+    /**
+     * Resolves custom type override for schema via registered plugins.
+     */
+    resolveSchemaTypeOverride(schema, context) {
+        for (const plugin of this._plugins) {
+            const override = plugin.resolveSchemaTypeOverride?.({ schema, context });
+            if (typeof override === 'string' && override.trim()) {
+                return override.trim();
+            }
+        }
+        return undefined;
+    }
     canonicalizeRef(ref, parentSourceFile) {
         const parsed = (0, parseRef_1.parseRef)(ref);
         // LOCAL_FRAGMENT → тот же файл
@@ -164,9 +178,14 @@ class Context {
         }
         // Обходим каждый файл чтобы найти $ref с фрагментами (#)
         for (const [sourceFile] of this.virtualFiles) {
-            const schema = this._refs?.get(sourceFile);
-            if (schema && typeof schema === 'object') {
-                this.walkSchemaForFragments(schema, sourceFile);
+            try {
+                const schema = this._refs?.get(sourceFile);
+                if (schema && typeof schema === 'object') {
+                    this.walkSchemaForFragments(schema, sourceFile);
+                }
+            }
+            catch {
+                // Skip unresolved entries from refs.paths().
             }
         }
     }
@@ -204,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);
             }
         }