@hypercli/ui 0.1.1

package/dist/hyper-theme.js

@@ -0,0 +1,30 @@
+/**
+ * Hyper Theme — HyperDev CLI brand theme
+ *
+ * Encodes all of HyperDev's visual opinions as a DS theme object.
+ */
+export const hyperTheme = {
+    name: "hyper",
+    meta: { description: "HyperDev CLI brand theme" },
+    color: {
+        // Map Hyper's palette to DS token roles
+        code: { ansi16: "cyan", ansi256: 37, truecolor: "#4EC9B0" },
+        error: { ansi16: "red", ansi256: 196, truecolor: "#f87171" },
+        warning: { ansi16: "yellow", ansi256: 214, truecolor: "#fbbf24" },
+        success: { ansi16: "green", ansi256: 34, truecolor: "#4ade80" },
+        info: { ansi16: "blue", ansi256: 33, truecolor: "#60a5fa" },
+        accent: { ansi16: "blue", ansi256: 33, truecolor: "#60a5fa" },
+    },
+    symbol: {
+        // Match current UI symbols exactly
+        error: { unicode: "\u00d7", ascii: "[FAIL]" },
+        warning: { unicode: "\u25b2", ascii: "[WARN]" },
+        success: { unicode: "\u2714", ascii: "[OK]" },
+        info: { unicode: "\u25cf", ascii: "[INFO]" },
+        tip: { unicode: "\u25c6", ascii: "[TIP]" },
+    },
+    space: {
+        iconGap: 1,
+    },
+};
+//# sourceMappingURL=hyper-theme.js.map

package/dist/hyper-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyper-theme.js","sourceRoot":"","sources":["../src/hyper-theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,UAAU,GAAU;IAChC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACjD,KAAK,EAAE;QACN,wCAAwC;QACxC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;QAC3D,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE;QAC5D,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE;QACjE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;QAC/D,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;QAC3D,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;KAC7D;IACD,MAAM,EAAE;QACP,mCAAmC;QACnC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC7C,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC/C,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE;QAC7C,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC5C,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;KAC1C;IACD,KAAK,EAAE;QACN,OAAO,EAAE,CAAC;KACV;CACD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @hypercli/ui — CLI Design System for HyperDev
+ *
+ * Two consumption modes:
+ * 1. Full DS API: `import { createSystem, styledText, message } from '@hypercli/ui'`
+ * 2. Quick shortcuts: `import { c, s, msg, md } from '@hypercli/ui/shortcuts'`
+ * 3. Markdown rendering: `import { markdown } from '@hypercli/ui'`
+ */
+export { createSystem } from "./ds-index.ts";
+export type { SystemOptions, DesignSystem } from "./ds-index.ts";
+export { styledText, symbol, pad, truncate, align, line, stack, indent, wrap, border, divider, badge, markdown, defaultMarkdownTheme, } from "./primitives/index.ts";
+export { message, statusList, table, list, tree, keyValue, diff, panel, columns, section, helpLayout, } from "./components/index.ts";
+export { spinner, progressBar, } from "./components/index.ts";
+export type { TerminalCapabilities, ColorDepth } from "./capabilities/index.ts";
+export { createCapabilities } 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 { stripAnsi, stringWidth } from "./render/index.ts";
+export { getContext, setContext, createContext } from "./primitives/index.ts";
+export type { SystemContext } from "./primitives/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 { 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 { hyperTheme } from "./hyper-theme.ts";
+export { c, s, msg, md } from "./shortcuts.ts";
+export type { MarkdownTheme, MarkdownOptions, HeadingStyle } from "./primitives/index.ts";
+export { renderHelp, renderMarkdown, helpTheme } from "./help.ts";
+export type { HelpThemeConfig } from "./help.ts";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,39 @@
+/**
+ * @hypercli/ui — CLI Design System for HyperDev
+ *
+ * Two consumption modes:
+ * 1. Full DS API: `import { createSystem, styledText, message } from '@hypercli/ui'`
+ * 2. Quick shortcuts: `import { c, s, msg, md } from '@hypercli/ui/shortcuts'`
+ * 3. Markdown rendering: `import { markdown } from '@hypercli/ui'`
+ */
+// ---------------------------------------------------------------------------
+// Auto-initialize the design system with Hyper's brand theme
+// ---------------------------------------------------------------------------
+import { createSystem } from "./ds-index.js";
+import { hyperTheme } from "./hyper-theme.js";
+// Initialize on import — sets the global context so standalone functions work
+createSystem({ theme: hyperTheme });
+// ---------------------------------------------------------------------------
+// Re-export everything from the DS core
+// ---------------------------------------------------------------------------
+// Core factory
+export { createSystem } from "./ds-index.js";
+// Primitives
+export { styledText, symbol, pad, truncate, align, line, stack, indent, wrap, border, divider, badge, markdown, defaultMarkdownTheme, } from "./primitives/index.js";
+// Components (static) — excluding prompt components
+export { message, statusList, table, list, tree, keyValue, diff, panel, columns, section, helpLayout, } from "./components/index.js";
+// Interactive components (excluding prompts — those stay with clack)
+export { spinner, progressBar, } from "./components/index.js";
+export { createCapabilities } from "./capabilities/index.js";
+export { stripAnsi, stringWidth } from "./render/index.js";
+// Context
+export { getContext, setContext, createContext } from "./primitives/index.js";
+// ---------------------------------------------------------------------------
+// Hyper-specific exports
+// ---------------------------------------------------------------------------
+export { hyperTheme } from "./hyper-theme.js";
+// Convenience: re-export shortcuts at top level for backwards compat
+export { c, s, msg, md } from "./shortcuts.js";
+// Help system (convenience re-exports)
+export { renderHelp, renderMarkdown, helpTheme } from "./help.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;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,8EAA8E;AAC9E,YAAY,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AAEpC,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,aAAa;AACb,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,EACL,QAAQ,EACR,oBAAoB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,oDAAoD;AACpD,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,qEAAqE;AACrE,OAAO,EACN,OAAO,EACP,WAAW,GACX,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAU7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3D,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA8B9E,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,qEAAqE;AACrE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAK/C,uCAAuC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/md.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Inline markdown processor for CLI strings.
+ *
+ * Transforms a subset of markdown into chalk-styled terminal output:
+ * - `code` → command color (palette.brand)
+ * - **bold** → chalk.bold
+ * - *dim* → chalk.dim
+ *
+ * Opt-in only — not auto-applied to other functions.
+ */
+export declare function md(text: string): string;
+//# sourceMappingURL=md.d.ts.map

