semiotic 3.8.3 → 3.8.5

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

@@ -0,0 +1,2 @@
+"use client";
+import{bandFromAge as t,defaultTooltipStyle as e,normalizeTooltip as n,opacityFromAge as r,resolveCanvasFill as o}from"./chunk-chunk-CWQ5YIHX.module.min.js";import{drawGlyphParts as a,glyphFractionClipRect as s,glyphHitGeometry as l,glyphPlacement as c}from"./chunk-chunk-KTWEBFMX.module.min.js";function i(t,e){const n={...t};return e.provenance&&(n.provenance=e.provenance),e.lifecycle&&(n.lifecycle=e.lifecycle),n}function u(){return(new Date).toISOString()}function f(t,e={}){const n=t.provenance;return{...t,provenance:{...n,...e,createdAt:e.createdAt??n?.createdAt??u()}}}function d(t){if(null==t)return null;if("number"==typeof t)return t;if(t instanceof Date)return t.getTime();const e=Date.parse(t);return Number.isFinite(e)?e:null}function p(t){const e=d(t?.now);if(null!=e)return e;const n=t?.dataExtent;if(n)if(Array.isArray(n)){const t=d(n[n.length-1]);if(null!=t)return t}else if("max"in n){const t=d(n.max);if(null!=t)return t}return Date.now()}function h(e,n,r={}){const o=e?.lifecycle?.freshness,a=d(e?.provenance?.createdAt),s=function(t){if(null==t)return null;if("number"==typeof t)return t;const e=function(t){const e=/^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/.exec(t);return e?1e3*(3600*(24*parseInt(e[1]||"0",10)+parseInt(e[2]||"0",10))+60*parseInt(e[3]||"0",10)+parseInt(e[4]||"0",10)):0}(t);return e>0?e:null}(e?.lifecycle?.ttlHint);return null==a||null==s?o??"fresh":t(n-a,s,r)}function y(t,e={}){const n=p(e);return t.map(t=>{const r=h(t,n,e.thresholds);return{...t,lifecycle:{...t.lifecycle,freshness:r}}})}var g={fresh:null,aging:.55,stale:.35,expired:.2},m={fresh:null,aging:null,stale:"4 4",expired:"2 4"};function x(t,e,n){return t&&n in t?t[n]:e[n]}function b(t,e={}){const n=p(e),r=!0===e.showExpiredAnnotations,o=[];for(const a of t){const t=h(a,n,e.thresholds);if("expired"===t&&!r)continue;const s=x(e.opacity,g,t),l=x(e.strokeDasharray,m,t),c=e.labelSuffix?.[t],i={...a,lifecycle:{...a.lifecycle,freshness:t}};null!=s&&null==i.opacity&&(i.opacity=s),null!=l&&null==i.strokeDasharray&&(i.strokeDasharray=l),c&&"string"==typeof i.label&&(i.label=i.label+c);const u=a.lifecycle?.anchor;u&&null==i.anchor&&(i.anchor=u),o.push(i)}return o}var v={proposed:.7,accepted:null,disputed:.7,retracted:.25},w={proposed:"3 3",accepted:null,disputed:"2 3",retracted:"2 4"},A={proposed:" (proposed)",accepted:"",disputed:" (?)",retracted:""};function I(t,e,n){return t&&n in t?t[n]:e[n]}function k(t,e={}){const n=!0===e.showRetractedAnnotations,r=!0===e.showSupersededAnnotations,o=new Set;for(const e of t){const t=e?.lifecycle?.supersedes;t&&"retracted"!==e?.lifecycle?.status&&o.add(t)}return t.filter(t=>{if("retracted"===t?.lifecycle?.status&&!n)return!1;const e=t?.provenance?.stableId;return!(e&&o.has(e)&&!r)})}function _(t,e={}){const n=[];for(const r of k(t,e)){const t=r?.lifecycle?.status;if(!t){n.push(r);continue}const o=I(e.opacity,v,t),a=I(e.strokeDasharray,w,t),s=e.labelSuffix?.[t]??A[t],l={...r};null!=o&&(l.opacity=("number"==typeof l.opacity?l.opacity:1)*o),null!=a&&null==l.strokeDasharray&&(l.strokeDasharray=a),s&&"string"==typeof l.label&&(l.label=l.label+s),n.push(l)}return n}import{jsx as M,jsxs as S}from"react/jsx-runtime";function D(t){return"string"==typeof t?t:"value"}function O(t){return null==t?"–":"number"==typeof t?Math.abs(t)>9999?t.toLocaleString():t+"":t instanceof Date?t.toLocaleDateString():t+""}function E(t,e){if(!e)return O(t);try{const n=e(t);return null==n?O(t):n}catch{return O(t)}}function R(t,e){return"function"==typeof e?e(t):t[e]}function P(t,e){if(!t)return[];const n=[];return(Array.isArray(t)?t:[t]).forEach((t,r)=>{const o="string"==typeof t?.y0Accessor?t.y0Accessor:"low",a="string"==typeof t?.y1Accessor?t.y1Accessor:"high";n.push({label:o,accessor:t=>t.bands?.[r]?.y0??(0===r?t.band?.y0:void 0),format:e}),n.push({label:a,accessor:t=>t.bands?.[r]?.y1??(0===r?t.band?.y1:void 0),format:e})}),n}function j(t){const n=t.find(t=>"title"===t.role),r=t.filter(t=>"title"!==t.role);return t=>{const o=t.data;if(!o)return null;const a=n?E(R(o,n.accessor),n.format):null;return S("div",{className:"semiotic-tooltip",style:e,children:[null!=a&&M("div",{style:{fontWeight:"bold",marginBottom:r.length>0?4:0},children:a}),r.map((t,e)=>{const n=E(R(o,t.accessor),t.format);return S("div",{style:e>0?{marginTop:2}:void 0,children:[S("span",{style:{opacity:.7},children:[t.label,": "]}),M("span",{children:n})]},e)})]})}}function C({categoryAccessor:t,valueAccessor:n,groupAccessor:r,groupLabel:o,pieData:a=!1,valueFormat:s}){return l=>{const c=a?l.data?.[0]||l.data||l:l.data||l,i=R(c,t),u=R(c,n),f=r?R(c,r):void 0;return S("div",{className:"semiotic-tooltip",style:e,children:[M("div",{style:{fontWeight:"bold"},children:O(i)}),M("div",{style:{marginTop:4},children:E(u,s)}),null!=f&&S("div",{style:{marginTop:2,opacity:.8},children:[o||D(r),": ",O(f)]})]})}}import*as T from"react";function L(...t){const e=t.filter(t=>null!=t);return 0===e.length?null:1===e.length?e[0]:T.createElement(T.Fragment,null,...e)}import{useEffect as z,useRef as H}from"react";function $(t,e,n,r){z(()=>{t.current?.updateConfig(e),n.current=!0,r()},[e,r,t,n])}function N(t,e,n,r){const o=H(null);z(()=>{const a=t.current;if(!a)return;const s=e??null;o.current!==s&&(o.current=s,a.setLayoutSelection(s),a.hasCustomRestyle?a.restyleScene(s):n.current=!0,r())},[e,r,t,n])}var W={fresh:1,aging:.7,stale:.45,expired:.25},G={alpha:1,band:"fresh",isStale:!1};function U(e,n){if(!e||0>=n)return G;const r=null!=e.threshold&&e.threshold>0?e.threshold:5e3,o=e.graded;if(o){const e="object"==typeof o?o:{},a=t(n,r,e.thresholds);return{alpha:{...W,...e.opacities??{}}[a],band:a,isStale:"fresh"!==a}}return n>r?{alpha:e.dimOpacity??.5,band:"stale",isStale:!0}:G}import{useEffect as B,useRef as F}from"react";function V(t,e,n,r,o,a){const s=F("fresh");B(()=>{if(!t)return;const l=setInterval(()=>{const l=e.current;if(!l||0===l.lastIngestTime)return;const c="undefined"!=typeof performance?performance.now():Date.now(),i=U(t,c-l.lastIngestTime);i.band===s.current&&i.isStale===o||(s.current=i.band,i.isStale!==o&&a(i.isStale),n.current=!0,r())},1e3);return()=>clearInterval(l)},[t,o,r,e,a,n])}import{jsx as Y}from"react/jsx-runtime";function X({isStale:t,position:e}){return Y("div",{className:"stream-staleness-badge",style:{position:"absolute",..."top-left"===e?{top:4,left:4}:"bottom-left"===e?{bottom:4,left:4}:"bottom-right"===e?{bottom:4,right:4}:{top:4,right:4},padding:"2px 8px",borderRadius:4,fontSize:11,fontWeight:600,pointerEvents:"none",zIndex:3,background:t?"#dc3545":"#28a745",color:"white"},children:t?"STALE":"LIVE"})}import{useRef as K}from"react";function q(t){const e=K(t);return function(t,e){if(Object.is(t,e))return!0;if(Array.isArray(t)&&Array.isArray(e))return J(t,e);if(!Z(t)||!Z(e))return!1;const n=Object.keys(t),r=Object.keys(e);if(n.length!==r.length)return!1;for(const r of n){if(!Object.prototype.hasOwnProperty.call(e,r))return!1;const n=t[r],o=e[r];if(!Object.is(n,o))if(Array.isArray(n)&&Array.isArray(o)){if(!J(n,o))return!1}else{if(!Z(n)||!Z(o))return!1;if(!Q(n,o))return!1}}return!0}(e.current,t)||(e.current=t),e.current}function Q(t,e){const n=Object.keys(t),r=Object.keys(e);if(n.length!==r.length)return!1;for(const r of n){if(!Object.prototype.hasOwnProperty.call(e,r))return!1;if(!Object.is(t[r],e[r]))return!1}return!0}function J(t,e){if(t.length!==e.length)return!1;for(let n=0;t.length>n;n++)if(!Object.is(t[n],e[n]))return!1;return!0}function Z(t){if(null===t||"object"!=typeof t)return!1;if(Array.isArray(t))return!1;const e=Object.getPrototypeOf(t);return e===Object.prototype||null===e}function tt(t,e,n,r,l){if(0>=e.size)return;const i=e.glyph;if(!i||!i.parts?.length)return;const u=c(i,e.size);if(0>=u.scale)return;const f=(e.style.opacity??1)*(e._decayOpacity??1);if(0>=f)return;const d=e=>{const n=o(t,e,e);return"string"==typeof n?n:e},p=e.color??("string"==typeof e.style.fill?e.style.fill:void 0);t.save(),t.translate(n,r),e.rotation&&t.rotate(e.rotation),t.translate(u.offsetX,u.offsetY),t.scale(u.scale,u.scale),t.globalAlpha=l*f*(e.style.fillOpacity??1);const h=s(i,e.fraction??1,e.fractionStart??0,e.fractionDirection??"horizontal");h&&e.ghostColor&&a(t,i,p,e.accent,e.ghostColor,d),h&&(t.beginPath(),t.rect(h.x,h.y,h.width,h.height),t.clip()),a(t,i,p,e.accent,void 0,d),t.restore()}var et=(t,e)=>{const n=t.globalAlpha;for(const r of e)"glyph"===r.type&&tt(t,r,r.x,r.y,n);t.globalAlpha=n};function nt(t,e){const n=t.globalAlpha;for(const r of e)"glyph"===r.type&&tt(t,r,r.cx,r.cy,n);t.globalAlpha=n}var rt=new Set;function ot(t,e){const n="function"==typeof t?t(e.datum??null,e):t;return(r=n)&&"object"==typeof r&&"string"==typeof r.id&&"function"==typeof r.cacheKey&&"function"==typeof r.drawCanvas&&"function"==typeof r.renderStaticSVG?n:void 0;var r}function at(t,e){if("undefined"!=typeof process&&"production"===process.env?.NODE_ENV)return;const n=`${t}:${e}`;rt.has(n)||(rt.add(n),console.warn(`[Semiotic] Render backend "${t}" does not support scene node "${e}"; using the built-in renderer.`))}function st(t){const{context:e,nodes:n,renderMode:r,pixelRatio:o,paintBuiltIn:a}=t;if(!r||"sketchy"===r)return void a(n);let s=[];const l=()=>{s.length&&(a(s),s=[])};for(const t of n){const n=ot(r,t);if(!n){s.push(t);continue}let c;l(),e.save();try{c=n.drawCanvas({context:e,node:t,style:t.style??{},pixelRatio:o})}finally{e.restore()}c||(at(n.id,t.type??"unknown"),a([t]))}l()}function lt(t){const{node:e,index:n,renderMode:r,fallback:o}=t,a=ot(r,e);if(!a)return o();const s=a.renderStaticSVG({node:e,style:e.style??{},key:`${a.id}-${n}`});return null!=s?s:(at(a.id,e.type??"unknown"),o())}function ct(t){const e=new Map;for(const n of t){const t=n.group??"_default";let r=e.get(t);r||(r=[],e.set(t,r)),r.push(n)}for(const t of e.values()){t.sort((t,e)=>t.x-e.x||t.y-e.y);for(let e=0;t.length>e;e++)t[e]._groupIndex=e}const n=Array.from(e.keys()).sort((t,n)=>{const r=e.get(t),o=e.get(n);return(r.length>0?r[0].y:0)-(o.length>0?o[0].y:0)}),r=Array.from(e.values()).flat();r.sort((t,e)=>t.x-e.x||t.y-e.y);const o=new Map;for(let t=0;r.length>t;t++){r[t]._flatIndex=t;const e=r[t].datum?.id;null!=e&&o.set(e+"",t)}return{flat:r,groups:n,byGroup:e,idToIdx:o}}function it(t,e){if(0===t.flat.length)return{flatIndex:-1,group:"_default",indexInGroup:-1};const n=Math.max(0,Math.min(e,t.flat.length-1)),r=t.flat[n];return{flatIndex:n,group:r.group??"_default",indexInGroup:r._groupIndex??0}}function ut(t,e,n){const{group:r,indexInGroup:o}=e,a=n.byGroup.get(r);switch(t){case"ArrowRight":return a.length-1>o?a[o+1]._flatIndex:e.flatIndex;case"ArrowLeft":return o>0?a[o-1]._flatIndex:e.flatIndex;case"ArrowDown":{const t=n.groups.indexOf(r);return n.groups.length-1>t?ft(n,n.groups[t+1],a[o]):e.flatIndex}case"ArrowUp":{const t=n.groups.indexOf(r);return t>0?ft(n,n.groups[t-1],a[o]):e.flatIndex}case"PageDown":return Math.min(e.flatIndex+Math.max(1,Math.floor(.1*n.flat.length)),n.flat.length-1);case"PageUp":return Math.max(e.flatIndex-Math.max(1,Math.floor(.1*n.flat.length)),0);case"Home":return 0;case"End":return n.flat.length-1;case"Escape":return-1;default:return null}}function ft(t,e,n){const r=t.byGroup.get(e);let o=0,a=Math.abs(r[0].x-n.x);for(let t=1;r.length>t;t++){const e=Math.abs(r[t].x-n.x);a>e&&(a=e,o=t)}return r[o]._flatIndex}function dt(t){const e=[];for(const n of t)switch(n.type){case"point":e.push({x:n.x,y:n.y,datum:n.datum,shape:"circle",group:"_default"});break;case"symbol":if(0>=n.size)break;e.push({x:n.x,y:n.y,datum:n.datum,shape:"circle",group:"_default"});break;case"glyph":{if(0>=n.size||null==n.datum)break;const t=l(n.glyph,n.size);e.push({x:n.x+t.centerDx,y:n.y+t.centerDy,datum:n.datum,shape:"rect",w:2*t.halfWidth,h:2*t.halfHeight,group:"_default"});break}case"line":{const t=n,r=Array.isArray(t.datum)?t.datum:[],o=t.group??"_default";for(let n=0;t.path.length>n&&r.length>n;n++)e.push({x:t.path[n][0],y:t.path[n][1],datum:r[n],shape:"circle",group:o});break}case"area":{const t=n,r=Array.isArray(t.datum)?t.datum:[],o=t.group??"_default";for(let n=0;t.topPath.length>n&&r.length>n;n++)e.push({x:t.topPath[n][0],y:t.topPath[n][1],datum:r[n],shape:"circle",group:o});break}case"rect":e.push({x:n.x+n.w/2,y:n.y+n.h/2,datum:n.datum,shape:"rect",w:n.w,h:n.h,group:n.group??"_default"});break;case"heatcell":e.push({x:n.x+n.w/2,y:n.y+n.h/2,datum:n.datum,shape:"rect",w:n.w,h:n.h,group:"_default"})}return e.sort((t,e)=>t.x-e.x||t.y-e.y),e}function pt(t){const e=[];for(const n of t)if("rect"===n.type&&null!=n.x){if(null==n.datum)continue;e.push({x:n.x+n.w/2,y:n.y+n.h/2,datum:n.datum,shape:"rect",w:n.w,h:n.h,group:n.group??n.datum?.category??""})}else if("point"===n.type)e.push({x:n.x,y:n.y,datum:n.datum,shape:"circle",group:"_default"});else if("symbol"===n.type){if(0>=n.size)continue;e.push({x:n.x,y:n.y,datum:n.datum,shape:"circle",group:"_default"})}else if("glyph"===n.type){if(0>=n.size||null==n.datum)continue;const t=l(n.glyph,n.size);e.push({x:n.x+t.centerDx,y:n.y+t.centerDy,datum:n.datum,shape:"rect",w:2*t.halfWidth,h:2*t.halfHeight,group:"_default"})}else if("wedge"===n.type&&null!=n.cx){if(null===n.datum)continue;const t=((n.startAngle||0)+(n.endAngle||0))/2,r=((n.innerRadius||0)+(n.outerRadius||50))/2;e.push({x:n.cx+Math.cos(t)*r,y:n.cy+Math.sin(t)*r,datum:n.datum,shape:"wedge",group:"_default"})}return e.sort((t,e)=>t.x-e.x||t.y-e.y),e}function ht(t){const e=[];for(const n of t)if("circle"===n.type&&null!=n.cx){if(0>=n.r)continue;e.push({x:n.cx,y:n.cy,datum:n.datum,shape:"circle",group:n.datum?.id??"_default"})}else if("rect"===n.type&&null!=n.x){if(0>=n.w||0>=n.h)continue;e.push({x:n.x+n.w/2,y:n.y+n.h/2,datum:n.datum,shape:"rect",w:n.w,h:n.h,group:n.datum?.id??"_default"})}else if("arc"===n.type&&null!=n.cx)e.push({x:n.cx,y:n.cy,datum:n.datum,shape:"circle",group:n.datum?.id??"_default"});else if("symbol"===n.type&&null!=n.cx){if(0>=n.size)continue;e.push({x:n.cx,y:n.cy,datum:n.datum,shape:"circle",group:n.datum?.id??"_default"})}else if("glyph"===n.type&&null!=n.cx){if(0>=n.size||null==n.datum)continue;const t=l(n.glyph,n.size);e.push({x:n.cx+t.centerDx,y:n.cy+t.centerDy,datum:n.datum,shape:"rect",w:2*t.halfWidth,h:2*t.halfHeight,group:n.datum?.id??"_default"})}return e.sort((t,e)=>t.x-e.x||t.y-e.y),e}function yt(t,e,n,r,o){const a=n.flat[e.flatIndex];if(!a)return ut(t,e,n);const s=a.datum?.id;switch(t){case"ArrowRight":case"ArrowLeft":case"ArrowDown":case"ArrowUp":{const r=function(t,e,n){let r=null,o=1/0;for(let a=0;t.flat.length>a;a++){const s=t.flat[a];if(s===e)continue;const l=s.x-e.x,c=s.y-e.y;let i=!1;switch(n){case"right":i=l>0&&Math.abs(l)>=Math.abs(c);break;case"left":i=0>l&&Math.abs(l)>=Math.abs(c);break;case"down":i=c>0&&Math.abs(c)>=Math.abs(l);break;case"up":i=0>c&&Math.abs(c)>=Math.abs(l)}if(!i)continue;const u=l*l+c*c;o>u&&(o=u,r=a)}return r}(n,a,"ArrowRight"===t?"right":"ArrowLeft"===t?"left":"ArrowDown"===t?"down":"up")??e.flatIndex;return r!==e.flatIndex&&(o.current=-1),r}case"Enter":{if(null==s)return e.flatIndex;const t=function(t,e){const n=t+"",r=[];for(const t of e){const e=t.datum??t,o=gt(e.source),a=gt(e.target),s=null!=o,l=null!=a;s&&o+""===n&&l?r.push(a+""):l&&a+""===n&&s&&r.push(o+"")}return r}(s,r);if(0===t.length)return e.flatIndex;const a=n.idToIdx.get(t[(o.current+1)%t.length])??-1;return 0>a?e.flatIndex:(o.current=-1,a)}default:{const r=ut(t,e,n);return null!==r&&r!==e.flatIndex&&(o.current=-1),r}}}function gt(t){return"object"==typeof t&&null!==t&&"id"in t?t.id:t}function mt(t){const e=[];for(const n of t)if("point"===n.type&&null!=n.x)e.push({x:n.x,y:n.y,datum:n.datum,shape:"circle"});else if("glyph"===n.type){if(0>=n.size||null==n.datum)continue;const t=l(n.glyph,n.size);e.push({x:n.x+t.centerDx,y:n.y+t.centerDy,datum:n.datum,shape:"rect",w:2*t.halfWidth,h:2*t.halfHeight})}else"geoarea"===n.type&&n.centroid&&!1!==n.interactive&&e.push({x:n.centroid[0],y:n.centroid[1],datum:n.datum,shape:"geoarea",pathData:n.pathData});return e.sort((t,e)=>t.x-e.x||t.y-e.y),e}function xt(t,e,n){switch(t){case"ArrowRight":case"ArrowDown":return n-1>e?e+1:e;case"ArrowLeft":case"ArrowUp":return e>0?e-1:e;case"PageDown":return Math.min(e+Math.max(1,Math.floor(.1*n)),n-1);case"PageUp":return Math.max(e-Math.max(1,Math.floor(.1*n)),0);case"Home":return 0;case"End":return n-1;case"Escape":return-1;default:return null}}function bt(t){return{data:t.datum||{},x:t.x,y:t.y,__semioticHoverData:!0}}function vt(t){const{title:e,description:n,summary:r,accessibleTable:o,className:a,animate:s,axisExtent:l,autoPlaceAnnotations:c}=t,i={};return e&&(i.title=e),n&&(i.description=n),r&&(i.summary=r),void 0!==o&&(i.accessibleTable=o),a&&(i.className=a),null!=s&&(i.animate=s),void 0!==l&&(i.axisExtent=l),void 0!==c&&(i.autoPlaceAnnotations=c),i}function wt(t){const{linkedHover:e,selection:n,onObservation:r,onClick:o,hoverRadius:a,hoverHighlight:s,forceHoverBehavior:l,forceClickBehavior:c,mobileInteraction:i,customHoverBehavior:u,customClickBehavior:f,linkedHoverInClickPredicate:d=!0}=t,p={};r&&(p.annotationObservationCallback=r);const h=i?.enabled?Math.max(a??30,Math.ceil((i.targetSize||44)/2),24):a;return(l||e||r||o||s)&&(p.customHoverBehavior=u),f&&(c||(d?r||o||e:r||o)||i?.enabled&&(i.tapToSelect||i.tapToLockTooltip)&&(e||s||n))&&(p.customClickBehavior=f),null!=h&&(p.hoverRadius=h),p}function At(t){const{tooltip:e,defaultTooltipContent:r}=t;return{tooltipContent:!1===e?()=>null:n(e)||r}}function It(t,e,n){if(1>=n)return 1;const o=n-1;return r({age:o-e,extent:o,type:t.type,halfLife:t.halfLife??n/2,threshold:t.stepThreshold??.5*n,minOpacity:t.minOpacity??.1})}function kt(t){const e=new Map;for(let n=0;t.length>n;n++)e.set(t[n],n);return e}function _t(t,e,n,r=kt(n)){const o=n.length;if(o>1)for(const n of e){if("line"===n.type){const e=Array.isArray(n.datum)?n.datum:[];if(2>e.length)continue;const a=Array(e.length);let s=!1;for(let n=0;e.length>n;n++){const l=r.get(e[n]);null!=l?(a[n]=It(t,l,o),1>a[n]&&(s=!0)):a[n]=1}s&&(n._decayOpacities=a);continue}if("area"===n.type){const e=Array.isArray(n.datum)?n.datum:[],a=n.topPath?n.topPath.length:e.length;if(2>a)continue;if(e.length===a){const s=Array(a);let l=!1;for(let n=0;e.length>n;n++){const a=r.get(e[n]);null!=a?(s[n]=It(t,a,o),1>s[n]&&(l=!0)):s[n]=1}l&&(n._decayOpacities=s)}else{let s=1;for(const n of e){const e=r.get(n);if(null!=e){const n=It(t,e,o);s>n&&(s=n)}}if(1>s){const t=Array(a);t.fill(s),n._decayOpacities=t}}continue}const e=r.get(n.datum);if(null==e)continue;const a=It(t,e,o);"heatcell"===n.type?n.style={opacity:a}:"candlestick"===n.type?n._decayOpacity=a:n.style={...n.style,opacity:(n.style?.opacity??1)*a}}}function Mt(t){if("production"===process.env.NODE_ENV)return;const{label:e,nodes:n,overlays:r,warned:o}=t;St(r)&&0===n.length&&Dt(o,"overlay-only",`[semiotic] ${e} returned overlays but no data-bearing scene nodes. Overlays do not participate in hover, selection, transitions, SSR evidence, or accessibility tables. Emit at least one scene node with a datum, or mark the overlay-only chart as intentionally decorative.`),n.length>0&&n.every(t=>null==t.datum)&&Dt(o,"null-datums",`[semiotic] ${e} returned scene nodes, but every scene-node datum is null. Hover, callbacks, selection, and tooltip helpers need data-bearing nodes. Attach a user-facing datum to each interactive node, or set interactive overlays outside the chart.`)}function St(t){return null!=t&&!1!==t&&""!==t&&(!Array.isArray(t)||t.some(St))}function Dt(t,e,n){t.has(e)||(t.add(e),console.warn(n))}function Ot(t,e,n,r){const o=function(t){if(t instanceof Error)return{name:t.name||"Error",message:t.message||"Custom layout threw."};if("string"==typeof t)return{name:"Error",message:t};if(null==t)return{name:"Error",message:"Custom layout threw a nullish value."};try{return{name:"Error",message:t+""}}catch{return{name:"Error",message:"Custom layout threw a non-stringifiable value."}}}(e),a="network"===t?"customNetworkLayout":"customLayout";return{code:"CUSTOM_LAYOUT_ERROR",severity:"error",phase:"layout",component:t,source:a,message:`Semiotic ${t} ${a} failed: ${o.message}`,error:o,recovery:n?"preserved-last-good-scene":"empty-scene",preservedLastGoodScene:n,affectedRevision:r}}var Et=new WeakMap;function Rt(){return this.updateResults.last}function Pt(){return this.updateResults.last}function jt(t){return this.updateResults.subscribe(t)}function Ct(t){this.config.layoutSelection=t}function Tt(){Et.set(this,!0)}function Lt(){const t=!0===Et.get(this);return Et.delete(this),t}function zt(t){Object.assign(t.prototype,{getLastUpdateResult:Rt,getUpdateSnapshot:Pt,subscribeUpdateResult:jt,setLayoutSelection:Ct,markStylePaintPending:Tt,consumeStylePaintPending:Lt})}function Ht(t,e,n){return n.x>t||t>n.x+n.w||n.y>e||e>n.y+n.h?{hit:!1,cx:0,cy:0}:{hit:!0,cx:n.x+n.w/2,cy:n.y+n.h/2}}function $t(t,e=30){return Math.max((t??4)+5,12,e)}function Nt(t){return t instanceof Date?t:"number"==typeof t&&t>1e9?new Date(t):null}function Wt(t,e){const n=Nt(t);if(!n)return!1;const r=Nt(e);return!r||n.getFullYear()!==r.getFullYear()||n.getMonth()!==r.getMonth()}function Gt(t){let e=t%(2*Math.PI);return 0>e&&(e+=2*Math.PI),e}function Ut(t,e,n,r,o,a=t=>t.x,s=t=>t.y,l=t=>t.r){const c=Math.max(r,o+5,12),i=e-c,u=e+c,f=n-c,d=n+c;let p=null,h=1/0;return t.visit((t,o,c,y,g)=>{if(o>u||i>y||c>d||f>g)return!0;if(!t.length){let o=t;do{const t=o.data,c=a(t)-e,i=s(t)-n,u=Math.sqrt(c*c+i*i);$t(l(t),r)>=u&&h>u&&(p=t,h=u),o=o.next}while(o)}return!1}),p?{node:p,distance:h}:null}function Bt(t){return!(!t._pulseIntensity||0>=t._pulseIntensity)}function Ft(t,e,n=.3){Bt(e)&&(t.globalAlpha=e._pulseIntensity*n,t.fillStyle=e._pulseColor||"rgba(255,255,255,0.6)",t.fillRect(e.x,e.y,e.w,e.h))}function Vt(t,e,n=.6){if(!Bt(e))return;const r=e.r+(e._pulseGlowRadius??4)*e._pulseIntensity,o=e.cx??e.x??0,a=e.cy??e.y??0;t.beginPath(),t.arc(o,a,r,0,2*Math.PI),t.strokeStyle=e._pulseColor||"rgba(255,255,255,0.6)",t.lineWidth=2*e._pulseIntensity,t.globalAlpha=e._pulseIntensity*n,t.stroke()}function Yt(t,e,n,r=.35){Bt(e)&&(t.globalAlpha=e._pulseIntensity*r,t.fillStyle=e._pulseColor||"rgba(255,255,255,0.6)",n?t.fill(n):t.fill())}export{It as computeDecayOpacity,kt as buildDatumIndexMap,_t as applyDecay,Mt as warnCustomLayoutDiagnostics,Ot as createCustomLayoutFailureDiagnostic,zt as attachUpdateResultStore,L as composeOverlays,$ as useConfigSync,N as useLayoutSelectionSync,Ht as hitTestRect,$t as getHitRadius,Wt as isTimeLandmark,Gt as normalizeAngle,Ut as findHitPointInQuadtree,U as resolveStaleness,V as useStalenessCheck,X as StalenessBadge,i as withProvenance,u as currentTimestamp,f as withCurrentProvenance,h as annotationFreshnessFor,y as computeAnnotationFreshness,b as applyAnnotationLifecycle,k as filterAnnotationsByStatus,_ as applyAnnotationStatus,q as useStableShallow,Ft as renderRectPulse,Vt as renderCirclePulse,Yt as renderPathPulse,et as glyphCanvasRenderer,nt as networkGlyphRenderer,st as paintSceneWithBackend,lt as renderSceneWithBackend,D as accessorName,O as formatVal,P as bandTooltipFields,j as buildDefaultTooltip,C as buildOrdinalTooltip,ct as buildNavGraph,it as resolvePosition,ut as nextGraphIndex,dt as extractXYNavPoints,pt as extractOrdinalNavPoints,ht as extractNetworkNavPoints,yt as nextNetworkIndex,mt as extractGeoNavPoints,xt as nextIndex,bt as navPointToHover,vt as buildBaseMetadataProps,wt as buildCustomBehaviorProps,At as buildTooltipProps};

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

