@alpacakit/channels 0.1.0-beta.37 → 0.1.0-beta.39

package/dist/cli-presentation.js

@@ -1,301 +0,0 @@
-import { CLI_ROUTER_RESULT_KIND, } from "./cli-model.js";
-import { CLI_OPTION_KIND, CLI_OPTION_VALUE_MODE } from "./cli-values.js";
-import { PARAMETER_REQUIREMENT_KIND } from "./values.js";
-const CLI_HELP_TEXT = {
-    argumentsHeading: "Arguments:",
-    commandArgument: "<command>",
-    commandsHeading: "Commands:",
-    commaOrRepeatDetail: "comma-separated or repeatable",
-    defaultDetailPrefix: "default:",
-    examplesHeading: "Examples:",
-    expectedResultHeading: "Expected result:",
-    incompleteCommandPrefix: "Incomplete command:",
-    invalidInputLabel: "Invalid input",
-    invalidParameterPrefix: "Invalid",
-    nextStepsHeading: "Next steps:",
-    optionsHeading: "Options:",
-    optionalDetail: "optional",
-    relatedDocumentationHeading: "Related documentation:",
-    remarksHeading: "Remarks:",
-    repeatableDetail: "repeatable",
-    requiredDetail: "required",
-    unknownCommandPrefix: "Unknown command:",
-    usageHeading: "Usage:",
-    useWhenPrefix: "Use when",
-};
-const CLI_OPTION_VALUE_MODE_DETAILS = {
-    [CLI_OPTION_VALUE_MODE.replace]: [],
-    [CLI_OPTION_VALUE_MODE.repeat]: [CLI_HELP_TEXT.repeatableDetail],
-    [CLI_OPTION_VALUE_MODE.commaOrRepeat]: [CLI_HELP_TEXT.commaOrRepeatDetail],
-};
-const CLI_HELP_LAYOUT = {
-    columnSeparator: "\t",
-    commandPartSeparator: " ",
-    detailSeparator: ", ",
-    emptyLine: "",
-    issueSeparator: "; ",
-    itemIndent: "  ",
-    lineSeparator: "\n",
-    nestedItemIndent: "    ",
-    resultIndent: "      ",
-    sectionSeparator: "\n\n",
-};
-const TRAILING_NEWLINES_PATTERN = /\n+$/u;
-export function findCliHelpSurface(root, commandPath) {
-    return findCliHelpSurfaceLocation(root, commandPath)?.surface ?? null;
-}
-export function findCliHelpSurfaceLocation(root, commandPath) {
-    let current = root;
-    const path = [];
-    for (const token of commandPath) {
-        const child = current.children.find((candidate) => candidate.token === token);
-        if (!child) {
-            return null;
-        }
-        current = child;
-        path.push(child.token ?? child.name);
-    }
-    return { surface: current, path };
-}
-/**
- * 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 function renderCliHelp(surface, context) {
-    const body = joinCliHelpSections([
-        createCliHelpSummarySection(surface, context.programName),
-        createCliHelpCommandsSection(surface),
-        createCliHelpArgumentsSection(surface),
-        createCliHelpOptionsSection(surface),
-        createCliHelpRemarksSection(surface),
-        createCliHelpExamplesSection(surface, context.executableName),
-        createCliHelpDocumentationSection(surface),
-        createCliHelpNextStepsSection(surface, context.programName),
-    ]);
-    return `${body.replace(TRAILING_NEWLINES_PATTERN, "")}${CLI_HELP_LAYOUT.lineSeparator}`;
-}
-export function listCliHelpSurfaces(root) {
-    const locations = [];
-    const pending = [{ surface: root, path: [] }];
-    for (const current of pending) {
-        locations.push(current);
-        pending.push(...current.surface.children.map((child) => ({
-            surface: child,
-            path: [...current.path, child.token ?? child.name],
-        })));
-    }
-    return locations;
-}
-/**
- * Projects one immutable help tree without recreating its structural fields.
- * The root is always retained; `include` and `compare` are applied to children.
- */
-export function projectCliHelpSurface(root, projection) {
-    const projected = new Map();
-    const pending = [...listCliHelpSurfaces(root)].reverse();
-    for (const location of pending) {
-        const children = location.surface.children.flatMap((child) => {
-            const childPath = [...location.path, child.token ?? child.name];
-            const childLocation = { surface: child, path: childPath };
-            if (!projection.include(childLocation))
-                return [];
-            const projectedChild = projected.get(child);
-            return projectedChild === undefined
-                ? []
-                : [{ surface: projectedChild, path: childPath }];
-        });
-        if (projection.compare !== undefined) {
-            children.sort(projection.compare);
-        }
-        projected.set(location.surface, {
-            ...location.surface,
-            children: children.map((child) => child.surface),
-        });
-    }
-    return projected.get(root) ?? { ...root, children: [] };
-}
-function joinCliHelpSections(sections) {
-    return sections
-        .flatMap((section) => (section === null ? [] : [section]))
-        .map((section) => section.join(CLI_HELP_LAYOUT.lineSeparator))
-        .join(CLI_HELP_LAYOUT.sectionSeparator);
-}
-function createCliHelpSummarySection(surface, programName) {
-    return [
-        ...surface.usages.map((usage) => `${CLI_HELP_TEXT.usageHeading} ${appendCliCommandPart(programName, usage)}`),
-        CLI_HELP_LAYOUT.emptyLine,
-        surface.description,
-    ];
-}
-function createCliHelpCommandsSection(surface) {
-    if (surface.children.length === 0) {
-        return null;
-    }
-    return [
-        CLI_HELP_TEXT.commandsHeading,
-        ...surface.children.map((child) => {
-            const name = child.token ?? child.name;
-            return `${CLI_HELP_LAYOUT.itemIndent}${name}${CLI_HELP_LAYOUT.columnSeparator}${child.description}`;
-        }),
-    ];
-}
-function createCliHelpArgumentsSection(surface) {
-    if (surface.positionals.length === 0) {
-        return null;
-    }
-    return [
-        CLI_HELP_TEXT.argumentsHeading,
-        ...surface.positionals.map((positional) => `${CLI_HELP_LAYOUT.itemIndent}${positional.valueName}${CLI_HELP_LAYOUT.columnSeparator}${formatCliHelpParameterDescription({
-            description: positional.description,
-            requirement: positional.requirement,
-            additionalDetails: [],
-        })}`),
-    ];
-}
-function createCliHelpOptionsSection(surface) {
-    if (surface.optionGroups.length === 0) {
-        return null;
-    }
-    return [CLI_HELP_TEXT.optionsHeading, ...renderCliHelpOptions(surface)];
-}
-function createCliHelpRemarksSection(surface) {
-    if (surface.remarks.length === 0) {
-        return null;
-    }
-    return [
-        CLI_HELP_TEXT.remarksHeading,
-        ...surface.remarks.map((remark) => `${CLI_HELP_LAYOUT.itemIndent}${remark}`),
-    ];
-}
-function createCliHelpExamplesSection(surface, programName) {
-    if (surface.examples.length === 0) {
-        return null;
-    }
-    return [
-        CLI_HELP_TEXT.examplesHeading,
-        ...renderCliHelpExamples(surface.examples, programName),
-    ];
-}
-function createCliHelpDocumentationSection(surface) {
-    if (surface.relatedDocs.length === 0) {
-        return null;
-    }
-    return [
-        CLI_HELP_TEXT.relatedDocumentationHeading,
-        ...surface.relatedDocs.map((documentId) => `${CLI_HELP_LAYOUT.itemIndent}${documentId}`),
-    ];
-}
-function createCliHelpNextStepsSection(surface, programName) {
-    if (surface.children.length === 0) {
-        return null;
-    }
-    return [
-        CLI_HELP_TEXT.nextStepsHeading,
-        `${CLI_HELP_LAYOUT.itemIndent}${surface.subcommandHint ?? formatDefaultCliSubcommandHint(programName)}`,
-    ];
-}
-function renderCliHelpOptions(surface) {
-    return surface.optionGroups.flatMap((group) => {
-        const indent = group.heading === null
-            ? CLI_HELP_LAYOUT.itemIndent
-            : CLI_HELP_LAYOUT.nestedItemIndent;
-        return [
-            ...(group.heading === null
-                ? []
-                : [`${CLI_HELP_LAYOUT.itemIndent}${group.heading}`]),
-            ...(group.description === null
-                ? []
-                : [`${CLI_HELP_LAYOUT.nestedItemIndent}${group.description}`]),
-            ...group.options.map((option) => renderCliHelpOption(option, indent)),
-        ];
-    });
-}
-function renderCliHelpOption(option, indent) {
-    const description = describeCliHelpOption(option);
-    return `${indent}${description.names}${CLI_HELP_LAYOUT.columnSeparator}${description.description}`;
-}
-export function describeCliHelpOption(option) {
-    switch (option.kind) {
-        case CLI_OPTION_KIND.booleanFlag:
-            return {
-                names: [...option.flags, ...option.negativeFlags].join(CLI_HELP_LAYOUT.detailSeparator),
-                description: formatCliHelpParameterDescription({
-                    description: option.description,
-                    requirement: option.requirement,
-                    additionalDetails: [],
-                }),
-            };
-        case CLI_OPTION_KIND.value:
-            return {
-                names: `${option.flags.join(CLI_HELP_LAYOUT.detailSeparator)} <${option.valueName}>`,
-                description: formatCliHelpParameterDescription({
-                    description: option.description,
-                    requirement: option.requirement,
-                    additionalDetails: CLI_OPTION_VALUE_MODE_DETAILS[option.valueMode],
-                }),
-            };
-    }
-}
-export function appendCliCommandPart(command, part) {
-    return part.length === 0
-        ? command
-        : `${command}${CLI_HELP_LAYOUT.commandPartSeparator}${part}`;
-}
-export function formatDefaultCliSubcommandHint(programName) {
-    return `Run \`${programName} ${CLI_HELP_TEXT.commandArgument} --help\` for subcommand details.`;
-}
-export function formatCliRouterError(result) {
-    switch (result.kind) {
-        case CLI_ROUTER_RESULT_KIND.unknownCommand:
-            return `${CLI_HELP_TEXT.unknownCommandPrefix} ${[
-                ...result.path,
-                result.token,
-            ].join(CLI_HELP_LAYOUT.commandPartSeparator)}.`;
-        case CLI_ROUTER_RESULT_KIND.incompleteCommand:
-            return `${CLI_HELP_TEXT.incompleteCommandPrefix} ${result.path.join(CLI_HELP_LAYOUT.commandPartSeparator)}.`;
-        case CLI_ROUTER_RESULT_KIND.invalidInput:
-            return `${CLI_HELP_TEXT.invalidInputLabel}: ${result.issues.join(CLI_HELP_LAYOUT.issueSeparator)}`;
-        case CLI_ROUTER_RESULT_KIND.invalidParameter:
-            return `${CLI_HELP_TEXT.invalidParameterPrefix} ${result.parameterName}: ${result.issues.join(CLI_HELP_LAYOUT.issueSeparator)}`;
-    }
-}
-export function formatCliHelpParameterDescription(input) {
-    const [presenceDetail, ...defaultDetails] = formatParameterRequirementDetails(input.requirement);
-    const details = [
-        presenceDetail,
-        ...input.additionalDetails,
-        ...defaultDetails,
-    ];
-    return `${input.description} (${details.join(CLI_HELP_LAYOUT.detailSeparator)})`;
-}
-export function renderCliHelpExamples(examples, executableName) {
-    return examples.flatMap((example, index) => [
-        ...(index === 0 ? [] : [CLI_HELP_LAYOUT.emptyLine]),
-        `${CLI_HELP_LAYOUT.itemIndent}${example.title}:`,
-        `${CLI_HELP_LAYOUT.nestedItemIndent}${CLI_HELP_TEXT.useWhenPrefix} ${example.useWhen}`,
-        CLI_HELP_LAYOUT.emptyLine,
-        `${CLI_HELP_LAYOUT.nestedItemIndent}${appendCliCommandPart(executableName, example.command)}`,
-        ...(example.expectedResult.length === 0
-            ? []
-            : [
-                CLI_HELP_LAYOUT.emptyLine,
-                `${CLI_HELP_LAYOUT.nestedItemIndent}${CLI_HELP_TEXT.expectedResultHeading}`,
-                ...example.expectedResult.map((line) => `${CLI_HELP_LAYOUT.resultIndent}${line}`),
-            ]),
-    ]);
-}
-function formatParameterRequirementDetails(requirement) {
-    switch (requirement.kind) {
-        case PARAMETER_REQUIREMENT_KIND.required:
-            return [CLI_HELP_TEXT.requiredDetail];
-        case PARAMETER_REQUIREMENT_KIND.optional:
-            return [CLI_HELP_TEXT.optionalDetail];
-        case PARAMETER_REQUIREMENT_KIND.optionalWithDefault:
-            return [
-                CLI_HELP_TEXT.optionalDetail,
-                `${CLI_HELP_TEXT.defaultDetailPrefix} ${JSON.stringify(requirement.defaultValue)}`,
-            ];
-    }
-}