package/dist/md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.d.ts","sourceRoot":"","sources":["../src/md.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvC"}

package/dist/md.js

@@ -0,0 +1,19 @@
+/**
+ * Inline markdown processor for CLI strings.
+ *
+ * Transforms a subset of markdown into chalk-styled terminal output:
+ * - `code` → command color (palette.brand)
+ * - **bold** → chalk.bold
+ * - *dim* → chalk.dim
+ *
+ * Opt-in only — not auto-applied to other functions.
+ */
+import chalk from "chalk";
+import { palette } from "./palette.js";
+export function md(text) {
+    return text
+        .replace(/`([^`]+)`/g, (_, code) => chalk.hex(palette.brand)(code))
+        .replace(/\*\*([^*]+)\*\*/g, (_, bold) => chalk.bold(bold))
+        .replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, (_, dim) => chalk.dim(dim));
+}
+//# sourceMappingURL=md.js.map

package/dist/md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.js","sourceRoot":"","sources":["../src/md.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,UAAU,EAAE,CAAC,IAAY;IAC9B,OAAO,IAAI;SACT,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;SAClE,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1D,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Structured message blocks — the `msg` namespace.
+ *
+ * Produces formatted multi-line messages with icons, bars, and indentation.
+ * Supports both props objects and simple string shorthand.
+ */
+interface MessageProps {
+    title?: string;
+    summary: string;
+    body?: string | string[];
+}
+export declare const msg: {
+    error: (input: string | MessageProps) => string;
+    warning: (input: string | MessageProps) => string;
+    success: (input: string | MessageProps) => string;
+    info: (input: string | MessageProps) => string;
+    tip: (input: string | MessageProps) => string;
+};
+export {};
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,UAAU,YAAY;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzB;AAwDD,eAAO,MAAM,GAAG;mBANA,MAAM,GAAG,YAAY,KAAG,MAAM;qBAA9B,MAAM,GAAG,YAAY,KAAG,MAAM;qBAA9B,MAAM,GAAG,YAAY,KAAG,MAAM;kBAA9B,MAAM,GAAG,YAAY,KAAG,MAAM;iBAA9B,MAAM,GAAG,YAAY,KAAG,MAAM;CAY7C,CAAC"}

package/dist/messages.js

@@ -0,0 +1,65 @@
+/**
+ * Structured message blocks — the `msg` namespace.
+ *
+ * Produces formatted multi-line messages with icons, bars, and indentation.
+ * Supports both props objects and simple string shorthand.
+ */
+import chalk from "chalk";
+import { md } from "./md.js";
+import { symbols } from "./symbols.js";
+import { tokens } from "./tokens.js";
+const INDENT = "  ";
+const ICON_GAP = "  ";
+const types = {
+    error: { prefix: "Error:", icon: symbols.error, color: chalk.red },
+    warning: { prefix: "Warning:", icon: symbols.warning, color: chalk.yellow },
+    success: { prefix: "Success:", icon: symbols.success, color: chalk.green },
+    info: { prefix: "Info:", icon: symbols.info, color: chalk.blue },
+    tip: { prefix: "Tip:", icon: symbols.tip, color: chalk.hex(tokens.tip) },
+};
+function formatMessage(type, props) {
+    const { prefix, icon, color } = types[type];
+    const { title, summary, body } = props;
+    const lines = [];
+    // Don't add leading indent for tip messages
+    const leadingIndent = type === "tip" ? "" : INDENT;
+    const contentIndent = type === "tip" ? INDENT : `${INDENT}${INDENT}`;
+    const styledSummary = md(summary);
+    if (!title) {
+        // summary-only: just icon + summary
+        lines.push(`${leadingIndent}${color(icon)}${ICON_GAP}${styledSummary}`);
+    }
+    else if (!body) {
+        // title + summary
+        lines.push(`${leadingIndent}${color(prefix)} ${title}`);
+        lines.push("");
+        lines.push(`${contentIndent}${color(icon)}${ICON_GAP}${styledSummary}`);
+    }
+    else {
+        // title + summary + body
+        const bodyLines = Array.isArray(body) ? body : body.split("\n");
+        lines.push(`${leadingIndent}${color(prefix)} ${title}`);
+        lines.push("");
+        lines.push(`${contentIndent}${color(icon)}${ICON_GAP}${styledSummary}`);
+        lines.push(`${contentIndent}${color(symbols.bar)}`);
+        for (const bodyLine of bodyLines) {
+            lines.push(`${contentIndent}${color(symbols.bar)}${ICON_GAP}${chalk.dim(bodyLine)}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function makeMessageFn(type) {
+    return (input) => {
+        const props = typeof input === "string" ? { summary: input } : input;
+        return formatMessage(type, props);
+    };
+}
+export const msg = {
+    error: makeMessageFn("error"),
+    warning: makeMessageFn("warning"),
+    success: makeMessageFn("success"),
+    info: makeMessageFn("info"),
+    tip: makeMessageFn("tip"),
+};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

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

