@tangle-network/charts 0.4.0 → 0.6.0

package/dist/react/live.css

@@ -25,3 +25,32 @@ line.ov-gridline { stroke: color-mix(in srgb, var(--chart-live-faint, #777) 22%,
 .ov-spark { display: block; width: 8em; height: 1.6em; }
 .ov-spark-empty { font-size: .8em; color: var(--chart-live-faint, #777); }
 .ov-tip-line i { display: inline-block; width: .7em; height: .7em; border-radius: 3px; margin-right: .4em; vertical-align: -.05em; }
+/* Recorded events and spans. Colours come from Brand tokens; kinds also differ by stroke pattern and glyph. */
+.ov-mark { stroke-width: 1.5; fill: none; }
+.ov-mark-pass { stroke: var(--chart-live-pass, var(--chart-pass, var(--status-running))); }
+.ov-mark-deadline { stroke: var(--chart-live-fg, var(--chart-ink)); stroke-dasharray: 5 3; }
+.ov-mark-died { stroke: var(--chart-live-danger, var(--chart-breach, var(--status-error))); stroke-width: 2; }
+.ov-mark-event { stroke: var(--chart-live-muted, var(--chart-ink-muted)); stroke-dasharray: 1 3; stroke-linecap: round; }
+.ov-mark-label { fill: var(--chart-live-fg, var(--chart-ink)); font-size: .75em; paint-order: stroke; stroke: var(--chart-live-surface, var(--chart-canvas)); stroke-width: 3px; stroke-linejoin: round; }
+.ov-band-after-pass { fill: color-mix(in srgb, var(--chart-live-pass, var(--chart-pass, var(--status-running))) 12%, transparent); }
+.ov-band-idle { fill: var(--chart-live-hover, var(--chart-shade)); }
+/* Missing data is hatched, never drawn as zero. */
+.ov-hatch-bg { fill: color-mix(in srgb, var(--chart-live-faint, var(--chart-muted)) 10%, transparent); }
+.ov-hatch { fill: none; stroke: var(--chart-live-faint, var(--chart-muted)); stroke-width: 1; }
+.ov-hatched { background: repeating-linear-gradient(135deg, var(--chart-live-faint, var(--chart-muted)) 0 1px, transparent 1px 5px), color-mix(in srgb, var(--chart-live-faint, var(--chart-muted)) 10%, transparent); }
+.ov-now { stroke: var(--chart-live-fg, var(--chart-ink)); stroke-width: 1.5; }
+.ov-gantt-open { stroke: var(--chart-live-fg, var(--chart-ink)); stroke-width: 1.5; stroke-dasharray: 3 2; }
+.ov-events, .ov-key, .ov-meter-key { list-style: none; margin: .4em 0 0; padding: 0; display: flex; flex-wrap: wrap; gap: .2em 1em; font-size: .8em; color: var(--chart-live-muted, var(--chart-ink-muted)); }
+.ov-key li, .ov-events li, .ov-meter-key li { display: inline-flex; align-items: center; gap: .4em; }
+.ov-meter-key b { font-weight: 500; color: var(--chart-live-fg, var(--chart-ink)); font-family: var(--chart-live-font-mono, monospace); font-variant-numeric: tabular-nums; }
+.ov-meter-key i, .ov-event-swatch { display: inline-block; width: .8em; height: .8em; border-radius: 2px; }
+[data-segmented] > .ov-meter-track { display: flex; }
+[data-segmented] > .ov-meter-track > span { flex: none; border-radius: 0; }
+.ov-event-pass { border-left: 2px solid var(--chart-live-pass, var(--chart-pass, var(--status-running))); border-radius: 0; width: 0; }
+.ov-event-deadline { border-left: 2px dashed var(--chart-live-fg, var(--chart-ink)); border-radius: 0; width: 0; }
+.ov-event-died { border-left: 2px solid var(--chart-live-danger, var(--chart-breach, var(--status-error))); border-radius: 0; width: 0; }
+.ov-event-event { border-left: 2px dotted var(--chart-live-muted, var(--chart-ink-muted)); border-radius: 0; width: 0; }
+.ov-event-after-pass { background: color-mix(in srgb, var(--chart-live-pass, var(--chart-pass, var(--status-running))) 25%, transparent); }
+.ov-event-idle { background: var(--chart-live-hover, var(--chart-shade)); }
+.ov-event-missing { background: repeating-linear-gradient(135deg, var(--chart-live-faint, var(--chart-muted)) 0 1px, transparent 1px 4px); }
+.ov-refusal { margin: 0; color: var(--chart-live-muted, var(--chart-ink-muted)); font-size: .9em; }

package/dist/timeline-BAjzF-wL.d.ts

@@ -0,0 +1,183 @@
+//#region src/types.d.ts
+/**
+ * Inputs and outputs of the figure functions.
+ *
+ * The library draws and never decides. Ranks, intervals, frontier membership,
+ * estimate labels and pass counts arrive from the producer (a board record, a
+ * VerticalBench report, an agent-eval lens). A figure function returns a
+ * `Refusal` instead of a figure it cannot draw honestly.
+ */
+/** agent-eval `SearchEstimateMethod`, the same strings: what a unit count supports. */
+type Estimate = "none" | "insufficient" | "descriptive" | "bootstrap";
+type IntervalMethod = "task-cluster-bootstrap" | "mcnemar-exact" | "wilson";
+/**
+ * A confidence interval as the producer recorded it. `level` and `method` are
+ * nullable because real records omit them; a figure refuses to draw an
+ * interval that does not name both.
+ */
+interface Interval {
+  lower: number;
+  upper: number;
+  level: number | null;
+  method: IntervalMethod | null;
+}
+/** The App Grade ladder, lowest first. U (unable to measure) is not on it. */
+type Tier = "F" | "C" | "B" | "A" | "S";
+type TierCounts = Record<Tier, number>;
+/** Where a cost comes from. Only `receipts` is billed spend. */
+type CostBasis = "receipts" | "estimated" | "unknown";
+/** A column or row identity: an AgentProfile, a model, a judge, a search node. */
+interface Setup {
+  id: string;
+  label: string;
+  /** Null when the order is a sort, not a ranking backed by comparisons. */
+  rank: number | null;
+}
+/** One setup's rate. Field names follow the board record's `BoardProfile`. */
+interface RateRow extends Setup {
+  solved: number;
+  attempts: number;
+  rate: number;
+  /** The producer's label for what `attempts` supports; the library holds no threshold. */
+  estimate: Estimate;
+  interval: Interval | null;
+  tiers: TierCounts | null;
+  cost: {
+    perSolvedUsd: number | null;
+    basis: CostBasis;
+    receipts: number | null;
+  };
+  medianWallMs: number | null;
+  /** Null when the producer computed no frontier. */
+  onFront: boolean | null;
+}
+/** One task × setup cell. */
+interface MatrixCell {
+  task: string;
+  setup: string;
+  /** Attempts that count; null when the cell never ran. */
+  attempts: number | null;
+  /** Attempts that passed; null when no pass rule applies. */
+  solved: number | null;
+  /** Attempts graded on the App Grade ladder. */
+  tiers: TierCounts | null;
+  /** Attempts graded U: no floor check failed, but one could not be observed. */
+  unmeasured?: number;
+  /** Attempts whose grade failed an integrity check and awaits human review. */
+  flagged?: number;
+  /** A lens cell's mean score; null when the setup never scored the task. */
+  mean: number | null;
+  costUsd: number | null;
+}
+interface ComparisonRow {
+  /** Setup ids. */
+  favored: string;
+  other: string;
+  pairs: number | null;
+  minimumEffect: number | null;
+  /** The clustered interval on the difference, in the measure's units. */
+  interval: Interval | null;
+  /** The exact interval, drawn under the clustered one when present. */
+  exactInterval: Interval | null;
+}
+interface BreakdownInput {
+  reasons: string[];
+  setups: Array<{
+    id: string;
+    label: string;
+    n: number | null;
+  }>;
+  counts: Array<{
+    reason: string;
+    setup: string;
+    count: number | null;
+  }>;
+  excluded: {
+    count: number;
+    why: string;
+  } | null;
+  /** True when one attempt can count under several reasons. */
+  overlapping?: boolean;
+}
+/** Attempts left out of a figure, stated in its note. */
+interface Exclusion {
+  count: number;
+  why: string;
+}
+interface Figure {
+  id: string;
+  /** Generated from the input; no function accepts heading text. */
+  finding: string;
+  /** One quantified sentence. */
+  lede: string;
+  /** How to read the marks. */
+  read: string;
+  /** Wide and phone renders; vertical columns retain a readable minimum width. Null means the phone view uses the table. */
+  svg: {
+    wide: string;
+    narrow: string | null;
+    interactive?: boolean;
+  };
+  /** An HTML table with every number the plot shows. */
+  table: string;
+  note: {
+    method: string;
+    n: string;
+    exclusions: string[];
+  };
+}
+interface Refusal {
+  id: string;
+  refused: string;
+}
+declare function isRefusal(value: Figure | Refusal): value is Refusal;
+//#endregion
+//#region src/events.d.ts
+/** `pass` is solid, `deadline` dashed, `died` ends in a cross and `event` is dotted, so kinds read without colour. */
+type MarkKind = "pass" | "deadline" | "died" | "event";
+interface ChartMark {
+  at: number;
+  label: string;
+  kind: MarkKind;
+}
+/** `missing` is hatched: a span with no data is never drawn as zero. */
+type BandKind = "after-pass" | "idle" | "missing";
+interface ChartBand {
+  from: number;
+  to: number;
+  label: string;
+  kind: BandKind;
+}
+//#endregion
+//#region src/timeline.d.ts
+/** Epoch milliseconds. `end: null` is an open span; it needs the figure's `now`. */
+interface TimelineSpan {
+  start: number;
+  end: number | null;
+  state: string;
+  note?: string;
+}
+interface TimelineLane {
+  id: string;
+  label: string;
+  spans: TimelineSpan[];
+}
+interface TimelineOptions {
+  measure: string;
+  /** The recorded window; defaults to the extent of spans, marks, bands and `now`. Everything must fall inside it. */
+  start?: number;
+  end?: number;
+  /** The time an open span is drawn to. Required when any span is open. */
+  now?: number;
+  marks?: ChartMark[];
+  bands?: ChartBand[];
+  /** States drawn hatched because their time has no data. Default: missing, untraced. */
+  hatch?: string[];
+  /** States drawn in the muted tone, such as idle. Default: idle. */
+  muted?: string[];
+  formatTime?: (ms: number) => string;
+  id?: string;
+}
+declare function timeline(lanes: TimelineLane[], o: TimelineOptions): Figure | Refusal;
+//#endregion
+export { isRefusal as C, TierCounts as S, MatrixCell as _, BandKind as a, Setup as b, MarkKind as c, CostBasis as d, Estimate as f, IntervalMethod as g, Interval as h, timeline as i, BreakdownInput as l, Figure as m, TimelineOptions as n, ChartBand as o, Exclusion as p, TimelineSpan as r, ChartMark as s, TimelineLane as t, ComparisonRow as u, RateRow as v, Tier as x, Refusal as y };

package/package.json

@@ -1,18 +1,17 @@
 {
   "name": "@tangle-network/charts",
-  "version": "0.4.0",
-  "description": "Benchmark figures as static SVG and HTML tables: ranked rates, cost frontier, comparison intervals, task matrix and breakdown. Draws from producer data and refuses what it cannot draw honestly.",
+  "version": "0.6.0",
+  "description": "Static SVG and HTML figures for benchmarks and operational timing. Draws from producer data and refuses what it cannot draw honestly.",
   "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tangle-network/brand.git",
-    "directory": "packages/charts"
+    "url": "git+https://github.com/tangle-network/charts.git"
   },
   "bugs": {
-    "url": "https://github.com/tangle-network/brand/issues"
+    "url": "https://github.com/tangle-network/charts/issues"
   },
-  "homepage": "https://github.com/tangle-network/brand/tree/main/packages/charts",
+  "homepage": "https://github.com/tangle-network/charts",
   "sideEffects": [
     "./dist/figure.css",
     "./dist/react/live.css"
@@ -43,18 +42,31 @@
       "optional": true
     }
   },
+  "scripts": {
+    "gen:css": "node scripts/gen-css.mjs",
+    "build": "node scripts/gen-css.mjs --check && tsdown && cp src/figure.css dist/figure.css && cp src/react/live.css dist/react/live.css",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
   "devDependencies": {
+    "@tangle-network/brand": "1.24.2",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.7",
+    "@types/node": "^26.6.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.2.3",
+    "jsdom": "^30.1.1",
+    "playwright": "^1.63.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "tsdown": "^0.23.0",
-    "typescript": "^7.0.2"
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.2"
   },
   "keywords": [
     "tangle",
     "charts",
     "benchmarks",
     "svg"
-  ],
-  "scripts": {
-    "gen:css": "node scripts/gen-css.mjs",
-    "build": "node scripts/gen-css.mjs --check && tsdown && cp src/figure.css dist/figure.css && cp src/react/live.css dist/react/live.css"
-  }
-}
+  ]
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Tangle Network
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.