semiotic 3.8.0 → 3.8.2

package/dist/chunk-chunk-ZLKRTF5N.module.min.js

@@ -0,0 +1,2 @@
+"use client";
+import{renderRectPulse as t}from"./chunk-chunk-FAKO3RGQ.module.min.js";import{buildLinearFillGradient as e,clampCornerRadii as n,filterSparseArray as s,hasAnyCornerRadius as i,resolveCSSColor as o,resolveCanvasFill as r,symbolPathString as l}from"./chunk-chunk-ODUZEEBH.module.min.js";var h=class{constructor(){this._min=1/0,this._max=-1/0,this._dirty=!1}push(t){Number.isFinite(t)&&(this._min>t&&(this._min=t),t>this._max&&(this._max=t))}evict(t){t!==this._min&&t!==this._max||(this._dirty=!0)}recalculate(t,e){this._min=1/0,this._max=-1/0;for(const n of t){const t=e?e(n):n;Number.isFinite(t)&&(this._min>t&&(this._min=t),t>this._max&&(this._max=t))}this._dirty=!1}clear(){this._min=1/0,this._max=-1/0,this._dirty=!1}get extent(){return[this._min,this._max]}get min(){return this._min}get max(){return this._max}get dirty(){return this._dirty}},u=class{constructor(t,e){this.lastBoundedData=null,this.chunkTimer=0,this.pushBuffer=[],this.flushScheduled=!1,this.callback=t,this.chunkThreshold=e?.chunkThreshold??5e3,this.chunkSize=e?.chunkSize??5e3}updateChunkOptions(t){null!=t.chunkThreshold&&(this.chunkThreshold=t.chunkThreshold),null!=t.chunkSize&&(this.chunkSize=t.chunkSize)}clearLastData(){this.lastBoundedData=null,this.pushBuffer=[],this.flushScheduled=!1,this.chunkTimer&&(cancelAnimationFrame(this.chunkTimer),this.chunkTimer=0)}setBoundedData(t){if(t=s(t),this.lastBoundedData===t)return;if(this.lastBoundedData=t,this.chunkTimer&&(cancelAnimationFrame(this.chunkTimer),this.chunkTimer=0),this.chunkThreshold>=t.length)return void this.callback({inserts:t,bounded:!0});this.callback({inserts:t.slice(0,this.chunkSize),bounded:!0,totalSize:t.length});let e=this.chunkSize;const n=()=>{if(e>=t.length)return void(this.chunkTimer=0);if(t!==this.lastBoundedData)return void(this.chunkTimer=0);const s=Math.min(e+this.chunkSize,t.length);this.callback({inserts:t.slice(e,s),bounded:!1}),e=s,this.chunkTimer=t.length>e?requestAnimationFrame(n):0};this.chunkTimer=requestAnimationFrame(n)}setReplacementData(t){if(t=s(t),this.lastBoundedData=t,this.chunkTimer&&(cancelAnimationFrame(this.chunkTimer),this.chunkTimer=0),this.pushBuffer=[],this.flushScheduled=!1,this.chunkThreshold>=t.length)return void this.callback({inserts:t,bounded:!0,preserveCategoryOrder:!0});this.callback({inserts:t.slice(0,this.chunkSize),bounded:!0,preserveCategoryOrder:!0,totalSize:t.length});let e=this.chunkSize;const n=()=>{if(e>=t.length)return void(this.chunkTimer=0);if(t!==this.lastBoundedData)return void(this.chunkTimer=0);const s=Math.min(e+this.chunkSize,t.length);this.callback({inserts:t.slice(e,s),bounded:!1}),e=s,this.chunkTimer=t.length>e?requestAnimationFrame(n):0};this.chunkTimer=requestAnimationFrame(n)}flushPushBuffer(){if(this.flushScheduled=!1,0===this.pushBuffer.length)return;const t=this.pushBuffer;this.pushBuffer=[],this.callback({inserts:t,bounded:!1})}scheduleFlush(){this.flushScheduled||(this.flushScheduled=!0,queueMicrotask(()=>this.flushPushBuffer()))}push(t){null!=t&&"object"==typeof t&&(this.pushBuffer.push(t),this.scheduleFlush())}pushMany(t){if(0===t.length)return;let e=0;for(let n=0;t.length>n;n++){const s=t[n];null!=s&&"object"==typeof s&&(this.pushBuffer.push(s),e++)}0!==e&&this.scheduleFlush()}flush(){this.flushPushBuffer()}clear(){this.chunkTimer&&(cancelAnimationFrame(this.chunkTimer),this.chunkTimer=0),this.lastBoundedData=null,this.pushBuffer=[],this.flushScheduled=!1}};function c(t,e){return t===e}function a(t,e){if("function"==typeof t)return e=>+t(e);const n=t||e;return t=>+t[n]}function f(t,e){if("function"==typeof t)return t;const n=t||e;return t=>t[n]}function y(t,e){return"function"==typeof t?t:t?e=>e[t]+"":e?t=>t[e]+"":void 0}function d(t,e,n,s){return"function"==typeof t?t({size:e,margin:n,scales:s}):t}function m(t,e,n,s){return"string"==typeof t?{key:t,fn:null}:"function"==typeof t?{key:n,fn:t}:"string"==typeof e?{key:e,fn:null}:"function"==typeof e?{key:s,fn:e}:{key:void 0,fn:null}}function p(t,e,n){return s=>{if(!s||!n||!t.fn&&!e.fn)return s;let i=!1;const o=s.map(n=>{const s=t.fn&&t.key&&!(t.key in n),o=e.fn&&e.key&&!(e.key in n);if(!s&&!o)return n;i=!0;const r={...n};return s&&(r[t.key]=t.fn(n)),o&&(r[e.key]=e.fn(n)),r});return i?o:s}}function k(t){return new Set(Array.isArray(t)?t:[t])}function g(t,e,n){return"exact"===n?function(t,e){const n=t.domain(),s=n[0],i=n[n.length-1],o=s instanceof Date,r=s instanceof Date?s.getTime():s,l=i instanceof Date?i.getTime():i;if(2>e||r===l)return o?[new Date(r),new Date(l)]:[r,l];const h=(l-r)/(e-1),u=Array(e);for(let t=0;e>t;t++){const n=t===e-1?l:r+t*h;u[t]=o?new Date(n):n}return u}(t,e):t.ticks(e)}var T=new Map;function x(t){try{if(t.path)return new Path2D(t.path);const e=`${t.symbolType??"circle"}:${Math.round(t.size)}`;let n=T.get(e);return n||(n=new Path2D(l(t.symbolType,t.size)),T.size>256&&T.clear(),T.set(e,n)),n}catch{return null}}var b=(t,e)=>{const n=t.globalAlpha;for(const s of e){if("symbol"!==s.type)continue;const e=s;if(0>=e.size)continue;const i=x(e);if(!i)continue;t.save(),t.translate(e.x,e.y),e.rotation&&t.rotate(e.rotation);const o=(e.style.opacity??1)*(e._decayOpacity??1);e.style.fill&&(t.globalAlpha=n*o*(e.style.fillOpacity??1),t.fillStyle=r(t,e.style.fill,"#4e79a7"),t.fill(i)),e.style.stroke&&"none"!==e.style.stroke&&(t.globalAlpha=n*o,t.strokeStyle=r(t,e.style.stroke,e.style.stroke),t.lineWidth=e.style.strokeWidth??1,t.stroke(i)),t.restore()}t.globalAlpha=n};function w(t,e){const{x:s,y:i,w:o,h:r}=e,{tl:l,tr:h,br:u,bl:c}=n(e);t.beginPath(),t.moveTo(s+l,i),t.lineTo(s+o-h,i),h>0&&t.arcTo(s+o,i,s+o,i+h,h),t.lineTo(s+o,i+r-u),u>0&&t.arcTo(s+o,i+r,s+o-u,i+r,u),t.lineTo(s+c,i+r),c>0&&t.arcTo(s,i+r,s,i+r-c,c),t.lineTo(s,i+l),l>0&&t.arcTo(s,i,s+l,i,l),t.closePath()}function v(t){switch(t.roundedEdge){case"bottom":return{x0:t.x,y0:t.y+t.h,x1:t.x,y1:t.y};case"right":return{x0:t.x+t.w,y0:t.y,x1:t.x,y1:t.y};case"left":return{x0:t.x,y0:t.y,x1:t.x+t.w,y1:t.y};default:return{x0:t.x,y0:t.y,x1:t.x,y1:t.y+t.h}}}var S=(n,s,l,h)=>{const u=s.filter(t=>"rect"===t.type);for(const s of u){if(null!=s.style.opacity&&(n.globalAlpha=s.style.opacity),s.style.icon)F(n,s);else if(s.cornerRadii&&i(s.cornerRadii)){const t=r(n,s.style.fill,o(n,"var(--semiotic-primary, #007bff)")),i=v(s),l=s.fillGradient&&"string"==typeof t?e(n,s.fillGradient,t,i.x0,i.y0,i.x1,i.y1):null;n.fillStyle=l||t,w(n,s),n.fill(),s.style.stroke&&"none"!==s.style.stroke&&(n.strokeStyle=o(n,s.style.stroke)||s.style.stroke,n.lineWidth=s.style.strokeWidth||1,n.stroke())}else if(s.roundedTop&&s.roundedTop>0){const t=r(n,s.style.fill,o(n,"var(--semiotic-primary, #007bff)")),i=v(s),l=s.fillGradient&&"string"==typeof t?e(n,s.fillGradient,t,i.x0,i.y0,i.x1,i.y1):null;n.fillStyle=l||t;const h=Math.min(s.roundedTop,s.w/2,s.h/2);n.beginPath();const{x:u,y:c,w:a,h:f}=s;switch(s.roundedEdge){case"right":n.moveTo(u,c),n.lineTo(u+a-h,c),n.arcTo(u+a,c,u+a,c+h,h),n.lineTo(u+a,c+f-h),n.arcTo(u+a,c+f,u+a-h,c+f,h),n.lineTo(u,c+f);break;case"left":n.moveTo(u+a,c),n.lineTo(u+h,c),n.arcTo(u,c,u,c+h,h),n.lineTo(u,c+f-h),n.arcTo(u,c+f,u+h,c+f,h),n.lineTo(u+a,c+f);break;case"bottom":n.moveTo(u,c),n.lineTo(u+a,c),n.lineTo(u+a,c+f-h),n.arcTo(u+a,c+f,u+a-h,c+f,h),n.lineTo(u+h,c+f),n.arcTo(u,c+f,u,c+f-h,h);break;default:n.moveTo(u,c+f),n.lineTo(u,c+h),n.arcTo(u,c,u+h,c,h),n.lineTo(u+a-h,c),n.arcTo(u+a,c,u+a,c+h,h),n.lineTo(u+a,c+f)}n.closePath(),n.fill(),s.style.stroke&&"none"!==s.style.stroke&&(n.strokeStyle=o(n,s.style.stroke)||s.style.stroke,n.lineWidth=s.style.strokeWidth||1,n.stroke())}else{const t=r(n,s.style.fill,o(n,"var(--semiotic-primary, #007bff)")),i=v(s),l=s.fillGradient&&"string"==typeof t?e(n,s.fillGradient,t,i.x0,i.y0,i.x1,i.y1):null;n.fillStyle=l||t,n.fillRect(s.x,s.y,s.w,s.h),s.style.stroke&&"none"!==s.style.stroke&&(n.strokeStyle=o(n,s.style.stroke)||s.style.stroke,n.lineWidth=s.style.strokeWidth||1,n.strokeRect(s.x,s.y,s.w,s.h))}t(n,s),n.globalAlpha=1}};function F(t,e){const n=e.style.icon,s=e.style.iconPadding||2,i=Math.min(e.w,e.h)-s;if(0>=i)return;const o=e.h>e.w;if(t.save(),t.beginPath(),t.rect(e.x,e.y,e.w,e.h),t.clip(),o){const o=i+s,r=e.x+(e.w-i)/2;for(let s=e.y+e.h-i;s>=e.y-i;s-=o)t.drawImage(n,r,s,i,i)}else{const o=i+s,r=e.y+(e.h-i)/2;for(let s=e.x;e.x+e.w>s;s+=o)t.drawImage(n,s,r,i,i)}t.restore()}function _(t,e,n,s,i,o){const r=[];for(const i of t){const t=n(i),o=s(i);Number.isFinite(t)&&Number.isFinite(o)&&r.push({px:e.x(t),py:e.y(o),rawY:o,d:i})}r.sort((t,e)=>t.px-e.px);const l=Array(r.length),h=Array(r.length),u=Array(r.length);for(let t=0;r.length>t;t++){const e=r[t];l[t]=[e.px,e.py],h[t]=e.rawY,u[t]=e.d}return{type:"line",path:l,rawValues:h,style:i,datum:u,group:o}}function A(t,e,n,s,i,o,r,l){const h=[];for(const o of t){const t=n(o),r=s(o);if(!Number.isFinite(t)||!Number.isFinite(r))continue;const u=e.x(t),c=l?l(o):i;h.push({px:u,topY:e.y(r),botY:e.y(c)})}h.sort((t,e)=>t.px-e.px);const u=Array(h.length),c=Array(h.length);for(let t=0;h.length>t;t++){const e=h[t];u[t]=[e.px,e.topY],c[t]=[e.px,e.botY]}return{type:"area",topPath:u,bottomPath:c,style:o,datum:t,group:r}}function B(t,e,n,s){const i=new Map;if("silhouette"===s)for(const s of t){let t=0;for(const i of e)t+=n(i,s)||0;i.set(s,-t/2)}else if("wiggle"===s){t.length>0&&i.set(t[0],0);for(let s=1;t.length>s;s++){const o=t[s-1],r=t[s];let l=0,h=0,u=0;for(const t of e){const e=n(t,r)||0;l+=(2*u+e)*(e-(n(t,o)||0)),h+=e,u+=e}const c=i.get(o)??0;i.set(r,c-(h>0?l/(2*h):0))}if(t.length>0){let s=0;for(const o of t){let t=0;for(const s of e)t+=n(s,o)||0;s+=(i.get(o)??0)+t/2}const o=s/t.length;for(const e of t)i.set(e,(i.get(e)??0)-o)}}else for(const e of t)i.set(e,0);return i}function z(t,e,n){let s=0,i=0;for(const o of t){let t=0,r=0;for(const s of e){const e=n(s,o)||0;0>e?r+=e:t+=e}s>r&&(s=r),t>i&&(i=t)}return[s,i]}function D(t,e,n,s,i,o,r,l="zero"){const h=new Set;for(const e of t)for(const t of e.data){const e=n(t);Number.isFinite(e)&&h.add(e)}const u=Array.from(h).sort((t,e)=>t-e),c=new Map;for(const e of t){const t=new Map;for(const i of e.data){const e=n(i),o=s(i);Number.isFinite(e)&&Number.isFinite(o)&&t.set(e,(t.get(e)||0)+o)}c.set(e.key,t)}let a;if(o){a=new Map;for(const e of u){let n=0;for(const s of t)n+=c.get(s.key)?.get(e)||0;a.set(e,n||1)}}const f=B(u,t.map(t=>t.key),(t,e)=>c.get(t)?.get(e)||0,l),y="diverging"===l&&!o,d=[],m=new Map,p=new Map,k=new Map,g=new Map;for(const t of u)p.set(t,f.get(t)??0),k.set(t,0),g.set(t,0);for(const n of t){const t=c.get(n.key),s=new Map;let l=[],h=[];const f=()=>{if(l.length>=2){const t={type:"area",topPath:l,bottomPath:h,style:i(n.key,n.data[0]),datum:n.data,group:n.key};r&&(t.curve=r),d.push(t)}l=[],h=[]};for(const n of u){const i=t.has(n);let r,u,c=i?t.get(n):0;if(o&&i&&(c/=a.get(n)),!i||!Number.isFinite(c)||0===c){f();continue}y?c>0?(r=k.get(n),u=r+c,k.set(n,u)):(r=g.get(n),u=r+c,g.set(n,u)):(r=p.get(n),u=r+c,p.set(n,u));const d=e.x(n);h.push([d,e.y(r)]),l.push([d,e.y(u)]),s.set(n,u)}f(),m.set(n.key,s)}return{nodes:d,stackedTops:m}}function M(t,e,n,s,i,o,r){const l=n(t),h=s(t);if(!Number.isFinite(l)||!Number.isFinite(h))return null;const u={type:"point",x:e.x(l),y:e.y(h),r:i,style:o,datum:t};return void 0!==r&&(u.pointId=r),u}function P(t,e,n,s,i,o,r,l){const h=n(t),u=s(t);if(!Number.isFinite(h)||!Number.isFinite(u))return null;const c={type:"symbol",x:e.x(h),y:e.y(u),size:i,symbolType:o,style:r,datum:t};return void 0!==l&&(c.pointId=l),c}function N(t,e,n,s,i,o,r){return{type:"rect",x:t,y:e,w:n,h:s,style:i,datum:o,group:r}}function W(t,e,n,s,i,o,r){const l={type:"heatcell",x:t,y:e,w:n,h:s,fill:i,datum:o};return r?.showValues&&(l.showValues=!0,l.value=r.value,r.valueFormat&&(l.valueFormat=r.valueFormat)),l}export{u as DataSourceAdapter,h as IncrementalExtent,c as accessorsEquivalent,a as resolveAccessor,f as resolveRawAccessor,y as resolveStringAccessor,k as toIdSet,_ as buildLineNode,A as buildAreaNode,B as computeStackOffsets,z as computeDivergingStackExtent,D as buildStackedAreaNodes,M as buildPointNode,P as buildSymbolNode,N as buildRectNode,W as buildHeatcellNode,g as ticksForMode,d as resolveFrameGraphics,m as resolveAnnotationAccessor,p as buildEnrichAnnotationData,b as symbolCanvasRenderer,S as barCanvasRenderer};