package/dist/cli-result-envelope.d.ts

@@ -1,104 +0,0 @@
-import { type JsonValue } from "@alpacakit/core";
-import { z } from "zod";
-export declare const CLI_RESULT_STATUS: {
-    readonly completed: "completed";
-    readonly rejected: "rejected";
-    readonly partial: "partial";
-};
-export declare const CLI_RESULT_CODE: {
-    readonly ok: "ok";
-};
-/**
- * Process exit classes for commands that produced a typed result. Unexpected
- * process faults sit outside this contract and are projected by the host.
- */
-export declare const CLI_COMMAND_EXIT_CODE: {
-    readonly success: 0;
-    readonly rejected: 1;
-    readonly syntax: 2;
-};
-export declare const CLI_OUTPUT_FORMAT: {
-    readonly text: "text";
-    readonly json: "json";
-};
-export type CliOutputFormat = (typeof CLI_OUTPUT_FORMAT)[keyof typeof CLI_OUTPUT_FORMAT];
-export type CliResultStatus = (typeof CLI_RESULT_STATUS)[keyof typeof CLI_RESULT_STATUS];
-export type CliCommandExitCode = (typeof CLI_COMMAND_EXIT_CODE)[keyof typeof CLI_COMMAND_EXIT_CODE];
-export type CliDataVersion = `${string}/v${number}`;
-export type CliNextAction = {
-    readonly label: string;
-    readonly command: string;
-};
-export type CliResultEnvelope<Data extends JsonValue = JsonValue> = {
-    readonly envelopeVersion: 1;
-    readonly dataVersion: CliDataVersion;
-    readonly command: string;
-    readonly status: CliResultStatus;
-    readonly code: string;
-    readonly data: Data;
-    readonly nextActions: readonly CliNextAction[];
-};
-/** One typed command result from which text and the JSON envelope are projected. */
-export type CliResultProjection<Data extends JsonValue = JsonValue> = {
-    readonly status: CliResultStatus;
-    readonly code: string;
-    readonly data: Data;
-    readonly nextActions: readonly CliNextAction[];
-    readonly text: string;
-};
-/** A command's typed result paired with its process exit classification. */
-export type CliCommandExecutionResult<Data extends JsonValue = JsonValue> = {
-    readonly exitCode: CliCommandExitCode;
-    readonly result: CliResultProjection<Data>;
-};
-export declare const cliCommandExecutionResultSchema: z.ZodReadonly<z.ZodObject<{
-    exitCode: z.ZodEnum<{
-        readonly success: 0;
-        readonly rejected: 1;
-        readonly syntax: 2;
-    }>;
-    result: z.ZodReadonly<z.ZodObject<{
-        status: z.ZodEnum<{
-            completed: "completed";
-            rejected: "rejected";
-            partial: "partial";
-        }>;
-        code: z.ZodString;
-        data: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
-        nextActions: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
-            label: z.ZodString;
-            command: z.ZodString;
-        }, z.core.$strict>>>>;
-        text: z.ZodString;
-    }, z.core.$strict>>;
-}, z.core.$strict>>;
-export declare function createCliResultEnvelope<Data extends JsonValue>(input: {
-    readonly dataVersion: CliDataVersion;
-    readonly command: string;
-    readonly status: CliResultStatus;
-    readonly code: string;
-    readonly data: Data;
-    readonly nextActions?: readonly CliNextAction[];
-}): CliResultEnvelope<Data>;
-export declare function createCliResultProjection<Data extends JsonValue>(input: {
-    readonly status: CliResultStatus;
-    readonly code: string;
-    readonly data: Data;
-    readonly nextActions?: readonly CliNextAction[];
-    readonly text: string;
-}): CliResultProjection<Data>;
-export declare function createCliCommandExecutionResult<Data extends JsonValue>(input: {
-    readonly exitCode: CliCommandExitCode;
-    readonly status: CliResultStatus;
-    readonly code: string;
-    readonly data: Data;
-    readonly nextActions?: readonly CliNextAction[];
-    readonly text: string;
-}): CliCommandExecutionResult<Data>;
-export declare function projectCliResultEnvelope<Data extends JsonValue>(input: {
-    readonly dataVersion: CliDataVersion;
-    readonly command: string;
-    readonly result: CliResultProjection<Data>;
-}): CliResultEnvelope<Data>;
-export declare function verifyCliResultEnvelope(input: unknown): CliResultEnvelope;
-//# sourceMappingURL=cli-result-envelope.d.ts.map