@@ -0,0 +1 @@
+import{commonJsWorkerModuleUrl as e}from"./chunk-chunk-SV4XAZ3Q.module.min.js";import{resolveNodeSizeFn as r}from"./chunk-chunk-C4YA6TDR.module.min.js";function t(e,r,t,o,n=4e4){return"sync"!==e&&("worker"===e||o*(r+t)>=n)}function o(){return"undefined"!=typeof window&&"undefined"!=typeof Worker}function n(e,t,o,n,i){const s=r(o.nodeSize,o.nodeSizeRange,e);return{kind:"frame",nodes:e.map(e=>{const r=i?.get(e.id);return{id:e.id,x:0!==e.x||0!==e.y?e.x:r?.x??0,y:0!==e.x||0!==e.y?e.y:r?.y??0,x0:0,x1:0,y0:0,y1:0,width:0,height:0,value:e.value,__forceRadius:s(e)}}),edges:t.map(e=>{const r="string"==typeof e.source?e.source:e.source.id,t="string"==typeof e.target?e.target:e.target.id,o=e.data?.weight,n="number"==typeof o&&Number.isFinite(o)?o:e.value;return{source:r,target:t,value:e.value,y0:0,y1:0,sankeyWidth:0,weight:n}}),config:{chartType:"force",iterations:o.iterations,forceStrength:o.forceStrength,seed:o.seed},size:n}}function i(){if("undefined"!=typeof DOMException)return new DOMException("Force layout aborted","AbortError");const e=Error("Force layout aborted");return e.name="AbortError",e}var s=class{constructor(r=function(){const r="string"==typeof import.meta.url&&import.meta.url?new URL("./forceLayoutWorker.js",import.meta.url):e("forceLayoutWorker.js");return new Worker(r,{type:"module",name:"semiotic-force-layout"})}()){this.nextRequestId=1,this.pending=new Map,this.dead=!1,this.worker=r,this.worker.onmessage=e=>{const r=e.data,t=r.requestId,o=null!=t?this.pending.get(t):this.pending.values().next().value;if(o){if(null!=t?this.pending.delete(t):this.pending.clear(),o.cleanup(),r.error){const e=Error(r.error.message);return e.name=r.error.name??"Error",r.error.stack&&(e.stack=r.error.stack),void o.reject(e)}o.resolve({positions:r.positions??{}})}},this.worker.onerror=e=>{this.rejectAll(Error(e.message||"Force layout worker failed")),this.terminate()}}get isDead(){return this.dead}request(e,r){if(this.dead)return Promise.reject(Error("Force layout worker session is closed"));if(r?.aborted)return Promise.reject(i());const t=this.nextRequestId;this.nextRequestId+=1;const o={requestId:t,request:e};return new Promise((e,n)=>{const s=()=>{this.pending.delete(t),r?.removeEventListener("abort",s),n(i())},a=()=>r?.removeEventListener("abort",s);this.pending.set(t,{cleanup:a,reject:n,resolve:e}),r?.addEventListener("abort",s,{once:!0});try{this.worker.postMessage(o)}catch(e){this.pending.delete(t),a(),n(e instanceof Error?e:Error(e+""))}})}terminate(){this.dead||(this.dead=!0,this.rejectAll(Error("Force layout worker terminated")),this.worker.terminate())}rejectAll(e){for(const r of this.pending.values())r.cleanup(),r.reject(e);this.pending.clear()}},a=null;function u(e,r){return o()?r?.aborted?Promise.reject(i()):(a&&!a.isDead||(a=new s),a).request(e,r):Promise.reject(Error("Web Workers are unavailable"))}export{t as shouldUseForceWorker,o as canUseForceWorker,n as createFrameForceWorkerRequest,u as runForceLayoutWorker};

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