package/dist/chunk-chunk-ZTNVDWAK.module.min.js

@@ -0,0 +1,2 @@
+"use client";
+import{StreamXYFrame_default as e}from"./chunk-chunk-L6D3I3V7.module.min.js";import{buildCustomBehaviorProps as t}from"./chunk-chunk-FAKO3RGQ.module.min.js";import{normalizeLinkedBrush as n,useBrushSelection as i,useChartMode as s,useChartSelection as o}from"./chunk-chunk-ODUZEEBH.module.min.js";import{renderEmptyState as r,renderLoadingState as a}from"./chunk-chunk-ZCNBUZPL.module.min.js";var l=class e{constructor(){this._count=0,this._mean=0,this._m2=0,this._min=1/0,this._max=-1/0}push(e){if(!Number.isFinite(e))return;this._count+=1;const t=e-this._mean;this._mean+=t/this._count,this._m2+=t*(e-this._mean),this._min>e&&(this._min=e),e>this._max&&(this._max=e)}merge(e){if(0===e._count)return;if(0===this._count)return this._count=e._count,this._mean=e._mean,this._m2=e._m2,this._min=e._min,void(this._max=e._max);const t=this._count+e._count,n=e._mean-this._mean;this._mean+=n*e._count/t,this._m2+=e._m2+n*n*this._count*e._count/t,this._count=t,this._min>e._min&&(this._min=e._min),e._max>this._max&&(this._max=e._max)}clear(){this._count=0,this._mean=0,this._m2=0,this._min=1/0,this._max=-1/0}clone(){const t=new e;return t._count=this._count,t._mean=this._mean,t._m2=this._m2,t._min=this._min,t._max=this._max,t}get count(){return this._count}get mean(){return 0===this._count?0:this._mean}get sum(){return 0===this._count?0:this._mean*this._count}get variance(){return 2>this._count?0:this._m2/this._count}get stddev(){return Math.sqrt(this.variance)}get sampleVariance(){return 2>this._count?0:this._m2/(this._count-1)}get sampleStddev(){return Math.sqrt(this.sampleVariance)}get min(){return this._min}get max(){return this._max}},c=class{constructor(e){this.windows=new Map,this.sessions=[],this.latest=-1/0,this.type=e.window??"tumbling",this.size=e.size;const t=e.hop??e.size;this.hop=t>0&&e.size>=t?t:e.size,this.gap=e.gap??e.size,this.retain=null!=e.retain&&e.retain>0?e.retain:1/0}push(e,t){Number.isFinite(e)&&Number.isFinite(t)&&(e>this.latest&&(this.latest=e),"session"===this.type?this.pushSession(e,t):this.pushFixed(e,t),this.prune())}pushFixed(e,t){if("tumbling"===this.type||this.hop>=this.size)return void this.bump(Math.floor(e/this.size)*this.size,t);const n=this.hop,i=Math.floor(e/n);for(let s=Math.floor((e-this.size)/n)+1;i>=s;s++)this.bump(s*n,t)}bump(e,t){let n=this.windows.get(e);n||(n=new l,this.windows.set(e,n)),n.push(t)}pushSession(e,t){const n=this.gap,i=new l;i.push(t);let s=e,o=e;const r=[],a={start:s,end:o,stats:i};for(const t of this.sessions)e-n>t.end||t.start>e+n?r.push(t):(a.stats.merge(t.stats),s>t.start&&(s=t.start),t.end>o&&(o=t.end));a.start=s,a.end=o,r.push(a),r.sort((e,t)=>e.start-t.start),this.sessions=r}prune(){if(this.retain===1/0)return;if("session"===this.type)return void(this.sessions.length>this.retain&&(this.sessions=this.sessions.slice(this.sessions.length-this.retain)));if(this.retain>=this.windows.size)return;const e=[...this.windows.keys()].sort((e,t)=>e-t),t=e.length-this.retain;for(let n=0;t>n;n++)this.windows.delete(e[n])}emit(){return"session"===this.type?this.emitSessions():this.emitFixed()}emitFixed(){const e=[];for(const[t,n]of this.windows){const i=t+this.size;e.push(this.row(t,i,n,i>this.latest))}return e.sort((e,t)=>e.start-t.start),e}emitSessions(){return this.sessions.map(e=>this.row(e.start,e.end,e.stats,this.gap>this.latest-e.end))}row(e,t,n,i){return{start:e,end:t,count:n.count,mean:n.mean,sum:n.sum,min:n.min,max:n.max,stddev:n.stddev,partial:i}}get windowCount(){return"session"===this.type?this.sessions.length:this.windows.size}get watermark(){return this.latest}clear(){this.windows.clear(),this.sessions=[],this.latest=-1/0}};function u(e,t){switch(t){case"sum":return e.sum;case"min":return e.min;case"max":return e.max;case"count":return e.count;default:return e.mean}}function m(e,t,n,i=1){if("none"===t)return null;if("minmax"===t)return[e.min,e.max];const s=u(e,n),o=e.stddev*i;return[s-o,s+o]}var h={ms:1,s:1e3,m:6e4,h:36e5,d:864e5},d=/(\d+(?:\.\d+)?)(ms|s|m|h|d)/g;function p(e){if("number"==typeof e)return Number.isFinite(e)&&e>0?e:null;if("string"!=typeof e)return null;const t=e.trim();if(""===t)return null;d.lastIndex=0;let n,i=0,s=0;for(;null!==(n=d.exec(t));){const e=parseFloat(n[1]),t=h[n[2]];if(null==t||!Number.isFinite(e))return null;i+=e*t,s+=n[0].length}return s!==t.length?null:i>0?i:null}var v=class{constructor(e){this.held=[],this._watermark=-1/0,this._lateCount=0,this.lateness=e.lateness>0?e.lateness:0,this.getTime=e.getTime,this.latePolicy=e.latePolicy??"drop"}push(e){const t=this.getTime(e);if(!Number.isFinite(t))return{released:[e],late:[]};const n=[];return this._watermark!==-1/0&&this._watermark-this.lateness>t?(this._lateCount+=1,n.push(e),"drop"===this.latePolicy?{released:[],late:n}:{released:[e],late:n}):(t>this._watermark&&(this._watermark=t),this.held.push(e),{released:this.drain(),late:n})}drain(){const e=this._watermark-this.lateness;if(0===this.held.length)return[];const t=[],n=[];for(const i of this.held)this.getTime(i)>e?n.push(i):t.push(i);return this.held=n,t.sort((e,t)=>this.getTime(e)-this.getTime(t)),t}flush(){const e=this.held;return this.held=[],e.sort((e,t)=>this.getTime(e)-this.getTime(t)),e}clear(){this.held=[],this._watermark=-1/0,this._lateCount=0}get watermark(){return this._watermark}get lateCount(){return this._lateCount}get heldCount(){return this.held.length}};import{useRef as g,useImperativeHandle as f,forwardRef as w,useCallback as y,useState as b,useEffect as x}from"react";import{jsx as A,jsxs as _}from"react/jsx-runtime";var k={background:"var(--semiotic-tooltip-bg, rgba(0, 0, 0, 0.85))",color:"var(--semiotic-tooltip-text, #f3f4f6)",padding:"6px 10px",borderRadius:"var(--semiotic-tooltip-radius, 4px)",fontSize:"var(--semiotic-tooltip-font-size, 12px)",fontFamily:"var(--semiotic-tick-font-family, var(--semiotic-font-family, sans-serif))",boxShadow:"var(--semiotic-tooltip-shadow, 0 2px 8px rgba(0, 0, 0, 0.25))",lineHeight:1.4,pointerEvents:"none",whiteSpace:"nowrap"},H={opacity:.7,marginRight:4};function S(e,t,n){if(null!=e)return"function"==typeof t?t(e):e["string"==typeof t?t:n]}function z(e){return null==e?"":"number"==typeof e?Number.isInteger(e)?e+"":e.toFixed(2):e instanceof Date?e.toLocaleString():e+""}function I(e={}){const{timeAccessor:t,valueAccessor:n,xLabel:i="x",yLabel:s="y"}=e;return e=>{const o=e?.data??null,r=S(o,t,"time"),a=S(o,n,"value");return _("div",{className:"semiotic-tooltip",style:k,children:[_("div",{children:[_("span",{style:H,children:[i,":"]}),z(r)]}),_("div",{children:[_("span",{style:H,children:[s,":"]}),z(a)]})]})}}function C(e,t){return null!=e?e:Math.max(t?.length??0,200)}var T="time",R="value",F="__aggLower",P="__aggUpper",M="__aggPartial",N="count",D="__aggStart",E="__aggEnd";function O(e,t){const n=t.stat??"mean",i=t.band??"none",s=t.sigma??1;return e.emit().map(e=>{const t={[T]:(e.start+e.end)/2,[R]:u(e,n),[N]:e.count,[M]:e.partial,[D]:e.start,[E]:e.end},o=m(e,i,n,s);return o&&(t[F]=o[0],t[P]=o[1]),t})}import{jsx as B}from"react/jsx-runtime";function j(e,t,n){const i="function"==typeof t?t(e):e[t??n];if(null==i)return null;if(i instanceof Date)return i.getTime();const s=Number(i);return Number.isFinite(s)?s:null}var V=w(function(n,i){const l=s(n.mode,{width:n.size?.[0]??n.width,height:n.size?.[1]??n.height,enableHover:null!=n.enableHover?!!n.enableHover:void 0,mobileInteraction:n.mobileInteraction,mobileSemantics:n.mobileSemantics,responsiveRules:n.responsiveRules}),{size:u,margin:m,className:h,arrowOfTime:d="right",windowMode:w="sliding",windowSize:A,data:_,timeAccessor:k,valueAccessor:H,timeExtent:S,valueExtent:z,extentPadding:M,stroke:N="#007bff",strokeWidth:D=2,strokeDasharray:E,opacity:V,background:W,tooltipContent:$,tooltip:L,onHover:U,annotations:Z,autoPlaceAnnotations:q,svgAnnotationRules:X,tickFormatTime:Y,tickFormatValue:G,decay:K,pulse:Q,staleness:J,transition:ee,linkedHover:te,selection:ne,onObservation:ie,chartId:se,loading:oe,loadingContent:re,emptyContent:ae,emphasis:le,legendPosition:ce,aggregate:ue,eventTime:me}=n,he=l.showAxes,de=l.enableHover,pe=m??l.marginDefaults,ve=u??[l.width,l.height],ge=$??L??I({timeAccessor:k,valueAccessor:H}),fe=g(null),{customHoverBehavior:we}=o({selection:ne,linkedHover:te,unwrapData:!0,onObservation:ie,chartType:"RealtimeLineChart",chartId:se}),ye=y(e=>{U&&U(e),we(e)},[U,we]),be=null!=ue,[xe,Ae]=b([]),_e=g(null),ke=g(ue);ke.current=ue;const He=g(be);He.current=be;const Se=g(xe);Se.current=xe;const ze=g({timeAccessor:k,valueAccessor:H});ze.current={timeAccessor:k,valueAccessor:H},x(()=>{if(!be)return void(_e.current=null);const e=ke.current,t=function(e){const t=e.window??"tumbling",n=p("session"===t?e.gap??e.size:e.size);if(null==n)return null;const i=null!=e.hop?p(e.hop):void 0,s=null!=e.gap?p(e.gap):void 0;return new c({window:t,size:n,hop:i??void 0,gap:s??void 0,retain:e.retain})}(e);if(_e.current=t,t&&_){const{timeAccessor:e,valueAccessor:n}=ze.current;for(const i of _){const s=j(i,e,"time"),o=j(i,n,"value");null!=s&&null!=o&&t.push(s,o)}}Ae(t?O(t,e):[])},[be?[ue.window??"tumbling",ue.size,ue.hop??"",ue.gap??"",ue.retain??""].join("|"):"",be,_]),x(()=>{be&&_e.current&&Ae(O(_e.current,ke.current))},[ue?.stat,ue?.band,ue?.sigma]);const Ie=y(e=>{const t=_e.current,n=ke.current;if(!t||!n)return;const{timeAccessor:i,valueAccessor:s}=ze.current;for(const n of e){const e=j(n,i,"time"),o=j(n,s,"value");null!=e&&null!=o&&t.push(e,o)}Ae(O(t,n))},[]),Ce=null!=me,Te=g(null),Re=g(me);Re.current=me;const Fe=g(Ce);Fe.current=Ce;const Pe=g(ie);Pe.current=ie;const Me=g(se);Me.current=se,x(()=>{Te.current=Ce?function(e){const t=p(e.lateness);return null==t?null:new v({lateness:t,getTime:e=>j(e,ze.current.timeAccessor,"time")??NaN,latePolicy:e.latePolicy??"drop"})}(Re.current):null},[Ce?`${me.lateness}|${me.latePolicy??"drop"}`:"",Ce]);const Ne=y(e=>{0!==e.length&&(He.current?Ie(e):fe.current?.pushMany(e))},[Ie]),De=y(e=>{const t=Te.current;if(!Fe.current||!t)return void Ne(e);const n=[];for(const i of e){const e=t.push(i);if(e.released.length&&n.push(...e.released),e.late.length){const n=Pe.current;if(n){const{timeAccessor:i}=ze.current,s=Re.current?.latePolicy??"drop";for(const o of e.late)n({type:"late-data",datum:o,eventTime:j(o,i,"time")??NaN,watermark:t.watermark,policy:s,lateCount:t.lateCount,timestamp:Date.now(),chartType:"RealtimeLineChart",chartId:Me.current})}}}Ne(n)},[Ne]);f(i,()=>({push:e=>De([e]),pushMany:e=>De(e),remove:e=>He.current?[]:fe.current?.remove(e)??[],update:(e,t)=>He.current?[]:fe.current?.update(e,t)??[],clear:()=>{Te.current?.clear(),He.current?(_e.current?.clear(),Ae([])):fe.current?.clear()},getData:()=>He.current?Se.current:fe.current?.getData()??[],getScales:()=>fe.current?.getScales()??null}),[De]);const Ee=a(oe,ve[0],ve[1],re),Oe=Ee?null:r(be?void 0:_,ve[0],ve[1],ae),Be={stroke:N,strokeWidth:D,strokeDasharray:E};null!=V&&(Be.opacity=V);const je=C(A,_),Ve=be?xe:_,We=be?T:k,$e=be?R:H,Le=be&&ue&&"none"!==(ue.band??"none")?{y0Accessor:F,y1Accessor:P,perSeries:!1}:void 0;return Ee||Oe||B(e,{ref:fe,chartType:"line",runtimeMode:"streaming",size:ve,margin:pe,className:le?`${h||""} semiotic-emphasis-${le}`.trim():h,arrowOfTime:d,windowMode:be?"growing":w,windowSize:be?Math.max(1,ue?.retain??Math.max(xe.length,600)):je,data:Ve,timeAccessor:We,valueAccessor:$e,xExtent:S,yExtent:z,extentPadding:M,band:Le,lineStyle:Be,showAxes:he,background:W,hoverAnnotation:de,tooltipContent:ge,...t({linkedHover:te,selection:ne,onObservation:ie,forceHoverBehavior:!0,mobileInteraction:l.mobileInteraction,customHoverBehavior:ye}),annotations:Z,autoPlaceAnnotations:q,svgAnnotationRules:X,tickFormatTime:Y,tickFormatValue:G,decay:K,pulse:Q,staleness:J,transition:ee,pointIdAccessor:n.pointIdAccessor,legendPosition:ce})});V.displayName="RealtimeLineChart";import{useRef as W,useImperativeHandle as $,forwardRef as L,useCallback as U,useMemo as Z}from"react";import{jsx as q}from"react/jsx-runtime";function X(e,t,n){const i="function"==typeof t?t(e):e[t??n];if(null==i)return null;if(i instanceof Date)return i.getTime();if("string"==typeof i&&""===i.trim())return null;const s=Number(i);return Number.isFinite(s)?s:null}var Y=L(function(l,c){const u=s(l.mode,{width:l.size?.[0]??l.width,height:l.size?.[1]??l.height,showAxes:l.showAxes,enableHover:null!=l.enableHover?!!l.enableHover:void 0,linkedHover:l.linkedHover,mobileInteraction:l.mobileInteraction,mobileSemantics:l.mobileSemantics,responsiveRules:l.responsiveRules}),{binSize:m,size:h,margin:d,className:p,arrowOfTime:v="right",windowMode:g="sliding",windowSize:f,data:w,timeAccessor:y,valueAccessor:b,direction:x="up",timeExtent:I,valueExtent:T,extentPadding:R,categoryAccessor:F,colors:P,fill:M,stroke:N,strokeWidth:D,opacity:E,gap:O,background:B,tooltipContent:j,tooltip:V,onHover:L,annotations:Y,autoPlaceAnnotations:G,svgAnnotationRules:K,tickFormatTime:Q,tickFormatValue:J,linkedHover:ee,selection:te,decay:ne,pulse:ie,staleness:se,transition:oe,onObservation:re,chartId:ae,loading:le,loadingContent:ce,emptyContent:ue,emphasis:me,legendPosition:he,brush:de,onBrush:pe,linkedBrush:ve}=l,ge=u.showAxes,fe=u.enableHover,we=d??u.marginDefaults,ye=h??[u.width,u.height],be=j??V??function(e={}){const{timeAccessor:t,valueAccessor:n}=e;return e=>{const i=e?.data??null;if(null==i?.binStart||null==i?.binEnd){const e=S(i,t,"time"),s=S(i,n,"value");return _("div",{className:"semiotic-tooltip",style:k,children:[_("div",{children:[A("span",{style:H,children:"x:"}),z(e)]}),_("div",{children:[A("span",{style:H,children:"y:"}),z(s)]})]})}return _("div",{className:"semiotic-tooltip",style:k,children:[_("div",{children:[A("span",{style:H,children:"range:"}),z(i.binStart),"–",z(i.binEnd)]}),null!=i.total&&_("div",{children:[A("span",{style:H,children:"count:"}),z(i.total)]}),null!=i.category&&_("div",{children:[A("span",{style:H,children:"category:"}),z(i.category)]})]})}}({timeAccessor:y,valueAccessor:b}),xe=W(null),{customHoverBehavior:Ae}=o({selection:te,linkedHover:ee,unwrapData:!0,onObservation:re,chartType:"RealtimeHistogram",chartId:ae}),_e=U(e=>{L&&L(e),Ae(e)},[L,Ae]),ke=!0===de?{dimension:"x",snap:"bin"}:"x"===de?{dimension:"x"}:"object"==typeof de?de:void 0,He=n(ve),Se="string"==typeof y?y:"time",ze=i({name:He?.name||"__unused_hist_brush__",xField:He?.xField||Se,...He?.yField?{yField:He.yField}:{}}),Ie=W(ze.brushInteraction);Ie.current=ze.brushInteraction;const Ce=U(e=>{if(pe&&pe(e),re&&re(e?{type:"brush",extent:e,timestamp:Date.now(),chartType:"RealtimeHistogram",chartId:ae}:{type:"brush-end",timestamp:Date.now(),chartType:"RealtimeHistogram",chartId:ae}),He){const t=Ie.current;t.end(e?"xBrush"===t.brush?e.x:"yBrush"===t.brush?e.y:[[e.x[0],e.y[0]],[e.x[1],e.y[1]]]:null)}},[pe,re,ae,He]);$(c,()=>({push:e=>xe.current?.push(e),pushMany:e=>xe.current?.pushMany(e),remove:e=>xe.current?.remove(e)??[],update:(e,t)=>xe.current?.update(e,t)??[],clear:()=>xe.current?.clear(),getData:()=>xe.current?.getData()??[],getScales:()=>xe.current?.getScales()??null}),[]);const Te=a(le,ye[0],ye[1],ce),Re=Te?null:r(w,ye[0],ye[1],ue),Fe={};null!=M&&(Fe.fill=M),null!=N&&(Fe.stroke=N),null!=D&&(Fe.strokeWidth=D),null!=E&&(Fe.opacity=E),null!=O&&(Fe.gap=O);const Pe=me?`${p||""} semiotic-emphasis-${me}`.trim():p,Me=C(f,w),Ne=Z(()=>"down"!==x?T:function({data:e,valueAccessor:t,timeAccessor:n,binSize:i,valueExtent:s,extentPadding:o}){if(s)return[s[1],s[0]];if(!e||0===e.length)return;const r=new Map;for(const s of e){const e=X(s,n,"time"),o=X(s,t,"value");if(null==e||null==o)continue;const a=Math.floor(e/i)*i;r.set(a,(r.get(a)??0)+o)}let a=0;for(const e of r.values())e>a&&(a=e);return[a>0?a+a*(o??.1):1,0]}({data:w,valueAccessor:b,timeAccessor:y,binSize:m,valueExtent:T,extentPadding:R}),[x,w,b,y,m,T,R]);return Te||Re||q(e,{ref:xe,chartType:"bar",runtimeMode:"streaming",size:ye,margin:we,className:Pe,arrowOfTime:v,windowMode:g,windowSize:Me,data:w,timeAccessor:y,valueAccessor:b,xExtent:I,yExtent:Ne,extentPadding:R,binSize:m,categoryAccessor:F,barColors:P,barStyle:Fe,showAxes:ge,background:B,hoverAnnotation:fe,tooltipContent:be,...t({linkedHover:ee,selection:te,onObservation:re,forceHoverBehavior:!0,mobileInteraction:u.mobileInteraction,customHoverBehavior:_e}),annotations:Y,autoPlaceAnnotations:G,svgAnnotationRules:K,tickFormatTime:Q,tickFormatValue:J,decay:ne,pulse:ie,staleness:se,transition:oe,pointIdAccessor:l.pointIdAccessor,legendPosition:he,brush:ke||(ve?{dimension:"x"}:void 0),onBrush:ke||ve?Ce:void 0})});function G(e){return q(Y,{...e,windowMode:"growing"})}Y.displayName="RealtimeHistogram",G.displayName="TemporalHistogram";var K=Y;import{useRef as Q,useImperativeHandle as J,forwardRef as ee,useCallback as te}from"react";import{jsx as ne}from"react/jsx-runtime";var ie=ee(function(n,i){const l=s(n.mode,{width:n.size?.[0]??n.width,height:n.size?.[1]??n.height,enableHover:null!=n.enableHover?!!n.enableHover:void 0,mobileInteraction:n.mobileInteraction,mobileSemantics:n.mobileSemantics,responsiveRules:n.responsiveRules}),{size:c,margin:u,className:m,arrowOfTime:h="right",windowMode:d="sliding",windowSize:p,data:v,timeAccessor:g,valueAccessor:f,timeExtent:w,valueExtent:y,yScaleType:b,extentPadding:x,categoryAccessor:A,colors:_,radius:k,fill:H,opacity:S,stroke:z,strokeWidth:T,pointStyle:R,background:F,tooltipContent:P,tooltip:M,onHover:N,annotations:D,autoPlaceAnnotations:E,svgAnnotationRules:O,tickFormatTime:B,tickFormatValue:j,linkedHover:V,selection:W,onObservation:$,chartId:L,loading:U,loadingContent:Z,emptyContent:q,emphasis:X,legendPosition:Y}=n,G=l.showAxes,K=l.enableHover,ee=u??l.marginDefaults,ie=c??[l.width,l.height],se=P??M??I({timeAccessor:g,valueAccessor:f}),oe=Q(null),{customHoverBehavior:re}=o({selection:W,linkedHover:V,unwrapData:!0,onObservation:$,chartType:"RealtimeSwarmChart",chartId:L}),ae=te(e=>{N&&N(e),re(e)},[N,re]);J(i,()=>({push:e=>oe.current?.push(e),pushMany:e=>oe.current?.pushMany(e),remove:e=>oe.current?.remove(e)??[],update:(e,t)=>oe.current?.update(e,t)??[],clear:()=>oe.current?.clear(),getData:()=>oe.current?.getData()??[],getScales:()=>oe.current?.getScales()??null}),[]);const le=a(U,ie[0],ie[1],Z),ce=le?null:r(v,ie[0],ie[1],q),ue={};null!=k&&(ue.radius=k),null!=H&&(ue.fill=H),null!=S&&(ue.opacity=S),null!=z&&(ue.stroke=z),null!=T&&(ue.strokeWidth=T);const me=R,he=X?`${m||""} semiotic-emphasis-${X}`.trim():m,de=C(p,v);return le||ce||ne(e,{ref:oe,chartType:"swarm",runtimeMode:"streaming",size:ie,margin:ee,className:he,arrowOfTime:h,windowMode:d,windowSize:de,data:v,timeAccessor:g,valueAccessor:f,xExtent:w,yExtent:y,yScaleType:b,extentPadding:x,categoryAccessor:A,barColors:_,swarmStyle:ue,pointStyle:me,showAxes:G,background:F,hoverAnnotation:K,tooltipContent:se,...t({linkedHover:V,selection:W,onObservation:$,forceHoverBehavior:!0,mobileInteraction:l.mobileInteraction,customHoverBehavior:ae}),annotations:D,autoPlaceAnnotations:E,svgAnnotationRules:O,tickFormatTime:B,tickFormatValue:j,legendPosition:Y,pointIdAccessor:n.pointIdAccessor})});ie.displayName="RealtimeSwarmChart";import{useRef as se,useImperativeHandle as oe,forwardRef as re,useCallback as ae}from"react";import{jsx as le}from"react/jsx-runtime";var ce=re(function(n,i){const l=s(n.mode,{width:n.size?.[0]??n.width,height:n.size?.[1]??n.height,enableHover:null!=n.enableHover?!!n.enableHover:void 0,mobileInteraction:n.mobileInteraction,mobileSemantics:n.mobileSemantics,responsiveRules:n.responsiveRules}),{size:c,margin:u,className:m,arrowOfTime:h="right",windowMode:d="sliding",windowSize:p,data:v,timeAccessor:g,valueAccessor:f,timeExtent:w,valueExtent:y,extentPadding:b,positiveColor:x,negativeColor:I,connectorStroke:T,connectorWidth:R,gap:F,stroke:P,strokeWidth:M,opacity:N,background:D,tooltipContent:E,tooltip:O,onHover:B,annotations:j,autoPlaceAnnotations:V,svgAnnotationRules:W,tickFormatTime:$,tickFormatValue:L,linkedHover:U,selection:Z,onObservation:q,chartId:X,loading:Y,loadingContent:G,emptyContent:K,emphasis:Q,legendPosition:J}=n,ee=l.showAxes,te=l.enableHover,ne=u??l.marginDefaults,ie=c??[l.width,l.height],re=E??O??function(e={}){const{timeAccessor:t,valueAccessor:n}=e;return e=>{const i=e?.data??null,s=S(i,t,"time"),o=i?.delta??S(i,n,"value"),r=i?.cumEnd,a="number"==typeof o?0>o?z(o):"+"+z(o):z(o);return _("div",{className:"semiotic-tooltip",style:k,children:[_("div",{children:[A("span",{style:H,children:"x:"}),z(s)]}),_("div",{children:[A("span",{style:H,children:"Δ:"}),a]}),null!=r&&_("div",{children:[A("span",{style:H,children:"total:"}),z(r)]})]})}}({timeAccessor:g,valueAccessor:f}),ce=se(null),{customHoverBehavior:ue}=o({selection:Z,linkedHover:U,unwrapData:!0,onObservation:q,chartType:"RealtimeWaterfallChart",chartId:X}),me=ae(e=>{B&&B(e),ue(e)},[B,ue]);oe(i,()=>({push:e=>ce.current?.push(e),pushMany:e=>ce.current?.pushMany(e),remove:e=>ce.current?.remove(e)??[],update:(e,t)=>ce.current?.update(e,t)??[],clear:()=>ce.current?.clear(),getData:()=>ce.current?.getData()??[],getScales:()=>ce.current?.getScales()??null}),[]);const he=a(Y,ie[0],ie[1],G),de=he?null:r(v,ie[0],ie[1],K),pe={};null!=x&&(pe.positiveColor=x),null!=I&&(pe.negativeColor=I),null!=T&&(pe.connectorStroke=T),null!=R&&(pe.connectorWidth=R),null!=F&&(pe.gap=F),null!=P&&(pe.stroke=P),null!=M&&(pe.strokeWidth=M),null!=N&&(pe.opacity=N);const ve=Q?`${m||""} semiotic-emphasis-${Q}`.trim():m,ge=C(p,v);return he||de||le(e,{ref:ce,chartType:"waterfall",runtimeMode:"streaming",size:ie,margin:ne,className:ve,arrowOfTime:h,windowMode:d,windowSize:ge,data:v,timeAccessor:g,valueAccessor:f,xExtent:w,yExtent:y,extentPadding:b,waterfallStyle:pe,showAxes:ee,background:D,hoverAnnotation:te,tooltipContent:re,...t({linkedHover:U,selection:Z,onObservation:q,forceHoverBehavior:!0,mobileInteraction:l.mobileInteraction,customHoverBehavior:me}),annotations:j,autoPlaceAnnotations:V,svgAnnotationRules:W,tickFormatTime:$,tickFormatValue:L,legendPosition:J,pointIdAccessor:n.pointIdAccessor})});ce.displayName="RealtimeWaterfallChart";import{useRef as ue,useImperativeHandle as me,forwardRef as he,useCallback as de}from"react";import{jsx as pe}from"react/jsx-runtime";var ve=he(function(n,i){const l=s(n.mode,{width:n.size?.[0]??n.width,height:n.size?.[1]??n.height,enableHover:null!=n.enableHover?!!n.enableHover:void 0,mobileInteraction:n.mobileInteraction,mobileSemantics:n.mobileSemantics,responsiveRules:n.responsiveRules}),{size:c,margin:u,className:m,arrowOfTime:h="right",windowMode:d="sliding",windowSize:p,data:v,timeAccessor:g,valueAccessor:f,categoryAccessor:w,timeExtent:y,valueExtent:b,extentPadding:x,heatmapXBins:I=20,heatmapYBins:T=20,aggregation:R="count",background:F,tooltipContent:P,tooltip:M,onHover:N,annotations:D,autoPlaceAnnotations:E,svgAnnotationRules:O,tickFormatTime:B,tickFormatValue:j,decay:V,pulse:W,staleness:$,linkedHover:L,selection:U,onObservation:Z,chartId:q,loading:X,loadingContent:Y,emptyContent:G,emphasis:K,legendPosition:Q}=n,J=l.showAxes,ee=l.enableHover,te=u??l.marginDefaults,ne=c??[l.width,l.height],ie=P??M??function(e={}){const{timeAccessor:t,valueAccessor:n,xLabel:i="x",yLabel:s="y"}=e;return e=>{const o=e?.data??null,r=o?.xCenter??S(o,t,"time"),a=o?.yCenter??S(o,n,"value"),l=o?.count,c=o?.sum,u=o?.value,m=o?.agg??"count";return _("div",{className:"semiotic-tooltip",style:k,children:[_("div",{children:[_("span",{style:H,children:[i,":"]}),z(r)]}),_("div",{children:[_("span",{style:H,children:[s,":"]}),z(a)]}),null!=l&&_("div",{children:[A("span",{style:H,children:"count:"}),z(l)]}),"sum"===m&&null!=c&&_("div",{children:[A("span",{style:H,children:"sum:"}),z(c)]}),"mean"===m&&null!=u&&_("div",{children:[A("span",{style:H,children:"mean:"}),z(u)]})]})}}({timeAccessor:g,valueAccessor:f}),se=ue(null),{customHoverBehavior:oe}=o({selection:U,linkedHover:L,unwrapData:!0,onObservation:Z,chartType:"RealtimeHeatmap",chartId:q}),re=de(e=>{N&&N(e),oe(e)},[N,oe]);me(i,()=>({push:e=>se.current?.push(e),pushMany:e=>se.current?.pushMany(e),remove:e=>se.current?.remove(e)??[],update:(e,t)=>se.current?.update(e,t)??[],clear:()=>se.current?.clear(),getData:()=>se.current?.getData()??[],getScales:()=>se.current?.getScales()??null}),[]);const ae=a(X,ne[0],ne[1],Y),le=ae?null:r(v,ne[0],ne[1],G),ce=K?`${m||""} semiotic-emphasis-${K}`.trim():m,he=C(p,v);return ae||le||pe(e,{ref:se,chartType:"heatmap",runtimeMode:"streaming",size:ne,margin:te,className:ce,arrowOfTime:h,windowMode:d,windowSize:he,data:v,timeAccessor:g,valueAccessor:f,categoryAccessor:w,xExtent:y,yExtent:b,extentPadding:x,heatmapXBins:I,heatmapYBins:T,heatmapAggregation:R,showAxes:J,background:F,hoverAnnotation:ee,tooltipContent:ie,...t({linkedHover:L,selection:U,onObservation:Z,forceHoverBehavior:!0,mobileInteraction:l.mobileInteraction,customHoverBehavior:re}),annotations:D,autoPlaceAnnotations:E,svgAnnotationRules:O,tickFormatTime:B,tickFormatValue:j,decay:V,pulse:W,staleness:$,legendPosition:Q,pointIdAccessor:n.pointIdAccessor})});ve.displayName="RealtimeHeatmap";export{l as RunningStats,c as WindowAccumulator,u as statValue,m as bandBounds,p as parseWindowDuration,v as ReorderBuffer,V as RealtimeLineChart,Y as RealtimeHistogram,G as TemporalHistogram,K as RealtimeTemporalHistogram,ie as RealtimeSwarmChart,ce as RealtimeWaterfallChart,ve as RealtimeHeatmap};

