@optique/discover 1.2.0-dev.2252 → 1.2.0-dev.2255

package/dist/command-DSHBTa5c.d.cts

@@ -1,139 +0,0 @@
-import { CommandOptions } from "@optique/core/primitives";
-import { Mode, Parser } from "@optique/core/parser";
-
-//#region src/command.d.ts
-declare const commandBrand: unique symbol;
-/**
- * Metadata shown for a discovered command.
- *
- * This uses the same shape as Optique's `command()` options so discovered
- * commands can provide descriptions, usage overrides, visibility, and custom
- * command-level errors.
- *
- * @since 1.1.0
- */
-type CommandMetadata = CommandOptions;
-/**
- * Command path used by static command registration.
- *
- * An empty path represents the root command.
- *
- * @since 1.1.0
- */
-type CommandPath = readonly string[];
-/**
- * Input accepted by {@link defineCommand}.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @since 1.1.0
- */
-interface CommandDefinition<M extends Mode, T> {
-  /**
-   * Command path used when commands are passed directly to `runProgram()`.
-   * Use an empty path (`[]`) to register the root command.
-   *
-   * File-based discovery derives the command path from the file name and uses
-   * this field only to validate that the declared path matches.
-   */
-  readonly path?: CommandPath;
-  /**
-   * Parser for this command's command-specific arguments and options.
-   */
-  readonly parser: Parser<M, T, unknown>;
-  /**
-   * Metadata used in help output and shell completion.
-   */
-  readonly metadata?: CommandMetadata;
-  /**
-   * Handles the parsed command value.
-   *
-   * @param value Parsed command value.
-   * @returns Nothing, or a promise that resolves when command handling
-   *          completes.
-   */
-  readonly handler: (value: T) => void | Promise<void>;
-}
-/**
- * A discovered command module definition.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @since 1.1.0
- */
-interface Command<M extends Mode, T> extends CommandDefinition<M, T> {
-  /**
-   * Internal marker used to validate discovered modules.
-   *
-   * @internal
-   */
-  readonly [commandBrand]: true;
-}
-/**
- * A command that declares its own command path.
- *
- * Static `runProgram({ commands })` registration accepts this shape.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @since 1.1.0
- */
-interface StaticCommand<M extends Mode, T> extends Command<M, T> {
-  /**
-   * Command path used by static command registration.
-   */
-  readonly path: CommandPath;
-}
-/**
- * A command with its handler value type erased.
- *
- * This type is used by discovery APIs that collect commands with different
- * parsed value types.  The handler cannot be called directly without first
- * recovering the parser's value type.
- *
- * @since 1.1.0
- */
-type AnyCommand = Omit<Command<Mode, unknown>, "handler"> & {
-  /**
-   * Erased command handler.
-   */
-  readonly handler: (value: never) => void | Promise<void>;
-};
-/**
- * A statically registered command with its handler value type erased.
- *
- * @since 1.1.0
- */
-type AnyStaticCommand = Omit<StaticCommand<Mode, unknown>, "handler"> & {
-  /**
-   * Erased command handler.
-   */
-  readonly handler: (value: never) => void | Promise<void>;
-};
-/**
- * Defines a command module for `@optique/discover`.
- *
- * This helper returns its argument unchanged while preserving parser value
- * inference for the handler callback.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @param command The command definition.
- * @returns The same command definition with inferred types.
- * @throws {TypeError} If the parser, path, or handler is missing or malformed.
- * @since 1.1.0
- */
-declare function defineCommand<M extends Mode, T>(command: CommandDefinition<M, T> & {
-  readonly path: CommandPath;
-}): StaticCommand<M, T>;
-declare function defineCommand<M extends Mode, T>(command: CommandDefinition<M, T>): Command<M, T>;
-/**
- * Returns whether a value is a command created by {@link defineCommand}.
- *
- * @param value The value to inspect.
- * @returns `true` when the value is a discovered command definition.
- * @since 1.1.0
- */
-declare function isCommand(value: unknown): value is AnyCommand;
-//#endregion
-export { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, StaticCommand, defineCommand, isCommand };

