@hypercli/ui 0.1.1

package/dist/tokens/resolver.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Token Resolver
+ *
+ * Resolves abstract token values to concrete output values based on
+ * detected terminal capabilities. This is the bridge between the
+ * semantic token system and the actual ANSI output.
+ */
+import type { TerminalCapabilities } from "../capabilities/index.ts";
+import type { BorderCharSet, BorderStyleName, ColorTokenValue, ColorTokens, LayoutTokens, SpacingTokens, SpinnerDefinition, SymbolPair, SymbolTokens, TokenSet, TreeCharSet, TypographyStyle, TypographyTokens } from "./types.ts";
+/** A resolved color: string value or null when color is disabled. */
+export type ResolvedColor = string | null;
+/** Resolved typography style with the color reference replaced by a resolved color. */
+export type ResolvedTypographyStyle = Omit<TypographyStyle, "color"> & {
+    color?: ResolvedColor;
+};
+/** Resolved color tokens: each role maps to a string or null. */
+export type ResolvedColorTokens = {
+    [K in keyof ColorTokens]: ResolvedColor;
+};
+/** Resolved typography tokens: each role maps to a resolved style. */
+export type ResolvedTypographyTokens = {
+    [K in keyof TypographyTokens]: ResolvedTypographyStyle;
+};
+/** Resolved symbol tokens: each role maps to a single string. */
+export type ResolvedSymbolTokens = {
+    [K in keyof SymbolTokens]: string;
+};
+/** Resolved border tokens: a style name and the resolved character set. */
+export type ResolvedBorderTokens = {
+    style: BorderStyleName;
+    styles: Record<BorderStyleName, BorderCharSet>;
+    chars: BorderCharSet;
+};
+/** Resolved tree tokens: a single character set. */
+export type ResolvedTreeTokens = TreeCharSet;
+/** Resolved spinner: just the frame array for the current capability. */
+export type ResolvedSpinnerDefinition = string[];
+/** Resolved motion tokens. */
+export type ResolvedMotionTokens = {
+    spinnerDots: ResolvedSpinnerDefinition;
+    spinnerLine: ResolvedSpinnerDefinition;
+    spinnerArc: ResolvedSpinnerDefinition;
+    progressFilled: string;
+    progressPartial: string;
+    progressHead: string;
+    spinnerInterval: number;
+    progressInterval: number;
+};
+/** The complete resolved token set, ready for use by components. */
+export type ResolvedTokens = {
+    color: ResolvedColorTokens;
+    type: ResolvedTypographyTokens;
+    space: SpacingTokens;
+    layout: LayoutTokens;
+    symbol: ResolvedSymbolTokens;
+    border: ResolvedBorderTokens;
+    tree: ResolvedTreeTokens;
+    motion: ResolvedMotionTokens;
+};
+/**
+ * Resolves a single color token value to a string (or null if color is disabled).
+ *
+ * - colorDepth 'none' -> null
+ * - colorDepth '16' -> the ansi16 name (e.g. 'red')
+ * - colorDepth '256' -> the ansi256 index as a string
+ * - colorDepth 'truecolor' -> the hex string
+ * - Attribute tokens ('dim', 'bold', 'default') pass through as-is.
+ *
+ * @param token - The color token value to resolve.
+ * @param capabilities - Detected terminal capabilities used to pick the right tier.
+ * @returns A string representation of the color, or null when color is disabled.
+ */
+export declare function resolveColor(token: ColorTokenValue, capabilities: TerminalCapabilities): string | null;
+/**
+ * Resolves a symbol pair to the appropriate glyph based on unicode support.
+ *
+ * @param token - The symbol pair containing unicode and ascii variants.
+ * @param capabilities - Detected terminal capabilities.
+ * @returns The unicode or ascii glyph string.
+ */
+export declare function resolveSymbol(token: SymbolPair, capabilities: TerminalCapabilities): string;
+/**
+ * Resolves a spinner definition to the appropriate frame array.
+ *
+ * @param token - The spinner definition containing unicode and ascii frame arrays.
+ * @param capabilities - Detected terminal capabilities.
+ * @returns The unicode or ascii frame array.
+ */
+export declare function resolveSpinner(token: SpinnerDefinition, capabilities: TerminalCapabilities): string[];
+/**
+ * Resolves an entire token set against the given terminal capabilities,
+ * producing a {@link ResolvedTokens} object where every value is a concrete
+ * output-ready value.
+ *
+ * @param tokens - The complete token set to resolve.
+ * @param capabilities - Detected terminal capabilities.
+ * @returns A fully resolved token set ready for use by components.
+ */
+export declare function resolveTokens(tokens: TokenSet, capabilities: TerminalCapabilities): ResolvedTokens;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/tokens/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/tokens/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAc,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,KAAK,EACX,aAAa,EACb,eAAe,EAEf,eAAe,EACf,WAAW,EAEX,YAAY,EAEZ,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,WAAW,EAEX,eAAe,EACf,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAMpB,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;AAE1C,uFAAuF;AACvF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,GAAG;IACtE,KAAK,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG;KAChC,CAAC,IAAI,MAAM,WAAW,GAAG,aAAa;CACvC,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,wBAAwB,GAAG;KACrC,CAAC,IAAI,MAAM,gBAAgB,GAAG,uBAAuB;CACtD,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG;KACjC,CAAC,IAAI,MAAM,YAAY,GAAG,MAAM;CACjC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAC/C,KAAK,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE7C,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,MAAM,EAAE,CAAC;AAEjD,8BAA8B;AAC9B,MAAM,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,yBAAyB,CAAC;IACvC,WAAW,EAAE,yBAAyB,CAAC;IACvC,UAAU,EAAE,yBAAyB,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;CAC7B,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,oBAAoB,GAChC,MAAM,GAAG,IAAI,CAqBf;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,GAAG,MAAM,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,oBAAoB,GAChC,MAAM,EAAE,CAEV;AAkFD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,QAAQ,EAChB,YAAY,EAAE,oBAAoB,GAChC,cAAc,CAWhB"}

