@kymoscope/sdk 0.3.0 → 0.5.0

package/dist/rules/kyr1.schema.json

@@ -0,0 +1,135 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kymoscope.com/schemas/kyr1.schema.json",
+  "title": "Kymoscope alert rule (kyr/1)",
+  "description": "A portable alert rule. Channels are matched by exact, case-sensitive name on each target; a rule whose channels a target lacks waits there. Runtimes check the semantic limits (aliases referenced exist, derived signals are acyclic, at most 16 conditions) themselves.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["kyr", "id", "version", "name", "severity", "enabled", "signals", "when", "forS", "clearForS", "runWhere"],
+  "properties": {
+    "kyr": { "const": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "version": { "type": "integer", "minimum": 1 },
+    "name": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "\\S" },
+    "severity": { "enum": ["info", "warning", "critical"] },
+    "enabled": { "type": "boolean" },
+    "targets": {
+      "type": "object",
+      "properties": {
+        "streams": { "$ref": "#/definitions/idList" },
+        "histories": { "$ref": "#/definitions/idList" },
+        "datasets": { "$ref": "#/definitions/idList" }
+      }
+    },
+    "signals": {
+      "type": "object",
+      "minProperties": 1,
+      "propertyNames": { "$ref": "#/definitions/alias" },
+      "additionalProperties": { "$ref": "#/definitions/signal" }
+    },
+    "derived": {
+      "type": "object",
+      "propertyNames": { "$ref": "#/definitions/alias" },
+      "additionalProperties": { "$ref": "#/definitions/derived" }
+    },
+    "when": { "$ref": "#/definitions/condition" },
+    "forS": { "$ref": "#/definitions/seconds" },
+    "clearForS": { "$ref": "#/definitions/seconds" },
+    "staleS": { "oneOf": [{ "$ref": "#/definitions/seconds" }, { "type": "null" }] },
+    "notify": { "type": "array", "items": { "type": "string" } },
+    "runWhere": { "type": "array", "minItems": 1, "items": { "enum": ["browser", "collector", "watcher", "cloud"] } },
+    "keep": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "object", "required": ["beforeS", "afterS"], "properties": { "beforeS": { "$ref": "#/definitions/seconds" }, "afterS": { "$ref": "#/definitions/seconds" } } }
+      ]
+    },
+    "origin": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "required": ["workbookId", "worksheetId", "chartId", "field"],
+          "properties": {
+            "workbookId": { "type": ["string", "null"] },
+            "worksheetId": { "type": "string" },
+            "chartId": { "type": "string" },
+            "field": { "type": "string" },
+            "seriesId": { "type": "string" }
+          }
+        }
+      ]
+    }
+  },
+  "definitions": {
+    "alias": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,31}$" },
+    "channel": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "seconds": { "type": "number", "minimum": 0, "maximum": 86400 },
+    "hysteresis": { "type": "number", "minimum": 0 },
+    "idList": { "oneOf": [{ "type": "null" }, { "type": "array", "items": { "type": "string" } }] },
+    "signal": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["channel"],
+          "additionalProperties": false,
+          "properties": {
+            "channel": { "$ref": "#/definitions/channel" },
+            "stream": { "type": "string", "description": "Only on this stream id." },
+            "history": { "type": "string", "description": "Only on this history id." },
+            "dataset": { "type": "string", "description": "Only on loaded files with this name." },
+            "tag": { "type": "string", "description": "Collector only: bind by the source address (OPC UA node id) instead of the published name." }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["formula"],
+          "additionalProperties": false,
+          "description": "A math channel by name. The rule's runWhere must be exactly [\"browser\"].",
+          "properties": { "formula": { "$ref": "#/definitions/channel" } }
+        }
+      ]
+    },
+    "derived": {
+      "oneOf": [
+        {
+          "type": "object", "required": ["op", "of", "windowS"], "additionalProperties": false,
+          "properties": { "op": { "enum": ["rate", "mean", "min", "max"] }, "of": { "$ref": "#/definitions/alias" }, "windowS": { "type": "number", "exclusiveMinimum": 0, "maximum": 86400 } }
+        },
+        {
+          "type": "object", "required": ["op", "of"], "additionalProperties": false,
+          "properties": { "op": { "const": "abs" }, "of": { "$ref": "#/definitions/alias" } }
+        },
+        {
+          "type": "object", "required": ["op", "a", "b"], "additionalProperties": false,
+          "properties": { "op": { "const": "diff" }, "a": { "$ref": "#/definitions/alias" }, "b": { "$ref": "#/definitions/alias" } }
+        }
+      ]
+    },
+    "condition": {
+      "description": "Nesting depth at most 3, at most 16 leaves. Other condition keys are refused (unsupported_condition).",
+      "oneOf": [
+        { "type": "object", "required": ["above", "value"], "additionalProperties": false,
+          "properties": { "above": { "$ref": "#/definitions/alias" }, "value": { "type": "number" }, "hysteresis": { "$ref": "#/definitions/hysteresis" } } },
+        { "type": "object", "required": ["below", "value"], "additionalProperties": false,
+          "properties": { "below": { "$ref": "#/definitions/alias" }, "value": { "type": "number" }, "hysteresis": { "$ref": "#/definitions/hysteresis" } } },
+        { "type": "object", "required": ["outside", "lo", "hi"], "additionalProperties": false,
+          "properties": { "outside": { "$ref": "#/definitions/alias" }, "lo": { "type": "number" }, "hi": { "type": "number" }, "hysteresis": { "$ref": "#/definitions/hysteresis" } } },
+        { "type": "object", "required": ["inside", "lo", "hi"], "additionalProperties": false,
+          "properties": { "inside": { "$ref": "#/definitions/alias" }, "lo": { "type": "number" }, "hi": { "type": "number" }, "hysteresis": { "$ref": "#/definitions/hysteresis" } } },
+        { "type": "object", "required": ["equals", "value"], "additionalProperties": false,
+          "properties": { "equals": { "$ref": "#/definitions/alias" }, "value": { "type": "number" } } },
+        { "type": "object", "required": ["changes"], "additionalProperties": false,
+          "properties": { "changes": { "$ref": "#/definitions/alias" } } },
+        { "type": "object", "required": ["noData", "forS"], "additionalProperties": false,
+          "properties": { "noData": { "$ref": "#/definitions/alias" }, "forS": { "$ref": "#/definitions/seconds" } } },
+        { "type": "object", "required": ["all"], "additionalProperties": false,
+          "properties": { "all": { "type": "array", "minItems": 1, "items": { "$ref": "#/definitions/condition" } } } },
+        { "type": "object", "required": ["any"], "additionalProperties": false,
+          "properties": { "any": { "type": "array", "minItems": 1, "items": { "$ref": "#/definitions/condition" } } } },
+        { "type": "object", "required": ["not"], "additionalProperties": false,
+          "properties": { "not": { "$ref": "#/definitions/condition" } } }
+      ]
+    }
+  }
+}