package/dist/chunk-statisticalOverlays-6MVAK5RW.module.min.js

@@ -0,0 +1,2 @@
+"use client";
+import{darkenColor as t,lightenColor as o}from"./chunk-chunk-2JGJ5GUG.module.min.js";import{getMax as n,getMinMax as e}from"./chunk-chunk-JJ2OOIET.module.min.js";var r="__forecastSegment",a="__forecastOpacity";function s(t,o,n,r){const s=o.uncertaintyOpacity,i=o.confidenceAccessor;if(!s&&!i)return;const l="object"==typeof s?s:{},c=l.min??.15,f=l.max??1;if(i){const o="function"==typeof i?i:t=>t[i];for(const n of t){const t=o(n);null!=t&&Number.isFinite(t)&&(n[a]=c+Math.max(0,Math.min(1,t))*(f-c))}return}const u=t.map(t=>{const o=n(t),e=r(t);return null!=o&&null!=e&&Number.isFinite(o)&&Number.isFinite(e)?Math.abs(o-e):NaN}),p=u.filter(t=>Number.isFinite(t));if(0===p.length)return;const[h,y]=e(p),d=y-h;t.forEach((t,o)=>{const n=u[o];Number.isFinite(n)&&(t[a]=f-(d>0?(n-h)/d:0)*(f-c))})}function i(t,o){return"function"==typeof o?o(t):!!t[o]}function l(t){return[{type:"anomaly-band",threshold:t.threshold??2,showBand:!1!==t.showBand,fill:t.bandColor||"#6366f1",fillOpacity:t.bandOpacity??.1,anomalyColor:t.anomalyColor||"#ef4444",anomalyRadius:t.anomalyRadius??6,label:t.label}]}function c(t,o,e,a,l){return(c=a).isTraining||c.isForecast||c.isAnomaly||c.upperBounds||c.lowerBounds?function(t,o,n,e,a){const{isTraining:l,isForecast:c,isAnomaly:f,upperBounds:u,lowerBounds:p,color:h="#6366f1",bandOpacity:y=.15,anomalyColor:d="#ef4444",anomalyRadius:m=6,label:b}=e,g=t.map(t=>{let o="observed";return c&&i(t,c)?o="forecast":l&&i(t,l)&&(o="training"),{...t,[r]:o}}),k=e._groupBy,_=[];if(k){const t=new Map;for(const o of g){const n=o[k]??"__default";t.has(n)||t.set(n,[]),t.get(n).push(o)}const o=[];for(const[,n]of t)for(let t=0;n.length-1>t;t++)n[t][r]!==n[t+1][r]&&(o.push({...n[t+1],[r]:n[t][r]}),o.push({...n[t],[r]:n[t+1][r]}));_.push(...g,...o)}else for(let t=0;g.length>t;t++)_.push(g[t]),g.length-1>t&&g[t][r]!==g[t+1][r]&&(_.push({...g[t+1],[r]:g[t][r]}),_.push({...g[t],[r]:g[t+1][r]}));if(e.trainUnderline){const t=[];for(const o of _)"training"===o[r]&&t.push({...o,[r]:"training-base"});_.unshift(...t)}const O=[];if(u&&p){const t="string"==typeof u?u:"__envUpper",o="string"==typeof p?p:"__envLower";if("function"==typeof u||"function"==typeof p)for(const n of _)"function"==typeof u&&(n[t]=u(n)),"function"==typeof p&&(n[o]=p(n));O.push({type:"envelope",upperAccessor:t,lowerAccessor:o,fill:h,fillOpacity:y,label:b})}if(e.uncertaintyOpacity||e.confidenceAccessor){const t=u?"function"==typeof u?u:t=>t[u]:()=>{},o=p?"function"==typeof p?p:t=>t[p]:()=>{};s(_.filter(t=>"forecast"===t[r]),e,t,o)}if(f){const t=e.anomalyStyle,o={type:"highlight",filter:t=>i(t,f)};t?(o.style=t,o.r=m):"function"==typeof d?(o.style=t=>{const o=d(t);return{stroke:o,strokeWidth:1.5,fill:o,fillOpacity:.7}},o.r=m):(o.color=d,o.r=m,o.style={stroke:d,strokeWidth:1.5,fill:d,fillOpacity:.7}),O.push(o)}return a&&O.push({type:"anomaly-band",threshold:a.threshold??2,showBand:!1!==a.showBand,fill:a.bandColor||"#6366f1",fillOpacity:a.bandOpacity??.1,anomalyColor:a.anomalyColor||"#ef4444",anomalyRadius:a.anomalyRadius??6,label:a.label}),{processedData:_,annotations:O}}(t,0,0,a,l):function(t,o,e,a,i){const{trainEnd:l,steps:c=10,confidence:f=.95,color:u="#6366f1",bandOpacity:p=.15,label:h}=a;if(null==l)return{processedData:t,annotations:[]};const y=[],d=[];for(const n of t)n[o]>l?d.push({...n,[r]:"observed"}):y.push({...n,[r]:"training"});const m=y.map(t=>[t[o],t[e]]).filter(t=>null!=t[0]&&null!=t[1]&&isFinite(t[0])&&isFinite(t[1])).sort((t,o)=>t[0]-o[0]),b=[],g=[];if(m.length>=3){const i=m.length;let l=0,y=0,d=0,k=0;for(const[t,o]of m)l+=t,y+=o,d+=t*t,k+=t*o;const _=i*d-l*l;if(Math.abs(_)>1e-12){const d=(i*k-l*y)/_,O=(y-d*l)/i,w=t=>O+d*t,B=m.map(([t,o])=>o-w(t)).reduce((t,o)=>t+o*o,0),F=Math.sqrt(B/Math.max(i-2,1)),v=m.reduce((t,o)=>t+o[0],0)/i,C=m.reduce((t,o)=>t+(o[0]-v)**2,0),D=.99>f?.95>f?.9>f?1:1.645:1.96:2.576,A=t.map(t=>t[o]).filter(t=>null!=t&&isFinite(t)),M=n(A),N=m.length>1?(m[i-1][0]-m[0][0])/(i-1):1;for(let t=1;c>=t;t++){const n=M+t*N,a=w(n),s=F*Math.sqrt(1+1/i+(C>0?(n-v)**2/C:0))*D;g.push({[o]:n,[e]:a,[r]:"forecast",__forecastUpper:a+s,__forecastLower:a-s})}s(g,a,t=>t.__forecastUpper,t=>t.__forecastLower),b.push({type:"envelope",upperAccessor:"__forecastUpper",lowerAccessor:"__forecastLower",fill:u,fillOpacity:p,label:h})}}b.push({type:"x-threshold",x:l,color:"#94a3b8",strokeWidth:1,strokeDasharray:"4,2",label:"Train / Forecast"}),i&&b.push({type:"anomaly-band",threshold:i.threshold??2,showBand:!1!==i.showBand,fill:i.bandColor||"#6366f1",fillOpacity:i.bandOpacity??.1,anomalyColor:i.anomalyColor||"#ef4444",anomalyRadius:i.anomalyRadius??6,label:i.label});const k=[];if(k.push(...y),y.length>0&&d.length>0&&k.push({...y[y.length-1],[r]:"observed"}),k.push(...d),g.length>0){const t=d.length>0?d[d.length-1]:y[y.length-1];t&&k.push({...t,[r]:"forecast"}),k.push(...g)}return{processedData:k,annotations:b}}(t,o,e,a,l);var c}function f(n,e){const s=e.trainDasharray??"8,4",i=e.forecastDasharray??"4,4",l=e.color||"#6366f1",c=e.trainOpacity,f=e.forecastOpacity,u=e.trainStroke,p=e.trainLinecap,h=e.trainUnderline;return e=>{const y=n(e),d=e[r];if("training"===d){let o=y.stroke;return"darken"===u?o=t(y.stroke||"#666",.5):u&&(o=u),{...y,stroke:o,strokeDasharray:s,...p&&{strokeLinecap:p},...null!=c&&{strokeOpacity:c}}}if("training-base"===d){let t=y.stroke||"#666";return"lighten"===h&&(t=o(t,.4)),{...y,stroke:t,strokeDasharray:void 0}}if("forecast"===d){const t=e[a],o=null!=t?t:f;return{...y,stroke:l,strokeDasharray:i,...null!=o&&{strokeOpacity:o}}}return y}}export{a as FORECAST_OPACITY_FIELD,r as SEGMENT_FIELD,l as buildAnomalyAnnotations,c as buildForecast,f as createSegmentLineStyle,t as darkenColor,o as lightenColor,s as stampForecastOpacity};

