@knpkv/rly 0.12.1 → 0.14.0

package/README.md

@@ -204,12 +204,33 @@ never reads as 0%. Under forced colours the track keeps a `CanvasText` edge. Pas
 to expose it as a meter instead. With `value={null}`, it is a named image whose
 accessible label combines `label` and `valueText`, without a numeric range.
 
+`StackedBars` stacks values per period on a time axis, with optional `bands` of
+limit levels above the bars on the same axis, and an optional `window` (such as the
+current limit window) shaded across bands and bars and named in a key under the axis. Narrow containers bin periods so every
+bar's hit area stays at least 24px wide, a full pointer target (the drawn fill is 2px narrower, for the gap). The plot is one tab stop: ←/→ move and select, Shift
+extends, Home/End jump and Escape clears. Click selects, and Shift+click or a second
+tap elsewhere extends the span. The caller owns `selection` and words it through
+`describeSelection`. Only a selection the user makes is announced, politely, once it
+settles: the first render and a data refresh under the same selection stay quiet. Charts
+are presentation only: the application computes columns, bands and any projection.
+`columns` must be in time order without overlaps (gaps are fine), or the chart throws an error naming
+the first column out of place. Every bar stacks its series in one chart-wide order, the order
+each id first appears. Bins group every N columns, so hourly columns that start on the
+hour bin on clock hours. The selection is outlined above the bars, and the window is a
+neutral dashed stretch, never the focus colour. A chart on a surface other than
+`surface-1` sets `--rly-stacked-bars-gap` to that background, so the gaps between bars
+match it.
+Everything the bands draw is named in that key in the caller's words: each band's
+`near: { level, label }` mark, and `noReadingLabel`, which is required once any band has
+a stretch with `level: null`. Zero, negative and non-finite values draw nothing.
+
 `TrackKey` explains the marks the tracks draw, listing only the marks in use.
 `ChartLegend` says which colour is which series, with the swatch before each label.
 Series colours are the tokens `--rly-color-series-1` to `-8` plus
 `--rly-color-series-other` for folded series. Use `rlySeriesColor(series)` in SVG
 fills, and keep an id on the same slot while it is visible. Colour is never the only
-carrier: every chart ships a labelled key and a table equivalent, and forced-colours
+carrier: every chart ships a labelled key and a table equivalent (a readable-resolution
+table, each band's intervals, and a selection announcement naming every series' value), and forced-colours
 mode collapses the series to `CanvasText`.
 
 ```tsx
@@ -427,6 +448,30 @@ target, expected revision, impact, and evidence beside a named human reviewer.
 Its owned authorization button stays disabled until the controlled exact-action
 confirmation is checked, and terminal outcomes remain visible after review.
 
+`RelayMark` is Relay's mark, the baton: two open hooks with a stroke passed between
+them. The bare mark is drawn in the current colour, so it follows its host's text in
+every theme and in forced colours; sizes are 16, 20 (default), 24 and 32px, and 16px
+stays legible in one colour. `RelayMark.Tile` sets it on the agent colour (20, 24 or
+32px); in forced colours the tile becomes an outline in its context's colour
+(LinkText in a link, ButtonText in a button). Both are decorative
+unless given a `label`. The same mark on its tile ships as `@knpkv/rly/relay-mark.svg`
+for a host's favicon.
+
+`RelayLauncher` is the header button that opens and closes Relay: the mark, a label
+("Relay" unless the host names it) and the Ctrl/⌘+J hint. It sits in the host's header
+like any other control, never fixed over the page. `expanded` drives `aria-expanded`,
+and `aria-keyshortcuts` names the shortcut while the visible hint stays hidden from
+assistive technology. `shortcut` is required: pass `useRelayShortcut()` (Ctrl/⌘+J for
+the platform) only when the host binds that key and prevents the browser's own Ctrl+J,
+or `null` where it binds none, such as a live terminal that keeps its chords.
+The hint hides at 40rem and below, and the button is 32px tall, 44px for a coarse pointer.
+
+```tsx
+import { RelayLauncher, useRelayShortcut } from "@knpkv/rly/patterns"
+
+;<RelayLauncher expanded={open} onClick={() => setOpen((value) => !value)} shortcut={useRelayShortcut()} />
+```
+
 `RelayDock` is the shared product frame for one adapter-owned Relay thread. It
 starts collapsed, keeps context plus profile and model selection visible above
 the scrolling thread, and accepts explicit ready, loading, empty, error, and

package/dist/assets/relay-mark.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32">
+  <title>Relay</title>
+  <rect width="32" height="32" rx="9.6" fill="#6741A5"/>
+  <g transform="translate(8 8) scale(0.6667)" fill="none" stroke="#FFFFFF" stroke-width="2.75" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M4 20V9.5A5.5 5.5 0 0 1 9.5 4H13"/>
+    <path d="M20 4v10.5a5.5 5.5 0 0 1-5.5 5.5H11"/>
+    <path d="M10 14 14 10"/>
+  </g>
+</svg>