@alpacakit/channels 0.1.0-beta.37 → 0.2.0-beta.2

package/examples/greeting.ts

@@ -0,0 +1,193 @@
+// Consumer-owned adapters over the implemented public collectors.
+import {
+  codecs,
+  defineEntry,
+  defineEntryEndpoint,
+  defineEntryNode,
+  defineEntryTree,
+  defineParameter,
+  EntryInputError,
+  optional,
+} from "@alpacakit/channels";
+import { bindCliEntry, collectCliCommands } from "@alpacakit/channels/cli";
+import { bindHttpEntry, collectHttpRoutes } from "@alpacakit/channels/http";
+import { bindMcpEntry, collectMcpTools } from "@alpacakit/channels/mcp";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Command, CommanderError, Option } from "commander";
+import { Hono } from "hono";
+
+export const GreetEntry = defineEntry({
+  name: "greet",
+  parameters: [
+    defineParameter({
+      name: "name",
+      codec: codecs.string(),
+      requirement: optional({ default: "world" }),
+      description: "Person to greet",
+    }),
+  ],
+  project: ({ values }) => ({ name: values.name }),
+});
+
+export type GreetingContext = {
+  readonly greeting: string;
+};
+
+export function greet(
+  input: ReturnType<typeof GreetEntry.project>,
+  context: GreetingContext,
+) {
+  return { message: `${context.greeting}, ${input.name}!` };
+}
+
+export const GreetEndpoint = defineEntryEndpoint(GreetEntry, {
+  handler: greet,
+  channels: [
+    bindHttpEntry({ method: "GET" }),
+    bindMcpEntry({ name: "greet" }),
+    bindCliEntry({
+      parameters: [{ kind: "option", parameterName: "name" }],
+    }),
+  ],
+});
+
+export const AppTree = defineEntryTree(
+  defineEntryNode({
+    name: "demo",
+    description: "Greeting example",
+    children: [
+      defineEntryNode({
+        name: "greet",
+        description: "Greet someone",
+        endpoints: [GreetEndpoint],
+      }),
+    ],
+  }),
+);
+
+export function createHttpApp() {
+  const app = new Hono();
+  collectHttpRoutes(AppTree).forEach((route) => {
+    app.on(route.method, route.path, async (context) => {
+      const input = route.input.parseQuery(context.req.queries());
+      const result = await route.handler(input, { greeting: "Hello" });
+      return context.json(result);
+    });
+  });
+  app.onError((error, context) => {
+    if (error instanceof EntryInputError) {
+      return context.json({ error: "Check your input" }, 400);
+    }
+    console.error(error);
+    return context.json({ error: "Operation failed" }, 500);
+  });
+  return app;
+}
+
+export function createMcpServer() {
+  const server = new McpServer({ name: "demo", version: "1.0.0" });
+  collectMcpTools(AppTree).forEach((tool) => {
+    server.registerTool(
+      tool.name,
+      { inputSchema: tool.input.schema },
+      async (values) => {
+        try {
+          // The SDK has already validated and transformed these values.
+          const input = tool.input.project(values);
+          const result = await tool.handler(input, { greeting: "Hello" });
+          return { content: [{ type: "text", text: result.message }] };
+        } catch (error) {
+          const expected = error instanceof EntryInputError;
+          if (!expected) {
+            console.error(error);
+          }
+          return {
+            isError: true,
+            content: [
+              {
+                type: "text",
+                text: expected ? "Check your input" : "Operation failed",
+              },
+            ],
+          };
+        }
+      },
+    );
+  });
+  return server;
+}
+
+export function createCliProgram(
+  writeMessage: (message: string) => void = console.log,
+) {
+  const view = collectCliCommands(AppTree);
+  const program = new Command()
+    .name(view.root.token)
+    .exitOverride()
+    .enablePositionalOptions();
+
+  function register(node: typeof view.root, command: Command): void {
+    command.description(node.description);
+    node.commands.forEach((spec) => {
+      // This example tree only uses value-taking options.
+      const mappings = spec.parameters.map((parameter) => {
+        if (parameter.kind !== "option" || parameter.optionKind !== "value") {
+          throw new Error("This example only handles value-taking options");
+        }
+        const option = new Option(
+          `${parameter.flags.join(", ")} <${parameter.valueName}>`,
+          parameter.description,
+        );
+        command.addOption(option);
+        return {
+          name: parameter.parameterName,
+          attribute: option.attributeName(),
+        };
+      });
+      command.action(async () => {
+        const raw = Object.fromEntries(
+          mappings
+            .filter(
+              (mapping) =>
+                command.getOptionValueSource(mapping.attribute) === "cli",
+            )
+            .map((mapping) => [
+              mapping.name,
+              command.getOptionValue(mapping.attribute),
+            ]),
+        );
+        const input = spec.input.parseOptions(raw);
+        const result = await spec.handler(input, { greeting: "Hello" });
+        writeMessage(result.message);
+      });
+    });
+    for (const child of node.children) {
+      register(child, command.command(child.token));
+    }
+  }
+
+  register(view.root, program);
+  return program;
+}
+
+export async function runCli(argv: readonly string[]): Promise<void> {
+  try {
+    await createCliProgram().parseAsync([...argv], { from: "user" });
+  } catch (error) {
+    if (error instanceof CommanderError) {
+      process.exitCode = error.exitCode;
+      return;
+    }
+    if (error instanceof EntryInputError) {
+      console.error("Check your input");
+      process.exitCode = 2;
+      return;
+    }
+    console.error(error);
+    process.exitCode = 1;
+  }
+}
+
+// CLI entrypoint: await runCli(process.argv.slice(2));
+// HTTP host: mount createHttpApp() in the existing Hono application.
+// MCP host: await createMcpServer().connect(theChosenTransport);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alpacakit/channels",
-  "version": "0.1.0-beta.37",
-  "description": "Neutral multi-channel entry definitions with CLI and MCP binding adapters.",
+  "version": "0.2.0-beta.2",
+  "description": "Neutral multi-channel entry definitions with CLI, MCP, and HTTP binding adapters.",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
@@ -20,16 +20,21 @@
     "./mcp": {
       "types": "./dist/mcp.d.ts",
       "import": "./dist/mcp.js"
+    },
+    "./http": {
+      "types": "./dist/http.d.ts",
+      "import": "./dist/http.js"
     }
   },
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "examples",
     "README*.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@alpacakit/core": "0.1.0-beta.37"