package/dist/palette.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Raw color values — single source of truth for the HyperDev CLI palette.
+ *
+ * All hex values and terminal color names live here.
+ * No chalk imports, no logic — just constants.
+ */
+export declare const palette: {
+    readonly brand: "#4EC9B0";
+    readonly danger: "#F67280";
+    readonly tipBlue: "#7FB3D5";
+    readonly red: "red";
+    readonly green: "green";
+    readonly yellow: "yellow";
+    readonly blue: "blue";
+    readonly magenta: "magenta";
+    readonly cyan: "cyan";
+    readonly gray: "gray";
+    readonly white: "white";
+};
+//# sourceMappingURL=palette.d.ts.map

package/dist/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../src/palette.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;;;CAeV,CAAC"}

package/dist/palette.js

@@ -0,0 +1,22 @@
+/**
+ * Raw color values — single source of truth for the HyperDev CLI palette.
+ *
+ * All hex values and terminal color names live here.
+ * No chalk imports, no logic — just constants.
+ */
+export const palette = {
+    // Brand colors (hex)
+    brand: "#4EC9B0", // teal — commands, code
+    danger: "#F67280", // coral — destructive actions
+    tipBlue: "#7FB3D5", // pastel blue — tips
+    // Terminal builtins (named for chalk compatibility)
+    red: "red",
+    green: "green",
+    yellow: "yellow",
+    blue: "blue",
+    magenta: "magenta",
+    cyan: "cyan",
+    gray: "gray",
+    white: "white",
+};
+//# sourceMappingURL=palette.js.map

