@fasl-work/caos-app-shell 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -2,8 +2,8 @@ export { A as APP_ROUTE, a as AppShell, b as ArchTab, c as ArchitectureConfig, d
 import * as react from 'react';
 import { ReactNode, Component, ErrorInfo } from 'react';
 import * as zustand from 'zustand';
-import { F as FormatOptions } from './text-DyQ1A8oo.js';
-export { a as FittedLabel, N as NBSP, b as NOT_AVAILABLE, c as SCIENTIFIC_BELOW, d as SHELL_TOKENS, S as ShellColorToken, e as ShellToken, f as fitLabel, g as fontFamily, h as formatNumber, i as formatTicks, n as niceStep, j as niceTicks, k as resolveToken, t as textWidth, u as useFormat, l as useThemeTokens, w as widestLabel } from './text-DyQ1A8oo.js';
+import { F as FormatOptions } from './tokens-BvU9bFPw.js';
+export { b as FittedLabel, N as NBSP, c as NOT_AVAILABLE, d as SCIENTIFIC_BELOW, e as SHELL_TOKENS, S as ShellColorToken, f as ShellToken, g as fitLabel, h as fontFamily, i as formatNumber, j as formatTicks, n as niceStep, k as niceTicks, l as resolveToken, t as textWidth, u as useFormat, m as useThemeTokens, w as widestLabel } from './tokens-BvU9bFPw.js';
 import { L as Lang, B as BiText } from './text-BlY47nIt.js';
 export { p as pick, u as useLangStore, a as useShellLang } from './text-BlY47nIt.js';
 
@@ -1082,16 +1082,32 @@ interface BarDatum {
     value: number | null | undefined;
     /** An explicit colour by meaning; otherwise the accent, or faint beside a highlighted bar. */
     tone?: Tone;
-    /** The bar the reader is on (the selected variant, the case asked about). */
+    /** The bar the reader is on (the selected variant, the case asked about). A bar with a `tone` keeps it and is outlined (0.19.0). */
     highlight?: boolean;
     /** One line shown as the bar's title. */
     hint?: BiText;
+    /** A floating bar (0.19.0): the bar's two ends on the value axis, in any order (a waterfall layer, a bridge step). Without it the bar spans
+     * zero to `value`. `value` stays the number the bar states (a layer's size, a step's amount, a total): it is written at the bar, read in the
+     * readout and the table, which add the two ends. A span of zero length is drawn as a dot as thick as a bar (a total on a bridge); a span with
+     * a missing end draws nothing; a span outside `axis.range` is cut to it. */
+    span?: [number | null | undefined, number | null | undefined];
+    /** Grouped bars (0.19.0): consecutive data with the same `group.id` share one category band, side by side (vertical) or one under another
+     * (horizontal), and the category axis prints the group label once; `label` then names the member (a regime, a year), read with its group
+     * ("Retail, Stress: 18"). Data of one group that are not consecutive make a band each. */
+    group?: {
+        id: string;
+        label: BiText;
+    };
+    /** The number format of this bar (0.19.0), over `axis.format`: its value label, its readout, its ends and its table cells (a layer stated to three
+     * decimals in a stack of two). The axis keeps `axis.format`. */
+    format?: FormatOptions;
 }
 interface BarChartProps {
     /** The chart's accessible name. */
     title: BiText;
     data: BarDatum[];
-    /** The value axis: its title, unit and number format; `range` fixes the domain (it always includes zero). */
+    /** The value axis: its title, unit and number format; `range` fixes the domain (it includes zero, unless a datum has a `span`: then
+     * the range is the axis, a bridge's from 100 to 140 for instance). */
     axis: {
         label: BiText;
         unit?: BiText;
@@ -1108,6 +1124,15 @@ interface BarChartProps {
     height?: number | 'fill';
     /** Called with a bar's id when it is clicked or chosen with the keyboard. */
     onSelect?: (id: string) => void;
+    /** Turn zoom and pan by category off (0.19.0), with the reason (at least 12 characters; the gate lists every chart that sets it).
+     * The crosshair, the readout, the keyboard, the data table and the summary cannot be turned off. */
+    zoomOff?: BiText;
+    /** What each tone means (0.19.0), drawn as a legend under the bars: grouped bars name their members by tone. A tone no bar uses is drawn
+     * anyway and warned about in development. */
+    legend?: Array<{
+        tone: Tone;
+        label: BiText;
+    }>;
 }
 /**
  * The house categorical chart (CAOS_MANAGE audit 2026-10-07: every product hand-drew its bar charts with fixed margins,
@@ -1115,8 +1140,14 @@ interface BarChartProps {
  * over two lines at a word and only then shortened, with the whole label as its title; ticks are round and share one
  * notation; values are written in the interface language. It renders once its box has a width and declares
  * `data-chart`, which the gate's text check (G10) measures.
+ *
+ * Since 0.19.0 it carries Tier A of the interactive-visualization rubric: a crosshair band and a readout for the bar under
+ * the pointer or the keyboard, zoom and pan by category (wheel while the chart has the focus, Ctrl and wheel, brush, Shift and
+ * drag, pinch), a reset control shown while zoomed, the keyboard model (arrows, Home, End, + and -, Shift with the arrows,
+ * 0 and Escape), a hidden table of the values and a one-line summary. A value axis of counts ticks at whole numbers only
+ * (`data-ticks-repeat` declares the labels that repeat, for the gate), and a long axis title wraps instead of being cut.
  */
-declare function BarChart({ title, data, axis, orientation, values, height, onSelect }: BarChartProps): react.JSX.Element;
+declare function BarChart({ title, data, axis, orientation, values, height, onSelect, zoomOff, legend }: BarChartProps): react.JSX.Element;
 
 /** One section of the control rail. A rail whose content does not fit is SPLIT into sections, one shown at a
  * time, never scrolled (ADR-0071 rule 6: a panel must show its own controls). */