@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/classes/PromptTemplate.md

@@ -6,7 +6,7 @@
 
 # Class: PromptTemplate
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:50
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:51
 
 The `StringTemplate` class is a versatile template engine that supports dynamic template creation,
 formatting, and partial data processing. It extends the `BaseFactory` class and provides methods
@@ -52,7 +52,7 @@ console.log(result); // Output: "Formatted: Hello World"
 
 > **new PromptTemplate**(`template?`, `options?`): `StringTemplate`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:187
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:252
 
 Initializes a new instance of the `StringTemplate` class.
 
@@ -94,7 +94,7 @@ console.log(template instanceof TestStringTemplate); // Output: true
 
 > **compiledTemplate**: `any`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:54
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:55
 
 Declares the compiled template instance.
 
@@ -102,9 +102,9 @@ Declares the compiled template instance.
 
 ### data
 
-> **data**: `undefined` \| `Record`\<`string`, `any`\>
+> **data**: `Record`\<`string`, `any`\> \| `undefined`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:66
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:67
 
 Declares the data object used for template interpolation.
 
@@ -112,19 +112,29 @@ Declares the data object used for template interpolation.
 
 ### inputVariables
 
-> **inputVariables**: `undefined` \| `string`[]
+> **inputVariables**: `string`[] \| `undefined`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:70
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:71
 
 Declares the list of input variables expected by the template.
 
 ***
 
+### raw
+
+> **raw**: `boolean` \| `undefined`
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:75
+
+Declares whether to return the raw value if the template is a pure placeholder.
+
+***
+
 ### template
 
 > **template**: `string`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:58
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:59
 
 Declares the raw template string.
 
@@ -132,9 +142,9 @@ Declares the raw template string.
 
 ### templateFormat
 
-> **templateFormat**: `undefined` \| `string`
+> **templateFormat**: `string` \| `undefined`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:62
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:63
 
 Declares the format of the template (e.g., 'default').
 
@@ -302,7 +312,7 @@ The Root Factory class
 
 > **\_format**(`data`): `string` \| `Promise`\<`string`\>
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:203
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:268
 
 Placeholder method for formatting the template. Must be implemented by subclasses.
 
@@ -326,7 +336,7 @@ A formatted string or a promise resolving to the formatted string.
 
 > **\_initialize**(`options?`): `void`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:192
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:257
 
 Placeholder method for initializing the template. Must be implemented by subclasses.
 
@@ -348,7 +358,7 @@ Configuration options for initialization.
 
 > **filterData**(`data`): `Record`\<`string`, `any`\>
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:172
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:237
 
 Filters the input data to include only the specified input variables.
 
@@ -380,9 +390,9 @@ console.log(filteredData); // Output: { name: "Alice" }
 
 ### format()
 
-> **format**(`data?`): `Promise`\<`string`\>
+> **format**(`data?`, `visited?`): `Promise`\<`any`\>
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:219
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:284
 
 Formats the template using the provided data, supporting asynchronous processing.
 
@@ -394,9 +404,13 @@ Formats the template using the provided data, supporting asynchronous processing
 
 The data object used for interpolation.
 
+##### visited?
+
+`Set`\<`any`\>
+
 #### Returns
 
-`Promise`\<`string`\>
+`Promise`\<`any`\>
 
 A promise that resolves to the formatted template string.
 
@@ -413,11 +427,27 @@ console.log(result); // Output: "Hello"
 
 ***
 
+### getPurePlaceholderVariable()
+
+> **getPurePlaceholderVariable**(): `string` \| `undefined`
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:200
+
+Returns the variable name if this template instance is a pure placeholder.
+
+#### Returns
+
+`string` \| `undefined`
+
+The variable name if the template is a pure placeholder, undefined otherwise.
+
+***
+
 ### initialize()
 
 > **initialize**(`options?`): `void`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:197
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:262
 
 Initializes the template instance with the provided options.
 
