shell-dsl 0.0.8 → 0.0.10

package/dist/types/src/utils/flag-parser.d.ts

@@ -0,0 +1,36 @@
+import type { Stderr } from "../types.ts";
+export interface FlagDefinition {
+    short?: string;
+    long?: string;
+    takesValue?: boolean;
+}
+export interface CommandSpec {
+    name: string;
+    flags: FlagDefinition[];
+    usage: string;
+    /** If true, stop parsing flags after the first positional argument (like echo) */
+    stopAfterFirstPositional?: boolean;
+}
+export interface FlagError {
+    type: "unrecognized_option" | "missing_value";
+    option: string;
+}
+export interface ParseResult<T> {
+    flags: T;
+    args: string[];
+    error?: FlagError;
+}
+export interface FlagParser<T> {
+    parse: (args: string[]) => ParseResult<T>;
+    formatError: (error: FlagError) => string;
+    writeError: (error: FlagError, stderr: Stderr) => Promise<void>;
+}
+/**
+ * Creates a flag parser for a command with consistent error handling.
+ *
+ * @param spec - Command specification with name, valid flags, and usage string
+ * @param defaults - Default values for the flags object
+ * @param handler - Function to handle setting a flag value
+ * @returns Parser object with parse, formatError, and writeError methods
+ */
+export declare function createFlagParser<T>(spec: CommandSpec, defaults: T, handler: (flags: T, flag: FlagDefinition, value?: string) => void): FlagParser<T>;

package/dist/types/src/utils/index.d.ts

@@ -1 +1,2 @@
 export { escape, escapeForInterpolation } from "./escape.ts";
+export { createFlagParser, type FlagDefinition, type CommandSpec, type FlagError, type ParseResult, type FlagParser, } from "./flag-parser.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "A sandboxed shell-style DSL for running scriptable command pipelines in-process without host OS access",
   "author": "ricsam <oss@ricsam.dev>",
   "license": "MIT",