@alcyone-labs/arg-parser 2.14.2 → 3.0.0

package/dist/index.d.ts

@@ -1,19 +1,30 @@
-export { ArgParserBase, ArgParserError, autoHelpHandler, type IParseOptions, } from "./core/ArgParserBase";
-export { ArgParser, type McpTransportConfig, type McpSubCommandOptions, type DxtServerInfo, type McpServerOptions, type WithMcpOptions, type ArgParserWithMcpOptions, type McpToolConfig, type ToolConfig, type DxtCopyEntry, type DxtCopyOptions, type DxtOptions, type CorsOptions, type AuthOptions, type JwtVerifyOptions, type HttpServerOptions, type ExpressApplication, } from "./core/ArgParser";
-export type { McpLoggerOptions } from "@alcyone-labs/simple-mcp-logger";
-export { resolveLogPath, detectEntryPoint, getEntryPointFromImportMeta, entryRelative, cwdRelative, absolutePath, legacyCwdPath, type LogPath, type LogPathConfig, } from "./core/log-path-utils";
-export { DxtPathResolver, type IPathContext, type IDxtVariableConfig, } from "./core/dxt-path-resolver";
-export { debug } from "./utils/debug-utils";
-export { ArgParserMcp, createMcpArgParser } from "./mcp/ArgParserMcp";
-export { sanitizeMcpToolName, isValidMcpToolName } from "./mcp/mcp-utils";
-export { zodFlagSchema, zodDxtOptionsSchema, FlagInheritance, type TFlagInheritance, type IFlagCore, type IFlag, type IDxtOptions, type ProcessedFlagCore, type ProcessedFlag, type TParsedArgsTypeFromFlagDef, type FlagsArray, type ResolveType, type ExtractFlagType, type TParsedArgs, type IHandlerContext, type MainHandler, type ISubCommand, type ArgParserInstance, type DynamicRegisterContext, type DynamicRegisterFn, getJsonSchemaTypeFromFlag, OutputSchemaPatterns, type OutputSchemaPatternName, type OutputSchemaConfig, createOutputSchema, type ArgParserOptions, type ArgParserBehaviorOptions, type ISystemArgs, type PromptType, type PromptFieldConfig, type PromptWhen, type IPromptableFlag, type IInteractiveSubCommand, } from "./core/types";
+/**
+ * @alcyone-labs/arg-parser v3.0.0
+ *
+ * A robust, type-safe CLI argument parser with plugin support.
+ *
+ * @example
+ * ```typescript
+ * import { ArgParser } from '@alcyone-labs/arg-parser';
+ *
+ * const parser = new ArgParser({
+ *   appName: 'my-cli',
+ *   handler: async (ctx) => {
+ *     console.log('Args:', ctx.args);
+ *   }
+ * });
+ *
+ * await parser.parse();
+ * ```
+ */
+export { ArgParser, ArgParserError } from "./core/ArgParser";
+export type { IArgParserParams, IParseOptions } from "./core/ArgParser";
 export { FlagManager, type FlagManagerOptions, type FlagOptionCollision } from "./core/FlagManager";
 export { PromptManager, type PromptManagerOptions, type PromptResult } from "./core/PromptManager";
-export { generateMcpToolsFromArgParser, type IMcpToolStructure, type GenerateMcpToolsOptions, type IParseExecutionResult, type SimplifiedToolResponse, extractSimplifiedResponse, convertFlagToJsonSchemaProperty, convertFlagsToJsonSchema, convertFlagsToZodSchema, createMcpSuccessResponse, createMcpErrorResponse, type McpResponse, } from "./mcp/mcp-integration";
-export { type IConfigPlugin, ConfigPlugin, JsonConfigPlugin, EnvConfigPlugin, ConfigPluginRegistry, globalConfigPluginRegistry, enableOptionalConfigPlugins, enableOptionalConfigPluginsAsync, enableConfigPlugins, TomlConfigPlugin, createTomlPlugin, createTomlPluginAsync, YamlConfigPlugin, createYamlPlugin, createYamlPluginAsync, } from "./config/plugins";
-export { ArgParserFuzzyTester } from "./testing/fuzzy-tester";
-export type { FuzzyTestOptions, TestResult, FuzzyTestReport } from "./testing/fuzzy-tester";
+export { type IArgParserPlugin, type IPluginMetadata, PluginRegistry, globalPluginRegistry, expose, type PluginMethods, } from "./plugin/types";
+export { zodFlagSchema, zodDxtOptionsSchema, FlagInheritance, type TFlagInheritance, type IFlagCore, type IFlag, type IDxtOptions, type ProcessedFlagCore, type ProcessedFlag, type TParsedArgsTypeFromFlagDef, type FlagsArray, type ResolveType, type ExtractFlagType, type TParsedArgs, type IHandlerContext, type MainHandler, type ISubCommand, type ArgParserInstance, type DynamicRegisterContext, type DynamicRegisterFn, getJsonSchemaTypeFromFlag, OutputSchemaPatterns, type OutputSchemaPatternName, type OutputSchemaConfig, createOutputSchema, type ArgParserOptions, type ArgParserBehaviorOptions, type ISystemArgs, type PromptType, type PromptFieldConfig, type PromptWhen, type IPromptableFlag, type IInteractiveSubCommand, type ParseResult, } from "./core/types";
+export { type IConfigPlugin, ConfigPlugin, JsonConfigPlugin, EnvConfigPlugin, ConfigPluginRegistry, globalConfigPluginRegistry, enableOptionalConfigPlugins, enableOptionalConfigPluginsAsync, enableConfigPlugins, } from "./config/plugins";
+export { debug } from "./utils/debug-utils";
+export { resolveLogPath, detectEntryPoint, getEntryPointFromImportMeta, entryRelative, cwdRelative, absolutePath, legacyCwdPath, type LogPath, type LogPathConfig, } from "./core/log-path-utils";
 export { default as SimpleChalk } from "@alcyone-labs/simple-chalk";
-export { Logger, logger, createMcpLogger, createCliLogger, type LogLevel, type LoggerConfig, } from "@alcyone-labs/simple-mcp-logger";
-export type { TuiAppConfig, TuiTheme, ShortcutBinding, ToastType } from "./tui/types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGnG,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,cAAc,EACd,oBAAoB,EACpB,MAAM,EACN,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAEhB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAC"}