package/dist/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../src/palette.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,qBAAqB;IACrB,KAAK,EAAE,SAAS,EAAE,wBAAwB;IAC1C,MAAM,EAAE,SAAS,EAAE,8BAA8B;IACjD,OAAO,EAAE,SAAS,EAAE,qBAAqB;IAEzC,oDAAoD;IACpD,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACL,CAAC"}

package/dist/primitives/align.d.ts

@@ -0,0 +1,23 @@
+/**
+ * align Primitive
+ *
+ * Aligns text within a given width using left, right, or center alignment.
+ * Supports a custom fill character.
+ */
+/** Options for aligning text within a fixed width. */
+export type AlignOptions = {
+    /** Horizontal alignment direction. Defaults to `'left'`. */
+    alignment?: "left" | "right" | "center";
+    /** Character used to fill remaining space. Defaults to `' '`. */
+    fill?: string;
+};
+/**
+ * Aligns text within a fixed column width, padding with a fill character.
+ *
+ * @param text - The text to align.
+ * @param width - The total column width to align within.
+ * @param options - Alignment configuration.
+ * @returns The aligned text string padded to the specified width.
+ */
+export declare function align(text: string, width: number, options?: AlignOptions): string;
+//# sourceMappingURL=align.d.ts.map

package/dist/primitives/align.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.d.ts","sourceRoot":"","sources":["../../src/primitives/align.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,sDAAsD;AACtD,MAAM,MAAM,YAAY,GAAG;IAC1B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACxC,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CA0BjF"}

package/dist/primitives/align.js

@@ -0,0 +1,40 @@
+/**
+ * align Primitive
+ *
+ * Aligns text within a given width using left, right, or center alignment.
+ * Supports a custom fill character.
+ */
+import { ansiPad, stringWidth } from "../render/index.js";
+/**
+ * Aligns text within a fixed column width, padding with a fill character.
+ *
+ * @param text - The text to align.
+ * @param width - The total column width to align within.
+ * @param options - Alignment configuration.
+ * @returns The aligned text string padded to the specified width.
+ */
+export function align(text, width, options) {
+    const alignment = options?.alignment ?? "left";
+    const fill = options?.fill;
+    // Default space fill: delegate to ansiPad
+    if (!fill || fill === " ") {
+        return ansiPad(text, width, alignment);
+    }
+    // Custom fill character: implement manually
+    const currentWidth = stringWidth(text);
+    if (currentWidth >= width)
+        return text;
+    const padding = width - currentWidth;
+    switch (alignment) {
+        case "right":
+            return fill.repeat(padding) + text;
+        case "center": {
+            const left = Math.floor(padding / 2);
+            const right = padding - left;
+            return fill.repeat(left) + text + fill.repeat(right);
+        }
+        default:
+            return text + fill.repeat(padding);
+    }
+}
+//# sourceMappingURL=align.js.map

package/dist/primitives/align.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.js","sourceRoot":"","sources":["../../src/primitives/align.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAU1D;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,KAAa,EAAE,OAAsB;IACxE,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,MAAM,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;IAE3B,0CAA0C;IAC1C,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,4CAA4C;IAC5C,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,YAAY,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,OAAO,GAAG,KAAK,GAAG,YAAY,CAAC;IAErC,QAAQ,SAAS,EAAE,CAAC;QACnB,KAAK,OAAO;YACX,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QACpC,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;QACD;YACC,OAAO,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;AACF,CAAC"}

