@outfitter/cli 0.1.0-rc.1 → 0.1.0-rc.2

package/dist/actions.d.ts

@@ -1,13 +1,2 @@
-import { ActionRegistry, ActionSurface, AnyActionSpec, HandlerContext } from "@outfitter/contracts";
-import { Command } from "commander";
-interface BuildCliCommandsOptions {
-	readonly createContext?: (input: {
-		action: AnyActionSpec;
-		args: readonly string[];
-		flags: Record<string, unknown>;
-	}) => HandlerContext;
-	readonly includeSurfaces?: readonly ActionSurface[];
-}
-type ActionSource = ActionRegistry | readonly AnyActionSpec[];
-declare function buildCliCommands(source: ActionSource, options?: BuildCliCommandsOptions): Command[];
+import { BuildCliCommandsOptions, buildCliCommands } from "./shared/@outfitter/cli-afecwfrn";
 export { buildCliCommands, BuildCliCommandsOptions };

package/dist/actions.js

@@ -1,175 +1,8 @@
 // @bun
-import"./shared/@outfitter/cli-4yy82cmp.js";
-
-// packages/cli/src/actions.ts
 import {
-  createContext as createHandlerContext,
-  DEFAULT_REGISTRY_SURFACES,
-  validateInput
-} from "@outfitter/contracts";
-import { Command } from "commander";
-var ARGUMENT_PREFIXES = ["<", "["];
-function isArgumentToken(token) {
-  if (!token) {
-    return false;
-  }
-  return ARGUMENT_PREFIXES.some((prefix) => token.startsWith(prefix));
-}
-function splitCommandSpec(spec) {
-  const parts = spec.trim().split(/\s+/).filter(Boolean);
-  if (parts.length === 0) {
-    return { name: undefined, args: [] };
-  }
-  return { name: parts[0], args: parts.slice(1) };
-}
-function applyArguments(command, args) {
-  for (const arg of args) {
-    command.argument(arg);
-  }
-}
-function applyCliOptions(command, action) {
-  const options = action.cli?.options ?? [];
-  for (const option of options) {
-    if (option.required) {
-      command.requiredOption(option.flags, option.description, option.defaultValue);
-    } else {
-      command.option(option.flags, option.description, option.defaultValue);
-    }
-  }
-}
-function resolveDescription(action) {
-  return action.cli?.description ?? action.description ?? action.id;
-}
-function resolveAliases(action) {
-  return action.cli?.aliases ?? [];
-}
-function resolveCommandSpec(action) {
-  return action.cli?.command ?? action.id;
-}
-function resolveFlags(command) {
-  return command.optsWithGlobals?.() ?? command.opts();
-}
-function resolveInput(action, context) {
-  if (action.cli?.mapInput) {
-    return action.cli.mapInput(context);
-  }
-  const hasFlags = Object.keys(context.flags).length > 0;
-  if (!hasFlags && context.args.length === 0) {
-    return {};
-  }
-  return {
-    ...context.flags,
-    ...context.args.length > 0 ? { args: context.args } : {}
-  };
-}
-async function runAction(action, command, createContext) {
-  const flags = resolveFlags(command);
-  const args = command.args;
-  const inputContext = { args, flags };
-  const input = resolveInput(action, inputContext);
-  const validation = validateInput(action.input, input);
-  if (validation.isErr()) {
-    throw validation.error;
-  }
-  const ctx = createContext({ action, args, flags });
-  const result = await action.handler(validation.value, ctx);
-  if (result.isErr()) {
-    throw result.error;
-  }
-}
-function createCommand(action, createContext, spec) {
-  const commandSpec = spec ?? resolveCommandSpec(action);
-  const { name, args } = splitCommandSpec(commandSpec);
-  if (!name) {
-    throw new Error(`Missing CLI command name for action ${action.id}`);
-  }
-  const command = new Command(name);
-  command.description(resolveDescription(action));
-  applyCliOptions(command, action);
-  applyArguments(command, args);
-  for (const alias of resolveAliases(action)) {
-    command.alias(alias);
-  }
-  command.action(async (...argsList) => {
-    const commandInstance = argsList.at(-1);
-    await runAction(action, commandInstance, createContext);
-  });
-  return command;
-}
-function buildCliCommands(source, options = {}) {
-  const actions = isActionRegistry(source) ? source.list() : source;
-  const includeSurfaces = options.includeSurfaces ?? [
-    "cli"
-  ];
-  const commands = [];
-  const createContext = options.createContext ?? ((_input) => createHandlerContext({
-    cwd: process.cwd(),
-    env: process.env
-  }));
-  const grouped = new Map;
-  const ungrouped = [];
-  for (const action of actions) {
-    const surfaces = action.surfaces ?? DEFAULT_REGISTRY_SURFACES;
-    if (!surfaces.some((surface) => includeSurfaces.includes(surface))) {
-      continue;
-    }
-    const group = action.cli?.group;
-    if (group) {
-      const groupActions = grouped.get(group) ?? [];
-      groupActions.push(action);
-      grouped.set(group, groupActions);
-    } else {
-      ungrouped.push(action);
-    }
-  }
-  for (const action of ungrouped) {
-    commands.push(createCommand(action, createContext));
-  }
-  for (const [groupName, groupActions] of grouped.entries()) {
-    const groupCommand = new Command(groupName);
-    let baseAction;
-    const subcommands = [];
-    for (const action of groupActions) {
-      const spec = action.cli?.command?.trim() ?? "";
-      const { name, args } = splitCommandSpec(spec);
-      if (!name || isArgumentToken(name)) {
-        if (baseAction) {
-          throw new Error(`Group '${groupName}' defines multiple base actions: '${baseAction.id}' and '${action.id}'.`);
-        }
-        baseAction = action;
-        groupCommand.description(resolveDescription(action));
-        applyCliOptions(groupCommand, action);
-        applyArguments(groupCommand, name ? [name, ...args] : args);
-        for (const alias of resolveAliases(action)) {
-          groupCommand.alias(alias);
-        }
-        groupCommand.action(async (...argsList) => {
-          const commandInstance = argsList.at(-1);
-          await runAction(action, commandInstance, createContext);
-        });
-      } else {
-        subcommands.push(action);
-      }
-    }
-    for (const action of subcommands) {
-      const spec = resolveCommandSpec(action);
-      const { name, args } = splitCommandSpec(spec);
-      if (!name) {
-        continue;
-      }
-      const subcommand = createCommand(action, createContext, [name, ...args].join(" "));
-      groupCommand.addCommand(subcommand);
-    }
-    if (!baseAction) {
-      groupCommand.description(groupName);
-    }
-    commands.push(groupCommand);
-  }
-  return commands;
-}
-function isActionRegistry(source) {
-  return "list" in source;
-}
+  buildCliCommands
+} from "./shared/@outfitter/cli-p0m2fc51.js";
+import"./shared/@outfitter/cli-bt423m6y.js";
 export {
   buildCliCommands
 };