package/dist/components/AccessibleNavTree.d.ts

@@ -1,5 +1,7 @@
 import * as React from "react";
 import { type NavTreeNode } from "./ai/navigationTree";
+import { type OnObservationCallback } from "./store/ObservationStore";
+import { type OnAnnotationActivateCallback } from "./charts/shared/annotationActivation";
 export interface AccessibleNavTreeProps {
     tree: NavTreeNode;
     /** Accessible name for the tree. */
@@ -22,5 +24,9 @@ export interface AccessibleNavTreeProps {
      * the conversation-arc store is enabled — zero-overhead otherwise.
      */
     chartId?: string;
+    /** Normalized focus/activation events produced by structured navigation. */
+    onObservation?: OnObservationCallback;
+    /** Observe activation of an annotation leaf in the navigation tree. */
+    onAnnotationActivate?: OnAnnotationActivateCallback;
 }
-export declare function AccessibleNavTree({ tree, label, visible, className, onActiveChange, activeId: controlledActiveId, chartId }: AccessibleNavTreeProps): React.JSX.Element;
+export declare function AccessibleNavTree({ tree, label, visible, className, onActiveChange, activeId: controlledActiveId, chartId, onObservation, onAnnotationActivate }: AccessibleNavTreeProps): React.JSX.Element;

package/dist/components/ai/chartClinicMetadata.generated.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AUTO-GENERATED from chartSpecs.ts and chartDefinitionPilot.ts by
+ * scripts/regenerate-schema.ts.
+ * Do not edit by hand; run `npm run docs:chart-specs:schema`.
+ */
+import type { ChartCategory } from "../charts/shared/chartSpecs";
+interface ChartClinicMetadata {
+    readonly category: ChartCategory;
+    readonly recommendedImport: string;
+    readonly serverImport?: "semiotic/server";
+    readonly docsRoute?: string;
+    readonly pilot?: true;
+}
+export declare const CHART_CLINIC_METADATA: Readonly<Record<string, ChartClinicMetadata>>;
+export {};

package/dist/components/ai/useNavigationSync.d.ts

@@ -1,3 +1,4 @@
+import type { ChartObservation } from "../store/ObservationStore";
 import type { NavTreeNode } from "./navigationTree";
 import type { Datum } from "../charts/shared/datumTypes";
 /**
@@ -29,8 +30,12 @@ export interface UseNavigationSyncOptions {
     matchFields?: string[];
     /** Selection name shared with the chart's `selection={{ name }}`. Default "__semiotic-nav-sync". */
     selectionName?: string;
-    /** Which canvas observations move the tree. Default ["hover", "click"]. */
-    observe?: Array<"hover" | "click">;
+    /**
+     * Which chart observations move the tree. Defaults to pointer hover/click
+     * plus keyboard focus/activation so raw frames and HOC charts stay in sync
+     * for both pointer and keyboard readers.
+     */
+    observe?: Array<"hover" | "click" | "focus" | "activate">;
     /**
      * The chart's annotations. An annotation anchored to a datum carries that
      * datum's identifying fields (the same `matchFields` used for hover sync), so
@@ -49,6 +54,16 @@ export interface UseNavigationSyncResult {
     selection: {
         name: string;
     };
+    /**
+     * Feed a chart observation directly into the sync. This is useful for raw
+     * StreamFrames or custom interactions that call `onObservation` themselves
+     * instead of publishing through the chart HOCs. Matching pointer and
+     * keyboard observations move the tree; events later received from the global
+     * observation store are de-duplicated by object identity.
+     */
+    onObservation: (observation: ChartObservation) => void;
+    /** Alias of `onObservation` for composing an externally supplied handler. */
+    handleObservation: (observation: ChartObservation) => void;
     /** Nav-tree leaf ids that an annotation anchors to — mark these as "has a note". */
     annotatedIds: Set<string>;
     /**

package/dist/components/chartContainerMobile.d.ts

@@ -0,0 +1,9 @@
+import type { ReactElement } from "react";
+import type { MobileStandardControlRequest, MobileStandardControlsProps } from "./MobileStandardControls";
+import type { MobileInteractionProp } from "./charts/shared/types";
+export declare function canReceiveChartProps(child: ReactElement): boolean;
+export declare function isMobileStandardControlsProps(value: MobileStandardControlRequest | MobileStandardControlsProps | undefined): value is MobileStandardControlsProps;
+export declare function standardControlsFromInteraction(mobileInteraction: MobileInteractionProp | undefined): MobileStandardControlRequest | undefined;
+export declare function targetSizeFromInteraction(mobileInteraction: MobileInteractionProp | undefined): number | undefined;
+export declare function hasStandardControlsRequest(request: MobileStandardControlRequest | undefined): request is MobileStandardControlRequest;
+export declare function withStandardControls(source: MobileInteractionProp | undefined, controls: MobileStandardControlRequest | undefined): MobileInteractionProp | undefined;

package/dist/components/charts/geo/ChoroplethMap.d.ts

@@ -4,6 +4,7 @@ import type { StreamGeoFrameProps, ProjectionProp } from "../../stream/geoTypes"
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 import { type AreasProp } from "../../geo/useReferenceAreas";
 /**
  * ChoroplethMap component props
@@ -33,6 +34,17 @@ export interface ChoroplethMapProps<TDatum extends Datum = Datum> extends BaseCh
     valueAccessor: ChartAccessor<TDatum, number>;
     /** Sequential color scheme @default "blues" */
     colorScheme?: string;
+    /**
+     * Declarative, threshold-aware feature styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins per property. `when` accepts a predicate
+     * `(feature, ctx) => boolean` (`ctx.value` is the feature's `valueAccessor`
+     * value; rules see the feature with its `properties` flattened, so
+     * `{ field: "iso", eq: "USA" }` works), a declarative threshold
+     * (`{ gt, gte, within, in, … }`), or `true`. A rule's `fill` may be a color
+     * or a HatchFill (hatch flags a feature — e.g. "no data" / "under review").
+     * Layers over the sequential-scale base fill.
+     */
+    styleRules?: StyleRule[];
     /** Geographic projection @default "equalEarth" */
     projection?: ProjectionProp;
     /** Show graticule grid lines */
@@ -43,8 +55,13 @@ export interface ChoroplethMapProps<TDatum extends Datum = Datum> extends BaseCh
     showLegend?: boolean;
     /** Legend interaction mode */
     legendInteraction?: LegendInteractionMode;
-    /** Padding fraction for auto-fit projection. 0.1 = 10% inset from edges. @default 0 */
-    fitPadding?: number;
+    /**
+     * Finite projection-fit fraction in `[0, 0.5)`. `0.1` = 10% inset;
+     * nullish values use 0 and invalid values throw. An explicit
+     * `frameProps.projectionExtent` remains authoritative.
+     * @default 0
+     */
+    fitPadding?: number | null;
     /** Enable zoom/pan. Defaults to true when tileURL is set, false otherwise. */
     zoomable?: boolean;
     /** [minZoom, maxZoom] @default [1, 8] */

package/dist/components/charts/geo/DistanceCartogram.d.ts

@@ -4,6 +4,7 @@ import type { StreamGeoFrameProps, ProjectionProp } from "../../stream/geoTypes"
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendPosition } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /** Point data with geographic coordinates */
@@ -36,6 +37,12 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
     transition?: number;
     /** Field to determine point color */
     colorBy?: ChartAccessor<TDatum, string>;
