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

package/dist/es/utils/utilityTypeSchemaMapper.js

@@ -0,0 +1,412 @@
+// Copyright 2026 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/* eslint-disable jsdoc/require-param, jsdoc/require-returns */
+import { JsonHelper, ObjectHelper } from "@twin.org/core";
+import * as ts from "typescript";
+import { ObjectTransformer } from "./objectTransformer.js";
+/**
+ * Static utility-type schema mapping helpers.
+ */
+export class UtilityTypeSchemaMapper {
+    /**
+     * Map Partial<T> to an object schema with no required properties.
+     * @param context The generation context.
+     * @param typeNode The Partial type reference.
+     * @param resolveUtilityBaseObjectSchema Callback to resolve base object schemas.
+     * @returns The mapped schema.
+     */
+    static mapPartialUtilityType(context, typeNode, resolveUtilityBaseObjectSchema) {
+        const baseTypeNode = typeNode.typeArguments?.[0];
+        if (!baseTypeNode) {
+            return undefined;
+        }
+        const objectSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);
+        if (objectSchema) {
+            const partialSchema = ObjectTransformer.toInlineUtilityObjectSchema(objectSchema);
+            delete partialSchema.required;
+            return partialSchema;
+        }
+        return undefined;
+    }
+    /**
+     * Map Required<T> to an object schema with all properties required.
+     * @param context The generation context.
+     * @param typeNode The Required type reference.
+     * @param resolveUtilityBaseObjectSchema Callback to resolve base object schemas.
+     * @returns The mapped schema.
+     */
+    static mapRequiredUtilityType(context, typeNode, resolveUtilityBaseObjectSchema) {
+        const baseTypeNode = typeNode.typeArguments?.[0];
+        if (!baseTypeNode) {
+            return undefined;
+        }
+        const objectSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);
+        if (objectSchema) {
+            const requiredSchema = ObjectTransformer.toInlineUtilityObjectSchema(objectSchema);
+            if (requiredSchema.properties) {
+                requiredSchema.required = Object.keys(requiredSchema.properties);
+            }
+            return requiredSchema;
+        }
+        return undefined;
+    }
+    /**
+     * Map Pick<T, K> to an object schema with selected keys preserved.
+     */
+    static mapPickUtilityType(context, typeNode, resolveUtilityBaseObjectSchema, extractUtilityTypeKeys) {
+        const baseTypeNode = typeNode.typeArguments?.[0];
+        const pickedKeys = extractUtilityTypeKeys(context, typeNode.typeArguments?.[1]);
+        if (!baseTypeNode || pickedKeys.length === 0) {
+            return undefined;
+        }
+        const baseSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);
+        if (baseSchema) {
+            return ObjectTransformer.pickKeysFromObjectSchema(baseSchema, pickedKeys);
+        }
+        return undefined;
+    }
+    /**
+     * Map Omit<T, K> to an object schema with selected keys removed.
+     */
+    static mapOmitUtilityType(context, typeNode, resolveUtilityBaseObjectSchema, extractUtilityTypeKeys) {
+        const baseTypeNode = typeNode.typeArguments?.[0];
+        const omittedKeys = extractUtilityTypeKeys(context, typeNode.typeArguments?.[1]);
+        if (!baseTypeNode || omittedKeys.length === 0) {
+            return undefined;
+        }
+        const baseSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);
+        if (baseSchema) {
+            return ObjectTransformer.omitKeysFromObjectSchema(baseSchema, omittedKeys);
+        }
+        return undefined;
+    }
+    /**
+     * Map Exclude<T, U> to a schema that removes U members from T.
+     */
+    static mapExcludeUtilityType(context, typeNode, mapTypeNodeToSchema) {
+        const sourceTypeNode = typeNode.typeArguments?.[0];
+        const excludedTypeNode = typeNode.typeArguments?.[1];
+        if (!sourceTypeNode || !excludedTypeNode) {
+            return undefined;
+        }
+        const sourceTypes = ts.isUnionTypeNode(sourceTypeNode)
+            ? sourceTypeNode.types
+            : [sourceTypeNode];
+        const excludedTypes = ts.isUnionTypeNode(excludedTypeNode)
+            ? excludedTypeNode.types
+            : [excludedTypeNode];
+        const sourceSchemas = sourceTypes
+            .map(sourceType => mapTypeNodeToSchema(context, sourceType))
+            .filter((schema) => schema !== undefined);
+        const excludedSchemas = excludedTypes
+            .map(excludedType => mapTypeNodeToSchema(context, excludedType))
+            .filter((schema) => schema !== undefined)
+            .map(schema => JsonHelper.canonicalize(schema));
+        if (sourceSchemas.length === 0) {
+            return undefined;
+        }
+        const excludedSchemaKeys = new Set(excludedSchemas);
+        const remainingSchemas = sourceSchemas.filter(schema => !excludedSchemaKeys.has(JsonHelper.canonicalize(schema)));
+        if (remainingSchemas.length === 0) {
+            return undefined;
+        }
+        if (remainingSchemas.length === 1) {
+            return remainingSchemas[0];
+        }
+        return {
+            anyOf: remainingSchemas
+        };
+    }
+    /**
+     * Map Extract<T, U> to a schema that keeps U members from T.
+     */
+    static mapExtractUtilityType(context, typeNode, mapTypeNodeToSchema) {
+        const sourceTypeNode = typeNode.typeArguments?.[0];
+        const includedTypeNode = typeNode.typeArguments?.[1];
+        if (!sourceTypeNode || !includedTypeNode) {
+            return undefined;
+        }
+        const sourceTypes = ts.isUnionTypeNode(sourceTypeNode)
+            ? sourceTypeNode.types
+            : [sourceTypeNode];
+        const includedTypes = ts.isUnionTypeNode(includedTypeNode)
+            ? includedTypeNode.types
+            : [includedTypeNode];
+        const sourceSchemas = sourceTypes
+            .map(sourceType => mapTypeNodeToSchema(context, sourceType))
+            .filter((schema) => schema !== undefined);
+        const includedSchemaKeys = new Set(includedTypes
+            .map(includedType => mapTypeNodeToSchema(context, includedType))
+            .filter((schema) => schema !== undefined)
+            .map(schema => JsonHelper.canonicalize(schema)));
+        if (sourceSchemas.length === 0 || includedSchemaKeys.size === 0) {
+            return undefined;
+        }
+        const matchedSchemas = sourceSchemas.filter(schema => includedSchemaKeys.has(JsonHelper.canonicalize(schema)));
+        if (matchedSchemas.length === 0) {
+            return undefined;
+        }
+        if (matchedSchemas.length === 1) {
+            return matchedSchemas[0];
+        }
+        return {
+            anyOf: matchedSchemas
+        };
+    }
+    /**
+     * Map NonNullable<T> by removing null and undefined branches from T.
+     */
+    static mapNonNullableUtilityType(context, typeNode, mapTypeNodeToSchema) {
+        const sourceTypeNode = typeNode.typeArguments?.[0];
+        if (!sourceTypeNode) {
+            return undefined;
+        }
+        const sourceTypes = ts.isUnionTypeNode(sourceTypeNode)
+            ? sourceTypeNode.types
+            : [sourceTypeNode];
+        const nonNullableTypes = sourceTypes.filter(sourceType => !UtilityTypeSchemaMapper.isNullOrUndefinedTypeNode(sourceType));
+        if (nonNullableTypes.length === 0) {
+            return undefined;
+        }
+        const mappedSchemas = nonNullableTypes
+            .map(sourceType => mapTypeNodeToSchema(context, sourceType))
+            .filter((schema) => schema !== undefined);
+        if (mappedSchemas.length === 0) {
+            return undefined;
+        }
+        if (mappedSchemas.length === 1) {
+            return mappedSchemas[0];
+        }
+        const uniqueSchemas = mappedSchemas.filter((schema, index, allSchemas) => {
+            const schemaKey = JsonHelper.canonicalize(schema);
+            return allSchemas.findIndex(s => JsonHelper.canonicalize(s) === schemaKey) === index;
+        });
+        if (uniqueSchemas.length === 1) {
+            return uniqueSchemas[0];
+        }
+        return {
+            anyOf: uniqueSchemas
+        };
+    }
+    /**
+     * Map Record<K, V> to an object schema with key constraints where possible.
+     */
+    static mapRecordUtilityType(context, typeNode, mapTypeNodeToSchema) {
+        const keyTypeNode = typeNode.typeArguments?.[0];
+        const valueTypeNode = typeNode.typeArguments?.[1];
+        if (!keyTypeNode || !valueTypeNode) {
+            return undefined;
+        }
+        const valueSchema = mapTypeNodeToSchema(context, valueTypeNode);
+        if (!valueSchema) {
+            return undefined;
+        }
+        const recordLiteralKeys = UtilityTypeSchemaMapper.extractRecordLiteralKeys(keyTypeNode);
+        if (recordLiteralKeys.length > 0) {
+            const properties = {};
+            for (const key of recordLiteralKeys) {
+                properties[key] = ObjectHelper.clone(valueSchema);
+            }
+            return {
+                type: "object",
+                properties,
+                required: recordLiteralKeys
+            };
+        }
+        return {
+            type: "object",
+            additionalProperties: valueSchema
+        };
+    }
+    /**
+     * Map JsonLdObject utility types using key-removal and optional key-addition rules.
+     */
+    static mapJsonLdObjectUtilityType(context, typeNode, options, resolveUtilityBaseObjectSchema, mapTypeNodeToSchema) {
+        const baseTypeNode = typeNode.typeArguments?.[0];
+        if (!baseTypeNode) {
+            return undefined;
+        }
+        const baseSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);
+        if (!baseSchema) {
+            return undefined;
+        }
+        const mappedSchema = ObjectTransformer.omitKeysFromObjectSchema(baseSchema, options.keysToRemove);
+        if (!options.keyToAdd) {
+            return mappedSchema;
+        }
+        const valueTypeNode = typeNode.typeArguments?.[1];
+        const valueSchema = valueTypeNode
+            ? mapTypeNodeToSchema(context, valueTypeNode)
+            : UtilityTypeSchemaMapper.mapJsonLdObjectDefaultSchemaByKey(baseSchema, options.keyToAdd);
+        if (!valueSchema) {
+            return undefined;
+        }
+        mappedSchema.type = "object";
+        mappedSchema.properties ??= {};
+        mappedSchema.properties[options.keyToAdd] = valueSchema;
+        if (options.isAddedKeyRequired) {
+            const requiredKeys = new Set(mappedSchema.required ?? []);
+            requiredKeys.add(options.keyToAdd);
+            mappedSchema.required = [...requiredKeys];
+        }
+        return mappedSchema;
+    }
+    /**
+     * Map ObjectOrArray<T> to a schema accepting T or T[].
+     */
+    static mapObjectOrArrayUtilityType(context, typeNode, mapTypeNodeToSchema) {
+        const baseTypeNode = typeNode.typeArguments?.[0];
+        if (!baseTypeNode) {
+            return undefined;
+        }
+        const itemSchema = mapTypeNodeToSchema(context, baseTypeNode);
+        if (!itemSchema) {
+            return undefined;
+        }
+        const scalarSchemas = Array.isArray(itemSchema.anyOf) && Object.keys(itemSchema).length === 1
+            ? itemSchema.anyOf
+            : [itemSchema];
+        return {
+            anyOf: [...scalarSchemas, { type: "array", items: itemSchema }]
+        };
+    }
+    /**
+     * Map SingleOccurrenceArray<T, U> to a non-empty array containing exactly one U.
+     */
+    static mapSingleOccurrenceArrayUtilityType(context, typeNode, mapTypeNodeToSchema) {
+        const primaryTypeNode = typeNode.typeArguments?.[0];
+        if (!primaryTypeNode) {
+            return undefined;
+        }
+        const primarySchema = mapTypeNodeToSchema(context, primaryTypeNode);
+        if (!primarySchema) {
+            return undefined;
+        }
+        const singleOccurrenceTypeNode = typeNode.typeArguments?.[1];
+        if (!singleOccurrenceTypeNode) {
+            return {
+                type: "array",
+                items: primarySchema,
+                minItems: 1
+            };
+        }
+        const singleOccurrenceSchema = mapTypeNodeToSchema(context, singleOccurrenceTypeNode);
+        if (!singleOccurrenceSchema) {
+            return {
+                type: "array",
+                items: primarySchema,
+                minItems: 1
+            };
+        }
+        if (JsonHelper.canonicalize(primarySchema) === JsonHelper.canonicalize(singleOccurrenceSchema)) {
+            return {
+                type: "array",
+                items: primarySchema,
+                minItems: 1
+            };
+        }
+        const itemSchema = {
+            anyOf: [primarySchema, singleOccurrenceSchema]
+        };
+        return {
+            type: "array",
+            items: itemSchema,
+            contains: singleOccurrenceSchema,
+            minContains: 1,
+            maxContains: 1,
+            minItems: 1
+        };
+    }
+    /**
+     * Determine whether a type node represents null or undefined.
+     */
+    static isNullOrUndefinedTypeNode(typeNode) {
+        if (typeNode.kind === ts.SyntaxKind.NullKeyword ||
+            typeNode.kind === ts.SyntaxKind.UndefinedKeyword) {
+            return true;
+        }
+        if (ts.isLiteralTypeNode(typeNode)) {
+            return typeNode.literal.kind === ts.SyntaxKind.NullKeyword;
+        }
+        if (ts.isTypeReferenceNode(typeNode) && ts.isIdentifier(typeNode.typeName)) {
+            return typeNode.typeName.text === "undefined";
+        }
+        return false;
+    }
+    /**
+     * Extract literal keys from a Record key type argument.
+     */
+    static extractRecordLiteralKeys(keyTypeNode) {
+        if (ts.isLiteralTypeNode(keyTypeNode) && ts.isStringLiteral(keyTypeNode.literal)) {
+            return [keyTypeNode.literal.text];
+        }
+        if (ts.isUnionTypeNode(keyTypeNode)) {
+            const keys = keyTypeNode.types
+                .filter(type => ts.isLiteralTypeNode(type) && ts.isStringLiteral(type.literal))
+                .map(type => type.literal)
+                .map(literal => literal.text);
+            return keys.length === keyTypeNode.types.length ? keys : [];
+        }
+        return [];
+    }
+    /**
+     * Resolve a default schema for JsonLdObject utility key additions when the type argument is omitted.
+     */
+    static mapJsonLdObjectDefaultSchemaByKey(baseSchema, keyToAdd) {
+        if (keyToAdd === "id" || keyToAdd === "@id") {
+            return UtilityTypeSchemaMapper.mapJsonLdObjectWithIdDefaultIdSchema(baseSchema);
+        }
+        if (keyToAdd === "@context") {
+            return UtilityTypeSchemaMapper.mapJsonLdObjectWithContextDefaultContextSchema(baseSchema);
+        }
+        return UtilityTypeSchemaMapper.mapJsonLdObjectWithTypeDefaultTypeSchema(baseSchema);
+    }
+    /**
+     * Resolve default id schema for JsonLdObjectWithId when Id type argument is omitted.
+     */
+    static mapJsonLdObjectWithIdDefaultIdSchema(baseSchema) {
+        return UtilityTypeSchemaMapper.mapJsonLdObjectDefaultEitherSchema(baseSchema, "id", "@id", {
+            type: "string"
+        });
+    }
+    /**
+     * Resolve default type schema for JsonLdObjectWithType when Type argument is omitted.
+     */
+    static mapJsonLdObjectWithTypeDefaultTypeSchema(baseSchema) {
+        return UtilityTypeSchemaMapper.mapJsonLdObjectDefaultEitherSchema(baseSchema, "type", "@type", {
+            anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }]
+        });
+    }
+    /**
+     * Resolve default context schema for JsonLdObjectWithContext when Context argument is omitted.
+     */
+    static mapJsonLdObjectWithContextDefaultContextSchema(baseSchema) {
+        return UtilityTypeSchemaMapper.mapJsonLdObjectDefaultEitherSchema(baseSchema, "@context", "@context", {
+            type: "array",
+            items: { type: "string" }
+        });
+    }
+    /**
+     * Resolve default schema from either of two source keys, with fallback when both are absent.
+     */
+    static mapJsonLdObjectDefaultEitherSchema(baseSchema, firstKey, secondKey, fallbackSchema) {
+        const firstSchema = ObjectTransformer.resolvePropertySchemaFromObjectSchema(baseSchema, firstKey);
+        const secondSchema = ObjectTransformer.resolvePropertySchemaFromObjectSchema(baseSchema, secondKey);
+        if (firstSchema && secondSchema) {
+            if (JsonHelper.canonicalize(firstSchema) === JsonHelper.canonicalize(secondSchema)) {
+                return firstSchema;
+            }
+            return {
+                anyOf: [firstSchema, secondSchema]
+            };
+        }
+        if (firstSchema) {
+            return firstSchema;
+        }
+        if (secondSchema) {
+            return secondSchema;
+        }
+        return fallbackSchema;
+    }
+}
+//# sourceMappingURL=utilityTypeSchemaMapper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utilityTypeSchemaMapper.js","sourceRoot":"","sources":["../../../src/utils/utilityTypeSchemaMapper.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n/* eslint-disable jsdoc/require-param, jsdoc/require-returns */\nimport { JsonHelper, ObjectHelper } from \"@twin.org/core\";\nimport type { IJsonSchema } from \"@twin.org/tools-models\";\nimport * as ts from \"typescript\";\nimport { ObjectTransformer } from \"./objectTransformer.js\";\nimport type { ITypeScriptToSchemaContext } from \"../models/ITypeScriptToSchemaContext.js\";\n\n/**\n * Static utility-type schema mapping helpers.\n */\nexport class UtilityTypeSchemaMapper {\n\t/**\n\t * Map Partial<T> to an object schema with no required properties.\n\t * @param context The generation context.\n\t * @param typeNode The Partial type reference.\n\t * @param resolveUtilityBaseObjectSchema Callback to resolve base object schemas.\n\t * @returns The mapped schema.\n\t */\n\tpublic static mapPartialUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tresolveUtilityBaseObjectSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\tbaseTypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst baseTypeNode = typeNode.typeArguments?.[0];\n\t\tif (!baseTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst objectSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);\n\t\tif (objectSchema) {\n\t\t\tconst partialSchema = ObjectTransformer.toInlineUtilityObjectSchema(objectSchema);\n\t\t\tdelete partialSchema.required;\n\t\t\treturn partialSchema;\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Map Required<T> to an object schema with all properties required.\n\t * @param context The generation context.\n\t * @param typeNode The Required type reference.\n\t * @param resolveUtilityBaseObjectSchema Callback to resolve base object schemas.\n\t * @returns The mapped schema.\n\t */\n\tpublic static mapRequiredUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tresolveUtilityBaseObjectSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\tbaseTypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst baseTypeNode = typeNode.typeArguments?.[0];\n\t\tif (!baseTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst objectSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);\n\t\tif (objectSchema) {\n\t\t\tconst requiredSchema = ObjectTransformer.toInlineUtilityObjectSchema(objectSchema);\n\t\t\tif (requiredSchema.properties) {\n\t\t\t\trequiredSchema.required = Object.keys(requiredSchema.properties);\n\t\t\t}\n\t\t\treturn requiredSchema;\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Map Pick<T, K> to an object schema with selected keys preserved.\n\t */\n\tpublic static mapPickUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tresolveUtilityBaseObjectSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\tbaseTypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined,\n\t\textractUtilityTypeKeys: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\tkeysNode: ts.TypeNode | undefined\n\t\t) => string[]\n\t): IJsonSchema | undefined {\n\t\tconst baseTypeNode = typeNode.typeArguments?.[0];\n\t\tconst pickedKeys = extractUtilityTypeKeys(context, typeNode.typeArguments?.[1]);\n\t\tif (!baseTypeNode || pickedKeys.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst baseSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);\n\t\tif (baseSchema) {\n\t\t\treturn ObjectTransformer.pickKeysFromObjectSchema(baseSchema, pickedKeys);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Map Omit<T, K> to an object schema with selected keys removed.\n\t */\n\tpublic static mapOmitUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tresolveUtilityBaseObjectSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\tbaseTypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined,\n\t\textractUtilityTypeKeys: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\tkeysNode: ts.TypeNode | undefined\n\t\t) => string[]\n\t): IJsonSchema | undefined {\n\t\tconst baseTypeNode = typeNode.typeArguments?.[0];\n\t\tconst omittedKeys = extractUtilityTypeKeys(context, typeNode.typeArguments?.[1]);\n\t\tif (!baseTypeNode || omittedKeys.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst baseSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);\n\t\tif (baseSchema) {\n\t\t\treturn ObjectTransformer.omitKeysFromObjectSchema(baseSchema, omittedKeys);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Map Exclude<T, U> to a schema that removes U members from T.\n\t */\n\tpublic static mapExcludeUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tmapTypeNodeToSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\ttypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst sourceTypeNode = typeNode.typeArguments?.[0];\n\t\tconst excludedTypeNode = typeNode.typeArguments?.[1];\n\t\tif (!sourceTypeNode || !excludedTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst sourceTypes = ts.isUnionTypeNode(sourceTypeNode)\n\t\t\t? sourceTypeNode.types\n\t\t\t: [sourceTypeNode];\n\t\tconst excludedTypes = ts.isUnionTypeNode(excludedTypeNode)\n\t\t\t? excludedTypeNode.types\n\t\t\t: [excludedTypeNode];\n\n\t\tconst sourceSchemas = sourceTypes\n\t\t\t.map(sourceType => mapTypeNodeToSchema(context, sourceType))\n\t\t\t.filter((schema): schema is IJsonSchema => schema !== undefined);\n\t\tconst excludedSchemas = excludedTypes\n\t\t\t.map(excludedType => mapTypeNodeToSchema(context, excludedType))\n\t\t\t.filter((schema): schema is IJsonSchema => schema !== undefined)\n\t\t\t.map(schema => JsonHelper.canonicalize(schema));\n\n\t\tif (sourceSchemas.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst excludedSchemaKeys = new Set(excludedSchemas);\n\t\tconst remainingSchemas = sourceSchemas.filter(\n\t\t\tschema => !excludedSchemaKeys.has(JsonHelper.canonicalize(schema))\n\t\t);\n\n\t\tif (remainingSchemas.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tif (remainingSchemas.length === 1) {\n\t\t\treturn remainingSchemas[0];\n\t\t}\n\n\t\treturn {\n\t\t\tanyOf: remainingSchemas\n\t\t};\n\t}\n\n\t/**\n\t * Map Extract<T, U> to a schema that keeps U members from T.\n\t */\n\tpublic static mapExtractUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tmapTypeNodeToSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\ttypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst sourceTypeNode = typeNode.typeArguments?.[0];\n\t\tconst includedTypeNode = typeNode.typeArguments?.[1];\n\t\tif (!sourceTypeNode || !includedTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst sourceTypes = ts.isUnionTypeNode(sourceTypeNode)\n\t\t\t? sourceTypeNode.types\n\t\t\t: [sourceTypeNode];\n\t\tconst includedTypes = ts.isUnionTypeNode(includedTypeNode)\n\t\t\t? includedTypeNode.types\n\t\t\t: [includedTypeNode];\n\n\t\tconst sourceSchemas = sourceTypes\n\t\t\t.map(sourceType => mapTypeNodeToSchema(context, sourceType))\n\t\t\t.filter((schema): schema is IJsonSchema => schema !== undefined);\n\t\tconst includedSchemaKeys = new Set(\n\t\t\tincludedTypes\n\t\t\t\t.map(includedType => mapTypeNodeToSchema(context, includedType))\n\t\t\t\t.filter((schema): schema is IJsonSchema => schema !== undefined)\n\t\t\t\t.map(schema => JsonHelper.canonicalize(schema))\n\t\t);\n\n\t\tif (sourceSchemas.length === 0 || includedSchemaKeys.size === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst matchedSchemas = sourceSchemas.filter(schema =>\n\t\t\tincludedSchemaKeys.has(JsonHelper.canonicalize(schema))\n\t\t);\n\n\t\tif (matchedSchemas.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tif (matchedSchemas.length === 1) {\n\t\t\treturn matchedSchemas[0];\n\t\t}\n\n\t\treturn {\n\t\t\tanyOf: matchedSchemas\n\t\t};\n\t}\n\n\t/**\n\t * Map NonNullable<T> by removing null and undefined branches from T.\n\t */\n\tpublic static mapNonNullableUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tmapTypeNodeToSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\ttypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst sourceTypeNode = typeNode.typeArguments?.[0];\n\t\tif (!sourceTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst sourceTypes = ts.isUnionTypeNode(sourceTypeNode)\n\t\t\t? sourceTypeNode.types\n\t\t\t: [sourceTypeNode];\n\t\tconst nonNullableTypes = sourceTypes.filter(\n\t\t\tsourceType => !UtilityTypeSchemaMapper.isNullOrUndefinedTypeNode(sourceType)\n\t\t);\n\n\t\tif (nonNullableTypes.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst mappedSchemas = nonNullableTypes\n\t\t\t.map(sourceType => mapTypeNodeToSchema(context, sourceType))\n\t\t\t.filter((schema): schema is IJsonSchema => schema !== undefined);\n\n\t\tif (mappedSchemas.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tif (mappedSchemas.length === 1) {\n\t\t\treturn mappedSchemas[0];\n\t\t}\n\n\t\tconst uniqueSchemas = mappedSchemas.filter((schema, index, allSchemas) => {\n\t\t\tconst schemaKey = JsonHelper.canonicalize(schema);\n\t\t\treturn allSchemas.findIndex(s => JsonHelper.canonicalize(s) === schemaKey) === index;\n\t\t});\n\n\t\tif (uniqueSchemas.length === 1) {\n\t\t\treturn uniqueSchemas[0];\n\t\t}\n\n\t\treturn {\n\t\t\tanyOf: uniqueSchemas\n\t\t};\n\t}\n\n\t/**\n\t * Map Record<K, V> to an object schema with key constraints where possible.\n\t */\n\tpublic static mapRecordUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tmapTypeNodeToSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\ttypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst keyTypeNode = typeNode.typeArguments?.[0];\n\t\tconst valueTypeNode = typeNode.typeArguments?.[1];\n\t\tif (!keyTypeNode || !valueTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst valueSchema = mapTypeNodeToSchema(context, valueTypeNode);\n\t\tif (!valueSchema) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst recordLiteralKeys = UtilityTypeSchemaMapper.extractRecordLiteralKeys(keyTypeNode);\n\t\tif (recordLiteralKeys.length > 0) {\n\t\t\tconst properties: { [key: string]: IJsonSchema } = {};\n\t\t\tfor (const key of recordLiteralKeys) {\n\t\t\t\tproperties[key] = ObjectHelper.clone(valueSchema);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\ttype: \"object\",\n\t\t\t\tproperties,\n\t\t\t\trequired: recordLiteralKeys\n\t\t\t};\n\t\t}\n\n\t\treturn {\n\t\t\ttype: \"object\",\n\t\t\tadditionalProperties: valueSchema\n\t\t};\n\t}\n\n\t/**\n\t * Map JsonLdObject utility types using key-removal and optional key-addition rules.\n\t */\n\tpublic static mapJsonLdObjectUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\toptions: {\n\t\t\tkeysToRemove: string[];\n\t\t\tkeyToAdd?: \"id\" | \"@id\" | \"type\" | \"@type\" | \"@context\";\n\t\t\tisAddedKeyRequired?: boolean;\n\t\t},\n\t\tresolveUtilityBaseObjectSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\tbaseTypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined,\n\t\tmapTypeNodeToSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\ttypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst baseTypeNode = typeNode.typeArguments?.[0];\n\t\tif (!baseTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst baseSchema = resolveUtilityBaseObjectSchema(context, baseTypeNode);\n\t\tif (!baseSchema) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst mappedSchema = ObjectTransformer.omitKeysFromObjectSchema(\n\t\t\tbaseSchema,\n\t\t\toptions.keysToRemove\n\t\t);\n\t\tif (!options.keyToAdd) {\n\t\t\treturn mappedSchema;\n\t\t}\n\n\t\tconst valueTypeNode = typeNode.typeArguments?.[1];\n\t\tconst valueSchema = valueTypeNode\n\t\t\t? mapTypeNodeToSchema(context, valueTypeNode)\n\t\t\t: UtilityTypeSchemaMapper.mapJsonLdObjectDefaultSchemaByKey(baseSchema, options.keyToAdd);\n\t\tif (!valueSchema) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tmappedSchema.type = \"object\";\n\t\tmappedSchema.properties ??= {};\n\t\tmappedSchema.properties[options.keyToAdd] = valueSchema;\n\n\t\tif (options.isAddedKeyRequired) {\n\t\t\tconst requiredKeys = new Set(mappedSchema.required ?? []);\n\t\t\trequiredKeys.add(options.keyToAdd);\n\t\t\tmappedSchema.required = [...requiredKeys];\n\t\t}\n\n\t\treturn mappedSchema;\n\t}\n\n\t/**\n\t * Map ObjectOrArray<T> to a schema accepting T or T[].\n\t */\n\tpublic static mapObjectOrArrayUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tmapTypeNodeToSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\ttypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst baseTypeNode = typeNode.typeArguments?.[0];\n\t\tif (!baseTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst itemSchema = mapTypeNodeToSchema(context, baseTypeNode);\n\t\tif (!itemSchema) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst scalarSchemas =\n\t\t\tArray.isArray(itemSchema.anyOf) && Object.keys(itemSchema).length === 1\n\t\t\t\t? itemSchema.anyOf\n\t\t\t\t: [itemSchema];\n\n\t\treturn {\n\t\t\tanyOf: [...scalarSchemas, { type: \"array\", items: itemSchema }]\n\t\t};\n\t}\n\n\t/**\n\t * Map SingleOccurrenceArray<T, U> to a non-empty array containing exactly one U.\n\t */\n\tpublic static mapSingleOccurrenceArrayUtilityType(\n\t\tcontext: ITypeScriptToSchemaContext,\n\t\ttypeNode: ts.TypeReferenceNode,\n\t\tmapTypeNodeToSchema: (\n\t\t\tcontext: ITypeScriptToSchemaContext,\n\t\t\ttypeNode: ts.TypeNode\n\t\t) => IJsonSchema | undefined\n\t): IJsonSchema | undefined {\n\t\tconst primaryTypeNode = typeNode.typeArguments?.[0];\n\t\tif (!primaryTypeNode) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst primarySchema = mapTypeNodeToSchema(context, primaryTypeNode);\n\t\tif (!primarySchema) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst singleOccurrenceTypeNode = typeNode.typeArguments?.[1];\n\t\tif (!singleOccurrenceTypeNode) {\n\t\t\treturn {\n\t\t\t\ttype: \"array\",\n\t\t\t\titems: primarySchema,\n\t\t\t\tminItems: 1\n\t\t\t};\n\t\t}\n\n\t\tconst singleOccurrenceSchema = mapTypeNodeToSchema(context, singleOccurrenceTypeNode);\n\t\tif (!singleOccurrenceSchema) {\n\t\t\treturn {\n\t\t\t\ttype: \"array\",\n\t\t\t\titems: primarySchema,\n\t\t\t\tminItems: 1\n\t\t\t};\n\t\t}\n\n\t\tif (\n\t\t\tJsonHelper.canonicalize(primarySchema) === JsonHelper.canonicalize(singleOccurrenceSchema)\n\t\t) {\n\t\t\treturn {\n\t\t\t\ttype: \"array\",\n\t\t\t\titems: primarySchema,\n\t\t\t\tminItems: 1\n\t\t\t};\n\t\t}\n\n\t\tconst itemSchema: IJsonSchema = {\n\t\t\tanyOf: [primarySchema, singleOccurrenceSchema]\n\t\t};\n\n\t\treturn {\n\t\t\ttype: \"array\",\n\t\t\titems: itemSchema,\n\t\t\tcontains: singleOccurrenceSchema,\n\t\t\tminContains: 1,\n\t\t\tmaxContains: 1,\n\t\t\tminItems: 1\n\t\t};\n\t}\n\n\t/**\n\t * Determine whether a type node represents null or undefined.\n\t */\n\tprivate static isNullOrUndefinedTypeNode(typeNode: ts.TypeNode): boolean {\n\t\tif (\n\t\t\ttypeNode.kind === ts.SyntaxKind.NullKeyword ||\n\t\t\ttypeNode.kind === ts.SyntaxKind.UndefinedKeyword\n\t\t) {\n\t\t\treturn true;\n\t\t}\n\n\t\tif (ts.isLiteralTypeNode(typeNode)) {\n\t\t\treturn typeNode.literal.kind === ts.SyntaxKind.NullKeyword;\n\t\t}\n\n\t\tif (ts.isTypeReferenceNode(typeNode) && ts.isIdentifier(typeNode.typeName)) {\n\t\t\treturn typeNode.typeName.text === \"undefined\";\n\t\t}\n\n\t\treturn false;\n\t}\n\n\t/**\n\t * Extract literal keys from a Record key type argument.\n\t */\n\tprivate static extractRecordLiteralKeys(keyTypeNode: ts.TypeNode): string[] {\n\t\tif (ts.isLiteralTypeNode(keyTypeNode) && ts.isStringLiteral(keyTypeNode.literal)) {\n\t\t\treturn [keyTypeNode.literal.text];\n\t\t}\n\n\t\tif (ts.isUnionTypeNode(keyTypeNode)) {\n\t\t\tconst keys = keyTypeNode.types\n\t\t\t\t.filter(type => ts.isLiteralTypeNode(type) && ts.isStringLiteral(type.literal))\n\t\t\t\t.map(type => (type as ts.LiteralTypeNode).literal as ts.StringLiteral)\n\t\t\t\t.map(literal => literal.text);\n\t\t\treturn keys.length === keyTypeNode.types.length ? keys : [];\n\t\t}\n\n\t\treturn [];\n\t}\n\n\t/**\n\t * Resolve a default schema for JsonLdObject utility key additions when the type argument is omitted.\n\t */\n\tprivate static mapJsonLdObjectDefaultSchemaByKey(\n\t\tbaseSchema: IJsonSchema,\n\t\tkeyToAdd: \"id\" | \"@id\" | \"type\" | \"@type\" | \"@context\"\n\t): IJsonSchema {\n\t\tif (keyToAdd === \"id\" || keyToAdd === \"@id\") {\n\t\t\treturn UtilityTypeSchemaMapper.mapJsonLdObjectWithIdDefaultIdSchema(baseSchema);\n\t\t}\n\n\t\tif (keyToAdd === \"@context\") {\n\t\t\treturn UtilityTypeSchemaMapper.mapJsonLdObjectWithContextDefaultContextSchema(baseSchema);\n\t\t}\n\n\t\treturn UtilityTypeSchemaMapper.mapJsonLdObjectWithTypeDefaultTypeSchema(baseSchema);\n\t}\n\n\t/**\n\t * Resolve default id schema for JsonLdObjectWithId when Id type argument is omitted.\n\t */\n\tprivate static mapJsonLdObjectWithIdDefaultIdSchema(baseSchema: IJsonSchema): IJsonSchema {\n\t\treturn UtilityTypeSchemaMapper.mapJsonLdObjectDefaultEitherSchema(baseSchema, \"id\", \"@id\", {\n\t\t\ttype: \"string\"\n\t\t});\n\t}\n\n\t/**\n\t * Resolve default type schema for JsonLdObjectWithType when Type argument is omitted.\n\t */\n\tprivate static mapJsonLdObjectWithTypeDefaultTypeSchema(baseSchema: IJsonSchema): IJsonSchema {\n\t\treturn UtilityTypeSchemaMapper.mapJsonLdObjectDefaultEitherSchema(baseSchema, \"type\", \"@type\", {\n\t\t\tanyOf: [{ type: \"string\" }, { type: \"array\", items: { type: \"string\" } }]\n\t\t});\n\t}\n\n\t/**\n\t * Resolve default context schema for JsonLdObjectWithContext when Context argument is omitted.\n\t */\n\tprivate static mapJsonLdObjectWithContextDefaultContextSchema(\n\t\tbaseSchema: IJsonSchema\n\t): IJsonSchema {\n\t\treturn UtilityTypeSchemaMapper.mapJsonLdObjectDefaultEitherSchema(\n\t\t\tbaseSchema,\n\t\t\t\"@context\",\n\t\t\t\"@context\",\n\t\t\t{\n\t\t\t\ttype: \"array\",\n\t\t\t\titems: { type: \"string\" }\n\t\t\t}\n\t\t);\n\t}\n\n\t/**\n\t * Resolve default schema from either of two source keys, with fallback when both are absent.\n\t */\n\tprivate static mapJsonLdObjectDefaultEitherSchema(\n\t\tbaseSchema: IJsonSchema,\n\t\tfirstKey: string,\n\t\tsecondKey: string,\n\t\tfallbackSchema: IJsonSchema\n\t): IJsonSchema {\n\t\tconst firstSchema = ObjectTransformer.resolvePropertySchemaFromObjectSchema(\n\t\t\tbaseSchema,\n\t\t\tfirstKey\n\t\t);\n\t\tconst secondSchema = ObjectTransformer.resolvePropertySchemaFromObjectSchema(\n\t\t\tbaseSchema,\n\t\t\tsecondKey\n\t\t);\n\n\t\tif (firstSchema && secondSchema) {\n\t\t\tif (JsonHelper.canonicalize(firstSchema) === JsonHelper.canonicalize(secondSchema)) {\n\t\t\t\treturn firstSchema;\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tanyOf: [firstSchema, secondSchema]\n\t\t\t};\n\t\t}\n\n\t\tif (firstSchema) {\n\t\t\treturn firstSchema;\n\t\t}\n\n\t\tif (secondSchema) {\n\t\t\treturn secondSchema;\n\t\t}\n\n\t\treturn fallbackSchema;\n\t}\n}\n"]}