package/dist/primitives/badge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * badge Primitive
+ *
+ * Renders a short label with a background color badge style.
+ * Falls back to [TEXT] brackets when color is unavailable.
+ */
+import type { ColorTokens } from "../tokens/index.ts";
+/** Options for rendering a badge label. */
+export type BadgeOptions = {
+    /** Background color token name. Defaults to `'bgInfo'`. */
+    color?: keyof ColorTokens;
+    /** Foreground (text) color token name. Uses the terminal default when omitted. */
+    textColor?: keyof ColorTokens;
+};
+/**
+ * Renders a short label as a colored badge.
+ * Falls back to `[text]` brackets on dumb or no-color terminals.
+ *
+ * @param text - The label text to display.
+ * @param options - Badge color configuration.
+ * @returns The styled badge string.
+ */
+export declare function badge(text: string, options?: BadgeOptions): string;
+//# sourceMappingURL=badge.d.ts.map

package/dist/primitives/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/primitives/badge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,2CAA2C;AAC3C,MAAM,MAAM,YAAY,GAAG;IAC1B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,WAAW,CAAC;IAC1B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CA6BlE"}

package/dist/primitives/badge.js

@@ -0,0 +1,40 @@
+/**
+ * badge Primitive
+ *
+ * Renders a short label with a background color badge style.
+ * Falls back to [TEXT] brackets when color is unavailable.
+ */
+import { applyStyle } from "../render/index.js";
+import { getContext } from "./context.js";
+/**
+ * Renders a short label as a colored badge.
+ * Falls back to `[text]` brackets on dumb or no-color terminals.
+ *
+ * @param text - The label text to display.
+ * @param options - Badge color configuration.
+ * @returns The styled badge string.
+ */
+export function badge(text, options) {
+    const ctx = getContext();
+    // Dumb terminal: plain brackets
+    if (ctx.capabilities.isDumb) {
+        return `[${text}]`;
+    }
+    // No color support: brackets
+    if (ctx.capabilities.noColor || ctx.capabilities.colorDepth === "none") {
+        return `[${text}]`;
+    }
+    const bgTokenName = options?.color ?? "bgInfo";
+    const bgColor = ctx.tokens.color[bgTokenName];
+    const fgTokenName = options?.textColor;
+    const fgColor = fgTokenName ? ctx.tokens.color[fgTokenName] : null;
+    const spec = {
+        bg: bgColor,
+    };
+    if (fgColor) {
+        spec.color = fgColor;
+    }
+    // Pad with single space each side
+    return applyStyle(` ${text} `, spec);
+}
+//# sourceMappingURL=badge.js.map

package/dist/primitives/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../src/primitives/badge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAU1C;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,OAAsB;IACzD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IAEzB,gCAAgC;IAChC,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,IAAI,IAAI,GAAG,CAAC;IACpB,CAAC;IAED,6BAA6B;IAC7B,IAAI,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QACxE,OAAO,IAAI,IAAI,GAAG,CAAC;IACpB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC;IAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAE9C,MAAM,WAAW,GAAG,OAAO,EAAE,SAAS,CAAC;IACvC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnE,MAAM,IAAI,GAAc;QACvB,EAAE,EAAE,OAAO;KACX,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,CAAC;IAED,kCAAkC;IAClC,OAAO,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/primitives/border.d.ts

@@ -0,0 +1,29 @@
+/**
+ * border Primitive
+ *
+ * Draws a box around content using resolved border character sets.
+ * Supports titles, configurable padding, and explicit or auto width.
+ */
+import type { BorderStyleName } from "../tokens/index.ts";
+/** Options for rendering a border box around content. */
+export type BorderOptions = {
+    /** Border character style name. Falls back to `'ascii'` when unicode is unavailable. */
+    style?: BorderStyleName;
+    /** Title text displayed in the top border. */
+    title?: string;
+    /** Alignment of the title within the top border. Defaults to `'left'`. */
+    titleAlign?: "left" | "center" | "right";
+    /** Number of horizontal padding characters inside the border on each side. Defaults to `1`. */
+    padding?: number;
+    /** Total box width including borders, or `'auto'` to fit content. Defaults to `'auto'`. */
+    width?: number | "auto";
+};
+/**
+ * Draws a box border around content lines.
+ *
+ * @param content - A string (split on newlines) or array of lines to enclose.
+ * @param options - Border configuration.
+ * @returns The bordered content as a multi-line string.
+ */
+export declare function border(content: string | string[], options?: BorderOptions): string;
+//# sourceMappingURL=border.d.ts.map

