termkit 2.1.0 → 2.2.0

package/README.md

@@ -1,6 +1,6 @@
 # TermKit
 
-A fluent CLI framework for Node.js with nested subcommands, middleware, and TypeScript support.
+TermKit is a complete terminal toolkit for Node.js. Build CLI programs with a fluent command API — nested subcommands, middleware, typed options — then prompt users interactively, render progress bars, tables, and charts, all from a single package with full TypeScript support.
 
 ## Installation
 
@@ -10,12 +10,14 @@ npm install termkit
 
 ## Usage
 
-### Basic program
+### Program
+
+`Program` is the entry point for CLI argument parsing. Define commands with `Program.command`, declare options, attach middleware and actions, then call `Program.parse` to run.
 
 ```ts
-import { command, option, parse } from 'termkit'
+import { Program } from 'termkit'
 
-const program = command('my-app')
+Program.command('my-app')
   .version('1.0.0')
   .description('My CLI application')
   .option('v', 'verbose', null, 'Enable verbose output')
@@ -24,11 +26,7 @@ const program = command('my-app')
     console.log(options.output)
   })
 
-try {
-  program.parse(process.argv)
-} catch (err) {
-  console.error(err)
-}
+Program.parse(process.argv)
 ```
 
 ### Options
@@ -36,7 +34,7 @@ try {
 Options support four variable shapes:
 
 ```ts
-command('app')
+Program.command('app')
   .option('b', 'boolean', null,        'Flag with no value')
   .option('o', 'optional', '[val]',    'Optional value')
   .option('r', 'required', '<val>',    'Required value')
@@ -56,34 +54,40 @@ Accessible in actions and middleware via the long name:
 
 ### Value coercion
 
-Append `:number` or `:boolean` to a variable to coerce the parsed string:
+Append `:number`, `:integer`, or `:boolean` to a variable to coerce the parsed string. Append `(min,max)` to enforce a numeric or length range. Use `|`-separated values for an enum:
 
 ```ts
-command('app')
-  .option('p', 'port',    '<port:number>',     'Port number')
-  .option('v', 'verbose', '[verbose:boolean]', 'Verbose mode')
-  .option('n', 'nums',    '[nums:number...]',  'List of numbers')
+Program.command('app')
+  .option('p', 'port',  '<port:integer(1,65535)>', 'Port number')
+  .option('e', 'env',   '<env:dev|staging|prod>',  'Environment')
+  .option('n', 'nums',  '[nums:number...]',          'List of numbers')
+  .option('t', 'token', '<token:string(32,64)>',    'API token')
   .action((options) => {
-    options.port    // number
-    options.verbose // boolean
-    options.nums    // number[]
+    options.port  // number
+    options.env   // 'dev' | 'staging' | 'prod'
+    options.nums  // number[]
+    options.token // string
   })
 ```
 
+Append `=default` inside the brackets to set a default value:
+
+```ts
+.option('p', 'port', '[port:integer=3000]', 'Port number')
+```
+
 ### Subcommands
 
 Commands nest to any depth. Each level can have its own options and middleware.
 
 ```ts
-import { command, option } from 'termkit'
-
-command('app')
+Program.command('app')
   .commands([
-    command('serve')
+    Program.command('serve')
       .option('p', 'port', '<port:number>', 'Port to listen on')
       .action((options) => startServer(options.port)),
 
-    command('build')
+    Program.command('build')
       .option('w', 'watch', null, 'Watch for changes')
       .action((options) => runBuild(options)),
   ])
@@ -92,9 +96,9 @@ command('app')
 Commands can also carry their own positional variables:
 
 ```ts
-command('get', '<id>')        // required
-command('list', '[filter]')   // optional
-command('tag', '[tags...]')   // array
+Program.command('get', '<id>')        // required
+Program.command('list', '[filter]')   // optional
+Program.command('tag', '[tags...]')   // array
 ```
 
 ### Middleware
@@ -102,7 +106,7 @@ command('tag', '[tags...]')   // array
 Middleware runs before the action. It can mutate the options object and supports async.
 
 ```ts
-command('app')
+Program.command('app')
   .middleware(async (options) => {
     options.user = await getUser(options.token)
   })
@@ -118,9 +122,7 @@ Use `.middlewares([...])` to register several at once. When navigating into a su
 Apply middleware or options to every command created after the call:
 
 ```ts
-import { setDefaults } from 'termkit'
-
-setDefaults({
+Program.setDefaults({
   middlewares: [
     async (options) => { options.timestamp = Date.now() }
   ]
@@ -136,6 +138,19 @@ my-app help
 my-app serve help
 ```
 
+### configure
+
+Sets global display options for the entire toolkit — accent color used in help output, tables, charts, and prompts; plus Unicode glyph support.
+
+```ts
+import { configure } from 'termkit'
+
+configure({
+  color: '#a855f7', // any named color, hex string, or xterm number
+  glyphs: true,
+})
+```
+
 ### Input
 
 Interactive text prompt. Supports string, number, integer, boolean, and enum types with validation.
@@ -326,7 +341,7 @@ new Table(rows, { columns: ['name', 'role'] }).print()
 
 ### Chart
 
-The `Chart` namespace provides horizontal bar, vertical column, heatmap, and scatter visualizations. Every chart class has a `.print()` method that writes to stdout and a `.toString()` method that returns the rendered string.
+The `Chart` namespace provides horizontal bar, vertical column, heatmap, scatter, line, and sparkline visualizations. Every chart class has a `.print()` method that writes to stdout and a `.toString()` method that returns the rendered string.
 
 All chart constructors accept optional `paddingX` and `paddingY` options to add whitespace around the output.
 
@@ -570,6 +585,60 @@ Each `add()` call accepts the same options as `Bar` and returns a `Bar` instance
 
 Options: `interval`.
 
+### Spinner
+
+Animated spinner for indeterminate work. Shares the same completion API as `Bar` — `.succeed()`, `.fail()`, `.warn()`, `.info()`.
+
+```ts
+import { Spinner } from 'termkit'
+
+const spinner = new Spinner({ text: 'Loading…' })
+spinner.start()
+
+await doWork()
+
+spinner.succeed('Done')
+```
+
+Update the label while running:
+
+```ts
+spinner.message('Still working…')
+```
+
+Built-in frame sets are available on `Spinner.FRAMES`:
+
+```ts
+new Spinner({ frames: Spinner.FRAMES.dots, text: 'Thinking…' }).start()
+```
+
+Frame sets: `braille`, `dots`, `line`, `arrow`, `bounce`.
+
+Options: `frames`, `text`, `prefix`, `suffix`, `reverse`, `interval`, `colors`, `bgColors`, `colorCycle`, `shimmer`, `successColor`, `failColor`, `warnColor`, `infoColor`, `glyphs`.
+
+### Scrollbox
+
+Interactive terminal pager. Renders a fixed-height viewport over an array of strings with keyboard navigation. Requires an interactive TTY.
+
+```ts
+import { scrollbox } from 'termkit'
+
+await scrollbox(lines, { height: 20, title: 'Output', lineNumbers: true })
+```
+
+Or use the class directly for more control:
+
+```ts
+import { Scrollbox } from 'termkit'
+
+const box = new Scrollbox({ height: 15, scrollbar: true, wrapLines: true })
+await box.show(lines)
+```
+
+Keyboard controls: ↑↓ / `j` `k` scroll one line · `d` / `u` half-page · `f` / `b` full page · `g` top · `G` bottom · Enter / Escape / `q` close.
+
+Options: `height`, `title`, `lineNumbers`, `scrollbar`, `borderColor`, `wrapLines`.
+
 ### truncate
 
 ANSI-aware string truncation. Measures visible length ignoring escape codes, and appends a configurable suffix.
@@ -595,16 +664,22 @@ console.log(wrap(longParagraph, 60))
 
 ## API
 
+### Program
+
+| Method | Signature | Description |
+|---|---|---|
+| `Program.command` | `(name, variables?, info?) => Command` | Create a command |
+| `Program.option` | `(short, long, variables, info) => Option` | Create a standalone option |
+| `Program.middleware` | `(fn) => fn` | Identity helper for typing middleware inline |
+| `Program.parse` | `(argv) => Promise<void>` | Parse argv using the root command |
+| `Program.setDefaults` | `(defaults) => void` | Apply middleware/options to all new commands |
+
 ### Functions
 
 | Function | Signature | Description |
 |---|---|---|
-| `command` | `(name, variables?, info?) => Command` | Create a command |
-| `option` | `(short, long, variables, info) => Option` | Create an option |
-| `middleware` | `(fn) => fn` | Identity helper for typing middleware inline |
-| `parse` | `(argv) => Promise<unknown>` | Parse using the root command |
-| `setDefaults` | `(defaults) => void` | Set defaults applied to all new commands |
-| `configure` | `(opts) => void` | Set global display options (color, glyphs) |
+| `configure` | `(opts) => void` | Set global accent color and display options |
+| `scrollbox` | `(lines, options?) => Promise<void>` | Interactive terminal pager |
 | `markup` | `(data, options?) => string` | Pretty-print a value with syntax coloring |
 | `input` | `(prompt, options?) => Promise<string \| number \| boolean \| null>` | Interactive text prompt |
 | `confirm` | `(prompt, options?) => Promise<boolean \| null>` | Boolean yes/no prompt |
@@ -620,7 +695,7 @@ console.log(wrap(longParagraph, 60))
 
 ### Classes
 
-`Command`, `Option`, `Variable`, `TermKit`, `Bar`, `MultiBar`, `Spinner`, `Input`, `Select`, `MultiSelect`, `Log`, `Table`, `Column`, `Chart.Bar`, `Chart.VerticalBar`, `Chart.Heatmap`, `Chart.Scatter`, `Chart.Line`
+`Command`, `Option`, `Variable`, `TermKit`, `Bar`, `MultiBar`, `Spinner`, `Scrollbox`, `Input`, `Select`, `MultiSelect`, `Log`, `Table`, `Column`, `Chart.Bar`, `Chart.VerticalBar`, `Chart.Heatmap`, `Chart.Scatter`, `Chart.Line`
 
 ### Types
 

package/dist/index.d.ts

@@ -42,9 +42,11 @@ export interface CommandDefaults {
     middlewares?: MiddlewareFn[];
     options?: Option[];
 }
-export declare const command: (name: string, variables?: string | null, info?: string) => Command;
-export declare const middleware: (fn: MiddlewareFn) => MiddlewareFn;
-export declare const option: (short: string | null, long: string | null, variables: string | null, info: string) => Option;
-export declare const parse: (arr: string[]) => Promise<void>;
-export declare const setDefaults: (data: CommandDefaults) => void;
+export declare const Program: {
+    command: (name: string, variables?: string | null, info?: string) => Command;
+    option: (short: string | null, long: string | null, variables: string | null, info: string) => Option;
+    middleware: (fn: MiddlewareFn) => MiddlewareFn;
+    parse: (arr: string[]) => Promise<void>;
+    setDefaults: (data: CommandDefaults) => void;
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACvC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACzD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,UAAU,CAAA;AAE3C,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,YAAY,EAAE,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAKD,eAAO,MAAM,OAAO;oBACF,MAAM,cAAc,MAAM,GAAG,IAAI,SAAS,MAAM,KAAG,OAAO;oBAM1D,MAAM,GAAG,IAAI,QAAQ,MAAM,GAAG,IAAI,aAAa,MAAM,GAAG,IAAI,QAAQ,MAAM,KAAG,MAAM;qBAElF,YAAY,KAAG,YAAY;iBAEzB,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAAC;wBAevB,eAAe,KAAG,IAAI;CAG3C,CAAA"}

package/dist/index.js

@@ -40,37 +40,30 @@ __export(index_exports, {
   MultiBar: () => MultiBar,
   MultiSelect: () => MultiSelect,
   Option: () => Option,
+  Program: () => Program,
   Scrollbox: () => Scrollbox,
   Select: () => Select,
   Spinner: () => Spinner,
   Table: () => Table,
   TermKit: () => TermKit,
   Variable: () => Variable,
-  command: () => command,
   configure: () => configure,
   confirm: () => confirm,
   input: () => input,
   log: () => log,
   markup: () => markup,
-  middleware: () => middleware,
   multiSelect: () => multiSelect,
-  option: () => option,
   padLeft: () => padLeft,
   padRight: () => padRight,
   padSides: () => padSides,
-  parse: () => parse,
   scrollbox: () => scrollbox,
   select: () => select,
-  setDefaults: () => setDefaults,
   stringLength: () => stringLength,
   truncate: () => truncate,
   wrap: () => wrap
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/models/Command.ts
-var import_cosmetic = __toESM(require("cosmetic"));
-
 // src/config.ts
 var isLegacyTerminal = process.env.TERM === "dumb" || process.platform === "win32" && !process.env.WT_SESSION && process.env.TERM_PROGRAM !== "vscode" && process.env.TERM_PROGRAM !== "Hyper";
 var config = {
@@ -86,6 +79,9 @@ function configure(opts) {
   if (opts.interactive !== void 0) config.interactive = opts.interactive;
 }
 
+// src/models/Command.ts
+var import_cosmetic = __toESM(require("cosmetic"));
+
 // src/models/Variable.ts
 var Variable = class {
   constructor(data) {
@@ -182,10 +178,10 @@ var Option = class {
 
 // src/utils/findCommand.ts
 function findCommand(array, commands) {
-  for (const command2 of commands) {
-    if (array[0] === command2.name) {
+  for (const command of commands) {
+    if (array[0] === command.name) {
       array.shift();
-      return command2;
+      return command;
     }
   }
   return null;
@@ -780,11 +776,11 @@ async function findVariable(array, variable, commands) {
 }
 
 // src/utils/findCommandVariables.ts
-async function findCommandVariables(array, command2) {
-  if (!command2.variables) return null;
+async function findCommandVariables(array, command) {
+  if (!command.variables) return null;
   const result = {};
-  for (const variable of command2.variables) {
-    const value = await findVariable(array, variable, command2.commandStrings);
+  for (const variable of command.variables) {
+    const value = await findVariable(array, variable, command.commandStrings);
     if (value !== true) result[variable.name] = value;
   }
   return Object.keys(result).length > 0 ? result : null;
@@ -818,40 +814,40 @@ async function findVariables(base2, array, variables, commands) {
 }
 
 // src/utils/findOptions.ts
-async function findOptions(array, command2) {
+async function findOptions(array, command) {
   const result = {};
   while (array.length > 0 && array[0].startsWith("-")) {
     if (array[0].startsWith("--")) {
       const raw = array.shift().slice(2);
       if (raw.startsWith("no-")) {
         const longName = raw.slice(3);
-        const negated = findOption(longName, command2.optionsArray);
+        const negated = findOption(longName, command.optionsArray);
         if (negated?.long) {
           result[negated.long] = false;
           continue;
         }
       }
-      const option2 = findOption(raw, command2.optionsArray);
-      if (!option2) throw new Error(`Unknown Option: --${raw}`);
+      const option = findOption(raw, command.optionsArray);
+      if (!option) throw new Error(`Unknown Option: --${raw}`);
       try {
-        Object.assign(result, await findVariables(option2.long, array, option2.variables, command2.commandStrings));
+        Object.assign(result, await findVariables(option.long, array, option.variables, command.commandStrings));
       } catch (err) {
         ;
-        err.message += ` for --${option2.long}`;
+        err.message += ` for --${option.long}`;
         throw err;
       }
     } else {
       let string = array.shift();
       const short = string.slice(1, 2);
-      const option2 = findOption(short, command2.optionsArray);
-      if (!option2) throw new Error(`Unknown Option: -${short}`);
+      const option = findOption(short, command.optionsArray);
+      if (!option) throw new Error(`Unknown Option: -${short}`);
       string = "-" + string.slice(2);
       if (string !== "-") array.unshift(string);
       try {
-        Object.assign(result, await findVariables(option2.long, array, option2.variables, command2.commandStrings));
+        Object.assign(result, await findVariables(option.long, array, option.variables, command.commandStrings));
       } catch (err) {
         ;
-        err.message += ` for --${option2.long}`;
+        err.message += ` for --${option.long}`;
         throw err;
       }
     }
@@ -996,7 +992,7 @@ var Command = class {
   async parse(input2) {
     const array = [...input2];
     array.splice(0, 2);
-    let command2 = this;
+    let command = this;
     const options = { _source: Array.from(array) };
     const ddIdx = array.indexOf("--");
     if (ddIdx !== -1) {
@@ -1005,19 +1001,19 @@ var Command = class {
     }
     while (array.length) {
       if (!array.includes("help")) {
-        Object.assign(options, await findOptions(array, command2));
-        const cmdVars = await findCommandVariables(array, command2);
+        Object.assign(options, await findOptions(array, command));
+        const cmdVars = await findCommandVariables(array, command);
         if (cmdVars) Object.assign(options, cmdVars);
-        Object.assign(options, await findOptions(array, command2));
+        Object.assign(options, await findOptions(array, command));
       }
       if (array.length) {
         if (!array.includes("help")) {
-          for (const mw of command2.middlewaresArray) await mw(options);
+          for (const mw of command.middlewaresArray) await mw(options);
         }
-        const next = findCommand(array, command2.commandsArray);
-        if (!next && array[0] === "help") return command2.help(options._source);
+        const next = findCommand(array, command.commandsArray);
+        if (!next && array[0] === "help") return command.help(options._source);
         if (!next) throw new SyntaxError(`Unknown command: ${array[0]}`);
-        const name = command2.name ?? "_base";
+        const name = command.name ?? "_base";
         if (!options._parents) options._parents = {};
         options._parents[name] = {};
         for (const key of Object.keys(options)) {
@@ -1026,10 +1022,10 @@ var Command = class {
             delete options[key];
           }
         }
-        command2 = next;
+        command = next;
       }
     }
-    for (const opt of command2.optionsArray) {
+    for (const opt of command.optionsArray) {
       if (!opt.long || !opt.variables) continue;
       for (const v of opt.variables) {
         if (v.default !== null && !(opt.long in options)) {
@@ -1037,10 +1033,10 @@ var Command = class {
         }
       }
     }
-    for (const mw of command2.middlewaresArray) await mw(options);
-    if (command2.actionFunction) return command2.actionFunction(options);
-    if (options._source.length === 2) return command2.help(options._source);
-    throw new Error(`No action for command: ${command2.name ?? "_base"}`);
+    for (const mw of command.middlewaresArray) await mw(options);
+    if (command.actionFunction) return command.actionFunction(options);
+    if (options._source.length === 2) return command.help(options._source);
+    throw new Error(`No action for command: ${command.name ?? "_base"}`);
   }
 };
 
@@ -2792,32 +2788,34 @@ var TermKit = _TermKit;
 var import_cosmetic4 = __toESM(require("cosmetic"));
 var base = null;
 var commandDefaults = {};
-var command = (name, variables, info) => {
-  const cmd = new Command(Object.assign({ name, variables, info }, commandDefaults));
-  if (!base) base = cmd;
-  return cmd;
-};
-var middleware = (fn) => fn;
-var option = (short, long, variables, info) => new Option({ short, long, variables, info });
-var parse = async (arr) => {
-  if (!base) throw new Error("No command defined");
-  try {
-    await base.parse(arr);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    if (process.stderr.isTTY && config.glyphs) {
-      process.stderr.write(`\x1B[31m\u2716\x1B[0m ${msg}
+var Program = {
+  command: (name, variables, info) => {
+    const cmd = new Command(Object.assign({ name, variables, info }, commandDefaults));
+    if (!base) base = cmd;
+    return cmd;
+  },
+  option: (short, long, variables, info) => new Option({ short, long, variables, info }),
+  middleware: (fn) => fn,
+  parse: async (arr) => {
+    if (!base) throw new Error("No command defined");
+    try {
+      await base.parse(arr);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (process.stderr.isTTY && config.glyphs) {
+        process.stderr.write(`\x1B[31m\u2716\x1B[0m ${msg}
 `);
-    } else {
-      process.stderr.write(`Error: ${msg}
+      } else {
+        process.stderr.write(`Error: ${msg}
 `);
+      }
+      process.exit(1);
     }
-    process.exit(1);
+  },
+  setDefaults: (data) => {
+    commandDefaults = data;
   }
 };
-var setDefaults = (data) => {
-  commandDefaults = data;
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Bar,
@@ -2830,28 +2828,24 @@ var setDefaults = (data) => {
   MultiBar,
   MultiSelect,
   Option,
+  Program,
   Scrollbox,
   Select,
   Spinner,
   Table,
   TermKit,
   Variable,
-  command,
   configure,
   confirm,
   input,
   log,
   markup,
-  middleware,
   multiSelect,
-  option,
   padLeft,
   padRight,
   padSides,
-  parse,
   scrollbox,
   select,
-  setDefaults,
   stringLength,
   truncate,
   wrap

package/dist/index.mjs

@@ -4,9 +4,6 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/models/Command.ts
-import cosmetic from "cosmetic";
-
 // src/config.ts
 var isLegacyTerminal = process.env.TERM === "dumb" || process.platform === "win32" && !process.env.WT_SESSION && process.env.TERM_PROGRAM !== "vscode" && process.env.TERM_PROGRAM !== "Hyper";
 var config = {
@@ -22,6 +19,9 @@ function configure(opts) {
   if (opts.interactive !== void 0) config.interactive = opts.interactive;
 }
 
+// src/models/Command.ts
+import cosmetic from "cosmetic";
+
 // src/models/Variable.ts
 var Variable = class {
   constructor(data) {
@@ -118,10 +118,10 @@ var Option = class {
 
 // src/utils/findCommand.ts
 function findCommand(array, commands) {
-  for (const command2 of commands) {
-    if (array[0] === command2.name) {
+  for (const command of commands) {
+    if (array[0] === command.name) {
       array.shift();
-      return command2;
+      return command;
     }
   }
   return null;
@@ -716,11 +716,11 @@ async function findVariable(array, variable, commands) {
 }
 
 // src/utils/findCommandVariables.ts
-async function findCommandVariables(array, command2) {
-  if (!command2.variables) return null;
+async function findCommandVariables(array, command) {
+  if (!command.variables) return null;
   const result = {};
-  for (const variable of command2.variables) {
-    const value = await findVariable(array, variable, command2.commandStrings);
+  for (const variable of command.variables) {
+    const value = await findVariable(array, variable, command.commandStrings);
     if (value !== true) result[variable.name] = value;
   }
   return Object.keys(result).length > 0 ? result : null;
@@ -754,40 +754,40 @@ async function findVariables(base2, array, variables, commands) {
 }
 
 // src/utils/findOptions.ts
-async function findOptions(array, command2) {
+async function findOptions(array, command) {
   const result = {};
   while (array.length > 0 && array[0].startsWith("-")) {
     if (array[0].startsWith("--")) {
       const raw = array.shift().slice(2);
       if (raw.startsWith("no-")) {
         const longName = raw.slice(3);
-        const negated = findOption(longName, command2.optionsArray);
+        const negated = findOption(longName, command.optionsArray);
         if (negated?.long) {
           result[negated.long] = false;
           continue;
         }
       }
-      const option2 = findOption(raw, command2.optionsArray);
-      if (!option2) throw new Error(`Unknown Option: --${raw}`);
+      const option = findOption(raw, command.optionsArray);
+      if (!option) throw new Error(`Unknown Option: --${raw}`);
       try {
-        Object.assign(result, await findVariables(option2.long, array, option2.variables, command2.commandStrings));
+        Object.assign(result, await findVariables(option.long, array, option.variables, command.commandStrings));
       } catch (err) {
         ;
-        err.message += ` for --${option2.long}`;
+        err.message += ` for --${option.long}`;
         throw err;
       }
     } else {
       let string = array.shift();
       const short = string.slice(1, 2);
-      const option2 = findOption(short, command2.optionsArray);
-      if (!option2) throw new Error(`Unknown Option: -${short}`);
+      const option = findOption(short, command.optionsArray);
+      if (!option) throw new Error(`Unknown Option: -${short}`);
       string = "-" + string.slice(2);
       if (string !== "-") array.unshift(string);
       try {
-        Object.assign(result, await findVariables(option2.long, array, option2.variables, command2.commandStrings));
+        Object.assign(result, await findVariables(option.long, array, option.variables, command.commandStrings));
       } catch (err) {
         ;
-        err.message += ` for --${option2.long}`;
+        err.message += ` for --${option.long}`;
         throw err;
       }
     }
@@ -932,7 +932,7 @@ var Command = class {
   async parse(input2) {
     const array = [...input2];
     array.splice(0, 2);
-    let command2 = this;
+    let command = this;
     const options = { _source: Array.from(array) };
     const ddIdx = array.indexOf("--");
     if (ddIdx !== -1) {
@@ -941,19 +941,19 @@ var Command = class {
     }
     while (array.length) {
       if (!array.includes("help")) {
-        Object.assign(options, await findOptions(array, command2));
-        const cmdVars = await findCommandVariables(array, command2);
+        Object.assign(options, await findOptions(array, command));
+        const cmdVars = await findCommandVariables(array, command);
         if (cmdVars) Object.assign(options, cmdVars);
-        Object.assign(options, await findOptions(array, command2));
+        Object.assign(options, await findOptions(array, command));
       }
       if (array.length) {
         if (!array.includes("help")) {
-          for (const mw of command2.middlewaresArray) await mw(options);
+          for (const mw of command.middlewaresArray) await mw(options);
         }
-        const next = findCommand(array, command2.commandsArray);
-        if (!next && array[0] === "help") return command2.help(options._source);
+        const next = findCommand(array, command.commandsArray);
+        if (!next && array[0] === "help") return command.help(options._source);
         if (!next) throw new SyntaxError(`Unknown command: ${array[0]}`);
-        const name = command2.name ?? "_base";
+        const name = command.name ?? "_base";
         if (!options._parents) options._parents = {};
         options._parents[name] = {};
         for (const key of Object.keys(options)) {
@@ -962,10 +962,10 @@ var Command = class {
             delete options[key];
           }
         }
-        command2 = next;
+        command = next;
       }
     }
-    for (const opt of command2.optionsArray) {
+    for (const opt of command.optionsArray) {
       if (!opt.long || !opt.variables) continue;
       for (const v of opt.variables) {
         if (v.default !== null && !(opt.long in options)) {
@@ -973,10 +973,10 @@ var Command = class {
         }
       }
     }
-    for (const mw of command2.middlewaresArray) await mw(options);
-    if (command2.actionFunction) return command2.actionFunction(options);
-    if (options._source.length === 2) return command2.help(options._source);
-    throw new Error(`No action for command: ${command2.name ?? "_base"}`);
+    for (const mw of command.middlewaresArray) await mw(options);
+    if (command.actionFunction) return command.actionFunction(options);
+    if (options._source.length === 2) return command.help(options._source);
+    throw new Error(`No action for command: ${command.name ?? "_base"}`);
   }
 };
 
@@ -2728,32 +2728,34 @@ var TermKit = _TermKit;
 import { default as default2 } from "cosmetic";
 var base = null;
 var commandDefaults = {};
-var command = (name, variables, info) => {
-  const cmd = new Command(Object.assign({ name, variables, info }, commandDefaults));
-  if (!base) base = cmd;
-  return cmd;
-};
-var middleware = (fn) => fn;
-var option = (short, long, variables, info) => new Option({ short, long, variables, info });
-var parse = async (arr) => {
-  if (!base) throw new Error("No command defined");
-  try {
-    await base.parse(arr);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    if (process.stderr.isTTY && config.glyphs) {
-      process.stderr.write(`\x1B[31m\u2716\x1B[0m ${msg}
+var Program = {
+  command: (name, variables, info) => {
+    const cmd = new Command(Object.assign({ name, variables, info }, commandDefaults));
+    if (!base) base = cmd;
+    return cmd;
+  },
+  option: (short, long, variables, info) => new Option({ short, long, variables, info }),
+  middleware: (fn) => fn,
+  parse: async (arr) => {
+    if (!base) throw new Error("No command defined");
+    try {
+      await base.parse(arr);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (process.stderr.isTTY && config.glyphs) {
+        process.stderr.write(`\x1B[31m\u2716\x1B[0m ${msg}
 `);
-    } else {
-      process.stderr.write(`Error: ${msg}
+      } else {
+        process.stderr.write(`Error: ${msg}
 `);
+      }
+      process.exit(1);
     }
-    process.exit(1);
+  },
+  setDefaults: (data) => {
+    commandDefaults = data;
   }
 };
-var setDefaults = (data) => {
-  commandDefaults = data;
-};
 export {
   Bar,
   Chart_exports as Chart,
@@ -2765,28 +2767,24 @@ export {
   MultiBar,
   MultiSelect,
   Option,
+  Program,
   Scrollbox,
   Select,
   Spinner,
   Table,
   TermKit,
   Variable,
-  command,
   configure,
   confirm,
   input,
   log,
   markup,
-  middleware,
   multiSelect,
-  option,
   padLeft,
   padRight,
   padSides,
-  parse,
   scrollbox,
   select,
-  setDefaults,
   stringLength,
   truncate,
   wrap

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termkit",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Node.js terminal toolkit with CLI commands, progress bars, charts, tables, styled markup, prompts, and text utilities",
   "keywords": [
     "animation",