package/dist/cli-result-envelope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-result-envelope.d.ts","sourceRoot":"","sources":["../src/cli-result-envelope.ts"],"names":[],"mappings":"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"}

package/dist/cli-result-envelope.js

@@ -1,137 +0,0 @@
-import { jsonValueSchema } from "@alpacakit/core";
-import { z } from "zod";
-export const CLI_RESULT_STATUS = {
-    completed: "completed",
-    rejected: "rejected",
-    partial: "partial",
-};
-export const CLI_RESULT_CODE = {
-    ok: "ok",
-};
-/**
- * Process exit classes for commands that produced a typed result. Unexpected
- * process faults sit outside this contract and are projected by the host.
- */
-export const CLI_COMMAND_EXIT_CODE = {
-    success: 0,
-    rejected: 1,
-    syntax: 2,
-};
-export const CLI_OUTPUT_FORMAT = {
-    text: "text",
-    json: "json",
-};
-const cliNextActionSchema = z
-    .object({ label: z.string(), command: z.string() })
-    .strict()
-    .readonly();
-const cliResultProjectionSchema = z
-    .object({
-    status: z.enum(Object.values(CLI_RESULT_STATUS)),
-    code: z.string().min(1),
-    data: jsonValueSchema,
-    nextActions: z.array(cliNextActionSchema).readonly(),
-    text: z.string(),
-})
-    .strict()
-    .readonly();
-export const cliCommandExecutionResultSchema = z
-    .object({
-    exitCode: z.enum(CLI_COMMAND_EXIT_CODE),
-    result: cliResultProjectionSchema,
-})
-    .strict()
-    .superRefine((execution, context) => {
-    const expectedExitCode = execution.result.status === CLI_RESULT_STATUS.completed
-        ? CLI_COMMAND_EXIT_CODE.success
-        : CLI_COMMAND_EXIT_CODE.rejected;
-    const valid = execution.result.status === CLI_RESULT_STATUS.rejected
-        ? execution.exitCode === CLI_COMMAND_EXIT_CODE.rejected ||
-            execution.exitCode === CLI_COMMAND_EXIT_CODE.syntax
-        : execution.exitCode === expectedExitCode;
-    if (!valid) {
-        context.addIssue({
-            code: "custom",
-            message: "Completed results require exit 0, partial results require exit 1, and rejected results require exit 1 or 2.",
-        });
-    }
-})
-    .readonly();
-const cliResultEnvelopeSchema = z
-    .object({
-    envelopeVersion: z.literal(1),
-    dataVersion: z.string().regex(/^[a-z0-9-]+\/v[1-9][0-9]*$/u),
-    command: z.string(),
-    status: z.enum(Object.values(CLI_RESULT_STATUS)),
-    code: z.string().min(1),
-    data: jsonValueSchema,
-    nextActions: z.array(cliNextActionSchema).readonly(),
-})
-    .strict()
-    .superRefine((document, context) => {
-    const completed = document.status === CLI_RESULT_STATUS.completed;
-    if (completed !== (document.code === CLI_RESULT_CODE.ok)) {
-        context.addIssue({
-            code: "custom",
-            message: "Completed results require code=ok and failures forbid it.",
-        });
-    }
-})
-    .readonly();
-export function createCliResultEnvelope(input) {
-    return verifyCliResultEnvelope({
-        envelopeVersion: 1,
-        dataVersion: input.dataVersion,
-        command: input.command,
-        status: input.status,
-        code: input.code,
-        data: input.data,
-        nextActions: input.nextActions ?? [],
-    });
-}
-export function createCliResultProjection(input) {
-    const verified = createCliResultEnvelope({
-        dataVersion: "projection/v1",
-        command: "projection",
-        status: input.status,
-        code: input.code,
-        data: input.data,
-        ...(input.nextActions === undefined
-            ? {}
-            : { nextActions: input.nextActions }),
-    });
-    return Object.freeze({
-        status: verified.status,
-        code: verified.code,
-        data: verified.data,
-        nextActions: verified.nextActions,
-        text: input.text,
-    });
-}
-export function createCliCommandExecutionResult(input) {
-    return cliCommandExecutionResultSchema.parse({
-        exitCode: input.exitCode,
-        result: createCliResultProjection({
-            status: input.status,
-            code: input.code,
-            data: input.data,
-            ...(input.nextActions === undefined
-                ? {}
-                : { nextActions: input.nextActions }),
-            text: input.text,
-        }),
-    });
-}
-export function projectCliResultEnvelope(input) {
-    return createCliResultEnvelope({
-        dataVersion: input.dataVersion,
-        command: input.command,
-        status: input.result.status,
-        code: input.result.code,
-        data: input.result.data,
-        nextActions: input.result.nextActions,
-    });
-}
-export function verifyCliResultEnvelope(input) {
-    return cliResultEnvelopeSchema.parse(input);
-}

package/dist/cli-schema.d.ts

@@ -1,4 +0,0 @@
-import type { CliEntryBinding, CliSegment } from "./cli-model.js";
-export declare function isCliSegment(value: unknown): value is CliSegment;
-export declare function isCliEntryBinding(value: unknown): value is CliEntryBinding;
-//# sourceMappingURL=cli-schema.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cli-schema.d.ts","sourceRoot":"","sources":["../src/cli-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGlE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/cli-schema.js

@@ -1,7 +0,0 @@
-import { isChannelPayload, PAYLOAD_KIND } from "./tree-internal.js";
-export function isCliSegment(value) {
-    return isChannelPayload(PAYLOAD_KIND.cliSegment, value);
-}
-export function isCliEntryBinding(value) {
-    return isChannelPayload(PAYLOAD_KIND.cliBinding, value);
-}