@isdk/ai-tool 0.5.8 → 0.7.0

package/docs/{classes → api/classes}/EnvPromptTemplate.md

@@ -6,7 +6,34 @@
 
 # Class: EnvPromptTemplate
 
-Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:5](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/env-prompt-template.ts#L5)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:657
+
+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
+for handling template strings, validating input variables, and managing template configurations.
+
+## Example
+
+```typescript
+import { StringTemplate } from './template';
+
+// Register a custom template class
+class CustomTemplate extends StringTemplate {
+  _initialize(options?: StringTemplateOptions): void {}
+  _format(data: Record<string, any>): string {
+    return `Formatted: ${data.text}`;
+  }
+}
+StringTemplate.register(CustomTemplate);
+
+// Create a new instance with a custom template format
+const template = new StringTemplate("{{text}}", { templateFormat: "Custom" });
+console.log(template instanceof CustomTemplate); // Output: true
+
+// Format the template with data
+const result = await template.format({ text: "Hello World" });
+console.log(result); // Output: "Formatted: Hello World"
+```
 
 ## Extends
 
@@ -18,22 +45,38 @@ Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:5](https:/
 
 > **new EnvPromptTemplate**(`template`?, `options`?): [`EnvPromptTemplate`](EnvPromptTemplate.md)
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:69](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L69)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:187
+
+Initializes a new instance of the `StringTemplate` class.
 
 #### Parameters
 
 ##### template?
 