@@ -0,0 +1,2 @@
+"use client";
+var t=/^\d{4}-\d{1,2}$/;function e(e){const n=e.trim();if(!n||!Number.isNaN(Number(n)))return NaN;const r=t.test(n)?n+"-01":n;if(r===n&&10>n.length)return NaN;const i=Date.parse(r);return Number.isFinite(i)?i:NaN}function n(t){return t instanceof Date?t.getTime():"string"==typeof t?e(t):+t}export{e as parseDateLikeString,n as coerceDateLikeValue};

package/dist/chunk-minimapBrushOverlay-JU57U7NM.module.min.js

@@ -0,0 +1,2 @@
+"use client";
+import{useRef as t,useEffect as r}from"react";import{brushX as e,brushY as n}from"d3-brush";import{select as o}from"d3-selection";import{jsx as l}from"react/jsx-runtime";function u({width:u,height:s,margin:c,scales:i,brushDirection:f,extent:a,onBrush:h}){const m=t(null),p=t(null),b=t(!1),x=u+c.left+c.right,d=s+c.top+c.bottom;return r(()=>{if(!m.current||!i)return;const t=o(m.current).select(".brush-group"),r="x"===f?e().extent([[0,0],[u,s]]):n().extent([[0,0],[u,s]]);return r.on("brush end",t=>{if(b.current)return;if(!t.sourceEvent)return;const r=t.selection;if(!r)return void h(null);const e=("x"===f?i.x:i.y).invert;if(!e)return;const n=[e(r[0]),e(r[1])];h(n)}),t.call(r),p.current=e=>{t.call(r.move,e)},t.select(".selection").attr("fill","steelblue").attr("fill-opacity",.2).attr("stroke","steelblue").attr("stroke-width",1),()=>{p.current=null,r.on("brush end",null)}},[i,u,s,f,h]),r(()=>{if(!p.current||!i||!m.current)return;const t="x"===f?i.x:i.y;if(b.current=!0,a){const r=[t(a[0]),t(a[1])];p.current(r)}else p.current(null);b.current=!1},[a,i,f]),l("svg",{ref:m,width:x,height:d,style:{position:"absolute",top:0,left:0,pointerEvents:"all"},children:l("g",{className:"brush-group",transform:`translate(${c.left},${c.top})`})})}export{u as MinimapBrushOverlay};

