ts-openapi-codegen 1.0.0-beta.8 → 2.0.0-beta.0

package/dist/core/utils/__tests__/getOperationPath.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getOperationPath_1 = require("../getOperationPath");
-(0, node_test_1.describe)('getOperationPath', () => {
-    (0, node_test_1.test)('@unit: should produce correct result', () => {
+(0, node_test_1.describe)('@unit: getOperationPath', () => {
+    (0, node_test_1.test)('should produce correct result', () => {
         node_assert_1.default.strictEqual((0, getOperationPath_1.getOperationPath)('/api/v{api-version}/list/{id}/{type}'), '/api/v{api-version}/list/${id}/${type}');
         node_assert_1.default.strictEqual((0, getOperationPath_1.getOperationPath)('/api/v{api-version}/list/{id}'), '/api/v{api-version}/list/${id}');
         node_assert_1.default.strictEqual((0, getOperationPath_1.getOperationPath)('/api/v1/list/{id}'), '/api/v1/list/${id}');

package/dist/core/utils/__tests__/getOperationResponseCode.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getOperationResponseCode_1 = require("../getOperationResponseCode");
-(0, node_test_1.describe)('getOperationResponseCode', () => {
-    (0, node_test_1.test)('@unit: should produce correct result', () => {
+(0, node_test_1.describe)('@unit: getOperationResponseCode', () => {
+    (0, node_test_1.test)('should produce correct result', () => {
         node_assert_1.default.strictEqual((0, getOperationResponseCode_1.getOperationResponseCode)(''), null);
         node_assert_1.default.strictEqual((0, getOperationResponseCode_1.getOperationResponseCode)('default'), 200);
         node_assert_1.default.strictEqual((0, getOperationResponseCode_1.getOperationResponseCode)('200'), 200);

package/dist/core/utils/__tests__/getPattern.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getPattern_1 = require("../getPattern");
-(0, node_test_1.describe)('getPattern', () => {
-    (0, node_test_1.test)('@unit: should produce correct result', () => {
+(0, node_test_1.describe)('@unit: getPattern', () => {
+    (0, node_test_1.test)('should produce correct result', () => {
         node_assert_1.default.strictEqual((0, getPattern_1.getPattern)(), undefined);
         node_assert_1.default.strictEqual((0, getPattern_1.getPattern)(''), '');
         node_assert_1.default.strictEqual((0, getPattern_1.getPattern)('^[a-zA-Z]'), '^[a-zA-Z]');

package/dist/core/utils/__tests__/getRefFromSchema.test.js

@@ -9,8 +9,8 @@ const getRefFromSchema_1 = require("../getRefFromSchema");
 const ContextMock = {
     get: () => undefined,
 };
-(0, node_test_1.describe)('getRefFromSchema', () => {
-    node_test_1.test.skip('@unit: should obtain refs from all schemas', () => {
+(0, node_test_1.describe)('@unit: getRefFromSchema', () => {
+    node_test_1.test.skip('should obtain refs from all schemas', () => {
         node_test_1.mock.method(ContextMock, 'get', ($ref) => {
             if ($ref === '#/components/requestBodies/SimpleRequestBodyWithModelWithCircularReference') {
                 return {

package/dist/core/utils/__tests__/getRefs.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getRefs_1 = require("../getRefs");
-(0, node_test_1.describe)('getRefs', () => {
-    (0, node_test_1.test)('@unit: should return array of refs', () => {
+(0, node_test_1.describe)('@unit: getRefs', () => {
+    (0, node_test_1.test)('should return array of refs', () => {
         const object = {
             name: 'NAME',
             $ref: '#/first/ref',

package/dist/core/utils/__tests__/getRelativeModelPath.test.js

@@ -6,13 +6,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getRelativeModelPath_1 = require("../getRelativeModelPath");
-(0, node_test_1.describe)('getRelativeModelPath', () => {
-    (0, node_test_1.test)('@unit: hould return model relative path', () => {
+node_test_1.describe.skip('@unit: getRelativeModelPath', () => {
+    (0, node_test_1.test)('hould return model relative path', () => {
         const modelRelativePath = '../../../models/truck';
         const result = (0, getRelativeModelPath_1.getRelativeModelPath)(undefined, modelRelativePath);
         node_assert_1.default.strictEqual(result, '../../../models/truck');
     });
-    (0, node_test_1.test)('@unit: should return correct model relative path considering navigation symbols', () => {
+    (0, node_test_1.test)('should return correct model relative path considering navigation symbols', () => {
         const rootPath = '/home/generated';
         const modelRelativePath = '../../../models/truck';
         const result = (0, getRelativeModelPath_1.getRelativeModelPath)(rootPath, modelRelativePath);

package/dist/core/utils/__tests__/getServiceClassName.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getServiceClassName_1 = require("../getServiceClassName");
-(0, node_test_1.describe)('getServiceClassName', () => {
-    (0, node_test_1.test)('@unit: should produce correct result', () => {
+(0, node_test_1.describe)('@unit: getServiceClassName', () => {
+    (0, node_test_1.test)('should produce correct result', () => {
         node_assert_1.default.strictEqual((0, getServiceClassName_1.getServiceClassName)(''), '');
         node_assert_1.default.strictEqual((0, getServiceClassName_1.getServiceClassName)('FooBar'), 'FooBarService');
         node_assert_1.default.strictEqual((0, getServiceClassName_1.getServiceClassName)('Foo Bar'), 'FooBarService');

package/dist/core/utils/__tests__/getServiceNames.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getServiceNames_1 = require("../getServiceNames");
-(0, node_test_1.describe)('getServiceNames', () => {
-    (0, node_test_1.test)('@unit: should return sorted list', () => {
+(0, node_test_1.describe)('@unit: getServiceNames', () => {
+    (0, node_test_1.test)('should return sorted list', () => {
         const john = {
             name: 'John',
             originName: 'JohnService',

package/dist/core/utils/__tests__/getServiceVersion.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const getServiceVersion_1 = require("../getServiceVersion");
-(0, node_test_1.describe)('getServiceVersion', () => {
-    (0, node_test_1.test)('@unit: should produce correct result', () => {
+(0, node_test_1.describe)('@unit: getServiceVersion', () => {
+    (0, node_test_1.test)('should produce correct result', () => {
         node_assert_1.default.strictEqual((0, getServiceVersion_1.getServiceVersion)('1.0'), '1.0');
         node_assert_1.default.strictEqual((0, getServiceVersion_1.getServiceVersion)('v1.0'), '1.0');
         node_assert_1.default.strictEqual((0, getServiceVersion_1.getServiceVersion)('V1.0'), '1.0');

package/dist/core/utils/__tests__/isString.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const isString_1 = require("../isString");
-(0, node_test_1.describe)('isString', () => {
-    (0, node_test_1.test)('@unit: should produce correct result', () => {
+(0, node_test_1.describe)('@unit: isString', () => {
+    (0, node_test_1.test)('should produce correct result', () => {
         node_assert_1.default.ok((0, isString_1.isString)('foo'));
         node_assert_1.default.ok((0, isString_1.isString)('123'));
         node_assert_1.default.ok((0, isString_1.isString)('-1'));

package/dist/core/utils/__tests__/isSubdirectory.test.js

@@ -5,16 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
-const path_1 = require("path");
+const pathHelpers_1 = require("../../../common/utils/pathHelpers");
 const isSubdirectory_1 = require("../isSubdirectory");
-(0, node_test_1.describe)('isSubDirectory', () => {
-    (0, node_test_1.test)('@unit: should return correct result', () => {
-        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, path_1.resolve)('/'), (0, path_1.resolve)('/')), false);
-        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, path_1.resolve)('.'), (0, path_1.resolve)('.')), false);
-        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, path_1.resolve)('./project'), (0, path_1.resolve)('./project')), false);
-        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, path_1.resolve)('./project'), (0, path_1.resolve)('../')), false);
-        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, path_1.resolve)('./project'), (0, path_1.resolve)('../../')), false);
-        node_assert_1.default.ok((0, isSubdirectory_1.isSubDirectory)((0, path_1.resolve)('./'), (0, path_1.resolve)('./output')));
-        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, path_1.resolve)('./'), (0, path_1.resolve)('../output')), false);
+(0, node_test_1.describe)('@unit: isSubDirectory', () => {
+    node_test_1.test.skip('should return correct result', () => {
+        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, pathHelpers_1.resolveHelper)('/'), (0, pathHelpers_1.resolveHelper)('/')), false);
+        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, pathHelpers_1.resolveHelper)('.'), (0, pathHelpers_1.resolveHelper)('.')), false);
+        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, pathHelpers_1.resolveHelper)('./project'), (0, pathHelpers_1.resolveHelper)('./project')), false);
+        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, pathHelpers_1.resolveHelper)('./project'), (0, pathHelpers_1.resolveHelper)('../')), false);
+        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, pathHelpers_1.resolveHelper)('./project'), (0, pathHelpers_1.resolveHelper)('../../')), false);
+        node_assert_1.default.ok((0, isSubdirectory_1.isSubDirectory)((0, pathHelpers_1.resolveHelper)('./'), (0, pathHelpers_1.resolveHelper)('./output')));
+        node_assert_1.default.strictEqual((0, isSubdirectory_1.isSubDirectory)((0, pathHelpers_1.resolveHelper)('./'), (0, pathHelpers_1.resolveHelper)('../output')), false);
     });
 });

package/dist/core/utils/__tests__/registerHandlebarHelpers.test.js

@@ -41,8 +41,8 @@ const node_test_1 = require("node:test");
 const Handlebars = __importStar(require("handlebars/runtime"));
 const HttpClient_enum_1 = require("../../types/enums/HttpClient.enum");
 const registerHandlebarHelpers_1 = require("../registerHandlebarHelpers");
-(0, node_test_1.describe)('registerHandlebarHelpers', () => {
-    (0, node_test_1.test)('@unit: should register the helpers', () => {
+(0, node_test_1.describe)('@unit: registerHandlebarHelpers', () => {
+    (0, node_test_1.test)('should register the helpers', () => {
         (0, registerHandlebarHelpers_1.registerHandlebarHelpers)({
             httpClient: HttpClient_enum_1.HttpClient.FETCH,
             useOptions: false,

package/dist/core/utils/__tests__/registerHandlebarTemplates.test.js

@@ -40,8 +40,8 @@ const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = __importStar(require("node:test"));
 const HttpClient_enum_1 = require("../../types/enums/HttpClient.enum");
 const registerHandlebarTemplates_1 = require("../registerHandlebarTemplates");
-(0, node_test_1.describe)('registerHandlebarTemplates', () => {
-    (0, node_test_1.default)('@unit: should return correct templates', () => {
+(0, node_test_1.describe)('@unit: registerHandlebarTemplates', () => {
+    (0, node_test_1.default)('should return correct templates', () => {
         const templates = (0, registerHandlebarTemplates_1.registerHandlebarTemplates)({
             httpClient: HttpClient_enum_1.HttpClient.FETCH,
             useOptions: false,

package/dist/core/utils/__tests__/replaceString.test.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
 const replaceString_1 = require("../replaceString");
-(0, node_test_1.describe)('replaceString', () => {
-    (0, node_test_1.test)('@unit: should replace', () => {
+(0, node_test_1.describe)('@unit: replaceString', () => {
+    (0, node_test_1.test)('should replace', () => {
         node_assert_1.default.strictEqual((0, replaceString_1.replaceString)(''), '');
         node_assert_1.default.strictEqual((0, replaceString_1.replaceString)('fooBar'), 'fooBar');
         node_assert_1.default.strictEqual((0, replaceString_1.replaceString)('Foo/Bar'), 'Foo/Bar');

package/dist/core/utils/__tests__/resolveRefToImportPath.test.js

@@ -2,66 +2,375 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = require("node:assert");
 const node_test_1 = require("node:test");
+const fileSystemHelpers_1 = require("../../../common/utils/fileSystemHelpers");
+const Consts_1 = require("../../types/Consts");
 const resolveRefToImportPath_1 = require("../resolveRefToImportPath");
 // Normalization of paths for cross-platform
-const normalizePath = (p) => p.replace(/\\/g, '/');
+const normalizePath = (p) => p.replace(Consts_1.REGEX_BACKSLASH, '/');
 (0, node_test_1.describe)('@unit resolveRefToImportPath — correctly resolves links to components', () => {
     const mainSpecPath = '/Users/user/Developer/my_app/openapi/app/openapi_spec.yaml';
     const outputModelsPath = '/Users/user/Developer/openapi-codegen/generated/account/models';
-    (0, node_test_1.test)('internal link in the child file → path to the model by schema name', () => {
-        const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
-            mainSpecPath,
-            parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml#/components/schemas/AccountField',
-            refValuePath: '#/components/schemas/AccountField',
-            outputModelsPath,
-        });
-        node_assert_1.strict.equal(normalizePath(result), './spec/AccountField');
+    const originalIsDirectory = fileSystemHelpers_1.fileSystemHelpers.isDirectory;
+    const originalIsPathToFile = fileSystemHelpers_1.fileSystemHelpers.isPathToFile;
+    (0, node_test_1.beforeEach)(() => {
+        fileSystemHelpers_1.fileSystemHelpers.isDirectory = node_test_1.mock.fn(() => false);
+        fileSystemHelpers_1.fileSystemHelpers.isPathToFile = node_test_1.mock.fn(() => true);
     });
-    (0, node_test_1.test)('internal link in the main file → model in the root output', () => {
-        const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
-            mainSpecPath,
-            parentFilePath: mainSpecPath,
-            refValuePath: '#/components/schemas/MainUser',
-            outputModelsPath,
-        });
-        node_assert_1.strict.equal(normalizePath(result), './MainUser');
+    (0, node_test_1.afterEach)(() => {
+        fileSystemHelpers_1.fileSystemHelpers.isDirectory = originalIsDirectory;
+        fileSystemHelpers_1.fileSystemHelpers.isPathToFile = originalIsPathToFile;
     });
-    (0, node_test_1.test)('external link to the file → correct name via getClassName', () => {
-        const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
-            mainSpecPath,
-            parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
-            refValuePath: './users-list.yaml',
-            outputModelsPath,
-        });
-        // users-list.yaml → UsersList (по твоей логике stripNamespace + getClassName)
-        node_assert_1.strict.equal(normalizePath(result), './spec/UsersList');
+    (0, node_test_1.describe)('HTTP_URL', () => {
+        (0, node_test_1.test)('http URL → returns URL as is', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: mainSpecPath,
+                refValuePath: 'http://example.com/schema.json',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(result, 'http://example.com/schema.json');
+        });
+        (0, node_test_1.test)('https URL → returns URL as is', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: mainSpecPath,
+                refValuePath: 'https://api.example.com/schemas/user.yaml',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(result, 'https://api.example.com/schemas/user.yaml');
+        });
+    });
+    (0, node_test_1.describe)('LOCAL_FRAGMENT', () => {
+        (0, node_test_1.test)('internal link in the child file → path to the model by schema name', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml#/components/schemas/AccountField',
+                refValuePath: '#/components/schemas/AccountField',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/AccountField');
+        });
+        (0, node_test_1.test)('internal link in the main file → model in the root output', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: mainSpecPath,
+                refValuePath: '#/components/schemas/MainUser',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './MainUser');
+        });
+        (0, node_test_1.test)('internal link without parentFilePath → uses mainSpecPath', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '',
+                refValuePath: '#/components/schemas/MainUser',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './MainUser');
+        });
+        (0, node_test_1.test)('embedded internal link → folder structure is saved', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/nested/admin/schemas.yaml#/components/schemas/AdminUser',
+                refValuePath: '#/components/schemas/AdminUser',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/nested/admin/AdminUser');
+        });
+        (0, node_test_1.test)('deep nesting — the path is built correctly', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/very/deep/config/models.yaml#/components/schemas/ConfigDto',
+                refValuePath: '#/components/schemas/ConfigDto',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/very/deep/config/ConfigDto');
+        });
+        (0, node_test_1.test)('LOCAL_FRAGMENT with responses component', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '#/components/responses/ErrorResponse',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/ErrorResponse');
+        });
+        (0, node_test_1.test)('LOCAL_FRAGMENT with parameters component', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '#/components/parameters/PageParam',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/PageParam');
+        });
+        (0, node_test_1.test)('LOCAL_FRAGMENT with mainSpecPath as directory', () => {
+            fileSystemHelpers_1.fileSystemHelpers.isDirectory = node_test_1.mock.fn(() => true);
+            fileSystemHelpers_1.fileSystemHelpers.isPathToFile = node_test_1.mock.fn(() => false);
+            const mainSpecDir = '/Users/user/Developer/my_app/openapi/app';
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath: mainSpecDir,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '#/components/schemas/AccountField',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/AccountField');
+        });
+        (0, node_test_1.test)('LOCAL_FRAGMENT when mapPathToTargetDirSafe maps correctly → returns relative path', () => {
+            // Even with different output path, mapPathToTargetDirSafe finds common parent
+            // and maps the path, so function returns relative path, not fallback
+            const externalOutputPath = '/Users/user/Developer/other_project/generated/models';
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '#/components/schemas/AccountField',
+                outputModelsPath: externalOutputPath,
+            });
+            // The path is still mapped correctly via common parent
+            node_assert_1.strict.equal(normalizePath(result), './spec/AccountField');
+        });
+    });
+    (0, node_test_1.describe)('EXTERNAL_FILE_FRAGMENT', () => {
+        (0, node_test_1.test)('external file with fragment → resolves to correct model path', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: './users-list.yaml#/components/schemas/UserList',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/UserList');
+        });
+        (0, node_test_1.test)('external file fragment with nested path', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '../shared/common.yaml#/components/schemas/CommonModel',
+                outputModelsPath,
+            });
+            // Should resolve relative to parent file directory
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(normalized.includes('CommonModel') || normalized.includes('common'));
+        });
+        (0, node_test_1.test)('external file fragment without parentFilePath', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '',
+                refValuePath: './shared/models.yaml#/components/schemas/SharedModel',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(normalized.includes('SharedModel') || normalized.includes('shared'));
+        });
+        (0, node_test_1.test)('external file fragment with responses component', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: './responses.yaml#/components/responses/ApiResponse',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(normalized.includes('ApiResponse') || normalized.includes('spec'));
+        });
+        (0, node_test_1.test)('EXTERNAL_FILE_FRAGMENT when path is outside outputModelsPath → returns fallback', () => {
+            const externalOutputPath = '/Users/user/Developer/other_project/generated/models';
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: './users-list.yaml#/components/schemas/UserList',
+                outputModelsPath: externalOutputPath,
+            });
+            // mapPathToTargetDirSafe finds common parent and still maps the path,
+            // so it returns relative path instead of fallback
+            node_assert_1.strict.equal(normalizePath(result), './spec/UserList');
+        });
     });
-    (0, node_test_1.test)('embedded internal link → folder structure is saved', () => {
-        const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
-            mainSpecPath,
-            parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/nested/admin/schemas.yaml#/components/schemas/AdminUser',
-            refValuePath: '#/components/schemas/AdminUser',
-            outputModelsPath,
-        });
-        node_assert_1.strict.equal(normalizePath(result), './spec/nested/admin/AdminUser');
+    (0, node_test_1.describe)('EXTERNAL_FILE', () => {
+        (0, node_test_1.test)('external link to the file → correct name via getClassName', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: './users-list.yaml',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/UsersList');
+        });
+        (0, node_test_1.test)('the link to the file without the extension → is processed correctly', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/shared.yaml',
+                refValuePath: './common/error',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/common/Error');
+        });
+        (0, node_test_1.test)('external file with relative path up directory', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/nested/accountSpec.yaml',
+                refValuePath: '../shared/common.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(normalized.includes('Common') || normalized.includes('spec/shared'));
+        });
+        (0, node_test_1.test)('external file with absolute path', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '/Users/user/Developer/my_app/openapi/shared/models.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            // Absolute paths are handled in default case
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
+        (0, node_test_1.test)('EXTERNAL_FILE when path is outside outputModelsPath → returns fallback', () => {
+            const externalOutputPath = '/Users/user/Developer/other_project/generated/models';
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: './users-list.yaml',
+                outputModelsPath: externalOutputPath,
+            });
+            // mapPathToTargetDirSafe finds common parent and still maps the path,
+            // so it returns relative path instead of fallback
+            node_assert_1.strict.equal(normalizePath(result), './spec/UsersList');
+        });
+        (0, node_test_1.test)('external file reference from main spec file', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: mainSpecPath,
+                refValuePath: './schemas/user.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(normalized.includes('User') || normalized === './User');
+        });
     });
-    (0, node_test_1.test)('deep nesting — the path is built correctly', () => {
-        const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
-            mainSpecPath,
-            parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/very/deep/config/models.yaml#/components/schemas/ConfigDto',
-            refValuePath: '#/components/schemas/ConfigDto',
-            outputModelsPath,
-        });
-        node_assert_1.strict.equal(normalizePath(result), './spec/very/deep/config/ConfigDto');
+    (0, node_test_1.describe)('ABSOLUTE_PATH (default case)', () => {
+        (0, node_test_1.test)('absolute path to file → resolves correctly', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '/Users/user/Developer/my_app/openapi/shared/models/user.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string' && normalized.length > 0);
+        });
+        (0, node_test_1.test)('absolute path when isPathToFile returns true', () => {
+            fileSystemHelpers_1.fileSystemHelpers.isDirectory = node_test_1.mock.fn(() => false);
+            fileSystemHelpers_1.fileSystemHelpers.isPathToFile = node_test_1.mock.fn((path) => {
+                return path.includes('user.yaml');
+            });
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '/Users/user/Developer/my_app/openapi/shared/models/user.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
+        (0, node_test_1.test)('absolute path when isPathToFile returns false (directory)', () => {
+            fileSystemHelpers_1.fileSystemHelpers.isDirectory = node_test_1.mock.fn((path) => {
+                return path.includes('models');
+            });
+            fileSystemHelpers_1.fileSystemHelpers.isPathToFile = node_test_1.mock.fn(() => false);
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '/Users/user/Developer/my_app/openapi/shared/models',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
+        (0, node_test_1.test)('absolute path when path is outside outputModelsPath → returns fallback', () => {
+            const externalOutputPath = '/Users/user/Developer/other_project/generated/models';
+            fileSystemHelpers_1.fileSystemHelpers.isDirectory = node_test_1.mock.fn(() => false);
+            fileSystemHelpers_1.fileSystemHelpers.isPathToFile = node_test_1.mock.fn(() => true);
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: '/Users/user/Developer/my_app/openapi/shared/models/user.yaml',
+                outputModelsPath: externalOutputPath,
+            });
+            // Should return fallback with basename
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(normalized.includes('User') || normalized === './User');
+        });
+        (0, node_test_1.test)('absolute path with parentFilePath as directory', () => {
+            fileSystemHelpers_1.fileSystemHelpers.isDirectory = node_test_1.mock.fn((path) => {
+                return path.includes('app');
+            });
+            fileSystemHelpers_1.fileSystemHelpers.isPathToFile = node_test_1.mock.fn((path) => {
+                return !path.includes('app');
+            });
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app',
+                refValuePath: '/Users/user/Developer/my_app/openapi/shared/models/user.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
     });
-    (0, node_test_1.test)('the link to the file without the extension → is processed correctly', () => {
-        const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
-            mainSpecPath,
-            parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/shared.yaml',
-            refValuePath: './common/error',
-            outputModelsPath,
-        });
-        // error → Error (getClassName)
-        node_assert_1.strict.equal(normalizePath(result), './spec/common/Error');
+    (0, node_test_1.describe)('Edge cases', () => {
+        (0, node_test_1.test)('parentFilePath with fragment but refValuePath is external file', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml#/components/schemas/Account',
+                refValuePath: './users-list.yaml',
+                outputModelsPath,
+            });
+            node_assert_1.strict.equal(normalizePath(result), './spec/UsersList');
+        });
+        (0, node_test_1.test)('refValuePath starts with parent baseName → removes prefix correctly', () => {
+            fileSystemHelpers_1.fileSystemHelpers.isDirectory = node_test_1.mock.fn(() => false);
+            fileSystemHelpers_1.fileSystemHelpers.isPathToFile = node_test_1.mock.fn(() => true);
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/spec/accountSpec.yaml',
+                refValuePath: 'accountSpec.yaml/nested/model.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
+        (0, node_test_1.test)('empty refValuePath with default handling', () => {
+            // parseRef returns LOCAL_FRAGMENT for empty/invalid refs
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: mainSpecPath,
+                refValuePath: '',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
+        (0, node_test_1.test)('parentFilePath without filePath in parsed result', () => {
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath,
+                parentFilePath: '#/components/schemas/Parent',
+                refValuePath: './child.yaml',
+                outputModelsPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
+        (0, node_test_1.test)('when absModelPath equals absOutputModelsPath', () => {
+            // This tests the condition: absModelPath !== absOutputModelsPath
+            const customOutputPath = '/Users/user/Developer/openapi-codegen/generated/models';
+            const result = (0, resolveRefToImportPath_1.resolveRefToImportPath)({
+                mainSpecPath: '/Users/user/Developer/my_app/openapi/app/openapi_spec.yaml',
+                parentFilePath: '/Users/user/Developer/my_app/openapi/app/openapi_spec.yaml',
+                refValuePath: '#/components/schemas/MainUser',
+                outputModelsPath: customOutputPath,
+            });
+            const normalized = normalizePath(result);
+            node_assert_1.strict.ok(typeof normalized === 'string');
+        });
     });
 });