+    "@alpacakit/core": "0.2.0-beta.2"
   },
   "peerDependencies": {
     "zod": "^4.3.6"
@@ -40,7 +45,7 @@
     "zod": "4.3.6"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run"
   }

package/dist/cli-application.d.ts

@@ -1,40 +0,0 @@
-import type { CliCommandPath, CliLongOptionFlag, CliOptionFlag } from "./cli-model.js";
-export declare const CLI_HELP_REQUEST_KIND: {
-    readonly path: "path";
-};
-export type CliHelpRequest = {
-    readonly kind: typeof CLI_HELP_REQUEST_KIND.path;
-    readonly path: CliCommandPath;
-    readonly all: boolean;
-};
-export type CliHelpRequestDefinition = {
-    readonly commandToken: string;
-    readonly optionTokens: readonly CliOptionFlag[];
-    readonly allToken: CliLongOptionFlag;
-};
-export declare function parseCliHelpRequest(argv: readonly string[], definition: CliHelpRequestDefinition): CliHelpRequest | null;
-export declare const CLI_GLOBAL_OPTION_RESULT_KIND: {
-    readonly absent: "absent";
-    readonly invalid: "invalid";
-    readonly resolved: "resolved";
-};
-export declare const CLI_GLOBAL_OPTION_ISSUE_KIND: {
-    readonly duplicate: "duplicate";
-    readonly invalidValue: "invalid_value";
-};
-export type CliGlobalValueOptionDefinition<Value extends string = string> = {
-    readonly flag: CliLongOptionFlag;
-    readonly values: readonly Value[];
-};
-export type CliGlobalValueOptionResult<Value extends string = string> = {
-    readonly kind: typeof CLI_GLOBAL_OPTION_RESULT_KIND.absent;
-} | {
-    readonly kind: typeof CLI_GLOBAL_OPTION_RESULT_KIND.invalid;
-    readonly issue: typeof CLI_GLOBAL_OPTION_ISSUE_KIND.duplicate | typeof CLI_GLOBAL_OPTION_ISSUE_KIND.invalidValue;
-} | {
-    readonly kind: typeof CLI_GLOBAL_OPTION_RESULT_KIND.resolved;
-    readonly value: Value;
-    readonly argv: readonly string[];
-};
-export declare function extractCliGlobalValueOption<Value extends string>(argv: readonly string[], definition: CliGlobalValueOptionDefinition<Value>): CliGlobalValueOptionResult<Value>;
-//# sourceMappingURL=cli-application.d.ts.map