+    /**
+     * Declarative, threshold-aware point styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins. `ctx` = `{ value, category }`
+     * (category = `colorBy`). A rule `fill` may be a color or a HatchFill.
+     */
+    styleRules?: StyleRule[];
     /** Color scheme @default "category10" */
     colorScheme?: string | string[] | Record<string, string>;
     /** Point radius @default 5 */
@@ -46,8 +53,13 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
     showLegend?: boolean;
     /** Legend position */
     legendPosition?: LegendPosition;
-    /** Padding fraction for auto-fit projection. 0.1 = 10% inset from edges. @default 0 */
-    fitPadding?: number;
+    /**
+     * Finite projection-fit fraction in `[0, 0.5)`. `0.1` = 10% inset;
+     * nullish values use 0 and invalid values throw. An explicit
+     * `frameProps.projectionExtent` remains authoritative.
+     * @default 0
+     */
+    fitPadding?: number | null;
     /** Enable zoom/pan. Defaults to true when tileURL is set, false otherwise. */
     zoomable?: boolean;
     /** [minZoom, maxZoom] @default [1, 8] */

package/dist/components/charts/geo/FlowMap.d.ts

@@ -10,12 +10,11 @@ import type { GeoParticleStyle } from "../../stream/GeoParticlePool";
 import { type AreasProp } from "../../geo/useReferenceAreas";
 export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /** Flow edges with source/target/value */