package/dist/rules.js

@@ -0,0 +1,2 @@
+/*! @kymoscope/sdk (c) 2026 Kymoscope. Proprietary software: use requires a license. See LICENSE.md. */
+import{i as e,n as t,r as n,t as r}from"./threshold-C9it0Y7P.js";export{n as LEAF_KEYS,e as createRuleEvaluator,r as thresholdOf,t as validateRule};

package/dist/styles/charts.css

@@ -112,6 +112,9 @@
 }
 
 .kymo-ann { cursor: move; }
+/* Alert marks: read-only spans; only their top strip takes the pointer (it selects the rule). */
+.kymo-marks { pointer-events: none; }
+.kymo-mark-hit { fill: transparent; pointer-events: auto; cursor: pointer; }
 .kymo-ann-hit {
   fill: none;
   stroke: transparent;
@@ -205,3 +208,191 @@
 @media (prefers-reduced-motion: no-preference) {
   .kymo-ann-delete { transition: color 0.14s ease, border-color 0.14s ease; }
 }
+
+/* ── Camera panel ──────────────────────────────────────────────────────────
+   The video itself stays plain: no glow, no motion. The overlay is a small
+   readout over it; only the LIVE dot breathes (not with reduced motion). */
+.kymo-camera {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  background: var(--chart-bg);
+}
+
+.kymo-camera__video {
+  position: absolute;
+  inset: 0;
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+.kymo-camera__overlay {
+  position: absolute;
+  top: 8px;
+  left: 8px;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px 8px;
+  max-width: calc(100% - 16px);
+  padding: 3px 8px;
+  border-radius: 6px;
+  font: 500 11px/1.5 var(--font-mono, ui-monospace, monospace);
+  font-variant-numeric: tabular-nums;
+  font-feature-settings: 'tnum' 1;
+  color: var(--chart-fg, oklch(0.93 0.01 255));
+  background: color-mix(in oklch, var(--chart-bg) 80%, transparent);
+  box-shadow:
+    inset 0 1px 0 color-mix(in oklch, white 7%, transparent),
+    0 0 0 1px color-mix(in oklch, var(--chart-grid) 70%, transparent),
+    0 2px 6px color-mix(in oklch, black 28%, transparent);
+  pointer-events: none;
+}
+
+[data-color-scheme='light'] .kymo-camera__overlay { color: oklch(0.25 0.03 255); }
+
+.kymo-camera__name {
+  overflow: hidden;
+  max-width: 24ch;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.kymo-camera__live {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  color: var(--accent);
+}
+
+.kymo-camera__live::before {
+  content: '';
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: currentColor;
+  box-shadow: 0 0 0 2px color-mix(in oklch, var(--accent) 22%, transparent);
+}
+
+.kymo-camera__ago { color: var(--chart-muted); }
+
+.kymo-camera__rec {
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  color: var(--chart-muted);
+}
+
+.kymo-camera__badge {
+  padding: 0 5px;
+  border-radius: 4px;
+  border: 1px solid var(--chart-grid);
+  color: var(--chart-muted);
+}
+
+.kymo-camera__badge.is-exact {
+  border-color: color-mix(in oklch, var(--accent) 45%, transparent);
+  color: var(--accent);
+}
+
+.kymo-camera__note { color: var(--accent); }
+
+.kymo-camera__empty {
+  position: absolute;
+  inset: 0;
+  display: grid;
+  place-content: center;
+  justify-items: center;
+  gap: 6px;
+  padding: 16px;
+  text-align: center;
+  color: var(--chart-muted);
+  font: 13px/1.45 var(--font-sans, system-ui, sans-serif);
+}
+
+.kymo-camera__empty p { margin: 0; }
+
+.kymo-camera__empty-icon {
+  width: 30px;
+  height: 30px;
+  margin-bottom: 2px;
+  fill: none;
+  stroke: currentColor;
+  stroke-width: 1.5;
+  stroke-linejoin: round;
+  opacity: 0.75;
+}
+
+.kymo-camera__empty-title {
+  font-weight: 600;
+  color: var(--chart-fg, oklch(0.93 0.01 255));
+}
+
+[data-color-scheme='light'] .kymo-camera__empty-title { color: oklch(0.25 0.03 255); }
+
+.kymo-camera__empty-detail { font-family: var(--font-mono, ui-monospace, monospace); font-size: 12px; }
+
+/* A wall of cameras: tiles on a hairline grid (the gap shows the chart grid colour). */
+.kymo-camera-wall {
+  position: relative;
+  display: grid;
+  gap: 2px;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  background: var(--chart-grid);
+}
+
+.kymo-camera.is-tile { cursor: zoom-in; }
+
+/* Hover and keyboard focus ring the tile itself; the video is never dimmed or animated. */
+.kymo-camera.is-tile::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  box-shadow: inset 0 0 0 1px transparent;
+  pointer-events: none;
+}
+
+.kymo-camera.is-tile:hover::after { box-shadow: inset 0 0 0 1px color-mix(in oklch, var(--accent) 55%, transparent); }
+.kymo-camera.is-tile:focus-visible { outline: none; }
+.kymo-camera.is-tile:focus-visible::after { box-shadow: inset 0 0 0 2px var(--accent); }
+
+.kymo-camera__all {
+  position: absolute;
+  top: 8px;
+  right: 8px;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 10px 4px 8px;
+  border: 0;
+  border-radius: 6px;
+  font: 500 12px/1.4 var(--font-sans, system-ui, sans-serif);
+  color: var(--chart-fg, oklch(0.93 0.01 255));
+  background: color-mix(in oklch, var(--chart-bg) 82%, transparent);
+  box-shadow:
+    inset 0 1px 0 color-mix(in oklch, white 7%, transparent),
+    0 0 0 1px color-mix(in oklch, var(--chart-grid) 70%, transparent),
+    0 2px 6px color-mix(in oklch, black 28%, transparent);
+  cursor: pointer;
+}
+
+.kymo-camera__all svg { width: 14px; height: 14px; fill: none; stroke: currentColor; stroke-width: 1.4; }
+.kymo-camera__all:hover { box-shadow: inset 0 1px 0 color-mix(in oklch, white 7%, transparent), 0 0 0 1px color-mix(in oklch, var(--accent) 55%, transparent), 0 2px 6px color-mix(in oklch, black 28%, transparent); }
+.kymo-camera__all:hover svg { color: var(--accent); }
+.kymo-camera__all:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+
+[data-color-scheme='light'] .kymo-camera__all { color: oklch(0.25 0.03 255); }
+
+@media (prefers-reduced-motion: no-preference) {
+  .kymo-camera__live::before { animation: kymo-camera-live 2s ease-in-out infinite; }
+  .kymo-camera.is-tile::after, .kymo-camera__all { transition: box-shadow 0.15s ease; }
+}
+
+@keyframes kymo-camera-live {
+  50% { box-shadow: 0 0 0 4px color-mix(in oklch, var(--accent) 8%, transparent); }
+}

package/dist/threshold-C9it0Y7P.js

@@ -0,0 +1,2 @@
+/*! @kymoscope/sdk (c) 2026 Kymoscope. Proprietary software: use requires a license. See LICENSE.md. */
+function e(e){let n=Object.keys(e.signals),r=t(e.derived??{}),i=[...n,...r],a=e=>i.indexOf(e),o=r.map(t=>{let n=e.derived[t];return{i:a(t),d:n,src:(n.op===`diff`?[n.a,n.b]:[n.of]).map(a)}}),s=[],c=i.map(()=>!1),l=i.map(()=>e.staleS!=null),u=null,d=!1,f=e=>{d||(d=!0,u=e)},p=e=>{let t=e;if(`all`in t||`any`in t){let e=`all`in t,n=(e?t.all:t.any).map(p),r=s.length,i=n.filter(e=>`i`in s[e]);i.forEach((t,n)=>{let i=s[t];i.into=r,i.mode=n===0?0:e?1:2}),s.push({k:e?`all`:`any`,kids:n,rest:n.filter(e=>!i.includes(e)),fused:i.length>0})}else if(`not`in t){let e=p(t.not);s.push({k:`not`,kid:e})}else{let e=[`above`,`below`,`outside`,`inside`,`equals`,`changes`,`noData`].find(e=>e in t),n=a(t[e]),r=t.value??NaN,i=t.lo??NaN,o=t.hi??NaN;f(e===`above`?{i:n,excess:e=>e-r}:e===`below`?{i:n,excess:e=>r-e}:e===`outside`?{i:n,excess:e=>Math.max(e-o,i-e)}:null),e===`changes`&&(c[n]=!0),e===`noData`&&(l[n]=!0),s.push({k:e,i:n,v:r,lo:i,hi:o,h:t.hysteresis??0,f:t.forS??0,prev:0,into:s.length,mode:0})}return s.length-1};return p(e.when),{aliases:i,base:n.length,derived:o,ops:s,needPrev:c,needAt:l,first:u}}function t(e){let t=[],n=new Set,r=i=>{if(n.has(i)||!(i in e))return;n.add(i);let a=e[i];for(let e of a.op===`diff`?[a.a,a.b]:[a.of])r(e);t.push(i)};return Object.keys(e).forEach(r),t}var n=`\0t`;function r(e,t){return`formula`in e?{applies:!0,column:e.formula}:e.stream&&!(t.kind===`stream`&&t.id===e.stream)||e.history&&!(t.kind===`history`&&t.id===e.history)||e.dataset&&!(t.kind===`dataset`&&t.name===e.dataset)?{applies:!1,column:null}:e.tag?{applies:!0,column:t.tags?.[e.tag]??null}:{applies:!0,column:e.channel}}function i(t,n){let i=e(t),f=i.aliases.length,p=i.base,m=t.staleS??1/0,h=Object.values(t.signals),g=h.every(e=>r(e,n).applies),_=h.map(()=>null),v=!1,y=[],b=`idle`,x=NaN,S=NaN,C=-1/0,w=0,T=null,E=new Float64Array(f).fill(NaN),D=new Float64Array(f).fill(NaN),O=new Float64Array(f).fill(NaN),k=i.derived.map(()=>l()),A=Array(f),j=Array(f),M=Array(f),N=Array(f),P=0,F=[],I=[],L=[],R=[],z=new Float64Array,B=new Float64Array,V=new Float64Array,H=new Int32Array,U=new Uint8Array,W=[],G=e=>{e<=P||(P=Math.max(e,P*2,64),F=Array.from({length:f},()=>new Float64Array(P)),I=Array.from({length:f},()=>new Float64Array(P)),L=Array.from({length:f},()=>new Uint8Array(P)),R=Array.from({length:f},()=>new Float64Array(P)),z=new Float64Array(P),B=new Float64Array(P),V=new Float64Array(P),H=new Int32Array(P),U=new Uint8Array(P).fill(1),W=i.ops.map(()=>new Int8Array(P)))},K=(e,r,i={})=>({ruleId:t.id,ruleVersion:t.version,target:n,kind:e,t:r,...i}),q=()=>{E.fill(NaN),D.fill(NaN),O.fill(NaN);for(let e of k)e.head=0,e.len=0,e.sum=0};function J(e){let i=[];if(!t.enabled||!g)return i;let a=new Set(e),o=h.map(e=>r(e,n).column),s=h.map((e,t)=>o[t]!==null&&a.has(o[t])?null:`formula`in e?e.formula:e.channel).filter(e=>e!==null),c=v;return _=o,y=[...new Set(s)],v=y.length===0,c&&!v&&((b===`active`||b===`clearing`)&&i.push(K(`lost`,C)),b=`idle`,T=null,q()),i}function Y(e,t){for(let n=0;n<i.derived.length;n++){let{i:r,d:a,src:o}=i.derived[n],s=A[o[0]],c=M[o[0]],l=F[r],f=I[r],p=L[r],m=R[r],h=i.needPrev[r],g=E[r],_=D[r],v=O[r];if(a.op===`abs`||a.op===`diff`){let n=a.op===`diff`,i=n?A[o[1]]:s,u=n?M[o[1]]:c;if((c===U||u===U)&&!h){if(n)for(let t=0;t<e;t++)l[t]=s[t]-i[t];else for(let t=0;t<e;t++)l[t]=Math.abs(s[t]);O[r]=e>=2?l[e-2]:E[r],E[r]=l[e-1],D[r]=t[e-1],A[r]=l,j[r]=t,M[r]=U,N[r]=m;continue}for(let r=0;r<e;r++)c[r]||n&&u[r]?(v=g,g=n?s[r]-i[r]:Math.abs(s[r]),_=t[r],p[r]=1):p[r]=0,l[r]=g,f[r]=_,h&&(m[r]=v)}else{let o=k[n],y=a.windowS;if(a.op===`min`||a.op===`max`){let n=a.op===`max`;for(let r=0;r<e;r++){let e=t[r],i=e-y,a=c[r]===1,u=s[r];if(a){for(;o.len&&(n?o.x[o.head+o.len-1&o.mask]<=u:o.x[o.head+o.len-1&o.mask]>=u);)o.len--;d(o,e,u)}for(;o.len&&o.t[o.head]<i;)o.head=o.head+1&o.mask,o.len--;if(a){let t=o.x[o.head];v=g,g=t,t===t&&(_=e),p[r]=1}else p[r]=0;l[r]=g,f[r]=_,h&&(m[r]=v)}}else{let n=a.op===`mean`,d=o.len;z.length<d+e&&(z=new Float64Array(2*(d+e)),B=new Float64Array(2*(d+e)));for(let e=0;e<d;e++){let t=o.head+e&o.mask;z[e]=o.t[t],B[e]=o.x[t]}let b=0,x=d,S=o.sum;if(c===U&&!h&&!i.needAt[r]){for(let r=0;r<e;r++){let e=t[r],i=s[r],a=e-y;if(z[x]=e,B[x]=i,x++,n)for(S+=i;z[b]<a;)S-=B[b],b++;else for(;z[b]<a;)b++;l[r]=g=n?S/(x-b):x-b>=2&&e>z[b]?(i-B[b])/(e-z[b]):NaN}v=e>=2?l[e-2]:E[r];for(let n=e-1;n>=0;n--)if(l[n]===l[n]){_=t[n];break}o.head=0,o.len=0,u(o,z,B,b,x),o.sum=S,E[r]=g,D[r]=_,O[r]=v,A[r]=l,j[r]=t,M[r]=U,N[r]=m;continue}for(let r=0;r<e;r++){if(c[r]===1){let e=t[r],i=s[r],a=e-y;if(z[x]=e,B[x]=i,x++,n)for(S+=i;z[b]<a;)S-=B[b],b++;else for(;z[b]<a;)b++;let o=n?S/(x-b):x-b>=2&&e>z[b]?(i-B[b])/(e-z[b]):NaN;v=g,g=o,o===o&&(_=e),p[r]=1}else p[r]=0;l[r]=g,f[r]=_,h&&(m[r]=v)}o.head=0,o.len=0,u(o,z,B,b,x),o.sum=S}}E[r]=g,D[r]=_,O[r]=v,A[r]=l,j[r]=f,M[r]=p,N[r]=m}}function X(e,t){let n=m!==1/0;for(let r=0;r<i.ops.length;r++){let a=i.ops[r];if(a.k===`all`||a.k===`any`){let t=W[r],n=a.k===`all`,i=a.rest,o=0;for(a.fused||(t.set(W[i[0]].subarray(0,e)),o=1);o<i.length;o++){let r=W[i[o]];if(n)for(let n=0;n<e;n++)r[n]<t[n]&&(t[n]=r[n]);else for(let n=0;n<e;n++)r[n]>t[n]&&(t[n]=r[n])}continue}if(a.k===`not`){let t=W[r],n=W[a.kid];for(let r=0;r<e;r++)t[r]=c-n[r];continue}let o=a,l=A[o.i],u=j[o.i],d=W[o.into],f=o.mode,p=o.prev;switch(a.k){case`noData`:{let n=a.f;for(let r=0;r<e;r++){let e=u[r]===u[r]?t[r]-u[r]>=n?c:0:s;(f===0||(f===2?e>d[r]:e<d[r]))&&(d[r]=e)}break}case`above`:{let r=a.v,i=r-a.h;for(let a=0;a<e;a++){let e=l[a],o;e!==e||n&&t[a]-u[a]>=m&&u[a]!==t[a]?o=s:(e>r?p=c:e<=i&&(p=0),o=p),(f===0||(f===2?o>d[a]:o<d[a]))&&(d[a]=o)}break}case`below`:{let r=a.v,i=r+a.h;for(let a=0;a<e;a++){let e=l[a],o;e!==e||n&&t[a]-u[a]>=m&&u[a]!==t[a]?o=s:(e<r?p=c:e>=i&&(p=0),o=p),(f===0||(f===2?o>d[a]:o<d[a]))&&(d[a]=o)}break}case`outside`:{let r=a.lo,i=a.hi,o=r+a.h,h=i-a.h;for(let a=0;a<e;a++){let e=l[a],g;e!==e||n&&t[a]-u[a]>=m&&u[a]!==t[a]?g=s:(e<r||e>i?p=c:e>=o&&e<=h&&(p=0),g=p),(f===0||(f===2?g>d[a]:g<d[a]))&&(d[a]=g)}break}case`inside`:{let r=a.lo,i=a.hi,o=r-a.h,h=i+a.h;for(let a=0;a<e;a++){let e=l[a],g;e!==e||n&&t[a]-u[a]>=m&&u[a]!==t[a]?g=s:(e>=r&&e<=i?p=c:(e<o||e>h)&&(p=0),g=p),(f===0||(f===2?g>d[a]:g<d[a]))&&(d[a]=g)}break}case`equals`:{let r=a.v;for(let i=0;i<e;i++){let e=l[i],a;a=e!==e||n&&t[i]-u[i]>=m&&u[i]!==t[i]?s:e===r?c:0,(f===0||(f===2?a>d[i]:a<d[i]))&&(d[i]=a)}break}case`changes`:{let r=M[a.i],i=N[a.i];for(let a=0;a<e;a++){let e=l[a],o;if(e!==e||n&&t[a]-u[a]>=m&&u[a]!==t[a])o=s;else{let t=i[a];o=t===t?r[a]&&e!==t?c:0:s}(f===0||(f===2?o>d[a]:o<d[a]))&&(d[a]=o)}break}}a.prev=p}return W[i.ops.length-1]}function Z(e,n,r,a){let o=i.first,l=o?A[o.i]:null;for(let i=0;i<e;i++){let e=r[i];if(b===`idle`){if(e!==c)continue;b=`pending`,x=n[i],T=null}if(l){let e=l[i];if(e===e){let t=o.excess(e);t>0&&(T===null||t>o.excess(T.v))&&(T={v:e,t:n[i]})}}if(e===s)continue;let u=n[i];if(b===`pending`){if(e===0){b=`idle`,T=null;continue}u-x>=t.forS&&(b=`active`,a.push(K(`raised`,x)));continue}if(b===`active`){if(e===c)continue;b=`clearing`,S=u}else if(e===c){b=`active`;continue}u-S>=t.clearForS&&(b=`idle`,a.push(K(`cleared`,S,T?{peak:T}:{})),T=null)}}function Q(e){let n=[];if(!t.enabled||!g||!v)return n;let r=e.t,s=r.length;if(!s)return n;G(s);let c=null,l=_.map(t=>t!==null&&e.columns[t]||(c??=new Float64Array(s).fill(NaN))),u=l.map((t,n)=>o(e,_[n],t)),d=r[0]>C&&a(e)&&u.some(Boolean),f,m;if(d)f=s,m=r,C=r[s-1];else{f=0;for(let e=0;e<s;e++){let t=!1;for(let n=0;n<p;n++)if(l[n][e]===l[n][e]){t=!0;break}if(!t)continue;let n=r[e];if(n<=C){w++;continue}H[f]=e,V[f]=n,f++,C=n}if(!f)return n;m=V}for(let e=0;e<p;e++){let t=l[e],n=i.needPrev[e];if(d&&u[e]){if(n){let n=R[e];n[0]=E[e];for(let e=1;e<f;e++)n[e]=t[e-1];N[e]=n}O[e]=f>=2?t[f-2]:E[e],E[e]=t[f-1],D[e]=r[f-1],A[e]=t,j[e]=r,M[e]=U;continue}let a=F[e],o=I[e],s=L[e],c=R[e],p=E[e],h=D[e],g=O[e];for(let e=0;e<f;e++){let r=t[d?e:H[e]];r===r?(g=p,p=r,h=m[e],s[e]=1):s[e]=0,a[e]=p,o[e]=h,n&&(c[e]=g)}E[e]=p,D[e]=h,O[e]=g,A[e]=a,j[e]=o,M[e]=s,N[e]=c}return Y(f,m),Z(f,m,X(f,m),n),n}function $(e){let n=[];if(!t.enabled||!g||!v||e<=C)return n;G(1);for(let e=0;e<f;e++)F[e][0]=E[e],I[e][0]=D[e],L[e][0]=0,R[e][0]=O[e],A[e]=F[e],j[e]=I[e],M[e]=L[e],N[e]=R[e];return V[0]=e,Z(1,V,X(1,V),n),n}function ee(){let e=t.enabled?g?v?b:`waiting`:`not_applicable`:`disabled`;return{state:e,...e===`waiting`?{missing:y}:{},...b!==`idle`&&v?{since:b===`clearing`?S:x}:{},late:w,lastT:C}}return J([]),{rule:t,target:n,bind:J,push:Q,tick:$,state:ee}}function a(e){let t=e.scan?.get(n);if(t===void 0){let r=e.t;t=!0;for(let e=1;e<r.length;e++)if(!(r[e]>r[e-1])){t=!1;break}e.scan?.set(n,t)}return t}function o(e,t,n){let r=t===null?void 0:e.scan?.get(t);if(r===void 0){r=!0;for(let e=0;e<n.length;e++)if(n[e]!==n[e]){r=!1;break}t!==null&&e.scan?.set(t,r)}return r}var s=1,c=2,l=()=>({t:new Float64Array(16),x:new Float64Array(16),head:0,len:0,mask:15,sum:0});function u(e,t,n,r,i){let a=i-r;if(a<=0)return;if(e.len+a>e.mask+1){let t=e.mask+1;for(;t<e.len+a;)t*=2;let n=new Float64Array(t),r=new Float64Array(t);for(let t=0;t<e.len;t++)n[t]=e.t[e.head+t&e.mask],r[t]=e.x[e.head+t&e.mask];e.t=n,e.x=r,e.head=0,e.mask=t-1}let o=e.head+e.len&e.mask,s=Math.min(a,e.mask+1-o);e.t.set(t.subarray(r,r+s),o),e.x.set(n.subarray(r,r+s),o),s<a&&(e.t.set(t.subarray(r+s,i),0),e.x.set(n.subarray(r+s,i),0)),e.len+=a}function d(e,t,n){if(e.len===e.mask+1){let t=e.len*2,n=new Float64Array(t),r=new Float64Array(t);for(let t=0;t<e.len;t++)n[t]=e.t[e.head+t&e.mask],r[t]=e.x[e.head+t&e.mask];e.t=n,e.x=r,e.head=0,e.mask=t-1}let r=e.head+e.len&e.mask;e.t[r]=t,e.x[r]=n,e.len++}var f=[`above`,`below`,`outside`,`inside`,`equals`,`changes`,`noData`],p=/^[A-Za-z_][A-Za-z0-9_]{0,31}$/,m=[`info`,`warning`,`critical`],h=[`browser`,`collector`,`watcher`,`cloud`],g=e=>typeof e==`number`&&Number.isFinite(e),_=e=>g(e)&&e>=0&&e<=86400;function v(e){let t=[],n=(e,n)=>{t.push({code:e,path:n})};if(!e||typeof e!=`object`)return[{code:`not_a_rule`,path:``}];let r=e;r.kyr!==1&&n(`unsupported_version`,`kyr`),(typeof r.id!=`string`||!r.id)&&n(`bad_id`,`id`),(!Number.isInteger(r.version)||r.version<1)&&n(`bad_version`,`version`),(typeof r.name!=`string`||!r.name.trim()||r.name.length>120)&&n(`bad_name`,`name`),m.includes(r.severity)||n(`bad_severity`,`severity`);for(let e of[`forS`,`clearForS`])_(r[e])||n(`bad_duration`,e);r.staleS!=null&&!_(r.staleS)&&n(`bad_duration`,`staleS`),(!Array.isArray(r.runWhere)||!r.runWhere.length||!r.runWhere.every(e=>h.includes(e)))&&n(`bad_run_where`,`runWhere`);let i=new Map,a=r.signals&&typeof r.signals==`object`?r.signals:{};Object.keys(a).length||n(`no_signals`,`signals`);for(let[e,t]of Object.entries(a)){p.test(e)||n(`bad_alias`,`signals.${e}`),i.set(e,`signal`);let a=t&&typeof t==`object`?t:{};`formula`in a?((typeof a.formula!=`string`||!a.formula)&&n(`bad_channel`,`signals.${e}`),Array.isArray(r.runWhere)&&r.runWhere.length===1&&r.runWhere[0]===`browser`||n(`formula_browser_only`,`signals.${e}`)):(typeof a.channel!=`string`||!a.channel||a.channel.length>200)&&n(`bad_channel`,`signals.${e}`)}let o=r.derived&&typeof r.derived==`object`?r.derived:{};for(let e of Object.keys(o))p.test(e)||n(`bad_alias`,`derived.${e}`),i.has(e)&&n(`duplicate_alias`,`derived.${e}`),i.set(e,`derived`);let s=e=>e.op===`diff`?[e.a,e.b]:[e.of],c=new Set;for(let[e,t]of Object.entries(o)){let r=t&&typeof t==`object`?t:{};if(![`rate`,`mean`,`min`,`max`,`abs`,`diff`].includes(r.op)){n(`bad_derived`,`derived.${e}`);continue}c.add(e),[`rate`,`mean`,`min`,`max`].includes(r.op)&&!(_(r.windowS)&&r.windowS>0)&&n(`bad_duration`,`derived.${e}.windowS`);for(let t of s(r))(typeof t!=`string`||!i.has(t))&&n(`unknown_alias`,`derived.${e}`)}let l=new Set,u=new Set,d=e=>{if(u.has(e)||i.get(e)!==`derived`||!c.has(e))return!0;if(l.has(e))return!1;l.add(e);let t=s(o[e]).every(e=>typeof e!=`string`||d(e));return l.delete(e),u.add(e),t};for(let e of Object.keys(o))if(!d(e)){n(`derived_cycle`,`derived.${e}`);break}let v=0,y=(e,t,r)=>{if(!e||typeof e!=`object`)return n(`bad_condition`,t);let a=e;for(let e of[`all`,`any`])if(e in a)return r>=3?n(`too_deep`,t):!Array.isArray(a[e])||!a[e].length?n(`bad_condition`,t):a[e].forEach((n,i)=>y(n,`${t}.${e}[${i}]`,r+1));if(`not`in a)return r>=3?n(`too_deep`,t):y(a.not,`${t}.not`,r+1);let o=f.find(e=>e in a);if(!o)return n(`unsupported_condition`,t);v++,(typeof a[o]!=`string`||!i.has(a[o]))&&n(`unknown_alias`,t),a.hysteresis!=null&&!(g(a.hysteresis)&&a.hysteresis>=0)&&n(`bad_hysteresis`,t),(o===`above`||o===`below`||o===`equals`)&&!g(a.value)&&n(`bad_value`,t),(o===`outside`||o===`inside`)&&!(g(a.lo)&&g(a.hi)&&a.lo<a.hi)&&n(`bad_band`,t),o===`noData`&&!_(a.forS)&&n(`bad_duration`,`${t}.forS`)};return y(r.when,`when`,0),v>16&&n(`too_many_leaves`,`when`),t}function y(e){let t=e.when;for(;t&&typeof t==`object`;)if(`all`in t)t=t.all[0];else if(`any`in t)t=t.any[0];else if(`not`in t)return null;else break;return t?`above`in t||`below`in t?Number.isFinite(t.value)?t.value:null:`outside`in t&&Number.isFinite(t.hi)?t.hi:null:null}export{i,v as n,f as r,y as t};

package/dist/types/charts/AnnotationLayer.d.ts

@@ -1,4 +1,5 @@
-import type { AnnotationTool, ChartAnnotation } from '../lib/annotations';
+import { type AnnotationTool, type ChartAnnotation } from '../lib/annotations';
+import type { ChartMark } from '../engine/alerts';
 import { type PlotFrame, type PlotFrameStore } from '../lib/render/plotFrame';
 interface Props {
     annotations: ChartAnnotation[];
@@ -8,13 +9,17 @@ interface Props {
     /** Escape pressed with a tool set. */
     onToolEnd: () => void;
     onSelect: (id: string | null) => void;
+    /** Alert marks (read-only, under the annotations); only drawn on a chart with an X frame. */
+    marks?: ChartMark[];
+    /** A press on a mark's top strip: its rule id. */
+    onMarkSelect?: (ruleId: string) => void;
 }
 type Pt = [number, number];
 /** Elements outside the chart marked with this attribute keep the selection when pressed (a host's style controls). */
 export declare const ANNOTATION_CONTROLS_ATTR = "data-kymo-annotation-controls";
 /** Pixel positions of an annotation's points (null: pinned to X on a chart without an X frame now). */
 export declare function annotationPx(a: ChartAnnotation, W: number, H: number, frame: PlotFrame | null): Pt[] | null;
-export declare const AnnotationLayer: import("react").MemoExoticComponent<({ annotations, tool, plotFrame, onChange, onToolEnd, onSelect }: Props) => import("react/jsx-runtime").JSX.Element>;
+export declare const AnnotationLayer: import("react").MemoExoticComponent<({ annotations, tool, plotFrame, onChange, onToolEnd, onSelect, marks: alertList, onMarkSelect }: Props) => import("react/jsx-runtime").JSX.Element>;
 /** A smooth path through the stroke's points (quadratic curves through the midpoints). */
 export declare function brushPath(px: Pt[]): string;
 /** Head of an arrow ending at (x1, y1): its outline and where the shaft should stop. */

package/dist/types/charts/CameraPanel.d.ts

@@ -0,0 +1,43 @@
+import { type CameraPanelSettings } from '../lib/panelChartSettings';
+import type { LiveConnection } from '../lib/live/types';
+import { type VideoSource } from '../lib/live/videoTrack';
+import type { LoadedDataset } from '../types/loadedDataset';
+/** The worksheet's shared chart cursor (engine.view.cursorX), in X data units. */
+export interface CameraCursor {
+    get(): number | null;
+    subscribe(fn: (x: number | null) => void): () => void;
+}
+/** A cloud recording the worksheet shows: its selected recording dataset's wall clock (importer meta) and X shift. */
+export interface CameraRecording {
+    recordingId: string;
+    /** Unix seconds at X = 0 (info.meta.wallOrigin); null when the recording doesn't say. */
+    wallOrigin: number | null;
+    wallQuality: 'exact' | 'approx' | null;
+    /** The dataset's X offset (engine.datasets offset), subtracted from the cursor. */
+    xOffset: number;
+}
+/** The selected datasets that are cloud recordings, in selection order. */
+export declare function cameraRecordings(datasets: readonly LoadedDataset[], offsets: Readonly<Record<string, number>>): CameraRecording[];
+export interface CameraPanelProps {
+    settings: CameraPanelSettings;
+    /** Every live connection (cameras and data streams). */
+    live: LiveConnection[];
+    /** Plotted ids: the first selected data stream is the default sync stream. */
+    selection: string[];
+    /** The worksheet's X range; null = following live. */
+    viewXRange: [number, number] | null;
+    /** The worksheet's X axis is stream time (only then can a cursor map to a frame). */
+    xIsTime: boolean;
+    /** The worksheet's X key: a recording maps its 'Time' (or an exact ElapsedTime) to wall time. */
+    xKey?: string;
+    /** Every video source (engine.video.sources()): recorded cameras play from here. */
+    video?: VideoSource[];
+    /** The recordings the worksheet shows: a camera recorded with one of them plays recorded instead of live. */
+    recordings?: CameraRecording[];
+    cursor?: CameraCursor;
+    onContextMenu?: (e: {
+        clientX: number;
+        clientY: number;
+    }) => void;
+}
+export declare function CameraPanel(p: CameraPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/charts/ChartBody.d.ts

@@ -7,6 +7,8 @@ import type { ReactNode, Ref } from 'react';
 import type { DashboardPanel } from '../components/dashboardGridLayout';
 import { type PanelChartSettings } from '../lib/panelChartSettings';
 import { type XYZMeshChartHandle } from '../components/XYZMeshChart';
+import { type CameraCursor, type CameraRecording } from './CameraPanel';
+import type { VideoSource } from '../lib/live/videoTrack';
 import type { LiveZoomBus } from '../lib/render/liveZoomBus';
 import { type WorksheetData } from './useWorksheetData';
 import type { LiveConnection } from '../lib/live/types';
@@ -29,6 +31,8 @@ export interface ChartBodyProps {
     height: number;
     viewXRange: [number, number] | null;
     onViewXRangeChange: (r: [number, number] | null) => void;
+    /** Multiband hover: the shared cursor X of the worksheet (engine.view.setCursorX). */
+    onCursorX?: (x: number | null) => void;
     liveZoom: LiveZoomBus;
     liveWindowSeconds: number | null;
     onLiveWindowChange: (seconds: number | null) => void;
@@ -36,6 +40,14 @@ export interface ChartBodyProps {
     beaconLive: LiveConnection | null;
     /** A loaded dataset or lap by id (beacon reference data). */
     findDataset: (id: string) => LoadedDataset | undefined;
+    /** Every live connection and the plotted ids (camera panels). */
+    live?: LiveConnection[];
+    selection?: string[];
+    /** The worksheet's shared cursor (camera panels follow it). */
+    cursor?: CameraCursor;
+    /** engine.video.sources() and the recordings the worksheet shows (camera panels play recorded cameras). */
+    video?: VideoSource[];
+    recordings?: CameraRecording[];
     shiftMode?: {
         label: string;
         onDragStart: () => void;

package/dist/types/charts/beacon.d.ts

@@ -3,7 +3,7 @@
  * over — a lap, a battery cycle…) is drawn, with reference data behind it — a
  * loaded dataset, the previous cycle, or nothing (the chart restarts every cycle).
  */
-import type { LiveChartSource } from '../components/MultiBandCanvasChart';
+import type { LiveChartSource, MultibandEnvelope } from '../components/MultiBandCanvasChart';
 import { type PointColumns } from '../lib/data/pointColumns';
 import type { LiveConnection } from '../lib/live/types';
 import type { LoadedDataset } from '../types/loadedDataset';
@@ -25,3 +25,6 @@ export declare function datasetReference(ds: LoadedDataset, xKey: string, cols:
 export declare function beaconLiveSource(conn: LiveConnection, xKey: string, cols: string[], beacon: BeaconSettings, refDataset: LoadedDataset | undefined): LiveChartSource;
 /** Colour of the active reference, or null when nothing is drawn behind. */
 export declare function referenceColor(beacon: BeaconSettings, hasDataset: boolean): string | null;
+/** A dataset's bands (a reference's envelope) as chart envelopes: for each plotted series whose column has one, shaded
+ *  in `color` (else the series' own) on the dataset's X column, moved by its offset. */
+export declare function referenceBands(ds: Pick<LoadedDataset, 'data' | 'bands'>, xKey: string, series: PlotSeries[], color?: string, offset?: number): MultibandEnvelope[];

package/dist/types/charts/cameraLayout.d.ts

@@ -0,0 +1,10 @@
+/** Camera panel geometry: when a panel is small enough for a camera's low layer. */
+/** Narrower than this (CSS px) a panel plays a camera's low layer; it goes back to full quality at UP_PX (no flapping). */
+export declare const LOW_BELOW_PX = 640;
+/** Whether a panel `width` px wide is small, given whether it was (hysteresis between LOW_BELOW_PX and UP_PX). */
+export declare function smallPanel(width: number, wasSmall: boolean): boolean;
+/** A wall's grid for `n` cameras: 1, 2 side by side, 2x2 up to 4, 3x3 up to 9. */
+export declare function wallGrid(n: number): {
+    cols: number;
+    rows: number;
+};

package/dist/types/charts/liveOverlay.d.ts

@@ -7,6 +7,20 @@
 import type { LiveChartSource } from '../components/MultiBandCanvasChart';
 import { type PointColumns } from '../lib/data/pointColumns';
 import type { LiveConnection } from '../lib/live/types';
+/** A live stream a multiband chart pulls itself: its series key suffix (`__N`, its overlay index) and X offset. */
+export interface LiveOverlay {
+    conn: LiveConnection;
+    keySuffix: string;
+    offset: number;
+}
+/**
+ * The selected live streams a multiband chart pulls every frame as overlays, or null (a single stream alone has its
+ * own path; the rest draw the streams' row snapshots): one stream over in-memory datasets, after them; or several
+ * streams alone on time, each on its own clock (X is each one's own time).
+ */
+export declare function liveOverlayStreams(live: LiveConnection[], datasets: number, anyDuckDb: boolean, xKey: string, offsets: Record<string, number>): LiveOverlay[] | null;
+/** {@link liveOverlaySource} for several streams: every stream's layers after the datasets', X over all of them. */
+export declare function liveOverlaysSource(streams: LiveOverlay[], xKey: string, cols: string[], staticLayers: PointColumns[], staticRange: [number, number] | null): LiveChartSource;
 export declare function liveOverlaySource(conn: LiveConnection, xKey: string, cols: string[], 
 /** Series key suffix of the stream (`__N`, its overlay index). */
 keySuffix: string, 

package/dist/types/charts/runtime.d.ts

@@ -1,6 +1,8 @@
 import { type KymoscopeEngine } from '../engine/createEngine';
 import { type ChartStatus, type ContextMenuEvent } from './ChartBody';
-import type { AnnotationTool } from '../lib/annotations';
+import { type AnnotationTool, type ChartAnnotation } from '../lib/annotations';
+import type { ChartMark } from '../engine/alerts';
+import { type PlotFrame } from '../lib/render/plotFrame';
 export interface ChartStyle {
     /** Plot background (overrides the chart's own background setting). */
     background?: string;
@@ -26,6 +28,8 @@ export interface ChartViewEvents extends Record<string, unknown> {
     annotationtool: AnnotationTool | null;
     /** An annotation was selected in the chart (its id), or the selection ended (null). */
     annotationselect: string | null;
+    /** An alert mark's top strip was pressed: the rule's id. */
+    markselect: string;
 }
 export interface ChartView {
     readonly chartId: string;
@@ -61,3 +65,10 @@ export declare function mountChart(engine: KymoscopeEngine, chartId: string, ele
 export declare function refreshCharts(engine: KymoscopeEngine): void;
 /** Tear down every chart of an engine (called by engine.dispose()). */
 export declare function disposeCharts(engine: KymoscopeEngine): void;
+/**
+ * The alert marks a chart shows: those of a plotted dataset or stream whose rule ran on the chart's X key (D6: a chart
+ * on another axis has no time relation). Memoised on its inputs so charts don't redraw for nothing.
+ */
+export declare const chartMarks: (a: ChartMark[], b: string[], c: string) => ChartMark[];
+/** What PNG export paints: the alert marks (under) and the chart's annotations; open marks end at the plot's edge. */
+export declare function exportNotes(notes: ChartAnnotation[], marks: ChartMark[], frame: PlotFrame | null): ChartAnnotation[];

package/dist/types/charts/useWorksheetData.d.ts

@@ -51,6 +51,8 @@ export declare function staticXExtent(parts: {
     rows: Record<string, unknown>[];
     offset: number;
 }[], xKey: string): [number, number] | null;
+/** Unit per column, plus each column's suffixed key (e.g. "FZ__0") per overlaid source. */
+export declare function overlayColumnUnits(data: Pick<Dataset, 'columnNames' | 'units'>, sources: number): Record<string, string>;
 /**
  * Rows of the current lap on a wrapping X: from the last sample where X drops by
  * more than half its range (lap distance at the finish line). A channel that
@@ -65,11 +67,7 @@ export declare function useWorksheetData(input: WorksheetDataInput): {
     anyDuckDb: boolean;
     duckDbLayers: DuckDbLayerSpec[];
     liveConn: LiveConnection | null;
-    liveOverlay: {
-        conn: LiveConnection;
-        keySuffix: string;
-        offset: number;
-    } | null;
+    liveOverlays: import("./liveOverlay").LiveOverlay[] | null;
     hasLiveSelected: boolean;
     staticXRange: [number, number] | null;
     xUnit: string;

package/dist/types/components/GaugeChart.d.ts

@@ -35,3 +35,5 @@ export interface GaugeChartProps {
     }) => void;
 }
 export declare function GaugeChart({ gauges, live, backgroundToken, onPlotContextMenu }: GaugeChartProps): import("react/jsx-runtime").JSX.Element;
+/** Past the alarm: for a line linked to an alert rule, while the rule is active (spec §6.1); else value >= line. */
+export declare const alarmed: (g: Pick<GaugeReading, "value">, al: AlarmLine | null) => boolean;

package/dist/types/components/MultiBandCanvasChart.d.ts

@@ -46,7 +46,7 @@ export interface LiveChartSource {
 }
 /**
  * Per-series X gap threshold: consecutive valid points farther apart than this
- * are not joined by a line. Derived from the series' OWN median spacing so a
+ * are not joined by a line. Derived from the series' OWN mean spacing so a
  * co-plotted source at a different sample rate can't shrink it — a global
  * threshold lets a dense live feed collapse the bound below an imported
  * dataset's spacing and shatter that line into disconnected dots.
@@ -152,5 +152,7 @@ export interface MultiBandCanvasChartProps {
      *  whenever it changes. Lets an out-of-core parent size its decimation budget
      *  to the actual on-screen resolution instead of a fixed overdrawn count. */
     onPlotWidthCss?: (cssWidth: number) => void;
+    /** The hovered X in data units (null when the cursor leaves the plot), at most once per frame. */
+    onCursorX?: (x: number | null) => void;
 }
-export declare function MultiBandCanvasChart({ xLabel, series, points, columnUnits, height, onPlotContextMenu, backgroundToken, viewXRange, onViewXRangeChange, liveZoom, liveZoomId, fullXRange, shiftMode, xAxisLine, yAxisLine, gridLine, lineWidth, envelopes, showLatestValues, liveSource, liveWindowSeconds, onLiveWindowChange, liveZoomMode, onPlotWidthCss, }: MultiBandCanvasChartProps): import("react/jsx-runtime").JSX.Element;
+export declare function MultiBandCanvasChart({ xLabel, series, points, columnUnits, height, onPlotContextMenu, backgroundToken, viewXRange, onViewXRangeChange, liveZoom, liveZoomId, fullXRange, shiftMode, xAxisLine, yAxisLine, gridLine, lineWidth, envelopes, showLatestValues, liveSource, liveWindowSeconds, onLiveWindowChange, liveZoomMode, onPlotWidthCss, onCursorX, }: MultiBandCanvasChartProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/dashboardGridLayout.d.ts

@@ -7,7 +7,7 @@ export declare const DASHBOARD_ROW_HEIGHT_PX = 4;
 export declare const DASHBOARD_GRID_GAP_PX = 2;
 /** Hard cap on the number of charts we auto-arrange. */
 export declare const MAX_DASHBOARD_PANELS = 16;
-export type DashboardPanelKind = 'multiband' | 'xyscatter' | 'xyzmesh' | 'histogram' | 'polar' | 'spectrum' | 'boxplot' | 'spectrogram' | 'heatmap' | 'violin' | 'confusion' | 'roc' | 'losscurve' | 'controlchart' | 'parallelcoords' | 'embedding' | 'flamegraph' | 'barchart' | 'radar' | 'areachart' | 'cdfchart' | 'bubblechart' | 'treemap' | 'sankey' | 'calibration' | 'qqplot' | 'gantt' | 'gauge';
+export type DashboardPanelKind = 'multiband' | 'xyscatter' | 'xyzmesh' | 'histogram' | 'polar' | 'spectrum' | 'boxplot' | 'spectrogram' | 'heatmap' | 'violin' | 'confusion' | 'roc' | 'losscurve' | 'controlchart' | 'parallelcoords' | 'embedding' | 'flamegraph' | 'barchart' | 'radar' | 'areachart' | 'cdfchart' | 'bubblechart' | 'treemap' | 'sankey' | 'calibration' | 'qqplot' | 'gantt' | 'gauge' | 'camera';
 export interface DashboardGridRect {
     x: number;
     y: number;

package/dist/types/components/multiBandHover.d.ts

@@ -1,4 +1,11 @@
 import type { PointColumns } from '../lib/data/pointColumns';
+/**
+ * Sends the hovered X (or null) at most once per animation frame, the newest
+ * value winning. With no frame scheduler (no window: tests, node) it sends at once.
+ */
+export declare function createCursorEmitter(send: (x: number | null) => void, schedule?: ((cb: () => void) => void) | null): {
+    set(x: number | null): void;
+};
 /** X in data units under a cursor pixel, for the current view. */
 export declare function dataXAtPx(px: number, left: number, plotW: number, xmin: number, xmax: number): number;
 /**