package/dist/types/index.d.ts

@@ -1,11 +1,20 @@
-export * from "./models/IJsonSchema.js";
-export * from "./models/IOpenApi.js";
-export * from "./models/IOpenApiExample.js";
-export * from "./models/IOpenApiHeader.js";
-export * from "./models/IOpenApiPathMethod.js";
-export * from "./models/IOpenApiResponse.js";
-export * from "./models/IOpenApiSecurityScheme.js";
-export * from "./models/IPackageJson.js";
-export * from "./models/jsonTypeName.js";
-export * from "./utils/jsonSchemaHelper.js";
-export * from "./utils/openApiHelper.js";
+export * from "./models/ITypeScriptToSchemaContext.js";
+export * from "./models/ITypeScriptToSchemaDiagnostics.js";
+export * from "./models/ITypeScriptToSchemaOptions.js";
+export * from "./utils/diagnosticReporter.js";
+export * from "./utils/disallowedTypeGuard.js";
+export * from "./utils/enum.js";
+export * from "./utils/fileUtils.js";
+export * from "./utils/importTypeQuerySchemaResolver.js";
+export * from "./utils/indexSignaturePatternResolver.js";
+export * from "./utils/intersectionSchemaMerger.js";
+export * from "./utils/jsonSchemaBuilder.js";
+export * from "./utils/constants.js";
+export * from "./utils/mappedTypeSchemaResolver.js";
+export * from "./utils/objectTransformer.js";
+export * from "./utils/regEx.js";
+export * from "./utils/resolver.js";
+export * from "./utils/templateLiteralPatternBuilder.js";
+export * from "./utils/typeScriptToSchema.js";
+export * from "./utils/jsDoc.js";
+export * from "./utils/utilityTypeSchemaMapper.js";