@@ -439,11 +469,27 @@ Configuration options for initialization.
 
 ***
 
+### isPurePlaceholder()
+
+> **isPurePlaceholder**(): `boolean`
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:222
+
+Checks if this template instance is a pure placeholder.
+
+#### Returns
+
+`boolean`
+
+True if the template is a pure placeholder, false otherwise.
+
+***
+
 ### partial()
 
 > **partial**(`data`): `StringTemplate`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:247
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:312
 
 Creates a new `StringTemplate` instance with partially filled data.
 This is useful for pre-filling some variables while leaving others to be filled later.
@@ -486,11 +532,47 @@ console.log(dateResult.date instanceof Date); // Output: true
 
 ***
 
+### renderRawValue()
+
+> **renderRawValue**(`value`, `data`, `visited?`): `Promise`\<`any`\>
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:214
+
+Renders the raw value recursively, resolving any nested templates.
+
+#### Parameters
+
+##### value
+
+`any`
+
+The value to render.
+
+##### data
+
+`Record`\<`string`, `any`\>
+
+The data object used for interpolation.
+
+##### visited?
+
+`Set`\<`any`\>
+
+A set to track visited objects to avoid infinite recursion.
+
+#### Returns
+
+`Promise`\<`any`\>
+
+A promise that resolves to the rendered raw value.
+
+***
+
 ### toJSON()
 
 > **toJSON**(`options?`): [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:264
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:329
 
 Serializes the `StringTemplate` instance into a JSON-compatible object.
 
@@ -524,7 +606,7 @@ console.log(serialized);
 
 ### \_findRootFactory()
 
-> `static` **\_findRootFactory**(`aClass`): `undefined` \| *typeof* `BaseFactory`
+> `static` **\_findRootFactory**(`aClass`): *typeof* `BaseFactory` \| `undefined`
 
 Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:99
 
@@ -542,7 +624,7 @@ the abstract root factory class
 
 #### Returns
 
-`undefined` \| *typeof* `BaseFactory`
+*typeof* `BaseFactory` \| `undefined`
 
 #### Inherited from
 
@@ -622,7 +704,7 @@ remove all aliases of the registered item or itself
 
 the registered item or name
 
-`undefined` | `string` | *typeof* `BaseFactory`
+`string` | *typeof* `BaseFactory` | `undefined`
 
 #### Returns
 
@@ -636,7 +718,7 @@ the registered item or name
 
 ### createObject()
 
-> `static` **createObject**(`aName`, `aOptions`): `undefined` \| `BaseFactory`
+> `static` **createObject**(`aName`, `aOptions`): `BaseFactory` \| `undefined`
 
 Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:241
 
@@ -654,7 +736,7 @@ Create a new object instance of Factory
 
 #### Returns
 
-`undefined` \| `BaseFactory`
+`BaseFactory` \| `undefined`
 
 #### Inherited from
 
@@ -664,7 +746,7 @@ Create a new object instance of Factory
 
 ### findRootFactory()
 
-> `abstract` `static` **findRootFactory**(): `undefined` \| *typeof* `BaseFactory`
+> `abstract` `static` **findRootFactory**(): *typeof* `BaseFactory` \| `undefined`
 
 Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:92
 
@@ -677,7 +759,7 @@ or set _Factory directly.
 
 #### Returns
 
-`undefined` \| *typeof* `BaseFactory`
+*typeof* `BaseFactory` \| `undefined`
 
 the root factory class
 
@@ -699,7 +781,7 @@ executes a provided callback function once for each registered element.
 
 ##### cb
 
-(`ctor`, `name`) => `undefined` \| `string`
+(`ctor`, `name`) => `string` \| `undefined`
 
 the forEach callback function
 
@@ -715,9 +797,9 @@ the forEach callback function
 
 ### format()
 
-> `static` **format**(`options`): `Promise`\<`string`\>
+> `static` **format**(`options`): `Promise`\<`any`\>
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:102
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:107
 
 Formats a template using the provided options.
 
@@ -731,7 +813,7 @@ Configuration options for the template.
 
 #### Returns
 
-`Promise`\<`string`\>
+`Promise`\<`any`\>
 
 A promise that resolves to the formatted template string.
 
@@ -750,9 +832,9 @@ console.log(result); // Output: "Hello"
 
 ### formatIf()
 
-> `static` **formatIf**(`options`): `Promise`\<`undefined` \| `string`\>
+> `static` **formatIf**(`options`): `Promise`\<`any`\>
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:118
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:123
 
 Formats a template if the provided options represent a valid template.
 
@@ -766,7 +848,7 @@ Configuration options to check and format.
 
 #### Returns
 
-`Promise`\<`undefined` \| `string`\>
+`Promise`\<`any`\>
 
 A promise that resolves to the formatted template string if valid; otherwise, undefined.
 
@@ -847,7 +929,7 @@ the name to register
 
 > `static` **from**(`template?`, `options?`): `StringTemplate`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:86
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:91
 
 Creates a new instance of the `StringTemplate` class.
 
@@ -885,7 +967,7 @@ console.log(template instanceof TestStringTemplate); // Output: true
 
 ### get()
 
-> `static` **get**(`name`): `undefined` \| *typeof* `BaseFactory`
+> `static` **get**(`name`): *typeof* `BaseFactory` \| `undefined`
 
 Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:233
 
@@ -899,7 +981,7 @@ Get the registered class via name
 
 #### Returns
 
-`undefined` \| *typeof* `BaseFactory`
+*typeof* `BaseFactory` \| `undefined`
 
 return the registered class if found the name
 
@@ -923,7 +1005,7 @@ get the aliases of the aClass
 
 the class or name to get aliases, means itself if no aClass specified
 
-`undefined` | `string` | *typeof* `BaseFactory`
+`string` | *typeof* `BaseFactory` | `undefined`
 
 #### Returns
 
@@ -939,7 +1021,7 @@ aliases
 
 ### getDisplayName()
 
-> `static` **getDisplayName**(`aClass`): `undefined` \| `string`
+> `static` **getDisplayName**(`aClass`): `string` \| `undefined`
 
 Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:206
 
@@ -951,11 +1033,11 @@ Get the display name from aClass
 
 the class, name or itself, means itself if no aClass
 
-`undefined` | `string` | `Function`
+`string` | `Function` | `undefined`
 
 #### Returns
 
-`undefined` \| `string`
+`string` \| `undefined`
 
 #### Inherited from
 
@@ -989,6 +1071,38 @@ the unique name in the factory
 
 ***
 
+### getPurePlaceholderVariable()
+
+> `static` **getPurePlaceholderVariable**(`templateOpt`): `string` \| `undefined`
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:176
+
+Returns the variable name if the template is a pure placeholder.
+
+#### Parameters
+
+##### templateOpt
+
+The template options or template string to check.
+
+`string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+
+#### Returns
+
+`string` \| `undefined`
+
+The variable name if the template is a pure placeholder, undefined otherwise.
+
+#### Example
+
+```typescript
+StringTemplate.getPurePlaceholderVariable("{{text}}"); // "text"
+StringTemplate.getPurePlaceholderVariable("  {{text}}  "); // "text"
+StringTemplate.getPurePlaceholderVariable("Hello {{text}}"); // undefined
+```
+
+***
+
 ### getRealName()
 
 > `static` **getRealName**(`name`): `any`
@@ -1013,7 +1127,7 @@ Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_module
 
 ### getRealNameFromAlias()
 
-> `static` **getRealNameFromAlias**(`alias`): `undefined` \| `string`
+> `static` **getRealNameFromAlias**(`alias`): `string` \| `undefined`
 
 Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:106
 
@@ -1029,7 +1143,7 @@ the alias name
 
 #### Returns
 
-`undefined` \| `string`
+`string` \| `undefined`
 
 the unique name in the factory
 
@@ -1039,11 +1153,45 @@ the unique name in the factory
 
 ***
 
+### isPurePlaceholder()
+
+> `static` **isPurePlaceholder**(`templateOpt`): `boolean`
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:192
+
+Checks if the template string is a pure placeholder (optionally surrounded by whitespace).
+A pure placeholder means the template contains only one template segment and no other text.
+
+#### Parameters
+
+##### templateOpt
+
+The template options or template string to check.
+
+`string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+
+#### Returns
+
+`boolean`
+
+True if the template is a pure placeholder, false otherwise.
+
+#### Example
+
+```typescript
+StringTemplate.isPurePlaceholder("{{text}}"); // true
+StringTemplate.isPurePlaceholder("  {{text}}  "); // true
+StringTemplate.isPurePlaceholder("Hello {{text}}"); // false
+StringTemplate.isPurePlaceholder("{{text1}}{{text2}}"); // false
+```
+
+***
+
 ### isTemplate()
 
 > `static` **isTemplate**(`templateOpt`): `any`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:133
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:138
 
 Determines whether the given options represent a valid template.
 
@@ -1075,9 +1223,9 @@ console.log(isValid); // Output: true
 
 ### matchTemplateSegment()
 
-> `static` **matchTemplateSegment**(`templateOpt`, `index?`): `undefined` \| `RegExpExecArray`
+> `static` **matchTemplateSegment**(`templateOpt`, `index?`): `RegExpExecArray` \| `undefined`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:157
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:162
 
 Matches and extracts a single template segment from the provided template options.
 This method is designed to identify individual segments of a template string.
@@ -1099,7 +1247,7 @@ The default starting position in the template string to begin matching (default:
 
 #### Returns
 
-`undefined` \| `RegExpExecArray`
+`RegExpExecArray` \| `undefined`
 
 A `RegExpExecArray` representing the matched template segment, or `undefined` if no match is found.
          The `index` property of the result can be used to calculate the next position for iteration.
@@ -1157,7 +1305,7 @@ Check the name, alias or itself whether registered.
 
 the class name
 
-`undefined` | `string`
+`string` | `undefined`
 
 #### Returns
 
@@ -1211,7 +1359,7 @@ set alias to a class
 
 the class to set alias
 
-`undefined` | `string` | *typeof* `BaseFactory`
+`string` | *typeof* `BaseFactory` | `undefined`
 
 ##### alias
 
@@ -1241,7 +1389,7 @@ set aliases to a class
 
 the class to set aliases
 
-`undefined` | `string` | *typeof* `BaseFactory`
+`string` | *typeof* `BaseFactory` | `undefined`
 
 ##### aAliases
 
@@ -1283,7 +1431,7 @@ Set the display name to the aClass
 
 the class, name or itself, means itself if no aClass
 
-`undefined` | `string` | `Function`
+`string` | `Function` | `undefined`
 
 ##### aDisplayName
 
@@ -1315,7 +1463,7 @@ unregister this class in the factory
 
 the registered name or class, no name means unregister itself.
 
-`undefined` | `string` | `Function`
+`string` | `Function` | `undefined`
 
 #### Returns
 

package/docs/api/classes/ReadableStreamError.md

@@ -6,7 +6,7 @@
 
 # Class: ReadableStreamError
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/error-readable-stream.ts:6](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/stream/error-readable-stream.ts#L6)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/error-readable-stream.ts:6](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/stream/error-readable-stream.ts#L6)
 
 BaseError class that extends the Error class.
 
@@ -47,7 +47,7 @@ fromJSON - Creates a new BaseError instance from a JSON representation.
 
 > **new ReadableStreamError**(`msg`, `code`): `ReadableStreamError`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/error-readable-stream.ts:7](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/stream/error-readable-stream.ts#L7)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/error-readable-stream.ts:7](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/stream/error-readable-stream.ts#L7)
 
 #### Parameters