package/dist/chunk-scatterplotMatrixBrushOverlay-SDIZSN66.module.min.js

@@ -0,0 +1,2 @@
+"use client";
+import{useRef as t,useEffect as e}from"react";import{brush as r}from"d3-brush";import{select as n}from"d3-selection";import{jsx as s}from"react/jsx-runtime";function l({frameRef:l,cellSize:o,onBrush:i}){const c=t(null),u=o-4-4,a=o-4-4;return e(()=>{if(!c.current)return;const t=n(c.current).select(".brush-g"),e=r().extent([[0,0],[u,a]]).on("brush end",t=>{const e=l.current?.getScales();if(!e)return;if(!(r=t.selection)||!Array.isArray(r[0]))return void i(null);var r;const[[n,s],[o,c]]=t.selection,u=[[e.x.invert(n),e.y.invert(s)],[e.x.invert(o),e.y.invert(c)]];i(u)});return t.call(e),t.select(".selection").attr("fill","steelblue").attr("fill-opacity",.15).attr("stroke","steelblue").attr("stroke-width",1),()=>{e.on("brush end",null)}},[u,a,l,i]),s("svg",{ref:c,width:o,height:o,style:{position:"absolute",top:0,left:0},children:s("g",{className:"brush-g",transform:"translate(4,4)"})})}export{l as ScatterplotMatrixBrushOverlay};

