@hypercli/ui 0.1.1

package/dist/primitives/context.d.ts

@@ -0,0 +1,48 @@
+/**
+ * System Context
+ *
+ * Provides a shared context object that holds the ThemeEngine and resolved
+ * tokens. Primitives read from this context instead of accepting tokens
+ * as parameters on every call.
+ */
+import type { TerminalCapabilities } from "../capabilities/index.ts";
+import { ThemeEngine } from "../theme/index.ts";
+import type { ThemeInput } from "../theme/index.ts";
+import type { ResolvedTokens } from "../tokens/index.ts";
+/** Shared state holding the active theme engine, terminal capabilities, and resolved tokens. */
+export type SystemContext = {
+    /** The active theme engine instance. */
+    theme: ThemeEngine;
+    /** Detected or overridden terminal capabilities. */
+    capabilities: TerminalCapabilities;
+    /** Design tokens resolved by the theme engine. */
+    tokens: ResolvedTokens;
+};
+/**
+ * Returns the current system context, auto-initializing with defaults on first use.
+ *
+ * @returns The active {@link SystemContext}.
+ *
+ * @example
+ * ```ts
+ * const ctx = getContext()
+ * console.log(ctx.tokens.color.primary)
+ * ```
+ */
+export declare function getContext(): SystemContext;
+/**
+ * Replaces the current system context with the provided one.
+ *
+ * @param ctx - The new system context to set as active.
+ */
+export declare function setContext(ctx: SystemContext): void;
+/**
+ * Creates a new system context with specific capabilities and optional theme input.
+ * Useful for testing or rendering in non-default environments.
+ *
+ * @param capabilities - Partial terminal capabilities to merge with defaults.
+ * @param themeInput - Optional theme overrides to apply.
+ * @returns A new {@link SystemContext} configured with the given options.
+ */
+export declare function createContext(capabilities?: Partial<TerminalCapabilities>, themeInput?: ThemeInput): SystemContext;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/primitives/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,gGAAgG;AAChG,MAAM,MAAM,aAAa,GAAG;IAC3B,wCAAwC;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,oDAAoD;IACpD,YAAY,EAAE,oBAAoB,CAAC;IACnC,kDAAkD;IAClD,MAAM,EAAE,cAAc,CAAC;CACvB,CAAC;AAIF;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAc1C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAC5C,UAAU,CAAC,EAAE,UAAU,GACrB,aAAa,CAUf"}

package/dist/primitives/context.js