package/dist/types/models/ITypeScriptToSchemaContext.d.ts

@@ -0,0 +1,64 @@
+import type { IJsonSchema } from "@twin.org/tools-models";
+import type * as ts from "typescript";
+import type { ITypeScriptToSchemaOptions } from "./ITypeScriptToSchemaOptions.js";
+/**
+ * Context for TypeScript to JSON schema generation.
+ */
+export interface ITypeScriptToSchemaContext {
+    /**
+     * The namespace for generated schema ids.
+     */
+    namespace: string;
+    /**
+     * The package name for generated schema ids.
+     */
+    packageName: string;
+    /**
+     * The schema cache indexed by package and title.
+     */
+    schemas: {
+        [id: string]: {
+            [id: string]: IJsonSchema;
+        };
+    };
+    /**
+     * The currently active source file being mapped.
+     */
+    activeSourceFile?: ts.SourceFile;
+    /**
+     * The currently active enclosing object (interface/type) being mapped.
+     */
+    activeEnclosingObjectName?: string;
+    /**
+     * The first disallowed type encountered while mapping the active enclosing object.
+     */
+    activeDisallowedType?: {
+        disallowedTypeName: string;
+        propertyName: string;
+        enclosingObjectName: string;
+    };
+    /**
+     * Type names currently being resolved to avoid recursive local-type expansion loops.
+     */
+    resolvingTypeNames?: Set<string>;
+    /**
+     * Utility type names currently being processed to avoid infinite recursion cycles
+     * when encountering complex combinations of indexed access types, keyof, and utility types.
+     */
+    resolvingUtilityTypes?: Set<string>;
+    /**
+     * Imported utility base schemas currently being resolved to avoid recursive re-entry
+     * while parsing module graphs for utility type application.
+     */
+    resolvingImportedObjectSchemas?: Set<string>;
+    /**
+     * Generic type parameter bindings active for the current mapping scope.
+     */
+    typeParameterBindings?: {
+        [id: string]: ts.TypeNode | null;
+    };
+    /**
+     * Optional schema generation options.
+     */
+    options?: ITypeScriptToSchemaOptions;
+}

