icore 1.0.16 → 1.0.17

package/dist/terminal/app.d.ts

@@ -9,7 +9,7 @@
  * This file must not contain argv tokenization, option validation internals,
  * domain behavior, or application-specific report mapping.
  */
-import type { CommandDefinition, CommandResolutionOptions, Commands, PreparedCommand } from '../command/mechanics';
+import type { CommandContext, CommandResolutionOptions, Commands, PreparedCommand } from '../command/mechanics';
 import type { OptionsSchema } from '../options/schema';
 import { type Presentation, type PresentationResult } from '../presentation/facade';
 import { type PresentationFormat } from '../presentation/format-options';
@@ -21,8 +21,27 @@ import { type Output } from '../output/facade';
  * or no output. Other result shapes are rejected before writing to stdout.
  */
 export type TerminalCommandOutput = string | AsyncIterable<string> | PresentationResult | undefined;
-type TerminalCommandDefinition<TContext> = CommandDefinition<OptionsSchema, TContext, TerminalCommandOutput, readonly [string, ...string[]], unknown, unknown>;
-export type TerminalAppOptions<TContext, TCommands extends readonly TerminalCommandDefinition<TContext>[]> = {
+type BivariantCallback<TInput, TOutput> = {
+    bivarianceHack(input: TInput): TOutput;
+}['bivarianceHack'];
+type TerminalCommandDefinition = {
+    path: readonly [string, ...string[]];
+    options: OptionsSchema;
+    metadata?: unknown;
+    allowExtraPositionals?: boolean;
+    prepare?: BivariantCallback<PreparedCommandInput, unknown | Promise<unknown>>;
+    handle: BivariantCallback<TerminalCommandInput, TerminalCommandOutput | Promise<TerminalCommandOutput>>;
+};
+type PreparedCommandInput = {
+    options: Record<string, unknown>;
+    provided: Record<string, boolean>;
+    positionals: string[];
+};
+type TerminalCommandInput = PreparedCommandInput & {
+    context: unknown;
+    payload?: unknown;
+};
+export type TerminalAppOptions<TCommands extends readonly TerminalCommandDefinition[]> = {
     commands: Commands<TCommands>;
     /** Custom presentation facade. */
     presentation?: Presentation;
@@ -31,14 +50,14 @@ export type TerminalAppOptions<TContext, TCommands extends readonly TerminalComm
     /** Resolves output format. */
     resolveFormat?(prepared: PreparedCommand<TCommands[number]>): PresentationFormat | undefined;
 };
-export type TerminalApp<TContext, TCommands extends readonly TerminalCommandDefinition<TContext>[]> = {
+export type TerminalApp<TCommands extends readonly TerminalCommandDefinition[]> = {
     commands: Commands<TCommands>;
     presentation: Presentation;
     output: Output;
     /** No application context required. */
     prepare(args: readonly string[], options?: CommandResolutionOptions): Promise<PreparedCommand<TCommands[number]>>;
     /** Returns a process-style exit code. */
-    run(args: readonly string[], context: TContext, options?: CommandResolutionOptions): Promise<number>;
+    run(args: readonly string[], context: CommandContext<TCommands[number]>, options?: CommandResolutionOptions): Promise<number>;
 };
 /**
  * Composes command mechanics, presentation rendering, and output delivery into
@@ -47,5 +66,5 @@ export type TerminalApp<TContext, TCommands extends readonly TerminalCommandDefi
  * Command handlers keep ownership of application work; this facade only
  * prepares commands, renders supported terminal results, and writes output.
  */
-export declare function createTerminalApp<TContext, const TCommands extends readonly TerminalCommandDefinition<TContext>[]>(options: TerminalAppOptions<TContext, TCommands>): TerminalApp<TContext, TCommands>;
+export declare function createTerminalApp<const TCommands extends readonly TerminalCommandDefinition[]>(options: TerminalAppOptions<TCommands>): TerminalApp<TCommands>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icore",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "description": "Declarative command line interface and terminal presentation mechanics for Node.js",
   "keywords": [
     "command-line",