@usetheo/ui 0.23.0 → 0.27.0

package/dist/lib/chart/histogram.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure histogram binning — distributes numeric values into `binCount`
+ * equal-width bins over [min, max] and counts how many fall in each.
+ *
+ * Zero-dependency, total, deterministic (M11 ADR D2 — binning is pure logic,
+ * distinct from the SVG scaling reused from TrendChart). Non-finite values
+ * (NaN / ±Infinity) are dropped, mirroring the trace-core `Number.isFinite`
+ * discipline. A degenerate range (all values equal) collapses to a single
+ * populated bin so no count is lost.
+ */
+/** One histogram bucket: half-open [lo, hi) except the final bin, which is [lo, hi] (max-inclusive). */
+export interface HistogramBin {
+    lo: number;
+    hi: number;
+    count: number;
+}
+/**
+ * Bin `values` into `binCount` equal-width buckets.
+ * Returns `[]` for an empty input or a non-positive `binCount`.
+ */
+export declare function computeHistogram(values: number[], binCount: number): HistogramBin[];

package/dist/lib/chart/index.d.ts

@@ -0,0 +1 @@
+export * from "./histogram.js";

package/dist/lib/diff/diff-lines.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pure line-level diff via Longest Common Subsequence (M14 ADR D1 — zero
+ * dependency, keeps the registry copy-pasteable; no `diff`/`@pierre/diffs`).
+ * Suitable for the design-system case (prompts / JSON, < ~500 lines);
+ * O(n·m) time. A row is `eq` (unchanged), `del` (only in old), or `add`
+ * (only in new). Line numbers are honest: `del` has no rightNo, `add` has no
+ * leftNo. Deterministic, total — never throws.
+ */
+export type DiffRowKind = "eq" | "del" | "add";
+export interface DiffRow {
+    kind: DiffRowKind;
+    text: string;
+    /** 1-based line number in the old text (absent for `add`). */
+    leftNo?: number;
+    /** 1-based line number in the new text (absent for `del`). */
+    rightNo?: number;
+}
+/**
+ * Diff `oldText` against `newText` at line granularity. Returns the aligned
+ * sequence of rows (eq / del / add) in reading order. `del` before `add` when a
+ * line is replaced.
+ */
+export declare function diffLines(oldText: string, newText: string): DiffRow[];

package/dist/lib/diff/index.d.ts

@@ -0,0 +1 @@
+export * from "./diff-lines.js";

package/dist/lib/session/aggregate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pure, total session-metric aggregation. Never throws, never does I/O. Honest sums: absent
+ * cost/tokens count as 0 (never NaN); the window is max(end) − min(start) over parseable timestamps
+ * (an unparseable start is skipped from the window, never a crash).
+ */
+import type { SessionMetrics, SessionTraceItem } from "./types.js";
+/**
+ * The session's wall-clock window in ns: [min start, max effective end] over the parseable
+ * timestamps. An unparseable start is skipped (never a crash); a clock-skewed/absent end falls back
+ * to its own start. A session with no parseable timestamps yields 0/0. This is the SINGLE definition
+ * of "a session's time window" — both `aggregateSession` (for `windowMs`) and `SessionTimeline` (for
+ * the per-trace bar denominator) consume it, so the window semantics live in one place.
+ */
+export declare function sessionBounds(items: SessionTraceItem[]): {
+    startNs: bigint;
+    endNs: bigint;
+};
+export declare function aggregateSession(items: SessionTraceItem[]): SessionMetrics;

package/dist/lib/session/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./aggregate.js";

package/dist/lib/session/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Data contracts for the session-level components (M9). A session groups traces that share a
+ * `session.id`; `SessionTraceItem` is the trace-level shape both `SessionSummary` and
+ * `SessionTimeline` consume — the intersection of the theo-lens traces-list row and the peer
+ * session views (phoenix numTraces+latency+cost, langfuse timestamp+name+latency). Timestamps
+ * accept unix-ns (bigint | numeric string) or ISO — normalized by the trace-core `toNs`.
+ */
+export interface SessionTraceItem {
+    id: string;
+    name?: string;
+    /** Unix ns (bigint | numeric string) or ISO-8601 string. */
+    startTime?: bigint | string;
+    /** Absent/null = in-flight (renders unbounded on the timeline). */
+    endTime?: bigint | string | null;
+    status?: "OK" | "ERROR";
+    model?: string;
+    costUsd?: number;
+    totalTokens?: number;
+}
+/** Aggregate metrics over a session's traces. All numeric fields are 0 (never NaN) when absent. */
+export interface SessionMetrics {
+    traceCount: number;
+    /** Session wall-clock window in ms: max(end) − min(start) across all traces. */
+    windowMs: number;
+    totalCostUsd: number;
+    totalTokens: number;
+    errorCount: number;
+    /** Distinct models seen, sorted. */
+    models: string[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usetheo/ui",
-  "version": "0.23.0",
+  "version": "0.27.0",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Violet Forge design system — generic React components + primitives (the non-AI foundation of @theokit/ui).",