package/dist/cli-application.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-application.d.ts","sourceRoot":"","sources":["../src/cli-application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACd,MAAM,gBAAgB,CAAC;AAOxB,eAAO,MAAM,qBAAqB;;CAExB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,qBAAqB,CAAC,IAAI,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,UAAU,EAAE,wBAAwB,GACnC,cAAc,GAAG,IAAI,CAoBvB;AAiBD,eAAO,MAAM,6BAA6B;;;;CAIhC,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;CAG/B,CAAC;AAEX,MAAM,MAAM,8BAA8B,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI;IAC1E,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,6BAA6B,CAAC,MAAM,CAAA;CAAE,GAC9D;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,6BAA6B,CAAC,OAAO,CAAC;IAC5D,QAAQ,CAAC,KAAK,EACV,OAAO,4BAA4B,CAAC,SAAS,GAC7C,OAAO,4BAA4B,CAAC,YAAY,CAAC;CACtD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,6BAA6B,CAAC,QAAQ,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAEN,wBAAgB,2BAA2B,CAAC,KAAK,SAAS,MAAM,EAC9D,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,UAAU,EAAE,8BAA8B,CAAC,KAAK,CAAC,GAChD,0BAA0B,CAAC,KAAK,CAAC,CA4CnC"}

package/dist/cli-application.js

@@ -1,90 +0,0 @@
-const CLI_APPLICATION_SYNTAX = {
-    optionPrefix: "-",
-    positionalSeparator: "--",
-};
-export const CLI_HELP_REQUEST_KIND = {
-    path: "path",
-};
-export function parseCliHelpRequest(argv, definition) {
-    if (argv.length === 0)
-        return pathHelpRequest([], false);
-    if (argv[0] === definition.commandToken) {
-        const args = argv.slice(1);
-        if (args.length === 1 &&
-            definition.optionTokens.includes(args[0])) {
-            return pathHelpRequest([], false);
-        }
-        if (args.at(-1) === definition.allToken) {
-            return createPathHelpRequest(args.slice(0, -1), true);
-        }
-        return createPathHelpRequest(args, false);
-    }
-    const helpToken = argv.at(-1);
-    if (!definition.optionTokens.includes(helpToken)) {
-        return null;
-    }
-    return createPathHelpRequest(argv.slice(0, -1), false);
-}
-function createPathHelpRequest(path, all) {
-    return path.every((token) => !token.startsWith(CLI_APPLICATION_SYNTAX.optionPrefix))
-        ? pathHelpRequest(path, all)
-        : null;
-}
-function pathHelpRequest(path, all) {
-    return { kind: CLI_HELP_REQUEST_KIND.path, path, all };
-}
-export const CLI_GLOBAL_OPTION_RESULT_KIND = {
-    absent: "absent",
-    invalid: "invalid",
-    resolved: "resolved",
-};
-export const CLI_GLOBAL_OPTION_ISSUE_KIND = {
-    duplicate: "duplicate",
-    invalidValue: "invalid_value",
-};
-export function extractCliGlobalValueOption(argv, definition) {
-    const inlinePrefix = `${definition.flag}=`;
-    const values = [];
-    const normalized = [];
-    let optionsEnded = false;
-    for (let index = 0; index < argv.length; index += 1) {
-        const token = argv[index];
-        if (token === CLI_APPLICATION_SYNTAX.positionalSeparator) {
-            optionsEnded = true;
-            normalized.push(token);
-            continue;
-        }
-        if (!optionsEnded && token === definition.flag) {
-            values.push(argv[index + 1] ?? "");
-            index += 1;
-            continue;
-        }
-        if (!optionsEnded && token?.startsWith(inlinePrefix) === true) {
-            values.push(token.slice(inlinePrefix.length));
-            continue;
-        }
-        if (token !== undefined)
-            normalized.push(token);
-    }
-    if (values.length === 0) {
-        return { kind: CLI_GLOBAL_OPTION_RESULT_KIND.absent };
-    }
-    if (values.length > 1) {
-        return {
-            kind: CLI_GLOBAL_OPTION_RESULT_KIND.invalid,
-            issue: CLI_GLOBAL_OPTION_ISSUE_KIND.duplicate,
-        };
-    }
-    const value = values[0];
-    if (!definition.values.includes(value)) {
-        return {
-            kind: CLI_GLOBAL_OPTION_RESULT_KIND.invalid,
-            issue: CLI_GLOBAL_OPTION_ISSUE_KIND.invalidValue,
-        };
-    }
-    return {
-        kind: CLI_GLOBAL_OPTION_RESULT_KIND.resolved,
-        value: value,
-        argv: normalized,
-    };
-}

package/dist/cli-executor.d.ts

