@hypercli/ui 0.1.1

package/dist/components/table.js.map

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

package/dist/components/textPrompt.d.ts

@@ -0,0 +1,43 @@
+/**
+ * TextPrompt Component
+ *
+ * Prompts the user for text input with validation, placeholder, and default value support.
+ * Uses Node's readline module for input handling.
+ * Falls back to simple stdin reading in non-TTY environments.
+ */
+/** Options for creating a text input prompt. */
+export type TextPromptOptions = {
+    /** The question or label displayed to the user. */
+    message: string;
+    /** Placeholder text shown when the input is empty. */
+    placeholder?: string;
+    /** Default value used when the user submits an empty input. */
+    defaultValue?: string;
+    /** Validation function. Return an error message string to reject, or `undefined` to accept. */
+    validate?: (value: string) => string | undefined;
+    /** Whether an empty input is rejected. Defaults to `false`. */
+    required?: boolean;
+};
+/**
+ * Formats the prompt question line.
+ * Returns: `? message > ` with `?` in accent color and `>` as separator.
+ */
+export declare function formatTextQuestion(message: string): string;
+/**
+ * Formats the submitted answer line.
+ * Returns: `checkmark message value` with value in dim.
+ */
+export declare function formatTextAnswer(message: string, value: string): string;
+/**
+ * Formats a validation error.
+ */
+export declare function formatValidationError(error: string): string;
+/**
+ * Prompts the user for single-line text input with validation support.
+ * Falls back to simple stdin reading in non-TTY environments.
+ *
+ * @param options - Prompt configuration.
+ * @returns The validated user input string.
+ */
+export declare function textPrompt(options: TextPromptOptions): Promise<string>;
+//# sourceMappingURL=textPrompt.d.ts.map

package/dist/components/textPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textPrompt.d.ts","sourceRoot":"","sources":["../../src/components/textPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG;IAC/B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgGtE"}

package/dist/components/textPrompt.js

@@ -0,0 +1,123 @@
+/**
+ * TextPrompt Component
+ *
+ * Prompts the user for text input with validation, placeholder, and default value support.
+ * Uses Node's readline module for input handling.
+ * Falls back to simple stdin reading in non-TTY environments.
+ */
+import * as readline from "node:readline";
+import { getContext, styledText, symbol } from "../primitives/index.js";
+/**
+ * Formats the prompt question line.
+ * Returns: `? message > ` with `?` in accent color and `>` as separator.
+ */
+export function formatTextQuestion(message) {
+    const ctx = getContext();
+    const q = styledText("?", { color: "accent", bold: true });
+    const sep = styledText("\u203a", { dim: true });
+    return `${q} ${message} ${sep} `;
+}
+/**
+ * Formats the submitted answer line.
+ * Returns: `checkmark message value` with value in dim.
+ */
+export function formatTextAnswer(message, value) {
+    const icon = styledText(symbol("success"), { color: "success" });
+    const val = styledText(value, { dim: true });
+    return `${icon} ${message} ${val}`;
+}
+/**
+ * Formats a validation error.
+ */
+export function formatValidationError(error) {
+    const icon = styledText(symbol("error"), { color: "error" });
+    return `${icon} ${styledText(error, { color: "error" })}`;
+}
+/**
+ * Prompts the user for single-line text input with validation support.
+ * Falls back to simple stdin reading in non-TTY environments.
+ *
+ * @param options - Prompt configuration.
+ * @returns The validated user input string.
+ */
+export function textPrompt(options) {
+    const ctx = getContext();
+    const stream = process.stderr;
+    const isTTY = !!process.stdin.isTTY;
+    return new Promise((resolve, reject) => {
+        if (!isTTY) {
+            // Non-TTY: read a line from stdin directly
+            const rl = readline.createInterface({
+                input: process.stdin,
+                terminal: false,
+            });
+            stream.write(`${options.message}: `);
+            rl.once("line", (line) => {
+                const value = line.trim() || options.defaultValue || "";
+                if (options.required && !value) {
+                    rl.close();
+                    reject(new Error("Input required but received empty value in non-interactive mode"));
+                    return;
+                }
+                if (options.validate) {
+                    const error = options.validate(value);
+                    if (error) {
+                        rl.close();
+                        reject(new Error(error));
+                        return;
+                    }
+                }
+                rl.close();
+                resolve(value);
+            });
+            rl.once("close", () => {
+                // If stdin closes without a line (e.g. EOF), resolve with default
+            });
+            return;
+        }
+        // Interactive TTY mode
+        const promptLine = formatTextQuestion(options.message);
+        const placeholderText = options.placeholder
+            ? styledText(options.placeholder, { dim: true })
+            : "";
+        function askQuestion() {
+            stream.write("\r\x1b[K");
+            stream.write(promptLine);
+            if (placeholderText && !options.defaultValue) {
+                // Show placeholder, but it will be overwritten on typing
+            }
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: stream,
+                terminal: true,
+            });
+            rl.question("", (answer) => {
+                rl.close();
+                const value = answer.trim() || options.defaultValue || "";
+                if (options.required && !value) {
+                    stream.write("\n");
+                    stream.write(`${formatValidationError("This field is required")}\n`);
+                    askQuestion();
+                    return;
+                }
+                if (options.validate) {
+                    const error = options.validate(value);
+                    if (error) {
+                        stream.write("\n");
+                        stream.write(`${formatValidationError(error)}\n`);
+                        askQuestion();
+                        return;
+                    }
+                }
+                // Replace prompt with final answer
+                stream.write("\r\x1b[K");
+                // Move up one line to overwrite the question
+                stream.write("\x1b[A\r\x1b[K");
+                stream.write(`${formatTextAnswer(options.message, value)}\n`);
+                resolve(value);
+            });
+        }
+        askQuestion();
+    });
+}
+//# sourceMappingURL=textPrompt.js.map