@@ -0,0 +1,64 @@
+/**
+ * System Context
+ *
+ * Provides a shared context object that holds the ThemeEngine and resolved
+ * tokens. Primitives read from this context instead of accepting tokens
+ * as parameters on every call.
+ */
+import { createCapabilities, detectCapabilities } from "../capabilities/index.js";
+import { ThemeEngine } from "../theme/index.js";
+let currentContext = null;
+/**
+ * Returns the current system context, auto-initializing with defaults on first use.
+ *
+ * @returns The active {@link SystemContext}.
+ *
+ * @example
+ * ```ts
+ * const ctx = getContext()
+ * console.log(ctx.tokens.color.primary)
+ * ```
+ */
+export function getContext() {
+    if (!currentContext) {
+        // Auto-initialize with defaults on first use
+        const capabilities = detectCapabilities();
+        const theme = new ThemeEngine(capabilities);
+        currentContext = {
+            theme,
+            capabilities,
+            get tokens() {
+                return theme.resolvedTokens;
+            },
+        };
+    }
+    return currentContext;
+}
+/**
+ * Replaces the current system context with the provided one.
+ *
+ * @param ctx - The new system context to set as active.
+ */
+export function setContext(ctx) {
+    currentContext = ctx;
+}
+/**
+ * Creates a new system context with specific capabilities and optional theme input.
+ * Useful for testing or rendering in non-default environments.
+ *
+ * @param capabilities - Partial terminal capabilities to merge with defaults.
+ * @param themeInput - Optional theme overrides to apply.
+ * @returns A new {@link SystemContext} configured with the given options.
+ */
+export function createContext(capabilities, themeInput) {
+    const caps = createCapabilities(capabilities);
+    const theme = new ThemeEngine(caps, themeInput);
+    return {
+        theme,
+        capabilities: caps,
+        get tokens() {
+            return theme.resolvedTokens;
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/primitives/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/primitives/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAchD,IAAI,cAAc,GAAyB,IAAI,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACzB,IAAI,CAAC,cAAc,EAAE,CAAC;QACrB,6CAA6C;QAC7C,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;QAC5C,cAAc,GAAG;YAChB,KAAK;YACL,YAAY;YACZ,IAAI,MAAM;gBACT,OAAO,KAAK,CAAC,cAAc,CAAC;YAC7B,CAAC;SACD,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,GAAkB;IAC5C,cAAc,GAAG,GAAG,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC5B,YAA4C,EAC5C,UAAuB;IAEvB,MAAM,IAAI,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChD,OAAO;QACN,KAAK;QACL,YAAY,EAAE,IAAI;QAClB,IAAI,MAAM;YACT,OAAO,KAAK,CAAC,cAAc,CAAC;QAC7B,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/primitives/divider.d.ts

@@ -0,0 +1,25 @@
+/**
+ * divider Primitive
+ *
+ * Renders a horizontal divider line with optional title. Supports
+ * multiple styles and gracefully degrades to ASCII.
+ */
+/** Options for rendering a horizontal divider. */
+export type DividerOptions = {
+    /** Total width of the divider in columns. Defaults to terminal width or `layout.defaultWidth`. */
+    width?: number;
+    /** Visual style of the divider line. Defaults to `'line'`. */
+    style?: "line" | "dashed" | "heavy" | "blank";
+    /** Title text displayed inline within the divider. */
+    title?: string;
+    /** Alignment of the title within the divider. Defaults to `'left'`. */
+    titleAlign?: "left" | "center" | "right";
+};
+/**
+ * Renders a horizontal divider line, optionally with an inline title.
+ *
+ * @param options - Divider configuration.
+ * @returns The divider string, or an empty string for the `'blank'` style.
+ */
+export declare function divider(options?: DividerOptions): string;
+//# sourceMappingURL=divider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"divider.d.ts","sourceRoot":"","sources":["../../src/primitives/divider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,kDAAkD;AAClD,MAAM,MAAM,cAAc,GAAG;IAC5B,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9C,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACzC,CAAC;AAgBF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAmCxD"}

package/dist/primitives/divider.js

@@ -0,0 +1,56 @@
+/**
+ * divider Primitive
+ *
+ * Renders a horizontal divider line with optional title. Supports
+ * multiple styles and gracefully degrades to ASCII.
+ */
+import { stringWidth } from "../render/index.js";
+import { getContext } from "./context.js";
+/** Unicode divider characters keyed by style name. */
+const UNICODE_CHARS = {
+    line: "\u2500", // ─
+    dashed: "\u254C", // ╌
+    heavy: "\u2501", // ━
+};
+/** ASCII fallback divider characters keyed by style name. */
+const ASCII_CHARS = {
+    line: "-",
+    dashed: "-",
+    heavy: "=",
+};
+/**
+ * Renders a horizontal divider line, optionally with an inline title.
+ *
+ * @param options - Divider configuration.
+ * @returns The divider string, or an empty string for the `'blank'` style.
+ */
+export function divider(options) {
+    const ctx = getContext();
+    const style = options?.style ?? "line";
+    const width = options?.width ?? ctx.capabilities.columns ?? ctx.tokens.layout.defaultWidth;
+    const titleAlign = options?.titleAlign ?? "left";
+    if (style === "blank")
+        return "";
+    const chars = ctx.capabilities.unicode ? UNICODE_CHARS : ASCII_CHARS;
+    const ch = chars[style];
+    if (!options?.title) {
+        return ch.repeat(width);
+    }
+    const title = ` ${options.title} `;
+    const titleWidth = stringWidth(title);
+    const available = width - titleWidth;
+    if (available <= 0) {
+        return ch.repeat(width);
+    }
+    if (titleAlign === "left") {
+        return ch.repeat(2) + title + ch.repeat(available - 2);
+    }
+    if (titleAlign === "right") {
+        return ch.repeat(available - 2) + title + ch.repeat(2);
+    }
+    // center
+    const left = Math.floor(available / 2);
+    const right = available - left;
+    return ch.repeat(left) + title + ch.repeat(right);
+}
+//# sourceMappingURL=divider.js.map

package/dist/primitives/divider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"divider.js","sourceRoot":"","sources":["../../src/primitives/divider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C,sDAAsD;AACtD,MAAM,aAAa,GAA2B;IAC7C,IAAI,EAAE,QAAQ,EAAE,IAAI;IACpB,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,KAAK,EAAE,QAAQ,EAAE,IAAI;CACrB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,WAAW,GAA2B;IAC3C,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,GAAG;IACX,KAAK,EAAE,GAAG;CACV,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,OAAwB;IAC/C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IAC3F,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC;IAEjD,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;IACrE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;IAEzB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC;IACnC,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;IAErC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,SAAS;IACT,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC"}

package/dist/primitives/indent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * indent Primitive
+ *
+ * Prepends indentation spaces to each line of content based on
+ * the resolved space.indent token.
+ */
+/**
+ * Indents each line of content by a number of indent levels.
+ * The indent size per level is determined by the `space.indent` token.
+ *
+ * @param content - The text content to indent (may contain newlines).
+ * @param level - Number of indent levels to apply. Defaults to `1`.
+ * @returns The indented text string.
+ */
+export declare function indent(content: string, level?: number): string;
+//# sourceMappingURL=indent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indent.d.ts","sourceRoot":"","sources":["../../src/primitives/indent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CASzD"}

package/dist/primitives/indent.js

@@ -0,0 +1,25 @@
+/**
+ * indent Primitive
+ *
+ * Prepends indentation spaces to each line of content based on
+ * the resolved space.indent token.
+ */
+import { getContext } from "./context.js";
+/**
+ * Indents each line of content by a number of indent levels.
+ * The indent size per level is determined by the `space.indent` token.
+ *
+ * @param content - The text content to indent (may contain newlines).
+ * @param level - Number of indent levels to apply. Defaults to `1`.
+ * @returns The indented text string.
+ */
+export function indent(content, level = 1) {
+    const ctx = getContext();
+    const indentSize = ctx.tokens.space.indent;
+    const prefix = " ".repeat(level * indentSize);
+    return content
+        .split("\n")
+        .map((line) => prefix + line)
+        .join("\n");
+}
+//# sourceMappingURL=indent.js.map

package/dist/primitives/indent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indent.js","sourceRoot":"","sources":["../../src/primitives/indent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,KAAK,GAAG,CAAC;IAChD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC;IAE9C,OAAO,OAAO;SACZ,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/primitives/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Primitives — Barrel Export
+ *
+ * The 13 atomic building blocks plus context management.
+ */
+export { getContext, setContext, createContext } from "./context.ts";
+export type { SystemContext } from "./context.ts";
+export { styledText } from "./styledText.ts";
+export type { StyledTextOptions } from "./styledText.ts";
+export { symbol } from "./symbol.ts";
+export { pad } from "./pad.ts";
+export type { PadOptions } from "./pad.ts";
+export { truncate } from "./truncate.ts";
+export type { TruncateOptions } from "./truncate.ts";
+export { align } from "./align.ts";
+export type { AlignOptions } from "./align.ts";
+export { line } from "./line.ts";
+export type { LinePart } from "./line.ts";
+export { stack } from "./stack.ts";
+export type { StackOptions } from "./stack.ts";
+export { indent } from "./indent.ts";
+export { wrap } from "./wrap.ts";
+export type { WrapOptions } from "./wrap.ts";
+export { border } from "./border.ts";
+export type { BorderOptions } from "./border.ts";
+export { divider } from "./divider.ts";
+export type { DividerOptions } from "./divider.ts";
+export { badge } from "./badge.ts";
+export type { BadgeOptions } from "./badge.ts";
+export { markdown, defaultMarkdownTheme } from "./markdown.ts";
+export type { MarkdownTheme, MarkdownOptions, HeadingStyle } from "./markdown.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/primitives/index.js

@@ -0,0 +1,22 @@
+/**
+ * Primitives — Barrel Export
+ *
+ * The 13 atomic building blocks plus context management.
+ */
+// Context
+export { getContext, setContext, createContext } from "./context.js";
+// Primitives
+export { styledText } from "./styledText.js";
+export { symbol } from "./symbol.js";
+export { pad } from "./pad.js";
+export { truncate } from "./truncate.js";
+export { align } from "./align.js";
+export { line } from "./line.js";
+export { stack } from "./stack.js";
+export { indent } from "./indent.js";
+export { wrap } from "./wrap.js";
+export { border } from "./border.js";
+export { divider } from "./divider.js";
+export { badge } from "./badge.js";
+export { markdown, defaultMarkdownTheme } from "./markdown.js";
+//# sourceMappingURL=index.js.map

package/dist/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGrE,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG/B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/primitives/line.d.ts

@@ -0,0 +1,21 @@
+/**
+ * line Primitive
+ *
+ * Composes a single horizontal line from parts. String parts are
+ * concatenated directly. Tuple [string, number] parts pad the string
+ * to the given column width.
+ */
+/**
+ * A segment of a line: either a plain string or a `[text, columnWidth]` tuple
+ * that pads the text to a fixed column width.
+ */
+export type LinePart = string | [string, number];
+/**
+ * Composes a horizontal line by concatenating parts.
+ * Tuple parts are padded to their specified column width.
+ *
+ * @param parts - Line segments to compose.
+ * @returns The composed line string.
+ */
+export declare function line(...parts: LinePart[]): string;
+//# sourceMappingURL=line.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../src/primitives/line.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAWjD"}

package/dist/primitives/line.js

@@ -0,0 +1,29 @@
+/**
+ * line Primitive
+ *
+ * Composes a single horizontal line from parts. String parts are
+ * concatenated directly. Tuple [string, number] parts pad the string
+ * to the given column width.
+ */
+import { ansiPad } from "../render/index.js";
+/**
+ * Composes a horizontal line by concatenating parts.
+ * Tuple parts are padded to their specified column width.
+ *
+ * @param parts - Line segments to compose.
+ * @returns The composed line string.
+ */
+export function line(...parts) {
+    let result = "";
+    for (const part of parts) {
+        if (typeof part === "string") {
+            result += part;
+        }
+        else {
+            const [text, colWidth] = part;
+            result += ansiPad(text, colWidth);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=line.js.map

package/dist/primitives/line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.js","sourceRoot":"","sources":["../../src/primitives/line.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQ7C;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,GAAG,KAAiB;IACxC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC;YAC9B,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/primitives/markdown.d.ts

@@ -0,0 +1,91 @@
+/**
+ * markdown Primitive
+ *
+ * Renders markdown text to styled terminal output. This is the design system's
+ * rich text rendering primitive — scope item #16 (Markdown/Rich Text Rendering).
+ *
+ * The underlying rendering engine is an opaque implementation detail.
+ * Consumers interact only with the MarkdownTheme type defined here.
+ *
+ * Degradation chain:
+ * - Truecolor terminals: full color + styling
+ * - 256-color terminals: mapped palette
+ * - 16-color terminals: named ANSI colors
+ * - No color / dumb: plain text passthrough
+ */
+/** Style specification for a heading level. */
+export interface HeadingStyle {
+    /** Color specification string (e.g. 'blue bold', 'yellow'). */
+    color?: string;
+    /** Optional indicator marker shown before the heading. */
+    indicator?: {
+        /** The marker character (e.g. '▶︎', '▸'). */
+        marker?: string;
+        /** Color specification for the marker. */
+        color?: string;
+    };
+}
+/** Theme for markdown rendering — controls how each element is styled. */
+export interface MarkdownTheme {
+    /** Heading styles (h1-h6). Can be a color string or full HeadingStyle object. */
+    h1?: string | HeadingStyle;
+    h2?: string | HeadingStyle;
+    h3?: string | HeadingStyle;
+    h4?: string | HeadingStyle;
+    h5?: string | HeadingStyle;
+    h6?: string | HeadingStyle;
+    /** Inline code and code block styling. */
+    code?: {
+        /** Color for inline code spans. */
+        color?: string;
+        /** Code block styling. */
+        block?: {
+            /** Color for code block text. */
+            color?: string;
+            /** Line number configuration. */
+            numbers?: {
+                enabled?: boolean;
+            };
+        };
+    };
+    /** Table styling. */
+    table?: {
+        /** Header row styling. */
+        header?: {
+            color?: string;
+        };
+    };
+    /** Link styling. */
+    a?: {
+        color?: string;
+    };
+}
+/** Options for the markdown rendering function. */
+export interface MarkdownOptions {
+    /** Custom theme overriding the default. */
+    theme?: MarkdownTheme;
+}
+/** The default markdown theme matching HyperDev's brand. */
+export declare const defaultMarkdownTheme: MarkdownTheme;
+/**
+ * Renders a markdown string to styled terminal output.
+ *
+ * This is the design system's rich text primitive. It converts standard
+ * markdown (headings, code blocks, tables, links, etc.) into ANSI-styled
+ * terminal text using the provided or default theme.
+ *
+ * @param input - The markdown string to render.
+ * @param options - Optional rendering configuration.
+ * @returns The styled terminal string.
+ *
+ * @example
+ * ```ts
+ * // With defaults
+ * console.log(markdown('# Hello\n\nSome **bold** text'))
+ *
+ * // With custom theme
+ * console.log(markdown('# Hello', { theme: { h1: 'green bold' } }))
+ * ```
+ */
+export declare function markdown(input: string, options?: MarkdownOptions): string;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/primitives/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC5B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,SAAS,CAAC,EAAE;QACX,6CAA6C;QAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,0CAA0C;QAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC7B,iFAAiF;IACjF,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC3B,0CAA0C;IAC1C,IAAI,CAAC,EAAE;QACN,mCAAmC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,0BAA0B;QAC1B,KAAK,CAAC,EAAE;YACP,iCAAiC;YACjC,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,iCAAiC;YACjC,OAAO,CAAC,EAAE;gBAAE,OAAO,CAAC,EAAE,OAAO,CAAA;aAAE,CAAC;SAChC,CAAC;KACF,CAAC;IACF,qBAAqB;IACrB,KAAK,CAAC,EAAE;QACP,0BAA0B;QAC1B,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5B,CAAC;IACF,oBAAoB;IACpB,CAAC,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC/B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC;CACtB;AAMD,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,EAAE,aAUlC,CAAC;AAMF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAKzE"}

package/dist/primitives/markdown.js

@@ -0,0 +1,62 @@
+/**
+ * markdown Primitive
+ *
+ * Renders markdown text to styled terminal output. This is the design system's
+ * rich text rendering primitive — scope item #16 (Markdown/Rich Text Rendering).
+ *
+ * The underlying rendering engine is an opaque implementation detail.
+ * Consumers interact only with the MarkdownTheme type defined here.
+ *
+ * Degradation chain:
+ * - Truecolor terminals: full color + styling
+ * - 256-color terminals: mapped palette
+ * - 16-color terminals: named ANSI colors
+ * - No color / dumb: plain text passthrough
+ */
+// Internal implementation — the rendering engine is an opaque dependency
+import { renderMarkdown as renderEngine } from "cli-html";
+// ---------------------------------------------------------------------------
+// Default theme — Hyper's brand-consistent markdown rendering
+// ---------------------------------------------------------------------------
+/** The default markdown theme matching HyperDev's brand. */
+export const defaultMarkdownTheme = {
+    h1: { color: "blue bold", indicator: { marker: "\u25b6\ufe0e", color: "blue bold" } },
+    h2: { color: "yellow bold", indicator: { marker: "\u25b8", color: "yellow bold" } },
+    h3: { color: "white bold", indicator: { marker: "\u25b9", color: "white bold" } },
+    code: {
+        color: "hex-4EC9B0",
+        block: { color: "gray", numbers: { enabled: false } },
+    },
+    table: { header: { color: "white bold" } },
+    a: { color: "cyan underline" },
+};
+// ---------------------------------------------------------------------------
+// Render function
+// ---------------------------------------------------------------------------
+/**
+ * Renders a markdown string to styled terminal output.
+ *
+ * This is the design system's rich text primitive. It converts standard
+ * markdown (headings, code blocks, tables, links, etc.) into ANSI-styled
+ * terminal text using the provided or default theme.
+ *
+ * @param input - The markdown string to render.
+ * @param options - Optional rendering configuration.
+ * @returns The styled terminal string.
+ *
+ * @example
+ * ```ts
+ * // With defaults
+ * console.log(markdown('# Hello\n\nSome **bold** text'))
+ *
+ * // With custom theme
+ * console.log(markdown('# Hello', { theme: { h1: 'green bold' } }))
+ * ```
+ */
+export function markdown(input, options) {
+    const theme = options?.theme ?? defaultMarkdownTheme;
+    // The engine accepts the theme object directly — our MarkdownTheme is a
+    // strict subset of its internal type, so this cast is safe.
+    return renderEngine(input, theme);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/primitives/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/primitives/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,yEAAyE;AACzE,OAAO,EAAE,cAAc,IAAI,YAAY,EAAE,MAAM,UAAU,CAAC;AAuD1D,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IAClD,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;IACrF,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;IACnF,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;IACjF,IAAI,EAAE;QACL,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;KACrD;IACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;IAC1C,CAAC,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;CAC9B,CAAC;AAEF,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,OAAyB;IAChE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,oBAAoB,CAAC;IACrD,wEAAwE;IACxE,4DAA4D;IAC5D,OAAO,YAAY,CAAC,KAAK,EAAE,KAAY,CAAC,CAAC;AAC1C,CAAC"}

package/dist/primitives/pad.d.ts

@@ -0,0 +1,24 @@
+/**
+ * pad Primitive
+ *
+ * Adds left and/or right padding to a string using a configurable
+ * fill character.
+ */
+/** Options for adding padding to text. */
+export type PadOptions = {
+    /** Number of padding characters to prepend. Defaults to `0`. */
+    left?: number;
+    /** Number of padding characters to append. Defaults to `0`. */
+    right?: number;
+    /** Character used for padding. Defaults to `' '`. */
+    char?: string;
+};
+/**
+ * Pads a string with a fill character on the left and/or right.
+ *
+ * @param text - The text to pad.
+ * @param options - Padding configuration.
+ * @returns The padded text string.
+ */
+export declare function pad(text: string, options?: PadOptions): string;
+//# sourceMappingURL=pad.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pad.d.ts","sourceRoot":"","sources":["../../src/primitives/pad.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG;IACxB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAM9D"}

package/dist/primitives/pad.js

@@ -0,0 +1,20 @@
+/**
+ * pad Primitive
+ *
+ * Adds left and/or right padding to a string using a configurable
+ * fill character.
+ */
+/**
+ * Pads a string with a fill character on the left and/or right.
+ *
+ * @param text - The text to pad.
+ * @param options - Padding configuration.
+ * @returns The padded text string.
+ */
+export function pad(text, options) {
+    const left = options?.left ?? 0;
+    const right = options?.right ?? 0;
+    const ch = options?.char ?? " ";
+    return ch.repeat(left) + text + ch.repeat(right);
+}
+//# sourceMappingURL=pad.js.map

package/dist/primitives/pad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pad.js","sourceRoot":"","sources":["../../src/primitives/pad.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,OAAoB;IACrD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC;IAEhC,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/primitives/stack.d.ts

@@ -0,0 +1,22 @@
+/**
+ * stack Primitive
+ *
+ * Joins lines vertically with configurable spacing and an optional
+ * prefix prepended to each line.
+ */
+/** Options for vertical stacking of lines. */
+export type StackOptions = {
+    /** Number of blank lines to insert between each content line. Defaults to `0`. */
+    spacing?: number;
+    /** String to prepend to every line. */
+    prefix?: string;
+};
+/**
+ * Joins lines vertically with optional spacing and a per-line prefix.
+ *
+ * @param lines - The lines to stack vertically.
+ * @param options - Stacking configuration.
+ * @returns The joined multi-line string.
+ */
+export declare function stack(lines: string[], options?: StackOptions): string;
+//# sourceMappingURL=stack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../src/primitives/stack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG;IAC1B,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAQrE"}