@@ -1,25 +0,0 @@
-import type { CLI_ROUTER_RESULT_KIND, CliResolvedEndpointResult, CliRouter, CliRouterResult } from "./cli-model.js";
-import type { EntryTreeEndpoint } from "./model.js";
-type ResolvedCliResult = Extract<CliRouterResult, {
-    readonly kind: typeof CLI_ROUTER_RESULT_KIND.resolved;
-}>;
-export type CliEndpointHandlerBinding<Endpoint extends EntryTreeEndpoint = EntryTreeEndpoint, Result = unknown> = {
-    readonly endpoint: Endpoint;
-    readonly handler: (input: CliResolvedEndpointResult<Endpoint>) => Result | Promise<Result>;
-};
-export type CliEndpointHandlerRegistration<Result = unknown> = {
-    readonly endpoint: EntryTreeEndpoint;
-    readonly handler: (...args: never[]) => Result | Promise<Result>;
-};
-export declare class CliExecutorDefinitionError extends Error {
-    readonly issues: readonly string[];
-    constructor(issues: readonly string[]);
-}
-export declare function handleCliEndpoint<const Endpoint extends EntryTreeEndpoint, Result>(endpoint: Endpoint, handler: (input: CliResolvedEndpointResult<Endpoint>) => Result | Promise<Result>): CliEndpointHandlerBinding<Endpoint, Result>;
-type CliHandlerResult<Bindings extends readonly CliEndpointHandlerRegistration[]> = Awaited<ReturnType<Bindings[number]["handler"]>>;
-export type CliExecutor<Bindings extends readonly CliEndpointHandlerRegistration[]> = {
-    execute(result: ResolvedCliResult): Promise<CliHandlerResult<Bindings>>;
-};
-export declare function createCliExecutor<const Bindings extends readonly CliEndpointHandlerRegistration[]>(router: CliRouter, bindings: Bindings): CliExecutor<Bindings>;
-export {};
-//# sourceMappingURL=cli-executor.d.ts.map

package/dist/cli-executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-executor.d.ts","sourceRoot":"","sources":["../src/cli-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EACzB,SAAS,EACT,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,KAAK,iBAAiB,GAAG,OAAO,CAC9B,eAAe,EACf;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,sBAAsB,CAAC,QAAQ,CAAA;CAAE,CAC1D,CAAC;AAEF,MAAM,MAAM,yBAAyB,CACnC,QAAQ,SAAS,iBAAiB,GAAG,iBAAiB,EACtD,MAAM,GAAG,OAAO,IACd;IACF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,yBAAyB,CAAC,QAAQ,CAAC,KACvC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,8BAA8B,CAAC,MAAM,GAAG,OAAO,IAAI;IAC7D,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE,CAAC;AAEF,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;gBAAzB,MAAM,EAAE,SAAS,MAAM,EAAE;CAI/C;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,QAAQ,SAAS,iBAAiB,EACxC,MAAM,EAEN,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,CACP,KAAK,EAAE,yBAAyB,CAAC,QAAQ,CAAC,KACvC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC5B,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAE7C;AAED,KAAK,gBAAgB,CACnB,QAAQ,SAAS,SAAS,8BAA8B,EAAE,IACxD,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAErD,MAAM,MAAM,WAAW,CACrB,QAAQ,SAAS,SAAS,8BAA8B,EAAE,IACxD;IACF,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;CACzE,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,QAAQ,SAAS,SAAS,8BAA8B,EAAE,EAChE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAsC9D"}

package/dist/cli-executor.js

@@ -1,44 +0,0 @@
-export class CliExecutorDefinitionError extends Error {
-    issues;
-    constructor(issues) {
-        super(`Invalid CLI executor definition:\n${issues.join("\n")}`);
-        this.issues = issues;
-        this.name = CliExecutorDefinitionError.name;
-    }
-}
-export function handleCliEndpoint(endpoint, handler) {
-    return { endpoint, handler };
-}
-export function createCliExecutor(router, bindings) {
-    const issues = [];
-    const routerEndpoints = new Set(router.endpoints);
-    const handlers = new Map();
-    for (const binding of bindings) {
-        if (!routerEndpoints.has(binding.endpoint)) {
-            issues.push(`handler endpoint ${binding.endpoint.entry.name} is not in the router`);
-        }
-        if (handlers.has(binding.endpoint)) {
-            issues.push(`duplicate handler for endpoint ${binding.endpoint.entry.name}`);
-        }
-        handlers.set(binding.endpoint, binding);
-    }
-    for (const endpoint of router.endpoints) {
-        if (!handlers.has(endpoint)) {
-            issues.push(`missing handler for endpoint ${endpoint.entry.name}`);
-        }
-    }
-    if (issues.length > 0) {
-        throw new CliExecutorDefinitionError(issues);
-    }
-    const execute = async (result) => {
-        const binding = handlers.get(result.endpoint);
-        if (!binding) {
-            throw new CliExecutorDefinitionError([
-                `missing handler for endpoint ${result.endpoint.entry.name}`,
-            ]);
-        }
-        const handler = binding.handler;
-        return await handler(result);
-    };
-    return { execute };
-}

