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

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

@@ -388,64 +388,17 @@ export declare class JsonSchemaBuilder {
      * @param context The generation context.
      * @param schema The schema to expand.
      * @param declaration The interface declaration.
+     * @throws GeneralError when an extended type cannot be resolved to a schema.
      */
     static applyInterfaceExtendsSchema(context: ITypeScriptToSchemaContext, schema: Partial<IJsonSchema>, declaration: ts.InterfaceDeclaration): void;
     /**
-     * Map Partial<T> to an object schema with no required properties.
+     * Resolve a direct base reference for refinement Omit patterns in interface extends clauses.
      * @param context The generation context.
-     * @param typeNode The Partial type reference.
-     * @returns The mapped schema.
-     */
-    static mapPartialUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map Required<T> to an object schema with all properties required.
-     * @param context The generation context.
-     * @param typeNode The Required type reference.
-     * @returns The mapped schema.
-     */
-    static mapRequiredUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map Pick<T, K> to an object schema with selected keys preserved.
-     * @param context The generation context.
-     * @param typeNode The Pick type reference.
-     * @returns The mapped schema.
-     */
-    static mapPickUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map Omit<T, K> to an object schema with selected keys removed.
-     * @param context The generation context.
-     * @param typeNode The Omit type reference.
-     * @returns The mapped schema.
-     */
-    static mapOmitUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map Exclude<T, U> to a schema that removes U members from T.
-     * @param context The generation context.
-     * @param typeNode The Exclude type reference.
-     * @returns The mapped schema.
-     */
-    static mapExcludeUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map Extract<T, U> to a schema that keeps U members from T.
-     * @param context The generation context.
-     * @param typeNode The Extract type reference.
-     * @returns The mapped schema.
+     * @param declaration The interface declaration being mapped.
+     * @param extendedType The heritage type being processed.
+     * @returns A direct base reference when a refinement pattern is detected.
      */
-    static mapExtractUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map NonNullable<T> by removing null and undefined branches from T.
-     * @param context The generation context.
-     * @param typeNode The NonNullable type reference.
-     * @returns The mapped schema.
-     */
-    static mapNonNullableUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map Record<K, V> to an object schema with key constraints where possible.
-     * @param context The generation context.
-     * @param typeNode The Record type reference.
-     * @returns The mapped schema.
-     */
-    static mapRecordUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
+    static resolveRefinementUtilityBaseRef(context: ITypeScriptToSchemaContext, declaration: ts.InterfaceDeclaration, extendedType: ts.ExpressionWithTypeArguments): IJsonSchema | undefined;
     /**
      * Determine whether a type node represents null or undefined.
      * @param typeNode The type node.
@@ -458,21 +411,6 @@ export declare class JsonSchemaBuilder {
      * @returns The extracted literal keys.
      */
     static extractRecordLiteralKeys(keyTypeNode: ts.TypeNode): string[];
-    /**
-     * Map JsonLdObject utility types using key-removal and optional key-addition rules.
-     * @param context The generation context.
-     * @param typeNode The JsonLdObject utility type reference.
-     * @param options Mapping options.
-     * @param options.keysToRemove Keys to remove from the base schema.
-     * @param options.keyToAdd Optional key to add to the base schema.
-     * @param options.isAddedKeyRequired Whether the added key should be required.
-     * @returns The mapped schema.
-     */
-    static mapJsonLdObjectUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, options: {
-        keysToRemove: string[];
-        keyToAdd?: "id" | "@id" | "type" | "@type" | "@context";
-        isAddedKeyRequired?: boolean;
-    }): IJsonSchema | undefined;
     /**
      * Resolve a default schema for JsonLdObject utility key additions when the type argument is omitted.
      * @param baseSchema The base object schema.
@@ -507,20 +445,6 @@ export declare class JsonSchemaBuilder {
      * @returns The resolved schema.
      */
     static mapJsonLdObjectDefaultEitherSchema(baseSchema: IJsonSchema, firstKey: string, secondKey: string, fallbackSchema: IJsonSchema): IJsonSchema;
-    /**
-     * Map ObjectOrArray<T> to a schema accepting T or T[].
-     * @param context The generation context.
-     * @param typeNode The ObjectOrArray type reference.
-     * @returns The mapped schema.
-     */
-    static mapObjectOrArrayUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
-    /**
-     * Map SingleOccurrenceArray<T, U> to a non-empty array containing exactly one U.
-     * @param context The generation context.
-     * @param typeNode The SingleOccurrenceArray type reference.
-     * @returns The mapped schema.
-     */
-    static mapSingleOccurrenceArrayUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Add a comment to schemas inlined for utility type transformations.
      * @param schema The schema to annotate.

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

