@twin.org/tools-core 0.0.4-next.3 → 0.9.0-next.1

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

@@ -3,21 +3,21 @@
  */
 export declare class FileUtils {
     /**
-     * Does the file exist.
+     * Check whether a file exists at the given path.
      * @param filePath The file path.
      * @returns True if the file exists.
      */
     static fileExists(filePath: string): boolean;
     /**
-     * Read the file.
+     * Read the entire contents of a file as UTF-8 text.
      * @param filePath The file path.
      * @returns The file contents.
      */
     static readFile(filePath: string): string;
     /**
-     * Resolve a path.
+     * Resolve a file path to an absolute path.
      * @param filePath The file path.
-     * @returns The resolved path.
+     * @returns The resolved absolute path.
      */
     static resolvePath(filePath: string): string;
     /**

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

@@ -28,60 +28,4 @@ export declare class ImportTypeQuerySchemaResolver {
      * @returns The resolved schema id.
      */
     static resolveImportTypeReferenceSchemaId(context: ITypeScriptToSchemaContext, moduleSpecifier: string, typeName: string, title: string): string | undefined;
-    /**
-     * Resolve a property value from a const object declaration in an imported source file.
-     * @param context The generation context.
-     * @param objectName The imported object symbol name.
-     * @param propertyName The property name to resolve from the object.
-     * @returns The resolved literal property value.
-     */
-    private static resolveConstObjectProperty;
-    /**
-     * Find a variable declaration by traversing import and export chains.
-     * @param sourceFilePath The source file path to inspect.
-     * @param variableName The variable name to find.
-     * @param visitedFiles The set of visited files to prevent recursion cycles.
-     * @returns The matched variable declaration.
-     */
-    private static findVariableDeclarationInModuleGraph;
-    /**
-     * Find an imported symbol reference by local identifier name.
-     * @param sourceFile The active source file.
-     * @param localName The local identifier name.
-     * @returns The imported symbol reference.
-     */
-    private static findImportedValueReference;
-    /**
-     * Resolve an import declaration module specifier to a source file.
-     * @param containingSourceFilePath The path of the file containing the import declaration.
-     * @param moduleSpecifier The module specifier to resolve.
-     * @returns The resolved source file path.
-     */
-    private static resolveImportDeclarationSourceFile;
-    /**
-     * Extract a const-object property value from a declaration initializer.
-     * @param objectDeclaration The variable declaration containing the object initializer.
-     * @param propertyName The property name to resolve.
-     * @returns The extracted literal property value.
-     */
-    private static extractConstObjectPropertyFromDeclarationInitializer;
-    /**
-     * Extract a const-object property value from a declaration type annotation.
-     * @param declarationTypeNode The declaration type node to inspect.
-     * @param propertyName The property name to resolve.
-     * @returns The extracted literal property value.
-     */
-    private static extractConstObjectPropertyFromDeclarationType;
-    /**
-     * Extract a literal value from a type node when possible.
-     * @param typeNode The type node to inspect.
-     * @returns The extracted literal value.
-     */
-    private static extractLiteralValueFromTypeNode;
-    /**
-     * Extract a referenced type name from an import type qualifier.
-     * @param qualifier The import type qualifier.
-     * @returns The extracted type name.
-     */
-    private static extractImportTypeName;
 }

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

@@ -13,10 +13,6 @@ export declare class JsonSchemaBuilder {
      * Runtime name for the class.
      */
     static readonly CLASS_NAME: string;
-    /**
-     * Dictionary of TypeScript utility type names to their schema mapping handlers.
-     */
-    private static readonly _utilityTypeHandlers;
     /**
      * Parse all object declarations from a source file.
      * @param context The generation context.

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

@@ -71,11 +71,4 @@ export declare class MappedTypeSchemaResolver {
         sourceKey: string;
         mappedKey: string;
     }[], 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/typeScriptToSchema.d.ts

@@ -28,65 +28,4 @@ export declare class TypeScriptToSchema {
      * @returns True if the diagnostic originated from the package.
      */
     isDiagnosticFromPackage(path: string, fileName: string | undefined, packageName: string): boolean;
-    /**
-     * Rewrite refs to @json-schema embedded local types into the current schema's $defs.
-     * @param context The generation context.
-     * @param schema The root schema to rewrite.
-     * @param rootTitle The title of the root schema.
-     */
-    private inlineEmbeddedSchemas;
-    /**
-     * Traverse a schema tree and move embedded local refs into the root schema's $defs.
-     * @param context The generation context.
-     * @param rootSchema The root schema document being rewritten.
-     * @param currentNode The current schema node.
-     * @param rootTitle The title of the root schema.
-     * @param ancestry Titles currently being expanded to avoid recursion cycles.
-     * @returns True if inline embedding changed this node or a descendant.
-     */
-    private inlineEmbeddedSchemasInNode;
-    /**
-     * Flatten inline-expanded object allOf branches into the containing schema.
-     * @param schema The schema to flatten.
-     */
-    private flattenInlineAllOfBranches;
-    /**
-     * Determine whether an allOf branch can be flattened into its parent after inline embedding.
-     * @param branch The allOf branch.
-     * @returns True if the branch is a plain object schema.
-     */
-    private canFlattenInlineAllOfBranch;
-    /**
-     * Create a clone of an embedded schema suitable for defs or inline expansion.
-     * @param context The generation context.
-     * @param embeddedSchema The source schema.
-     * @param embeddedMode The embedding mode.
-     * @returns The cloned schema.
-     */
-    private createEmbeddedSchemaClone;
-    /**
-     * Replace the contents of a schema node while keeping the same object reference.
-     * @param target The schema node to mutate.
-     * @param replacement The replacement content.
-     */
-    private replaceSchemaNode;
-    /**
-     * Find a generated schema by its canonical id across all loaded packages.
-     * @param context The generation context.
-     * @param schemaId The schema id to locate.
-     * @returns The schema when found.
-     */
-    private findSchemaById;
-    /**
-     * Resolve the local $defs key to use for an embedded schema.
-     * @param schema The embedded schema.
-     * @param schemaId The canonical schema id.
-     * @returns The local definition key.
-     */
-    private getEmbeddedDefinitionKey;
-    /**
-     * Remove $comment fields from a schema tree.
-     * @param schema The schema tree to clean.
-     */
-    private removeSchemaComments;
 }

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

