@twin.org/tools-core 0.0.3-next.14 → 0.0.3-next.16

package/docs/reference/classes/FileUtils.md

@@ -0,0 +1,237 @@
+# Class: FileUtils
+
+Utility helpers for TypeScript file and directory paths.
+
+## Constructors
+
+### Constructor
+
+> **new FileUtils**(): `FileUtils`
+
+#### Returns
+
+`FileUtils`
+
+## Methods
+
+### fileExists() {#fileexists}
+
+> `static` **fileExists**(`filePath`): `boolean`
+
+Does the file exist.
+
+#### Parameters
+
+##### filePath
+
+`string`
+
+The file path.
+
+#### Returns
+
+`boolean`
+
+True if the file exists.
+
+***
+
+### readFile() {#readfile}
+
+> `static` **readFile**(`filePath`): `string`
+
+Read the file.
+
+#### Parameters
+
+##### filePath
+
+`string`
+
+The file path.
+
+#### Returns
+
+`string`
+
+The file contents.
+
+***
+
+### resolvePath() {#resolvepath}
+
+> `static` **resolvePath**(`filePath`): `string`
+
+Resolve a path.
+
+#### Parameters
+
+##### filePath
+
+`string`
+
+The file path.
+
+#### Returns
+
+`string`
+
+The resolved path.
+
+***
+
+### getCurrentWorkingDirectory() {#getcurrentworkingdirectory}
+
+> `static` **getCurrentWorkingDirectory**(): `string`
+
+Get the current working directory.
+
+#### Returns
+
+`string`
+
+The current working directory.
+
+***
+
+### normalizeFilePath() {#normalizefilepath}
+
+> `static` **normalizeFilePath**(`filePath`): `string`
+
+Normalize path separators for consistent comparisons.
+
+#### Parameters
+
+##### filePath
+
+`string`
+
+The file path.
+
+#### Returns
+
+`string`
+
+The normalized file path.
+
+***
+
+### getDirectoryPath() {#getdirectorypath}
+
+> `static` **getDirectoryPath**(`filePath`): `string`
+
+Get the directory portion of a file path.
+
+#### Parameters
+
+##### filePath
+
+`string`
+
+The file path.
+
+#### Returns
+
+`string`
+
+The directory path.
+
+***
+
+### resolveRelativePath() {#resolverelativepath}
+
+> `static` **resolveRelativePath**(`baseDirectory`, `relativePath`): `string`
+
+Resolve a relative path against a base directory.
+
+#### Parameters
+
+##### baseDirectory
+
+`string`
+
+The base directory.
+
+##### relativePath
+
+`string`
+
+The relative path.
+
+#### Returns
+
+`string`
+
+The resolved path.
+
+***
+
+### resolveImportSourceFilePath() {#resolveimportsourcefilepath}
+
+> `static` **resolveImportSourceFilePath**(`sourceFilePath`, `importPath`): `string` \| `undefined`
+
+Resolve a local import specifier to a TypeScript source file path.
+
+#### Parameters
+
+##### sourceFilePath
+
+`string`
+
+The importing source file path.
+
+##### importPath
+
+`string`
+
+The import specifier.
+
+#### Returns
+
+`string` \| `undefined`
+
+The resolved source file path.
+
+***
+
+### isGlobPattern() {#isglobpattern}
+
+> `static` **isGlobPattern**(`sourceFileOrGlob`): `boolean`
+
+Determine if the provided path includes glob pattern tokens.
+
+#### Parameters
+
+##### sourceFileOrGlob
+
+`string`
+
+The direct source file path or glob pattern.
+
+#### Returns
+
+`boolean`
+
+True if the value is a glob pattern.
+
+***
+
+### resolveSourceFiles() {#resolvesourcefiles}
+
+> `static` **resolveSourceFiles**(`sourceFileOrGlob`): `string`[]
+
+Resolve source files from a direct path or a glob pattern.
+
+#### Parameters
+
+##### sourceFileOrGlob
+
+`string`
+
+The direct source file path or glob pattern.
+
+#### Returns
+
+`string`[]
+
+The resolved source file paths.

package/docs/reference/classes/ImportTypeQuerySchemaResolver.md