package/dist/cli-presentation.d.ts

@@ -1,38 +0,0 @@
-import { CLI_ROUTER_RESULT_KIND, type CliCommandPath, type CliHelpExample, type CliHelpOption, type CliHelpRenderContext, type CliHelpSurface, type CliHelpSurfaceLocation, type CliRouterResult } from "./cli-model.js";
-import type { ParameterRequirementDescription } from "./introspection.js";
-export type CliHelpOptionDescription = {
-    readonly names: string;
-    readonly description: string;
-};
-export declare function findCliHelpSurface(root: CliHelpSurface, commandPath: CliCommandPath): CliHelpSurface | null;
-export declare function findCliHelpSurfaceLocation(root: CliHelpSurface, commandPath: CliCommandPath): CliHelpSurfaceLocation | null;
-/**
- * Rendered help always ends with exactly one newline. Help is written to a
- * terminal, so the terminating newline belongs to the renderer: leaving it out
- * makes every caller append the same one, and each one of them a place to
- * forget it or to append two.
- */
-export declare function renderCliHelp(surface: CliHelpSurface, context: CliHelpRenderContext): string;
-export declare function listCliHelpSurfaces(root: CliHelpSurface): readonly CliHelpSurfaceLocation[];
-export type CliHelpSurfaceProjection = {
-    include(location: CliHelpSurfaceLocation): boolean;
-    compare?(left: CliHelpSurfaceLocation, right: CliHelpSurfaceLocation): number;
-};
-/**
- * Projects one immutable help tree without recreating its structural fields.
- * The root is always retained; `include` and `compare` are applied to children.
- */
-export declare function projectCliHelpSurface(root: CliHelpSurface, projection: CliHelpSurfaceProjection): CliHelpSurface;
-export declare function describeCliHelpOption(option: CliHelpOption): CliHelpOptionDescription;
-export declare function appendCliCommandPart(command: string, part: string): string;
-export declare function formatDefaultCliSubcommandHint(programName: string): string;
-export declare function formatCliRouterError(result: Extract<CliRouterResult, {
-    readonly kind: typeof CLI_ROUTER_RESULT_KIND.unknownCommand | typeof CLI_ROUTER_RESULT_KIND.incompleteCommand | typeof CLI_ROUTER_RESULT_KIND.invalidInput | typeof CLI_ROUTER_RESULT_KIND.invalidParameter;
-}>): string;
-export declare function formatCliHelpParameterDescription(input: {
-    readonly description: string;
-    readonly requirement: ParameterRequirementDescription;
-    readonly additionalDetails: readonly string[];
-}): string;
-export declare function renderCliHelpExamples(examples: readonly CliHelpExample[], executableName: string): readonly string[];
-//# sourceMappingURL=cli-presentation.d.ts.map

package/dist/cli-presentation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-presentation.d.ts","sourceRoot":"","sources":["../src/cli-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAE3B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAmD1E,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,WAAW,EAAE,cAAc,GAC1B,cAAc,GAAG,IAAI,CAEvB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,cAAc,EACpB,WAAW,EAAE,cAAc,GAC1B,sBAAsB,GAAG,IAAI,CAc/B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAYR;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,GACnB,SAAS,sBAAsB,EAAE,CAanC;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC;IACnD,OAAO,CAAC,CAAC,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAAC;CAC/E,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,wBAAwB,GACnC,cAAc,CAsBhB;AAmJD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,GACpB,wBAAwB,CAuB1B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,CACb,eAAe,EACf;IACE,QAAQ,CAAC,IAAI,EACT,OAAO,sBAAsB,CAAC,cAAc,GAC5C,OAAO,sBAAsB,CAAC,iBAAiB,GAC/C,OAAO,sBAAsB,CAAC,YAAY,GAC1C,OAAO,sBAAsB,CAAC,gBAAgB,CAAC;CACpD,CACF,GACA,MAAM,CAcR;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,+BAA+B,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C,GAAG,MAAM,CAUT;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,cAAc,EAAE,MAAM,GACrB,SAAS,MAAM,EAAE,CAiBnB"}