package/dist/command-DrmNW0HO.d.ts

@@ -1,139 +0,0 @@
-import { CommandOptions } from "@optique/core/primitives";
-import { Mode, Parser } from "@optique/core/parser";
-
-//#region src/command.d.ts
-declare const commandBrand: unique symbol;
-/**
- * Metadata shown for a discovered command.
- *
- * This uses the same shape as Optique's `command()` options so discovered
- * commands can provide descriptions, usage overrides, visibility, and custom
- * command-level errors.
- *
- * @since 1.1.0
- */
-type CommandMetadata = CommandOptions;
-/**
- * Command path used by static command registration.
- *
- * An empty path represents the root command.
- *
- * @since 1.1.0
- */
-type CommandPath = readonly string[];
-/**
- * Input accepted by {@link defineCommand}.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @since 1.1.0
- */
-interface CommandDefinition<M extends Mode, T> {
-  /**
-   * Command path used when commands are passed directly to `runProgram()`.
-   * Use an empty path (`[]`) to register the root command.
-   *
-   * File-based discovery derives the command path from the file name and uses
-   * this field only to validate that the declared path matches.
-   */
-  readonly path?: CommandPath;
-  /**
-   * Parser for this command's command-specific arguments and options.
-   */
-  readonly parser: Parser<M, T, unknown>;
-  /**
-   * Metadata used in help output and shell completion.
-   */
-  readonly metadata?: CommandMetadata;
-  /**
-   * Handles the parsed command value.
-   *
-   * @param value Parsed command value.
-   * @returns Nothing, or a promise that resolves when command handling
-   *          completes.
-   */
-  readonly handler: (value: T) => void | Promise<void>;
-}
-/**
- * A discovered command module definition.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @since 1.1.0
- */
-interface Command<M extends Mode, T> extends CommandDefinition<M, T> {
-  /**
-   * Internal marker used to validate discovered modules.
-   *
-   * @internal
-   */
-  readonly [commandBrand]: true;
-}
-/**
- * A command that declares its own command path.
- *
- * Static `runProgram({ commands })` registration accepts this shape.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @since 1.1.0
- */
-interface StaticCommand<M extends Mode, T> extends Command<M, T> {
-  /**
-   * Command path used by static command registration.
-   */
-  readonly path: CommandPath;
-}
-/**
- * A command with its handler value type erased.
- *
- * This type is used by discovery APIs that collect commands with different
- * parsed value types.  The handler cannot be called directly without first
- * recovering the parser's value type.
- *
- * @since 1.1.0
- */
-type AnyCommand = Omit<Command<Mode, unknown>, "handler"> & {
-  /**
-   * Erased command handler.
-   */
-  readonly handler: (value: never) => void | Promise<void>;
-};
-/**
- * A statically registered command with its handler value type erased.
- *
- * @since 1.1.0
- */
-type AnyStaticCommand = Omit<StaticCommand<Mode, unknown>, "handler"> & {
-  /**
-   * Erased command handler.
-   */
-  readonly handler: (value: never) => void | Promise<void>;
-};
-/**
- * Defines a command module for `@optique/discover`.
- *
- * This helper returns its argument unchanged while preserving parser value
- * inference for the handler callback.
- *
- * @template M The mode of the command parser.
- * @template T The parsed value passed to the command handler.
- * @param command The command definition.
- * @returns The same command definition with inferred types.
- * @throws {TypeError} If the parser, path, or handler is missing or malformed.
- * @since 1.1.0
- */
-declare function defineCommand<M extends Mode, T>(command: CommandDefinition<M, T> & {
-  readonly path: CommandPath;
-}): StaticCommand<M, T>;
-declare function defineCommand<M extends Mode, T>(command: CommandDefinition<M, T>): Command<M, T>;
-/**
- * Returns whether a value is a command created by {@link defineCommand}.
- *
- * @param value The value to inspect.
- * @returns `true` when the value is a discovered command definition.
- * @since 1.1.0
- */
-declare function isCommand(value: unknown): value is AnyCommand;
-//#endregion
-export { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, StaticCommand, defineCommand, isCommand };