@@ -7,6 +7,11 @@ import type { ITypeScriptToSchemaContext } from "../models/ITypeScriptToSchemaCo
 export declare class MappedTypeSchemaResolver {
     /**
      * Resolve mapped type output keys, including remapped key names via `as`.
+     * @param context The generation context.
+     * @param typeNode The mapped type node.
+     * @param mappedKeys The resolved source keys from the mapped type constraint.
+     * @param mappedTypeParameterName The mapped type parameter identifier.
+     * @returns The resolved source-to-output mapped key entries.
      */
     static resolveMappedTypePropertyEntries(context: ITypeScriptToSchemaContext, typeNode: ts.MappedTypeNode, mappedKeys: string[], mappedTypeParameterName: string): {
         sourceKey: string;
@@ -14,26 +19,53 @@ export declare class MappedTypeSchemaResolver {
     }[] | undefined;
     /**
      * Resolve a remapped mapped-type key expression for a concrete source key.
+     * @param context The generation context.
+     * @param nameTypeNode The mapped type name remapping expression node.
+     * @param sourceKey The concrete source key currently being evaluated.
+     * @param mappedTypeParameterName The mapped type parameter identifier.
+     * @returns The remapped key, null when excluded via never, or undefined when unresolved.
      */
     static resolveMappedTypeRemappedKey(context: ITypeScriptToSchemaContext, nameTypeNode: ts.TypeNode, sourceKey: string, mappedTypeParameterName: string): string | null | undefined;
     /**
      * Evaluate whether a concrete mapped key satisfies an `extends` condition.
+     * @param context The generation context.
+     * @param sourceKey The concrete source key being evaluated.
+     * @param extendsTypeNode The extends condition type node.
+     * @returns True when the key satisfies the condition, false when it does not, otherwise undefined.
      */
     static evaluateMappedKeyExtendsCondition(context: ITypeScriptToSchemaContext, sourceKey: string, extendsTypeNode: ts.TypeNode): boolean | undefined;
     /**
      * Build a conservative fallback schema for mapped types whose key remapping cannot be resolved.
+     * @param context The generation context.
+     * @param typeNode The mapped type node.
+     * @param mappedKeys The resolved source keys from the mapped type constraint.
+     * @param mappedTypeParameterName The mapped type parameter identifier.
+     * @param sourceObjectSchema The optional source object schema for property lookups.
+     * @returns The fallback mapped type schema.
      */
     static buildMappedTypeFallbackSchema(context: ITypeScriptToSchemaContext, typeNode: ts.MappedTypeNode, mappedKeys: string[], mappedTypeParameterName: string, sourceObjectSchema?: IJsonSchema): IJsonSchema;
     /**
      * Build fallback additionalProperties for unresolved mapped key remapping.
+     * @param context The generation context.
+     * @param typeNode The mapped type node.
+     * @param mappedKeys The resolved source keys from the mapped type constraint.
+     * @param mappedTypeParameterName The mapped type parameter identifier.
+     * @param sourceObjectSchema The optional source object schema for property lookups.
+     * @returns The fallback additionalProperties schema.
      */
     static buildMappedTypeFallbackAdditionalProperties(context: ITypeScriptToSchemaContext, typeNode: ts.MappedTypeNode, mappedKeys: string[], mappedTypeParameterName: string, sourceObjectSchema?: IJsonSchema): IJsonSchema | undefined;
     /**
      * Merge mapped property schemas when multiple source keys remap to the same output key.
+     * @param existingSchema The existing schema already assigned to the mapped key.
+     * @param nextSchema The next schema to merge into the mapped key.
+     * @returns The merged schema.
      */
     static mergeMappedTypePropertySchemas(existingSchema: IJsonSchema, nextSchema: IJsonSchema): IJsonSchema;
     /**
      * Resolve required remapped keys from the source object's required key set.
+     * @param mappedEntries The source-to-output mapped key entries.
+     * @param sourceObjectSchema The source object schema containing required keys.
+     * @returns The required output keys.
      */
     static resolveMappedTypeSourceRequiredPropertyKeys(mappedEntries: {
         sourceKey: string;
@@ -41,6 +73,9 @@ export declare class MappedTypeSchemaResolver {
     }[], sourceObjectSchema: IJsonSchema): string[] | undefined;
     /**
      * Apply TypeScript intrinsic string remapping helpers to a key.
+     * @param intrinsicName The intrinsic helper name.
+     * @param value The input key value.
+     * @returns The remapped key value.
      */
     private static applyIntrinsicMappedTypeKeyRemap;
 }

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

@@ -7,9 +7,15 @@ export declare class Resolver {
      * Resolve a type declaration AST from a package and type name.
      * @param packageName The package to inspect.
      * @param typeName The type to resolve.
+     * @param containingFilePath An optional source file path to use as the starting point for
+     * package resolution. When provided, TypeScript module resolution walks up from that file's
+     * directory, which allows transitive dependencies installed alongside the source file (e.g.
+     * in a sub-directory node_modules) to be found even when they are not reachable from the
+     * current working directory. The path is normalised to absolute before use;
+     * falls back to process.cwd() when omitted.
      * @returns The resolved declaration AST.
      */
-    static resolveTypeDeclarationAst(packageName: string, typeName: string): {
+    static resolveTypeDeclarationAst(packageName: string, typeName: string, containingFilePath?: string): {
         sourceFile: ts.SourceFile;
         declaration: ts.InterfaceDeclaration | ts.TypeAliasDeclaration;
     } | undefined;

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

@@ -9,84 +9,131 @@ export declare 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: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, resolveUtilityBaseObjectSchema: (context: ITypeScriptToSchemaContext, baseTypeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapPartialUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | 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: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, resolveUtilityBaseObjectSchema: (context: ITypeScriptToSchemaContext, baseTypeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapRequiredUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map Pick<T, K> to an object schema with selected keys preserved.
+     * @param context The generation context.
+     * @param typeNode The Pick type reference.
+     * @returns The mapped schema.
      */
-    static mapPickUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, resolveUtilityBaseObjectSchema: (context: ITypeScriptToSchemaContext, baseTypeNode: ts.TypeNode) => IJsonSchema | undefined, extractUtilityTypeKeys: (context: ITypeScriptToSchemaContext, keysNode: ts.TypeNode | undefined) => string[]): IJsonSchema | undefined;
+    static mapPickUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map Omit<T, K> to an object schema with selected keys removed.
+     * @param context The generation context.
+     * @param typeNode The Omit type reference.
+     * @returns The mapped schema.
      */
-    static mapOmitUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, resolveUtilityBaseObjectSchema: (context: ITypeScriptToSchemaContext, baseTypeNode: ts.TypeNode) => IJsonSchema | undefined, extractUtilityTypeKeys: (context: ITypeScriptToSchemaContext, keysNode: ts.TypeNode | undefined) => string[]): IJsonSchema | undefined;
+    static mapOmitUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map Exclude<T, U> to a schema that removes U members from T.
+     * @param context The generation context.
+     * @param typeNode The Exclude type reference.
+     * @returns The mapped schema.
      */
-    static mapExcludeUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, mapTypeNodeToSchema: (context: ITypeScriptToSchemaContext, typeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapExcludeUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map Extract<T, U> to a schema that keeps U members from T.
+     * @param context The generation context.
+     * @param typeNode The Extract type reference.
+     * @returns The mapped schema.
      */
-    static mapExtractUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, mapTypeNodeToSchema: (context: ITypeScriptToSchemaContext, typeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapExtractUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map NonNullable<T> by removing null and undefined branches from T.
+     * @param context The generation context.
+     * @param typeNode The NonNullable type reference.
+     * @returns The mapped schema.
      */
-    static mapNonNullableUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, mapTypeNodeToSchema: (context: ITypeScriptToSchemaContext, typeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapNonNullableUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map Record<K, V> to an object schema with key constraints where possible.
+     * @param context The generation context.
+     * @param typeNode The Record type reference.
+     * @returns The mapped schema.
      */
-    static mapRecordUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, mapTypeNodeToSchema: (context: ITypeScriptToSchemaContext, typeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapRecordUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map JsonLdObject utility types using key-removal and optional key-addition rules.
+     * @param context The generation context.
+     * @param typeNode The JsonLdObject utility type reference.
+     * @param options The mapping options for key removal and optional key addition.
+     * @param options.keysToRemove The property keys to remove from the base schema.
+     * @param options.keyToAdd The optional key to add after removal.
+     * @param options.isAddedKeyRequired True when the added key must be required.
+     * @returns The mapped schema.
      */
     static mapJsonLdObjectUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, options: {
         keysToRemove: string[];
         keyToAdd?: "id" | "@id" | "type" | "@type" | "@context";
         isAddedKeyRequired?: boolean;
-    }, resolveUtilityBaseObjectSchema: (context: ITypeScriptToSchemaContext, baseTypeNode: ts.TypeNode) => IJsonSchema | undefined, mapTypeNodeToSchema: (context: ITypeScriptToSchemaContext, typeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    }): IJsonSchema | undefined;
     /**
      * Map ObjectOrArray<T> to a schema accepting T or T[].
+     * @param context The generation context.
+     * @param typeNode The ObjectOrArray type reference.
+     * @returns The mapped schema.
      */
-    static mapObjectOrArrayUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, mapTypeNodeToSchema: (context: ITypeScriptToSchemaContext, typeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapObjectOrArrayUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Map SingleOccurrenceArray<T, U> to a non-empty array containing exactly one U.
+     * @param context The generation context.
+     * @param typeNode The SingleOccurrenceArray type reference.
+     * @returns The mapped schema.
      */
-    static mapSingleOccurrenceArrayUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode, mapTypeNodeToSchema: (context: ITypeScriptToSchemaContext, typeNode: ts.TypeNode) => IJsonSchema | undefined): IJsonSchema | undefined;
+    static mapSingleOccurrenceArrayUtilityType(context: ITypeScriptToSchemaContext, typeNode: ts.TypeReferenceNode): IJsonSchema | undefined;
     /**
      * Determine whether a type node represents null or undefined.
+     * @param typeNode The type node to inspect.
+     * @returns True if the node represents null or undefined; otherwise false.
      */
     private static isNullOrUndefinedTypeNode;
     /**
      * Extract literal keys from a Record key type argument.
+     * @param keyTypeNode The Record key type argument to inspect.
+     * @returns The extracted literal keys.
      */
     private static extractRecordLiteralKeys;
     /**
      * Resolve a default schema for JsonLdObject utility key additions when the type argument is omitted.
+     * @param baseSchema The base object schema being transformed.
+     * @param keyToAdd The key to add when no explicit value type argument is provided.
+     * @returns The resolved default schema for the added key.
      */
     private static mapJsonLdObjectDefaultSchemaByKey;
     /**
      * Resolve default id schema for JsonLdObjectWithId when Id type argument is omitted.
+     * @param baseSchema The base object schema being transformed.
+     * @returns The default id schema.
      */
     private static mapJsonLdObjectWithIdDefaultIdSchema;
     /**
      * Resolve default type schema for JsonLdObjectWithType when Type argument is omitted.
+     * @param baseSchema The base object schema being transformed.
+     * @returns The default type schema.
      */
     private static mapJsonLdObjectWithTypeDefaultTypeSchema;
     /**
      * Resolve default context schema for JsonLdObjectWithContext when Context argument is omitted.
+     * @param baseSchema The base object schema being transformed.
+     * @returns The default context schema.
      */
     private static mapJsonLdObjectWithContextDefaultContextSchema;
     /**
      * Resolve default schema from either of two source keys, with fallback when both are absent.
+     * @param baseSchema The base object schema being transformed.
+     * @param firstKey The first property key to check.
+     * @param secondKey The second property key to check.
+     * @param fallbackSchema The fallback schema when neither key is present.
+     * @returns The resolved schema.
      */
     private static mapJsonLdObjectDefaultEitherSchema;
 }

package/docs/changelog.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## [0.0.3-next.23](https://github.com/twinfoundation/tools/compare/tools-core-v0.0.3-next.22...tools-core-v0.0.3-next.23) (2026-03-20)
+
+
+### Features
+
+* improve inheritance redefinition optionality ([e7024f6](https://github.com/twinfoundation/tools/commit/e7024f699988c0b3de8315a0dbe455a13268e75d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/tools-models bumped from 0.0.3-next.22 to 0.0.3-next.23
+
+## [0.0.3-next.22](https://github.com/twinfoundation/tools/compare/tools-core-v0.0.3-next.21...tools-core-v0.0.3-next.22) (2026-03-20)
+
+
+### Features
+
+* add context id features ([#54](https://github.com/twinfoundation/tools/issues/54)) ([41ad65d](https://github.com/twinfoundation/tools/commit/41ad65d5ae33d0533d32a2864cd94e5c35e56c76))
+* add jsdoc default value to schema ([7886a84](https://github.com/twinfoundation/tools/commit/7886a84961e692d2054f223e2e99205a654b76a6))
+* add jsdoc tag validation ([971b8d3](https://github.com/twinfoundation/tools/commit/971b8d3817d40467bfd7549c99af602f0c590299))
+* add support for auto expand types ([dd1e10a](https://github.com/twinfoundation/tools/commit/dd1e10a5b2fea6f80890ff6f3971f48e239cb4c1))
+* add validate-locales ([97bb11f](https://github.com/twinfoundation/tools/commit/97bb11fd9e6ed400e7fa69671075ba78f36ca6e6))
+* correctly handle auto expand types ([57fce0f](https://github.com/twinfoundation/tools/commit/57fce0f9ec4a0876665d70adc6e885f6feb3caf7))
+* eslint migration to flat config ([25acfcf](https://github.com/twinfoundation/tools/commit/25acfcf4c4e0c496fffeaf67659fe171bc15199a))
+* improve auto expand types ([6181d1d](https://github.com/twinfoundation/tools/commit/6181d1daded1f91323195cf7efbc2f1881f38b41))
+* improve discriminated unions ([9c36ea7](https://github.com/twinfoundation/tools/commit/9c36ea7283230089ff19085ddc4b4c30a4e3f8a2))
+* improve type name normalisation ([1fe28e5](https://github.com/twinfoundation/tools/commit/1fe28e567593e46a41a833fbba95fe4cd958f525))
+* remove additionalProperties ([f9b5d81](https://github.com/twinfoundation/tools/commit/f9b5d81e952468f9579593cb979f2b84db6f0dfa))
+* remove auto expanded types from final output ([18e05dc](https://github.com/twinfoundation/tools/commit/18e05dc88f71a0a27b79d1d076b1261b42d2c4c2))
+* tighten the types included with the regex matching ([e54909b](https://github.com/twinfoundation/tools/commit/e54909bded4a19d00560dd3ec783e9146580bda3))
+* ts to schema ([#86](https://github.com/twinfoundation/tools/issues/86)) ([ffebda5](https://github.com/twinfoundation/tools/commit/ffebda5f14ab5ec734bf37c9fb70a7ec3d4012c3))
+* update framework core ([559cb98](https://github.com/twinfoundation/tools/commit/559cb98612c05a05458b37462cda806b9591b18a))
+* use jsdoc tags for json-ld markup ([1ea872e](https://github.com/twinfoundation/tools/commit/1ea872e07a1cc0e94178158a57383d64008e02e3))
+
+
+### Bug Fixes
+
+* additionalItems object check ([ca81668](https://github.com/twinfoundation/tools/commit/ca81668e1ee0d2b1a479215265e651932d7b76de))
+* improve schema output ([9e53cbe](https://github.com/twinfoundation/tools/commit/9e53cbe26e6272323d72c65e277b7d24521fdbba))
+* missing type definitions when importing relative from dynamic node_modules ([52d9fc5](https://github.com/twinfoundation/tools/commit/52d9fc5f2618a09c02b9f5dbe585b37cf60c9f20))
+* work for schema generator spread defect ([1a705ff](https://github.com/twinfoundation/tools/commit/1a705ffc74b353f652e74ea43454164a2f6740bf))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/tools-models bumped from 0.0.3-next.21 to 0.0.3-next.22
+
 ## [0.0.3-next.21](https://github.com/twinfoundation/tools/compare/tools-core-v0.0.3-next.20...tools-core-v0.0.3-next.21) (2026-03-20)
 
 

package/docs/reference/classes/ImportTypeQuerySchemaResolver.md

@@ -26,14 +26,20 @@ Map import type nodes (e.g. import("pkg").Type) to schema references.
 
 [`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
 
+The generation context.
+
 ##### typeNode
 
 `ImportTypeNode`
 
+The import type node.
+
 #### Returns
 
 `IJsonSchema` \| `undefined`
 
+The mapped schema.
+
 ***
 
 ### mapTypeQueryNodeToSchema() {#maptypequerynodetoschema}
@@ -48,14 +54,20 @@ Map a type query node (typeof expr) to schema by resolving the referenced variab
 
 [`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
 
+The generation context.
+
 ##### typeNode
 
 `TypeQueryNode`
 
+The type query node.
+
 #### Returns
 
 `IJsonSchema`
 
+The mapped schema.
+
 ***
 
 ### resolveImportTypeReferenceSchemaId() {#resolveimporttypereferenceschemaid}
@@ -70,18 +82,28 @@ Resolve import-type references to local or external schema ids.
 
 [`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
 
+The generation context.
+
 ##### moduleSpecifier
 
 `string`
 
+The import module specifier.
+
 ##### typeName
 
 `string`
 
+The imported type name.
+
 ##### title
 
 `string`
 
+The stripped schema title.
+
 #### Returns
 
 `string` \| `undefined`
+
+The resolved schema id.