package/dist/chunk-statisticalOverlays-QGDLRUHX.module.min.js

@@ -0,0 +1 @@
+import{FORECAST_OPACITY_FIELD as m,SEGMENT_FIELD as n,buildAnomalyAnnotations as o,buildForecast as u,createSegmentLineStyle as c,stampForecastOpacity as h}from"./chunk-chunk-C57LR3YG.module.min.js";import{darkenColor as i,lightenColor as k}from"./chunk-chunk-2JGJ5GUG.module.min.js";import"./chunk-chunk-JJ2OOIET.module.min.js";export{m as FORECAST_OPACITY_FIELD,n as SEGMENT_FIELD,o as buildAnomalyAnnotations,u as buildForecast,c as createSegmentLineStyle,i as darkenColor,k as lightenColor,h as stampForecastOpacity};

package/dist/chunk-statisticalOverlays-T77OKLDY.module.min.js

@@ -0,0 +1 @@
+import{FORECAST_OPACITY_FIELD as m,SEGMENT_FIELD as o,buildAnomalyAnnotations as n,buildForecast as r,createSegmentLineStyle as u,darkenColor as c,lightenColor as e,stampForecastOpacity as h}from"./chunk-chunk-AVBI6GDT.module.min.js";export{m as FORECAST_OPACITY_FIELD,o as SEGMENT_FIELD,n as buildAnomalyAnnotations,r as buildForecast,u as createSegmentLineStyle,c as darkenColor,e as lightenColor,h as stampForecastOpacity};