package/dist/components/textPrompt.js.map

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

package/dist/components/tree.d.ts

@@ -0,0 +1,30 @@
+/**
+ * tree Component
+ *
+ * Renders a tree structure with branch connectors using resolved tree tokens.
+ */
+/** A node in a tree structure. */
+export type TreeNode = {
+    /** Display label for this node. */
+    label: string;
+    /** Child nodes. */
+    children?: TreeNode[];
+};
+/** Options for rendering a tree. */
+export type TreeOptions = {
+    /** Maximum tree depth to render. Omit for unlimited. */
+    maxDepth?: number;
+    /** Append child count in parentheses after nodes with children. */
+    showCounts?: boolean;
+    /** Custom formatting function for node labels. */
+    formatNode?: (node: TreeNode) => string;
+};
+/**
+ * Renders a tree structure with branch connectors using resolved tree tokens.
+ *
+ * @param root - The root node of the tree.
+ * @param options - Tree rendering configuration.
+ * @returns The formatted tree as a multi-line string.
+ */
+export declare function tree(root: TreeNode, options?: TreeOptions): string;
+//# sourceMappingURL=tree.d.ts.map

package/dist/components/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/components/tree.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,kCAAkC;AAClC,MAAM,MAAM,QAAQ,GAAG;IACtB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACtB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG;IACzB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;CACxC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CA0ClE"}

package/dist/components/tree.js