-    flows?: {
+    flows?: Array<Datum & {
         source: string;
         target: string;
         value?: number;
-        [key: string]: any;
-    }[];
+    }>;
     /** Geographic nodes with coordinates */
     nodes?: TDatum[];
     /** Node ID accessor @default "id" */
@@ -39,7 +38,7 @@ export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartPro
     /** Background area style */
     areaStyle?: Style;
     /** Edge color accessor */
-    edgeColorBy?: ChartAccessor<any, string>;
+    edgeColorBy?: ChartAccessor<Datum, string>;
     /** Edge opacity @default 0.6 */
     edgeOpacity?: number;
     /** Min/max pixel width for proportional edge width @default [1, 8] */
@@ -60,8 +59,13 @@ export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartPro
     legendInteraction?: LegendInteractionMode;
     /** Legend position */
     legendPosition?: LegendPosition;
-    /** Padding fraction for auto-fit projection. 0.1 = 10% inset from edges. @default 0 */
-    fitPadding?: number;
+    /**
+     * Finite projection-fit fraction in `[0, 0.5)`. `0.1` = 10% inset;
+     * nullish values use 0 and invalid values throw. An explicit
+     * `frameProps.projectionExtent` remains authoritative.
+     * @default 0
+     */
+    fitPadding?: number | null;
     /** Enable zoom/pan. Defaults to true when tileURL is set, false otherwise. */
     zoomable?: boolean;
     /** [minZoom, maxZoom] @default [1, 8] */