package/dist/components/ChartContainer.d.ts

@@ -4,6 +4,8 @@ import { type DescribeLevel } from "./ai/describeChart";
 import type { ChartMode, MobileInteractionProp } from "./charts/shared/types";
 import { type MobileStandardControlRequest, type MobileStandardControlsProps } from "./MobileStandardControls";
 import { type MobileVisualizationContract } from "./charts/shared/auditMobileVisualization";
+import type { ChartContainerDataAudit } from "./chartContainerDataAudit";
+export type { ChartContainerDataAudit, ChartContainerDataAuditOptions } from "./chartContainerDataAudit";
 export type ChartNotificationLevel = "info" | "success" | "warning" | "error" | "neutral";
 /**
  * One entry in a ChartContainer's notification stack — chart-level context
@@ -58,8 +60,8 @@ export interface ChartContainerMobileAuditOptions {
 }
 export type ChartContainerMobileAudit = boolean | "warn" | ChartContainerMobileAuditOptions;
 export interface ChartContainerProps {
-    /** Chart title */
-    title?: string;
+    /** Chart title (string or inline nodes — e.g. a secret debug hit-target) */
+    title?: React.ReactNode;
     /** Subtitle / description */
     subtitle?: string;
     /** Chart children (any Semiotic chart component) */
