@clerc/core 1.0.0-beta.10 → 1.0.0-beta.12

package/dist/index.d.ts

@@ -1,7 +1,13 @@
 import { ErrorHandler as ErrorHandler$1 } from "lite-emit";
 
+//#region rolldown:runtime
+//#endregion
+//#region ../parser/src/errors.d.ts
+declare class InvalidSchemaError extends Error {
+  constructor(message: string);
+}
+//#endregion
 //#region ../parser/src/flag-types.d.ts
-
 /**
 * Creates a Choices type function that validates the input against allowed values.
 * The display name will be formatted as "value1 | value2 | ..." for help output.
@@ -86,6 +92,28 @@ type FlagOptions = (BaseFlagOptions<BooleanConstructor> & {
 });
 type FlagDefinitionValue = FlagOptions | FlagType;
 type FlagsDefinition = Record<string, FlagDefinitionValue>;
+/**
+* Configuration options for the parser.
+*/
+interface ParserOptions<T extends FlagsDefinition = {}> {
+  /**
+  * Detailed configuration for flags.
+  * Supports the full object syntax or a type constructor as a shorthand.
+  * The key is the flag name (e.g., "file" for "--file").
+  */
+  flags?: T;
+  /**
+  * Delimiters to split flag names and values.
+  *
+  * @default ['=', ':']
+  */
+  delimiters?: string[];
+  /**
+  * A callback function to conditionally stop parsing.
+  * When it returns true, parsing stops and remaining arguments are preserved in `ignored`.
+  */
+  ignore?: IgnoreFunction;
+}
 type RawInputType = string | boolean;
 interface ObjectInputType {
   [key: string]: RawInputType | ObjectInputType;
@@ -141,6 +169,14 @@ declare const PARAMETER = "parameter";
 //#endregion
 //#region ../parser/src/parse.d.ts
 declare const DOUBLE_DASH = "--";
+type ParseFunction<T extends FlagsDefinition> = (args: string[]) => ParsedResult<InferFlags<T>>;
+declare function createParser<T extends FlagsDefinition>(options?: ParserOptions<T>): {
+  parse: ParseFunction<T>;
+};
+declare const parse: <T extends FlagsDefinition>(args: string[], options?: ParserOptions<T>) => ParsedResult<InferFlags<T>>;
+declare namespace index_d_exports {
+  export { BaseFlagOptions, Choices, DOUBLE_DASH, FlagDefaultValue, FlagDefinitionValue, FlagOptions, FlagType, FlagTypeFunction, FlagsDefinition, IgnoreFunction, InferFlags, InvalidSchemaError, KNOWN_FLAG, ObjectInputType, PARAMETER, ParsedResult, ParserOptions, RawInputType, UNKNOWN_FLAG, createParser, parse };
+}
 //#endregion
 //#region src/types/clerc.d.ts
 type ErrorHandler = (error: unknown) => void;
@@ -283,4 +319,4 @@ declare function createStopAtFirstParameter(): IgnoreFunction;
 //#region src/plugin.d.ts
 declare const definePlugin: (plugin: Plugin) => Plugin;
 //#endregion
-export { BaseContext, Choices, Clerc, ClercFlagOptions, ClercFlagOptionsWithDescription, ClercFlagsDefinition, ClercGlobalFlagDefinitionValue, Command, CommandCustomOptions, CommandHandler, CommandHandlerContext, CommandOptions, CommandWithHandler, CommandsMap, CommandsRecord, type CreateOptions, DOUBLE_DASH, ErrorHandler, FlagCustomOptions, InferParameters, Interceptor, InterceptorContext, InterceptorHandler, InterceptorNext, InterceptorObject, InvalidCommandError, InvalidParametersError, KNOWN_FLAG, MakeEmitterEvents, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, type ParseOptions, Plugin, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, resolveCommand };
+export { BaseContext, Choices, Clerc, ClercFlagOptions, ClercFlagOptionsWithDescription, ClercFlagsDefinition, ClercGlobalFlagDefinitionValue, Command, CommandCustomOptions, CommandHandler, CommandHandlerContext, CommandOptions, CommandWithHandler, CommandsMap, CommandsRecord, type CreateOptions, DOUBLE_DASH, ErrorHandler, FlagCustomOptions, InferParameters, Interceptor, InterceptorContext, InterceptorHandler, InterceptorNext, InterceptorObject, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MakeEmitterEvents, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, type ParseOptions, type index_d_exports as Parser, Plugin, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, resolveCommand };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Choices, DOUBLE_DASH, DOUBLE_DASH as DOUBLE_DASH$1, KNOWN_FLAG, PARAMETER, PARAMETER as PARAMETER$1, UNKNOWN_FLAG, parse } from "@clerc/parser";
+import { Choices, DOUBLE_DASH, DOUBLE_DASH as DOUBLE_DASH$1, InvalidSchemaError, KNOWN_FLAG, PARAMETER, PARAMETER as PARAMETER$1, UNKNOWN_FLAG, parse } from "@clerc/parser";
 import { LiteEmit } from "lite-emit";
 
 //#region ../utils/src/index.ts
@@ -348,4 +348,4 @@ function createStopAtFirstParameter() {
 const definePlugin = (plugin) => plugin;
 
 //#endregion
-export { Choices, Clerc, DOUBLE_DASH, InvalidCommandError, InvalidParametersError, KNOWN_FLAG, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, resolveCommand };
+export { Choices, Clerc, DOUBLE_DASH, InvalidCommandError, InvalidParametersError, InvalidSchemaError, KNOWN_FLAG, MissingRequiredMetadataError, NoCommandSpecifiedError, NoSuchCommandError, PARAMETER, UNKNOWN_FLAG, createStopAtFirstParameter, defineCommand, definePlugin, resolveCommand };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/core",
-  "version": "1.0.0-beta.10",
+  "version": "1.0.0-beta.12",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc core",
@@ -45,10 +45,10 @@
   },
   "dependencies": {
     "lite-emit": "^3.1.0",
-    "@clerc/parser": "^1.0.0-beta.10"
+    "@clerc/parser": "^1.0.0-beta.12"
   },
   "devDependencies": {
     "is-platform": "^1.0.0",
-    "@clerc/utils": "1.0.0-beta.10"
+    "@clerc/utils": "1.0.0-beta.12"
   }
 }