@@ -0,0 +1,87 @@
+# Class: ImportTypeQuerySchemaResolver
+
+Static helpers for import type and type query schema resolution.
+
+## Constructors
+
+### Constructor
+
+> **new ImportTypeQuerySchemaResolver**(): `ImportTypeQuerySchemaResolver`
+
+#### Returns
+
+`ImportTypeQuerySchemaResolver`
+
+## Methods
+
+### mapImportTypeNodeToSchema() {#mapimporttypenodetoschema}
+
+> `static` **mapImportTypeNodeToSchema**(`context`, `typeNode`): `IJsonSchema` \| `undefined`
+
+Map import type nodes (e.g. import("pkg").Type) to schema references.
+
+#### Parameters
+
+##### context
+
+[`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
+
+##### typeNode
+
+`ImportTypeNode`
+
+#### Returns
+
+`IJsonSchema` \| `undefined`
+
+***
+
+### mapTypeQueryNodeToSchema() {#maptypequerynodetoschema}
+
+> `static` **mapTypeQueryNodeToSchema**(`context`, `typeNode`): `IJsonSchema`
+
+Map a type query node (typeof expr) to schema by resolving the referenced variable.
+
+#### Parameters
+
+##### context
+
+[`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
+
+##### typeNode
+
+`TypeQueryNode`
+
+#### Returns
+
+`IJsonSchema`
+
+***
+
+### resolveImportTypeReferenceSchemaId() {#resolveimporttypereferenceschemaid}
+
+> `static` **resolveImportTypeReferenceSchemaId**(`context`, `moduleSpecifier`, `typeName`, `title`): `string` \| `undefined`
+
+Resolve import-type references to local or external schema ids.
+
+#### Parameters
+
+##### context
+
+[`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
+
+##### moduleSpecifier
+
+`string`
+
+##### typeName
+
+`string`
+
+##### title
+
+`string`
+
+#### Returns
+
+`string` \| `undefined`

package/docs/reference/classes/IndexSignaturePatternResolver.md

@@ -0,0 +1,69 @@
+# Class: IndexSignaturePatternResolver
+
+Resolves regex patterns for index signature key types.
+
+## Constructors
+
+### Constructor
+
+> **new IndexSignaturePatternResolver**(): `IndexSignaturePatternResolver`
+
+#### Returns
+
+`IndexSignaturePatternResolver`
+
+## Methods
+
+### isSupportedIndexSignature() {#issupportedindexsignature}
+
+> `static` **isSupportedIndexSignature**(`member`): `boolean`
+
+Determine whether an index signature can be represented as JSON object additionalProperties.
+
+#### Parameters
+
+##### member
+
+`IndexSignatureDeclaration`
+
+The index signature declaration.
+
+#### Returns
+
+`boolean`
+
+True if supported.
+
+***
+
+### extractIndexSignaturePattern() {#extractindexsignaturepattern}
+
+> `static` **extractIndexSignaturePattern**(`context`, `member`, `getTypeParameterBinding`): `string` \| `undefined`
+
+Extract a regex pattern for an index signature key type when representable.
+
+#### Parameters
+
+##### context
+
+[`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
+
+The generation context.
+
+##### member
+
+`IndexSignatureDeclaration`
+
+The index signature declaration.
+
+##### getTypeParameterBinding
+
+(`context`, `typeName`) => `TypeNode` \| `null` \| `undefined`
+
+Callback for resolving generic bindings.
+
+#### Returns
+
+`string` \| `undefined`
+
+The property-name pattern, if derivable.

package/docs/reference/classes/IntersectionSchemaMerger.md

@@ -0,0 +1,48 @@
+# Class: IntersectionSchemaMerger
+
+Merges compatible object intersections into a single JSON schema object.
+
+## Constructors
+
+### Constructor
+
+> **new IntersectionSchemaMerger**(): `IntersectionSchemaMerger`
+
+#### Returns
+
+`IntersectionSchemaMerger`
+
+## Methods
+
+### mergeIntersectionObjectSchemas() {#mergeintersectionobjectschemas}
+
+> `static` **mergeIntersectionObjectSchemas**(`context`, `schemas`, `toInlineUtilityObjectSchema`): `IJsonSchema` \| `undefined`
+
+Merge simple object intersection parts into a single object schema.
+Supports local/known object refs by expanding them before merge.
+
+#### Parameters
+
+##### context
+
+[`ITypeScriptToSchemaContext`](../interfaces/ITypeScriptToSchemaContext.md)
+
+The generation context.
+
+##### schemas
+
+`IJsonSchema`[]
+
+The mapped intersection schemas.
+
+##### toInlineUtilityObjectSchema
+
+(`schema`) => `IJsonSchema`
+
+Callback for converting referenced schemas to inline forms.
+
+#### Returns
+
+`IJsonSchema` \| `undefined`
+
+The merged schema, or undefined when merge is not safe.