package/dist/components/charts/geo/ProportionalSymbolMap.d.ts

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 import type { Style } from "../../stream/types";
 import { type AreasProp } from "../../geo/useReferenceAreas";
 export interface ProportionalSymbolMapProps<TDatum extends Datum = Datum> extends BaseChartProps {
@@ -20,6 +21,12 @@ export interface ProportionalSymbolMapProps<TDatum extends Datum = Datum> extend
     sizeRange?: [number, number];
     /** Field to determine point color */
     colorBy?: ChartAccessor<TDatum, string>;
+    /**
+     * Declarative, threshold-aware symbol styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins. `ctx` = `{ value, category }` (value =
+     * `sizeBy`, category = `colorBy`). A rule `fill` may be a color or HatchFill.
+     */
+    styleRules?: StyleRule[];
     /** Color scheme @default "category10" */
     colorScheme?: string | string[] | Record<string, string>;
     /** Geographic projection @default "equalEarth" */
@@ -38,8 +45,13 @@ export interface ProportionalSymbolMapProps<TDatum extends Datum = Datum> extend
     legendInteraction?: LegendInteractionMode;
     /** Legend position */
     legendPosition?: LegendPosition;
-    /** Padding fraction for auto-fit projection. 0.1 = 10% inset from edges. @default 0 */
-    fitPadding?: number;
+    /**
+     * Finite projection-fit fraction in `[0, 0.5)`. `0.1` = 10% inset;
+     * nullish values use 0 and invalid values throw. An explicit
+     * `frameProps.projectionExtent` remains authoritative.
+     * @default 0
+     */
+    fitPadding?: number | null;
     /** Enable zoom/pan. Defaults to true when tileURL is set, false otherwise. */
     zoomable?: boolean;
     /** [minZoom, maxZoom] @default [1, 8] */

package/dist/components/charts/index.d.ts

@@ -133,3 +133,9 @@ export { Tooltip, MultiLineTooltip, normalizeTooltip } from "../Tooltip/Tooltip"
 export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig } from "../Tooltip/Tooltip";
 export { createHatchPattern } from "./shared/hatchPattern";
 export type { HatchPatternOptions } from "./shared/hatchPattern";
+export { isHatchFill, hatchPatternDef, resolveSvgFill, hatchFillId } from "./shared/hatchFill";
+export type { HatchFill } from "./shared/hatchFill";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeXYRuleContext, makeNodeRuleContext, composeStyleRules, makeStyleRuleStyleFn, } from "./shared/styleRules";
+export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate, } from "./shared/styleRules";
+export { AnnotationLabel, estimateLabelWidth } from "./shared/AnnotationLabel";
+export type { AnnotationLabelBackground, AnnotationLabelBackgroundConfig, AnnotationLabelProps } from "./shared/AnnotationLabel";