@@ -131,6 +133,14 @@ export interface ChartContainerProps {
      * so notifications that arrive while streaming are announced.
      */
     notifications?: ChartNotification[];
+    /**
+     * Run Semiotic's numeric input audit over `chartConfig.props` and merge its
+     * findings into the notification bell. Re-evaluates when the config/data
+     * identity changes. Ref-only push mutations are intentionally not observable
+     * here; audit a bounded stream snapshot and pass its notifications instead.
+     * Requires `chartConfig`.
+     */
+    dataAudit?: ChartContainerDataAudit;
     /**
      * Called when a notification's dismiss button is clicked. Dismissal state
      * is tracked internally (keyed by `notification.id`, falling back to array

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

@@ -45,6 +45,7 @@ import { CollisionSwarmChartCapability } from "../charts/physics/CollisionSwarmC
 import { PhysicalFlowChartCapability } from "../charts/physics/PhysicalFlowChart.capability";
 import { ProcessFlowChartCapability } from "../charts/physics/ProcessFlowChart.capability";
 import { GauntletChartCapability } from "../charts/physics/GauntletChart.capability";
+import { CrucibleChartCapability } from "../charts/physics/CrucibleChart.capability";
 /**
  * Register a capability for a chart (built-in or third-party). Re-registering by
  * component name replaces the previous descriptor — useful for overriding defaults.
@@ -59,4 +60,4 @@ export declare function unregisterChartCapability(component: string): void;
 export declare function getCapabilities(): ReadonlyArray<ChartCapability>;
 /** Look up a capability by component name. */
 export declare function getCapability(component: string): ChartCapability | undefined;
-export { LineChartCapability, AreaChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability, GaltonBoardChartCapability, EventDropChartCapability, PhysicsPileChartCapability, CollisionSwarmChartCapability, PhysicalFlowChartCapability, ProcessFlowChartCapability, GauntletChartCapability, };
+export { LineChartCapability, AreaChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability, GaltonBoardChartCapability, EventDropChartCapability, PhysicsPileChartCapability, CollisionSwarmChartCapability, PhysicalFlowChartCapability, ProcessFlowChartCapability, GauntletChartCapability, CrucibleChartCapability };

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

@@ -1,5 +1,7 @@
 import type { Datum } from "../charts/shared/datumTypes";
 import type { DataSummary } from "../data/DataSummarizer";
+import type { NumericContracts } from "../data/numericContracts";
+import type { NumericFieldProfile } from "../data/auditData";
 import type { IntentId } from "./intents";
 import type { ChartRecipe, ChartRecipeFrameFamily, MobileDesignDefinition } from "./chartRecipes";
 import type { ScaleFitFn, QualityFitFn, ScaleBand, CardinalityBand, EffectiveScale } from "./dataScaleProfile";
@@ -52,6 +54,12 @@ export interface FieldCandidate {
 export interface ChartDataProfile extends DataSummary {
     /** Original rows (read-only); used by capabilities to compute their own stats. */
     data: ReadonlyArray<Datum>;
+    /**
+     * Per-field numeric health, including invalid/missing counts and extrema.
+     * Unlike `fields`, categorical values assigned to a numeric role remain
+     * visible here as `nonNumericCount` rather than being silently discarded.
+     */
+    numericFields?: Readonly<Record<string, NumericFieldProfile>>;
     /** Candidate fields per role, sorted best-first. */
     candidates: {
         x: FieldCandidate[];
@@ -146,6 +154,11 @@ export interface ChartVariant {
     description?: string;
     /** Props to merge into the base chart props. */
     props: Record<string, unknown>;
+    /**
+     * When set, suggestions use this component instead of `capability.component`
+     * (e.g. PieChart's "donut" variant → DonutChart, which actually honors innerRadius).
+     */
+    component?: string;
     /** Style/role tags (used by consumers like vizmart for filtering). */
     tags?: ReadonlyArray<string>;
     /** Per-intent additive score deltas (e.g. {"trend": +1, "outlier-detection": -2}). */
@@ -178,6 +191,12 @@ export interface ChartCapability {
     importPath: ChartImportPath;
     /** Base rubric, before variant/profile adjustments. */
     rubric: ChartRubric;
+    /**
+     * JSON-safe Semiotic runtime declaration of the numeric assumptions this
+     * chart makes about accessor-bound data. Consumed by `auditData` and
+     * `diagnoseConfig`; not part of the library-neutral IDID v0.1 subset.
+     */
+    numericContracts?: NumericContracts;
     /**
      * Hard requirements gate. Return null if the chart can render this profile,
      * or a human-readable string explaining why not (e.g. "no numeric y candidate").

package/dist/components/chartContainerDataAudit.d.ts

@@ -0,0 +1,10 @@
+import type { ChartNotification } from "./ChartContainer";
+import type { ChartConfig } from "./export/chartConfig";
+import { type DataAuditNotificationOptions } from "./data/dataAuditPresentation";
+import type { AuditDataOptions } from "./data/auditData";
+export interface ChartContainerDataAuditOptions extends Pick<AuditDataOptions, "checkOutliers">, DataAuditNotificationOptions {
+}
+export type ChartContainerDataAudit = boolean | ChartContainerDataAuditOptions;
+type AuditableChartConfig = Pick<ChartConfig, "component" | "props">;
+export declare function buildChartDataAuditNotifications(chartConfig: AuditableChartConfig | undefined, dataAudit: ChartContainerDataAudit | undefined): ChartNotification[];
+export {};

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

@@ -51,6 +51,8 @@ export interface ChoroplethMapProps<TDatum extends Datum = Datum> extends BaseCh
     graticule?: boolean | import("../../stream/geoTypes").GraticuleConfig;
     /** Tooltip config */
     tooltip?: TooltipProp;
+    /** Enable hover interaction. Defaults by chart mode. */
+    enableHover?: boolean;
     /** Show legend @default true */
     showLegend?: boolean;
     /** Legend interaction mode */

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

@@ -45,10 +45,12 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
     styleRules?: StyleRule[];
     /** Color scheme @default "category10" */
     colorScheme?: string | string[] | Record<string, string>;
-    /** Point radius @default 5 */
+    /** Point radius. Defaults to 5, or 1.5 in sparkline mode. */
     pointRadius?: number;
     /** Tooltip */
     tooltip?: TooltipProp;
+    /** Enable hover interaction. Defaults by chart mode. */
+    enableHover?: boolean;
     /** Show legend */
     showLegend?: boolean;
     /** Legend position */
@@ -77,9 +79,16 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
     tileAttribution?: string;
     /** Max cached tiles @default 256 */
     tileCacheSize?: number;
-    /** Show concentric distance rings around center. true for auto intervals, number for ring count, or number[] for explicit cost values. @default true */
+    /**
+     * Cost reference marks.
+     * - Radial layout: concentric rings around center.
+     * - Strip (sparkline) layout: baseline tick marks on the cost axis.
+     * @default true (radial); true as axis ticks in sparkline
+     */
     showRings?: boolean | number | number[];
-    /** Ring style overrides */
+    /** Show numeric labels on distance rings. Defaults to false in context and sparkline modes. */
+    showRingLabels?: boolean;
+    /** Ring / strip-tick style overrides */
     ringStyle?: {
         stroke?: string;
         strokeWidth?: number;
@@ -87,10 +96,15 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
         labelColor?: string;
         labelSize?: number;
     };
-    /** Show north indicator arrow @default true */
+    /** Show north indicator arrow. Defaults to true, or false in sparkline mode. */
     showNorth?: boolean;
     /** Label for cost units shown on rings (e.g. "hrs", "km") */
     costLabel?: string;
+    /**
+     * Cartogram layout encoding. Defaults to `"strip"` (1D Langren cost axis)
+     * in sparkline mode and `"radial"` otherwise.
+     */
+    cartogramLayout?: "radial" | "strip";
     /** Annotations */
     annotations?: Datum[];
     /** Passthrough */
@@ -103,7 +117,10 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
  * proportional to `costAccessor` (commute time, fare, hops, etc.) rather
  * than great-circle distance. `strength` interpolates between the
  * geographic positions (0) and the fully-distorted cartogram (1).
- * Concentric rings show iso-cost contours by default.
+ * Concentric rings show iso-cost contours by default. In `mode="sparkline"`
+ * the chart collapses to a Langren-style 1D cost strip (origin at left,
+ * cost growing right) so dense estimates of the same distance stay legible
+ * without map chrome.
  *
  * @example
  * ```tsx
@@ -143,6 +160,19 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
  *   lineMode="fractional"
  * />
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Sparkline: Langren-style 1D cost strip (origin left, cost right)
+ * <DistanceCartogram
+ *   points={estimates}
+ *   center="Toledo"
+ *   costAccessor="degrees"
+ *   mode="sparkline"
+ *   width={160}
+ *   height={28}
+ * />
+ * ```
  */
 export declare const DistanceCartogram: {
     <TDatum extends Datum = Datum>(props: DistanceCartogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;

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

@@ -43,6 +43,8 @@ export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartPro
     edgeOpacity?: number;
     /** Min/max pixel width for proportional edge width @default [1, 8] */
     edgeWidthRange?: [number, number];
+    /** Node radius in pixels. Defaults to 5, or 1.5 in sparkline mode. */
+    pointRadius?: number;
     /** Line cap style for flow edges @default "round" */
     edgeLinecap?: "butt" | "round" | "square";
     /** Color scheme for edges @default "category10" */
@@ -53,6 +55,8 @@ export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartPro
     particleStyle?: GeoParticleStyle;
     /** Tooltip */
     tooltip?: TooltipProp;
+    /** Enable hover interaction. Defaults by chart mode. */
+    enableHover?: boolean;
     /** Show legend */
     showLegend?: boolean;
     /** Legend interaction mode */

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

@@ -17,7 +17,7 @@ export interface ProportionalSymbolMapProps<TDatum extends Datum = Datum> extend
     yAccessor?: ChartAccessor<TDatum, number>;
     /** Field to scale point size */
     sizeBy: ChartAccessor<TDatum, number>;
-    /** Min and max radius @default [3, 30] */
+    /** Min and max radius. Defaults to [3, 30], or [1, 4] in sparkline mode. */
     sizeRange?: [number, number];
     /** Field to determine point color */
     colorBy?: ChartAccessor<TDatum, string>;
@@ -39,6 +39,8 @@ export interface ProportionalSymbolMapProps<TDatum extends Datum = Datum> extend
     areaStyle?: Style;
     /** Tooltip config */
     tooltip?: TooltipProp;
+    /** Enable hover interaction. Defaults by chart mode. */
+    enableHover?: boolean;
     /** Show legend */
     showLegend?: boolean;
     /** Legend interaction mode */

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

@@ -104,6 +104,7 @@ export { PhysicsPileChart } from "./physics/PhysicsPileChart";
 export type { PhysicsPileChartProps } from "./physics/PhysicsPileChart";
 export { CollisionSwarmChart } from "./physics/CollisionSwarmChart";
 export type { CollisionSwarmChartProps } from "./physics/CollisionSwarmChart";
+export * from "./physics/CrucibleChart";
 export { GauntletChart, GuantletChart, planGauntletPropertyWork, replaceGauntletNegative } from "./physics/GauntletChart";
 export type { GauntletChartProps, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletNegativeReplacementOptions, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectState, GauntletPropertyForceContext, GauntletPropertyDefinition, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions } from "./physics/GauntletChart";
 export { physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems } from "./physics/physicsProcessPrimitives";

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

@@ -90,13 +90,48 @@ export interface ForceDirectedGraphProps<TNode extends Datum = Datum, TEdge exte
      * @default [5, 20]
      */
     nodeSizeRange?: [number, number];
+    /**
+     * Outline color for **node** marks only, leaving edges untouched — the
+     * node half of independent node/edge stroking (the edge half is
+     * {@link ForceDirectedGraphProps.edgeColor}). Overrides the generic
+     * {@link BaseChartProps.stroke} for nodes; pass `"none"` to remove the
+     * default node outline. Precedence per property: `nodeStroke` > `stroke`
+     * > the built-in node outline.
+     * @example
+     * ```tsx
+     * // Ringless nodes, blue edges — styled separately
+     * <ForceDirectedGraph nodeStroke="none" edgeColor="#4c78a8" />
+     * // White node ring, unchanged edges
+     * <ForceDirectedGraph nodeStroke="#fff" nodeStrokeWidth={1.5} />
+     * ```
+     */
+    nodeStroke?: string;
+    /**
+     * Outline width for **node** marks only. Overrides the generic
+     * {@link BaseChartProps.strokeWidth} for nodes.
+     * @default the generic `strokeWidth`
+     */
+    nodeStrokeWidth?: number;
     /**
      * Constant pixel width, or a function/field returning a numeric value
-     * scaled to a default width range.
+     * scaled to a default width range. The **edge** stroke width; overrides
+     * the generic `strokeWidth` for edges.
      * @default 1
      */
     edgeWidth?: number | ChartAccessor<TEdge, number>;
+    /**
+     * Stroke color for **edge** marks only, leaving nodes untouched — the edge
+     * half of independent node/edge stroking (the node half is
+     * {@link ForceDirectedGraphProps.nodeStroke}). Overrides the generic
+     * {@link BaseChartProps.stroke} for edges. Precedence per property:
+     * `edgeColor` > `stroke` > the built-in `#999`.
+     * @default "#999"
+     */
     edgeColor?: string;
+    /**
+     * Opacity for **edge** marks only. Overrides the generic `opacity` for edges.
+     * @default 0.6
+     */
     edgeOpacity?: number;
     /**
      * Number of force-simulation ticks before the layout settles.

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

@@ -3,7 +3,7 @@ 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";
+import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
 export interface CollisionSwarmChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin">, PhysicsSharedChartProps {
     data?: TDatum[];
     size?: [number, number];
@@ -22,6 +22,11 @@ export interface CollisionSwarmChartProps<TDatum extends Datum = Datum> extends
     xExtent?: [number, number];
     collisionIterations?: number;
     settle?: boolean;
+    /**
+     * Replay the seeded simulation this many milliseconds after it settles.
+     * Omit or pass `null` for a single run; `0` replays on the next timer turn.
+     */
+    rerunMS?: PhysicsRerunMS;
     showProjection?: boolean;
     tooltip?: TooltipProp;
     paused?: boolean;

package/dist/components/charts/physics/CrucibleChart.capability.d.ts

@@ -0,0 +1,8 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+/**
+ * CrucibleChart is intentionally known to the AI surface but never selected
+ * from a flat data profile. A valid chart needs an authored treatment program,
+ * declared products, and explicit destinations that dataset profiling cannot
+ * responsibly invent.
+ */
+export declare const CrucibleChartCapability: ChartCapability;

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

@@ -0,0 +1,63 @@
+import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
+import type { CrucibleChartHandle, CrucibleChartProps } from "./crucibleChartProps";
+export * from "./crucibleTypes";
+export * from "./crucibleProgram";
+export { applyCrucibleEvent, buildCrucibleEvidence, buildCrucibleProjection, cloneCrucibleState, crucibleProjectionRows, evaluateCrucibleConservation, resolveCrucibleSelector } from "./crucibleEffects";
+export { DEFAULT_CRUCIBLE_HEIGHT, DEFAULT_CRUCIBLE_OUTLETS, DEFAULT_CRUCIBLE_SIZE, DEFAULT_CRUCIBLE_WIDTH, buildCrucibleInitialSpawns, buildCrucibleLayout, buildCruciblePhysicsConfig, buildCrucibleStateSpawns, buildCrucibleTerminalSpawns, compileCruciblePlan, createInitialCrucibleState, crucibleBoundaryColliders, crucibleBondId, crucibleComponentBodyId, crucibleProductBodyId, crucibleSemanticKey, replayCruciblePlan, resolveCrucibleSnapshotAt, resolveCrucibleTime } from "./cruciblePhysics";
+export type { CrucibleSelectorResult } from "./crucibleEffects";
+export type { CrucibleInitialStateResult, CrucibleResolvedTime, CrucibleSpawnOptions } from "./cruciblePhysics";
+export type { CrucibleChartHandle, CrucibleChartProps, CrucibleColorBy, CrucibleControls, CrucibleSnapshotAt } from "./crucibleChartProps";
+/**
+ * A bounded, deterministic treatment tape for peer components. Authored
+ * events own every semantic transition; physics only explains co-presence,
+ * agitation, binding, separation, and settling.
+ *
+ * @example One authored event forms and completes a declared product.
+ * ```tsx
+ * <CrucibleChart
+ *   data={[{ id: "crm", amount: 1 }, { id: "billing", amount: 1 }]}
+ *   phases={[{ id: "resolve", duration: 2, motion: "bind" }]}
+ *   products={[{ id: "golden-record", outletId: "published" }]}
+ *   outlets={[{ id: "published", side: "bottom" }]}
+ *   events={[{
+ *     id: "publish-record",
+ *     at: { phaseId: "resolve", progress: 0.7 },
+ *     effects: [{
+ *       type: "combine",
+ *       sourceIds: ["crm", "billing"],
+ *       productId: "golden-record",
+ *       complete: true
+ *     }]
+ *   }]}
+ *   idAccessor="id"
+ *   amountAccessor="amount"
+ * />
+ * ```
+ *
+ * @example Build an explicit lifecycle and replay it without remount state.
+ * ```tsx
+ * const chartRef = React.createRef<CrucibleChartHandle>()
+ * const events = buildCrucibleProductEvents({
+ *   productId: "finding",
+ *   form: { at: { time: 0.5 }, sourceIds: ["trace", "metric"] },
+ *   contributions: [{ at: { time: 1 }, sourceIds: ["experiment"] }],
+ *   complete: { at: { time: 1.5 }, outletId: "supported" }
+ * })
+ *
+ * <button onClick={() => chartRef.current?.replay()}>Replay</button>
+ * <CrucibleChart
+ *   ref={chartRef}
+ *   data={evidence}
+ *   phases={[{ id: "assay", duration: 2, motion: "mix" }]}
+ *   products={[{ id: "finding", outletId: "supported" }]}
+ *   outlets={[{ id: "supported", side: "bottom" }]}
+ *   events={events}
+ * />
+ * ```
+ */
+export declare const CrucibleChart: {
+    <TDatum extends Datum = Datum>(props: CrucibleChartProps<TDatum> & React.RefAttributes<CrucibleChartHandle<TDatum>>): React.ReactElement | null;
+    displayName?: string;
+};
+export default CrucibleChart;

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

@@ -3,7 +3,7 @@ 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 PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type PhysicsSimulationMode, type TooltipProp } from "./physicsHocUtils";
 import type { ChartMode } from "../shared/types";
 export interface GaltonBoardReferenceLine {
     value: number;
@@ -42,6 +42,11 @@ export interface GaltonBoardChartProps<TDatum extends Datum = Datum> extends Omi
     styleRules?: StyleRule[];
     referenceLines?: GaltonBoardReferenceLine | GaltonBoardReferenceLine[];
     seed?: number;
+    /**
+     * Replay the seeded simulation this many milliseconds after it settles.
+     * Omit or pass `null` for a single run; `0` replays on the next timer turn.
+     */
+    rerunMS?: PhysicsRerunMS;
     showProjection?: boolean;
     tooltip?: TooltipProp;
     paused?: boolean;

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

@@ -0,0 +1,27 @@
+import * as React from "react";
+import type { Style } from "../../stream/types";
+import type { PhysicsBodyState } from "../../stream/physics/PhysicsKernel";
+import type { PhysicsSemanticItem } from "../../stream/physics/StreamPhysicsFrame";
+import type { Datum } from "../shared/datumTypes";
+import type { CrucibleComponentState, CrucibleProductState, CrucibleRunState } from "./crucibleTypes";
+export declare function displayNumber(value: number): string;
+export declare function componentDescription(component: CrucibleComponentState): string;
+export declare function productDescription(product: CrucibleProductState): string;
+/** Default accessible description for each live crucible body. */
+export declare function crucibleBodySemanticItem<TDatum extends Datum>(body: PhysicsBodyState, state: CrucibleRunState<TDatum>): false | Partial<PhysicsSemanticItem>;
+/** Canvas mark used when callers do not supply frameProps.renderBody. */
+export declare function drawCrucibleBody(ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style): void;
+/**
+ * SSR sibling of `drawCrucibleBody` — the same shadowed hexagon + inner ring
+ * for settled products, and highlight dot for source components, as an SVG
+ * fragment instead of canvas draw calls. Returns `undefined` for non-crucible
+ * bodies so the SVG renderer falls back to its default circle mark.
+ *
+ * `idPrefix` is the sanitized prefix the owning `PhysicsSettledSVG` document
+ * uses for its own ids — folded into this body's `<filter>` id so multiple
+ * settled Crucible SVGs on one page (SVG ids are document-global) can't
+ * collide and mis-apply each other's glow filter.
+ */
+export declare function drawCrucibleBodySVG(body: PhysicsBodyState, style: Style, index: number, idPrefix?: string): React.ReactNode | undefined;
+/** Draw supplied relations and committed source-to-product lineage. */
+export declare function drawCrucibleBonds<TDatum extends Datum>(ctx: CanvasRenderingContext2D, bodies: readonly PhysicsBodyState[], state: CrucibleRunState<TDatum>): void;