+Either a template string or an options object.
+
 `string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
 ##### options?
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Additional configuration options for the template.
+
 #### Returns
 
 [`EnvPromptTemplate`](EnvPromptTemplate.md)
 
+#### Example
+
+```typescript
+const template = new StringTemplate("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+console.log(template instanceof TestStringTemplate); // Output: true
+```
+
 #### Inherited from
 
 [`PromptTemplate`](PromptTemplate.md).[`constructor`](PromptTemplate.md#constructors)
@@ -44,7 +87,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:69](https://gi
 
 > **compiledTemplate**: `any`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:21](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L21)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:54
+
+Declares the compiled template instance.
 
 #### Inherited from
 
@@ -56,7 +101,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:21](https://gi
 
 > **data**: `undefined` \| `Record`\<`string`, `any`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:24](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L24)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:66
+
+Declares the data object used for template interpolation.
 
 #### Inherited from
 
@@ -68,7 +115,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:24](https://gi
 
 > **inputVariables**: `undefined` \| `string`[]
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:25](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L25)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:70
+
+Declares the list of input variables expected by the template.
 
 #### Inherited from
 
@@ -80,7 +129,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:25](https://gi
 
 > **template**: `string`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:22](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L22)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:58
+
+Declares the raw template string.
 
 #### Inherited from
 
@@ -92,7 +143,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:22](https://gi
 
 > **templateFormat**: `undefined` \| `string`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:23](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L23)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:62
+
+Declares the format of the template (e.g., 'default').
 
 #### Inherited from
 
@@ -104,7 +157,7 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:23](https://gi
 
 > `abstract` `static` **\_aliases**: \[`string`\]
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:59
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:59
 
 **`Internal`**
 
@@ -121,7 +174,7 @@ the key is alias name, the value is the registered name
 
 > `static` **\_baseNameOnly**: `number`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:82
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:82
 
 **`Internal`**
 
@@ -162,7 +215,7 @@ _baseNameOnly
 
 > `abstract` `static` **\_children**: `object`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:49
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:49
 
 **`Internal`**
 
@@ -186,7 +239,7 @@ _children
 
 > `abstract` `static` **\_Factory**: *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:41
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:41
 
 **`Internal`**
 
@@ -208,7 +261,7 @@ _Factory
 
 > **get** `static` **aliases**(): `string`[]
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:200
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:200
 
 the aliases of itself
 
@@ -220,7 +273,7 @@ the aliases of itself
 
 > **set** `static` **aliases**(`value`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:196
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:196
 
 ##### Parameters
 
@@ -244,7 +297,7 @@ Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factor
 
 > **get** `static` **Factory**(): *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:63
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:63
 
 The Root Factory class
 
@@ -262,7 +315,9 @@ The Root Factory class
 
 > **\_format**(`data`): `string`
 
-Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:35](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/env-prompt-template.ts#L35)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:662
+
+Placeholder method for formatting the template. Must be implemented by subclasses.
 
 #### Parameters
 
@@ -270,10 +325,14 @@ Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:35](https:
 
 `Record`\<`string`, `any`\>
 
+The data object used for interpolation.
+
 #### Returns
 
 `string`
 
+A formatted string or a promise resolving to the formatted string.
+
 #### Overrides
 
 [`PromptTemplate`](PromptTemplate.md).[`_format`](PromptTemplate.md#_format)
@@ -284,7 +343,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:35](https:
 
 > **\_initialize**(`options`?): `void`
 
-Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:27](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/env-prompt-template.ts#L27)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:661
+
+Placeholder method for initializing the template. Must be implemented by subclasses.
 
 #### Parameters
 
@@ -292,6 +353,8 @@ Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:27](https:
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Configuration options for initialization.
+
 #### Returns
 
 `void`
@@ -306,9 +369,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:27](https:
 
 > **filterData**(`data`): `Record`\<`string`, `any`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:62](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L62)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:172
 
-Validate/filter the data in inputVariables
+Filters the input data to include only the specified input variables.
 
 #### Parameters
 
@@ -316,10 +379,24 @@ Validate/filter the data in inputVariables
 
 `Record`\<`string`, `any`\>
 
+The data object to validate and filter.
+
 #### Returns
 
 `Record`\<`string`, `any`\>
 
+The filtered data object containing only the allowed keys.
+
+#### Example
+
+```typescript
+const template = new StringTemplate({
+  inputVariables: ['name']
+});
+const filteredData = template.filterData({ name: "Alice", age: 30 });
+console.log(filteredData); // Output: { name: "Alice" }
+```
+
 #### Inherited from
 
 [`PromptTemplate`](PromptTemplate.md).[`filterData`](PromptTemplate.md#filterdata)
@@ -330,7 +407,9 @@ Validate/filter the data in inputVariables
 
 > **format**(`data`?): `Promise`\<`string`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:109](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L109)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:219
+
+Formats the template using the provided data, supporting asynchronous processing.
 
 #### Parameters
 
@@ -338,10 +417,25 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:109](https://g
 
 `Record`\<`string`, `any`\>
 
+The data object used for interpolation.
+
 #### Returns
 
 `Promise`\<`string`\>
 
+A promise that resolves to the formatted template string.
+
+#### Example
+
+```typescript
+const template = new StringTemplate("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+const result = await template.format({ text: "Hello" });
+console.log(result); // Output: "Hello"
+```
+
 #### Inherited from
 
 [`PromptTemplate`](PromptTemplate.md).[`format`](PromptTemplate.md#format)
@@ -350,15 +444,15 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:109](https://g
 
 ### getVariables()
 
-> **getVariables**(`template`): `string`[]
+> **getVariables**(`template`?): `string`[]
 
-Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:23](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/env-prompt-template.ts#L23)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:660
 
 #### Parameters
 
-##### template
+##### template?
 
-`string` = `...`
+`string`
 
 #### Returns
 
@@ -368,13 +462,11 @@ Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:23](https:
 
 ### initialize()
 
-> `abstract` **initialize**(`options`?): `void`
-
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:96](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L96)
+> **initialize**(`options`?): `void`
 
-**`Internal`**
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:197
 
-initialize instance method
+Initializes the template instance with the provided options.
 
 #### Parameters
 
@@ -382,6 +474,8 @@ initialize instance method
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Configuration options for initialization.
+
 #### Returns
 
 `void`
@@ -396,9 +490,10 @@ initialize instance method
 
 > **partial**(`data`): [`PromptTemplate`](PromptTemplate.md)
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:139](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L139)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:247
 
-it can make sense to "partial" a prompt template - eg pass in a subset of the required values, as to create a new prompt template which expects only the remaining subset of values.
+Creates a new `StringTemplate` instance with partially filled data.
+This is useful for pre-filling some variables while leaving others to be filled later.
 
 #### Parameters
 
@@ -406,13 +501,35 @@ it can make sense to "partial" a prompt template - eg pass in a subset of the re
 
 `Record`\<`string`, `any`\>
 
-the partial data
+The partial data to pre-fill in the new template.
 
 #### Returns
 
 [`PromptTemplate`](PromptTemplate.md)
 
-the new partial PromptTemplate instance
+A new `StringTemplate` instance with the partial data applied.
+
+#### Example
+
+```typescript
+const template = new StringTemplate("{{role}}:{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['role', 'text']
+});
+const partialTemplate = template.partial({ role: "user" });
+console.log(partialTemplate.data); // Output: { role: "user" }
+const result = await partialTemplate.format({ text: "Hello" });
+console.log(result); // Output: { role: "user", text: "Hello" }
+
+// Example with a function
+function getDate() {
+  return new Date();
+}
+const dateTemplate = template.partial({ date: getDate });
+console.log(dateTemplate.data); // Output: { date: getDate }
+const dateResult = await dateTemplate.format({ role: "user" });
+console.log(dateResult.date instanceof Date); // Output: true
+```
 
 #### Inherited from
 
@@ -422,20 +539,38 @@ the new partial PromptTemplate instance
 
 ### toJSON()
 
-> **toJSON**(`options`): [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+> **toJSON**(`options`?): [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:264
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:147](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L147)
+Serializes the `StringTemplate` instance into a JSON-compatible object.
 
 #### Parameters
 
-##### options
+##### options?
+
+[`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
-[`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md) = `...`
+Optional configuration for serialization.
 
 #### Returns
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+A JSON-compatible object representing the template's state.
+
+#### Example
+
+```typescript
+const template = new StringTemplate("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+const serialized = template.toJSON();
+console.log(serialized);
+// Output: { template: "{{text}}", templateFormat: "Test", inputVariables: ['text'] }
+```
+
 #### Inherited from
 
 [`PromptTemplate`](PromptTemplate.md).[`toJSON`](PromptTemplate.md#tojson)
@@ -446,7 +581,7 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:147](https://g
 
 > `static` **\_findRootFactory**(`aClass`): `undefined` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:99
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:99
 
 **`Internal`**
 
@@ -474,7 +609,7 @@ the abstract root factory class
 
 > `static` **\_get**(`name`): `any`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:234
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:234
 
 #### Parameters
 
@@ -496,7 +631,7 @@ Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factor
 
 > `static` **\_register**(`aClass`, `aOptions`?): `boolean`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:145
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:145
 
 **`Internal`**
 
@@ -532,7 +667,7 @@ return true if successful.
 
 > `static` **cleanAliases**(`aName`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:162
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:162
 
 remove all aliases of the registered item or itself
 
@@ -558,7 +693,7 @@ the registered item or name
 
 > `static` **createObject**(`aName`, `aOptions`): `undefined` \| `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:241
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:241
 
 Create a new object instance of Factory
 
@@ -586,7 +721,7 @@ Create a new object instance of Factory
 
 > `abstract` `static` **findRootFactory**(): `undefined` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:92
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:92
 
 **`Internal`**
 
@@ -611,7 +746,7 @@ the root factory class
 
 > `static` **forEach**(`cb`): `any`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:227
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:227
 
 executes a provided callback function once for each registered element.
 
@@ -637,7 +772,9 @@ the forEach callback function
 
 > `static` **format**(`options`): `Promise`\<`string`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:31](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L31)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:102
+
+Formats a template using the provided options.
 
 #### Parameters
 
@@ -645,10 +782,25 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:31](https://gi
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Configuration options for the template.
+
 #### Returns
 
 `Promise`\<`string`\>
 
+A promise that resolves to the formatted template string.
+
+#### Example
+
+```typescript
+const result = await StringTemplate.format({
+  template: "{{text}}",
+  data: { text: "Hello" },
+  templateFormat: "Test"
+});
+console.log(result); // Output: "Hello"
+```
+
 #### Inherited from
 
 [`PromptTemplate`](PromptTemplate.md).[`format`](PromptTemplate.md#format-2)
@@ -659,9 +811,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:31](https://gi
 
 > `static` **formatIf**(`options`): `Promise`\<`undefined` \| `string`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:41](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L41)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:118
 
-If the given options.template is the template, perform formatting using that template.
+Formats a template if the provided options represent a valid template.
 
 #### Parameters
 
@@ -669,13 +821,24 @@ If the given options.template is the template, perform formatting using that tem
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
-The options object to check for being a template and to format.
+Configuration options to check and format.
 
 #### Returns
 
 `Promise`\<`undefined` \| `string`\>
 
-A Promise that resolves to the formatted result if options is a template; otherwise, no value is returned.
+A promise that resolves to the formatted template string if valid; otherwise, undefined.
+
+#### Example
+
+```typescript
+const result = await StringTemplate.formatIf({
+  template: "{{text}}",
+  data: { text: "Valid Template" },
+  templateFormat: "Test"
+});
+console.log(result); // Output: "Valid Template"
+```
 
 #### Inherited from
 
@@ -687,7 +850,7 @@ A Promise that resolves to the formatted result if options is a template; otherw
 
 > `abstract` `static` **formatName**(`aName`): `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:116
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:116
 
 **`Internal`**
 
@@ -715,7 +878,7 @@ defaults to returning the name unchanged. By overloading this method, case-insen
 
 > `static` **formatNameFromClass**(`aClass`, `aBaseNameOnly`?): `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:130
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:130
 
 **`Internal`**
 
@@ -747,22 +910,40 @@ the name to register
 
 > `static` **from**(`template`?, `options`?): [`PromptTemplate`](PromptTemplate.md)
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:27](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L27)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:86
+
+Creates a new instance of the `StringTemplate` class.
 
 #### Parameters
 
 ##### template?
 
+Either a template string or an options object.
+
 `string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
 ##### options?
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Additional configuration options for the template.
+
 #### Returns
 
 [`PromptTemplate`](PromptTemplate.md)
 
+A new `StringTemplate` instance.
+
+#### Example
+
+```typescript
+const template = StringTemplate.from("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+console.log(template instanceof TestStringTemplate); // Output: true
+```
+
 #### Inherited from
 
 [`PromptTemplate`](PromptTemplate.md).[`from`](PromptTemplate.md#from)
@@ -773,7 +954,7 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:27](https://gi
 
 > `static` **get**(`name`): `undefined` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:233
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:233
 
 Get the registered class via name
 
@@ -799,7 +980,7 @@ return the registered class if found the name
 
 > `static` **getAliases**(`aClass`): `string`[]
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:195
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:195
 
 get the aliases of the aClass
 
@@ -827,7 +1008,7 @@ aliases
 
 > `static` **getDisplayName**(`aClass`): `undefined` \| `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:206
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:206
 
 Get the display name from aClass
 
@@ -853,7 +1034,7 @@ the class, name or itself, means itself if no aClass
 
 > `static` **getNameFrom**(`aClass`): `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:122
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:122
 
 Get the unique(registered) name in the factory
 
@@ -879,7 +1060,7 @@ the unique name in the factory
 
 > `static` **getRealName**(`name`): `any`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:100
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:100
 
 #### Parameters
 
@@ -901,7 +1082,7 @@ Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factor
 
 > `static` **getRealNameFromAlias**(`alias`): `undefined` \| `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:106
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:106
 
 get the unique name in the factory from an alias name
 
@@ -929,29 +1110,91 @@ the unique name in the factory
 
 > `static` **isTemplate**(`templateOpt`): `boolean`
 
-Defined in: [packages/ai-tool/src/utils/prompt/env-prompt-template.ts:7](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/env-prompt-template.ts#L7)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:659
+
+Determines whether the given options represent a valid template.
 
 #### Parameters
 
 ##### templateOpt
 
+The options object to evaluate.
+
 `string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
 #### Returns
 
 `boolean`
 
+A boolean indicating whether the options represent a valid template.
+
+#### Example
+
+```typescript
+const isValid = StringTemplate.isTemplate({
+  template: "{{text}}",
+  templateFormat: "Test"
+});
+console.log(isValid); // Output: true
+```
+
 #### Overrides
 
 [`PromptTemplate`](PromptTemplate.md).[`isTemplate`](PromptTemplate.md#istemplate)
 
 ***
 
+### matchTemplateSegment()
+
+> `static` **matchTemplateSegment**(`template`, `index`?): `undefined` \| `RegExpExecArray`
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:658
+
+Matches and extracts a single template segment from the provided template options.
+This method is designed to identify individual segments of a template string.
+
+#### Parameters
+
+##### template
+
+`string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+
+##### index?
+
+`number`
+
+The default starting position in the template string to begin matching (default: 0).
+               This value is used only if `templateOpt.index` is not provided or invalid.
+
+#### Returns
+
+`undefined` \| `RegExpExecArray`
+
+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.
+
+#### Example
+
+```typescript
+const template = "{{name}} is {{age}} years old";
+let match = StringTemplate.matchTemplateSegment({ template });
+while (match) {
+  console.log(match[0]); // Output: "{{name}}"
+  match = StringTemplate.matchTemplateSegment({ template }, match.index + match[0].length);
+}
+```
+
+#### Overrides
+
+[`PromptTemplate`](PromptTemplate.md).[`matchTemplateSegment`](PromptTemplate.md#matchtemplatesegment)
+
+***
+
 ### register()
 
 > `static` **register**(...`args`): `boolean`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:137
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:137
 
 register the aClass to the factory
 
@@ -977,7 +1220,7 @@ return true if successful.
 
 > `static` **registeredClass**(`aName`): `false` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:151
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:151
 
 Check the name, alias or itself whether registered.
 
@@ -1005,7 +1248,7 @@ the registered class if registered, otherwise returns false
 
 > `static` **removeAlias**(...`aliases`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:167
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:167
 
 remove specified aliases
 
@@ -1031,7 +1274,7 @@ the aliases to remove
 
 > `static` **setAlias**(`aClass`, `alias`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:189
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:189
 
 set alias to a class
 
@@ -1061,7 +1304,7 @@ the class to set alias
 
 > `static` **setAliases**(`aClass`, ...`aAliases`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:183
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:183
 
 set aliases to a class
 
@@ -1103,7 +1346,7 @@ import { BaseFactory } from 'custom-factory'
 
 > `static` **setDisplayName**(`aClass`, `aDisplayName`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:212
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:212
 
 Set the display name to the aClass
 
@@ -1135,7 +1378,7 @@ the display name to set
 
 > `static` **unregister**(`aName`): `boolean`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:157
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:157
 
 unregister this class in the factory