@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/classes/CmdArgLexer.md

@@ -0,0 +1,82 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgLexer
+
+# Class: CmdArgLexer
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/lexer.ts:7](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/lexer.ts#L7)
+
+Lexical analyzer for command arguments.
+Responsible for breaking down the raw input string into a sequence of basic tokens.
+
+## Constructors
+
+### Constructor
+
+> **new CmdArgLexer**(`input`, `options?`): `CmdArgLexer`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/lexer.ts:13](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/lexer.ts#L13)
+
+#### Parameters
+
+##### input
+
+`string`
+
+##### options?
+
+[`CmdArgParserOptions`](../interfaces/CmdArgParserOptions.md)
+
+#### Returns
+
+`CmdArgLexer`
+
+## Properties
+
+### input
+
+> **input**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/lexer.ts:8](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/lexer.ts#L8)
+
+## Methods
+
+### nextToken()
+
+> **nextToken**(): [`CmdArgToken`](../interfaces/CmdArgToken.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/lexer.ts:32](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/lexer.ts#L32)
+
+Retrieves the next CmdArgToken and advances the position pointer.
+
+#### Returns
+
+[`CmdArgToken`](../interfaces/CmdArgToken.md)
+
+***
+
+### peekToken()
+
+> **peekToken**(): [`CmdArgToken`](../interfaces/CmdArgToken.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/lexer.ts:22](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/lexer.ts#L22)
+
+Peeks at the next CmdArgToken without consuming it.
+
+#### Returns
+
+[`CmdArgToken`](../interfaces/CmdArgToken.md)
+
+***
+
+### reset()
+
+> **reset**(): `void`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/lexer.ts:125](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/lexer.ts#L125)
+
+#### Returns
+
+`void`

package/docs/api/classes/CmdArgParser.md

@@ -0,0 +1,56 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgParser
+
+# Class: CmdArgParser
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/parser.ts:11](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/parser.ts#L11)
+
+Structured command argument CmdArgParser.
+Supports positional arguments, named arguments (k=v), nested structures,
+and Symbol-based extension protocols.
+
+## Constructors
+
+### Constructor
+
+> **new CmdArgParser**(`lexer`, `options?`): `CmdArgParser`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/parser.ts:15](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/parser.ts#L15)
+
+#### Parameters
+
+##### lexer
+
+[`CmdArgLexer`](CmdArgLexer.md)
+
+##### options?
+
+[`CmdArgParserOptions`](../interfaces/CmdArgParserOptions.md)
+
+#### Returns
+
+`CmdArgParser`
+
+## Methods
+
+### parse()
+
+> **parse**(): `Promise`\<[`CmdArgParseResult`](../interfaces/CmdArgParseResult.md)\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/parser.ts:35](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/parser.ts#L35)
+
+Executes the parsing process.
+
+Core logic priority:
+1. Collect top-level arguments (respecting bracket nesting depth).
+2. Identify explicit named arguments (k=v) or flag shorthands.
+3. Pre-check if a positional argument fits identifier/path format for auto-mapping.
+4. Invoke Evaluator to get the value and unpack any Symbol Protocols.
+5. Distribute results to 'args' and 'namedArgs', maintaining index consistency.
+
+#### Returns
+
+`Promise`\<[`CmdArgParseResult`](../interfaces/CmdArgParseResult.md)\>

package/docs/api/classes/ConfigFile.md

@@ -6,7 +6,7 @@
 
 # Class: ConfigFile
 
-Defined in: @isdk/util/dist/index.d.ts:30
+Defined in: @isdk/util/dist/index.d.ts:31
 
 Represents a configuration file utility class that provides methods to load and save configuration files.
 It supports multiple file formats such as YAML, JSON, etc., by registering corresponding parsers and stringifiers.
@@ -45,7 +45,7 @@ console.log(config); // Output: { key: 'value' }
 
 > `static` **stringifys**: `Record`\<`string`, `StringifyFunc`\>
 
-Defined in: @isdk/util/dist/index.d.ts:34
+Defined in: @isdk/util/dist/index.d.ts:35
 
 A record of registered stringify functions for different file extensions.
 
@@ -55,7 +55,7 @@ A record of registered stringify functions for different file extensions.
 
 > `static` **existsSync**(`filename`, `options?`): `boolean`
 
-Defined in: @isdk/util/dist/index.d.ts:102
+Defined in: @isdk/util/dist/index.d.ts:103
 
 Checks if a configuration file exists at the specified path.
 
@@ -104,7 +104,7 @@ console.log(existsWithExt); // true or false
 
 > `static` **loadSync**(`filename`, `options?`): `any`
 
-Defined in: @isdk/util/dist/index.d.ts:61
+Defined in: @isdk/util/dist/index.d.ts:62
 
 Loads a configuration file based on the provided filename and options.
 
@@ -141,7 +141,7 @@ console.log(config); // Output: { key: 'value' }
 
 > `static` **register**(`extname`, `parser`, `stringify`): `void`
 
-Defined in: @isdk/util/dist/index.d.ts:47
+Defined in: @isdk/util/dist/index.d.ts:48
 
 Registers a parser and stringifier for specific file extensions.
 
@@ -181,7 +181,7 @@ ConfigFile.register(['.json'], JSON.parse, (obj) => JSON.stringify(obj, null, 2)
 
 > `static` **saveSync**(`filename`, `config`, `options?`): `string`
 
-Defined in: @isdk/util/dist/index.d.ts:75
+Defined in: @isdk/util/dist/index.d.ts:76
 
 Saves a configuration object to a file with the specified filename and options.