@procedures/mark 0.33.0 → 0.35.0

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
  "version": 2,
- "fingerprint": "b71161fed26ba33fe82feeb6e13b44e3dc152979ab2161a3900bda50cecb058c",
- "generatedAt": "2026-10-25T21:45:09.340Z",
+ "fingerprint": "23d2e754ff5fd77e97e8598a0d8732478c8b5d450f4688372e3172bae0b2f3cf",
+ "generatedAt": "2026-10-26T14:52:46.400Z",
  "commands": [
   {
    "path": [
@@ -9540,7 +9540,8 @@
   {
    "path": [
     "fs",
-    "read.json"
+    "read",
+    "json"
    ],
    "metadata": {
     "description": "Read and parse JSON file",
@@ -9606,7 +9607,8 @@
   {
    "path": [
     "fs",
-    "write.json"
+    "write",
+    "json"
    ],
    "metadata": {
     "description": "Write a value as a JSON file, with a rename at the end",
@@ -10067,7 +10069,7 @@
       "kind": "number"
      },
      "required": true,
-     "description": "The exit code of mark"
+     "description": "The exit code of mark (0 is success)"
     },
     {
      "name": "stdout",
@@ -10085,7 +10087,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of mark"
+     "description": "The standard error of mark, or the error message when mark did not start"
     },
     {
      "name": "success",
@@ -10257,7 +10259,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -10435,7 +10437,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -10599,7 +10601,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -10719,7 +10721,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -10882,7 +10884,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -11111,7 +11113,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -11301,7 +11303,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -11310,7 +11312,7 @@
       "kind": "boolean"
      },
      "required": true,
-     "description": "True when the command succeeded"
+     "description": "True when the exit code is 0"
     },
     {
      "name": "duration",
@@ -11504,7 +11506,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -11513,7 +11515,7 @@
       "kind": "boolean"
      },
      "required": true,
-     "description": "True when the command succeeded"
+     "description": "True when the exit code is 0"
     },
     {
      "name": "duration",
@@ -11687,7 +11689,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -11696,7 +11698,7 @@
       "kind": "boolean"
      },
      "required": true,
-     "description": "True when the command succeeded"
+     "description": "True when the exit code is 0"
     },
     {
      "name": "duration",
@@ -11884,7 +11886,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -12006,7 +12008,7 @@
       "kind": "string"
      },
      "required": true,
-     "description": "The standard error of pnpm"
+     "description": "The standard error of pnpm, or the error message when pnpm did not start"
     },
     {
      "name": "success",
@@ -12015,7 +12017,7 @@
       "kind": "boolean"
      },
      "required": true,
-     "description": "True when the command succeeded"
+     "description": "True when the exit code is 0"
     },
     {
      "name": "duration",

package/dist/parse.d.ts

@@ -1,88 +1,11 @@
 /**
  * Schema-based CLI Argument Parser
  *
- * Reads the field types of a procedure's input schema, converts CLI text to those types, and
- * makes the help text. Validation is delegated to the procedure's schema.
+ * The field types, the conversion of CLI text and the help text are in `@procedures/cli-kit`
+ * (roadmap O61). This module gives them to mark with the name `mark` and the global flags of mark.
  */
-/**
- * CLI metadata that can be attached to procedures via .meta()
- */
-export interface CLIMeta {
-    /** Description for help text */
-    description?: string;
-    /** Field names that are positional args (in order). An array field that is last takes the rest. */
-    args?: string[];
-    /** Short flag mappings: { fieldName: "f" } */
-    shorts?: Record<string, string>;
-    /** Output format hint */
-    output?: "text" | "json" | "table" | "streaming";
-    /** Whether to prompt for missing required fields */
-    interactive?: boolean;
-}
-/**
- * The kinds of field the CLI can convert to. "any" is a field with no usable type: its value is
- * JSON when it parses as JSON, and text otherwise.
- */
-export type FieldKind = "string" | "number" | "bigint" | "boolean" | "enum" | "literal" | "date" | "array" | "record" | "object" | "union" | "any";
-/**
- * The type of a schema field, as the CLI sees it
- */
-export interface FieldType {
-    kind: FieldKind;
-    /** The item type of an array */
-    item?: FieldType;
-    /** The value type of a record */
-    value?: FieldType;
-    /** The member types of a union */
-    options?: FieldType[];
-    /** The values of an enum */
-    values?: readonly string[];
-    /** The value of a literal */
-    literal?: unknown;
-}
-/**
- * Extracted schema field info for help generation
- */
-export interface SchemaFieldInfo {
-    name: string;
-    /** The display name of the type, for the help text */
-    type: string;
-    /** The type the CLI converts values to */
-    fieldType: FieldType;
-    required: boolean;
-    description: string | undefined;
-    defaultValue: unknown;
-    enumValues: readonly string[] | undefined;
-}
-/**
- * The CLI type of a schema: a procedure schema (a Standard Schema such as zod 4) or its JSON
- * Schema. The type comes from the JSON Schema, so every schema library works. (Before, the
- * parser read the private fields of zod 3.)
- */
-export declare function fieldTypeOf(schema: unknown): FieldType;
-/**
- * Extract field information from a schema: a procedure schema or its JSON Schema. A schema that
- * is not an object (or that has no JSON Schema) gives no fields: the CLI then passes its flags
- * through.
- */
-export declare function extractSchemaFields(schema: unknown): SchemaFieldInfo[];
-/** The result of a conversion: the value, or a message for the user */
-export type Converted = {
-    ok: true;
-    value: unknown;
-} | {
-    ok: false;
-    error: string;
-};
-/**
- * Convert the CLI text of one value to a field type
- */
-export declare function convertValue(text: string, type: FieldType, label: string): Converted;
-/**
- * Add a converted value to a field that already has one. Arrays collect and records merge,
- * so a repeated flag adds to the field. Other fields take the last value.
- */
-export declare function mergeValue(previous: unknown, next: unknown, type: FieldType): unknown;
+import { type CLIMeta, type SchemaFieldInfo } from "@procedures/cli-kit";
+export { convertValue, extractSchemaFields, fieldTypeOf, fieldsOf, mergeValue, resultFieldsOf, resultFieldsOfSchema, toCamel, toKebab, type CLIMeta, type CommandLike, type Converted, type FieldKind, type FieldType, type SchemaFieldInfo, } from "@procedures/cli-kit";
 /**
  * Gluegun parameters shape
  */
@@ -95,45 +18,12 @@ export interface Parameters {
     raw?: string[];
     string?: string;
 }
-/**
- * Convert camelCase to kebab-case
- */
-export declare function toKebab(str: string): string;
-/**
- * Convert kebab-case to camelCase
- */
-export declare function toCamel(str: string): string;
 /**
  * Parse CLI parameters into procedure input based on metadata. With the schema, each value is
  * converted by the type of its field: a string field keeps its text. Without the schema, a value
  * is JSON when it parses as JSON, and text otherwise.
  */
 export declare function parseFromSchema(params: Parameters, meta: CLIMeta, schema?: unknown): Record<string, unknown>;
-/**
- * A command as mark sees it: a procedure of the registry (with its input schema), or a command
- * of the manifest (with the fields of its input). See manifest.ts.
- */
-export interface CommandLike {
-    path: readonly string[];
-    metadata?: unknown;
-    /** The input schema of a procedure of the registry */
-    input?: unknown;
-    /** The output schema of a procedure of the registry */
-    output?: unknown;
-    /** The fields of the input of a command of the manifest */
-    fields?: readonly SchemaFieldInfo[];
-    /** The fields of the result of a command of the manifest */
-    resultFields?: readonly SchemaFieldInfo[];
-}
-/** The fields of the input of a command: from the manifest, or read from the schema */
-export declare function fieldsOf(command: CommandLike): SchemaFieldInfo[];
-/**
- * The fields of the result of a procedure, from its output schema: only for a result that is an
- * object (a union, a stream item or a pass-through schema gives none).
- */
-export declare function resultFieldsOfSchema(output: unknown): SchemaFieldInfo[];
-/** The fields of the result of a command: from the manifest, or read from the output schema */
-export declare function resultFieldsOf(command: CommandLike): SchemaFieldInfo[];
 /**
  * Generate help text for a procedure based on its metadata and schema. `schema` is the input
  * schema, or the fields of the input (a command of the manifest). `result` gives the fields of

package/dist/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAML,KAAK,OAAO,EAEZ,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B,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,qBAAqB,CAAC;AAM7B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB;AASD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,OAAO,EAChB,MAAM,GAAE,SAAS,eAAe,EAAO,GACtC,MAAM,CAER"}