@@ -99,52 +99,4 @@ export declare class UtilityTypeSchemaMapper {
      * @returns The mapped schema.
      */
     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 context The generation context.
-     * @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 context The generation context.
-     * @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,53 @@
 # Changelog
 
+## [0.9.0-next.1](https://github.com/iotaledger/twin-tools/compare/tools-core-v0.9.0-next.0...tools-core-v0.9.0-next.1) (2026-06-22)
+
+
+### Features
+
+* add 'byte' to supported json-schema format values ([#122](https://github.com/iotaledger/twin-tools/issues/122)) ([54c2a27](https://github.com/iotaledger/twin-tools/commit/54c2a279c1fdc4f6779667e3deb3de3a199237ac))
+* add context id features ([#54](https://github.com/iotaledger/twin-tools/issues/54)) ([41ad65d](https://github.com/iotaledger/twin-tools/commit/41ad65d5ae33d0533d32a2864cd94e5c35e56c76))
+* add examples to json schema ([#109](https://github.com/iotaledger/twin-tools/issues/109)) ([def5b13](https://github.com/iotaledger/twin-tools/commit/def5b1312e7a0ffefe662fb14575cb655d1c0774))
+* add jsdoc default value to schema ([7886a84](https://github.com/iotaledger/twin-tools/commit/7886a84961e692d2054f223e2e99205a654b76a6))
+* add jsdoc tag validation ([971b8d3](https://github.com/iotaledger/twin-tools/commit/971b8d3817d40467bfd7549c99af602f0c590299))
+* add json-schema embedded mode ([#102](https://github.com/iotaledger/twin-tools/issues/102)) ([f070967](https://github.com/iotaledger/twin-tools/commit/f070967f8f3308e0b5320eab278a319c9d229e3e))
+* add support for auto expand types ([dd1e10a](https://github.com/iotaledger/twin-tools/commit/dd1e10a5b2fea6f80890ff6f3971f48e239cb4c1))
+* add validate-locales ([97bb11f](https://github.com/iotaledger/twin-tools/commit/97bb11fd9e6ed400e7fa69671075ba78f36ca6e6))
+* correctly handle auto expand types ([57fce0f](https://github.com/iotaledger/twin-tools/commit/57fce0f9ec4a0876665d70adc6e885f6feb3caf7))
+* eslint migration to flat config ([25acfcf](https://github.com/iotaledger/twin-tools/commit/25acfcf4c4e0c496fffeaf67659fe171bc15199a))
+* improve auto expand types ([6181d1d](https://github.com/iotaledger/twin-tools/commit/6181d1daded1f91323195cf7efbc2f1881f38b41))
+* improve discriminated unions ([9c36ea7](https://github.com/iotaledger/twin-tools/commit/9c36ea7283230089ff19085ddc4b4c30a4e3f8a2))
+* improve inheritance redefinition optionality ([e7024f6](https://github.com/iotaledger/twin-tools/commit/e7024f699988c0b3de8315a0dbe455a13268e75d))
+* improve type name normalisation ([1fe28e5](https://github.com/iotaledger/twin-tools/commit/1fe28e567593e46a41a833fbba95fe4cd958f525))
+* remove additionalProperties ([f9b5d81](https://github.com/iotaledger/twin-tools/commit/f9b5d81e952468f9579593cb979f2b84db6f0dfa))
+* remove auto expanded types from final output ([18e05dc](https://github.com/iotaledger/twin-tools/commit/18e05dc88f71a0a27b79d1d076b1261b42d2c4c2))
+* tighten the types included with the regex matching ([e54909b](https://github.com/iotaledger/twin-tools/commit/e54909bded4a19d00560dd3ec783e9146580bda3))
+* ts to schema ([#86](https://github.com/iotaledger/twin-tools/issues/86)) ([ffebda5](https://github.com/iotaledger/twin-tools/commit/ffebda5f14ab5ec734bf37c9fb70a7ec3d4012c3))
+* typescript 6 update ([02d2e47](https://github.com/iotaledger/twin-tools/commit/02d2e47859a1d64c81e840626cc2d443816af45b))
+* update dependencies ([5bdd8be](https://github.com/iotaledger/twin-tools/commit/5bdd8becf9f08b35342ea8f298f74578951f4bac))
+* update framework core ([559cb98](https://github.com/iotaledger/twin-tools/commit/559cb98612c05a05458b37462cda806b9591b18a))
+* use correct json-ld context schema ([c831486](https://github.com/iotaledger/twin-tools/commit/c8314864a63635556cd5f2912162a2989056e974))
+* use jsdoc tags for json-ld markup ([1ea872e](https://github.com/iotaledger/twin-tools/commit/1ea872e07a1cc0e94178158a57383d64008e02e3))
+
+
+### Bug Fixes
+
+* additionalItems object check ([ca81668](https://github.com/iotaledger/twin-tools/commit/ca81668e1ee0d2b1a479215265e651932d7b76de))
+* ajv stack overflow for oneOf on large enums ([#112](https://github.com/iotaledger/twin-tools/issues/112)) ([6be32a3](https://github.com/iotaledger/twin-tools/commit/6be32a3ae5b3cf188c0d1caf1080f497b648705c))
+* improve schema output ([9e53cbe](https://github.com/iotaledger/twin-tools/commit/9e53cbe26e6272323d72c65e277b7d24521fdbba))
+* missing type definitions when importing relative from dynamic node_modules ([52d9fc5](https://github.com/iotaledger/twin-tools/commit/52d9fc5f2618a09c02b9f5dbe585b37cf60c9f20))
+* module resolution ([f3aa10c](https://github.com/iotaledger/twin-tools/commit/f3aa10c9c9af073de392a2ef6b8411e947e991c2))
+* remove byte support ([#124](https://github.com/iotaledger/twin-tools/issues/124)) ([7f8c9cd](https://github.com/iotaledger/twin-tools/commit/7f8c9cd4dcc49c58ccc9a985f5bcd03736b5ef0f))
+* support json-ld with aliases type ([#127](https://github.com/iotaledger/twin-tools/issues/127)) ([1eb6c4f](https://github.com/iotaledger/twin-tools/commit/1eb6c4f00088955506c88f026cfaba6e1e1a61b7))
+* work for schema generator spread defect ([1a705ff](https://github.com/iotaledger/twin-tools/commit/1a705ffc74b353f652e74ea43454164a2f6740bf))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/tools-models bumped from 0.9.0-next.0 to 0.9.0-next.1
+
 ## [0.0.4-next.3](https://github.com/iotaledger/twin-tools/compare/tools-core-v0.0.4-next.2...tools-core-v0.0.4-next.3) (2026-06-02)
 
 

package/docs/reference/classes/FileUtils.md

@@ -18,7 +18,7 @@ Utility helpers for TypeScript file and directory paths.
 
 > `static` **fileExists**(`filePath`): `boolean`
 
-Does the file exist.
+Check whether a file exists at the given path.
 
 #### Parameters
 
@@ -40,7 +40,7 @@ True if the file exists.
 
 > `static` **readFile**(`filePath`): `string`
 
-Read the file.
+Read the entire contents of a file as UTF-8 text.
 
 #### Parameters
 
@@ -62,7 +62,7 @@ The file contents.
 
 > `static` **resolvePath**(`filePath`): `string`
 
-Resolve a path.
+Resolve a file path to an absolute path.
 
 #### Parameters
 
@@ -76,7 +76,7 @@ The file path.
 
 `string`
 
-The resolved path.
+The resolved absolute path.
 
 ***
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/tools-core",
-	"version": "0.0.4-next.3",
+	"version": "0.9.0-next.1",
 	"description": "Shared utilities and models for tooling packages",
 	"repository": {
 		"type": "git",
@@ -14,9 +14,9 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/core": "next",
-		"@twin.org/nameof": "next",
-		"@twin.org/tools-models": "0.0.4-next.3",
+		"@twin.org/core": "0.9.0-next.1",
+		"@twin.org/nameof": "0.9.0-next.1",
+		"@twin.org/tools-models": "0.9.0-next.1",
 		"glob": "13.0.6"
 	},
 	"main": "./dist/es/index.js",