@twin.org/tools-core 0.0.3-next.2 → 0.0.3-next.21

package/dist/es/utils/fileUtils.js

@@ -0,0 +1,130 @@
+// Copyright 2026 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { globSync } from "glob";
+/**
+ * Utility helpers for TypeScript file and directory paths.
+ */
+export class FileUtils {
+    /**
+     * Does the file exist.
+     * @param filePath The file path.
+     * @returns True if the file exists.
+     */
+    static fileExists(filePath) {
+        return existsSync(filePath);
+    }
+    /**
+     * Read the file.
+     * @param filePath The file path.
+     * @returns The file contents.
+     */
+    static readFile(filePath) {
+        return readFileSync(filePath, "utf-8");
+    }
+    /**
+     * Resolve a path.
+     * @param filePath The file path.
+     * @returns The resolved path.
+     */
+    static resolvePath(filePath) {
+        return path.resolve(filePath);
+    }
+    /**
+     * Get the current working directory.
+     * @returns The current working directory.
+     */
+    static getCurrentWorkingDirectory() {
+        return process.cwd();
+    }
+    /**
+     * Normalize path separators for consistent comparisons.
+     * @param filePath The file path.
+     * @returns The normalized file path.
+     */
+    static normalizeFilePath(filePath) {
+        return filePath.replaceAll("\\", "/");
+    }
+    /**
+     * Get the directory portion of a file path.
+     * @param filePath The file path.
+     * @returns The directory path.
+     */
+    static getDirectoryPath(filePath) {
+        const normalizedPath = FileUtils.normalizeFilePath(filePath);
+        const lastSeparatorIndex = normalizedPath.lastIndexOf("/");
+        return lastSeparatorIndex > -1 ? normalizedPath.slice(0, lastSeparatorIndex) : normalizedPath;
+    }
+    /**
+     * Resolve a relative path against a base directory.
+     * @param baseDirectory The base directory.
+     * @param relativePath The relative path.
+     * @returns The resolved path.
+     */
+    static resolveRelativePath(baseDirectory, relativePath) {
+        const normalizedRelative = FileUtils.normalizeFilePath(relativePath);
+        // Return absolute paths unchanged (Windows drive letter or POSIX root)
+        if (path.isAbsolute(normalizedRelative)) {
+            return normalizedRelative;
+        }
+        const normalizedBase = FileUtils.normalizeFilePath(baseDirectory);
+        if (path.isAbsolute(normalizedBase)) {
+            return FileUtils.normalizeFilePath(path.resolve(baseDirectory, relativePath));
+        }
+        // Base was relative — resolve to absolute then express relative to CWD to preserve relative form
+        return FileUtils.normalizeFilePath(path.relative(process.cwd(), path.resolve(baseDirectory, relativePath)));
+    }
+    /**
+     * Resolve a local import specifier to a TypeScript source file path.
+     * @param sourceFilePath The importing source file path.
+     * @param importPath The import specifier.
+     * @returns The resolved source file path.
+     */
+    static resolveImportSourceFilePath(sourceFilePath, importPath) {
+        const sourceDirectory = FileUtils.getDirectoryPath(sourceFilePath);
+        const resolvedBase = FileUtils.resolveRelativePath(sourceDirectory, importPath);
+        const baseWithoutExtension = resolvedBase.replace(/\.(c|m)?js$/u, "");
+        const candidates = [
+            resolvedBase,
+            `${resolvedBase}.ts`,
+            `${resolvedBase}.d.ts`,
+            `${resolvedBase}/index.ts`,
+            `${resolvedBase}/index.d.ts`,
+            `${baseWithoutExtension}.d.ts`,
+            `${baseWithoutExtension}/index.d.ts`
+        ];
+        for (const candidate of candidates) {
+            if (FileUtils.fileExists(candidate)) {
+                return candidate;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Determine if the provided path includes glob pattern tokens.
+     * @param sourceFileOrGlob The direct source file path or glob pattern.
+     * @returns True if the value is a glob pattern.
+     */
+    static isGlobPattern(sourceFileOrGlob) {
+        return /[*?[\]{}]/u.test(sourceFileOrGlob);
+    }
+    /**
+     * Resolve source files from a direct path or a glob pattern.
+     * @param sourceFileOrGlob The direct source file path or glob pattern.
+     * @returns The resolved source file paths.
+     */
+    static resolveSourceFiles(sourceFileOrGlob) {
+        if (!FileUtils.isGlobPattern(sourceFileOrGlob)) {
+            return FileUtils.fileExists(sourceFileOrGlob) ? [sourceFileOrGlob] : [];
+        }
+        const sourceFiles = globSync(sourceFileOrGlob, {
+            windowsPathsNoEscape: true,
+            withFileTypes: false
+        });
+        return sourceFiles
+            .filter(sourceFile => /\.(ts|tsx|mts|cts)$/u.test(sourceFile) && FileUtils.fileExists(sourceFile))
+            .sort((sourceFileA, sourceFileB) => sourceFileA.localeCompare(sourceFileB));
+    }
+}
+//# sourceMappingURL=fileUtils.js.map

package/dist/es/utils/fileUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUtils.js","sourceRoot":"","sources":["../../../src/utils/fileUtils.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { globSync } from \"glob\";\n\n/**\n * Utility helpers for TypeScript file and directory paths.\n */\nexport class FileUtils {\n\t/**\n\t * Does the file exist.\n\t * @param filePath The file path.\n\t * @returns True if the file exists.\n\t */\n\tpublic static fileExists(filePath: string): boolean {\n\t\treturn existsSync(filePath);\n\t}\n\n\t/**\n\t * Read the file.\n\t * @param filePath The file path.\n\t * @returns The file contents.\n\t */\n\tpublic static readFile(filePath: string): string {\n\t\treturn readFileSync(filePath, \"utf-8\");\n\t}\n\n\t/**\n\t * Resolve a path.\n\t * @param filePath The file path.\n\t * @returns The resolved path.\n\t */\n\tpublic static resolvePath(filePath: string): string {\n\t\treturn path.resolve(filePath);\n\t}\n\n\t/**\n\t * Get the current working directory.\n\t * @returns The current working directory.\n\t */\n\tpublic static getCurrentWorkingDirectory(): string {\n\t\treturn process.cwd();\n\t}\n\n\t/**\n\t * Normalize path separators for consistent comparisons.\n\t * @param filePath The file path.\n\t * @returns The normalized file path.\n\t */\n\tpublic static normalizeFilePath(filePath: string): string {\n\t\treturn filePath.replaceAll(\"\\\\\", \"/\");\n\t}\n\n\t/**\n\t * Get the directory portion of a file path.\n\t * @param filePath The file path.\n\t * @returns The directory path.\n\t */\n\tpublic static getDirectoryPath(filePath: string): string {\n\t\tconst normalizedPath = FileUtils.normalizeFilePath(filePath);\n\t\tconst lastSeparatorIndex = normalizedPath.lastIndexOf(\"/\");\n\t\treturn lastSeparatorIndex > -1 ? normalizedPath.slice(0, lastSeparatorIndex) : normalizedPath;\n\t}\n\n\t/**\n\t * Resolve a relative path against a base directory.\n\t * @param baseDirectory The base directory.\n\t * @param relativePath The relative path.\n\t * @returns The resolved path.\n\t */\n\tpublic static resolveRelativePath(baseDirectory: string, relativePath: string): string {\n\t\tconst normalizedRelative = FileUtils.normalizeFilePath(relativePath);\n\n\t\t// Return absolute paths unchanged (Windows drive letter or POSIX root)\n\t\tif (path.isAbsolute(normalizedRelative)) {\n\t\t\treturn normalizedRelative;\n\t\t}\n\n\t\tconst normalizedBase = FileUtils.normalizeFilePath(baseDirectory);\n\n\t\tif (path.isAbsolute(normalizedBase)) {\n\t\t\treturn FileUtils.normalizeFilePath(path.resolve(baseDirectory, relativePath));\n\t\t}\n\n\t\t// Base was relative — resolve to absolute then express relative to CWD to preserve relative form\n\t\treturn FileUtils.normalizeFilePath(\n\t\t\tpath.relative(process.cwd(), path.resolve(baseDirectory, relativePath))\n\t\t);\n\t}\n\n\t/**\n\t * Resolve a local import specifier to a TypeScript source file path.\n\t * @param sourceFilePath The importing source file path.\n\t * @param importPath The import specifier.\n\t * @returns The resolved source file path.\n\t */\n\tpublic static resolveImportSourceFilePath(\n\t\tsourceFilePath: string,\n\t\timportPath: string\n\t): string | undefined {\n\t\tconst sourceDirectory = FileUtils.getDirectoryPath(sourceFilePath);\n\t\tconst resolvedBase = FileUtils.resolveRelativePath(sourceDirectory, importPath);\n\t\tconst baseWithoutExtension = resolvedBase.replace(/\\.(c|m)?js$/u, \"\");\n\t\tconst candidates = [\n\t\t\tresolvedBase,\n\t\t\t`${resolvedBase}.ts`,\n\t\t\t`${resolvedBase}.d.ts`,\n\t\t\t`${resolvedBase}/index.ts`,\n\t\t\t`${resolvedBase}/index.d.ts`,\n\t\t\t`${baseWithoutExtension}.d.ts`,\n\t\t\t`${baseWithoutExtension}/index.d.ts`\n\t\t];\n\n\t\tfor (const candidate of candidates) {\n\t\t\tif (FileUtils.fileExists(candidate)) {\n\t\t\t\treturn candidate;\n\t\t\t}\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Determine if the provided path includes glob pattern tokens.\n\t * @param sourceFileOrGlob The direct source file path or glob pattern.\n\t * @returns True if the value is a glob pattern.\n\t */\n\tpublic static isGlobPattern(sourceFileOrGlob: string): boolean {\n\t\treturn /[*?[\\]{}]/u.test(sourceFileOrGlob);\n\t}\n\n\t/**\n\t * Resolve source files from a direct path or a glob pattern.\n\t * @param sourceFileOrGlob The direct source file path or glob pattern.\n\t * @returns The resolved source file paths.\n\t */\n\tpublic static resolveSourceFiles(sourceFileOrGlob: string): string[] {\n\t\tif (!FileUtils.isGlobPattern(sourceFileOrGlob)) {\n\t\t\treturn FileUtils.fileExists(sourceFileOrGlob) ? [sourceFileOrGlob] : [];\n\t\t}\n\n\t\tconst sourceFiles = globSync(sourceFileOrGlob, {\n\t\t\twindowsPathsNoEscape: true,\n\t\t\twithFileTypes: false\n\t\t});\n\n\t\treturn sourceFiles\n\t\t\t.filter(\n\t\t\t\tsourceFile => /\\.(ts|tsx|mts|cts)$/u.test(sourceFile) && FileUtils.fileExists(sourceFile)\n\t\t\t)\n\t\t\t.sort((sourceFileA, sourceFileB) => sourceFileA.localeCompare(sourceFileB));\n\t}\n}\n"]}

package/dist/es/utils/importTypeQuerySchemaResolver.js

@@ -0,0 +1,328 @@
+// Copyright 2026 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/* eslint-disable jsdoc/require-param, jsdoc/require-returns */
+import { Is, StringHelper } from "@twin.org/core";
+import * as ts from "typescript";
+import { DiagnosticReporter } from "./diagnosticReporter.js";
+import { FileUtils } from "./fileUtils.js";
+import { JsonSchemaBuilder } from "./jsonSchemaBuilder.js";
+import { Resolver } from "./resolver.js";
+/**
+ * Static helpers for import type and type query schema resolution.
+ */
+export class ImportTypeQuerySchemaResolver {
+    /**
+     * Map import type nodes (e.g. import("pkg").Type) to schema references.
+     */
+    static mapImportTypeNodeToSchema(context, typeNode) {
+        if (typeNode.isTypeOf ||
+            !ts.isLiteralTypeNode(typeNode.argument) ||
+            !ts.isStringLiteral(typeNode.argument.literal)) {
+            DiagnosticReporter.report(context, typeNode, "jsonSchemaBuilder.diagnostic.unsupportedImportTypeForm", { argument: typeNode.getText() });
+            return {};
+        }
+        const moduleSpecifier = typeNode.argument.literal.text;
+        const typeName = ImportTypeQuerySchemaResolver.extractImportTypeName(typeNode.qualifier);
+        if (!typeName) {
+            DiagnosticReporter.report(context, typeNode, "jsonSchemaBuilder.diagnostic.unresolvedImportTypeQualifier", { argument: moduleSpecifier });
+            return {};
+        }
+        const title = StringHelper.stripPrefix(typeName);
+        const existingSchemaId = JsonSchemaBuilder.findExistingSchemaIdByTitle(context, title);
+        const resolvedSchemaId = existingSchemaId ??
+            ImportTypeQuerySchemaResolver.resolveImportTypeReferenceSchemaId(context, moduleSpecifier, typeName, title);
+        return {
+            $ref: resolvedSchemaId ?? `${context.namespace}${title}`
+        };
+    }
+    /**
+     * Map a type query node (typeof expr) to schema by resolving the referenced variable.
+     */
+    static mapTypeQueryNodeToSchema(context, typeNode) {
+        if (ts.isQualifiedName(typeNode.exprName) && ts.isIdentifier(typeNode.exprName.left)) {
+            const localValue = JsonSchemaBuilder.resolveLocalConstObjectProperty(context, typeNode.exprName.left.text, typeNode.exprName.right.text);
+            if (localValue !== undefined) {
+                return { const: localValue };
+            }
+            const importedValue = ImportTypeQuerySchemaResolver.resolveConstObjectProperty(context, typeNode.exprName.left.text, typeNode.exprName.right.text);
+            if (importedValue !== undefined) {
+                return { const: importedValue };
+            }
+            DiagnosticReporter.report(context, typeNode, "jsonSchemaBuilder.diagnostic.unresolvedTypeQueryTarget", { target: typeNode.getText() });
+            return {};
+        }
+        const exprName = ts.isIdentifier(typeNode.exprName) ? typeNode.exprName.text : undefined;
+        if (!exprName || !context.activeSourceFile) {
+            DiagnosticReporter.report(context, typeNode, "jsonSchemaBuilder.diagnostic.unresolvedTypeQueryTarget", { target: typeNode.getText() });
+            return {};
+        }
+        const localDeclaration = JsonSchemaBuilder.findVariableDeclaration(context.activeSourceFile, exprName);
+        if (localDeclaration) {
+            if (localDeclaration.type) {
+                return JsonSchemaBuilder.mapTypeNodeToSchema(context, localDeclaration.type) ?? {};
+            }
+            if (localDeclaration.initializer) {
+                return JsonSchemaBuilder.inferSchemaFromExpression(context, localDeclaration.initializer);
+            }
+        }
+        const importedTypeQuerySchema = JsonSchemaBuilder.resolveImportedTypeQuerySchema(context, exprName);
+        if (importedTypeQuerySchema) {
+            return importedTypeQuerySchema;
+        }
+        DiagnosticReporter.report(context, typeNode, "jsonSchemaBuilder.diagnostic.unresolvedTypeQueryTarget", { target: exprName });
+        return {};
+    }
+    /**
+     * Resolve import-type references to local or external schema ids.
+     */
+    static resolveImportTypeReferenceSchemaId(context, moduleSpecifier, typeName, title) {
+        const mappedReference = JsonSchemaBuilder.resolveReferenceMappingTarget(context, moduleSpecifier, typeName);
+        if (moduleSpecifier.startsWith(".")) {
+            if (mappedReference?.schemaId) {
+                return mappedReference.schemaId;
+            }
+            const activeFilePath = context.activeSourceFile?.fileName;
+            if (!activeFilePath) {
+                return undefined;
+            }
+            const resolvedImportPath = FileUtils.resolveImportSourceFilePath(activeFilePath, moduleSpecifier);
+            if (!resolvedImportPath) {
+                return undefined;
+            }
+            const importedSource = FileUtils.readFile(resolvedImportPath);
+            if (!importedSource) {
+                return undefined;
+            }
+            JsonSchemaBuilder.parseAllObjectSchemas(context, resolvedImportPath, importedSource, []);
+            return context.schemas[context.packageName]?.[title]?.$id;
+        }
+        const cachedSchemaId = context.schemas[moduleSpecifier]?.[title]?.$id;
+        if (cachedSchemaId) {
+            return cachedSchemaId;
+        }
+        const declarationResult = Resolver.resolveTypeDeclarationAst(moduleSpecifier, typeName);
+        if (!declarationResult) {
+            return mappedReference?.schemaId;
+        }
+        const externalContext = {
+            namespace: mappedReference?.namespace ?? context.namespace,
+            packageName: moduleSpecifier,
+            schemas: context.schemas,
+            activeSourceFile: context.activeSourceFile,
+            options: context.options
+        };
+        JsonSchemaBuilder.parseAllObjectSchemas(externalContext, declarationResult.sourceFile.fileName, declarationResult.sourceFile.getFullText(), []);
+        return context.schemas[moduleSpecifier]?.[title]?.$id ?? mappedReference?.schemaId;
+    }
+    /**
+     * Resolve a property value from a const object declaration in an imported source file.
+     */
+    static resolveConstObjectProperty(context, objectName, propertyName) {
+        if (!context.activeSourceFile) {
+            return undefined;
+        }
+        const importReference = ImportTypeQuerySchemaResolver.findImportedValueReference(context.activeSourceFile, objectName);
+        if (!importReference) {
+            return undefined;
+        }
+        const resolvedPath = ImportTypeQuerySchemaResolver.resolveImportDeclarationSourceFile(context.activeSourceFile.fileName, importReference.moduleSpecifier);
+        if (!resolvedPath) {
+            return undefined;
+        }
+        const importedSource = FileUtils.readFile(resolvedPath);
+        if (!importedSource) {
+            return undefined;
+        }
+        const importedSourceFile = ts.createSourceFile(resolvedPath, importedSource, ts.ScriptTarget.Latest, true);
+        let objDecl = importedSourceFile.statements
+            .filter((stmt) => ts.isVariableStatement(stmt))
+            .flatMap(stmt => [...stmt.declarationList.declarations])
+            .find(decl => ts.isIdentifier(decl.name) && decl.name.text === importReference.importedName);
+        objDecl ??= ImportTypeQuerySchemaResolver.findVariableDeclarationInModuleGraph(resolvedPath, importReference.importedName, new Set());
+        if (!objDecl) {
+            return undefined;
+        }
+        const valueFromInitializer = ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationInitializer(objDecl, propertyName);
+        if (valueFromInitializer !== undefined) {
+            return valueFromInitializer;
+        }
+        if (objDecl.type) {
+            return ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(objDecl.type, propertyName);
+        }
+        return undefined;
+    }
+    /**
+     * Find a variable declaration by traversing import and export chains.
+     */
+    static findVariableDeclarationInModuleGraph(sourceFilePath, variableName, visitedFiles) {
+        const normalizedSourceFilePath = FileUtils.normalizeFilePath(sourceFilePath);
+        if (visitedFiles.has(normalizedSourceFilePath)) {
+            return undefined;
+        }
+        visitedFiles.add(normalizedSourceFilePath);
+        const source = FileUtils.readFile(sourceFilePath);
+        if (!source) {
+            return undefined;
+        }
+        const sourceFile = ts.createSourceFile(sourceFilePath, source, ts.ScriptTarget.Latest, true);
+        const declaration = sourceFile.statements
+            .filter((stmt) => ts.isVariableStatement(stmt))
+            .flatMap(stmt => [...stmt.declarationList.declarations])
+            .find(decl => ts.isIdentifier(decl.name) && decl.name.text === variableName);
+        if (declaration) {
+            return declaration;
+        }
+        const compilerOptions = {
+            module: ts.ModuleKind.NodeNext,
+            moduleResolution: ts.ModuleResolutionKind.NodeNext,
+            target: ts.ScriptTarget.ESNext,
+            skipLibCheck: true
+        };
+        const moduleSpecifiers = sourceFile.statements
+            .filter(statement => ts.isExportDeclaration(statement) || ts.isImportDeclaration(statement))
+            .flatMap(statement => {
+            const moduleSpecifier = statement.moduleSpecifier;
+            return moduleSpecifier && ts.isStringLiteral(moduleSpecifier) ? [moduleSpecifier.text] : [];
+        });
+        for (const moduleSpecifier of moduleSpecifiers) {
+            const resolvedModulePath = ts.resolveModuleName(moduleSpecifier, sourceFilePath, compilerOptions, ts.sys).resolvedModule?.resolvedFileName;
+            if (resolvedModulePath) {
+                const declarationInModule = ImportTypeQuerySchemaResolver.findVariableDeclarationInModuleGraph(resolvedModulePath, variableName, visitedFiles);
+                if (declarationInModule) {
+                    return declarationInModule;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Find an imported symbol reference by local identifier name.
+     */
+    static findImportedValueReference(sourceFile, localName) {
+        for (const statement of sourceFile.statements) {
+            if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {
+                const bindings = statement.importClause?.namedBindings;
+                if (bindings && ts.isNamedImports(bindings)) {
+                    const importElement = bindings.elements.find(el => el.name.text === localName);
+                    if (importElement) {
+                        return {
+                            moduleSpecifier: statement.moduleSpecifier.text,
+                            importedName: importElement.propertyName?.text ?? importElement.name.text
+                        };
+                    }
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Resolve an import declaration module specifier to a source file.
+     */
+    static resolveImportDeclarationSourceFile(containingSourceFilePath, moduleSpecifier) {
+        const resolvedContainingSourceFilePath = FileUtils.resolvePath(containingSourceFilePath);
+        if (moduleSpecifier.startsWith(".")) {
+            return (FileUtils.resolveImportSourceFilePath(resolvedContainingSourceFilePath, moduleSpecifier) ??
+                (moduleSpecifier.endsWith(".js")
+                    ? FileUtils.resolveImportSourceFilePath(resolvedContainingSourceFilePath, `${moduleSpecifier.slice(0, -3)}.ts`)
+                    : undefined));
+        }
+        const compilerOptions = {
+            module: ts.ModuleKind.NodeNext,
+            moduleResolution: ts.ModuleResolutionKind.NodeNext,
+            target: ts.ScriptTarget.ESNext,
+            skipLibCheck: true
+        };
+        return ts.resolveModuleName(moduleSpecifier, resolvedContainingSourceFilePath, compilerOptions, ts.sys).resolvedModule?.resolvedFileName;
+    }
+    /**
+     * Extract a const-object property value from a declaration initializer.
+     */
+    static extractConstObjectPropertyFromDeclarationInitializer(objectDeclaration, propertyName) {
+        if (!objectDeclaration.initializer) {
+            return undefined;
+        }
+        let objLiteral;
+        if (ts.isObjectLiteralExpression(objectDeclaration.initializer)) {
+            objLiteral = objectDeclaration.initializer;
+        }
+        else if (ts.isAsExpression(objectDeclaration.initializer) &&
+            ts.isObjectLiteralExpression(objectDeclaration.initializer.expression)) {
+            objLiteral = objectDeclaration.initializer.expression;
+        }
+        if (!objLiteral) {
+            return undefined;
+        }
+        const prop = objLiteral.properties
+            .filter((p) => ts.isPropertyAssignment(p))
+            .find(p => ts.isIdentifier(p.name) && p.name.text === propertyName);
+        if (!prop) {
+            return undefined;
+        }
+        if (ts.isStringLiteral(prop.initializer)) {
+            return prop.initializer.text;
+        }
+        if (ts.isNumericLiteral(prop.initializer)) {
+            return Number(prop.initializer.text);
+        }
+        return undefined;
+    }
+    /**
+     * Extract a const-object property value from a declaration type annotation.
+     */
+    static extractConstObjectPropertyFromDeclarationType(declarationTypeNode, propertyName) {
+        if (ts.isParenthesizedTypeNode(declarationTypeNode)) {
+            return ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(declarationTypeNode.type, propertyName);
+        }
+        if (ts.isTypeOperatorNode(declarationTypeNode) &&
+            declarationTypeNode.operator === ts.SyntaxKind.ReadonlyKeyword) {
+            return ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(declarationTypeNode.type, propertyName);
+        }
+        if (ts.isTypeReferenceNode(declarationTypeNode) &&
+            ts.isIdentifier(declarationTypeNode.typeName) &&
+            declarationTypeNode.typeName.text === "Readonly" &&
+            Is.arrayValue(declarationTypeNode.typeArguments)) {
+            return ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(declarationTypeNode.typeArguments[0], propertyName);
+        }
+        if (ts.isTypeLiteralNode(declarationTypeNode)) {
+            const propertySignature = declarationTypeNode.members.find((member) => {
+                if (!ts.isPropertySignature(member) || !member.name) {
+                    return false;
+                }
+                return ((ts.isIdentifier(member.name) && member.name.text === propertyName) ||
+                    (ts.isStringLiteral(member.name) && member.name.text === propertyName) ||
+                    (ts.isNumericLiteral(member.name) && member.name.text === propertyName));
+            });
+            if (propertySignature?.type) {
+                return ImportTypeQuerySchemaResolver.extractLiteralValueFromTypeNode(propertySignature.type);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract a literal value from a type node when possible.
+     */
+    static extractLiteralValueFromTypeNode(typeNode) {
+        if (ts.isLiteralTypeNode(typeNode)) {
+            if (ts.isStringLiteral(typeNode.literal)) {
+                return typeNode.literal.text;
+            }
+            if (ts.isNumericLiteral(typeNode.literal)) {
+                return Number(typeNode.literal.text);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract a referenced type name from an import type qualifier.
+     */
+    static extractImportTypeName(qualifier) {
+        if (!qualifier) {
+            return undefined;
+        }
+        if (ts.isIdentifier(qualifier)) {
+            return qualifier.text;
+        }
+        return qualifier.right.text;
+    }
+}
+//# sourceMappingURL=importTypeQuerySchemaResolver.js.map

package/dist/es/utils/importTypeQuerySchemaResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importTypeQuerySchemaResolver.js","sourceRoot":"","sources":["../../../src/utils/importTypeQuerySchemaResolver.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,+DAA+D;AAC/D,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;GAEG;AACH,MAAM,OAAO,6BAA6B;IACzC;;OAEG;IACI,MAAM,CAAC,yBAAyB,CACtC,OAAmC,EACnC,QAA2B;QAE3B,IACC,QAAQ,CAAC,QAAQ;YACjB,CAAC,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACxC,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC7C,CAAC;YACF,kBAAkB,CAAC,MAAM,CACxB,OAAO,EACP,QAAQ,EACR,wDAAwD,EACxD,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAChC,CAAC;YACF,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QACvD,MAAM,QAAQ,GAAG,6BAA6B,CAAC,qBAAqB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,kBAAkB,CAAC,MAAM,CACxB,OAAO,EACP,QAAQ,EACR,4DAA4D,EAC5D,EAAE,QAAQ,EAAE,eAAe,EAAE,CAC7B,CAAC;YACF,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvF,MAAM,gBAAgB,GACrB,gBAAgB;YAChB,6BAA6B,CAAC,kCAAkC,CAC/D,OAAO,EACP,eAAe,EACf,QAAQ,EACR,KAAK,CACL,CAAC;QAEH,OAAO;YACN,IAAI,EAAE,gBAAgB,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,KAAK,EAAE;SACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,wBAAwB,CACrC,OAAmC,EACnC,QAA0B;QAE1B,IAAI,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtF,MAAM,UAAU,GAAG,iBAAiB,CAAC,+BAA+B,CACnE,OAAO,EACP,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAC3B,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAC5B,CAAC;YACF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YAC9B,CAAC;YAED,MAAM,aAAa,GAAG,6BAA6B,CAAC,0BAA0B,CAC7E,OAAO,EACP,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAC3B,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAC5B,CAAC;YACF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;YACjC,CAAC;YAED,kBAAkB,CAAC,MAAM,CACxB,OAAO,EACP,QAAQ,EACR,wDAAwD,EACxD,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAC9B,CAAC;YACF,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC5C,kBAAkB,CAAC,MAAM,CACxB,OAAO,EACP,QAAQ,EACR,wDAAwD,EACxD,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAC9B,CAAC;YACF,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,uBAAuB,CACjE,OAAO,CAAC,gBAAgB,EACxB,QAAQ,CACR,CAAC;QACF,IAAI,gBAAgB,EAAE,CAAC;YACtB,IAAI,gBAAgB,CAAC,IAAI,EAAE,CAAC;gBAC3B,OAAO,iBAAiB,CAAC,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACpF,CAAC;YACD,IAAI,gBAAgB,CAAC,WAAW,EAAE,CAAC;gBAClC,OAAO,iBAAiB,CAAC,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAC3F,CAAC;QACF,CAAC;QAED,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,8BAA8B,CAC/E,OAAO,EACP,QAAQ,CACR,CAAC;QACF,IAAI,uBAAuB,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAAC;QAChC,CAAC;QAED,kBAAkB,CAAC,MAAM,CACxB,OAAO,EACP,QAAQ,EACR,wDAAwD,EACxD,EAAE,MAAM,EAAE,QAAQ,EAAE,CACpB,CAAC;QAEF,OAAO,EAAE,CAAC;IACX,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,kCAAkC,CAC/C,OAAmC,EACnC,eAAuB,EACvB,QAAgB,EAChB,KAAa;QAEb,MAAM,eAAe,GAAG,iBAAiB,CAAC,6BAA6B,CACtE,OAAO,EACP,eAAe,EACf,QAAQ,CACR,CAAC;QAEF,IAAI,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,eAAe,EAAE,QAAQ,EAAE,CAAC;gBAC/B,OAAO,eAAe,CAAC,QAAQ,CAAC;YACjC,CAAC;YAED,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,QAAQ,CAAC;YAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,kBAAkB,GAAG,SAAS,CAAC,2BAA2B,CAC/D,cAAc,EACd,eAAe,CACf,CAAC;YACF,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACzB,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,cAAc,GAAG,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YAC9D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,iBAAiB,CAAC,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;YACzF,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QAC3D,CAAC;QAED,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QACtE,IAAI,cAAc,EAAE,CAAC;YACpB,OAAO,cAAc,CAAC;QACvB,CAAC;QAED,MAAM,iBAAiB,GAAG,QAAQ,CAAC,yBAAyB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACxF,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACxB,OAAO,eAAe,EAAE,QAAQ,CAAC;QAClC,CAAC;QAED,MAAM,eAAe,GAA+B;YACnD,SAAS,EAAE,eAAe,EAAE,SAAS,IAAI,OAAO,CAAC,SAAS;YAC1D,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAC;QAEF,iBAAiB,CAAC,qBAAqB,CACtC,eAAe,EACf,iBAAiB,CAAC,UAAU,CAAC,QAAQ,EACrC,iBAAiB,CAAC,UAAU,CAAC,WAAW,EAAE,EAC1C,EAAE,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,eAAe,EAAE,QAAQ,CAAC;IACpF,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,0BAA0B,CACxC,OAAmC,EACnC,UAAkB,EAClB,YAAoB;QAEpB,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,eAAe,GAAG,6BAA6B,CAAC,0BAA0B,CAC/E,OAAO,CAAC,gBAAgB,EACxB,UAAU,CACV,CAAC;QACF,IAAI,CAAC,eAAe,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,YAAY,GAAG,6BAA6B,CAAC,kCAAkC,CACpF,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EACjC,eAAe,CAAC,eAAe,CAC/B,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,cAAc,GAAG,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxD,IAAI,CAAC,cAAc,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,kBAAkB,GAAG,EAAE,CAAC,gBAAgB,CAC7C,YAAY,EACZ,cAAc,EACd,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,CACJ,CAAC;QAEF,IAAI,OAAO,GAAG,kBAAkB,CAAC,UAAU;aACzC,MAAM,CAAC,CAAC,IAAI,EAAgC,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;aAC5E,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;aACvD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,YAAY,CAAC,CAAC;QAE9F,OAAO,KAAK,6BAA6B,CAAC,oCAAoC,CAC7E,YAAY,EACZ,eAAe,CAAC,YAAY,EAC5B,IAAI,GAAG,EAAU,CACjB,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,oBAAoB,GACzB,6BAA6B,CAAC,oDAAoD,CACjF,OAAO,EACP,YAAY,CACZ,CAAC;QACH,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,oBAAoB,CAAC;QAC7B,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,6BAA6B,CAAC,6CAA6C,CACjF,OAAO,CAAC,IAAI,EACZ,YAAY,CACZ,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,oCAAoC,CAClD,cAAsB,EACtB,YAAoB,EACpB,YAAyB;QAEzB,MAAM,wBAAwB,GAAG,SAAS,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAC7E,IAAI,YAAY,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE7F,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU;aACvC,MAAM,CAAC,CAAC,IAAI,EAAgC,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;aAC5E,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;aACvD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YACjB,OAAO,WAAW,CAAC;QACpB,CAAC;QAED,MAAM,eAAe,GAAuB;YAC3C,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ;YAC9B,gBAAgB,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ;YAClD,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;YAC9B,YAAY,EAAE,IAAI;SAClB,CAAC;QAEF,MAAM,gBAAgB,GAAG,UAAU,CAAC,UAAU;aAC5C,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;aAC3F,OAAO,CAAC,SAAS,CAAC,EAAE;YACpB,MAAM,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC;YAClD,OAAO,eAAe,IAAI,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,CAAC,CAAC,CAAC;QAEJ,KAAK,MAAM,eAAe,IAAI,gBAAgB,EAAE,CAAC;YAChD,MAAM,kBAAkB,GAAG,EAAE,CAAC,iBAAiB,CAC9C,eAAe,EACf,cAAc,EACd,eAAe,EACf,EAAE,CAAC,GAAG,CACN,CAAC,cAAc,EAAE,gBAAgB,CAAC;YAEnC,IAAI,kBAAkB,EAAE,CAAC;gBACxB,MAAM,mBAAmB,GACxB,6BAA6B,CAAC,oCAAoC,CACjE,kBAAkB,EAClB,YAAY,EACZ,YAAY,CACZ,CAAC;gBACH,IAAI,mBAAmB,EAAE,CAAC;oBACzB,OAAO,mBAAmB,CAAC;gBAC5B,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,0BAA0B,CACxC,UAAyB,EACzB,SAAiB;QAOjB,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC/C,IAAI,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;gBACxF,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;gBACvD,IAAI,QAAQ,IAAI,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7C,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;oBAC/E,IAAI,aAAa,EAAE,CAAC;wBACnB,OAAO;4BACN,eAAe,EAAE,SAAS,CAAC,eAAe,CAAC,IAAI;4BAC/C,YAAY,EAAE,aAAa,CAAC,YAAY,EAAE,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI;yBACzE,CAAC;oBACH,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,kCAAkC,CAChD,wBAAgC,EAChC,eAAuB;QAEvB,MAAM,gCAAgC,GAAG,SAAS,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;QAEzF,IAAI,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,CACN,SAAS,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,eAAe,CAAC;gBACxF,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC/B,CAAC,CAAC,SAAS,CAAC,2BAA2B,CACrC,gCAAgC,EAChC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CACpC;oBACF,CAAC,CAAC,SAAS,CAAC,CACb,CAAC;QACH,CAAC;QAED,MAAM,eAAe,GAAuB;YAC3C,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ;YAC9B,gBAAgB,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ;YAClD,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;YAC9B,YAAY,EAAE,IAAI;SAClB,CAAC;QAEF,OAAO,EAAE,CAAC,iBAAiB,CAC1B,eAAe,EACf,gCAAgC,EAChC,eAAe,EACf,EAAE,CAAC,GAAG,CACN,CAAC,cAAc,EAAE,gBAAgB,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,oDAAoD,CAClE,iBAAyC,EACzC,YAAoB;QAEpB,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,IAAI,UAAkD,CAAC;QACvD,IAAI,EAAE,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;YACjE,UAAU,GAAG,iBAAiB,CAAC,WAAW,CAAC;QAC5C,CAAC;aAAM,IACN,EAAE,CAAC,cAAc,CAAC,iBAAiB,CAAC,WAAW,CAAC;YAChD,EAAE,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,EACrE,CAAC;YACF,UAAU,GAAG,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU;aAChC,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;aACrE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAErE,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAC9B,CAAC;QACD,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,6CAA6C,CAC3D,mBAAgC,EAChC,YAAoB;QAEpB,IAAI,EAAE,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACrD,OAAO,6BAA6B,CAAC,6CAA6C,CACjF,mBAAmB,CAAC,IAAI,EACxB,YAAY,CACZ,CAAC;QACH,CAAC;QAED,IACC,EAAE,CAAC,kBAAkB,CAAC,mBAAmB,CAAC;YAC1C,mBAAmB,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,eAAe,EAC7D,CAAC;YACF,OAAO,6BAA6B,CAAC,6CAA6C,CACjF,mBAAmB,CAAC,IAAI,EACxB,YAAY,CACZ,CAAC;QACH,CAAC;QAED,IACC,EAAE,CAAC,mBAAmB,CAAC,mBAAmB,CAAC;YAC3C,EAAE,CAAC,YAAY,CAAC,mBAAmB,CAAC,QAAQ,CAAC;YAC7C,mBAAmB,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU;YAChD,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAC/C,CAAC;YACF,OAAO,6BAA6B,CAAC,6CAA6C,CACjF,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,EACpC,YAAY,CACZ,CAAC;QACH,CAAC;QAED,IAAI,EAAE,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC/C,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CACzD,CAAC,MAAM,EAAkC,EAAE;gBAC1C,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACrD,OAAO,KAAK,CAAC;gBACd,CAAC;gBAED,OAAO,CACN,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;oBACnE,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;oBACtE,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CACvE,CAAC;YACH,CAAC,CACD,CAAC;YAEF,IAAI,iBAAiB,EAAE,IAAI,EAAE,CAAC;gBAC7B,OAAO,6BAA6B,CAAC,+BAA+B,CACnE,iBAAiB,CAAC,IAAI,CACtB,CAAC;YACH,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,+BAA+B,CAC7C,QAAqB;QAErB,IAAI,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,IAAI,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1C,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;YAC9B,CAAC;YAED,IAAI,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3C,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,qBAAqB,CAAC,SAAoC;QACxE,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,IAAI,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC,IAAI,CAAC;QACvB,CAAC;QAED,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;IAC7B,CAAC;CACD","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n/* eslint-disable jsdoc/require-param, jsdoc/require-returns */\nimport { Is, StringHelper } from \"@twin.org/core\";\nimport type { IJsonSchema } from \"@twin.org/tools-models\";\nimport * as ts from \"typescript\";\nimport { DiagnosticReporter } from \"./diagnosticReporter.js\";\nimport { FileUtils } from \"./fileUtils.js\";\nimport { JsonSchemaBuilder } from \"./jsonSchemaBuilder.js\";\nimport { Resolver } from \"./resolver.js\";\nimport type { ITypeScriptToSchemaContext } from \"../models/ITypeScriptToSchemaContext.js\";\n\n/**\n * Static helpers for import type and type query schema resolution.\n */\nexport class ImportTypeQuerySchemaResolver {\n\t/**\n\t * Map import type nodes (e.g. import(\"pkg\").Type) to schema references.\n\t */\n\tpublic static mapImportTypeNodeToSchema(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.ImportTypeNode\n\t): IJsonSchema | undefined {\n\t\tif (\n\t\t\ttypeNode.isTypeOf ||\n\t\t\t!ts.isLiteralTypeNode(typeNode.argument) ||\n\t\t\t!ts.isStringLiteral(typeNode.argument.literal)\n\t\t) {\n\t\t\tDiagnosticReporter.report(\n\t\t\t\tcontext,\n\t\t\t\ttypeNode,\n\t\t\t\t\"jsonSchemaBuilder.diagnostic.unsupportedImportTypeForm\",\n\t\t\t\t{ argument: typeNode.getText() }\n\t\t\t);\n\t\t\treturn {};\n\t\t}\n\n\t\tconst moduleSpecifier = typeNode.argument.literal.text;\n\t\tconst typeName = ImportTypeQuerySchemaResolver.extractImportTypeName(typeNode.qualifier);\n\t\tif (!typeName) {\n\t\t\tDiagnosticReporter.report(\n\t\t\t\tcontext,\n\t\t\t\ttypeNode,\n\t\t\t\t\"jsonSchemaBuilder.diagnostic.unresolvedImportTypeQualifier\",\n\t\t\t\t{ argument: moduleSpecifier }\n\t\t\t);\n\t\t\treturn {};\n\t\t}\n\n\t\tconst title = StringHelper.stripPrefix(typeName);\n\t\tconst existingSchemaId = JsonSchemaBuilder.findExistingSchemaIdByTitle(context, title);\n\t\tconst resolvedSchemaId =\n\t\t\texistingSchemaId ??\n\t\t\tImportTypeQuerySchemaResolver.resolveImportTypeReferenceSchemaId(\n\t\t\t\tcontext,\n\t\t\t\tmoduleSpecifier,\n\t\t\t\ttypeName,\n\t\t\t\ttitle\n\t\t\t);\n\n\t\treturn {\n\t\t\t$ref: resolvedSchemaId ?? `${context.namespace}${title}`\n\t\t};\n\t}\n\n\t/**\n\t * Map a type query node (typeof expr) to schema by resolving the referenced variable.\n\t */\n\tpublic static mapTypeQueryNodeToSchema(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeQueryNode\n\t): IJsonSchema {\n\t\tif (ts.isQualifiedName(typeNode.exprName) && ts.isIdentifier(typeNode.exprName.left)) {\n\t\t\tconst localValue = JsonSchemaBuilder.resolveLocalConstObjectProperty(\n\t\t\t\tcontext,\n\t\t\t\ttypeNode.exprName.left.text,\n\t\t\t\ttypeNode.exprName.right.text\n\t\t\t);\n\t\t\tif (localValue !== undefined) {\n\t\t\t\treturn { const: localValue };\n\t\t\t}\n\n\t\t\tconst importedValue = ImportTypeQuerySchemaResolver.resolveConstObjectProperty(\n\t\t\t\tcontext,\n\t\t\t\ttypeNode.exprName.left.text,\n\t\t\t\ttypeNode.exprName.right.text\n\t\t\t);\n\t\t\tif (importedValue !== undefined) {\n\t\t\t\treturn { const: importedValue };\n\t\t\t}\n\n\t\t\tDiagnosticReporter.report(\n\t\t\t\tcontext,\n\t\t\t\ttypeNode,\n\t\t\t\t\"jsonSchemaBuilder.diagnostic.unresolvedTypeQueryTarget\",\n\t\t\t\t{ target: typeNode.getText() }\n\t\t\t);\n\t\t\treturn {};\n\t\t}\n\n\t\tconst exprName = ts.isIdentifier(typeNode.exprName) ? typeNode.exprName.text : undefined;\n\t\tif (!exprName || !context.activeSourceFile) {\n\t\t\tDiagnosticReporter.report(\n\t\t\t\tcontext,\n\t\t\t\ttypeNode,\n\t\t\t\t\"jsonSchemaBuilder.diagnostic.unresolvedTypeQueryTarget\",\n\t\t\t\t{ target: typeNode.getText() }\n\t\t\t);\n\t\t\treturn {};\n\t\t}\n\n\t\tconst localDeclaration = JsonSchemaBuilder.findVariableDeclaration(\n\t\t\tcontext.activeSourceFile,\n\t\t\texprName\n\t\t);\n\t\tif (localDeclaration) {\n\t\t\tif (localDeclaration.type) {\n\t\t\t\treturn JsonSchemaBuilder.mapTypeNodeToSchema(context, localDeclaration.type) ?? {};\n\t\t\t}\n\t\t\tif (localDeclaration.initializer) {\n\t\t\t\treturn JsonSchemaBuilder.inferSchemaFromExpression(context, localDeclaration.initializer);\n\t\t\t}\n\t\t}\n\n\t\tconst importedTypeQuerySchema = JsonSchemaBuilder.resolveImportedTypeQuerySchema(\n\t\t\tcontext,\n\t\t\texprName\n\t\t);\n\t\tif (importedTypeQuerySchema) {\n\t\t\treturn importedTypeQuerySchema;\n\t\t}\n\n\t\tDiagnosticReporter.report(\n\t\t\tcontext,\n\t\t\ttypeNode,\n\t\t\t\"jsonSchemaBuilder.diagnostic.unresolvedTypeQueryTarget\",\n\t\t\t{ target: exprName }\n\t\t);\n\n\t\treturn {};\n\t}\n\n\t/**\n\t * Resolve import-type references to local or external schema ids.\n\t */\n\tpublic static resolveImportTypeReferenceSchemaId(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\tmoduleSpecifier: string,\n\t\ttypeName: string,\n\t\ttitle: string\n\t): string | undefined {\n\t\tconst mappedReference = JsonSchemaBuilder.resolveReferenceMappingTarget(\n\t\t\tcontext,\n\t\t\tmoduleSpecifier,\n\t\t\ttypeName\n\t\t);\n\n\t\tif (moduleSpecifier.startsWith(\".\")) {\n\t\t\tif (mappedReference?.schemaId) {\n\t\t\t\treturn mappedReference.schemaId;\n\t\t\t}\n\n\t\t\tconst activeFilePath = context.activeSourceFile?.fileName;\n\t\t\tif (!activeFilePath) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\n\t\t\tconst resolvedImportPath = FileUtils.resolveImportSourceFilePath(\n\t\t\t\tactiveFilePath,\n\t\t\t\tmoduleSpecifier\n\t\t\t);\n\t\t\tif (!resolvedImportPath) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\n\t\t\tconst importedSource = FileUtils.readFile(resolvedImportPath);\n\t\t\tif (!importedSource) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\n\t\t\tJsonSchemaBuilder.parseAllObjectSchemas(context, resolvedImportPath, importedSource, []);\n\t\t\treturn context.schemas[context.packageName]?.[title]?.$id;\n\t\t}\n\n\t\tconst cachedSchemaId = context.schemas[moduleSpecifier]?.[title]?.$id;\n\t\tif (cachedSchemaId) {\n\t\t\treturn cachedSchemaId;\n\t\t}\n\n\t\tconst declarationResult = Resolver.resolveTypeDeclarationAst(moduleSpecifier, typeName);\n\t\tif (!declarationResult) {\n\t\t\treturn mappedReference?.schemaId;\n\t\t}\n\n\t\tconst externalContext: ITypeScriptToSchemaContext = {\n\t\t\tnamespace: mappedReference?.namespace ?? context.namespace,\n\t\t\tpackageName: moduleSpecifier,\n\t\t\tschemas: context.schemas,\n\t\t\tactiveSourceFile: context.activeSourceFile,\n\t\t\toptions: context.options\n\t\t};\n\n\t\tJsonSchemaBuilder.parseAllObjectSchemas(\n\t\t\texternalContext,\n\t\t\tdeclarationResult.sourceFile.fileName,\n\t\t\tdeclarationResult.sourceFile.getFullText(),\n\t\t\t[]\n\t\t);\n\n\t\treturn context.schemas[moduleSpecifier]?.[title]?.$id ?? mappedReference?.schemaId;\n\t}\n\n\t/**\n\t * Resolve a property value from a const object declaration in an imported source file.\n\t */\n\tprivate static resolveConstObjectProperty(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\tobjectName: string,\n\t\tpropertyName: string\n\t): string | number | undefined {\n\t\tif (!context.activeSourceFile) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst importReference = ImportTypeQuerySchemaResolver.findImportedValueReference(\n\t\t\tcontext.activeSourceFile,\n\t\t\tobjectName\n\t\t);\n\t\tif (!importReference) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst resolvedPath = ImportTypeQuerySchemaResolver.resolveImportDeclarationSourceFile(\n\t\t\tcontext.activeSourceFile.fileName,\n\t\t\timportReference.moduleSpecifier\n\t\t);\n\t\tif (!resolvedPath) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst importedSource = FileUtils.readFile(resolvedPath);\n\t\tif (!importedSource) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst importedSourceFile = ts.createSourceFile(\n\t\t\tresolvedPath,\n\t\t\timportedSource,\n\t\t\tts.ScriptTarget.Latest,\n\t\t\ttrue\n\t\t);\n\n\t\tlet objDecl = importedSourceFile.statements\n\t\t\t.filter((stmt): stmt is ts.VariableStatement => ts.isVariableStatement(stmt))\n\t\t\t.flatMap(stmt => [...stmt.declarationList.declarations])\n\t\t\t.find(decl => ts.isIdentifier(decl.name) && decl.name.text === importReference.importedName);\n\n\t\tobjDecl ??= ImportTypeQuerySchemaResolver.findVariableDeclarationInModuleGraph(\n\t\t\tresolvedPath,\n\t\t\timportReference.importedName,\n\t\t\tnew Set<string>()\n\t\t);\n\n\t\tif (!objDecl) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst valueFromInitializer =\n\t\t\tImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationInitializer(\n\t\t\t\tobjDecl,\n\t\t\t\tpropertyName\n\t\t\t);\n\t\tif (valueFromInitializer !== undefined) {\n\t\t\treturn valueFromInitializer;\n\t\t}\n\n\t\tif (objDecl.type) {\n\t\t\treturn ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(\n\t\t\t\tobjDecl.type,\n\t\t\t\tpropertyName\n\t\t\t);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Find a variable declaration by traversing import and export chains.\n\t */\n\tprivate static findVariableDeclarationInModuleGraph(\n\t\tsourceFilePath: string,\n\t\tvariableName: string,\n\t\tvisitedFiles: Set<string>\n\t): ts.VariableDeclaration | undefined {\n\t\tconst normalizedSourceFilePath = FileUtils.normalizeFilePath(sourceFilePath);\n\t\tif (visitedFiles.has(normalizedSourceFilePath)) {\n\t\t\treturn undefined;\n\t\t}\n\t\tvisitedFiles.add(normalizedSourceFilePath);\n\n\t\tconst source = FileUtils.readFile(sourceFilePath);\n\t\tif (!source) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst sourceFile = ts.createSourceFile(sourceFilePath, source, ts.ScriptTarget.Latest, true);\n\n\t\tconst declaration = sourceFile.statements\n\t\t\t.filter((stmt): stmt is ts.VariableStatement => ts.isVariableStatement(stmt))\n\t\t\t.flatMap(stmt => [...stmt.declarationList.declarations])\n\t\t\t.find(decl => ts.isIdentifier(decl.name) && decl.name.text === variableName);\n\t\tif (declaration) {\n\t\t\treturn declaration;\n\t\t}\n\n\t\tconst compilerOptions: ts.CompilerOptions = {\n\t\t\tmodule: ts.ModuleKind.NodeNext,\n\t\t\tmoduleResolution: ts.ModuleResolutionKind.NodeNext,\n\t\t\ttarget: ts.ScriptTarget.ESNext,\n\t\t\tskipLibCheck: true\n\t\t};\n\n\t\tconst moduleSpecifiers = sourceFile.statements\n\t\t\t.filter(statement => ts.isExportDeclaration(statement) || ts.isImportDeclaration(statement))\n\t\t\t.flatMap(statement => {\n\t\t\t\tconst moduleSpecifier = statement.moduleSpecifier;\n\t\t\t\treturn moduleSpecifier && ts.isStringLiteral(moduleSpecifier) ? [moduleSpecifier.text] : [];\n\t\t\t});\n\n\t\tfor (const moduleSpecifier of moduleSpecifiers) {\n\t\t\tconst resolvedModulePath = ts.resolveModuleName(\n\t\t\t\tmoduleSpecifier,\n\t\t\t\tsourceFilePath,\n\t\t\t\tcompilerOptions,\n\t\t\t\tts.sys\n\t\t\t).resolvedModule?.resolvedFileName;\n\n\t\t\tif (resolvedModulePath) {\n\t\t\t\tconst declarationInModule =\n\t\t\t\t\tImportTypeQuerySchemaResolver.findVariableDeclarationInModuleGraph(\n\t\t\t\t\t\tresolvedModulePath,\n\t\t\t\t\t\tvariableName,\n\t\t\t\t\t\tvisitedFiles\n\t\t\t\t\t);\n\t\t\t\tif (declarationInModule) {\n\t\t\t\t\treturn declarationInModule;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Find an imported symbol reference by local identifier name.\n\t */\n\tprivate static findImportedValueReference(\n\t\tsourceFile: ts.SourceFile,\n\t\tlocalName: string\n\t):\n\t\t| {\n\t\t\t\tmoduleSpecifier: string;\n\t\t\t\timportedName: string;\n\t\t  }\n\t\t| undefined {\n\t\tfor (const statement of sourceFile.statements) {\n\t\t\tif (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {\n\t\t\t\tconst bindings = statement.importClause?.namedBindings;\n\t\t\t\tif (bindings && ts.isNamedImports(bindings)) {\n\t\t\t\t\tconst importElement = bindings.elements.find(el => el.name.text === localName);\n\t\t\t\t\tif (importElement) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tmoduleSpecifier: statement.moduleSpecifier.text,\n\t\t\t\t\t\t\timportedName: importElement.propertyName?.text ?? importElement.name.text\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Resolve an import declaration module specifier to a source file.\n\t */\n\tprivate static resolveImportDeclarationSourceFile(\n\t\tcontainingSourceFilePath: string,\n\t\tmoduleSpecifier: string\n\t): string | undefined {\n\t\tconst resolvedContainingSourceFilePath = FileUtils.resolvePath(containingSourceFilePath);\n\n\t\tif (moduleSpecifier.startsWith(\".\")) {\n\t\t\treturn (\n\t\t\t\tFileUtils.resolveImportSourceFilePath(resolvedContainingSourceFilePath, moduleSpecifier) ??\n\t\t\t\t(moduleSpecifier.endsWith(\".js\")\n\t\t\t\t\t? FileUtils.resolveImportSourceFilePath(\n\t\t\t\t\t\t\tresolvedContainingSourceFilePath,\n\t\t\t\t\t\t\t`${moduleSpecifier.slice(0, -3)}.ts`\n\t\t\t\t\t\t)\n\t\t\t\t\t: undefined)\n\t\t\t);\n\t\t}\n\n\t\tconst compilerOptions: ts.CompilerOptions = {\n\t\t\tmodule: ts.ModuleKind.NodeNext,\n\t\t\tmoduleResolution: ts.ModuleResolutionKind.NodeNext,\n\t\t\ttarget: ts.ScriptTarget.ESNext,\n\t\t\tskipLibCheck: true\n\t\t};\n\n\t\treturn ts.resolveModuleName(\n\t\t\tmoduleSpecifier,\n\t\t\tresolvedContainingSourceFilePath,\n\t\t\tcompilerOptions,\n\t\t\tts.sys\n\t\t).resolvedModule?.resolvedFileName;\n\t}\n\n\t/**\n\t * Extract a const-object property value from a declaration initializer.\n\t */\n\tprivate static extractConstObjectPropertyFromDeclarationInitializer(\n\t\tobjectDeclaration: ts.VariableDeclaration,\n\t\tpropertyName: string\n\t): string | number | undefined {\n\t\tif (!objectDeclaration.initializer) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tlet objLiteral: ts.ObjectLiteralExpression | undefined;\n\t\tif (ts.isObjectLiteralExpression(objectDeclaration.initializer)) {\n\t\t\tobjLiteral = objectDeclaration.initializer;\n\t\t} else if (\n\t\t\tts.isAsExpression(objectDeclaration.initializer) &&\n\t\t\tts.isObjectLiteralExpression(objectDeclaration.initializer.expression)\n\t\t) {\n\t\t\tobjLiteral = objectDeclaration.initializer.expression;\n\t\t}\n\n\t\tif (!objLiteral) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst prop = objLiteral.properties\n\t\t\t.filter((p): p is ts.PropertyAssignment => ts.isPropertyAssignment(p))\n\t\t\t.find(p => ts.isIdentifier(p.name) && p.name.text === propertyName);\n\n\t\tif (!prop) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tif (ts.isStringLiteral(prop.initializer)) {\n\t\t\treturn prop.initializer.text;\n\t\t}\n\t\tif (ts.isNumericLiteral(prop.initializer)) {\n\t\t\treturn Number(prop.initializer.text);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Extract a const-object property value from a declaration type annotation.\n\t */\n\tprivate static extractConstObjectPropertyFromDeclarationType(\n\t\tdeclarationTypeNode: ts.TypeNode,\n\t\tpropertyName: string\n\t): string | number | undefined {\n\t\tif (ts.isParenthesizedTypeNode(declarationTypeNode)) {\n\t\t\treturn ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(\n\t\t\t\tdeclarationTypeNode.type,\n\t\t\t\tpropertyName\n\t\t\t);\n\t\t}\n\n\t\tif (\n\t\t\tts.isTypeOperatorNode(declarationTypeNode) &&\n\t\t\tdeclarationTypeNode.operator === ts.SyntaxKind.ReadonlyKeyword\n\t\t) {\n\t\t\treturn ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(\n\t\t\t\tdeclarationTypeNode.type,\n\t\t\t\tpropertyName\n\t\t\t);\n\t\t}\n\n\t\tif (\n\t\t\tts.isTypeReferenceNode(declarationTypeNode) &&\n\t\t\tts.isIdentifier(declarationTypeNode.typeName) &&\n\t\t\tdeclarationTypeNode.typeName.text === \"Readonly\" &&\n\t\t\tIs.arrayValue(declarationTypeNode.typeArguments)\n\t\t) {\n\t\t\treturn ImportTypeQuerySchemaResolver.extractConstObjectPropertyFromDeclarationType(\n\t\t\t\tdeclarationTypeNode.typeArguments[0],\n\t\t\t\tpropertyName\n\t\t\t);\n\t\t}\n\n\t\tif (ts.isTypeLiteralNode(declarationTypeNode)) {\n\t\t\tconst propertySignature = declarationTypeNode.members.find(\n\t\t\t\t(member): member is ts.PropertySignature => {\n\t\t\t\t\tif (!ts.isPropertySignature(member) || !member.name) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\n\t\t\t\t\treturn (\n\t\t\t\t\t\t(ts.isIdentifier(member.name) && member.name.text === propertyName) ||\n\t\t\t\t\t\t(ts.isStringLiteral(member.name) && member.name.text === propertyName) ||\n\t\t\t\t\t\t(ts.isNumericLiteral(member.name) && member.name.text === propertyName)\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t);\n\n\t\t\tif (propertySignature?.type) {\n\t\t\t\treturn ImportTypeQuerySchemaResolver.extractLiteralValueFromTypeNode(\n\t\t\t\t\tpropertySignature.type\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Extract a literal value from a type node when possible.\n\t */\n\tprivate static extractLiteralValueFromTypeNode(\n\t\ttypeNode: ts.TypeNode\n\t): string | number | undefined {\n\t\tif (ts.isLiteralTypeNode(typeNode)) {\n\t\t\tif (ts.isStringLiteral(typeNode.literal)) {\n\t\t\t\treturn typeNode.literal.text;\n\t\t\t}\n\n\t\t\tif (ts.isNumericLiteral(typeNode.literal)) {\n\t\t\t\treturn Number(typeNode.literal.text);\n\t\t\t}\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Extract a referenced type name from an import type qualifier.\n\t */\n\tprivate static extractImportTypeName(qualifier: ts.EntityName | undefined): string | undefined {\n\t\tif (!qualifier) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tif (ts.isIdentifier(qualifier)) {\n\t\t\treturn qualifier.text;\n\t\t}\n\n\t\treturn qualifier.right.text;\n\t}\n}\n"]}

package/dist/es/utils/indexSignaturePatternResolver.js

@@ -0,0 +1,94 @@
+// Copyright 2026 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import * as ts from "typescript";
+import { TemplateLiteralPatternBuilder } from "./templateLiteralPatternBuilder.js";
+/**
+ * Resolves regex patterns for index signature key types.
+ */
+export class IndexSignaturePatternResolver {
+    /**
+     * Determine whether an index signature can be represented as JSON object additionalProperties.
+     * @param member The index signature declaration.
+     * @returns True if supported.
+     */
+    static isSupportedIndexSignature(member) {
+        // [key: string]: Value  (index signature, first parameter is the key)
+        const indexParameter = member.parameters[0];
+        if (!indexParameter?.type) {
+            return false;
+        }
+        // [key: string]: Value  or  [key: number]: Value  (string or numeric key)
+        return (indexParameter.type.kind === ts.SyntaxKind.StringKeyword ||
+            indexParameter.type.kind === ts.SyntaxKind.NumberKeyword);
+    }
+    /**
+     * Extract a regex pattern for an index signature key type when representable.
+     * @param context The generation context.
+     * @param member The index signature declaration.
+     * @param getTypeParameterBinding Callback for resolving generic bindings.
+     * @returns The property-name pattern, if derivable.
+     */
+    static extractIndexSignaturePattern(context, member, getTypeParameterBinding) {
+        const indexParameterType = member.parameters[0]?.type;
+        if (!indexParameterType) {
+            return undefined;
+        }
+        const resolvedTemplateType = IndexSignaturePatternResolver.resolveTemplateLiteralTypeNode(context, indexParameterType, new Set(), getTypeParameterBinding);
+        return resolvedTemplateType
+            ? TemplateLiteralPatternBuilder.buildTemplateLiteralPattern(resolvedTemplateType)
+            : undefined;
+    }
+    /**
+     * Resolve a template literal type node from a key-type expression.
+     * Handles parenthesised, readonly-wrapped, and type-aliased variants by recursing.
+     * A cycle guard via resolvingTypeNames prevents unbounded recursion on self-referential types.
+     * @param context The generation context.
+     * @param typeNode The key type node.
+     * @param resolvingTypeNames Type names currently being resolved.
+     * @param getTypeParameterBinding Callback for resolving generic bindings.
+     * @returns A template literal type node when resolvable.
+     * @internal
+     */
+    static resolveTemplateLiteralTypeNode(context, typeNode, resolvingTypeNames, getTypeParameterBinding) {
+        // `prefix-${T}` or `${K}`  (already a template literal type)
+        if (ts.isTemplateLiteralTypeNode(typeNode)) {
+            return typeNode;
+        }
+        // (KeyType)  (parenthesised type, unwrap and recurse)
+        if (ts.isParenthesizedTypeNode(typeNode)) {
+            return IndexSignaturePatternResolver.resolveTemplateLiteralTypeNode(context, typeNode.type, resolvingTypeNames, getTypeParameterBinding);
+        }
+        // readonly KeyType  (readonly-wrapped type operator, strip modifier and recurse)
+        if (ts.isTypeOperatorNode(typeNode) && typeNode.operator === ts.SyntaxKind.ReadonlyKeyword) {
+            return IndexSignaturePatternResolver.resolveTemplateLiteralTypeNode(context, typeNode.type, resolvingTypeNames, getTypeParameterBinding);
+        }
+        // MyKeyType  (named type reference, resolve via binding or type alias in source file)
+        if (ts.isTypeReferenceNode(typeNode)) {
+            // Namespace.TypeName  (qualified name) or TypeName  (plain identifier)
+            const typeName = ts.isIdentifier(typeNode.typeName)
+                ? typeNode.typeName.text
+                : typeNode.typeName.right.text;
+            if (resolvingTypeNames.has(typeName)) {
+                return undefined;
+            }
+            const typeParameterBinding = getTypeParameterBinding(context, typeName);
+            if (typeParameterBinding) {
+                return IndexSignaturePatternResolver.resolveTemplateLiteralTypeNode(context, typeParameterBinding, resolvingTypeNames, getTypeParameterBinding);
+            }
+            const sourceFile = context.activeSourceFile;
+            if (!sourceFile) {
+                return undefined;
+            }
+            // type MyKeyType = `prefix-${string}`  (look up a type alias in the active source file)
+            const typeAlias = sourceFile.statements.find((statement) => ts.isTypeAliasDeclaration(statement) && statement.name.text === typeName);
+            if (typeAlias) {
+                resolvingTypeNames.add(typeName);
+                const resolvedTemplateType = IndexSignaturePatternResolver.resolveTemplateLiteralTypeNode(context, typeAlias.type, resolvingTypeNames, getTypeParameterBinding);
+                resolvingTypeNames.delete(typeName);
+                return resolvedTemplateType;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=indexSignaturePatternResolver.js.map