package/dist/types/models/ITypeScriptToSchemaDiagnostics.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Diagnostic payload for non-fatal schema generation issues.
+ */
+export interface ITypeScriptToSchemaDiagnostics {
+    /**
+     * Stable diagnostic code identifying the issue type.
+     */
+    code: string;
+    /**
+     * Additional structured metadata related to the diagnostic.
+     */
+    properties?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Schema path where the issue was detected.
+     */
+    path: string;
+    /**
+     * Source file where the diagnostic originated, if available.
+     */
+    fileName?: string;
+    /**
+     * One-based source line number, when available.
+     */
+    line?: number;
+    /**
+     * One-based source column number, when available.
+     */
+    column?: number;
+}

package/dist/types/models/ITypeScriptToSchemaOptions.d.ts

@@ -0,0 +1,22 @@
+import type { ITypeScriptToSchemaDiagnostics } from "./ITypeScriptToSchemaDiagnostics.js";
+/**
+ * Options for TypeScript to JSON schema generation.
+ */
+export interface ITypeScriptToSchemaOptions {
+    /**
+     * Mapping of package ids, type ids, wildcard patterns, or regex patterns to schema id prefixes
+     * or replacement templates for referenced schemas.
+     */
+    externalReferences?: {
+        [id: string]: string;
+    };
+    /**
+     * Optional diagnostic callback for non-fatal generation issues.
+     * @param diagnostic The diagnostic details for the generation issue.
+     */
+    onDiagnostic?: (diagnostic: ITypeScriptToSchemaDiagnostics) => void;
+    /**
+     * Package names where diagnostics should be suppressed, e.g. jose.
+     */
+    suppressPackageWarnings?: string[];
+}

package/dist/types/utils/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared constants for TypeScript to JSON schema generation.
+ */
+export declare class Constants {
+    /**
+     * Utility type names currently unsupported and mapped to open schemas with diagnostics.
+     */
+    static readonly UNSUPPORTED_UTILITY_TYPE_NAMES: string[];
+    /**
+     * Native typed-array and binary type names mapped to JSON number arrays.
+     */
+    static readonly ARRAY_NUMBER_TYPE_NAMES: string[];
+}

package/dist/types/utils/diagnosticReporter.d.ts

@@ -0,0 +1,17 @@
+import type * as ts from "typescript";
+import type { ITypeScriptToSchemaContext } from "../models/ITypeScriptToSchemaContext.js";
+/**
+ * Emits non-fatal diagnostics during schema mapping.
+ */
+export declare class DiagnosticReporter {
+    /**
+     * Emit an optional non-fatal schema generation diagnostic.
+     * @param context The generation context.
+     * @param node The related AST node.
+     * @param code The diagnostic code.
+     * @param properties The values to substitute into the localised message.
+     */
+    static report(context: ITypeScriptToSchemaContext, node: ts.Node, code: string, properties?: {
+        [key: string]: unknown;
+    }): void;
+}