package/dist/components/charts/network/ChordDiagram.d.ts

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 /**
  * ChordDiagram component props
  */
@@ -17,10 +18,17 @@ export interface ChordDiagramProps<TNode extends Datum = Datum, TEdge extends Da
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string>;
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware node styling (see ForceDirectedGraph).
+     * Ordered `{ when, style }` rules; last applicable rule wins. Rules see the
+     * raw node object. A rule `fill` may be a color or a HatchFill.
+     */
+    styleRules?: StyleRule[];
     edgeColorBy?: "source" | "target" | ((d: Datum) => string);
     padAngle?: number;
     groupWidth?: number;
-    sortGroups?: (a: any, b: any) => number;
+    /** Compare D3 chord group indices to control their angular order. */
+    sortGroups?: (a: number, b: number) => number;
     nodeLabel?: ChartAccessor<TNode, string>;
     showLabels?: boolean;
     enableHover?: boolean;

package/dist/components/charts/network/ForceDirectedGraph.d.ts

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 /**
  * ForceDirectedGraph component props
  */
@@ -68,6 +69,16 @@ export interface ForceDirectedGraphProps<TNode extends Datum = Datum, TEdge exte
     colorBy?: ChartAccessor<TNode, string>;
     /** d3 scheme name or explicit color array; falls back to theme. */
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware node styling. Ordered `{ when, style }`
+     * rules; the last applicable rule wins per property. `when` accepts a
+     * predicate `(node, ctx) => boolean` (rules see the raw node object; `ctx` =
+     * `{ value, category }` where `category` is the `colorBy` group), a
+     * declarative threshold (`{ field, gt, eq, in, … }`), or `true` — so you can
+     * style whole groups of nodes (`{ field: "type", eq: "db" }`). A rule's
+     * `fill` may be a color or a HatchFill. Layers over the resolved node color.
+     */
+    styleRules?: StyleRule[];
     /**
      * Constant pixel radius, or a function/field returning a numeric value
      * scaled into `nodeSizeRange`.

package/dist/components/charts/network/SankeyDiagram.d.ts

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 /**
  * SankeyDiagram component props
  */
@@ -17,6 +18,13 @@ export interface SankeyDiagramProps<TNode extends Datum = Datum, TEdge extends D
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string>;
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware node styling (see ForceDirectedGraph).
+     * Ordered `{ when, style }` rules; last applicable rule wins. Rules see the
+     * raw node object; `ctx` = `{ value, category }`. A rule `fill` may be a
+     * color or a HatchFill. Layers over the resolved node color.
+     */
+    styleRules?: StyleRule[];
     edgeColorBy?: "source" | "target" | "gradient" | ((d: Datum) => string);
     orientation?: "horizontal" | "vertical";
     nodeAlign?: "justify" | "left" | "right" | "center";
@@ -31,7 +39,7 @@ export interface SankeyDiagramProps<TNode extends Datum = Datum, TEdge extends D
     legendPosition?: LegendPosition;
     legendInteraction?: LegendInteractionMode;
     edgeOpacity?: number;
-    edgeSort?: (a: any, b: any) => number;
+    edgeSort?: (a: TEdge, b: TEdge) => number;
     tooltip?: TooltipProp;
     frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
 }

package/dist/components/charts/ordinal/BarChart.d.ts

@@ -5,6 +5,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { RealtimeFrameHandle } from "../../realtime/types";
+import { type StyleRule } from "../shared/styleRules";
 import { type RegressionProp } from "../shared/regressionUtils";
 /**
  * BarChart component props
@@ -81,6 +82,26 @@ export interface BarChartProps<TDatum extends Datum = Datum> extends BaseChartPr
             color: string;
         }>;
     };
+    /**
+     * Declarative, threshold-aware bar styling. An ordered list of
+     * `{ when, style }` rules; every rule whose condition matches a bar
+     * contributes its style, merged in order so the **last applicable rule
+     * wins** per property. `when` accepts a predicate `(datum, ctx) => boolean`,
+     * a declarative threshold (`{ gt, lte, within, in, … }` — compares the
+     * bar's value unless `field` is set), or `true`/omitted (always applies).
+     * A rule's `fill` may be a color string or a declarative
+     * {@link HatchFill} for diagonal hatching (renders on canvas and SSR).
+     * Rules layer over the resolved base color; `frameProps.pieceStyle` and
+     * top-level `stroke`/`strokeWidth`/`opacity` still override them.
+     * @example
+     * ```tsx
+     * styleRules={[
+     *   { when: { gte: 10 }, style: { fill: "var(--semiotic-warning)" } },
+     *   { when: { gt: 15 }, style: { fill: { type: "hatch", background: "#e0a92a", stroke: "#fff" } } },
+     * ]}
+     * ```
+     */
+    styleRules?: StyleRule[];
     /** When true, adds padding below the 0 baseline. Default false (bars flush with axis). */
     baselinePadding?: boolean;
     enableHover?: boolean;

package/dist/components/charts/ordinal/GroupedBarChart.d.ts

@@ -4,6 +4,7 @@ import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import { type StyleRule } from "../shared/styleRules";
 import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
@@ -21,6 +22,16 @@ export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends Base
     barPadding?: number;
     /** Rounded corner radius on bar ends (away from baseline). */
     roundedTop?: number;
+    /**
+     * Declarative, threshold-aware bar styling. Ordered `{ when, style }`
+     * rules; the last applicable rule wins per property. `when` accepts a
+     * predicate `(datum, ctx) => boolean` (where `ctx.category` is the group
+     * series key), a declarative threshold on the bar value
+     * (`{ gt, lte, within, in, … }`), or `true`. A rule's `fill` may be a color
+     * or a {@link HatchFill}. Layers over the resolved series color;
+     * `frameProps.pieceStyle` overrides.
+     */
+    styleRules?: StyleRule[];
     baselinePadding?: boolean;
     enableHover?: boolean;
     showGrid?: boolean;

package/dist/components/charts/ordinal/StackedBarChart.d.ts

@@ -5,6 +5,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { RealtimeFrameHandle } from "../../realtime/types";
+import { type StyleRule } from "../shared/styleRules";
 export interface StackedBarChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
@@ -22,6 +23,16 @@ export interface StackedBarChartProps<TDatum extends Datum = Datum> extends Base
     barPadding?: number;
     /** Rounded top corner radius. Only the topmost stacked segment gets rounded. */
     roundedTop?: number;
+    /**
+     * Declarative, threshold-aware segment styling. Ordered `{ when, style }`
+     * rules; the last applicable rule wins per property. `when` accepts a
+     * predicate `(datum, ctx) => boolean` (where `ctx.category` is the stack
+     * series key), a declarative threshold on the segment value
+     * (`{ gt, lte, within, in, … }`), or `true`. A rule's `fill` may be a color
+     * or a {@link HatchFill} for hatching a segment (e.g. a "fixed-rate" band).
+     * Layers over the resolved series color; `frameProps.pieceStyle` overrides.
+     */
+    styleRules?: StyleRule[];
     baselinePadding?: boolean;
     enableHover?: boolean;
     showGrid?: boolean;

package/dist/components/charts/physics/CollisionSwarmChart.d.ts

@@ -1,6 +1,7 @@
 import * as React from "react";
 import type { Datum } from "../shared/datumTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import type { StyleRule } from "../shared/styleRules";
 import { type PhysicsFrameHandle } from "./physicsHocHandle";
 import { type PhysicsHocFrameProps, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
 export interface CollisionSwarmChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin">, PhysicsSharedChartProps {
@@ -11,6 +12,12 @@ export interface CollisionSwarmChartProps<TDatum extends Datum = Datum> extends
     radiusAccessor?: ChartAccessor<TDatum, number>;
     pointRadius?: number;
     colorBy?: ChartAccessor<TDatum, string>;
+    /**
+     * Declarative, threshold-aware dot styling. Ordered `{ when, style }` rules;
+     * last applicable rule wins. `ctx` = `{ value, category }` (value = the
+     * `xAccessor` position). A rule `fill` may be a color or a HatchFill.
+     */
+    styleRules?: StyleRule[];
     seed?: number;
     xExtent?: [number, number];
     collisionIterations?: number;

package/dist/components/charts/physics/EventDropChart.d.ts

@@ -2,6 +2,7 @@ import * as React from "react";
 import type { Datum } from "../shared/datumTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type EventDropWindowOptions } from "./physicsChartUtils";
+import type { StyleRule } from "../shared/styleRules";
 import { type PhysicsFrameHandle } from "./physicsHocHandle";
 import { type PhysicsHocFrameProps, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
 export interface EventDropChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin">, PhysicsSharedChartProps {
@@ -16,6 +17,12 @@ export interface EventDropChartProps<TDatum extends Datum = Datum> extends Omit<
     } | ((latestEventTime: number) => number);
     ballRadius?: number;
     colorBy?: ChartAccessor<TDatum, string>;
+    /**
+     * Declarative, threshold-aware drop styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins. `ctx` = `{ value, category }` (value =
+     * the event time). A rule `fill` may be a color or a HatchFill.
+     */
+    styleRules?: StyleRule[];
     seed?: number;
     timeExtent?: [number, number];
     timeScale?: number;

package/dist/components/charts/physics/GaltonBoardChart.d.ts

@@ -1,6 +1,7 @@
 import * as React from "react";
 import type { Datum } from "../shared/datumTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import type { StyleRule } from "../shared/styleRules";
 import { type PhysicsFrameHandle } from "./physicsHocHandle";
 import { type PhysicsHocFrameProps, type PhysicsSharedChartProps, type PhysicsSimulationMode, type TooltipProp } from "./physicsHocUtils";
 import type { ChartMode } from "../shared/types";
@@ -32,6 +33,13 @@ export interface GaltonBoardChartProps<TDatum extends Datum = Datum> extends Omi
     branchProbability?: number;
     ballRadius?: number;
     colorBy?: ChartAccessor<TDatum, string>;
+    /**
+     * Declarative, threshold-aware ball styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins. Rules resolve against each ball's datum;
+     * `ctx` = `{ value, category }` (category = the colorBy group). A rule `fill`
+     * may be a color or a HatchFill. Layers over the colorBy-derived fill.
+     */
+    styleRules?: StyleRule[];
     referenceLines?: GaltonBoardReferenceLine | GaltonBoardReferenceLine[];
     seed?: number;
     showProjection?: boolean;