@slkiser/opencode-quota 5.0.3 → 6.0.0-beta.1

package/dist/view/usage.js

@@ -0,0 +1,724 @@
+import { usageRangeLabel } from "../core/usage-ranges.js";
+import { getQuotaProviderDisplayLabel } from "../lib/provider-metadata.js";
+import { columnsOf, padEndColumns, padStartColumns, sliceColumns, truncateColumns, } from "./columns.js";
+import { cacheHit, formatShare, formatTokens, formatUsd, LOW_CACHE_MARK, } from "./format.js";
+/** The chart sits beside the total and the providers, like T3's page, when it gets this much. */
+const BESIDE_CHART_MIN_WIDTH = 32;
+/** The total and the provider list never get wider than this, so their numbers stay close. */
+const LIST_MAX_WIDTH = 48;
+const COLUMN_GAP = 3;
+/** Between the total and providers on the left and the chart on the right. */
+const SIDE_GAP = 4;
+/** Narrower views are laid out at this width and then cut. */
+const LAYOUT_MIN_WIDTH = 32;
+/** Under the providers the chart has this many rows; beside them, at least this many. */
+const CHART_ROWS = 6;
+const DETAIL_CHART_ROWS = 5;
+/** A day's column is at most this wide, so a short range does not draw a few huge blocks. */
+const CHART_COLUMN_MAX = 16;
+/** From this many cells, a chart column leaves its last cell empty, so the days stand apart. */
+const CHART_GAP_FROM = 3;
+/** One to eight eighths of a chart cell. */
+const BLOCKS = "▁▂▃▄▅▆▇█";
+/** The "by type" bar and its legend stay short, like T3's, on a wide view. */
+const BY_TYPE_MAX_WIDTH = 64;
+/** The provider color mark, before a provider and its models. */
+const DOT = "● ";
+const TEXT_MAX_WIDTH = 64;
+const TEXT_BREAKDOWN_ROWS = 10;
+/** The TUI's "by type" bar and its legend marks: a thin line, its parts told apart by color. */
+const THIN_BAR = "━";
+const THIN_MARK = "━━";
+/** A breakdown row's bar needs this much room, else the row has none. */
+const ROW_BAR_MIN_WIDTH = 8;
+/** The breakdown's names get at most this wide when the rows have bars. */
+const ROW_NAME_MAX_WIDTH = 40;
+/** At the end of each model row in the TUI: enter or a click opens the model's details. */
+const OPEN_MARK = " ▸";
+const CACHE_HEADER = "Cache";
+/** A model's Cache cell without input tokens or cache numbers. */
+const NO_CACHE_HIT = "—";
+/** The model breakdown drops its Cache column before its names get narrower than this. */
+const CACHE_NAME_MIN_WIDTH = 8;
+/** Shade marks, one per part, so the "by type" bar also reads without colors. */
+const PART_MARKS = {
+    input: "▒",
+    cacheRead: "░",
+    cacheWrite: "▓",
+    output: "█",
+};
+const PART_LABELS = {
+    input: "Input",
+    cacheRead: "Cache read",
+    cacheWrite: "Cache write",
+    output: "Output",
+};
+const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+function span(text, role) {
+    return { text, role };
+}
+function lineWidth(line) {
+    return line.reduce((sum, part) => sum + columnsOf(part.text), 0);
+}
+/** `line` cut to `width` columns: the last guard that keeps every line inside the view. */
+function clip(line, width) {
+    const clipped = [];
+    let room = width;
+    for (const part of line) {
+        const text = sliceColumns(part.text, Math.max(0, room));
+        if (text)
+            clipped.push({ ...part, text });
+        room -= columnsOf(text);
+    }
+    return clipped;
+}
+function plural(count, word) {
+    return `${count} ${count === 1 ? word : `${word}s`}`;
+}
+/** A row's cost, or "no price" when all its tokens come from models without a price. */
+export function costText(row) {
+    return row.tokens > 0 && row.unpricedTokens >= row.tokens ? "no price" : formatUsd(row.costUsd);
+}
+/** "Sep 11", or "Sep 11, 2025" outside `thisYear`. */
+function shortDate(date, thisYear) {
+    const text = `${MONTHS[date.getMonth()]} ${date.getDate()}`;
+    return date.getFullYear() === thisYear ? text : `${text}, ${date.getFullYear()}`;
+}
+/** The local midnight of a report day like "2026-09-11". */
+function dayDate(day) {
+    const [year, month, date] = day.split("-").map(Number);
+    return new Date(year, month - 1, date);
+}
+/**
+ * The days a report covers, like "Oct 7 – Oct 13", or one day like "Oct 13"; undefined for
+ * "all" and "session", which have no time window.
+ */
+export function rangeDates(report) {
+    if (report.sinceMs === undefined || report.untilMs === undefined)
+        return undefined;
+    const thisYear = new Date(report.generatedAtMs).getFullYear();
+    const first = shortDate(new Date(report.sinceMs), thisYear);
+    const last = shortDate(new Date(report.untilMs), thisYear);
+    return first === last ? first : `${first} – ${last}`;
+}
+function rangeTitle(report) {
+    if (report.range !== "between" || report.sinceMs === undefined || report.untilMs === undefined) {
+        return usageRangeLabel(report.range);
+    }
+    const thisYear = new Date(report.generatedAtMs).getFullYear();
+    return `${shortDate(new Date(report.sinceMs), thisYear)} to ${shortDate(new Date(report.untilMs), thisYear)}`;
+}
+/** The report's rows in the mode's order: the report's own (most cost first), or most tokens. */
+function inModeOrder(rows, mode) {
+    return mode === "cost" ? rows : [...rows].sort((a, b) => b.tokens - a.tokens);
+}
+function providerRole(report, providerID) {
+    const index = report.providers.findIndex((row) => row.providerID === providerID);
+    return index < 0 ? "muted" : `provider:${index}`;
+}
+/** The total on one line, or two when it does not fit. */
+function totalLines(view, width) {
+    const { totals } = view.report;
+    const sessions = plural(totals.sessions, "session");
+    const title = view.mode === "cost"
+        ? span(formatUsd(totals.costUsd), "title")
+        : span(`${formatTokens(totals.tokens.processed)} tokens`, "title");
+    const detail = view.mode === "cost"
+        ? `${sessions} · API estimate`
+        : `${sessions} · ${formatUsd(totals.costUsd)} API estimate`;
+    const fits = columnsOf(title.text) + 2 + columnsOf(detail) <= width;
+    return fits ? [[title, span(`  ${detail}`, "muted")]] : [[title], [span(detail, "muted")]];
+}
+/** "Unpriced tokens excluded: 4.0% (exo-free)", when any tokens have no price. */
+function unpricedLines(view, width) {
+    const { totals, models } = view.report;
+    if (totals.unpricedShare <= 0)
+        return [];
+    const label = "Unpriced tokens excluded: ";
+    const share = formatShare(totals.unpricedShare);
+    const names = models.filter((row) => !row.priced && row.tokens > 0).map((row) => row.modelID);
+    const shown = names.length > 3
+        ? `${names.slice(0, 3).join(", ")} +${names.length - 3} more`
+        : names.join(", ");
+    const room = width - columnsOf(label) - columnsOf(share) - " ()".length;
+    const line = [span(label, "muted"), span(share, "warning")];
+    if (shown && room >= 2)
+        line.push(span(` (${truncateColumns(shown, room)})`, "muted"));
+    return [line];
+}
+const METRIC_HEADERS = { cost: "Cost", share: "Share", tokens: "Tokens" };
+/** A table's number columns: the mode's amount, its share, then the other amount. */
+function metricsOf(mode) {
+    return mode === "cost" ? ["cost", "share", "tokens"] : ["tokens", "share", "cost"];
+}
+function metricText(view, metric, row) {
+    if (metric === "cost")
+        return costText(row);
+    if (metric === "tokens")
+        return formatTokens(row.tokens);
+    return formatShare(view.mode === "cost" ? row.costShare : row.tokenShare);
+}
+function metricRole(view, metric, text) {
+    if (metric === "share" || text === "no price")
+        return "muted";
+    return metric === view.mode ? "value" : "text";
+}
+/** Each metric column's width: its header or its widest number. */
+function metricWidths(view, metrics, rows) {
+    return metrics.map((metric) => Math.max(columnsOf(METRIC_HEADERS[metric]), ...rows.map((row) => columnsOf(metricText(view, metric, row)))));
+}
+/** The metric cells of one table line: right-aligned, two spaces before each. */
+function metricSpans(view, metrics, widths, row) {
+    return metrics.map((metric, index) => {
+        if (!row)
+            return span(`  ${padStartColumns(METRIC_HEADERS[metric], widths[index])}`, "muted");
+        const text = metricText(view, metric, row);
+        return span(`  ${padStartColumns(text, widths[index])}`, metricRole(view, metric, text));
+    });
+}
+/**
+ * The providers as a table under a header: name, the mode's amount, its share and the other
+ * amount. A narrow list drops the other amount, then the share, before names get short.
+ */
+function providerLines(view, width) {
+    const rows = inModeOrder(view.report.providers, view.mode);
+    const names = rows.map((row) => getQuotaProviderDisplayLabel(row.providerID));
+    const nameWidest = Math.max(columnsOf("Provider") - columnsOf(DOT), ...names.map(columnsOf));
+    let metrics = metricsOf(view.mode);
+    let widths = metricWidths(view, metrics, rows);
+    const room = () => width - columnsOf(DOT) - widths.reduce((sum, item) => sum + item + 2, 0);
+    while (metrics.length > 1 && room() < Math.min(nameWidest, 8)) {
+        metrics = metrics.slice(0, -1);
+        widths = widths.slice(0, -1);
+    }
+    const nameWidth = Math.max(1, Math.min(nameWidest, room()));
+    return [
+        [
+            span(padEndColumns("Provider", columnsOf(DOT) + nameWidth), "muted"),
+            ...metricSpans(view, metrics, widths, undefined),
+        ],
+        ...rows.map((row, index) => [
+            span(DOT, providerRole(view.report, row.providerID)),
+            span(padEndColumns(truncateColumns(names[index], nameWidth), nameWidth), "text"),
+            ...metricSpans(view, metrics, widths, row),
+        ]),
+    ];
+}
+/** "Sep 11 … Sep 26 … Oct 10" under the chart: first, middle (when it fits) and last day. */
+function dateAxis(columns, columnStart, chartWidth, thisYear) {
+    const first = shortDate(dayDate(columns[0].first), thisYear);
+    const last = shortDate(dayDate(columns[columns.length - 1].last), thisYear);
+    const lastAt = chartWidth - columnsOf(last);
+    if (lastAt < columnsOf(first) + 2)
+        return truncateColumns(first, chartWidth);
+    const middleIndex = Math.floor(columns.length / 2);
+    const middle = shortDate(dayDate(columns[middleIndex].first), thisYear);
+    const middleCenter = (columnStart(middleIndex) + columnStart(middleIndex + 1)) / 2;
+    const middleAt = Math.round(middleCenter - columnsOf(middle) / 2);
+    const middleFits = middleAt >= columnsOf(first) + 2 && middleAt + columnsOf(middle) + 2 <= lastAt;
+    const axis = columns.length >= 3 && middleFits ? padEndColumns(first, middleAt) + middle : first;
+    return padEndColumns(axis, lastAt) + last;
+}
+/**
+ * `days` in at most `plotWidth` columns: one day per column, or the same number of days per
+ * column (the last may hold fewer) when the days do not fit.
+ */
+function chartColumns(days, plotWidth) {
+    const daysPerColumn = Math.ceil(days.length / Math.max(1, plotWidth));
+    const columns = [];
+    for (let index = 0; index < days.length; index += daysPerColumn) {
+        const group = days.slice(index, index + daysPerColumn);
+        columns.push({
+            first: group[0].date,
+            last: group[group.length - 1].date,
+            amount: group.reduce((sum, day) => sum + day.amount, 0),
+            parts: group[0].parts.map((_, part) => group.reduce((sum, day) => sum + day.parts[part], 0)),
+        });
+    }
+    return { columns, daysPerColumn, max: Math.max(...columns.map((column) => column.amount)) };
+}
+/**
+ * The report's days with the mode's amount: all of them, or one model's (0 on its other days),
+ * each split by provider from the models' days.
+ */
+function chartDays(report, mode, model) {
+    const amountOf = (row) => mode === "cost" ? row.costUsd : row.tokens;
+    const parts = new Map(report.days.map((day) => [day.date, report.providers.map(() => 0)]));
+    for (const row of model ? [model] : report.models) {
+        const provider = report.providers.findIndex((item) => item.providerID === row.providerID);
+        if (provider < 0)
+            continue;
+        for (const day of row.days) {
+            const dayParts = parts.get(day.date);
+            if (dayParts)
+                dayParts[provider] += amountOf(day);
+        }
+    }
+    const modelDays = new Map(model?.days.map((day) => [day.date, amountOf(day)]));
+    return report.days.map((day) => ({
+        date: day.date,
+        amount: model ? (modelDays.get(day.date) ?? 0) : amountOf(day),
+        parts: parts.get(day.date) ?? [],
+    }));
+}
+/** `column` as a stack `height` eighths tall, its parts in proportion to their amounts. */
+function chartStack(column, height) {
+    const known = column.parts.reduce((sum, part) => sum + part, 0);
+    const amounts = [...column.parts, Math.max(0, column.amount - known)];
+    const total = known + amounts[amounts.length - 1];
+    let below = 0;
+    const segments = amounts.map((amount, index) => {
+        below += amount;
+        const role = index < column.parts.length ? `provider:${index}` : "bar";
+        const top = index === amounts.length - 1 ? height : Math.round((below / total) * height);
+        return { role, top: Math.min(height, top) };
+    });
+    return { height, segments };
+}
+/**
+ * The cell of `stack` that starts `bottom` eighths up. A cell has two colors: a block where one
+ * part ends inside a full cell is that part's color, and above it is the color of the part with
+ * the most of the rest of the cell. Where the column ends inside the cell, the part with the
+ * most of the cell colors its block.
+ */
+function chartCell(stack, bottom) {
+    const fill = Math.min(8, Math.max(0, stack.height - bottom));
+    if (fill === 0)
+        return span(" ", "muted");
+    const inCell = [];
+    stack.segments.forEach((segment, index) => {
+        const start = Math.max(index === 0 ? 0 : stack.segments[index - 1].top, bottom);
+        const size = Math.min(segment.top, bottom + fill) - start;
+        if (size > 0)
+            inCell.push({ role: segment.role, size });
+    });
+    const lower = inCell[0];
+    if (inCell.length === 1)
+        return span(BLOCKS[fill - 1], lower.role);
+    if (fill < 8) {
+        const most = inCell.reduce((largest, part) => (part.size > largest.size ? part : largest));
+        return span(BLOCKS[fill - 1], most.role);
+    }
+    const upper = inCell
+        .slice(1)
+        .reduce((largest, part) => (part.size > largest.size ? part : largest));
+    return { text: BLOCKS[lower.size - 1], role: lower.role, back: upper.role };
+}
+/** Adds `part` to `line`, joined with the last span when both color the same way. */
+function pushSpan(line, part) {
+    const last = line[line.length - 1];
+    if (last && last.role === part.role && last.back === part.back)
+        last.text += part.text;
+    else
+        line.push(part);
+}
+/**
+ * The daily chart: a title, `rows` rows of block characters (one column per day, or per few
+ * days when the days do not fit) with the top value on the left, a baseline with 0, and a date
+ * axis. Each column stacks its providers, the first (most cost) at the bottom, in their colors.
+ * Columns of 3 cells or more keep their last cell empty, so the days stand apart.
+ * Nothing when the range has fewer than two days or nothing to draw.
+ */
+function chartLines(days, mode, thisYear, width, rows) {
+    const formatAmount = mode === "cost" ? formatUsd : formatTokens;
+    if (days.length < 2 || days.every((day) => day.amount <= 0))
+        return [];
+    // The label column decides the room for the columns, and the columns decide the top value:
+    // start at the width of "0" and widen the label column until the top value fits in it.
+    let labelWidth = 1;
+    let grouping = chartColumns(days, width - labelWidth - 1);
+    while (columnsOf(formatAmount(grouping.max)) > labelWidth) {
+        labelWidth = columnsOf(formatAmount(grouping.max));
+        grouping = chartColumns(days, width - labelWidth - 1);
+    }
+    const { columns, daysPerColumn, max } = grouping;
+    // `columns` were grouped for this plot width, so every column gets at least one cell.
+    const plotWidth = Math.max(1, width - labelWidth - 1);
+    const chartWidth = Math.min(plotWidth, columns.length * CHART_COLUMN_MAX);
+    // Column `index` covers [columnStart(index), columnStart(index + 1)): widths differ by one at most.
+    const columnStart = (index) => Math.floor((index * chartWidth) / columns.length);
+    const gap = Math.floor(chartWidth / columns.length) >= CHART_GAP_FROM;
+    // Each column's height in eighths of a row (a day above 0 always shows), split by provider.
+    const stacks = columns.map((column) => chartStack(column, column.amount <= 0 ? 0 : Math.max(1, Math.round((column.amount / max) * rows * 8))));
+    const [daily, amount] = mode === "cost" ? ["Daily cost", "Cost"] : ["Daily tokens", "Tokens"];
+    const title = daysPerColumn === 1 ? daily : `${amount} per ${daysPerColumn} days`;
+    const lines = [[span(title, "heading")]];
+    for (let row = 0; row < rows; row += 1) {
+        const below = (rows - 1 - row) * 8;
+        const label = row === 0 ? formatAmount(max) : "";
+        const cells = [];
+        stacks.forEach((stack, index) => {
+            const cell = chartCell(stack, below);
+            const width = columnStart(index + 1) - columnStart(index);
+            pushSpan(cells, { ...cell, text: cell.text.repeat(gap ? width - 1 : width) });
+            if (gap)
+                pushSpan(cells, span(" ", "muted"));
+        });
+        lines.push([span(`${padStartColumns(label, labelWidth)} `, "muted"), ...cells]);
+    }
+    lines.push([
+        span(`${padStartColumns("0", labelWidth)} `, "muted"),
+        span("─".repeat(chartWidth), "muted"),
+    ]);
+    const axis = dateAxis(columns, columnStart, chartWidth, thisYear);
+    lines.push([span(`${" ".repeat(labelWidth + 1)}${axis}`, "muted")]);
+    return lines;
+}
+/** Label-over-value cells in as few rows as fit in `width`, the rows evenly filled. */
+function grid(items, width) {
+    const cellMin = Math.max(...items.flatMap(([label, value]) => [columnsOf(label), columnsOf(value)])) + 2;
+    const rows = Math.ceil(items.length / Math.max(1, Math.floor(width / cellMin)));
+    const perRow = Math.ceil(items.length / rows);
+    const cellWidth = Math.floor(width / perRow);
+    const lines = [];
+    for (let index = 0; index < items.length; index += perRow) {
+        const row = items.slice(index, index + perRow);
+        lines.push(row.map(([label]) => span(padEndColumns(label, cellWidth), "muted")));
+        lines.push(row.map(([, value]) => span(padEndColumns(value, cellWidth), "value")));
+    }
+    return lines;
+}
+function totalsLines(view, width) {
+    const { tokens, cacheSavingsUsd } = view.report.totals;
+    return [
+        [span("Totals", "heading")],
+        ...grid([
+            ["Processed tokens", formatTokens(tokens.processed)],
+            ["Cached input", formatTokens(tokens.cachedInput)],
+            ["Uncached input", formatTokens(tokens.uncachedInput)],
+            ["Output", formatTokens(tokens.output)],
+            ["Cache savings", formatUsd(cacheSavingsUsd)],
+        ], width),
+    ];
+}
+/**
+ * `width` cells split in proportion to `amounts` (largest remainder); a part above 0 gets at
+ * least one cell, taken from the widest part.
+ */
+function splitWidth(amounts, width) {
+    const total = amounts.reduce((sum, amount) => sum + amount, 0);
+    const exact = amounts.map((amount) => (amount / total) * width);
+    const cells = exact.map(Math.floor);
+    let left = width - cells.reduce((sum, count) => sum + count, 0);
+    const byRemainder = amounts
+        .map((_, index) => index)
+        .sort((a, b) => exact[b] - cells[b] - (exact[a] - cells[a]));
+    for (const index of byRemainder) {
+        if (left <= 0)
+            break;
+        cells[index] += 1;
+        left -= 1;
+    }
+    amounts.forEach((amount, index) => {
+        const widest = cells.indexOf(Math.max(...cells));
+        if (amount > 0 && cells[index] === 0 && cells[widest] > 1) {
+            cells[widest] -= 1;
+            cells[index] = 1;
+        }
+    });
+    return cells;
+}
+/**
+ * One stacked bar and its legend: cost by type, or tokens by type. Text gets a bar of shade
+ * marks of at most 64 columns; `colored` (the TUI) a thin line as wide as `width`, a space
+ * between its parts.
+ */
+function byTypeLines(kind, amounts, width, colored) {
+    const barWidth = colored ? width : Math.min(width, BY_TYPE_MAX_WIDTH);
+    const parts = ["input", "cacheRead", "cacheWrite", "output"].map((part) => ({
+        part,
+        amount: amounts[part],
+    }));
+    if (parts.every((part) => part.amount <= 0))
+        return [];
+    const shown = parts.filter((part) => part.amount > 0).length;
+    const gaps = colored ? shown - 1 : 0;
+    const cells = splitWidth(parts.map((part) => part.amount), barWidth - gaps);
+    const bar = [];
+    parts.forEach((part, index) => {
+        if (cells[index] === 0)
+            return;
+        if (colored && bar.length > 0)
+            bar.push(span(" ", "muted"));
+        const mark = colored ? THIN_BAR : PART_MARKS[part.part];
+        bar.push(span(mark.repeat(cells[index]), `part:${part.part}`));
+    });
+    const legend = [];
+    for (const part of parts) {
+        const amount = kind === "cost" ? formatUsd(part.amount) : formatTokens(part.amount);
+        const item = [
+            span(colored ? THIN_MARK : PART_MARKS[part.part], `part:${part.part}`),
+            span(` ${PART_LABELS[part.part]} `, "muted"),
+            span(amount, "value"),
+        ];
+        const current = legend[legend.length - 1];
+        if (current && lineWidth(current) + 3 + lineWidth(item) <= barWidth) {
+            current.push(span("   ", "muted"), ...item);
+        }
+        else {
+            legend.push(item);
+        }
+    }
+    const title = kind === "cost" ? "Cost by type" : "Tokens by type";
+    return [[span(title, "heading")], bar, ...legend];
+}
+function breakdownEntries(view) {
+    const { report } = view;
+    if (view.breakdown === "day") {
+        return report.days
+            .filter((row) => row.tokens > 0)
+            .reverse()
+            .map((row) => {
+            const date = dayDate(row.date);
+            return {
+                name: `${WEEKDAYS[date.getDay()]}, ${shortDate(date, view.thisYear)}`,
+                dot: undefined,
+                row,
+            };
+        });
+    }
+    return breakdownModels(report, view.mode).map((row) => ({
+        name: modelName(report, row),
+        dot: providerRole(report, row.providerID),
+        row,
+        cache: cacheHit(row.tokensByType),
+    }));
+}
+/** A model's id, with its provider when more than one provider serves that id. */
+function modelName(report, model) {
+    const providers = report.models.filter((row) => row.modelID === model.modelID).length;
+    return providers > 1 ? `${model.providerID}/${model.modelID}` : model.modelID;
+}
+/**
+ * The models of the model breakdown, in its order. In `usageView` with the model breakdown,
+ * these models' rows follow the Breakdown heading and its column names, one each, in this order.
+ */
+export function breakdownModels(report, mode) {
+    return inModeOrder(report.models.filter((row) => row.tokens > 0), mode);
+}
+/**
+ * The model breakdown's Cache column: each model's cache hit, right-aligned under "Cache", in
+ * the good color, or the warning color with " ⚠" after it when it is low, or muted before 200K
+ * input tokens; "—" without one.
+ */
+function cacheColumn(shown) {
+    const texts = shown.map((entry) => entry.cache?.text ?? NO_CACHE_HIT);
+    const percentWidth = Math.max(columnsOf(CACHE_HEADER), ...texts.map(columnsOf));
+    const lowAfter = ` ${LOW_CACHE_MARK}`;
+    const hang = shown.some((entry) => entry.cache?.low) ? columnsOf(lowAfter) : 0;
+    const spans = (entry) => {
+        if (!entry) {
+            const header = `  ${padStartColumns(CACHE_HEADER, percentWidth)}${" ".repeat(hang)}`;
+            return [span(header, "muted")];
+        }
+        const { cache } = entry;
+        let role = "muted";
+        if (cache?.judged)
+            role = cache.low ? "warning" : "good";
+        const cell = span(`  ${padStartColumns(cache?.text ?? NO_CACHE_HIT, percentWidth)}`, role);
+        if (hang === 0)
+            return [cell];
+        return [cell, cache?.low ? span(lowAfter, "warning") : span(" ".repeat(hang), "muted")];
+    };
+    return { width: 2 + percentWidth + hang, spans };
+}
+/**
+ * The breakdown table: #, Model or Day, then the mode's amount, Share and the other amount, and
+ * for models their cache hit (`cacheColumn`) while the names keep 8 columns or their full width.
+ * `colored` (the TUI) puts a bar of each row's amount between the names and the numbers, the
+ * biggest row's bar full, when there is room for it, and ends each model row with ▸.
+ */
+function breakdownLines(view, fullWidth, maxRows, colored) {
+    const mark = colored && view.breakdown === "model" ? OPEN_MARK : "";
+    const width = fullWidth - columnsOf(mark);
+    const entries = breakdownEntries(view);
+    const shown = entries.slice(0, maxRows);
+    const metrics = metricsOf(view.mode);
+    const widths = metricWidths(view, metrics, shown.map((entry) => entry.row));
+    const numberWidth = String(shown.length).length;
+    const dotWidth = view.breakdown === "model" ? columnsOf(DOT) : 0;
+    const metricsWidth = widths.reduce((sum, metricWidth) => sum + metricWidth + 2, 0);
+    const nameWidest = Math.min(ROW_NAME_MAX_WIDTH, Math.max(4, ...shown.map((entry) => columnsOf(entry.name))));
+    const withoutCache = numberWidth + 2 + dotWidth + metricsWidth;
+    const cache = cacheColumn(shown);
+    const withCache = view.breakdown === "model" &&
+        width - withoutCache - cache.width >= Math.min(nameWidest, CACHE_NAME_MIN_WIDTH);
+    const fixed = withoutCache + (withCache ? cache.width : 0);
+    const barRoom = width - fixed - nameWidest - 2;
+    const barWidth = colored && barRoom >= ROW_BAR_MIN_WIDTH ? barRoom : 0;
+    const nameWidth = barWidth > 0 ? nameWidest : Math.max(4, width - fixed);
+    const amountOf = (row) => (view.mode === "cost" ? row.costUsd : row.tokens);
+    const most = Math.max(0, ...shown.map((entry) => amountOf(entry.row)));
+    const barSpans = (entry) => {
+        if (barWidth === 0)
+            return [];
+        const amount = amountOf(entry.row);
+        const filled = most > 0 && amount > 0 ? Math.max(1, Math.round((amount / most) * barWidth)) : 0;
+        return [
+            span("  ", "muted"),
+            span(THIN_BAR.repeat(filled), entry.dot ?? "bar"),
+            span(" ".repeat(barWidth - filled), "muted"),
+        ].filter((part) => part.text.length > 0);
+    };
+    const nameHeader = view.breakdown === "model" ? "Model" : "Day";
+    const lines = [
+        [span("Breakdown", "heading")],
+        [
+            span(`${padStartColumns("#", numberWidth)}  ${padEndColumns(nameHeader, dotWidth + nameWidth)}${barWidth > 0 ? " ".repeat(barWidth + 2) : ""}`, "muted"),
+            ...metricSpans(view, metrics, widths, undefined),
+            ...(withCache ? cache.spans(undefined) : []),
+            ...(mark ? [span(" ".repeat(columnsOf(mark)), "muted")] : []),
+        ],
+    ];
+    shown.forEach((entry, position) => {
+        lines.push([
+            span(`${padStartColumns(String(position + 1), numberWidth)}  `, "muted"),
+            ...(entry.dot ? [span(DOT, entry.dot)] : []),
+            span(padEndColumns(truncateColumns(entry.name, nameWidth), nameWidth), "text"),
+            ...barSpans(entry),
+            ...metricSpans(view, metrics, widths, entry.row),
+            ...(withCache ? cache.spans(entry) : []),
+            ...(mark ? [span(mark, "muted")] : []),
+        ]);
+    });
+    if (entries.length > shown.length) {
+        lines.push([span(`and ${entries.length - shown.length} more`, "muted")]);
+    }
+    return lines;
+}
+/** `right` beside `left`, starting at column `rightStart`. */
+function sideBySide(left, right, rightStart) {
+    return Array.from({ length: Math.max(left.length, right.length) }, (_, index) => {
+        const leftLine = left[index] ?? [];
+        const rightLine = right[index] ?? [];
+        if (rightLine.length === 0)
+            return leftLine;
+        const gap = " ".repeat(Math.max(0, rightStart - lineWidth(leftLine)));
+        return [...leftLine, span(gap, "muted"), ...rightLine];
+    });
+}
+function buildView(report, options, contents) {
+    const width = Math.max(0, Math.floor(options.width));
+    if (report.totals.tokens.processed <= 0) {
+        return [clip([span("No usage in this range.", "muted")], width)];
+    }
+    const view = {
+        report,
+        mode: options.mode,
+        breakdown: options.breakdown,
+        thisYear: new Date(report.generatedAtMs).getFullYear(),
+    };
+    const layoutWidth = Math.max(LAYOUT_MIN_WIDTH, width);
+    const listWidth = Math.min(LIST_MAX_WIDTH, layoutWidth);
+    const list = [...totalLines(view, listWidth), [], ...providerLines(view, listWidth)].map((line) => clip(line, listWidth));
+    let top = list;
+    if (contents.chart) {
+        const listUsed = Math.max(...list.map(lineWidth));
+        if (layoutWidth - listUsed - SIDE_GAP >= BESIDE_CHART_MIN_WIDTH) {
+            // As tall as the list: the chart's title, baseline and dates take 3 lines.
+            const rows = Math.max(CHART_ROWS, list.length - 3);
+            const chart = chartLines(chartDays(report, view.mode), view.mode, view.thisYear, layoutWidth - listUsed - SIDE_GAP, rows);
+            top = sideBySide(list, chart, listUsed + SIDE_GAP);
+        }
+        else {
+            const chart = chartLines(chartDays(report, view.mode), view.mode, view.thisYear, layoutWidth, CHART_ROWS);
+            if (chart.length > 0)
+                top = [...list, [], ...chart];
+        }
+    }
+    const sections = [
+        top,
+        totalsLines(view, layoutWidth),
+        byTypeLines(view.mode, view.mode === "cost" ? report.totals.costByType : report.totals.tokensByType, layoutWidth, contents.colored),
+        breakdownLines(view, layoutWidth, contents.breakdownRows, contents.colored),
+        unpricedLines(view, layoutWidth),
+    ].filter((lines) => lines.length > 0);
+    const gap = Array.from({ length: contents.sectionGap }, () => []);
+    return sections
+        .flatMap((lines, index) => (index === 0 ? lines : [...gap, ...lines]))
+        .map((line) => clip(line, width));
+}
+/** The usage view for the TUI Usage tab: lines of role-tagged spans, each at most `width`. */
+export function usageView(report, options) {
+    return buildView(report, options, {
+        chart: true,
+        breakdownRows: Number.POSITIVE_INFINITY,
+        colored: true,
+        sectionGap: 2,
+    });
+}
+/** Below this width per side, cost by type and tokens by type stack in the model detail. */
+const DETAIL_SIDE_MIN_WIDTH = 30;
+/** The model detail's first line: the provider's dot and the model's name, cut to `width`. */
+export function modelDetailTitle(report, model, width) {
+    const room = Math.max(0, Math.floor(width));
+    const name = truncateColumns(modelName(report, model), room - columnsOf(DOT));
+    return clip([span(DOT, providerRole(report, model.providerID)), span(name, "title")], room);
+}
+/**
+ * One model of the breakdown, like T3 Code's model popup: its name, provider and share, then
+ * Cost, Tokens, cost per 1M tokens and cache hit (cache reads ÷ all input tokens), its daily
+ * chart over the report's days, and cost by type and tokens by type, side by side when they
+ * fit. Every line fits in `width`.
+ */
+export function modelDetailView(report, model, options) {
+    const width = Math.max(0, Math.floor(options.width));
+    const layoutWidth = Math.max(LAYOUT_MIN_WIDTH, width);
+    const { mode } = options;
+    const thisYear = new Date(report.generatedAtMs).getFullYear();
+    const share = mode === "cost"
+        ? `${formatShare(model.costShare)} of cost`
+        : `${formatShare(model.tokenShare)} of tokens`;
+    const { input, cacheRead, cacheWrite } = model.tokensByType;
+    const allInput = input + cacheRead + cacheWrite;
+    let perMillion = "—";
+    if (!model.priced)
+        perMillion = "no price";
+    else if (model.tokens > 0)
+        perMillion = formatUsd((model.costUsd / model.tokens) * 1_000_000);
+    const lines = [
+        modelDetailTitle(report, model, width),
+        [span(`${getQuotaProviderDisplayLabel(model.providerID)} · ${share}`, "muted")],
+        [],
+        ...grid([
+            ["Cost", costText(model)],
+            ["Tokens", formatTokens(model.tokens)],
+            ["Per 1M tokens", perMillion],
+            ["Cache hit", allInput > 0 ? formatShare(cacheRead / allInput) : "—"],
+        ], layoutWidth),
+    ];
+    const chart = chartLines(chartDays(report, mode, model), mode, thisYear, layoutWidth, DETAIL_CHART_ROWS);
+    if (chart.length > 0)
+        lines.push([], ...chart);
+    const sideWidth = Math.floor((layoutWidth - COLUMN_GAP) / 2);
+    const sideBySideFits = sideWidth >= DETAIL_SIDE_MIN_WIDTH;
+    const byTypeWidth = sideBySideFits ? sideWidth : layoutWidth;
+    const costByType = byTypeLines("cost", model.costByType, byTypeWidth, true);
+    const tokensByType = byTypeLines("tokens", model.tokensByType, byTypeWidth, true);
+    if (sideBySideFits && costByType.length > 0) {
+        lines.push([], ...sideBySide(costByType, tokensByType, sideWidth + COLUMN_GAP));
+    }
+    else {
+        for (const section of [costByType, tokensByType]) {
+            if (section.length > 0)
+                lines.push([], ...section);
+        }
+    }
+    return lines.map((line) => clip(line, width));
+}
+/**
+ * The usage view as plain text for Web `/quota` and the CLI: a range title, no chart, the top
+ * 10 breakdown rows, at most 64 columns.
+ */
+export function usageText(report, options) {
+    const width = Math.min(TEXT_MAX_WIDTH, options.width ?? TEXT_MAX_WIDTH);
+    const lines = buildView(report, { mode: options.mode, breakdown: options.breakdown, width }, { chart: false, breakdownRows: TEXT_BREAKDOWN_ROWS, colored: false, sectionGap: 1 });
+    const title = truncateColumns(`Usage · ${rangeTitle(report)}`, width);
+    const texts = lines.map((line) => line
+        .map((part) => part.text)
+        .join("")
+        .trimEnd());
+    return [title, ...texts].join("\n");
+}
+//# sourceMappingURL=usage.js.map