@@ -0,0 +1,49 @@
+/**
+ * tree Component
+ *
+ * Renders a tree structure with branch connectors using resolved tree tokens.
+ */
+import { getContext, styledText } from "../primitives/index.js";
+/**
+ * Renders a tree structure with branch connectors using resolved tree tokens.
+ *
+ * @param root - The root node of the tree.
+ * @param options - Tree rendering configuration.
+ * @returns The formatted tree as a multi-line string.
+ */
+export function tree(root, options) {
+    const ctx = getContext();
+    const chars = ctx.tokens.tree;
+    const maxDepth = options?.maxDepth;
+    const showCounts = options?.showCounts ?? false;
+    const formatNode = options?.formatNode;
+    const lines = [];
+    function formatLabel(node) {
+        let label = formatNode ? formatNode(node) : node.label;
+        if (showCounts && node.children && node.children.length > 0) {
+            label += styledText(` (${node.children.length})`, { dim: true });
+        }
+        return label;
+    }
+    // Render root
+    lines.push(formatLabel(root));
+    function renderChildren(children, prefix, depth) {
+        if (maxDepth !== undefined && depth >= maxDepth)
+            return;
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            const isLast = i === children.length - 1;
+            const connector = isLast ? chars.last : chars.branch;
+            const continuation = isLast ? chars.indent : chars.vertical;
+            lines.push(`${prefix + connector} ${formatLabel(child)}`);
+            if (child.children && child.children.length > 0) {
+                renderChildren(child.children, prefix + continuation, depth + 1);
+            }
+        }
+    }
+    if (root.children && root.children.length > 0) {
+        renderChildren(root.children, "", 0);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=tree.js.map

package/dist/components/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../src/components/tree.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAoBhE;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,IAAc,EAAE,OAAqB;IACzD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACnC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAChD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS,WAAW,CAAC,IAAc;QAClC,IAAI,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACvD,IAAI,UAAU,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,KAAK,IAAI,UAAU,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,cAAc;IACd,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9B,SAAS,cAAc,CAAC,QAAoB,EAAE,MAAc,EAAE,KAAa;QAC1E,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,IAAI,QAAQ;YAAE,OAAO;QAExD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YACrD,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YAE5D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAE1D,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAClE,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/ds-index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * CLI Design System — Public API
+ *
+ * Two consumption modes:
+ * 1. System object (full control): `const ds = createSystem({ theme: 'minimal' })`
+ * 2. Standalone functions (zero config): `import { message } from 'cli-ds'`
+ */
+import type { TerminalCapabilities } from "./capabilities/index.ts";
+import { ThemeEngine } from "./theme/index.ts";
+import type { Theme, ThemeInput } from "./theme/index.ts";
+import type { ResolvedTokens } from "./tokens/index.ts";
+import { align, badge, border, divider, indent, line, pad, stack, styledText, symbol, truncate, wrap } from "./primitives/index.ts";
+import { columns, confirmPrompt, diff, helpLayout, keyValue, list, message, panel, progressBar, section, selectPrompt, spinner, statusList, table, textPrompt, tree } from "./components/index.ts";
+/** Configuration options for {@link createSystem}. */
+export type SystemOptions = {
+    /** Theme configuration: a built-in name, custom theme object, or array to compose. */
+    theme?: ThemeInput;
+    /** Terminal capability overrides merged onto auto-detected values. */
+    capabilities?: Partial<TerminalCapabilities>;
+};
+/**
+ * A fully configured design system instance providing access to all primitives,
+ * components, and runtime theme management.
+ */
+export type DesignSystem = {
+    /** Resolved design tokens for the current theme and terminal capabilities. */
+    readonly tokens: ResolvedTokens;
+    /** Detected or overridden terminal capabilities. */
+    readonly capabilities: TerminalCapabilities;
+    /** The underlying theme engine managing token resolution and caching. */
+    readonly theme: ThemeEngine;
+    /** Replace the active theme. Updates all resolved tokens. */
+    setTheme(themeInput: ThemeInput): void;
+    /** Merge partial overrides into the active theme. */
+    mergeTheme(partial: Theme): void;
+    styledText: typeof styledText;
+    symbol: typeof symbol;
+    pad: typeof pad;
+    truncate: typeof truncate;
+    align: typeof align;
+    line: typeof line;
+    stack: typeof stack;
+    indent: typeof indent;
+    wrap: typeof wrap;
+    border: typeof border;
+    divider: typeof divider;
+    badge: typeof badge;
+    message: typeof message;
+    statusList: typeof statusList;
+    table: typeof table;
+    list: typeof list;
+    tree: typeof tree;
+    keyValue: typeof keyValue;
+    diff: typeof diff;
+    panel: typeof panel;
+    columns: typeof columns;
+    section: typeof section;
+    helpLayout: typeof helpLayout;
+    spinner: typeof spinner;
+    progressBar: typeof progressBar;
+    textPrompt: typeof textPrompt;
+    confirmPrompt: typeof confirmPrompt;
+    selectPrompt: typeof selectPrompt;
+};
+/**
+ * Creates a fully configured design system instance.
+ *
+ * Detects (or accepts overridden) terminal capabilities, instantiates
+ * a ThemeEngine, sets the global context, and returns an object with
+ * all primitives and components bound to that context.
+ *
+ * @param options - Optional theme and capability configuration.
+ * @returns A {@link DesignSystem} instance with all primitives and components.
+ */
+export declare function createSystem(options?: SystemOptions): DesignSystem;
+export { styledText, symbol, pad, truncate, align, line, stack, indent, wrap, border, divider, badge, } from "./primitives/index.ts";
+export { message, statusList, table, list, tree, keyValue, diff, panel, columns, section, helpLayout, } from "./components/index.ts";
+export { spinner, progressBar, textPrompt, confirmPrompt, selectPrompt, } from "./components/index.ts";
+export type { TerminalCapabilities, ColorDepth } from "./capabilities/index.ts";
+export type { Theme, ThemeInput, BuiltinThemeName } from "./theme/index.ts";
+export type { ResolvedTokens } from "./tokens/index.ts";
+export type { StyleSpec } from "./render/index.ts";
+export type { MessageOptions } from "./components/index.ts";
+export type { StatusListItem } from "./components/index.ts";
+export type { TableColumn, TableOptions } from "./components/index.ts";
+export type { ListItem, ListOptions } from "./components/index.ts";
+export type { TreeNode, TreeOptions } from "./components/index.ts";
+export type { KeyValueEntry, KeyValueOptions } from "./components/index.ts";
+export type { DiffLine, DiffHunk, DiffOptions } from "./components/index.ts";
+export type { PanelOptions } from "./components/index.ts";
+export type { ColumnDef, ColumnsOptions } from "./components/index.ts";
+export type { SectionOptions } from "./components/index.ts";
+export type { HelpLayoutOptions } from "./components/index.ts";
+export type { SpinnerOptions, SpinnerHandle } from "./components/index.ts";
+export type { ProgressBarOptions, ProgressBarHandle } from "./components/index.ts";
+export type { TextPromptOptions } from "./components/index.ts";
+export type { ConfirmPromptOptions } from "./components/index.ts";
+export type { SelectOption, SelectPromptOptions } from "./components/index.ts";
+export type { StyledTextOptions } from "./primitives/index.ts";
+export type { PadOptions } from "./primitives/index.ts";
+export type { TruncateOptions } from "./primitives/index.ts";
+export type { AlignOptions } from "./primitives/index.ts";
+export type { LinePart } from "./primitives/index.ts";
+export type { StackOptions } from "./primitives/index.ts";
+export type { WrapOptions } from "./primitives/index.ts";
+export type { BorderOptions } from "./primitives/index.ts";
+export type { DividerOptions } from "./primitives/index.ts";
+export type { BadgeOptions } from "./primitives/index.ts";
+export { stripAnsi, stringWidth } from "./render/index.ts";
+export { createCapabilities } from "./capabilities/index.ts";
+export { getContext, setContext, createContext } from "./primitives/index.ts";
+export type { SystemContext } from "./primitives/index.ts";
+//# sourceMappingURL=ds-index.d.ts.map

package/dist/ds-index.d.ts.map

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

package/dist/ds-index.js

@@ -0,0 +1,112 @@
+/**
+ * CLI Design System — Public API
+ *
+ * Two consumption modes:
+ * 1. System object (full control): `const ds = createSystem({ theme: 'minimal' })`
+ * 2. Standalone functions (zero config): `import { message } from 'cli-ds'`
+ */
+// ---------------------------------------------------------------------------
+// Core factory
+// ---------------------------------------------------------------------------
+import { createCapabilities, detectCapabilities } from "./capabilities/index.js";
+import { setContext } from "./primitives/context.js";
+import { ThemeEngine } from "./theme/index.js";
+// Import all primitives for binding onto the system object
+import { align, badge, border, divider, indent, line, pad, stack, styledText, symbol, truncate, wrap, } from "./primitives/index.js";
+// Import all components for binding onto the system object
+import { columns, confirmPrompt, diff, helpLayout, keyValue, list, message, panel, progressBar, section, selectPrompt, spinner, statusList, table, textPrompt, tree, } from "./components/index.js";
+/**
+ * Creates a fully configured design system instance.
+ *
+ * Detects (or accepts overridden) terminal capabilities, instantiates
+ * a ThemeEngine, sets the global context, and returns an object with
+ * all primitives and components bound to that context.
+ *
+ * @param options - Optional theme and capability configuration.
+ * @returns A {@link DesignSystem} instance with all primitives and components.
+ */
+export function createSystem(options) {
+    const caps = options?.capabilities
+        ? createCapabilities(options.capabilities)
+        : detectCapabilities();
+    const themeEngine = new ThemeEngine(caps, options?.theme);
+    const ctx = {
+        theme: themeEngine,
+        capabilities: caps,
+        get tokens() {
+            return themeEngine.resolvedTokens;
+        },
+    };
+    // Set as the global context so all standalone functions use this system
+    setContext(ctx);
+    const system = {
+        // Resolved state — tokens is a live getter that reflects theme changes
+        get tokens() {
+            return themeEngine.resolvedTokens;
+        },
+        capabilities: caps,
+        theme: themeEngine,
+        // Runtime modifications
+        setTheme(themeInput) {
+            themeEngine.setTheme(themeInput);
+            // Context stays in sync because ctx.tokens is a getter on themeEngine
+        },
+        mergeTheme(partial) {
+            themeEngine.mergeTheme(partial);
+        },
+        // Primitives — same functions, they read from the global context
+        styledText,
+        symbol,
+        pad,
+        truncate,
+        align,
+        line,
+        stack,
+        indent,
+        wrap,
+        border,
+        divider,
+        badge,
+        // Static components
+        message,
+        statusList,
+        table,
+        list,
+        tree,
+        keyValue,
+        diff,
+        panel,
+        columns,
+        section,
+        helpLayout,
+        // Interactive components
+        spinner,
+        progressBar,
+        textPrompt,
+        confirmPrompt,
+        selectPrompt,
+    };
+    return system;
+}
+// ---------------------------------------------------------------------------
+// Standalone re-exports — primitives
+// ---------------------------------------------------------------------------
+export { styledText, symbol, pad, truncate, align, line, stack, indent, wrap, border, divider, badge, } from "./primitives/index.js";
+// ---------------------------------------------------------------------------
+// Standalone re-exports — components (static)
+// ---------------------------------------------------------------------------
+export { message, statusList, table, list, tree, keyValue, diff, panel, columns, section, helpLayout, } from "./components/index.js";
+// ---------------------------------------------------------------------------
+// Standalone re-exports — components (interactive)
+// ---------------------------------------------------------------------------
+export { spinner, progressBar, textPrompt, confirmPrompt, selectPrompt, } from "./components/index.js";
+// ---------------------------------------------------------------------------
+// Utility re-exports
+// ---------------------------------------------------------------------------
+export { stripAnsi, stringWidth } from "./render/index.js";
+export { createCapabilities } from "./capabilities/index.js";
+// ---------------------------------------------------------------------------
+// Context re-exports (for advanced usage)
+// ---------------------------------------------------------------------------
+export { getContext, setContext, createContext } from "./primitives/index.js";
+//# sourceMappingURL=ds-index.js.map

package/dist/ds-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ds-index.js","sourceRoot":"","sources":["../src/ds-index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,2DAA2D;AAC3D,OAAO,EACN,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,IAAI,EACJ,GAAG,EACH,KAAK,EACL,UAAU,EACV,MAAM,EACN,QAAQ,EACR,IAAI,GACJ,MAAM,uBAAuB,CAAC;AAE/B,2DAA2D;AAC3D,OAAO,EACN,OAAO,EACP,aAAa,EACb,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAO,EACP,YAAY,EACZ,OAAO,EACP,UAAU,EACV,KAAK,EACL,UAAU,EACV,IAAI,GACJ,MAAM,uBAAuB,CAAC;AA8D/B;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,OAAuB;IACnD,MAAM,IAAI,GAAG,OAAO,EAAE,YAAY;QACjC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1C,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAExB,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAE1D,MAAM,GAAG,GAAkB;QAC1B,KAAK,EAAE,WAAW;QAClB,YAAY,EAAE,IAAI;QAClB,IAAI,MAAM;YACT,OAAO,WAAW,CAAC,cAAc,CAAC;QACnC,CAAC;KACD,CAAC;IAEF,wEAAwE;IACxE,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAiB;QAC5B,uEAAuE;QACvE,IAAI,MAAM;YACT,OAAO,WAAW,CAAC,cAAc,CAAC;QACnC,CAAC;QACD,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,WAAW;QAElB,wBAAwB;QACxB,QAAQ,CAAC,UAAsB;YAC9B,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACjC,sEAAsE;QACvE,CAAC;QACD,UAAU,CAAC,OAAc;YACxB,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,iEAAiE;QACjE,UAAU;QACV,MAAM;QACN,GAAG;QACH,QAAQ;QACR,KAAK;QACL,IAAI;QACJ,KAAK;QACL,MAAM;QACN,IAAI;QACJ,MAAM;QACN,OAAO;QACP,KAAK;QAEL,oBAAoB;QACpB,OAAO;QACP,UAAU;QACV,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,UAAU;QAEV,yBAAyB;QACzB,OAAO;QACP,WAAW;QACX,UAAU;QACV,aAAa;QACb,YAAY;KACZ,CAAC;IAEF,OAAO,MAAM,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,OAAO,EACN,UAAU,EACV,MAAM,EACN,GAAG,EACH,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,KAAK,EACL,MAAM,EACN,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,GACL,MAAM,uBAAuB,CAAC;AAE/B,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,OAAO,EACN,OAAO,EACP,UAAU,EACV,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,UAAU,GACV,MAAM,uBAAuB,CAAC;AAE/B,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,OAAO,EACN,OAAO,EACP,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,GACZ,MAAM,uBAAuB,CAAC;AA8D/B,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/help.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Help System — Subpath re-exports for @hypercli/ui/help
+ *
+ * Provides convenience re-exports of the markdown primitive under
+ * help-oriented names for the CLI help rendering use case.
+ * No third-party types are exposed — everything is defined by the DS.
+ */
+import type { HeadingStyle, MarkdownOptions, MarkdownTheme } from "./primitives/markdown.ts";
+export type { MarkdownTheme, MarkdownOptions, HeadingStyle };
+/** @deprecated Use MarkdownTheme instead. */
+export type HelpTheme = MarkdownTheme;
+/** Configuration for help rendering. */
+export interface HelpThemeConfig {
+    theme?: MarkdownTheme;
+    lineWidth?: {
+        max?: number;
+        min?: number;
+    };
+    asciiMode?: boolean;
+}
+/** The default help theme. Alias for defaultMarkdownTheme. */
+export declare const helpTheme: HelpThemeConfig;
+/**
+ * Render markdown for help output using the default or custom theme.
+ */
+export declare function renderHelp(input: string, config?: HelpThemeConfig): string;
+/**
+ * Render markdown with an optional theme.
+ * If no theme is given, uses the default markdown theme.
+ */
+export declare function renderMarkdown(input: string, theme?: MarkdownTheme): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAM7F,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAE7D,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC;AAEtC,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,8DAA8D;AAC9D,eAAO,MAAM,SAAS,EAAE,eAGvB,CAAC;AAMF;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAG1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAE3E"}

package/dist/help.js

@@ -0,0 +1,34 @@
+/**
+ * Help System — Subpath re-exports for @hypercli/ui/help
+ *
+ * Provides convenience re-exports of the markdown primitive under
+ * help-oriented names for the CLI help rendering use case.
+ * No third-party types are exposed — everything is defined by the DS.
+ */
+import { defaultMarkdownTheme, markdown } from "./primitives/markdown.js";
+// ---------------------------------------------------------------------------
+// Default theme
+// ---------------------------------------------------------------------------
+/** The default help theme. Alias for defaultMarkdownTheme. */
+export const helpTheme = {
+    lineWidth: { max: 100 },
+    theme: defaultMarkdownTheme,
+};
+// ---------------------------------------------------------------------------
+// Convenience functions
+// ---------------------------------------------------------------------------
+/**
+ * Render markdown for help output using the default or custom theme.
+ */
+export function renderHelp(input, config) {
+    const theme = config?.theme ?? defaultMarkdownTheme;
+    return markdown(input, { theme });
+}
+/**
+ * Render markdown with an optional theme.
+ * If no theme is given, uses the default markdown theme.
+ */
+export function renderMarkdown(input, theme) {
+    return markdown(input, theme ? { theme } : undefined);
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAmB1E,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GAAoB;IACzC,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;IACvB,KAAK,EAAE,oBAAoB;CAC3B,CAAC;AAEF,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAwB;IACjE,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,oBAAoB,CAAC;IACpD,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAqB;IAClE,OAAO,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACvD,CAAC"}

package/dist/hyper-theme.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hyper Theme — HyperDev CLI brand theme
+ *
+ * Encodes all of HyperDev's visual opinions as a DS theme object.
+ */
+import type { Theme } from "./theme/index.ts";
+export declare const hyperTheme: Theme;
+//# sourceMappingURL=hyper-theme.d.ts.map

package/dist/hyper-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyper-theme.d.ts","sourceRoot":"","sources":["../src/hyper-theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,UAAU,EAAE,KAuBxB,CAAC"}