package/dist/tokens/resolver.js

@@ -0,0 +1,138 @@
+/**
+ * Token Resolver
+ *
+ * Resolves abstract token values to concrete output values based on
+ * detected terminal capabilities. This is the bridge between the
+ * semantic token system and the actual ANSI output.
+ */
+// ---------------------------------------------------------------------------
+// Individual Resolvers
+// ---------------------------------------------------------------------------
+/**
+ * Resolves a single color token value to a string (or null if color is disabled).
+ *
+ * - colorDepth 'none' -> null
+ * - colorDepth '16' -> the ansi16 name (e.g. 'red')
+ * - colorDepth '256' -> the ansi256 index as a string
+ * - colorDepth 'truecolor' -> the hex string
+ * - Attribute tokens ('dim', 'bold', 'default') pass through as-is.
+ *
+ * @param token - The color token value to resolve.
+ * @param capabilities - Detected terminal capabilities used to pick the right tier.
+ * @returns A string representation of the color, or null when color is disabled.
+ */
+export function resolveColor(token, capabilities) {
+    // Attribute-only tokens pass through regardless of color depth
+    if (token === "dim" || token === "bold" || token === "default") {
+        return token;
+    }
+    const depth = capabilities.colorDepth;
+    if (depth === "none") {
+        return null;
+    }
+    // After the attribute guard above, token is narrowed to ColorValue
+    switch (depth) {
+        case "16":
+            return token.ansi16;
+        case "256":
+            return String(token.ansi256);
+        case "truecolor":
+            return token.truecolor;
+    }
+}
+/**
+ * Resolves a symbol pair to the appropriate glyph based on unicode support.
+ *
+ * @param token - The symbol pair containing unicode and ascii variants.
+ * @param capabilities - Detected terminal capabilities.
+ * @returns The unicode or ascii glyph string.
+ */
+export function resolveSymbol(token, capabilities) {
+    return capabilities.unicode ? token.unicode : token.ascii;
+}
+/**
+ * Resolves a spinner definition to the appropriate frame array.
+ *
+ * @param token - The spinner definition containing unicode and ascii frame arrays.
+ * @param capabilities - Detected terminal capabilities.
+ * @returns The unicode or ascii frame array.
+ */
+export function resolveSpinner(token, capabilities) {
+    return capabilities.unicode ? token.unicode : token.ascii;
+}
+// ---------------------------------------------------------------------------
+// Full Token Set Resolver
+// ---------------------------------------------------------------------------
+function resolveColorTokens(colors, capabilities) {
+    const result = {};
+    for (const key of Object.keys(colors)) {
+        result[key] = resolveColor(colors[key], capabilities);
+    }
+    return result;
+}
+function resolveTypographyTokens(typography, colors, capabilities) {
+    const result = {};
+    for (const key of Object.keys(typography)) {
+        const style = typography[key];
+        const { color: colorRef, ...rest } = style;
+        const resolved = { ...rest };
+        if (colorRef !== undefined) {
+            resolved.color = resolveColor(colors[colorRef], capabilities);
+        }
+        result[key] = resolved;
+    }
+    return result;
+}
+function resolveSymbolTokens(symbols, capabilities) {
+    const result = {};
+    for (const key of Object.keys(symbols)) {
+        result[key] = resolveSymbol(symbols[key], capabilities);
+    }
+    return result;
+}
+function resolveBorderTokens(border, capabilities) {
+    // ASCII-only terminals force the ascii border style
+    const effectiveStyle = capabilities.unicode ? border.style : "ascii";
+    return {
+        style: effectiveStyle,
+        styles: border.styles,
+        chars: border.styles[effectiveStyle],
+    };
+}
+function resolveTreeTokens(tree, capabilities) {
+    return capabilities.unicode ? tree.unicode : tree.ascii;
+}
+function resolveMotionTokens(motion, capabilities) {
+    return {
+        spinnerDots: resolveSpinner(motion.spinnerDots, capabilities),
+        spinnerLine: resolveSpinner(motion.spinnerLine, capabilities),
+        spinnerArc: resolveSpinner(motion.spinnerArc, capabilities),
+        progressFilled: resolveSymbol(motion.progressFilled, capabilities),
+        progressPartial: resolveSymbol(motion.progressPartial, capabilities),
+        progressHead: resolveSymbol(motion.progressHead, capabilities),
+        spinnerInterval: motion.spinnerInterval,
+        progressInterval: motion.progressInterval,
+    };
+}
+/**
+ * Resolves an entire token set against the given terminal capabilities,
+ * producing a {@link ResolvedTokens} object where every value is a concrete
+ * output-ready value.
+ *
+ * @param tokens - The complete token set to resolve.
+ * @param capabilities - Detected terminal capabilities.
+ * @returns A fully resolved token set ready for use by components.
+ */
+export function resolveTokens(tokens, capabilities) {
+    return {
+        color: resolveColorTokens(tokens.color, capabilities),
+        type: resolveTypographyTokens(tokens.type, tokens.color, capabilities),
+        space: tokens.space,
+        layout: tokens.layout,
+        symbol: resolveSymbolTokens(tokens.symbol, capabilities),
+        border: resolveBorderTokens(tokens.border, capabilities),
+        tree: resolveTreeTokens(tokens.tree, capabilities),
+        motion: resolveMotionTokens(tokens.motion, capabilities),
+    };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/tokens/resolver.js.map

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

package/dist/tokens/types.d.ts

@@ -0,0 +1,265 @@
+/**
+ * Token Type Definitions
+ *
+ * All token types for the CLI Design System. Tokens are named for what they
+ * mean, never for what they look like. Every component references tokens
+ * by semantic role, and the token engine resolves them to concrete values
+ * based on terminal capabilities.
+ */
+/** Per-tier color values for capability-aware resolution. */
+export type ColorValue = {
+    /** Hex color string, e.g. '#f87171' */
+    truecolor: string;
+    /** 256-color palette index (0-255) */
+    ansi256: number;
+    /** ANSI 16 color name or attribute: 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'black' | 'dim' | 'bold' */
+    ansi16: string;
+};
+/**
+ * A color token value is either a full ColorValue with per-tier fallbacks,
+ * or a simple attribute string for tokens that represent styling rather
+ * than a specific hue.
+ */
+export type ColorTokenValue = ColorValue | "dim" | "bold" | "default";
+/** Semantic color roles used throughout the design system. */
+export type ColorTokens = {
+    /** Default foreground text */
+    fg: ColorTokenValue;
+    /** De-emphasized, secondary text */
+    fgMuted: ColorTokenValue;
+    /** Errors, failures, destructive actions */
+    error: ColorTokenValue;
+    /** Warnings, cautions, non-fatal issues */
+    warning: ColorTokenValue;
+    /** Success, completion, positive outcomes */
+    success: ColorTokenValue;
+    /** Informational, neutral highlights */
+    info: ColorTokenValue;
+    /** Interactive elements, links, focus states */
+    accent: ColorTokenValue;
+    /** High-importance text within a message */
+    emphasis: ColorTokenValue;
+    /** Inline code, commands, file paths, flags */
+    code: ColorTokenValue;
+    /** Section headers, titles */
+    heading: ColorTokenValue;
+    /** Error badge background */
+    bgError: ColorTokenValue;
+    /** Warning badge background */
+    bgWarning: ColorTokenValue;
+    /** Success badge background */
+    bgSuccess: ColorTokenValue;
+    /** Info badge background */
+    bgInfo: ColorTokenValue;
+    /** Selection highlight, search match */
+    bgHighlight: ColorTokenValue;
+    /** Added lines/content */
+    diffAdded: ColorTokenValue;
+    /** Removed lines/content */
+    diffRemoved: ColorTokenValue;
+    /** Unchanged context lines */
+    diffContext: ColorTokenValue;
+    /** Hunk headers */
+    diffHunk: ColorTokenValue;
+};
+/** A combination of ANSI text attributes and an optional color reference. */
+export type TypographyStyle = {
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    inverse?: boolean;
+    /** Reference to a color token by key name */
+    color?: keyof ColorTokens;
+};
+/** Semantic typography roles. */
+export type TypographyTokens = {
+    /** Key terms, important values, primary information */
+    emphasis: TypographyStyle;
+    /** Headings, critical labels */
+    strong: TypographyStyle;
+    /** Secondary info, timestamps, metadata, hints */
+    deEmphasis: TypographyStyle;
+    /** Inline code, commands, file paths, flag names */
+    code: TypographyStyle;
+    /** Clickable URLs */
+    link: TypographyStyle;
+    /** Removed or deprecated content */
+    deleted: TypographyStyle;
+    /** Top-level section headers */
+    heading1: TypographyStyle;
+    /** Sub-section headers */
+    heading2: TypographyStyle;
+    /** Minor section headers */
+    heading3: TypographyStyle;
+    /** Key in key-value pairs, column headers */
+    label: TypographyStyle;
+    /** Supplementary notes, help text */
+    caption: TypographyStyle;
+};
+/** Horizontal and vertical spacing measured in characters/lines. */
+export type SpacingTokens = {
+    /** Standard indentation per nesting level (characters) */
+    indent: number;
+    /** Wide indentation for code blocks, deep nesting (characters) */
+    indentLarge: number;
+    /** Gap between columns (characters) */
+    gutter: number;
+    /** Gap between major columns (characters) */
+    gutterLarge: number;
+    /** Inner padding inside boxes (characters) */
+    padding: number;
+    /** Generous inner padding (characters) */
+    paddingLarge: number;
+    /** Space between a status icon and its text (characters) */
+    iconGap: number;
+    /** Items within a dense group (blank lines) */
+    lineNone: number;
+    /** List items, table rows — no extra spacing (blank lines) */
+    lineCompact: number;
+    /** Between sections (blank lines) */
+    lineNormal: number;
+    /** Between major sections of output (blank lines) */
+    lineRelaxed: number;
+};
+/** Layout constraints for content width. */
+export type LayoutTokens = {
+    /** Maximum content width for readability */
+    maxWidth: number;
+    /** Minimum width before switching to compact mode */
+    minWidth: number;
+    /** Assumed width when detection fails */
+    defaultWidth: number;
+};
+/** A pair of glyphs: one for Unicode-capable terminals, one for ASCII-only. */
+export type SymbolPair = {
+    unicode: string;
+    ascii: string;
+};
+/** Semantic symbol tokens for status, navigation, structure, and interaction. */
+export type SymbolTokens = {
+    /** Operation succeeded */
+    success: SymbolPair;
+    /** Operation failed */
+    error: SymbolPair;
+    /** Warning condition */
+    warning: SymbolPair;
+    /** Informational notice */
+    info: SymbolPair;
+    /** Not yet started */
+    pending: SymbolPair;
+    /** In progress (static representation) */
+    running: SymbolPair;
+    /** Intentionally skipped */
+    skipped: SymbolPair;
+    /** Tip/suggestion indicator */
+    tip: SymbolPair;
+    /** Vertical bar for body content connectors */
+    bar: SymbolPair;
+    /** Points to, leads to */
+    arrowRight: SymbolPair;
+    /** Returns to, back */
+    arrowLeft: SymbolPair;
+    /** Upward, increase */
+    arrowUp: SymbolPair;
+    /** Downward, decrease */
+    arrowDown: SymbolPair;
+    /** Current selection, active item */
+    pointer: SymbolPair;
+    /** Nested indicator */
+    pointerSmall: SymbolPair;
+    /** List item */
+    bullet: SymbolPair;
+    /** Separator, range */
+    dash: SymbolPair;
+    /** Truncation, continuation */
+    ellipsis: SymbolPair;
+    /** Separator in inline lists */
+    middot: SymbolPair;
+    /** Selected radio option */
+    radioOn: SymbolPair;
+    /** Unselected radio option */
+    radioOff: SymbolPair;
+    /** Checked checkbox */
+    checkboxOn: SymbolPair;
+    /** Unchecked checkbox */
+    checkboxOff: SymbolPair;
+    /** Cursor position in select list */
+    cursor: SymbolPair;
+};
+/** A complete set of box-drawing characters for one border style. */
+export type BorderCharSet = {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    horizontal: string;
+    vertical: string;
+    teeRight: string;
+    teeLeft: string;
+    teeDown: string;
+    teeUp: string;
+    cross: string;
+};
+/** Named border styles shipped with the design system. */
+export type BorderStyleName = "rounded" | "single" | "double" | "heavy" | "dashed" | "ascii";
+/** Border tokens: a default style and all available style character sets. */
+export type BorderTokens = {
+    /** The default border style to use */
+    style: BorderStyleName;
+    /** All available border style character sets */
+    styles: Record<BorderStyleName, BorderCharSet>;
+};
+/** Characters for rendering tree structures. */
+export type TreeCharSet = {
+    /** Intermediate child connector */
+    branch: string;
+    /** Last child connector */
+    last: string;
+    /** Continuation line */
+    vertical: string;
+    /** Indent after last child */
+    indent: string;
+};
+/** Tree drawing tokens with Unicode and ASCII variants. */
+export type TreeTokens = {
+    unicode: TreeCharSet;
+    ascii: TreeCharSet;
+};
+/** Spinner animation frames with Unicode and ASCII variants. */
+export type SpinnerDefinition = {
+    unicode: string[];
+    ascii: string[];
+};
+/** Motion tokens for animated elements — spinners, progress bars, timing. */
+export type MotionTokens = {
+    /** Default spinner for indeterminate work */
+    spinnerDots: SpinnerDefinition;
+    /** Alternative minimal spinner */
+    spinnerLine: SpinnerDefinition;
+    /** Smooth circular spinner */
+    spinnerArc: SpinnerDefinition;
+    /** Completed portion of progress bar */
+    progressFilled: SymbolPair;
+    /** Remaining portion of progress bar */
+    progressPartial: SymbolPair;
+    /** Leading edge of progress bar */
+    progressHead: SymbolPair;
+    /** Frame interval for spinners (ms) */
+    spinnerInterval: number;
+    /** Update interval for progress bars (ms) */
+    progressInterval: number;
+};
+/** The complete set of all design tokens. */
+export type TokenSet = {
+    color: ColorTokens;
+    type: TypographyTokens;
+    space: SpacingTokens;
+    layout: LayoutTokens;
+    symbol: SymbolTokens;
+    border: BorderTokens;
+    tree: TreeTokens;
+    motion: MotionTokens;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tokens/types.d.ts.map

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

package/dist/tokens/types.js

@@ -0,0 +1,10 @@
+/**
+ * Token Type Definitions
+ *
+ * All token types for the CLI Design System. Tokens are named for what they
+ * mean, never for what they look like. Every component references tokens
+ * by semantic role, and the token engine resolves them to concrete values
+ * based on terminal capabilities.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tokens/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tokens/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/tokens.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Semantic tokens — map UI roles to palette values.
+ *
+ * These tokens define *what* a color means in the CLI context,
+ * not *what* color it is. Change the palette, and all tokens update.
+ */
+export declare const tokens: {
+    readonly success: "green";
+    readonly error: "red";
+    readonly warning: "yellow";
+    readonly info: "blue";
+    readonly tip: "#7FB3D5";
+    readonly muted: "gray";
+    readonly command: "#4EC9B0";
+    readonly danger: "#F67280";
+    readonly kit: "magenta";
+    readonly recipe: "cyan";
+    readonly cookbook: "magenta";
+    readonly highlight: "cyan";
+    readonly subtle: "gray";
+    readonly title: "cyan";
+    readonly heading: "yellow";
+    readonly version: "gray";
+    readonly path: "gray";
+};
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

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

package/dist/tokens.js

@@ -0,0 +1,30 @@
+/**
+ * Semantic tokens — map UI roles to palette values.
+ *
+ * These tokens define *what* a color means in the CLI context,
+ * not *what* color it is. Change the palette, and all tokens update.
+ */
+import { palette } from "./palette.js";
+export const tokens = {
+    // Status
+    success: palette.green,
+    error: palette.red,
+    warning: palette.yellow,
+    info: palette.blue,
+    tip: palette.tipBlue,
+    muted: palette.gray,
+    // CLI entities
+    command: palette.brand,
+    danger: palette.danger,
+    kit: palette.magenta,
+    recipe: palette.cyan,
+    cookbook: palette.magenta,
+    // Text roles
+    highlight: palette.cyan,
+    subtle: palette.gray,
+    title: palette.cyan,
+    heading: palette.yellow,
+    version: palette.gray,
+    path: palette.gray,
+};
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,SAAS;IACT,OAAO,EAAE,OAAO,CAAC,KAAK;IACtB,KAAK,EAAE,OAAO,CAAC,GAAG;IAClB,OAAO,EAAE,OAAO,CAAC,MAAM;IACvB,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,GAAG,EAAE,OAAO,CAAC,OAAO;IACpB,KAAK,EAAE,OAAO,CAAC,IAAI;IAEnB,eAAe;IACf,OAAO,EAAE,OAAO,CAAC,KAAK;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,GAAG,EAAE,OAAO,CAAC,OAAO;IACpB,MAAM,EAAE,OAAO,CAAC,IAAI;IACpB,QAAQ,EAAE,OAAO,CAAC,OAAO;IAEzB,aAAa;IACb,SAAS,EAAE,OAAO,CAAC,IAAI;IACvB,MAAM,EAAE,OAAO,CAAC,IAAI;IACpB,KAAK,EAAE,OAAO,CAAC,IAAI;IACnB,OAAO,EAAE,OAAO,CAAC,MAAM;IACvB,OAAO,EAAE,OAAO,CAAC,IAAI;IACrB,IAAI,EAAE,OAAO,CAAC,IAAI;CACT,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * cli-html type fixes.
+ *
+ * The published types in cli-html have incorrect HeadingStyle —
+ * they use `marker?: string` but the actual config uses `indicator: { marker, color }`.
+ * This module re-exports corrected types.
+ *
+ * Moved from core/src/logger/cli-html-types.ts.
+ */
+import type { Config as CliHtmlConfig, Theme as CliHtmlTheme } from "cli-html";
+export type { CliHtmlConfig, CliHtmlTheme };
+export interface HeadingStyle {
+    color?: string;
+    indicator?: {
+        marker?: string;
+        color?: string;
+    };
+}
+/**
+ * cli-html Theme with corrected heading types.
+ */
+export type Theme = Omit<CliHtmlTheme, "h1" | "h2" | "h3" | "h4" | "h5" | "h6"> & {
+    h1?: string | HeadingStyle;
+    h2?: string | HeadingStyle;
+    h3?: string | HeadingStyle;
+    h4?: string | HeadingStyle;
+    h5?: string | HeadingStyle;
+    h6?: string | HeadingStyle;
+};
+/**
+ * cli-html Config with corrected Theme type.
+ */
+export interface HelpThemeConfig {
+    theme?: Theme;
+    lineWidth?: CliHtmlConfig["lineWidth"];
+    asciiMode?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/E,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG;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;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * cli-html type fixes.
+ *
+ * The published types in cli-html have incorrect HeadingStyle —
+ * they use `marker?: string` but the actual config uses `indicator: { marker, color }`.
+ * This module re-exports corrected types.
+ *
+ * Moved from core/src/logger/cli-html-types.ts.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}