package/dist/cli.d.ts

@@ -1,104 +1,3 @@
-import { Command } from "commander";
-/**
-* Configuration for creating a CLI instance.
-*
-* @example
-* ```typescript
-* const config: CLIConfig = {
-*   name: "waymark",
-*   version: "1.0.0",
-*   description: "A note management CLI",
-* };
-* ```
-*/
-interface CLIConfig {
-	/** CLI name (used in help output and error messages) */
-	readonly name: string;
-	/** CLI version (displayed with --version) */
-	readonly version: string;
-	/** CLI description (displayed in help output) */
-	readonly description?: string;
-	/** Custom error handler */
-	readonly onError?: (error: Error) => void;
-	/** Custom exit handler (defaults to process.exit) */
-	readonly onExit?: (code: number) => never;
-}
-/**
-* CLI instance returned by createCLI.
-*/
-interface CLI {
-	/** Register a command with the CLI */
-	register(command: CommandBuilder | Command): this;
-	/** Parse arguments and execute the matched command */
-	parse(argv?: readonly string[]): Promise<void>;
-	/** Get the underlying Commander program */
-	readonly program: Command;
-}
-/**
-* Action function executed when a command is invoked.
-*
-* @typeParam TFlags - Type of parsed command flags
-*/
-type CommandAction<TFlags extends CommandFlags = CommandFlags> = (context: {
-	/** Parsed command-line arguments */
-	readonly args: readonly string[];
-	/** Parsed command flags */
-	readonly flags: TFlags;
-	/** Raw Commander command instance */
-	readonly command: Command;
-}) => Promise<void> | void;
-/**
-* Base type for command flags.
-* All flag types must extend this.
-*/
-type CommandFlags = Record<string, unknown>;
-/**
-* Builder interface for constructing commands fluently.
-*/
-interface CommandBuilder {
-	/** Set command description */
-	description(text: string): this;
-	/** Add a command option/flag */
-	option(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add a required option */
-	requiredOption(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add command aliases */
-	alias(alias: string): this;
-	/** Set the action handler */
-	action<TFlags extends CommandFlags = CommandFlags>(handler: CommandAction<TFlags>): this;
-	/** Build the underlying Commander command */
-	build(): Command;
-}
-/**
-* Create a new CLI instance with the given configuration.
-*
-* The CLI wraps Commander.js with typed helpers, output contract enforcement,
-* and pagination state management.
-*
-* @param config - CLI configuration options
-* @returns A CLI instance ready for command registration
-*
-* @example
-* ```typescript
-* import { createCLI, command, output } from "@outfitter/cli";
-*
-* const cli = createCLI({
-*   name: "waymark",
-*   version: "1.0.0",
-*   description: "A note management CLI",
-* });
-*
-* cli.register(
-*   command("list")
-*     .description("List all notes")
-*     .action(async () => {
-*       const notes = await getNotes();
-*       output(notes);
-*     })
-* );
-*
-* await cli.parse();
-* ```
-*/
-declare function createCLI(config: CLIConfig): CLI;
+import { createCLI } from "./shared/@outfitter/cli-mhamvbty";
+import "./shared/@outfitter/cli-ttt7r0j7";
 export { createCLI };

package/dist/cli.js

@@ -1,55 +1,8 @@
 // @bun
-import"./shared/@outfitter/cli-4yy82cmp.js";
-
-// packages/cli/src/cli.ts
-import { Command } from "commander";
-function isCommanderHelp(error) {
-  return error.code === "commander.helpDisplayed" || error.code === "commander.version" || error.code === "commander.help";
-}
-function createCLI(config) {
-  const program = new Command;
-  program.name(config.name).version(config.version);
-  if (config.description) {
-    program.description(config.description);
-  }
-  const exit = config.onExit ?? ((code) => process.exit(code));
-  program.exitOverride((error) => {
-    if (isCommanderHelp(error)) {
-      exit(0);
-    }
-    if (config.onError) {
-      config.onError(error);
-    }
-    const exitCode = typeof error.exitCode === "number" && Number.isFinite(error.exitCode) ? error.exitCode : 1;
-    exit(exitCode);
-  });
-  const parse = async (argv) => {
-    try {
-      await program.parseAsync(argv ?? process.argv);
-    } catch (error) {
-      const err = error instanceof Error ? error : new Error(String(error));
-      if (config.onError) {
-        config.onError(err);
-      }
-      const errorExitCode = error.exitCode;
-      const exitCode = typeof errorExitCode === "number" ? errorExitCode : 1;
-      exit(exitCode);
-    }
-  };
-  const cli = {
-    program,
-    register: (builderOrCommand) => {
-      if ("build" in builderOrCommand) {
-        program.addCommand(builderOrCommand.build());
-      } else {
-        program.addCommand(builderOrCommand);
-      }
-      return cli;
-    },
-    parse
-  };
-  return cli;
-}
+import {
+  createCLI
+} from "./shared/@outfitter/cli-efy6jfcj.js";
+import"./shared/@outfitter/cli-bt423m6y.js";
 export {
   createCLI
 };

package/dist/command.d.ts

@@ -1,74 +1,3 @@
-import { Command } from "commander";
-/**
-* Action function executed when a command is invoked.
-*
-* @typeParam TFlags - Type of parsed command flags
-*/
-type CommandAction<TFlags extends CommandFlags = CommandFlags> = (context: {
-	/** Parsed command-line arguments */
-	readonly args: readonly string[];
-	/** Parsed command flags */
-	readonly flags: TFlags;
-	/** Raw Commander command instance */
-	readonly command: Command;
-}) => Promise<void> | void;
-/**
-* Base type for command flags.
-* All flag types must extend this.
-*/
-type CommandFlags = Record<string, unknown>;
-/**
-* Builder interface for constructing commands fluently.
-*/
-interface CommandBuilder {
-	/** Set command description */
-	description(text: string): this;
-	/** Add a command option/flag */
-	option(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add a required option */
-	requiredOption(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add command aliases */
-	alias(alias: string): this;
-	/** Set the action handler */
-	action<TFlags extends CommandFlags = CommandFlags>(handler: CommandAction<TFlags>): this;
-	/** Build the underlying Commander command */
-	build(): Command;
-}
-/**
-* Create a new command builder with the given name.
-*
-* The command builder provides a fluent API for defining CLI commands
-* with typed flags, arguments, and actions.
-*
-* @param name - Command name and optional argument syntax (e.g., "list" or "get <id>")
-* @returns A CommandBuilder instance for fluent configuration
-*
-* @example
-* ```typescript
-* import { command, output } from "@outfitter/cli";
-*
-* const list = command("list")
-*   .description("List all notes")
-*   .option("--limit <n>", "Max results", "20")
-*   .option("--json", "Output as JSON")
-*   .option("--next", "Continue from last position")
-*   .action(async ({ flags }) => {
-*     const results = await listNotes(flags);
-*     output(results);
-*   });
-* ```
-*
-* @example
-* ```typescript
-* // Command with required argument
-* const get = command("get <id>")
-*   .description("Get a note by ID")
-*   .action(async ({ args }) => {
-*     const [id] = args;
-*     const note = await getNote(id);
-*     output(note);
-*   });
-* ```
-*/
-declare function command(name: string): CommandBuilder;
+import { command } from "./shared/@outfitter/cli-2yq94zst";
+import "./shared/@outfitter/cli-ttt7r0j7";
 export { command };

package/dist/command.js

@@ -1,46 +1,8 @@
 // @bun
-import"./shared/@outfitter/cli-4yy82cmp.js";
-
-// packages/cli/src/command.ts
-import { Command } from "commander";
-
-class CommandBuilderImpl {
-  command;
-  constructor(name) {
-    this.command = new Command(name);
-  }
-  description(text) {
-    this.command.description(text);
-    return this;
-  }
-  option(flags, description, defaultValue) {
-    this.command.option(flags, description, defaultValue);
-    return this;
-  }
-  requiredOption(flags, description, defaultValue) {
-    this.command.requiredOption(flags, description, defaultValue);
-    return this;
-  }
-  alias(alias) {
-    this.command.alias(alias);
-    return this;
-  }
-  action(handler) {
-    this.command.action(async (...args) => {
-      const command = args.at(-1);
-      const flags = command.optsWithGlobals?.() ?? command.opts();
-      const positional = command.args;
-      await handler({ args: positional, flags, command });
-    });
-    return this;
-  }
-  build() {
-    return this.command;
-  }
-}
-function command(name) {
-  return new CommandBuilderImpl(name);
-}
+import {
+  command
+} from "./shared/@outfitter/cli-8r0bnyyx.js";
+import"./shared/@outfitter/cli-bt423m6y.js";
 export {
   command
 };