@procedures/cli-kit 0.0.0-stage → 0.35.1

package/dist/help.js

@@ -0,0 +1,188 @@
+/**
+ * The help text of a command line: the help of one command, of a group of commands and of the
+ * whole program.
+ *
+ * Each function gives the text and prints nothing. The caller prints it.
+ */
+import { findChildren } from "./args.js";
+import { extractSchemaFields, fieldWithoutSchema, toKebab, typeName, } from "./fields.js";
+/** This function gives the hint of a field on the command line, for the help text. */
+function valueHint(field) {
+    const type = field.fieldType;
+    switch (type.kind) {
+        case "boolean":
+            return "";
+        case "array":
+            return ` <${typeName(type.item ?? { kind: "any" })}>... (repeat the flag, or give a JSON array)`;
+        case "record":
+            return " <key=value>... (repeat the flag, or give a JSON object)";
+        case "object":
+        case "any":
+            return " <json>";
+        case "enum":
+            return ` <${(field.enumValues ?? []).join("|")}>`;
+        default:
+            return ` <${typeName(type)}>`;
+    }
+}
+/**
+ * This function gives the help text of one command. `schema` is the input schema, or the fields
+ * of the input. `result` gives the fields of the result. The help lists them after the options.
+ */
+export function generateHelp(path, meta, schema, result, options) {
+    const positionalArgs = meta.args ?? [];
+    const shorts = meta.shorts ?? {};
+    const lines = [];
+    const schemaFields = Array.isArray(schema)
+        ? schema
+        : schema
+            ? extractSchemaFields(schema)
+            : [];
+    const schemaFieldMap = new Map(schemaFields.map((f) => [f.name, f]));
+    // Command signature: the last positional array takes the rest of the arguments
+    const cmdName = `${options.name} ${path.join(" ")}`;
+    const posStr = positionalArgs
+        .map((a, i) => {
+        const many = i === positionalArgs.length - 1 && schemaFieldMap.get(a)?.fieldType.kind === "array";
+        return many ? `<${a}...>` : `<${a}>`;
+    })
+        .join(" ");
+    lines.push(`Usage: ${cmdName}${posStr ? " " + posStr : ""} [options]`);
+    lines.push("");
+    if (meta.description) {
+        lines.push(meta.description);
+        lines.push("");
+    }
+    if (positionalArgs.length > 0) {
+        lines.push("Arguments:");
+        for (const arg of positionalArgs) {
+            const fieldInfo = schemaFieldMap.get(arg);
+            const typeStr = fieldInfo ? ` (${fieldInfo.type})` : "";
+            const reqStr = fieldInfo?.required ? " [required]" : "";
+            const descStr = fieldInfo?.description ? `  ${fieldInfo.description}` : "";
+            lines.push(`  ${arg}${typeStr}${reqStr}`);
+            if (descStr) {
+                lines.push(`    ${descStr}`);
+            }
+        }
+        lines.push("");
+    }
+    // Options: each schema field that is not positional, with its short flag if it has one
+    const optionLines = [];
+    const positionalSet = new Set(positionalArgs);
+    const listed = new Set();
+    const optionFields = [
+        ...Object.keys(shorts).map((name) => schemaFieldMap.get(name) ?? fieldWithoutSchema(name)),
+        ...schemaFields.filter((field) => !(field.name in shorts) && !positionalSet.has(field.name)),
+    ];
+    for (const field of optionFields) {
+        if (listed.has(field.name)) {
+            continue;
+        }
+        listed.add(field.name);
+        const short = shorts[field.name];
+        const kebab = toKebab(field.name);
+        const flag = short ? `  -${short}, --${kebab}` : `      --${kebab}`;
+        const negation = field.fieldType.kind === "boolean" ? ` (or --no-${kebab})` : "";
+        const reqStr = field.required ? " [required]" : "";
+        const defaultStr = field.defaultValue !== undefined ? ` (default: ${JSON.stringify(field.defaultValue)})` : "";
+        optionLines.push(`${flag}${valueHint(field)}${negation}${reqStr}${defaultStr}`);
+        if (field.description) {
+            optionLines.push(`        ${field.description}`);
+        }
+    }
+    if (optionLines.length > 0) {
+        lines.push("Options:");
+        lines.push(...optionLines);
+    }
+    if (result.length > 0) {
+        lines.push("");
+        lines.push("Result:");
+        for (const field of result) {
+            const optional = field.required ? "" : ", optional";
+            lines.push(`  ${field.name} (${field.type}${optional})`);
+            if (field.description) {
+                lines.push(`        ${field.description}`);
+            }
+        }
+    }
+    const globals = (options.globals ?? []).filter((flag) => !flag.hidden);
+    if (globals.length > 0) {
+        lines.push("");
+        lines.push("Global Options (before the command, or after it when the command has no flag of that name):");
+        for (const flag of globals) {
+            const name = flag.short ? `-${flag.short}, --${flag.long}` : `    --${flag.long}`;
+            lines.push(`  ${name.padEnd(18)} ${flag.description}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * This function gives the help of a group of commands: one message for each line. It gives
+ * undefined when no command is in the group. A message can contain a line break.
+ */
+export function groupHelp(name, commands, path) {
+    const children = findChildren(commands, path);
+    if (children.length === 0) {
+        return undefined;
+    }
+    const groupName = path.join(" ");
+    const lines = [`${groupName} commands:\n`];
+    // The commands directly in the group
+    for (const child of children.filter((p) => p.path.length === path.length + 1)) {
+        const meta = (child.metadata ?? {});
+        const cmdName = child.path[child.path.length - 1] ?? "";
+        lines.push(`  ${name} ${groupName} ${cmdName}  ${meta.description ?? ""}`);
+    }
+    // The groups in the group
+    const childGroups = new Set();
+    for (const child of children) {
+        if (child.path.length > path.length + 1) {
+            const groupSeg = child.path[path.length];
+            if (groupSeg)
+                childGroups.add(groupSeg);
+        }
+    }
+    for (const group of childGroups) {
+        lines.push(`  ${name} ${groupName} ${group}  ${group} commands`);
+    }
+    lines.push(`\nRun '${name} ${groupName} <command> --help' for more info.`);
+    return lines;
+}
+/**
+ * This function gives the help of the whole program: the commands by their first word. It gives
+ * one message for each line. A message can contain a line break.
+ */
+export function rootHelp(commands, options) {
+    const { name } = options;
+    const lines = [`${options.title ?? name}\n`, "Commands:\n"];
+    const groups = new Map();
+    for (const proc of commands) {
+        const group = proc.path[0] ?? "other";
+        const members = groups.get(group) ?? [];
+        members.push(proc);
+        groups.set(group, members);
+    }
+    for (const [group, procs] of groups) {
+        lines.push(`  ${group}`);
+        for (const proc of procs) {
+            const meta = (proc.metadata ?? {});
+            lines.push(`    ${name} ${proc.path.join(" ")}  ${meta.description ?? ""}`);
+        }
+        lines.push("");
+    }
+    lines.push(`Run '${name} <command> --help' for more information.`);
+    lines.push(...(options.footer ?? []));
+    return lines;
+}
+/** This function gives the message of a validation error: one line for each issue of a Zod error. */
+export function validationMessage(error) {
+    const issues = error.issues;
+    if (Array.isArray(issues) && issues.length > 0) {
+        return issues
+            .map((issue) => `${(issue.path ?? []).join(".") || "input"}: ${issue.message ?? "invalid"}`)
+            .join("\n  ");
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@procedures/cli-kit`: a command line for any procedure registry.
+ *
+ * The package has no procedures, and an import registers nothing. `createProcedureCli()` makes
+ * a whole program. The other exports are its parts: the parse, the help, the questions and the
+ * output. The `mark` CLI uses the parts.
+ */
+export { createProcedureCli, STANDARD_GLOBAL_FLAGS, type CliCallOptions, type CliClient, type CommandSource, type FormatContext, type FormatHook, type ProcedureCli, type ProcedureCliOptions, type ProcedureCliRunOptions, } from "./cli.js";
+export { findChildren, findGlobalFlag, findProcedure, parseCommandLine, parseLeadingGlobals, procedureFlags, type GlobalFlag, type Globals, type ParsedCommandLine, type ParseOptions, } from "./args.js";
+export { convertValue, extractSchemaFields, fieldTypeOf, fieldsOf, mergeValue, resultFieldsOf, resultFieldsOfSchema, toCamel, toKebab, type CLIMeta, type CommandLike, type Converted, type FieldKind, type FieldType, type SchemaFieldInfo, } from "./fields.js";
+export { generateHelp, groupHelp, rootHelp, validationMessage, type HelpOptions, type RootHelpOptions, } from "./help.js";
+export { askMissing, canAsk, missingFields, processTerminal, questionOf, terminalAsker, type Answer, type Asked, type Asker, type Terminal, } from "./ask.js";
+export { formatOutput, plainPrint, type OutputFormat, type Print, type Spinner } from "./format.js";
+export { failureOf } from "./failure.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,OAAO,EACP,OAAO,EACP,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,UAAU,EACV,MAAM,EACN,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,KAAK,EACV,KAAK,QAAQ,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@procedures/cli-kit`: a command line for any procedure registry.
+ *
+ * The package has no procedures, and an import registers nothing. `createProcedureCli()` makes
+ * a whole program. The other exports are its parts: the parse, the help, the questions and the
+ * output. The `mark` CLI uses the parts.
+ */
+export { createProcedureCli, STANDARD_GLOBAL_FLAGS, } from "./cli.js";
+export { findChildren, findGlobalFlag, findProcedure, parseCommandLine, parseLeadingGlobals, procedureFlags, } from "./args.js";
+export { convertValue, extractSchemaFields, fieldTypeOf, fieldsOf, mergeValue, resultFieldsOf, resultFieldsOfSchema, toCamel, toKebab, } from "./fields.js";
+export { generateHelp, groupHelp, rootHelp, validationMessage, } from "./help.js";
+export { askMissing, canAsk, missingFields, processTerminal, questionOf, terminalAsker, } from "./ask.js";
+export { formatOutput, plainPrint } from "./format.js";
+export { failureOf } from "./failure.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GAStB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,GAKf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,OAAO,EACP,OAAO,GAOR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,iBAAiB,GAGlB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,UAAU,EACV,MAAM,EACN,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,GAKd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,UAAU,EAA+C,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,68 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/cli-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.35.1",
+  "description": "A command line for any procedure registry: flags from the input schemas, help, --json, questions for missing arguments, @file input, short flags and a format hook for each procedure.",
+  "keywords": [
+    "cli",
+    "command-line",
+    "procedures",
+    "flags",
+    "help",
+    "zod"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/cli-kit"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "@procedures/client": "0.35.1"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3",
+    "zod": "^4.6.5"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }