@elaraai/e3-ui-cli 1.0.71 → 1.0.73

package/dist/tui/render/layout.js.map

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

package/dist/tui/render/text.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Text measurement and formatting for one-line terminal rows.
+ *
+ * Every row the TUI renders is exactly one terminal line, so the layout
+ * math needs the CELL width of a string (not its code-unit length): the
+ * glyph set is single-width, but user data can carry wide (CJK, emoji) or
+ * zero-width (combining) characters. Byte sizes come from
+ * `formatSize` (`@elaraai/e3-cli/internal`) — one formatter across `e3`
+ * and `e3-ui`, not a third.
+ *
+ * @packageDocumentation
+ */
+export { formatSize } from '@elaraai/e3-cli/internal';
+/**
+ * The number of terminal cells `text` occupies.
+ *
+ * @param text - The text (no ANSI escapes)
+ * @returns Its cell width
+ */
+export declare function displayWidth(text: string): number;
+/**
+ * Truncates `text` to at most `width` cells, ending in `ellipsis` when cut.
+ *
+ * @param text - The text
+ * @param width - The cell budget
+ * @param ellipsis - The marker appended when truncated (default `…`)
+ * @returns The text, or a prefix of it plus the ellipsis, within `width`
+ */
+export declare function truncate(text: string, width: number, ellipsis?: string): string;
+/**
+ * Pads `text` on the right to exactly `width` cells, truncating when longer.
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The fitted text
+ */
+export declare function padEnd(text: string, width: number): string;
+/**
+ * Pads `text` on the left to exactly `width` cells, truncating when longer.
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The fitted text
+ */
+export declare function padStart(text: string, width: number): string;
+/**
+ * Centres `text` in `width` cells (the extra cell of an odd remainder goes
+ * to the right).
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The centred, fitted text
+ */
+export declare function center(text: string, width: number): string;
+/**
+ * Fits `text` to exactly `width` cells — padded on the right, or truncated
+ * with an ellipsis.
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The fitted text
+ */
+export declare function fit(text: string, width: number): string;
+/**
+ * A row with `left` at the start and `right` flush against the end, in
+ * `width` cells; the left part yields to the right one.
+ *
+ * @param left - The left text
+ * @param right - The right text
+ * @param width - The cell width
+ * @param gap - Minimum cells between the two (default 1)
+ * @returns The composed row
+ */
+export declare function lr(left: string, right: string, width: number, gap?: number): string;
+/**
+ * Formats an integer with thousands grouping (`1,240,000`).
+ *
+ * @param n - The integer
+ * @returns The grouped text
+ */
+export declare function formatInt(n: number | bigint): string;
+/**
+ * Formats a duration in milliseconds the way the dashboard reads it:
+ * `0.8s`, `38.4s`, `2m 5s`, `1h 02m`, `3d 4h`.
+ *
+ * @param ms - The duration in milliseconds
+ * @returns The formatted duration
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * How long ago `then` was, at whole-unit precision: `just now`, `12s ago`,
+ * `2m ago`, `3h ago`, `3d ago`, `12d ago`.
+ *
+ * @param then - The instant (a `Date`, ISO text, or epoch milliseconds)
+ * @param now - The current epoch milliseconds
+ * @returns The relative text (`—` for an unparsable instant)
+ */
+export declare function timeAgo(then: Date | string | number, now: number): string;
+/**
+ * How long ago `then` was, with one decimal under ten seconds (`0.4s ago`,
+ * `7.1s ago`, `12s ago`, `2m ago`) — the "polled … ago" hint.
+ *
+ * @param then - The instant in epoch milliseconds
+ * @param now - The current epoch milliseconds
+ * @returns The relative text
+ */
+export declare function agoShort(then: number, now: number): string;
+/**
+ * The first `n` characters of a hash (`9f3c1a7e2b41`).
+ *
+ * @param hash - The hash
+ * @param n - Characters kept (default 12, e3-cli's display width)
+ * @returns The prefix
+ */
+export declare function hashShort(hash: string, n?: number): string;
+/**
+ * A hash abbreviated at both ends (`4be1…a9`).
+ *
+ * @param hash - The hash
+ * @returns The abbreviation (short hashes are returned as is)
+ */
+export declare function hashMid(hash: string): string;
+/**
+ * A hash abbreviated to its first four characters plus an ellipsis (`0a44…`).
+ *
+ * @param hash - The hash
+ * @returns The abbreviation
+ */
+export declare function hashTiny(hash: string): string;
+/**
+ * Formats a UTC instant as `YYYY-MM-DD HH:MM:SS`.
+ *
+ * @param when - The instant (a `Date`, ISO text, or epoch milliseconds)
+ * @returns The formatted text (`—` when unparsable)
+ */
+export declare function formatStamp(when: Date | string | number): string;
+/**
+ * A percentage with two decimals (`0.97%`), for the value-tree footer.
+ *
+ * @param part - The numerator
+ * @param whole - The denominator
+ * @returns The percentage text (`0%` when `whole` is 0)
+ */
+export declare function percent(part: number, whole: number): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/tui/render/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/tui/render/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAoCtD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,CAM9E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAKpD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAWzE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAIhE;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/tui/render/text.js

@@ -0,0 +1,288 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Text measurement and formatting for one-line terminal rows.
+ *
+ * Every row the TUI renders is exactly one terminal line, so the layout
+ * math needs the CELL width of a string (not its code-unit length): the
+ * glyph set is single-width, but user data can carry wide (CJK, emoji) or
+ * zero-width (combining) characters. Byte sizes come from
+ * `formatSize` (`@elaraai/e3-cli/internal`) — one formatter across `e3`
+ * and `e3-ui`, not a third.
+ *
+ * @packageDocumentation
+ */
+export { formatSize } from '@elaraai/e3-cli/internal';
+const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+/** Whether a code point renders two cells wide (East Asian Wide / Fullwidth, emoji presentation). */
+function isWide(cp) {
+    return ((cp >= 0x1100 && cp <= 0x115f) ||
+        (cp >= 0x2e80 && cp <= 0x303e) ||
+        (cp >= 0x3041 && cp <= 0x33ff) ||
+        (cp >= 0x3400 && cp <= 0x4dbf) ||
+        (cp >= 0x4e00 && cp <= 0x9fff) ||
+        (cp >= 0xa000 && cp <= 0xa4cf) ||
+        (cp >= 0xac00 && cp <= 0xd7a3) ||
+        (cp >= 0xf900 && cp <= 0xfaff) ||
+        (cp >= 0xfe30 && cp <= 0xfe4f) ||
+        (cp >= 0xff00 && cp <= 0xff60) ||
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f300 && cp <= 0x1f64f) ||
+        (cp >= 0x1f900 && cp <= 0x1f9ff) ||
+        (cp >= 0x20000 && cp <= 0x3fffd));
+}
+/** Whether a code point occupies no cell (combining marks, ZWJ, variation selectors, controls). */
+function isZeroWidth(cp) {
+    return (cp < 0x20 ||
+        (cp >= 0x7f && cp < 0xa0) ||
+        (cp >= 0x300 && cp <= 0x36f) ||
+        (cp >= 0x200b && cp <= 0x200f) ||
+        (cp >= 0xfe00 && cp <= 0xfe0f) ||
+        cp === 0xfeff);
+}
+/**
+ * The number of terminal cells `text` occupies.
+ *
+ * @param text - The text (no ANSI escapes)
+ * @returns Its cell width
+ */
+export function displayWidth(text) {
+    let width = 0;
+    for (const { segment } of segmenter.segment(text)) {
+        const cp = segment.codePointAt(0);
+        if (cp === undefined || isZeroWidth(cp))
+            continue;
+        width += isWide(cp) ? 2 : 1;
+    }
+    return width;
+}
+/**
+ * Truncates `text` to at most `width` cells, ending in `ellipsis` when cut.
+ *
+ * @param text - The text
+ * @param width - The cell budget
+ * @param ellipsis - The marker appended when truncated (default `…`)
+ * @returns The text, or a prefix of it plus the ellipsis, within `width`
+ */
+export function truncate(text, width, ellipsis = '…') {
+    if (width <= 0)
+        return '';
+    if (displayWidth(text) <= width)
+        return text;
+    const ellipsisWidth = displayWidth(ellipsis);
+    const budget = width - ellipsisWidth;
+    if (budget <= 0)
+        return ellipsis.slice(0, width);
+    let out = '';
+    let used = 0;
+    for (const { segment } of segmenter.segment(text)) {
+        const w = displayWidth(segment);
+        if (used + w > budget)
+            break;
+        out += segment;
+        used += w;
+    }
+    return out + ellipsis;
+}
+/**
+ * Pads `text` on the right to exactly `width` cells, truncating when longer.
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The fitted text
+ */
+export function padEnd(text, width) {
+    const w = displayWidth(text);
+    if (w > width)
+        return truncate(text, width, '');
+    return text + ' '.repeat(width - w);
+}
+/**
+ * Pads `text` on the left to exactly `width` cells, truncating when longer.
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The fitted text
+ */
+export function padStart(text, width) {
+    const w = displayWidth(text);
+    if (w > width)
+        return truncate(text, width, '');
+    return ' '.repeat(width - w) + text;
+}
+/**
+ * Centres `text` in `width` cells (the extra cell of an odd remainder goes
+ * to the right).
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The centred, fitted text
+ */
+export function center(text, width) {
+    const w = displayWidth(text);
+    if (w >= width)
+        return truncate(text, width, '');
+    const left = Math.floor((width - w) / 2);
+    return ' '.repeat(left) + text + ' '.repeat(width - w - left);
+}
+/**
+ * Fits `text` to exactly `width` cells — padded on the right, or truncated
+ * with an ellipsis.
+ *
+ * @param text - The text
+ * @param width - The cell width
+ * @returns The fitted text
+ */
+export function fit(text, width) {
+    return padEnd(truncate(text, width), width);
+}
+/**
+ * A row with `left` at the start and `right` flush against the end, in
+ * `width` cells; the left part yields to the right one.
+ *
+ * @param left - The left text
+ * @param right - The right text
+ * @param width - The cell width
+ * @param gap - Minimum cells between the two (default 1)
+ * @returns The composed row
+ */
+export function lr(left, right, width, gap = 1) {
+    const rightWidth = displayWidth(right);
+    if (rightWidth >= width)
+        return truncate(right, width, '');
+    const leftBudget = width - rightWidth - gap;
+    const l = leftBudget > 0 ? truncate(left, leftBudget) : '';
+    return l + ' '.repeat(width - displayWidth(l) - rightWidth) + right;
+}
+/**
+ * Formats an integer with thousands grouping (`1,240,000`).
+ *
+ * @param n - The integer
+ * @returns The grouped text
+ */
+export function formatInt(n) {
+    const negative = typeof n === 'bigint' ? n < 0n : n < 0;
+    const digits = (typeof n === 'bigint' ? (negative ? -n : n) : Math.trunc(Math.abs(n))).toString();
+    const grouped = digits.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    return negative ? `-${grouped}` : grouped;
+}
+/**
+ * Formats a duration in milliseconds the way the dashboard reads it:
+ * `0.8s`, `38.4s`, `2m 5s`, `1h 02m`, `3d 4h`.
+ *
+ * @param ms - The duration in milliseconds
+ * @returns The formatted duration
+ */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return '—';
+    const seconds = ms / 1000;
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ${Math.round(seconds - minutes * 60)}s`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ${String(minutes - hours * 60).padStart(2, '0')}m`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ${hours - days * 24}h`;
+}
+/**
+ * How long ago `then` was, at whole-unit precision: `just now`, `12s ago`,
+ * `2m ago`, `3h ago`, `3d ago`, `12d ago`.
+ *
+ * @param then - The instant (a `Date`, ISO text, or epoch milliseconds)
+ * @param now - The current epoch milliseconds
+ * @returns The relative text (`—` for an unparsable instant)
+ */
+export function timeAgo(then, now) {
+    const t = typeof then === 'number' ? then : new Date(then).getTime();
+    if (!Number.isFinite(t))
+        return '—';
+    const seconds = Math.max(0, Math.round((now - t) / 1000));
+    if (seconds < 1)
+        return 'just now';
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}
+/**
+ * How long ago `then` was, with one decimal under ten seconds (`0.4s ago`,
+ * `7.1s ago`, `12s ago`, `2m ago`) — the "polled … ago" hint.
+ *
+ * @param then - The instant in epoch milliseconds
+ * @param now - The current epoch milliseconds
+ * @returns The relative text
+ */
+export function agoShort(then, now) {
+    const seconds = Math.max(0, (now - then) / 1000);
+    if (seconds < 10)
+        return `${seconds.toFixed(1)}s ago`;
+    return timeAgo(then, now);
+}
+/**
+ * The first `n` characters of a hash (`9f3c1a7e2b41`).
+ *
+ * @param hash - The hash
+ * @param n - Characters kept (default 12, e3-cli's display width)
+ * @returns The prefix
+ */
+export function hashShort(hash, n = 12) {
+    return hash.slice(0, n);
+}
+/**
+ * A hash abbreviated at both ends (`4be1…a9`).
+ *
+ * @param hash - The hash
+ * @returns The abbreviation (short hashes are returned as is)
+ */
+export function hashMid(hash) {
+    if (hash.length <= 8)
+        return hash;
+    return `${hash.slice(0, 4)}…${hash.slice(-2)}`;
+}
+/**
+ * A hash abbreviated to its first four characters plus an ellipsis (`0a44…`).
+ *
+ * @param hash - The hash
+ * @returns The abbreviation
+ */
+export function hashTiny(hash) {
+    if (hash.length <= 4)
+        return hash;
+    return `${hash.slice(0, 4)}…`;
+}
+/**
+ * Formats a UTC instant as `YYYY-MM-DD HH:MM:SS`.
+ *
+ * @param when - The instant (a `Date`, ISO text, or epoch milliseconds)
+ * @returns The formatted text (`—` when unparsable)
+ */
+export function formatStamp(when) {
+    const d = when instanceof Date ? when : new Date(when);
+    if (!Number.isFinite(d.getTime()))
+        return '—';
+    return d.toISOString().replace('T', ' ').slice(0, 19);
+}
+/**
+ * A percentage with two decimals (`0.97%`), for the value-tree footer.
+ *
+ * @param part - The numerator
+ * @param whole - The denominator
+ * @returns The percentage text (`0%` when `whole` is 0)
+ */
+export function percent(part, whole) {
+    if (whole <= 0)
+        return '0%';
+    return `${((part / whole) * 100).toFixed(2)}%`;
+}
+//# sourceMappingURL=text.js.map

package/dist/tui/render/text.js.map

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

package/dist/tui/render/theme.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Colour: the design system's semantic tokens mapped onto what the
+ * terminal can show.
+ *
+ * `process.stdout.getColorDepth()` selects truecolor / 256 / 16 colours;
+ * `NO_COLOR` forces monochrome (bold / dim / inverse only) and
+ * `FORCE_COLOR` overrides detection, the way chalk reads them. The tokens
+ * follow `libs/east-ui/app_design_system`: ink is the default foreground,
+ * ink-4 is dim, brand (`#488e97`) marks the selection bar and the active
+ * tab, pos / neg / warn / info colour status dots — "status is a dot + word,
+ * never a tinted badge".
+ *
+ * @packageDocumentation
+ */
+/** The colour capability: 0 monochrome, 1 sixteen colours, 2 256 colours, 3 truecolor. */
+export type ColorLevel = 0 | 1 | 2 | 3;
+/** A stream that may report its colour depth (`process.stdout`). */
+export interface ColorStream {
+    isTTY?: boolean | undefined;
+    getColorDepth?: ((env?: NodeJS.ProcessEnv) => number) | undefined;
+}
+/**
+ * Detects the colour level of `stream` under `env`.
+ *
+ * @param env - The environment (`NO_COLOR`, `FORCE_COLOR`, `TERM`, `COLORTERM`)
+ * @param stream - The output stream
+ * @returns The level — `NO_COLOR` (non-empty) wins, then `FORCE_COLOR`
+ *   (`0`–`3`, or any other value meaning 16 colours), then the stream's
+ *   `getColorDepth()` (1 → 0, 4 → 1, 8 → 2, 24 → 3), then `COLORTERM` /
+ *   `TERM` hints, else monochrome
+ */
+export declare function detectColorLevel(env: NodeJS.ProcessEnv, stream: ColorStream): ColorLevel;
+/**
+ * The semantic colour tokens as Ink colour strings (`#hex`, `ansi256(n)`,
+ * or a chalk colour name), or `undefined` when a token falls back to the
+ * terminal default in the current level.
+ *
+ * @property level - The colour level the theme was built for
+ * @property ink - Primary text (always the terminal default)
+ * @property ink2 - Secondary text
+ * @property ink3 - Tertiary text
+ * @property ink4 - Muted text (rendered dim)
+ * @property brand - Selection bar, active tab, the prompt
+ * @property brandTint - The brand's tint, for a filled highlight
+ * @property pos - Positive status (complete, up-to-date, connected)
+ * @property neg - Negative status (failed, error, offline)
+ * @property warn - Warning status (waiting, stale, reconnecting)
+ * @property info - Informational status (running, in progress)
+ * @property rule - Rules and scrollbar tracks
+ */
+export interface Theme {
+    level: ColorLevel;
+    ink: string | undefined;
+    ink2: string | undefined;
+    ink3: string | undefined;
+    ink4: string | undefined;
+    brand: string | undefined;
+    brandTint: string | undefined;
+    pos: string | undefined;
+    neg: string | undefined;
+    warn: string | undefined;
+    info: string | undefined;
+    rule: string | undefined;
+}
+/**
+ * Builds the theme for a colour level.
+ *
+ * @param level - The colour level
+ * @returns The theme — truecolor hex at 3, `ansi256(n)` at 2, the sixteen
+ *   colour names at 1, and every token `undefined` at 0 (bold / dim /
+ *   inverse carry the meaning)
+ */
+export declare function createTheme(level: ColorLevel): Theme;
+/** The tone a status word or dot carries. */
+export type Tone = 'pos' | 'neg' | 'warn' | 'info' | 'muted' | 'brand' | 'plain';
+/**
+ * The theme colour of a tone (`undefined` = the terminal default).
+ *
+ * @param theme - The theme
+ * @param tone - The tone
+ * @returns The Ink colour string, if any
+ */
+export declare function toneColor(theme: Theme, tone: Tone): string | undefined;
+//# sourceMappingURL=theme.d.ts.map

package/dist/tui/render/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tui/render/theme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,0FAA0F;AAC1F,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvC,oEAAoE;AACpE,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CACrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,CA0BxF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,KAAK;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CA+DpD;AAED,6CAA6C;AAC7C,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAUtE"}