package/dist/primitives/border.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"border.d.ts","sourceRoot":"","sources":["../../src/primitives/border.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG;IAC3B,wFAAwF;IACxF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAqFlF"}

package/dist/primitives/border.js

@@ -0,0 +1,100 @@
+/**
+ * border Primitive
+ *
+ * Draws a box around content using resolved border character sets.
+ * Supports titles, configurable padding, and explicit or auto width.
+ */
+import { ansiPad, stringWidth } from "../render/index.js";
+import { getContext } from "./context.js";
+/**
+ * Draws a box border around content lines.
+ *
+ * @param content - A string (split on newlines) or array of lines to enclose.
+ * @param options - Border configuration.
+ * @returns The bordered content as a multi-line string.
+ */
+export function border(content, options) {
+    const ctx = getContext();
+    const paddingSize = options?.padding ?? 1;
+    const titleAlign = options?.titleAlign ?? "left";
+    // Resolve border character set
+    let chars = ctx.tokens.border.chars;
+    if (options?.style) {
+        // If not unicode capable, force ascii
+        const effectiveStyle = ctx.capabilities.unicode ? options.style : "ascii";
+        chars = ctx.tokens.border.styles[effectiveStyle];
+    }
+    else if (!ctx.capabilities.unicode) {
+        chars = ctx.tokens.border.styles.ascii;
+    }
+    const lines = Array.isArray(content) ? content : content.split("\n");
+    const paddingStr = " ".repeat(paddingSize);
+    // Calculate inner width (content area between vertical bars, including padding)
+    let innerWidth;
+    if (options?.width && options.width !== "auto") {
+        // Explicit width is the total box width including borders
+        // innerWidth = totalWidth - 2 (for vertical bars)
+        innerWidth = options.width - 2;
+    }
+    else {
+        // Auto: find the widest line
+        let maxLineWidth = 0;
+        for (const line of lines) {
+            const w = stringWidth(line);
+            if (w > maxLineWidth)
+                maxLineWidth = w;
+        }
+        innerWidth = maxLineWidth + paddingSize * 2;
+    }
+    // Content width is innerWidth minus padding on both sides
+    const contentWidth = innerWidth - paddingSize * 2;
+    // Build top border
+    let topLine;
+    if (options?.title) {
+        const title = ` ${options.title} `;
+        const titleWidth = stringWidth(title);
+        const available = innerWidth - titleWidth;
+        if (available <= 0) {
+            topLine = chars.topLeft + title.slice(0, innerWidth) + chars.topRight;
+        }
+        else if (titleAlign === "left") {
+            topLine =
+                chars.topLeft +
+                    chars.horizontal +
+                    title +
+                    chars.horizontal.repeat(available - 1) +
+                    chars.topRight;
+        }
+        else if (titleAlign === "right") {
+            topLine =
+                chars.topLeft +
+                    chars.horizontal.repeat(available - 1) +
+                    title +
+                    chars.horizontal +
+                    chars.topRight;
+        }
+        else {
+            // center
+            const left = Math.floor(available / 2);
+            const right = available - left;
+            topLine =
+                chars.topLeft +
+                    chars.horizontal.repeat(left) +
+                    title +
+                    chars.horizontal.repeat(right) +
+                    chars.topRight;
+        }
+    }
+    else {
+        topLine = chars.topLeft + chars.horizontal.repeat(innerWidth) + chars.topRight;
+    }
+    // Build bottom border
+    const bottomLine = chars.bottomLeft + chars.horizontal.repeat(innerWidth) + chars.bottomRight;
+    // Build content lines
+    const contentLines = lines.map((line) => {
+        const padded = ansiPad(line, contentWidth);
+        return chars.vertical + paddingStr + padded + paddingStr + chars.vertical;
+    });
+    return [topLine, ...contentLines, bottomLine].join("\n");
+}
+//# sourceMappingURL=border.js.map

package/dist/primitives/border.js.map

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