@syidax/advanced 0.0.0-stage → 1.0.1

package/dist/collection/components/chart/word-cloud-chart/sy-word-cloud.js

@@ -0,0 +1 @@
+import{safeChartFormatter}from"../_shared/core/format/safe-formatter.js";import{h,Host}from"@stencil/core";import{wordAtPoint}from"./core/word-layout.js";import{resolveWordCloudDatum}from"./core/types.js";import{pickWordCloudEngine}from"./core/word-cloud-core.js";import{createCanvasWordMeasure}from"./core/word-measure.js";import{applyEasing}from"../pie-chart/core/pie-animator.js";import{createWordCloudStreamSource}from"./core/word-stream-source.js";import{ChartStreamingGate,chartStreamingInput,standardOnlyEngineStatus}from"../pie-chart/license/chart-streaming-gate.js";import{wordCloudTooltipSpecFromLegacy,resolveWordCloudTooltipSpec}from"./core/word-tooltip.js";import{prepareWordCloudLayout}from"./engines/standard/index.js";import{categorical,discretize}from"../_shared/core/color/index.js";import{computeTooltipPlacement,tooltipConnectorEnd}from"../_shared/core/tooltip/index.js";import{buildChartPointContextMenuDetail}from"../_shared/core/event/index.js";import{fromViewport,resolveCartesianZoomSpec,toViewport,viewportZoomFrame,viewportZoomMatrix,viewportZoomTransform,ZoomInteraction}from"../_shared/core/zoom/index.js";import{renderChartBrand}from"../_shared/core/brand/chart-brand.js";function wordTooltipClassName(base,extra){return extra?`${base} ${extra}`:base}function wordTooltipCssValue(property,value){if(typeof value!=="number")return value;const unitless=new Set(["lineHeight","opacity","zIndex","fontWeight","flex","flexGrow","flexShrink","order"]);return unitless.has(property)?String(value):`${value}px`}function escapeHtml(s){return s.replace(/[&<>"']/g,ch=>{switch(ch){case"&":return"&amp;";case"<":return"&lt;";case">":return"&gt;";case'"':return"&quot;";case"'":return"&#39;";default:return ch}})}function insideRect(rect,x,y){return x>=rect.x&&x<=rect.x+rect.width&&y>=rect.y&&y<=rect.y+rect.height}let wordCloudInstanceCounter=0;export class SyWordCloud{host;values=[];width=520;height=400;brandLogo;brandPosition="bottom-right";palette="tableau10";colors;minFontSize=10;maxFontSize=44;weightScale="linear";spiral="rectangular";orientations=2;rotationFrom=0;rotationTo=90;wordPadding=2;fontFamily="system-ui, sans-serif";fontWeight="600";chartTitle;chartSubtitle;tooltipShow=true;tooltipFormat;tooltip;enableMouseTracking=true;zoom;engine="auto";unavailable="fallback";streamSource;streamWindow;streamMax;animated=false;animationDuration=600;animationEasing="ease-out";animationType;rendered;pointClick;pointHover;pointContextMenu;appended;windowSlid;chartAnimationStart;chartAnimationEnd;chartAnimationInterrupted;tooltipShown;tooltipHide;tooltipAction;zoomChange;activeTier="standard";fallbackReason;wordTooltip=null;wordTooltips=[];displayValues=[];hoverWordIndex=null;focusedWordIndex=null;srAnnouncement="";animationTick=0;zoomState=null;zoomSelection=null;initialRevealState;morphState;animationFrameHandle=null;stopAnimationLoopImpl;suppressNextValuesAnimation=false;internalStreamSource;internalStreamCapacity;boundStreamSource;streamUnsubscribe;streamLicense=new ChartStreamingGate({host:()=>this.host,input:()=>chartStreamingInput(this,"plain-fallback"),active:()=>this.boundStreamSource!==void 0,onChange:()=>this.handleStreamLicenseChange()});internalStreamValues;lastRenderResult={words:0,dropped:0,renderMs:0};pendingRenderedEmit=false;tooltipDrag;tooltipElement;nextTooltipId=1;draggableTooltipPositions=new Map;pointerFocusing=false;layoutCache;wordMeasure;wordMeasureFont;instanceKey=++wordCloudInstanceCounter;zoomInteraction=new ZoomInteraction(this.zoomInteractionHost());componentWillLoad(){this.displayValues=this.values}hasLoaded=false;detached=false;connectedCallback(){this.detached=false;this.streamLicense.connect();if(!this.hasLoaded)return;this.host.addEventListener("wheel",this.handleZoomWheel,{passive:false});this.bindStreamSource()}componentDidLoad(){this.hasLoaded=true;this.bindStreamSource();this.host.addEventListener("wheel",this.handleZoomWheel,{passive:false});if(this.shouldRunInitialAnimation(null))this.startInitialReveal()}componentDidRender(){if(this.detached)return;if(this.pendingRenderedEmit){this.pendingRenderedEmit=false;this.rendered.emit({...this.lastRenderResult,tier:this.activeTier})}this.measureWordTooltipBox()}disconnectedCallback(){this.detached=true;this.streamLicense.disconnect();this.streamUnsubscribe?.();this.streamUnsubscribe=void 0;this.boundStreamSource=void 0;this.cancelInitialReveal(false);this.cancelMorph(false);this.stopAnimationLoop();this.tooltipDrag=void 0;this.host.removeEventListener("wheel",this.handleZoomWheel);this.zoomInteraction.dispose();this.zoomSelection=null}handleValuesChange(next,previous){if(this.suppressNextValuesAnimation){this.suppressNextValuesAnimation=false;if(!this.morphState)this.displayValues=next;return}this.routeValuesAnimation(previous??[],next)}handleStreamSourceChange(){this.bindStreamSource()}handleAnimationChange(){this.cancelMorph(true);this.cancelInitialReveal(true);if(this.shouldRunInitialAnimation(null))this.startInitialReveal()}handleVisualPropsChange(){this.animationTick++}async redraw(){const start=this.now();this.layoutCache=void 0;const base=this.settledRenderLayout();const result={words:base.placed.length,dropped:base.dropped.length,renderMs:this.now()-start};this.lastRenderResult=result;this.animationTick++;return result}async getActiveTier(){return this.activeTier}async addWord(datum,opts){const next=Array.isArray(this.values)?[...this.values]:[];const at=typeof opts?.insertAt==="number"&&opts.insertAt>=0&&opts.insertAt<=next.length?Math.floor(opts.insertAt):next.length;next.splice(at,0,datum);this.values=next;return at}async removeWord(idOrIndex){if(!Array.isArray(this.values))return false;const idx=this.resolveWordIndex(idOrIndex);if(idx<0)return false;const next=[...this.values];next.splice(idx,1);this.values=next;return true}async updateWord(idOrIndex,patch){if(!Array.isArray(this.values))return false;const idx=this.resolveWordIndex(idOrIndex);if(idx<0)return false;const next=[...this.values];const current=next[idx];if(Array.isArray(current)){next[idx]={name:current[0],weight:current[1],...patch}}else{next[idx]={...current,...patch}}this.values=next;return true}async setWordWeight(idOrIndex,weight){return this.updateWord(idOrIndex,{weight})}async appendPoint(datum){await this.streamLicense.run("appendPoint",()=>{const source=this.activeStreamSource();if(source){source.push(datum);return}this.mergeIntoValues([datum]);this.appended.emit({count:1})})}async appendBatch(datums){if(!Array.isArray(datums)||datums.length===0)return;await this.streamLicense.run("appendBatch",()=>{const source=this.activeStreamSource();if(source){source.pushBatch(datums);return}this.mergeIntoValues(datums);this.appended.emit({count:datums.length})})}async shift(count=1){await this.streamLicense.run("shift",()=>{const source=this.activeStreamSource();if(source){source.shift(count);return}if(!Array.isArray(this.values))return;const n=Math.max(0,Math.min(Math.floor(count),this.values.length));if(n===0)return;const next=[...this.values];for(let i=0;i<n;i+=1){let lightest=0;for(let j=1;j<next.length;j+=1){if(resolveWordCloudDatum(next[j],j).weight<resolveWordCloudDatum(next[lightest],lightest).weight)lightest=j}next.splice(lightest,1)}this.values=next;this.windowSlid.emit({dropped:n})})}async replace(datums){await this.streamLicense.run("replace",()=>{const source=this.activeStreamSource();if(source){source.replace(datums);return}this.values=Array.isArray(datums)?[...datums]:[]})}async getStreamSource(){return this.streamLicense.run("getStreamSource",()=>this.activeStreamSource())}async setAnimation(options){if(!options)return;if(Number.isFinite(options.duration))this.animationDuration=options.duration;if(options.easing)this.animationEasing=options.easing;if(options.type)this.animationType=options.type;if(typeof options.enabled==="boolean"){if(!options.enabled&&(this.initialRevealState||this.morphState))this.chartAnimationInterrupted.emit();this.animated=options.enabled;if(!options.enabled){this.cancelMorph(false);this.cancelInitialReveal(false);this.stopAnimationLoop();this.animationTick++}}}async pauseAnimation(){const now=this.now();for(const st of[this.initialRevealState,this.morphState]){if(st&&!st.paused){st.pausedElapsed=now-st.startedAt;st.paused=true}}this.stopAnimationLoop()}async resumeAnimation(){const now=this.now();for(const st of[this.initialRevealState,this.morphState]){if(st&&st.paused){st.startedAt=now-st.pausedElapsed;st.paused=false}}if(this.initialRevealState||this.morphState)this.startAnimationLoop()}async replayAnimation(){if(!this.animated)return;this.cancelMorph(false);this.cancelInitialReveal(false);this.startInitialReveal()}async hitTestWord(cssX,cssY){const base=this.settledRenderLayout();const placed=this.wordUnderPointer(base,cssX,cssY);if(!placed)return null;return{index:placed.word.index,id:placed.word.id,name:placed.word.name}}async getDroppedWords(){const base=this.settledRenderLayout();return base.dropped.map(entry=>({index:entry.word.index,id:entry.word.id,name:entry.word.name,weight:entry.word.weight}))}async showTooltipAtWord(idOrIndex){const idx=this.resolveWordIndex(idOrIndex);const base=this.settledRenderLayout();const placed=base.placed.find(entry=>entry.word.index===idx);if(!placed)return null;const spec=this.effectiveTooltipSpec();if(!spec.show)return null;this.showTooltipForWord(placed.word,{x:placed.x,y:placed.y},spec,spec.openMode==="multiple",placed);return this.buildPointEventDetail(placed.word,base)}async hideTooltip(){this.clearTooltips()}async zoomTo(request){return this.zoomInteraction.zoomTo(request)}async zoomBy(factor,anchorFraction=.5){return this.zoomInteraction.zoomBy(factor,anchorFraction)}async panBy(delta){return this.zoomInteraction.panBy(delta)}async resetZoom(){return this.zoomInteraction.reset()}async getZoom(){return this.zoomState}async getZoomExtent(request){return this.zoomInteraction.extent(request)}zoomSpec(){return resolveCartesianZoomSpec(this.zoom)}zoomRect(){return this.plotRect()}viewportTransform(){return viewportZoomTransform(this.zoomRect(),this.zoomState)}shownPoint(x,y){return toViewport(this.viewportTransform(),x,y)}contentPointAt(x,y){const t=this.viewportTransform();if(!t.zoomed)return{x,y};if(!insideRect(this.zoomRect(),x,y))return null;return fromViewport(t,x,y)}wordUnderPointer(base,hostX,hostY){const content=this.contentPointAt(hostX,hostY);return content?wordAtPoint(base.placed,content.x,content.y):null}zoomInteractionHost(){return{frame:()=>viewportZoomFrame(this.zoomRect(),this.zoomState),spec:()=>this.zoomSpec(),state:()=>this.zoomState,apply:next=>{this.zoomState=next;this.reanchorTooltipsForZoom()},emit:detail=>{this.zoomChange.emit(detail)},selection:rect=>{this.zoomSelection=rect},standDown:()=>this.zoomStandDown()}}zoomStandDown(){this.clearHover()}reanchorTooltipsForZoom(){if(!this.hasVisibleTooltips())return;const t=this.viewportTransform();const rect=this.zoomRect();const follow=tooltip=>{const shown=toViewport(t,tooltip.anchorX,tooltip.anchorY);if(t.zoomed&&!insideRect(rect,shown.x,shown.y))return null;const context={...tooltip.context,cssX:shown.x,cssY:shown.y};if(tooltip.positionLock)return{...tooltip,pointCssX:shown.x,pointCssY:shown.y,context};return{...tooltip,cssX:shown.x,cssY:shown.y,pointCssX:shown.x,pointCssY:shown.y,context}};this.wordTooltip=this.wordTooltip?follow(this.wordTooltip):null;this.wordTooltips=this.wordTooltips.map(follow).filter(tooltip=>tooltip!==null);if(!this.hasVisibleTooltips()){this.tooltipDrag=void 0;this.tooltipHide.emit()}}zoomPointerInput(e){const point=this.pointerCss(e);return{pointerId:e.pointerId,x:point.x,y:point.y,button:e.button,shiftKey:e.shiftKey,altKey:e.altKey,pointerType:e.pointerType}}zoomWheelInput(e){const point=this.pointerCss(e);return{x:point.x,y:point.y,deltaX:e.deltaX,deltaY:e.deltaY,deltaMode:e.deltaMode,ctrlKey:e.ctrlKey,metaKey:e.metaKey,shiftKey:e.shiftKey}}handleZoomWheel=e=>{if(this.zoomInteraction.wheel(this.zoomWheelInput(e)))e.preventDefault()};handleZoomPointerDown=e=>{if(this.zoomInteraction.pointerDown(this.zoomPointerInput(e)))e.currentTarget?.setPointerCapture?.(e.pointerId)};handleZoomPointerMove(e){return this.zoomInteraction.pointerMove(this.zoomPointerInput(e))}handleZoomPointerUp=e=>{const owned=this.zoomInteraction.isPending;this.zoomInteraction.pointerUp(this.zoomPointerInput(e));if(owned)e.currentTarget?.releasePointerCapture?.(e.pointerId)};handleZoomPointerCancel=()=>{this.zoomInteraction.pointerCancel()};consumeSuppressedPlotClick(){return this.zoomInteraction.consumeSuppressedClick()}handleZoomKeyDown(event){if(!this.zoomInteraction.wantsKey(event))return false;if(!this.zoomInteraction.keyDown(event))return false;event.preventDefault();event.stopPropagation();return true}renderZoomOverlay(){const spec=this.zoomSpec();const selection=this.zoomSelection;const zoomed=this.zoomState!==null;if(!selection&&!(zoomed&&spec.resetButton))return null;const rect=this.zoomRect();return h("div",{class:"sy-word-cloud__zoom-overlay",style:{position:"absolute",left:"0",top:"0",width:`${this.width}px`,height:`${this.height}px`,pointerEvents:"none",zIndex:"6"}},selection&&h("div",{class:"sy-word-cloud__zoom-selection","aria-hidden":"true",style:{position:"absolute",left:`${selection.x}px`,top:`${selection.y}px`,width:`${selection.width}px`,height:`${selection.height}px`,boxSizing:"border-box",background:"var(--sy-zoom-selection-bg, rgba(37, 99, 235, 0.12))",border:"1px solid var(--sy-zoom-selection-border, rgba(37, 99, 235, 0.6))"}}),zoomed&&spec.resetButton&&h("button",{type:"button",class:"sy-word-cloud__zoom-reset","aria-label":"Reset zoom",onClick:()=>{void this.resetZoom()},style:{...ZoomInteraction.resetButtonStyle,position:"absolute",left:`${rect.x+rect.width-8}px`,top:`${rect.y+8}px`,transform:"translateX(-100%)",pointerEvents:"auto",font:"500 11px system-ui, sans-serif",padding:"3px 8px",borderRadius:"4px",border:"1px solid var(--sy-zoom-reset-border, #9ca3af)",background:"var(--sy-zoom-reset-bg, #ffffff)",color:"var(--sy-axis-color, #111827)",cursor:"pointer"}},"Reset zoom"))}resolveWordIndex(idOrIndex){if(typeof idOrIndex==="number"&&Number.isFinite(idOrIndex)){const idx=Math.floor(idOrIndex);if(Array.isArray(this.values))return idx>=0&&idx<this.values.length?idx:-1;return-1}if(!Array.isArray(this.values))return-1;for(let i=0;i<this.values.length;i++){const resolved=resolveWordCloudDatum(this.values[i],i);if(resolved.id===idOrIndex||resolved.name===idOrIndex)return i}return-1}mergeIntoValues(datums){const next=Array.isArray(this.values)?[...this.values]:[];for(const datum of datums){const incoming=resolveWordCloudDatum(datum,next.length);const idx=next.findIndex((entry,i)=>resolveWordCloudDatum(entry,i).name===incoming.name);if(idx<0){next.push(datum);continue}const current=resolveWordCloudDatum(next[idx],idx);next[idx]={name:current.name,weight:current.weight+incoming.weight,...incoming.color!==void 0||current.color!==void 0?{color:incoming.color??current.color}:{},...incoming.rotation!==void 0||current.rotation!==void 0?{rotation:incoming.rotation??current.rotation}:{},...current.id!==current.name?{id:current.id}:{}}}this.values=next}activeStreamSource(){const route=this.streamLicense.route();if(route==="plain")this.dropInternalStreamSource();if(route!=="stream")return void 0;if(this.streamSource)return this.streamSource;return this.ensureInternalStreamSource()}ensureInternalStreamSource(){if(!Number.isFinite(this.streamMax)){this.dropInternalStreamSource();return void 0}const capacity=Math.max(1,Math.floor(this.streamMax));if(this.internalStreamSource&&this.internalStreamCapacity===capacity)return this.internalStreamSource;this.internalStreamCapacity=capacity;this.internalStreamSource=createWordCloudStreamSource({capacity,initial:Array.isArray(this.values)?this.values:[]});this.internalStreamValues=this.values;return this.internalStreamSource}dropInternalStreamSource(){this.internalStreamSource=void 0;this.internalStreamCapacity=void 0;this.internalStreamValues=void 0}bindStreamSource(){if(this.detached)return;const route=this.streamLicense.route();if(route==="plain")this.dropInternalStreamSource();let source=route==="stream"?this.streamSource??this.ensureInternalStreamSource():void 0;if(source===this.boundStreamSource)return;if(source!==void 0&&source===this.internalStreamSource&&this.values!==this.internalStreamValues){this.dropInternalStreamSource();source=this.ensureInternalStreamSource()}this.streamUnsubscribe?.();this.streamUnsubscribe=void 0;this.boundStreamSource=void 0;if(!source)return;this.boundStreamSource=source;this.streamUnsubscribe=source.subscribe(event=>this.handleStreamEvent(event));this.syncFromStreamSource()}syncFromStreamSource(){if(!this.boundStreamSource)return;const snapshot=this.boundStreamSource.snapshot(this.streamWindow);this.suppressNextValuesAnimation=true;this.values=snapshot;this.noteStreamValues();this.displayValues=snapshot}handleStreamLicenseChange(){this.bindStreamSource()}noteStreamValues(){if(this.boundStreamSource!==void 0&&this.boundStreamSource===this.internalStreamSource)this.internalStreamValues=this.values}handleStreamEvent(event){if(!this.boundStreamSource)return;const snapshot=this.boundStreamSource.snapshot(this.streamWindow);const prevVisuals=this.currentWordVisuals();const prevValues=this.displayValues;this.suppressNextValuesAnimation=true;this.values=snapshot;this.noteStreamValues();if(event.type==="push"||event.type==="pushBatch")this.appended.emit({count:event.count});else if(event.type==="shift")this.windowSlid.emit({dropped:event.count});if(this.shouldRunInitialAnimation(prevValues)){this.cancelMorph(false);this.displayValues=snapshot;this.startInitialReveal();this.animationTick++;return}if(!this.shouldAnimateUpdates(prevValues)){this.cancelMorph(false);this.displayValues=snapshot;this.animationTick++;return}if(this.sameWordValues(prevValues,snapshot)){this.displayValues=snapshot;this.animationTick++;return}this.displayValues=snapshot;this.startWordMorph(prevVisuals)}sameWordValues(a,b){const aa=Array.isArray(a)?a:[];const bb=Array.isArray(b)?b:[];if(aa.length!==bb.length)return false;for(let i=0;i<aa.length;i++){const ra=resolveWordCloudDatum(aa[i],i);const rb=resolveWordCloudDatum(bb[i],i);if(ra.id!==rb.id||ra.weight!==rb.weight)return false}return true}shouldAnimateUpdates(previous){return this.animated&&this.resolveAnimationType(previous)==="update"}shouldRunInitialAnimation(previous){return this.animated&&this.resolveAnimationType(previous)==="initial"}resolveAnimationType(previous){if(this.animationType)return this.animationType;return Array.isArray(previous)&&previous.length>0?"update":"initial"}routeValuesAnimation(prev,next){const prevVisuals=this.currentWordVisuals();this.displayValues=next;if(this.shouldRunInitialAnimation(prev)){this.cancelMorph(true);this.startInitialReveal()}else if(this.shouldAnimateUpdates(prev)&&!this.sameWordValues(prev,next)){this.startWordMorph(prevVisuals)}else{this.animationTick++}}startInitialReveal(){this.cancelInitialReveal(false);const duration=Math.max(0,this.animationDuration);if(duration<=0)return;this.initialRevealState={startedAt:this.now(),duration,paused:false,pausedElapsed:0};this.chartAnimationStart.emit();this.startAnimationLoop()}cancelInitialReveal(emitInterrupt){if(!this.initialRevealState)return;if(emitInterrupt)this.chartAnimationInterrupted.emit();this.initialRevealState=void 0}startWordMorph(prevVisuals){this.cancelMorph(true);const duration=Math.max(0,this.animationDuration);if(duration<=0){this.animationTick++;return}this.morphState={prevVisuals,startedAt:this.now(),duration,paused:false,pausedElapsed:0};this.chartAnimationStart.emit();this.startAnimationLoop()}cancelMorph(emitInterrupt){if(!this.morphState)return;if(emitInterrupt)this.chartAnimationInterrupted.emit();this.morphState=void 0}now(){return typeof performance!=="undefined"?performance.now():0}startAnimationLoop(){if(this.animationFrameHandle!==null)return;const schedule=typeof requestAnimationFrame==="function"?requestAnimationFrame:(cb=>setTimeout(()=>cb(this.now()),16));const cancel=typeof cancelAnimationFrame==="function"?cancelAnimationFrame:(id=>clearTimeout(id));const tick=now=>{this.animationFrameHandle=null;const stillRunning=this.advanceAnimations(now);this.animationTick++;if(stillRunning){this.animationFrameHandle=schedule(tick)}else{this.chartAnimationEnd.emit()}};this.animationFrameHandle=schedule(tick);this.stopAnimationLoopImpl=()=>{if(this.animationFrameHandle!==null){cancel(this.animationFrameHandle);this.animationFrameHandle=null}}}stopAnimationLoop(){this.stopAnimationLoopImpl?.();this.animationFrameHandle=null}advanceAnimations(now){let running=false;if(this.initialRevealState){const st=this.initialRevealState;const elapsed=st.paused?st.pausedElapsed:now-st.startedAt;if(elapsed>=st.duration)this.initialRevealState=void 0;else if(!st.paused)running=true}if(this.morphState){const st=this.morphState;const elapsed=st.paused?st.pausedElapsed:now-st.startedAt;if(elapsed>=st.duration)this.morphState=void 0;else if(!st.paused)running=true}return running}tweenProgress(st){const elapsed=st.paused?st.pausedElapsed:this.now()-st.startedAt;const raw=Math.min(1,Math.max(0,elapsed/Math.max(1,st.duration)));return applyEasing(raw,this.animationEasing)}resolvedPalette(){if(Array.isArray(this.colors)&&this.colors.length>0)return[...this.colors];const scheme=categorical[this.palette]??categorical.tableau10;const length=Math.max(scheme.stops.length,12);return discretize(scheme,length).map(c=>`rgb(${c.r}, ${c.g}, ${c.b})`)}titleGutter(){let gutter=0;if(this.chartTitle)gutter+=22;if(this.chartSubtitle)gutter+=16;return gutter}plotRect(){const top=this.titleGutter();return{x:0,y:top,width:Math.max(1,this.width),height:Math.max(1,this.height-top)}}effectiveWordMeasure(){const font=`${this.fontWeight}|${this.fontFamily}`;if(!this.wordMeasure||this.wordMeasureFont!==font){this.wordMeasure=createCanvasWordMeasure(this.fontFamily,this.fontWeight);this.wordMeasureFont=font}return this.wordMeasure}settledRenderLayout(){const palette=this.resolvedPalette();const key=[this.width,this.height,this.titleGutter(),this.minFontSize,this.maxFontSize,this.weightScale,this.spiral,this.orientations,this.rotationFrom,this.rotationTo,this.wordPadding,this.fontFamily,this.fontWeight,palette.join(",")].join("|");if(this.layoutCache&&this.layoutCache.key===key&&this.layoutCache.values===this.displayValues){return this.layoutCache.layout}const layout=prepareWordCloudLayout({values:this.displayValues,plot:this.plotRect(),palette,minFontSize:this.minFontSize,maxFontSize:this.maxFontSize,weightScale:this.weightScale,spiral:this.spiral,orientations:this.orientations,rotationFrom:this.rotationFrom,rotationTo:this.rotationTo,wordPadding:this.wordPadding,measure:this.effectiveWordMeasure()});this.layoutCache={key,values:this.displayValues,layout};return layout}currentWordVisuals(){const base=this.settledRenderLayout();if(!this.morphState)return base.visuals;const t=this.tweenProgress(this.morphState);const rendered=this.composeMorphWords(this.morphState.prevVisuals,base.visuals,t);return rendered.filter(word=>!word.key.startsWith("ghost:")).map(word=>{const settled=base.visuals.find(visual=>visual.key===word.key);return{key:word.key,placed:settled?.placed??base.visuals[0]?.placed,x:word.x,y:word.y,rotation:word.rotation,fontSize:word.fontSize,color:word.color,name:word.name,index:word.index}}).filter(visual=>visual.placed!==void 0)}composeMorphWords(prev,next,t){const out=[];const prevByKey=new Map(prev.map(visual=>[visual.key,visual]));const nextKeys=new Set(next.map(visual=>visual.key));for(const b of next){const a=prevByKey.get(b.key);if(a){out.push({key:b.key,x:a.x+(b.x-a.x)*t,y:a.y+(b.y-a.y)*t,rotation:a.rotation+(b.rotation-a.rotation)*t,fontSize:a.fontSize+(b.fontSize-a.fontSize)*t,color:b.color,name:b.name,index:b.index,opacity:1})}else{out.push({key:b.key,x:b.x,y:b.y,rotation:b.rotation,fontSize:b.fontSize*t,color:b.color,name:b.name,index:b.index,opacity:t})}}for(const a of prev){if(nextKeys.has(a.key))continue;out.push({key:`ghost:${a.key}`,x:a.x,y:a.y,rotation:a.rotation,fontSize:a.fontSize*(1-t),color:a.color,name:a.name,index:a.index,opacity:1-t})}return out}revealProgressFor(placementOrder,total,eased){if(total<=0)return 1;const slot=placementOrder/total;const window=Math.max(1e-6,1/Math.min(total,12));return Math.min(1,Math.max(0,(eased*(1+window)-slot)/window))}buildPointEventDetail(word,base,placed){const spot=placed??base.placed.find(entry=>entry.word.index===word.index);const percentage=base.totalWeight>0?word.weight/base.totalWeight:0;const shown=this.shownPoint(spot?.x??base.plot.x+base.plot.width/2,spot?.y??base.plot.y+base.plot.height/2);return{index:word.index,id:word.id,name:word.name,weight:word.weight,percentage,color:word.color,fontSize:spot?.fontSize??0,rotation:spot?.rotation??0,cssX:shown.x,cssY:shown.y}}navigableWords(base=this.settledRenderLayout()){return base.placed.map(placed=>placed.word)}wordAriaLabel(word,base){const percentage=base.totalWeight>0?word.weight/base.totalWeight:0;const pct=Math.round(percentage*1e3)/10;return`${word.name}: ${word.weight} (${pct}%)`}accessibleSummary(base){const title=this.chartTitle?`${this.chartTitle}. `:"";const hidden=base.dropped.length>0?` ${base.dropped.length} ${base.dropped.length===1?"word":"words"} hidden (no space).`:"";return`${title}Word cloud, ${base.placed.length} ${base.placed.length===1?"word":"words"}.${hidden}`}announceFocusedWord(word){const base=this.settledRenderLayout();this.focusedWordIndex=word.index;this.srAnnouncement=this.wordAriaLabel(word,base);if(this.enableMouseTracking)this.pointHover.emit(this.buildPointEventDetail(word,base))}moveFocus(delta){const words=this.navigableWords();if(words.length===0)return;let idx=words.findIndex(word=>word.index===this.focusedWordIndex);if(idx<0)idx=delta>0?-1:0;idx=(idx+delta+words.length)%words.length;this.announceFocusedWord(words[idx])}onChartPointerDown=()=>{this.pointerFocusing=true;setTimeout(()=>{this.pointerFocusing=false},0)};onChartFocus=()=>{if(this.pointerFocusing)return;if(this.focusedWordIndex!==null)return;const words=this.navigableWords();if(words.length>0)this.announceFocusedWord(words[0])};onChartBlur=()=>{this.focusedWordIndex=null};onChartKeyDown=ev=>{if(this.handleZoomKeyDown(ev))return;switch(ev.key){case"ArrowRight":case"ArrowDown":ev.preventDefault();this.moveFocus(1);break;case"ArrowLeft":case"ArrowUp":ev.preventDefault();this.moveFocus(-1);break;case"Home":{ev.preventDefault();const first=this.navigableWords()[0];if(first)this.announceFocusedWord(first);break}case"End":{ev.preventDefault();const list=this.navigableWords();if(list.length>0)this.announceFocusedWord(list[list.length-1]);break}case"Enter":case" ":{if(this.focusedWordIndex===null)return;ev.preventDefault();const base=this.settledRenderLayout();const placed=base.placed.find(entry=>entry.word.index===this.focusedWordIndex);if(!placed)return;this.pointClick.emit(this.buildPointEventDetail(placed.word,base,placed));const spec=this.effectiveTooltipSpec();if(spec.show)this.showTooltipForWord(placed.word,{x:placed.x,y:placed.y},spec,spec.openMode==="multiple",placed);break}case"Escape":this.focusedWordIndex=null;this.clearHover();break;default:break}};pointerCss(event){const rect=this.host.getBoundingClientRect();return{x:event.clientX-rect.left,y:event.clientY-rect.top}}onChartPointerMove=event=>{if(this.handleZoomPointerMove(event))return;if(!this.enableMouseTracking)return;const{x,y}=this.pointerCss(event);const base=this.settledRenderLayout();const placed=this.wordUnderPointer(base,x,y);const nextWord=placed?placed.word.index:null;if(nextWord===this.hoverWordIndex)return;this.hoverWordIndex=nextWord;if(nextWord===null||!placed){this.pointHover.emit(null);const spec2=this.effectiveTooltipSpec();if(this.shouldHideTooltipOnLeave(spec2))this.clearSingleTooltip();return}this.pointHover.emit(this.buildPointEventDetail(placed.word,base,placed));const spec=this.effectiveTooltipSpec();if(spec.show&&spec.trigger!=="click"){this.showTooltipForWord(placed.word,{x:placed.x,y:placed.y},spec,false,placed)}};onChartClick=event=>{if(this.consumeSuppressedPlotClick())return;if(!this.enableMouseTracking){if(this.hasVisibleTooltips())this.clearTooltips();return}const{x,y}=this.pointerCss(event);const base=this.settledRenderLayout();const placed=this.wordUnderPointer(base,x,y);if(!placed){if(this.hasVisibleTooltips())this.clearTooltips();return}this.pointClick.emit(this.buildPointEventDetail(placed.word,base,placed));const spec=this.effectiveTooltipSpec();if(spec.show&&(spec.trigger==="click"||spec.trigger==="hover-click")){this.showTooltipForWord(placed.word,{x:placed.x,y:placed.y},spec,true,placed)}};onChartLeave=()=>{this.clearHover()};onPointContextMenu=event=>{if(!this.enableMouseTracking)return;const{x,y}=this.pointerCss(event);const base=this.settledRenderLayout();const placed=this.wordUnderPointer(base,x,y);if(!placed)return;event.preventDefault();event.stopPropagation();this.pointContextMenu.emit(buildChartPointContextMenuDetail(event,this.host,"word-cloud",this.buildPointEventDetail(placed.word,base,placed),{index:0,id:"word-cloud",name:this.chartTitle??"Word cloud"}))};clearHover(){const hadHover=this.hoverWordIndex!==null;if(!hadHover&&!this.hasVisibleTooltips())return;this.hoverWordIndex=null;if(hadHover)this.pointHover.emit(null);const spec=this.effectiveTooltipSpec();if(this.shouldHideTooltipOnLeave(spec))this.clearSingleTooltip()}effectiveTooltipSpec(){if(this.tooltip!==void 0)return resolveWordCloudTooltipSpec(this.tooltip);return wordCloudTooltipSpecFromLegacy({show:this.tooltipShow,format:this.tooltipFormat})}defaultTooltipHtml(word,context){const pct=Math.round(context.percentage*1e3)/10;return`<strong>${escapeHtml(word.name)}</strong> · ${word.weight} (${pct}%)`}plainTooltipText(word,context){const pct=Math.round(context.percentage*1e3)/10;return`${word.name} · ${word.weight} (${pct}%)`}buildTooltipContext(word,point,placed){const base=this.settledRenderLayout();return{index:word.index,id:word.id,name:word.name,weight:word.weight,percentage:base.totalWeight>0?word.weight/base.totalWeight:0,fontSize:placed?.fontSize??0,rotation:placed?.rotation??0,cssX:point.x,cssY:point.y}}hasVisibleTooltips(){return this.wordTooltip!==null||this.wordTooltips.length>0}clearSingleTooltip(){if(this.wordTooltip===null)return;this.tooltipDrag=void 0;this.wordTooltip=null;if(this.wordTooltips.length===0)this.tooltipHide.emit()}clearTooltips(){if(!this.hasVisibleTooltips())return;this.tooltipDrag=void 0;this.wordTooltip=null;this.wordTooltips=[];this.tooltipHide.emit()}shouldHideTooltipOnLeave(spec){if(!spec.show)return true;if(spec.draggable||spec.trigger==="click")return false;return spec.hideOnLeave!==false}showTooltipForWord(word,anchorPoint,spec,allowMultiple,placed){const shownAnchor=this.shownPoint(anchorPoint.x,anchorPoint.y);const context=this.buildTooltipContext(word,shownAnchor,placed);const side=spec.side??"top";const text=spec.format?safeChartFormatter(spec.format,[word,context],()=>this.plainTooltipText(word,context),"tooltip.format",spec):this.plainTooltipText(word,context);const html=spec.html?safeChartFormatter(spec.html,[word,context],()=>void 0,"tooltip.html",spec):spec.format?void 0:this.defaultTooltipHtml(word,context);const locked=this.lockedTooltipPositionForWord(word,spec);const renderedSide=locked?.side??side;const renderedAnchor=locked?this.tooltipAnchorFromPositionLock(locked.lock,renderedSide,locked.box,spec.offset):{cssX:shownAnchor.x,cssY:shownAnchor.y};const rendered={id:this.nextTooltipId++,cssX:renderedAnchor.cssX,cssY:renderedAnchor.cssY,pointCssX:shownAnchor.x,pointCssY:shownAnchor.y,anchorX:anchorPoint.x,anchorY:anchorPoint.y,box:locked?.box,side:renderedSide,text,html,className:spec.className,style:this.tooltipStyleFromSpec(spec),interactive:spec.interactive,connector:spec.connector,draggable:spec.draggable,offset:spec.offset,positionLock:locked?.lock,context};this.tooltipDrag=void 0;if(allowMultiple&&spec.openMode==="multiple"){this.wordTooltip=rendered;this.wordTooltips=[...this.wordTooltips,rendered]}else{this.wordTooltips=[];this.wordTooltip=rendered}const detail={cssX:renderedAnchor.cssX,cssY:renderedAnchor.cssY,anchor:renderedSide,text,html,context};this.tooltipShown.emit(detail);return detail}tooltipStyleFromSpec(spec){const style={...spec.style??{}};if(spec.width!==void 0)style.width=spec.width;if(spec.minWidth!==void 0)style.minWidth=spec.minWidth;if(spec.maxWidth!==void 0)style.maxWidth=spec.maxWidth;if(spec.padding!==void 0)style.padding=spec.padding;return Object.keys(style).length>0?style:void 0}positionedWordTooltip(tooltip=this.wordTooltip){if(!tooltip)return null;if(!tooltip.box||this.tooltipDrag)return tooltip;if(tooltip.positionLock)return tooltip;const offset=tooltip.offset??10;const placement=computeTooltipPlacement({anchor:{kind:"point",x:tooltip.pointCssX,y:tooltip.pointCssY},tooltip:tooltip.box,viewport:{x:0,y:0,width:this.width,height:this.height},preferredSide:tooltip.side,offset});const anchor=this.tooltipAnchorFromTopLeft(placement.x,placement.y,tooltip.box,placement.side,offset);return{...tooltip,cssX:anchor.cssX,cssY:anchor.cssY,side:placement.side}}tooltipAnchorFromTopLeft(x,y,box,side,offset){if(side==="top")return{cssX:x+box.width/2,cssY:y+box.height+offset};if(side==="bottom")return{cssX:x+box.width/2,cssY:y-offset};if(side==="left")return{cssX:x+box.width+offset,cssY:y+box.height/2};return{cssX:x-offset,cssY:y+box.height/2}}tooltipTopLeftFromAnchor(tooltip){const box=tooltip.box;if(!box)return void 0;const offset=tooltip.offset??10;if(tooltip.side==="top")return{x:tooltip.cssX-box.width/2,y:tooltip.cssY-offset-box.height};if(tooltip.side==="bottom")return{x:tooltip.cssX-box.width/2,y:tooltip.cssY+offset};if(tooltip.side==="left")return{x:tooltip.cssX-offset-box.width,y:tooltip.cssY-box.height/2};return{x:tooltip.cssX+offset,y:tooltip.cssY-box.height/2}}tooltipTopLeftFromElement(element){const rect=element.getBoundingClientRect();const hostRect=this.host.getBoundingClientRect();if(!Number.isFinite(rect.left)||!Number.isFinite(rect.top))return void 0;return{x:rect.left-hostRect.left,y:rect.top-hostRect.top}}tooltipAnchorFromPositionLock(lock,side,box,offset){return box?this.tooltipAnchorFromTopLeft(lock.x,lock.y,box,side,offset):{cssX:lock.x,cssY:lock.y}}rememberDraggableTooltipPosition(tooltip){if(!tooltip.draggable||!tooltip.positionLock)return;this.draggableTooltipPositions.set(String(tooltip.context.index),{lock:{...tooltip.positionLock},side:tooltip.side,box:tooltip.box})}lockedTooltipPositionForWord(word,spec){if(spec.draggable){const memory=this.draggableTooltipPositions.get(String(word.index));if(!memory)return void 0;return{lock:{...memory.lock},side:memory.side,box:memory.box}}if(!spec.interactive||spec.openMode==="multiple")return void 0;const tooltip=this.positionedWordTooltip();if(!tooltip?.box||tooltip.context.index!==word.index)return void 0;const lock=this.tooltipTopLeftFromAnchor(tooltip);return lock?{lock,side:tooltip.side,box:tooltip.box}:void 0}measureWordTooltipBox(){if(this.wordTooltips.length>0)return;const tooltip=this.wordTooltip;const element=this.tooltipElement;if(!tooltip||!element)return;const rect=element.getBoundingClientRect();if(!Number.isFinite(rect.width)||!Number.isFinite(rect.height))return;const width=Math.round(rect.width*100)/100;const height=Math.round(rect.height*100)/100;if(tooltip.box?.width===width&&tooltip.box?.height===height)return;const box={width,height};const next={...tooltip,box};if(tooltip.positionLock){Object.assign(next,this.tooltipAnchorFromPositionLock(tooltip.positionLock,tooltip.side,box,tooltip.offset??10))}this.rememberDraggableTooltipPosition(next);this.wordTooltip=next}handleTooltipActionClick=event=>{const target=event.target;const actionTarget=target?.closest?.("[data-tooltip-action]");const action=actionTarget?.dataset.tooltipAction;const tooltipId=Number(actionTarget?.closest?.("[data-tooltip-id]")?.getAttribute("data-tooltip-id"));const tooltip=this.wordTooltips.find(entry=>entry.id===tooltipId)??this.wordTooltip;if(!action||!tooltip)return;event.stopPropagation();this.tooltipAction.emit({...tooltip.context,action,text:tooltip.text,html:tooltip.html})};handleTooltipPointerDown=event=>{if(!this.wordTooltip?.draggable)return;const target=event.target;if(target?.closest?.("[data-tooltip-action],button,a,input,textarea,select"))return;event.preventDefault();event.stopPropagation();const element=event.currentTarget;const rendered=this.positionedWordTooltip(this.wordTooltip)??this.wordTooltip;const lock=this.tooltipTopLeftFromElement(element)??this.tooltipTopLeftFromAnchor(rendered)??{x:rendered.cssX,y:rendered.cssY};const box=this.wordTooltip.box??rendered.box;const next={...this.wordTooltip,cssX:rendered.cssX,cssY:rendered.cssY,side:rendered.side,box,positionLock:lock};Object.assign(next,this.tooltipAnchorFromPositionLock(lock,next.side,box,next.offset??10));this.wordTooltip=next;this.rememberDraggableTooltipPosition(next);element.setPointerCapture?.(event.pointerId);this.tooltipDrag={pointerId:event.pointerId,startX:event.clientX,startY:event.clientY,originX:next.cssX,originY:next.cssY,originLockX:lock.x,originLockY:lock.y}};handleTooltipPointerMove=event=>{const drag=this.tooltipDrag;if(!drag||drag.pointerId!==event.pointerId||!this.wordTooltip)return;event.preventDefault();event.stopPropagation();const lock={x:drag.originLockX+event.clientX-drag.startX,y:drag.originLockY+event.clientY-drag.startY};const next={...this.wordTooltip,positionLock:lock};Object.assign(next,this.tooltipAnchorFromPositionLock(lock,next.side,next.box,next.offset??10));this.wordTooltip=next;this.rememberDraggableTooltipPosition(next)};handleTooltipPointerUp=event=>{const drag=this.tooltipDrag;if(!drag||drag.pointerId!==event.pointerId)return;event.stopPropagation();if(this.wordTooltip)this.rememberDraggableTooltipPosition(this.wordTooltip);event.currentTarget.releasePointerCapture?.(event.pointerId);this.tooltipDrag=void 0};render(){const renderStart=this.now();const decision=pickWordCloudEngine({requested:this.engine,onUnavailable:this.unavailable});if(decision.tier!==this.activeTier)this.activeTier=decision.tier;if(decision.fallbackReason!==this.fallbackReason)this.fallbackReason=decision.fallbackReason;const base=this.settledRenderLayout();let drawWords=base.visuals.map(visual=>({key:visual.key,x:visual.x,y:visual.y,rotation:visual.rotation,fontSize:visual.fontSize,color:visual.color,name:visual.name,index:visual.index,opacity:1}));if(this.morphState){drawWords=this.composeMorphWords(this.morphState.prevVisuals,base.visuals,this.tweenProgress(this.morphState))}else if(this.initialRevealState){const eased=this.tweenProgress(this.initialRevealState);drawWords=base.visuals.map((visual,order)=>{const progress=this.revealProgressFor(order,base.visuals.length,eased);return{key:visual.key,x:visual.x,y:visual.y,rotation:visual.rotation,fontSize:visual.fontSize*progress,color:visual.color,name:visual.name,index:visual.index,opacity:progress}})}const activeWord=this.focusedWordIndex??this.hoverWordIndex;const zoomSpec=this.zoomSpec();const zoomRect=this.zoomRect();const viewport=viewportZoomTransform(zoomRect,this.zoomState);const viewportMatrix=viewportZoomMatrix(viewport);const viewportClipId=`sy-word-cloud-viewport-${this.instanceKey}`;this.lastRenderResult={words:base.placed.length,dropped:base.dropped.length,renderMs:this.now()-renderStart};this.pendingRenderedEmit=true;return h(Host,{"data-active-tier":this.activeTier,style:{touchAction:zoomSpec.enabled&&zoomSpec.pinch?"none":void 0},"data-sy-brand-host":"chart"},h("div",{class:"sy-word-cloud",style:{width:`${this.width}px`,height:`${this.height}px`,position:"relative"}},h("svg",{class:"sy-word-cloud__root",width:this.width,height:this.height,viewBox:`0 0 ${this.width} ${this.height}`,xmlns:"http://www.w3.org/2000/svg","data-animation-tick":this.animationTick,"data-total-words":base.placed.length,"data-dropped-words":base.dropped.length,role:"application","aria-roledescription":"Word cloud","aria-label":this.accessibleSummary(base),tabindex:0,onKeyDown:ev=>this.onChartKeyDown(ev),onFocus:()=>this.onChartFocus(),onBlur:()=>this.onChartBlur(),onMouseDown:()=>this.onChartPointerDown(),onPointerDown:this.handleZoomPointerDown,onPointerMove:ev=>this.onChartPointerMove(ev),onPointerUp:this.handleZoomPointerUp,onPointerCancel:this.handleZoomPointerCancel,onMouseLeave:()=>this.onChartLeave(),onClick:ev=>this.onChartClick(ev),onContextMenu:ev=>this.onPointContextMenu(ev)},this.chartTitle?h("text",{class:"sy-word-cloud__title",x:this.width/2,y:6,style:{fontSize:"14px"}},this.chartTitle):null,this.chartSubtitle?h("text",{class:"sy-word-cloud__subtitle",x:this.width/2,y:this.chartTitle?26:6,style:{fontSize:"12px"}},this.chartSubtitle):null,h("defs",null,h("clipPath",{id:viewportClipId},h("rect",{x:zoomRect.x,y:zoomRect.y,width:zoomRect.width,height:zoomRect.height}))),h("g",{class:"sy-word-cloud__viewport","clip-path":viewport.zoomed?`url(#${viewportClipId})`:void 0},h("g",{class:"sy-word-cloud__words","aria-hidden":"true",transform:viewportMatrix||void 0},drawWords.map(word=>{if(word.fontSize<=0||word.opacity<=0)return null;const dim=activeWord!==null&&word.index!==activeWord&&!word.key.startsWith("ghost:");const cls=`sy-word-cloud__word${dim?" sy-word-cloud__word--dim":""}`;return h("text",{key:word.key,class:cls,transform:`translate(${word.x} ${word.y}) rotate(${word.rotation})`,"text-anchor":"middle","dominant-baseline":"central",fill:word.color,opacity:word.opacity,style:{fontSize:`${word.fontSize}px`,fontFamily:this.fontFamily,fontWeight:this.fontWeight},"data-word-index":word.index,"data-word":word.name},word.name)})))),this.renderZoomOverlay(),h("div",{class:"sy-word-cloud__sr-only",role:"list","aria-label":"Words"},this.navigableWords(base).map(word=>h("div",{role:"listitem",key:`sr:${word.id}`},this.wordAriaLabel(word,base)))),h("div",{class:"sy-word-cloud__sr-only","aria-live":"polite",role:"status"},this.srAnnouncement),this.fallbackReason&&h("span",{class:"sy-word-cloud__watermark",title:this.fallbackReason},"Syidax - fell back to standard renderer"),this.renderWordTooltipConnector(),this.renderWordTooltip()),renderChartBrand(this.host,this.brandLogo,{width:this.width,height:this.height,plot:zoomRect}))}renderWordTooltip(){const multiple=this.wordTooltips.length>0;const tooltips=multiple?this.wordTooltips:[this.positionedWordTooltip()].filter(tooltip=>Boolean(tooltip));if(tooltips.length===0)return null;return tooltips.map(tooltip=>this.renderWordTooltipItem(tooltip,!multiple))}renderWordTooltipItem(tooltip,trackMeasure){const{cssX,cssY,side,text,html:tooltipHtml,className,style:customStyle,interactive,draggable}=tooltip;const offset=tooltip.offset??10;const style={position:"absolute",zIndex:"5",boxSizing:"border-box",width:"max-content",maxWidth:"calc(100% - 16px)",padding:"6px 10px",font:"500 12px system-ui, sans-serif",color:"var(--sy-tooltip-color, #fff)",background:"var(--sy-tooltip-bg, rgba(15,23,42,0.92))",borderRadius:"4px",whiteSpace:"pre-line",lineHeight:"1.35",boxShadow:"0 2px 8px rgba(0,0,0,0.18)",pointerEvents:interactive||draggable?"auto":"none",cursor:draggable?this.tooltipDrag?"grabbing":"grab":"default",transform:""};if(tooltip.positionLock){style.left=`${tooltip.positionLock.x}px`;style.top=`${tooltip.positionLock.y}px`;style.transform=""}else if(side==="top"){style.left=`${cssX}px`;style.top=`${cssY-offset}px`;style.transform="translate(-50%, -100%)"}else if(side==="bottom"){style.left=`${cssX}px`;style.top=`${cssY+offset}px`;style.transform="translate(-50%, 0%)"}else if(side==="left"){style.left=`${cssX-offset}px`;style.top=`${cssY}px`;style.transform="translate(-100%, -50%)"}else{style.left=`${cssX+offset}px`;style.top=`${cssY}px`;style.transform="translate(0%, -50%)"}for(const[key,value]of Object.entries(customStyle??{})){style[key]=wordTooltipCssValue(key,value)}if(tooltipHtml!==void 0){return h("div",{class:wordTooltipClassName("sy-word-cloud__tooltip",className),"data-tooltip-id":`${tooltip.id}`,ref:trackMeasure?el=>this.tooltipElement=el:void 0,style,role:"tooltip",onClick:this.handleTooltipActionClick,onPointerDown:this.handleTooltipPointerDown,onPointerMove:this.handleTooltipPointerMove,onPointerUp:this.handleTooltipPointerUp,onPointerCancel:this.handleTooltipPointerUp,innerHTML:tooltipHtml})}return h("div",{class:wordTooltipClassName("sy-word-cloud__tooltip",className),"data-tooltip-id":`${tooltip.id}`,ref:trackMeasure?el=>this.tooltipElement=el:void 0,style,role:"tooltip",onClick:this.handleTooltipActionClick,onPointerDown:this.handleTooltipPointerDown,onPointerMove:this.handleTooltipPointerMove,onPointerUp:this.handleTooltipPointerUp,onPointerCancel:this.handleTooltipPointerUp},text)}renderWordTooltipConnector(){const tooltips=this.wordTooltips.length>0?this.wordTooltips:[this.positionedWordTooltip()].filter(tooltip=>Boolean(tooltip));const connectedTooltips=tooltips.filter(tooltip=>tooltip.connector?.show);if(connectedTooltips.length===0)return null;return h("svg",{class:"sy-word-cloud__tooltip-connector",width:this.width,height:this.height,style:{position:"absolute",left:"0px",top:"0px",width:`${this.width}px`,height:`${this.height}px`,pointerEvents:"none",overflow:"visible",zIndex:"4"},"aria-hidden":"true"},connectedTooltips.map(tooltip=>{const connector=tooltip.connector;const end=tooltipConnectorEnd(tooltip);return h("line",{x1:tooltip.pointCssX,y1:tooltip.pointCssY,x2:end.x,y2:end.y,stroke:connector.color??"var(--sy-tooltip-connector-color, rgba(17,24,39,0.42))","stroke-width":connector.width??1,"stroke-dasharray":connector.dash?.join(" ")})}))}async getEngineStatus(){return standardOnlyEngineStatus({requested:this.engine,onUnavailable:this.unavailable,renderer:"word-cloud"})}static get is(){return"sy-word-cloud"}static get encapsulation(){return"scoped"}static get originalStyleUrls(){return{"$":["sy-word-cloud.scss"]}}static get styleUrls(){return{"$":["sy-word-cloud.css"]}}static get properties(){return{"values":{"type":"unknown","mutable":true,"complexType":{"original":"WordCloudValues","resolved":"readonly WordCloudDatum[]","references":{"WordCloudValues":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudValues","referenceLocation":"WordCloudValues"}}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"defaultValue":"[]"},"width":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"width","defaultValue":"520"},"height":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"height","defaultValue":"400"},"brandLogo":{"type":"string","mutable":false,"complexType":{"original":"string","resolved":"string","references":{}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"brand-logo"},"brandPosition":{"type":"string","mutable":false,"complexType":{"original":"'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'","resolved":'"bottom-left" | "bottom-right" | "top-left" | "top-right"',"references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":true,"attribute":"brand-position","defaultValue":"'bottom-right'"},"palette":{"type":"string","mutable":false,"complexType":{"original":"WordCloudPaletteName","resolved":'"observable10" | "paired12" | "set3_12" | "tableau10" | "tableau20"',"references":{"WordCloudPaletteName":{"location":"local","path":"src/components/chart/word-cloud-chart/sy-word-cloud.tsx","id":"src/components/chart/word-cloud-chart/sy-word-cloud.tsx::WordCloudPaletteName"}}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"palette","defaultValue":"'tableau10'"},"colors":{"type":"unknown","mutable":false,"complexType":{"original":"ReadonlyArray<string>","resolved":"readonly string[]","references":{"ReadonlyArray":{"location":"global","id":"global::ReadonlyArray"}}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false},"minFontSize":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"min-font-size","defaultValue":"10"},"maxFontSize":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"max-font-size","defaultValue":"44"},"weightScale":{"type":"string","mutable":false,"complexType":{"original":"WordCloudWeightScale","resolved":'"linear" | "log" | "sqrt"',"references":{"WordCloudWeightScale":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudWeightScale","referenceLocation":"WordCloudWeightScale"}}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"weight-scale","defaultValue":"'linear'"},"spiral":{"type":"string","mutable":false,"complexType":{"original":"WordCloudSpiral","resolved":'"archimedean" | "rectangular"',"references":{"WordCloudSpiral":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudSpiral","referenceLocation":"WordCloudSpiral"}}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"spiral","defaultValue":"'rectangular'"},"orientations":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"orientations","defaultValue":"2"},"rotationFrom":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"rotation-from","defaultValue":"0"},"rotationTo":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"rotation-to","defaultValue":"90"},"wordPadding":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"word-padding","defaultValue":"2"},"fontFamily":{"type":"string","mutable":false,"complexType":{"original":"string","resolved":"string","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"font-family","defaultValue":"'system-ui, sans-serif'"},"fontWeight":{"type":"string","mutable":false,"complexType":{"original":"string","resolved":"string","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"font-weight","defaultValue":"'600'"},"chartTitle":{"type":"string","mutable":false,"complexType":{"original":"string","resolved":"string","references":{}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"chart-title"},"chartSubtitle":{"type":"string","mutable":false,"complexType":{"original":"string","resolved":"string","references":{}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"chart-subtitle"},"tooltipShow":{"type":"boolean","mutable":false,"complexType":{"original":"boolean","resolved":"boolean","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"tooltip-show","defaultValue":"true"},"tooltipFormat":{"type":"unknown","mutable":false,"complexType":{"original":"(word: WordCloudResolvedWord) => string","resolved":"(word: WordCloudResolvedWord) => string","references":{"WordCloudResolvedWord":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudResolvedWord","referenceLocation":"WordCloudResolvedWord"}}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false},"tooltip":{"type":"any","mutable":false,"complexType":{"original":"WordCloudTooltipInput","resolved":'"auto" | "off" | Omit<Partial<WordCloudTooltipSpec>, "connector"> & { connector?: WordCloudTooltipConnectorInput; } | boolean',"references":{"WordCloudTooltipInput":{"location":"import","path":"./core/word-tooltip","id":"src/components/chart/word-cloud-chart/core/word-tooltip.ts::WordCloudTooltipInput","referenceLocation":"WordCloudTooltipInput"}}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"tooltip"},"enableMouseTracking":{"type":"boolean","mutable":false,"complexType":{"original":"boolean","resolved":"boolean","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"enable-mouse-tracking","defaultValue":"true"},"zoom":{"type":"any","mutable":false,"complexType":{"original":"CartesianZoomInput","resolved":'"auto" | "false" | "inside" | "off" | "true" | "x" | "xy" | "y" | Partial<Omit<CartesianZoomSpec, "wheel" | "pan">> & { pan?: CartesianZoomPanInput; wheel?: CartesianZoomWheelInput; } | boolean',"references":{"CartesianZoomInput":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomInput","referenceLocation":"CartesianZoomInput"}}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"zoom"},"engine":{"type":"string","mutable":false,"complexType":{"original":"WordCloudEngineMode","resolved":'"auto" | "pro" | "standard"',"references":{"WordCloudEngineMode":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudEngineMode","referenceLocation":"WordCloudEngineMode"}}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"engine","defaultValue":"'auto'"},"unavailable":{"type":"string","mutable":false,"complexType":{"original":"WordCloudUnavailableBehaviour","resolved":'"error" | "fallback" | "throw"',"references":{"WordCloudUnavailableBehaviour":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudUnavailableBehaviour","referenceLocation":"WordCloudUnavailableBehaviour"}}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"unavailable","defaultValue":"'fallback'"},"streamSource":{"type":"unknown","mutable":true,"complexType":{"original":"WordCloudStreamSource","resolved":"WordCloudStreamSource","references":{"WordCloudStreamSource":{"location":"import","path":"./core/word-stream-source","id":"src/components/chart/word-cloud-chart/core/word-stream-source.ts::WordCloudStreamSource","referenceLocation":"WordCloudStreamSource"}}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false},"streamWindow":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"stream-window"},"streamMax":{"type":"number","mutable":false,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"stream-max"},"animated":{"type":"boolean","mutable":true,"complexType":{"original":"boolean","resolved":"boolean","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"animate","defaultValue":"false"},"animationDuration":{"type":"number","mutable":true,"complexType":{"original":"number","resolved":"number","references":{}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"animation-duration","defaultValue":"600"},"animationEasing":{"type":"string","mutable":true,"complexType":{"original":"WordCloudEasing","resolved":'"ease-in" | "ease-in-out" | "ease-out" | "linear"',"references":{"WordCloudEasing":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudEasing","referenceLocation":"WordCloudEasing"}}},"required":false,"optional":false,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"animation-easing","defaultValue":"'ease-out'"},"animationType":{"type":"string","mutable":true,"complexType":{"original":"WordCloudAnimationType","resolved":'"initial" | "update"',"references":{"WordCloudAnimationType":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudAnimationType","referenceLocation":"WordCloudAnimationType"}}},"required":false,"optional":true,"docs":{text:"",tags:[]},"getter":false,"setter":false,"reflect":false,"attribute":"animation-type"}}}static get states(){return{"activeTier":{},"fallbackReason":{},"wordTooltip":{},"wordTooltips":{},"displayValues":{},"hoverWordIndex":{},"focusedWordIndex":{},"srAnnouncement":{},"animationTick":{},"zoomState":{},"zoomSelection":{}}}static get events(){return[{"method":"rendered","name":"rendered","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"WordCloudRenderResult & { tier: WordCloudEngineTier }","resolved":'WordCloudRenderResult & { tier: "standard"; }',"references":{"WordCloudRenderResult":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudRenderResult","referenceLocation":"WordCloudRenderResult"},"WordCloudEngineTier":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudEngineTier","referenceLocation":"WordCloudEngineTier"}}}},{"method":"pointClick","name":"pointClick","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"WordCloudPointEventDetail","resolved":"WordCloudPointEventDetail","references":{"WordCloudPointEventDetail":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudPointEventDetail","referenceLocation":"WordCloudPointEventDetail"}}}},{"method":"pointHover","name":"pointHover","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"WordCloudPointEventDetail | null","resolved":"WordCloudPointEventDetail","references":{"WordCloudPointEventDetail":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudPointEventDetail","referenceLocation":"WordCloudPointEventDetail"}}}},{"method":"pointContextMenu","name":"pointContextMenu","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"ChartPointContextMenuEventDetail<WordCloudPointEventDetail>","resolved":"ChartPointContextMenuEventDetail<WordCloudPointEventDetail>","references":{"ChartPointContextMenuEventDetail":{"location":"import","path":"../_shared/core/event","id":"src/components/chart/_shared/core/event/index.ts::ChartPointContextMenuEventDetail","referenceLocation":"ChartPointContextMenuEventDetail"},"WordCloudPointEventDetail":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudPointEventDetail","referenceLocation":"WordCloudPointEventDetail"}}}},{"method":"appended","name":"appended","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"{ count: number }","resolved":"{ count: number; }","references":{}}},{"method":"windowSlid","name":"windowSlid","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"{ dropped: number }","resolved":"{ dropped: number; }","references":{}}},{"method":"chartAnimationStart","name":"chartAnimationStart","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"void","resolved":"void","references":{}}},{"method":"chartAnimationEnd","name":"chartAnimationEnd","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"void","resolved":"void","references":{}}},{"method":"chartAnimationInterrupted","name":"chartAnimationInterrupted","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"void","resolved":"void","references":{}}},{"method":"tooltipShown","name":"tooltipShow","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"WordCloudTooltipShowEventDetail","resolved":"WordCloudTooltipShowEventDetail","references":{"WordCloudTooltipShowEventDetail":{"location":"import","path":"./core/word-tooltip","id":"src/components/chart/word-cloud-chart/core/word-tooltip.ts::WordCloudTooltipShowEventDetail","referenceLocation":"WordCloudTooltipShowEventDetail"}}}},{"method":"tooltipHide","name":"tooltipHide","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"void","resolved":"void","references":{}}},{"method":"tooltipAction","name":"tooltipAction","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"WordCloudTooltipActionEventDetail","resolved":"WordCloudTooltipActionEventDetail","references":{"WordCloudTooltipActionEventDetail":{"location":"import","path":"./core/word-tooltip","id":"src/components/chart/word-cloud-chart/core/word-tooltip.ts::WordCloudTooltipActionEventDetail","referenceLocation":"WordCloudTooltipActionEventDetail"}}}},{"method":"zoomChange","name":"zoomChange","bubbles":true,"cancelable":true,"composed":true,"docs":{text:"",tags:[]},"complexType":{"original":"CartesianZoomChangeEventDetail","resolved":"CartesianZoomChangeEventDetail","references":{"CartesianZoomChangeEventDetail":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomChangeEventDetail","referenceLocation":"CartesianZoomChangeEventDetail"}}}}]}static get methods(){return{"redraw":{"complexType":{"signature":"() => Promise<WordCloudRenderResult>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudRenderResult":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudRenderResult","referenceLocation":"WordCloudRenderResult"}},"return":"Promise<WordCloudRenderResult>"},"docs":{text:"",tags:[]}},"getActiveTier":{"complexType":{"signature":"() => Promise<WordCloudEngineTier>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudEngineTier":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudEngineTier","referenceLocation":"WordCloudEngineTier"}},"return":'Promise<"standard">'},"docs":{text:"",tags:[]}},"addWord":{"complexType":{"signature":"(datum: WordCloudDatum, opts?: { insertAt?: number; }) => Promise<number>","parameters":[{"name":"datum","type":"readonly [name: string, weight: number] | { readonly name: string; readonly weight: number; readonly color?: string; readonly rotation?: number; readonly visible?: boolean; readonly id?: string | number; }","docs":{text:"",tags:[]}},{"name":"opts","type":"{ insertAt?: number; }","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudDatum":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudDatum","referenceLocation":"WordCloudDatum"}},"return":"Promise<number>"},"docs":{text:"",tags:[]}},"removeWord":{"complexType":{"signature":"(idOrIndex: string | number) => Promise<boolean>","parameters":[{"name":"idOrIndex","type":"string | number","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudDatum":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudDatum","referenceLocation":"WordCloudDatum"}},"return":"Promise<boolean>"},"docs":{text:"",tags:[]}},"updateWord":{"complexType":{"signature":"(idOrIndex: string | number, patch: Partial<Exclude<WordCloudDatum, readonly [string, number]>>) => Promise<boolean>","parameters":[{"name":"idOrIndex","type":"string | number","docs":{text:"",tags:[]}},{"name":"patch","type":"{ readonly name?: string; readonly weight?: number; readonly color?: string; readonly rotation?: number; readonly visible?: boolean; readonly id?: string | number; }","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"Partial":{"location":"global","id":"global::Partial"},"Exclude":{"location":"global","id":"global::Exclude"},"WordCloudDatum":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudDatum","referenceLocation":"WordCloudDatum"}},"return":"Promise<boolean>"},"docs":{text:"",tags:[]}},"setWordWeight":{"complexType":{"signature":"(idOrIndex: string | number, weight: number) => Promise<boolean>","parameters":[{"name":"idOrIndex","type":"string | number","docs":{text:"",tags:[]}},{"name":"weight","type":"number","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"}},"return":"Promise<boolean>"},"docs":{text:"",tags:[]}},"appendPoint":{"complexType":{"signature":"(datum: WordCloudDatum) => Promise<void>","parameters":[{"name":"datum","type":"readonly [name: string, weight: number] | { readonly name: string; readonly weight: number; readonly color?: string; readonly rotation?: number; readonly visible?: boolean; readonly id?: string | number; }","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudDatum":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudDatum","referenceLocation":"WordCloudDatum"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"appendBatch":{"complexType":{"signature":"(datums: ReadonlyArray<WordCloudDatum>) => Promise<void>","parameters":[{"name":"datums","type":"readonly WordCloudDatum[]","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"ReadonlyArray":{"location":"global","id":"global::ReadonlyArray"},"WordCloudDatum":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudDatum","referenceLocation":"WordCloudDatum"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"shift":{"complexType":{"signature":"(count?: number) => Promise<void>","parameters":[{"name":"count","type":"number","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudDatum":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudDatum","referenceLocation":"WordCloudDatum"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"replace":{"complexType":{"signature":"(datums: ReadonlyArray<WordCloudDatum>) => Promise<void>","parameters":[{"name":"datums","type":"readonly WordCloudDatum[]","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"ReadonlyArray":{"location":"global","id":"global::ReadonlyArray"},"WordCloudDatum":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudDatum","referenceLocation":"WordCloudDatum"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"getStreamSource":{"complexType":{"signature":"() => Promise<WordCloudStreamSource | undefined>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudStreamSource":{"location":"import","path":"./core/word-stream-source","id":"src/components/chart/word-cloud-chart/core/word-stream-source.ts::WordCloudStreamSource","referenceLocation":"WordCloudStreamSource"}},"return":"Promise<WordCloudStreamSource>"},"docs":{text:"",tags:[]}},"setAnimation":{"complexType":{"signature":"(options: { duration?: number; easing?: WordCloudEasing; enabled?: boolean; type?: WordCloudAnimationType; }) => Promise<void>","parameters":[{"name":"options","type":"{ duration?: number; easing?: WordCloudEasing; enabled?: boolean; type?: WordCloudAnimationType; }","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudEasing":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudEasing","referenceLocation":"WordCloudEasing"},"WordCloudAnimationType":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudAnimationType","referenceLocation":"WordCloudAnimationType"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"pauseAnimation":{"complexType":{"signature":"() => Promise<void>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"resumeAnimation":{"complexType":{"signature":"() => Promise<void>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"replayAnimation":{"complexType":{"signature":"() => Promise<void>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"hitTestWord":{"complexType":{"signature":"(cssX: number, cssY: number) => Promise<{ index: number; id: string; name: string; } | null>","parameters":[{"name":"cssX","type":"number","docs":{text:"",tags:[]}},{"name":"cssY","type":"number","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"}},"return":"Promise<{ index: number; id: string; name: string; }>"},"docs":{text:"",tags:[]}},"getDroppedWords":{"complexType":{"signature":"() => Promise<Array<{ index: number; id: string; name: string; weight: number; }>>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"},"Array":{"location":"global","id":"global::Array"}},"return":"Promise<{ index: number; id: string; name: string; weight: number; }[]>"},"docs":{text:"",tags:[]}},"showTooltipAtWord":{"complexType":{"signature":"(idOrIndex: string | number) => Promise<WordCloudPointEventDetail | null>","parameters":[{"name":"idOrIndex","type":"string | number","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"WordCloudPointEventDetail":{"location":"import","path":"./core/types","id":"src/components/chart/word-cloud-chart/core/types.ts::WordCloudPointEventDetail","referenceLocation":"WordCloudPointEventDetail"}},"return":"Promise<WordCloudPointEventDetail>"},"docs":{text:"",tags:[]}},"hideTooltip":{"complexType":{"signature":"() => Promise<void>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"}},"return":"Promise<void>"},"docs":{text:"",tags:[]}},"zoomTo":{"complexType":{"signature":"(request: CartesianZoomRequest) => Promise<CartesianZoomChangeEventDetail | null>","parameters":[{"name":"request","type":"CartesianZoomRequest","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"CartesianZoomChangeEventDetail":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomChangeEventDetail","referenceLocation":"CartesianZoomChangeEventDetail"},"CartesianZoomRequest":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomRequest","referenceLocation":"CartesianZoomRequest"}},"return":"Promise<CartesianZoomChangeEventDetail>"},"docs":{text:"",tags:[]}},"zoomBy":{"complexType":{"signature":"(factor: number, anchorFraction?: number) => Promise<CartesianZoomChangeEventDetail | null>","parameters":[{"name":"factor","type":"number","docs":{text:"",tags:[]}},{"name":"anchorFraction","type":"number","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"CartesianZoomChangeEventDetail":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomChangeEventDetail","referenceLocation":"CartesianZoomChangeEventDetail"}},"return":"Promise<CartesianZoomChangeEventDetail>"},"docs":{text:"",tags:[]}},"panBy":{"complexType":{"signature":"(delta: { x?: number; y?: number; }) => Promise<CartesianZoomChangeEventDetail | null>","parameters":[{"name":"delta","type":"{ x?: number; y?: number; }","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"CartesianZoomChangeEventDetail":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomChangeEventDetail","referenceLocation":"CartesianZoomChangeEventDetail"}},"return":"Promise<CartesianZoomChangeEventDetail>"},"docs":{text:"",tags:[]}},"resetZoom":{"complexType":{"signature":"() => Promise<CartesianZoomChangeEventDetail | null>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"},"CartesianZoomChangeEventDetail":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomChangeEventDetail","referenceLocation":"CartesianZoomChangeEventDetail"}},"return":"Promise<CartesianZoomChangeEventDetail>"},"docs":{text:"",tags:[]}},"getZoom":{"complexType":{"signature":"() => Promise<CartesianZoomState | null>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"},"CartesianZoomState":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomState","referenceLocation":"CartesianZoomState"}},"return":"Promise<CartesianZoomState>"},"docs":{text:"",tags:[]}},"getZoomExtent":{"complexType":{"signature":"(request?: CartesianZoomExtentRequest) => Promise<CartesianZoomExtentDetail | null>","parameters":[{"name":"request","type":"CartesianZoomExtentRequest","docs":{text:"",tags:[]}}],"references":{"Promise":{"location":"global","id":"global::Promise"},"CartesianZoomExtentDetail":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomExtentDetail","referenceLocation":"CartesianZoomExtentDetail"},"CartesianZoomExtentRequest":{"location":"import","path":"../_shared/core/zoom","id":"src/components/chart/_shared/core/zoom/index.ts::CartesianZoomExtentRequest","referenceLocation":"CartesianZoomExtentRequest"}},"return":"Promise<CartesianZoomExtentDetail>"},"docs":{text:"",tags:[]}},"getEngineStatus":{"complexType":{"signature":"() => Promise<ChartEngineStatus>","parameters":[],"references":{"Promise":{"location":"global","id":"global::Promise"},"ChartEngineStatus":{"location":"import","path":"../_shared/core/engine/types","id":"src/components/chart/_shared/core/engine/types.ts::ChartEngineStatus","referenceLocation":"ChartEngineStatus"}},"return":"Promise<ChartEngineStatus>"},"docs":{text:"",tags:[]}}}}static get elementRef(){return"host"}static get watchers(){return[{"propName":"values","methodName":"handleValuesChange"},{"propName":"streamSource","methodName":"handleStreamSourceChange"},{"propName":"streamWindow","methodName":"handleStreamSourceChange"},{"propName":"streamMax","methodName":"handleStreamSourceChange"},{"propName":"animated","methodName":"handleAnimationChange"},{"propName":"animationDuration","methodName":"handleAnimationChange"},{"propName":"animationEasing","methodName":"handleAnimationChange"},{"propName":"animationType","methodName":"handleAnimationChange"},{"propName":"minFontSize","methodName":"handleVisualPropsChange"},{"propName":"maxFontSize","methodName":"handleVisualPropsChange"},{"propName":"weightScale","methodName":"handleVisualPropsChange"},{"propName":"spiral","methodName":"handleVisualPropsChange"},{"propName":"orientations","methodName":"handleVisualPropsChange"},{"propName":"rotationFrom","methodName":"handleVisualPropsChange"},{"propName":"rotationTo","methodName":"handleVisualPropsChange"},{"propName":"wordPadding","methodName":"handleVisualPropsChange"},{"propName":"fontFamily","methodName":"handleVisualPropsChange"},{"propName":"fontWeight","methodName":"handleVisualPropsChange"},{"propName":"palette","methodName":"handleVisualPropsChange"},{"propName":"colors","methodName":"handleVisualPropsChange"},{"propName":"chartTitle","methodName":"handleVisualPropsChange"},{"propName":"chartSubtitle","methodName":"handleVisualPropsChange"},{"propName":"tooltipShow","methodName":"handleVisualPropsChange"},{"propName":"tooltip","methodName":"handleVisualPropsChange"},{"propName":"enableMouseTracking","methodName":"handleVisualPropsChange"}]}}

package/dist/collection/components/dynamic-source.js

@@ -0,0 +1 @@
+export const dynamicSource=build=>({type:"dynamic",language:"html",transform:(_code,ctx)=>build(ctx?.args??{})});

package/dist/collection/components/grid/core/a11y/aria-grid.js

@@ -0,0 +1 @@
+export function coerceIndex(value){if(typeof value!=="number")return 0;if(!Number.isFinite(value))return 0;if(value<0)return 0;return Math.floor(value)}function coerceCount(value){if(typeof value!=="number")return 0;if(!Number.isFinite(value))return 0;if(value<0)return 0;return Math.floor(value)}export function gridRootAttrs(input){return{role:input.tree===true?"treegrid":"grid","aria-rowcount":String(coerceCount(input.rowCount)),"aria-colcount":String(coerceCount(input.colCount)),"aria-busy":input.busy===true?"true":"false"}}export function headerRowGroupAttrs(){return{role:"rowgroup"}}export function bodyRowGroupAttrs(){return{role:"rowgroup"}}export function headerRowAttrs(groupDepth=0){return{role:"row","aria-rowindex":coerceIndex(groupDepth)+1}}export function bodyRowAttrs(rowIndex,options){const headerOffset=options&&typeof options.headerOffset==="number"?coerceIndex(options.headerOffset):0;const out={role:"row","aria-rowindex":coerceIndex(rowIndex)+2+headerOffset};if(options&&typeof options.isSelected==="boolean"){out["aria-selected"]=options.isSelected?"true":"false"}if(options&&options.emitRowIndex===true){out["data-row-index"]=String(coerceIndex(rowIndex))}return out}function ariaSortFromDirection(direction){if(direction==="asc")return"ascending";if(direction==="desc")return"descending";return"none"}export function columnHeaderAttrs(input){return{role:"columnheader","aria-colindex":coerceIndex(input.colIndex)+1,"aria-sort":ariaSortFromDirection(input.sortDirection),"aria-label":typeof input.label==="string"?input.label:""}}export function gridCellAttrs(input){return{role:"gridcell","aria-colindex":coerceIndex(input.colIndex)+1,tabindex:input.isActive===true?0:-1}}

package/dist/collection/components/grid/core/a11y/audit-checklist.js

@@ -0,0 +1 @@
+function pass(wcagRef,severity){return{passed:true,severity,wcagRef}}function fail(wcagRef,severity,message){return{passed:false,severity,wcagRef,message}}export const AUDIT_CHECKS=[{id:"roles.gridRoot",category:"roles",wcagRef:"WCAG 2.1 AA — 1.3.1",description:'Grid root element has role="grid".',severity:"error",check(snapshot){if(snapshot.root.role!=="grid"){return fail("WCAG 2.1 AA — 1.3.1","error",`grid root role is "${snapshot.root.role??"(missing)"}", expected "grid"`)}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"roles.ariaRowcount",category:"roles",wcagRef:"WCAG 2.1 AA — 1.3.1",description:"Grid root carries aria-rowcount as a non-negative integer string.",severity:"error",check(snapshot){const v=snapshot.root.ariaRowcount;if(typeof v!=="string"||v.length===0){return fail("WCAG 2.1 AA — 1.3.1","error",`aria-rowcount missing on grid root`)}const n=Number(v);if(!Number.isFinite(n)||n<0||!Number.isInteger(n)){return fail("WCAG 2.1 AA — 1.3.1","error",`aria-rowcount="${v}" is not a non-negative integer`)}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"roles.ariaColcount",category:"roles",wcagRef:"WCAG 2.1 AA — 1.3.1",description:"Grid root carries aria-colcount as a non-negative integer string.",severity:"error",check(snapshot){const v=snapshot.root.ariaColcount;if(typeof v!=="string"||v.length===0){return fail("WCAG 2.1 AA — 1.3.1","error",`aria-colcount missing on grid root`)}const n=Number(v);if(!Number.isFinite(n)||n<0||!Number.isInteger(n)){return fail("WCAG 2.1 AA — 1.3.1","error",`aria-colcount="${v}" is not a non-negative integer`)}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"roles.rowgroupPresent",category:"roles",wcagRef:"WCAG 2.1 AA — 1.3.1",description:'At least one role="rowgroup" descendant.',severity:"error",check(snapshot){if(snapshot.rowgroupCount<1){return fail("WCAG 2.1 AA — 1.3.1","error",`no role="rowgroup" descendant found (counted ${snapshot.rowgroupCount})`)}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"header.exactlyOneHeaderRow",category:"header",wcagRef:"WCAG 2.1 AA — 1.3.1",description:"Exactly one row has aria-rowindex=1 (the header row).",severity:"error",check(snapshot){const headerRows=snapshot.rows.filter(r=>r.ariaRowindex===1);if(headerRows.length!==1){return fail("WCAG 2.1 AA — 1.3.1","error",`expected exactly 1 row with aria-rowindex=1, found ${headerRows.length}`)}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"header.allCellsAreColumnheaders",category:"header",wcagRef:"WCAG 2.1 AA — 1.3.1",description:'Every cell in the header row has role="columnheader".',severity:"error",check(snapshot){const headerRow=snapshot.rows.find(r=>r.ariaRowindex===1);if(!headerRow){return fail("WCAG 2.1 AA — 1.3.1","error","header row missing — cannot verify columnheader roles")}const offenders=headerRow.cells.filter(c=>c.role!=="columnheader");if(offenders.length>0){return fail("WCAG 2.1 AA — 1.3.1","error",`${offenders.length} header cell(s) missing role="columnheader"`)}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"header.colindexSequential",category:"header",wcagRef:"WCAG 2.1 AA — 1.3.1",description:"Columnheader aria-colindex values are sequential 1..N.",severity:"error",check(snapshot){const headerRow=snapshot.rows.find(r=>r.ariaRowindex===1);if(!headerRow){return fail("WCAG 2.1 AA — 1.3.1","error","header row missing — cannot verify aria-colindex sequence")}for(let i=0;i<headerRow.cells.length;i++){const expected=i+1;const actual=headerRow.cells[i].ariaColindex;if(actual!==expected){return fail("WCAG 2.1 AA — 1.3.1","error",`header cell #${i} has aria-colindex=${actual}, expected ${expected}`)}}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"header.sortableHasAriaSort",category:"header",wcagRef:"WCAG 2.1 AA — 1.3.1",description:'Every columnheader has aria-sort (one of "ascending"|"descending"|"none").',severity:"error",check(snapshot){const headerRow=snapshot.rows.find(r=>r.ariaRowindex===1);if(!headerRow){return fail("WCAG 2.1 AA — 1.3.1","error","header row missing — cannot verify aria-sort")}const valid=new Set(["ascending","descending","none"]);for(const cell of headerRow.cells){if(!cell.ariaSort||!valid.has(cell.ariaSort)){return fail("WCAG 2.1 AA — 1.3.1","error",`columnheader at colindex=${cell.ariaColindex} has aria-sort="${cell.ariaSort??"(missing)"}", expected one of ascending|descending|none`)}}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"header.tabindexNotZero",category:"header",wcagRef:"WCAG 2.1 AA — 2.4.3",description:"No columnheader cell holds tabindex=0 — the roving Tab stop must live on a body cell so header focus uses arrow keys only, never duplicating the Tab anchor.",severity:"error",check(snapshot){const headerRow=snapshot.rows.find(r=>r.ariaRowindex===1);if(!headerRow)return pass("WCAG 2.1 AA — 2.4.3","error");for(const cell of headerRow.cells){if(cell.tabindex===0){return fail("WCAG 2.1 AA — 2.4.3","error",`columnheader at colindex=${cell.ariaColindex} has tabindex=0; header cells must use tabindex=-1 (or omit) so the roving anchor stays on the body`)}}return pass("WCAG 2.1 AA — 2.4.3","error")}},{id:"header.columnheaderHasLabel",category:"header",wcagRef:"WCAG 2.1 AA — 2.4.6",description:"Every columnheader has a non-empty aria-label (Headers and Labels).",severity:"error",check(snapshot){const headerRow=snapshot.rows.find(r=>r.ariaRowindex===1);if(!headerRow){return fail("WCAG 2.1 AA — 2.4.6","error","header row missing — cannot verify columnheader labels")}for(const cell of headerRow.cells){if(typeof cell.ariaLabel!=="string"||cell.ariaLabel.length===0){return fail("WCAG 2.1 AA — 2.4.6","error",`columnheader at colindex=${cell.ariaColindex} missing aria-label`)}}return pass("WCAG 2.1 AA — 2.4.6","error")}},{id:"body.rowindexStartsAt2",category:"body",wcagRef:"WCAG 2.1 AA — 1.3.1",description:"Every body row has aria-rowindex >= 2.",severity:"error",check(snapshot){const bodyRows=snapshot.rows.filter(r=>r.ariaRowindex!==1);for(const row of bodyRows){if(typeof row.ariaRowindex!=="number"||!Number.isInteger(row.ariaRowindex)||row.ariaRowindex<2){return fail("WCAG 2.1 AA — 1.3.1","error",`body row has aria-rowindex=${row.ariaRowindex}, expected >= 2`)}}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"body.allCellsAreGridcells",category:"body",wcagRef:"WCAG 2.1 AA — 1.3.1",description:'Every cell in body rows has role="gridcell".',severity:"error",check(snapshot){const bodyRows=snapshot.rows.filter(r=>r.ariaRowindex!==1);for(const row of bodyRows){for(const cell of row.cells){if(cell.role!=="gridcell"){return fail("WCAG 2.1 AA — 1.3.1","error",`body cell at rowindex=${row.ariaRowindex} colindex=${cell.ariaColindex} has role="${cell.role??"(missing)"}", expected "gridcell"`)}}}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"body.colindexMatchesPosition",category:"body",wcagRef:"WCAG 2.1 AA — 1.3.1",description:"Body cell aria-colindex values are sequential 1..N within each row.",severity:"error",check(snapshot){const bodyRows=snapshot.rows.filter(r=>r.ariaRowindex!==1);for(const row of bodyRows){for(let i=0;i<row.cells.length;i++){const expected=i+1;const actual=row.cells[i].ariaColindex;if(actual!==expected){return fail("WCAG 2.1 AA — 1.3.1","error",`body cell at rowindex=${row.ariaRowindex} #${i} has aria-colindex=${actual}, expected ${expected}`)}}}return pass("WCAG 2.1 AA — 1.3.1","error")}},{id:"body.rovingTabindex",category:"body",wcagRef:"WCAG 2.1 AA — 2.4.3",description:"Exactly one body cell has tabindex=0 (or zero when activeCell is null); all others tabindex=-1.",severity:"error",check(snapshot){const bodyRows=snapshot.rows.filter(r=>r.ariaRowindex!==1);let zeros=0;for(const row of bodyRows){for(const cell of row.cells){if(cell.tabindex===0)zeros++;else if(cell.tabindex!==-1){return fail("WCAG 2.1 AA — 2.4.3","error",`body cell at rowindex=${row.ariaRowindex} colindex=${cell.ariaColindex} has tabindex=${cell.tabindex}, expected 0 or -1`)}}}const expectedZeros=snapshot.activeCell===null?0:1;if(zeros!==expectedZeros){return fail("WCAG 2.1 AA — 2.4.3","error",`roving tabindex broken — found ${zeros} cells with tabindex=0, expected ${expectedZeros} (activeCell ${snapshot.activeCell===null?"is null":"is set"})`)}return pass("WCAG 2.1 AA — 2.4.3","error")}},{id:"labels.gridLabel",category:"labels",wcagRef:"WCAG 2.1 AA — 4.1.2",description:"Grid root has aria-label.",severity:"error",check(snapshot,options){const expected=options.expectedLabels?.gridLabel;const actual=snapshot.root.ariaLabel;if(typeof actual!=="string"||actual.length===0){return fail("WCAG 2.1 AA — 4.1.2","error",`grid root missing aria-label`)}if(typeof expected==="string"&&expected.length>0&&actual!==expected){return fail("WCAG 2.1 AA — 4.1.2","error",`grid root aria-label="${actual}", expected "${expected}" (locale-resolved a11y.gridLabel)`)}return pass("WCAG 2.1 AA — 4.1.2","error")}},{id:"labels.quickFilter",category:"labels",wcagRef:"WCAG 2.1 AA — 4.1.2",description:"Quick filter input has aria-label (when present).",severity:"error",check(snapshot,options){if(!snapshot.quickFilter)return pass("WCAG 2.1 AA — 4.1.2","error");const expected=options.expectedLabels?.quickFilterLabel;const actual=snapshot.quickFilter.ariaLabel;if(typeof actual!=="string"||actual.length===0){return fail("WCAG 2.1 AA — 4.1.2","error",`quick filter input missing aria-label`)}if(typeof expected==="string"&&expected.length>0&&actual!==expected){return fail("WCAG 2.1 AA — 4.1.2","error",`quick filter aria-label="${actual}", expected "${expected}"`)}return pass("WCAG 2.1 AA — 4.1.2","error")}},{id:"labels.paginationPrev",category:"labels",wcagRef:"WCAG 2.1 AA — 4.1.2",description:"Pagination previous-page button has aria-label (when present).",severity:"error",check(snapshot,options){if(!snapshot.pagination)return pass("WCAG 2.1 AA — 4.1.2","error");const expected=options.expectedLabels?.paginationPrev;const actual=snapshot.pagination.prevAriaLabel;if(typeof actual!=="string"||actual.length===0){return fail("WCAG 2.1 AA — 4.1.2","error",`pagination prev button missing aria-label`)}if(typeof expected==="string"&&expected.length>0&&actual!==expected){return fail("WCAG 2.1 AA — 4.1.2","error",`pagination prev aria-label="${actual}", expected "${expected}"`)}return pass("WCAG 2.1 AA — 4.1.2","error")}},{id:"labels.paginationNext",category:"labels",wcagRef:"WCAG 2.1 AA — 4.1.2",description:"Pagination next-page button has aria-label (when present).",severity:"error",check(snapshot,options){if(!snapshot.pagination)return pass("WCAG 2.1 AA — 4.1.2","error");const expected=options.expectedLabels?.paginationNext;const actual=snapshot.pagination.nextAriaLabel;if(typeof actual!=="string"||actual.length===0){return fail("WCAG 2.1 AA — 4.1.2","error",`pagination next button missing aria-label`)}if(typeof expected==="string"&&expected.length>0&&actual!==expected){return fail("WCAG 2.1 AA — 4.1.2","error",`pagination next aria-label="${actual}", expected "${expected}"`)}return pass("WCAG 2.1 AA — 4.1.2","error")}},{id:"labels.paginationPageSize",category:"labels",wcagRef:"WCAG 2.1 AA — 4.1.2",description:"Pagination rows-per-page selector has aria-label (when present).",severity:"error",check(snapshot,options){if(!snapshot.pagination)return pass("WCAG 2.1 AA — 4.1.2","error");if(!snapshot.pagination.hasPageSize)return pass("WCAG 2.1 AA — 4.1.2","error");const expected=options.expectedLabels?.paginationPageSize;const actual=snapshot.pagination.pageSizeAriaLabel;if(typeof actual!=="string"||actual.length===0){return fail("WCAG 2.1 AA — 4.1.2","error",`pagination page-size selector missing aria-label`)}if(typeof expected==="string"&&expected.length>0&&actual!==expected){return fail("WCAG 2.1 AA — 4.1.2","error",`pagination page-size aria-label="${actual}", expected "${expected}"`)}return pass("WCAG 2.1 AA — 4.1.2","error")}},{id:"labels.filterButtons",category:"labels",wcagRef:"WCAG 2.1 AA — 4.1.2",description:"Every per-column filter button has a non-empty aria-label.",severity:"error",check(snapshot){for(const btn of snapshot.filterButtons){if(typeof btn.ariaLabel!=="string"||btn.ariaLabel.length===0){return fail("WCAG 2.1 AA — 4.1.2","error",`filter button #${snapshot.filterButtons.indexOf(btn)} missing aria-label`)}}return pass("WCAG 2.1 AA — 4.1.2","error")}},{id:"busy.ariaBusyWhenLoading",category:"busy",wcagRef:"WCAG 2.1 AA — 4.1.3",description:'aria-busy="true" exactly when loading; otherwise "false" or absent.',severity:"error",check(snapshot){const busy=snapshot.root.ariaBusy;if(snapshot.loading===true){if(busy!=="true"){return fail("WCAG 2.1 AA — 4.1.3","error",`loading=true but aria-busy="${busy??"(missing)"}", expected "true"`)}}else{if(busy!==void 0&&busy!=="false"){return fail("WCAG 2.1 AA — 4.1.3","error",`loading=false but aria-busy="${busy}", expected "false" or absent`)}}return pass("WCAG 2.1 AA — 4.1.3","error")}},{id:"keyboard.tabEscapeReachable",category:"keyboard",wcagRef:"WCAG 2.1 AA — 2.1.2",description:"Focus can move through the grid with a single active body cell tab stop.",severity:"error",check(snapshot){if(snapshot.activeCell===null){return pass("WCAG 2.1 AA — 2.1.2","error")}const{row:bodyRow,col}=snapshot.activeCell;const targetRowindex=bodyRow+2;const target=snapshot.rows.find(r=>r.ariaRowindex===targetRowindex);if(!target){return fail("WCAG 2.1 AA — 2.1.2","error",`activeCell points at body row=${bodyRow} (aria-rowindex=${targetRowindex}) but no such row in snapshot`)}const cell=target.cells.find(c=>c.ariaColindex===col+1);if(!cell){return fail("WCAG 2.1 AA — 2.1.2","error",`activeCell points at col=${col} (aria-colindex=${col+1}) but no such cell in row ${targetRowindex}`)}if(cell.tabindex!==0){return fail("WCAG 2.1 AA — 2.1.2","error",`active cell at (row=${bodyRow}, col=${col}) has tabindex=${cell.tabindex}, expected 0 (single Tab stop in/out of grid)`)}return pass("WCAG 2.1 AA — 2.1.2","error")}},{id:"keyboard.everyCellReachable",category:"keyboard",wcagRef:"WCAG 2.1 AA — 2.1.1",description:"Every gridcell has tabindex defined (0 or -1) — no cell with `undefined` tabindex (would be unreachable via roving tabindex).",severity:"error",check(snapshot){for(const row of snapshot.rows){if(row.ariaRowindex===1)continue;for(const cell of row.cells){if(typeof cell.tabindex!=="number"){return fail("WCAG 2.1 AA — 2.1.1","error",`body cell at rowindex=${row.ariaRowindex} colindex=${cell.ariaColindex} has no tabindex (would be unreachable via keyboard)`)}}}return pass("WCAG 2.1 AA — 2.1.1","error")}},{id:"contrast.textBackground",category:"contrast",wcagRef:"WCAG 2.1 AA — 1.4.3",description:"Text vs background contrast ratio >= 4.5:1 across every grid surface (rows, header, pagination, empty state).",severity:"warn",todo:false,check(snapshot){const tokens=snapshot.resolvedThemeTokens;if(!tokens){return fail("WCAG 2.1 AA — 1.4.3","warn","snapshot.resolvedThemeTokens missing — cannot compute contrast")}const pairs=[["--sy-grid-text","--sy-grid-row-bg-odd"],["--sy-grid-text","--sy-grid-row-bg-even"],["--sy-grid-header-color","--sy-grid-header-bg"],["--sy-grid-pagination-color","--sy-grid-pagination-bg"],["--sy-grid-empty-state-color","--sy-grid-empty-state-bg"]];const THRESHOLD=4.5;let worstRatio=Infinity;let worstPair=null;for(const[fgToken,bgToken]of pairs){const fgCss=tokens[fgToken];const bgCss=tokens[bgToken];if(typeof fgCss!=="string"||typeof bgCss!=="string"){return fail("WCAG 2.1 AA — 1.4.3","warn",`missing token "${typeof fgCss!=="string"?fgToken:bgToken}" in resolvedThemeTokens`)}const fg=parseLocalCssColor(fgCss);const bg=parseLocalCssColor(bgCss);if(!fg||!bg){return fail("WCAG 2.1 AA — 1.4.3","warn",`cannot parse colour for ${fgToken}="${fgCss}" / ${bgToken}="${bgCss}"`)}const ratio=localContrastRatio(fg,bg);if(ratio<worstRatio){worstRatio=ratio;worstPair={fg:fgToken,bg:bgToken}}}if(worstRatio<THRESHOLD){return fail("WCAG 2.1 AA — 1.4.3","warn",`worst contrast ratio ${worstRatio.toFixed(2)}:1 (between ${worstPair.fg} and ${worstPair.bg}), need >= ${THRESHOLD}:1`)}return pass("WCAG 2.1 AA — 1.4.3","warn")}},{id:"focus-visible.outlineRing",category:"focus-visible",wcagRef:"WCAG 2.1 AA — 2.4.7",description:"Active-cell outline + initial viewport focus outline are visible (non-text contrast >= 3:1 vs adjacent backgrounds).",severity:"warn",todo:false,check(snapshot){const tokens=snapshot.resolvedThemeTokens;if(!tokens){return fail("WCAG 2.1 AA — 2.4.7","warn","snapshot.resolvedThemeTokens missing — cannot verify focus outline")}const pairs=[["--sy-grid-active-cell-outline","--sy-grid-row-bg-odd"],["--sy-grid-viewport-focus-outline","--sy-grid-bg"]];const THRESHOLD=3;let worstRatio=Infinity;let worstPair=null;for(const[ringToken,bgToken]of pairs){const ringCss=tokens[ringToken];const bgCss=tokens[bgToken];if(typeof ringCss!=="string"||typeof bgCss!=="string"){return fail("WCAG 2.1 AA — 2.4.7","warn",`missing token "${typeof ringCss!=="string"?ringToken:bgToken}" in resolvedThemeTokens`)}const ring=parseLocalCssColor(ringCss);const bg=parseLocalCssColor(bgCss);if(!ring||!bg){return fail("WCAG 2.1 AA — 2.4.7","warn",`cannot parse colour for ${ringToken}="${ringCss}" / ${bgToken}="${bgCss}"`)}if(ring.r===bg.r&&ring.g===bg.g&&ring.b===bg.b){return fail("WCAG 2.1 AA — 2.4.7","warn",`${ringToken} is identical to ${bgToken} — focus indicator would be invisible`)}const ratio=localContrastRatio(ring,bg);if(ratio<worstRatio){worstRatio=ratio;worstPair={ring:ringToken,bg:bgToken}}}if(worstRatio<THRESHOLD){return fail("WCAG 2.1 AA — 2.4.7","warn",`worst focus-outline contrast ratio ${worstRatio.toFixed(2)}:1 (between ${worstPair.ring} and ${worstPair.bg}), need >= ${THRESHOLD}:1`)}return pass("WCAG 2.1 AA — 2.4.7","warn")}},{id:"selection.ariaSelectedConsistent",category:"selection",wcagRef:"WCAG 2.1 AA — 4.1.2",description:"Body rows uniformly carry aria-selected (when selection is on) OR uniformly omit it (when off).",severity:"error",check(snapshot){const bodyRows=snapshot.rows.filter(r=>r.ariaRowindex!==1);if(bodyRows.length===0)return pass("WCAG 2.1 AA — 4.1.2","error");let withAttr=0;let withoutAttr=0;const valid=new Set(["true","false"]);for(const row of bodyRows){if(row.ariaSelected===null){withoutAttr++}else if(valid.has(row.ariaSelected)){withAttr++}else{return fail("WCAG 2.1 AA — 4.1.2","error",`body row at rowindex=${row.ariaRowindex} has aria-selected="${row.ariaSelected}", expected "true"|"false" or absent`)}}if(withAttr>0&&withoutAttr>0){return fail("WCAG 2.1 AA — 4.1.2","error",`aria-selected split state — ${withAttr} body row(s) have it, ${withoutAttr} omit it; selection mode must be uniform across rows`)}return pass("WCAG 2.1 AA — 4.1.2","error")}}];function parseLocalCssColor(css){if(typeof css!=="string")return null;const trimmed=css.trim();if(trimmed.length===0)return null;if(trimmed[0]==="#"){const hex=trimmed.slice(1);if(!/^[0-9a-fA-F]+$/.test(hex))return null;if(hex.length===3){return{r:parseInt(hex[0]+hex[0],16),g:parseInt(hex[1]+hex[1],16),b:parseInt(hex[2]+hex[2],16)}}if(hex.length===4){return{r:parseInt(hex[0]+hex[0],16),g:parseInt(hex[1]+hex[1],16),b:parseInt(hex[2]+hex[2],16)}}if(hex.length===6){return{r:parseInt(hex.slice(0,2),16),g:parseInt(hex.slice(2,4),16),b:parseInt(hex.slice(4,6),16)}}if(hex.length===8){return{r:parseInt(hex.slice(0,2),16),g:parseInt(hex.slice(2,4),16),b:parseInt(hex.slice(4,6),16)}}return null}const lower=trimmed.toLowerCase();const fnMatch=lower.match(/^rgba?\s*\(([^)]+)\)$/);if(fnMatch){const parts=fnMatch[1].split(",").map(p=>p.trim());if(parts.length!==3&&parts.length!==4)return null;const r=Number(parts[0]);const g=Number(parts[1]);const b=Number(parts[2]);if(!Number.isFinite(r)||!Number.isFinite(g)||!Number.isFinite(b)){return null}if(r<0||r>255||g<0||g>255||b<0||b>255){return null}return{r:Math.round(r),g:Math.round(g),b:Math.round(b)}}return null}function localRelativeLuminance(rgb){const channel=raw=>{const c=raw/255;return c<=.03928?c/12.92:Math.pow((c+.055)/1.055,2.4)};const r=channel(rgb.r);const g=channel(rgb.g);const b=channel(rgb.b);return .2126*r+.7152*g+.0722*b}function localContrastRatio(fg,bg){const lFg=localRelativeLuminance(fg);const lBg=localRelativeLuminance(bg);const lighter=Math.max(lFg,lBg);const darker=Math.min(lFg,lBg);return(lighter+.05)/(darker+.05)}export function runAudit(snapshot,options={}){const skipTodos=options.skipTodoStubs!==false;const results=[];let errorCount=0;let warnCount=0;let infoCount=0;for(const check of AUDIT_CHECKS){if(check.todo===true&&skipTodos){results.push({id:check.id,category:check.category,wcagRef:check.wcagRef,description:check.description,severity:check.severity,passed:true,skipped:true});continue}const result=check.check(snapshot,options);results.push({id:check.id,category:check.category,wcagRef:check.wcagRef,description:check.description,severity:result.severity,passed:result.passed,message:result.message});if(!result.passed){if(result.severity==="error")errorCount++;else if(result.severity==="warn")warnCount++;else infoCount++}}return{errorCount,warnCount,infoCount,totalChecks:AUDIT_CHECKS.length,results}}export function formatAuditResult(result){const lines=[];lines.push(`Syidax sy-grid a11y audit — ${result.totalChecks} checks, ${result.errorCount} error(s), ${result.warnCount} warning(s)`);lines.push("");for(const r of result.results){const marker=r.skipped?"SKIP":r.passed?"PASS":r.severity.toUpperCase();lines.push(`[${marker}] ${r.id}  (${r.wcagRef})`);lines.push(`        ${r.description}`);if(r.message)lines.push(`        → ${r.message}`)}return lines.join("\n")}

package/dist/collection/components/grid/core/a11y/contrast.js

@@ -0,0 +1 @@
+export function parseCssColor(css){if(typeof css!=="string")return null;const trimmed=css.trim();if(trimmed.length===0)return null;if(trimmed[0]==="#"){const hex=trimmed.slice(1);if(!/^[0-9a-fA-F]+$/.test(hex))return null;if(hex.length===3){const r=parseInt(hex[0]+hex[0],16);const g=parseInt(hex[1]+hex[1],16);const b=parseInt(hex[2]+hex[2],16);return{r,g,b}}if(hex.length===4){const r=parseInt(hex[0]+hex[0],16);const g=parseInt(hex[1]+hex[1],16);const b=parseInt(hex[2]+hex[2],16);return{r,g,b}}if(hex.length===6){const r=parseInt(hex.slice(0,2),16);const g=parseInt(hex.slice(2,4),16);const b=parseInt(hex.slice(4,6),16);return{r,g,b}}if(hex.length===8){const r=parseInt(hex.slice(0,2),16);const g=parseInt(hex.slice(2,4),16);const b=parseInt(hex.slice(4,6),16);return{r,g,b}}return null}const lower=trimmed.toLowerCase();const fnMatch=lower.match(/^rgba?\s*\(([^)]+)\)$/);if(fnMatch){const parts=fnMatch[1].split(",").map(p=>p.trim());if(parts.length!==3&&parts.length!==4)return null;const r=Number(parts[0]);const g=Number(parts[1]);const b=Number(parts[2]);if(!Number.isFinite(r)||!Number.isFinite(g)||!Number.isFinite(b)){return null}if(r<0||r>255||g<0||g>255||b<0||b>255){return null}return{r:Math.round(r),g:Math.round(g),b:Math.round(b)}}return null}export function relativeLuminance(rgb){const channel=raw=>{const c=raw/255;return c<=.03928?c/12.92:Math.pow((c+.055)/1.055,2.4)};const r=channel(rgb.r);const g=channel(rgb.g);const b=channel(rgb.b);return .2126*r+.7152*g+.0722*b}export function contrastRatio(fg,bg){const lFg=relativeLuminance(fg);const lBg=relativeLuminance(bg);const lighter=Math.max(lFg,lBg);const darker=Math.min(lFg,lBg);return(lighter+.05)/(darker+.05)}export function passesContrast(fg,bg,isLargeText){const ratio=contrastRatio(fg,bg);const threshold=isLargeText?3:4.5;return{passed:ratio>=threshold,ratio}}

package/dist/collection/components/grid/core/a11y/screen-reader-transcript.js

@@ -0,0 +1 @@
+function toCount(value){if(value===null||value===void 0)return null;const n=Number(value);return Number.isFinite(n)&&n>0?n:null}function headerRow(snapshot){return snapshot.rows.find(row=>row.ariaRowindex===1)??null}function bodyRows(snapshot){return snapshot.rows.filter(row=>row.ariaRowindex!==1)}function cellByCol(row,colIndex){if(!row)return null;return row.cells.find(cell=>cell.ariaColindex===colIndex+1)??row.cells[colIndex]??null}function headerLabel(snapshot,colIndex){const header=cellByCol(headerRow(snapshot),colIndex);const label=header?.ariaLabel?.trim();return label&&label.length>0?label:`Column ${colIndex+1}`}function rowForActiveCell(snapshot,activeCell){if(!activeCell)return null;const ariaRowindex=activeCell.row+2;return snapshot.rows.find(row=>row.ariaRowindex===ariaRowindex)??bodyRows(snapshot)[activeCell.row]??null}function sortPhrase(sort){if(sort==="ascending")return"sorted ascending";if(sort==="descending")return"sorted descending";if(sort==="other")return"sorted";return"not sorted"}function voiceOverSortPhrase(sort){if(sort==="ascending")return"sorted ascending";if(sort==="descending")return"sorted descending";if(sort==="other")return"sorted";return"not sorted"}function cellAnnouncement(snapshot,activeCell){if(!activeCell)return"No active gridcell";const row=rowForActiveCell(snapshot,activeCell);const cell=cellByCol(row,activeCell.col);const rowLabel=Number.isFinite(row?.ariaRowindex)?String(row.ariaRowindex):String(activeCell.row+2);const colLabel=Number.isFinite(cell?.ariaColindex)?String(cell.ariaColindex):String(activeCell.col+1);const selected=row?.ariaSelected==="true"?", selected":"";return`row ${rowLabel} column ${colLabel}, ${headerLabel(snapshot,activeCell.col)}, gridcell${selected}`}function voiceOverCellAnnouncement(snapshot,activeCell){if(!activeCell)return"No active grid cell";const row=rowForActiveCell(snapshot,activeCell);const cell=cellByCol(row,activeCell.col);const rowLabel=Number.isFinite(row?.ariaRowindex)?String(row.ariaRowindex):String(activeCell.row+2);const colLabel=Number.isFinite(cell?.ariaColindex)?String(cell.ariaColindex):String(activeCell.col+1);const selected=row?.ariaSelected==="true"?", selected":"";return`${headerLabel(snapshot,activeCell.col)}, row ${rowLabel} column ${colLabel}, grid cell${selected}`}function sortedHeader(snapshot){const header=headerRow(snapshot);if(!header)return null;for(let i=0;i<header.cells.length;i++){const cell=header.cells[i];if(cell.ariaSort&&cell.ariaSort!=="none"){return{colIndex:i,cell}}}return null}function formatGridEntry(snapshot,rowCount,colCount){const label=snapshot.root.ariaLabel?.trim()||"Data grid";const rows=rowCount===null?"unknown rows":`${rowCount} rows`;const cols=colCount===null?"unknown columns":`${colCount} columns`;const busy=snapshot.root.ariaBusy==="true"?", busy":"";return`${label}, grid, ${rows}, ${cols}${busy}`}function formatVoiceOverGridEntry(snapshot,rowCount,colCount){const label=snapshot.root.ariaLabel?.trim()||"Data grid";const rows=rowCount===null?"unknown rows":`${rowCount} rows`;const cols=colCount===null?"unknown columns":`${colCount} columns`;const busy=snapshot.root.ariaBusy==="true"?", busy":"";return`${label}, grid, ${rows}, ${cols}${busy}`}function addCheck(checks,id,label,pass,actual,expected){checks.push({id,label,pass,actual,expected})}function addVoiceOverCheck(checks,id,label,pass,actual,expected){checks.push({id,label,pass,actual,expected})}export function buildNvdaGridTranscript(snapshot){const rowCount=toCount(snapshot.root.ariaRowcount);const colCount=toCount(snapshot.root.ariaColcount);const activeCell=snapshot.activeCell;const steps=[];const checks=[];const gridEntry=formatGridEntry(snapshot,rowCount,colCount);steps.push({id:"enter-grid",action:"Tab",target:snapshot.root.ariaLabel?.trim()||"grid",announcement:gridEntry,source:"grid"});steps.push({id:"active-cell",action:"Focus",target:"active gridcell",announcement:cellAnnouncement(snapshot,activeCell),source:"cell"});if(activeCell&&(colCount===null||activeCell.col+1<colCount)){const next={row:activeCell.row,col:activeCell.col+1};steps.push({id:"arrow-right",action:"ArrowRight",target:headerLabel(snapshot,next.col),announcement:cellAnnouncement(snapshot,next),source:"cell"})}if(activeCell&&(rowCount===null||activeCell.row+2<rowCount)){const next={row:activeCell.row+1,col:activeCell.col};steps.push({id:"arrow-down",action:"ArrowDown",target:headerLabel(snapshot,next.col),announcement:cellAnnouncement(snapshot,next),source:"cell"})}const sorted=sortedHeader(snapshot);if(sorted){steps.push({id:"sorted-header",action:"Shift+Tab to header",target:headerLabel(snapshot,sorted.colIndex),announcement:`column ${sorted.colIndex+1}, ${headerLabel(snapshot,sorted.colIndex)}, columnheader, `+sortPhrase(sorted.cell.ariaSort),source:"header"})}if(snapshot.quickFilter){const label=snapshot.quickFilter.ariaLabel?.trim()||"Quick filter";steps.push({id:"quick-filter",action:"Tab",target:label,announcement:`${label}, edit`,source:"quick-filter"})}if(snapshot.pagination){const pageSize=snapshot.pagination.pageSizeAriaLabel?.trim()||"Rows per page";const prev=snapshot.pagination.prevAriaLabel?.trim()||"Previous page";const next=snapshot.pagination.nextAriaLabel?.trim()||"Next page";steps.push({id:"pagination",action:"Tab through pagination",target:"pagination controls",announcement:`${pageSize}, combo box; ${prev}, button; ${next}, button`,source:"pagination"})}if(snapshot.loading||snapshot.root.ariaBusy!==void 0){const busy=snapshot.root.ariaBusy==="true"?"busy":"not busy";steps.push({id:"busy-state",action:"Loading state changes",target:"grid root",announcement:`${snapshot.root.ariaLabel?.trim()||"Data grid"}, ${busy}`,source:"busy"})}addCheck(checks,"grid-role",'Grid root exposes role="grid"',snapshot.root.role==="grid"&&gridEntry.includes("grid"),snapshot.root.role??"(missing)","grid");addCheck(checks,"row-count","NVDA entry includes row count",rowCount!==null&&gridEntry.includes(`${rowCount} rows`),rowCount===null?"(missing)":`${rowCount}`,"finite aria-rowcount");addCheck(checks,"col-count","NVDA entry includes column count",colCount!==null&&gridEntry.includes(`${colCount} columns`),colCount===null?"(missing)":`${colCount}`,"finite aria-colcount");addCheck(checks,"active-cell","Focused cell announces row, column, and gridcell",activeCell!==null&&/row \d+ column \d+/.test(cellAnnouncement(snapshot,activeCell)),activeCell===null?"(missing)":JSON.stringify(activeCell),"active body gridcell");addCheck(checks,"header-label","Focused cell announcement includes its column label",activeCell!==null&&cellAnnouncement(snapshot,activeCell).includes(headerLabel(snapshot,activeCell.col)),activeCell===null?"(missing)":headerLabel(snapshot,activeCell.col),"non-empty columnheader aria-label");if(sorted){addCheck(checks,"sort-state","Sorted header announcement includes aria-sort state",sortPhrase(sorted.cell.ariaSort)!=="not sorted",sorted.cell.ariaSort??"(missing)","ascending, descending, or other")}if(snapshot.quickFilter){addCheck(checks,"quick-filter","Quick filter has an accessible name",(snapshot.quickFilter.ariaLabel?.trim().length??0)>0,snapshot.quickFilter.ariaLabel??"(missing)","aria-label")}if(snapshot.pagination){const hasNames=(snapshot.pagination.prevAriaLabel?.trim().length??0)>0&&(snapshot.pagination.nextAriaLabel?.trim().length??0)>0&&(snapshot.pagination.pageSizeAriaLabel?.trim().length??0)>0;addCheck(checks,"pagination","Pagination controls have accessible names",hasNames,[snapshot.pagination.prevAriaLabel??"(missing prev)",snapshot.pagination.nextAriaLabel??"(missing next)",snapshot.pagination.pageSizeAriaLabel??"(missing page size)"].join(" | "),"prev, next, and page-size labels")}if(snapshot.loading||snapshot.root.ariaBusy!==void 0){const expectedBusy=snapshot.loading?"true":"false";addCheck(checks,"busy-state","aria-busy mirrors loading state",snapshot.root.ariaBusy===expectedBusy,snapshot.root.ariaBusy??"(missing)",expectedBusy)}return{screenReader:"NVDA",mode:"focus",rowCount,colCount,activeCell,steps,checks}}export function formatNvdaGridTranscript(transcript){const lines=["NVDA focus-mode transcript",`rows: ${transcript.rowCount??"unknown"} | columns: ${transcript.colCount??"unknown"}`,`activeCell: ${transcript.activeCell?JSON.stringify(transcript.activeCell):"(missing)"}`,"","Steps"];for(const step of transcript.steps){lines.push(`${step.id}`);lines.push(`  action: ${step.action}`);lines.push(`  target: ${step.target}`);lines.push(`  hears: ${step.announcement}`)}lines.push("","Checks");for(const check of transcript.checks){lines.push(`${check.pass?"PASS":"FAIL"} ${check.id} - ${check.label}`);if(!check.pass){lines.push(`  actual: ${check.actual}`);lines.push(`  expected: ${check.expected}`)}}return lines.join("\n")}export function buildVoiceOverGridTranscript(snapshot){const rowCount=toCount(snapshot.root.ariaRowcount);const colCount=toCount(snapshot.root.ariaColcount);const activeCell=snapshot.activeCell;const steps=[];const checks=[];const gridEntry=formatVoiceOverGridEntry(snapshot,rowCount,colCount);steps.push({id:"enter-grid",action:"VO+Right",target:snapshot.root.ariaLabel?.trim()||"grid",announcement:gridEntry,source:"grid"});steps.push({id:"active-cell",action:"VO+Right",target:"active grid cell",announcement:voiceOverCellAnnouncement(snapshot,activeCell),source:"cell"});if(activeCell&&(colCount===null||activeCell.col+1<colCount)){const next={row:activeCell.row,col:activeCell.col+1};steps.push({id:"quick-nav-right",action:"Quick Nav Right",target:headerLabel(snapshot,next.col),announcement:voiceOverCellAnnouncement(snapshot,next),source:"cell"})}if(activeCell&&(rowCount===null||activeCell.row+2<rowCount)){const next={row:activeCell.row+1,col:activeCell.col};steps.push({id:"quick-nav-down",action:"Quick Nav Down",target:headerLabel(snapshot,next.col),announcement:voiceOverCellAnnouncement(snapshot,next),source:"cell"})}const sorted=sortedHeader(snapshot);if(sorted){steps.push({id:"sorted-header",action:"VO+Command+H",target:headerLabel(snapshot,sorted.colIndex),announcement:`${headerLabel(snapshot,sorted.colIndex)}, column ${sorted.colIndex+1}, column header, `+voiceOverSortPhrase(sorted.cell.ariaSort),source:"header"})}if(snapshot.quickFilter){const label=snapshot.quickFilter.ariaLabel?.trim()||"Quick filter";steps.push({id:"quick-filter",action:"VO+Right",target:label,announcement:`${label}, edit text`,source:"quick-filter"})}if(snapshot.pagination){const pageSize=snapshot.pagination.pageSizeAriaLabel?.trim()||"Rows per page";const prev=snapshot.pagination.prevAriaLabel?.trim()||"Previous page";const next=snapshot.pagination.nextAriaLabel?.trim()||"Next page";steps.push({id:"pagination",action:"VO+Right through pagination",target:"pagination controls",announcement:`${pageSize}, pop up button; ${prev}, button; ${next}, button`,source:"pagination"})}if(snapshot.loading||snapshot.root.ariaBusy!==void 0){const busy=snapshot.root.ariaBusy==="true"?"busy":"not busy";steps.push({id:"busy-state",action:"Loading state changes",target:"grid root",announcement:`${snapshot.root.ariaLabel?.trim()||"Data grid"}, ${busy}`,source:"busy"})}addVoiceOverCheck(checks,"grid-role",'Grid root exposes role="grid"',snapshot.root.role==="grid"&&gridEntry.includes("grid"),snapshot.root.role??"(missing)","grid");addVoiceOverCheck(checks,"row-count","VoiceOver entry includes row count",rowCount!==null&&gridEntry.includes(`${rowCount} rows`),rowCount===null?"(missing)":`${rowCount}`,"finite aria-rowcount");addVoiceOverCheck(checks,"col-count","VoiceOver entry includes column count",colCount!==null&&gridEntry.includes(`${colCount} columns`),colCount===null?"(missing)":`${colCount}`,"finite aria-colcount");addVoiceOverCheck(checks,"active-cell","Focused cell announces label, row, column, and grid cell",activeCell!==null&&/row \d+ column \d+/.test(voiceOverCellAnnouncement(snapshot,activeCell)),activeCell===null?"(missing)":JSON.stringify(activeCell),"active body grid cell");addVoiceOverCheck(checks,"header-label","Focused cell announcement starts with its column label",activeCell!==null&&voiceOverCellAnnouncement(snapshot,activeCell).startsWith(headerLabel(snapshot,activeCell.col)),activeCell===null?"(missing)":headerLabel(snapshot,activeCell.col),"non-empty columnheader aria-label");if(sorted){addVoiceOverCheck(checks,"sort-state","Sorted header announcement includes aria-sort state",voiceOverSortPhrase(sorted.cell.ariaSort)!=="not sorted",sorted.cell.ariaSort??"(missing)","ascending, descending, or other")}if(snapshot.quickFilter){addVoiceOverCheck(checks,"quick-filter","Quick filter has an accessible name",(snapshot.quickFilter.ariaLabel?.trim().length??0)>0,snapshot.quickFilter.ariaLabel??"(missing)","aria-label")}if(snapshot.pagination){const hasNames=(snapshot.pagination.prevAriaLabel?.trim().length??0)>0&&(snapshot.pagination.nextAriaLabel?.trim().length??0)>0&&(snapshot.pagination.pageSizeAriaLabel?.trim().length??0)>0;addVoiceOverCheck(checks,"pagination","Pagination controls have accessible names",hasNames,[snapshot.pagination.prevAriaLabel??"(missing prev)",snapshot.pagination.nextAriaLabel??"(missing next)",snapshot.pagination.pageSizeAriaLabel??"(missing page size)"].join(" | "),"prev, next, and page-size labels")}if(snapshot.loading||snapshot.root.ariaBusy!==void 0){const expectedBusy=snapshot.loading?"true":"false";addVoiceOverCheck(checks,"busy-state","aria-busy mirrors loading state",snapshot.root.ariaBusy===expectedBusy,snapshot.root.ariaBusy??"(missing)",expectedBusy)}return{screenReader:"VoiceOver",mode:"quick-nav",rowCount,colCount,activeCell,steps,checks}}export function formatVoiceOverGridTranscript(transcript){const lines=["VoiceOver quick-nav transcript",`rows: ${transcript.rowCount??"unknown"} | columns: ${transcript.colCount??"unknown"}`,`activeCell: ${transcript.activeCell?JSON.stringify(transcript.activeCell):"(missing)"}`,"","Steps"];for(const step of transcript.steps){lines.push(`${step.id}`);lines.push(`  action: ${step.action}`);lines.push(`  target: ${step.target}`);lines.push(`  hears: ${step.announcement}`)}lines.push("","Checks");for(const check of transcript.checks){lines.push(`${check.pass?"PASS":"FAIL"} ${check.id} - ${check.label}`);if(!check.pass){lines.push(`  actual: ${check.actual}`);lines.push(`  expected: ${check.expected}`)}}return lines.join("\n")}

package/dist/collection/components/grid/core/a11y/snapshot.js

@@ -0,0 +1 @@
+export const A11Y_RESOLVED_THEME_TOKENS=["--sy-grid-bg","--sy-grid-text","--sy-grid-row-bg-odd","--sy-grid-row-bg-even","--sy-grid-header-color","--sy-grid-header-bg","--sy-grid-pagination-color","--sy-grid-pagination-bg","--sy-grid-empty-state-color","--sy-grid-empty-state-bg","--sy-grid-active-cell-outline","--sy-grid-viewport-focus-outline"];function attrToNumber(el,name){const v=el.getAttribute(name);if(v===null)return Number.NaN;const n=Number(v);return Number.isFinite(n)?n:Number.NaN}function attrToTabindex(el){const v=el.getAttribute("tabindex");if(v===null)return void 0;const n=Number(v);return Number.isFinite(n)?n:void 0}function snapshotCell(el){return{role:el.getAttribute("role"),ariaColindex:attrToNumber(el,"aria-colindex"),ariaSort:el.getAttribute("aria-sort"),ariaLabel:el.getAttribute("aria-label"),tabindex:attrToTabindex(el)}}function snapshotRow(el){const cellEls=el.querySelectorAll('[role="columnheader"], [role="gridcell"]');const cells=[];for(let i=0;i<cellEls.length;i++){cells.push(snapshotCell(cellEls[i]))}return{role:el.getAttribute("role"),ariaRowindex:attrToNumber(el,"aria-rowindex"),ariaSelected:el.getAttribute("aria-selected"),cells}}export function gridA11ySnapshot(host,extras={}){let gridRoot=null;if(host.getAttribute("role")==="grid"){gridRoot=host}else{gridRoot=host.querySelector('[role="grid"]')}const root=gridRoot?{role:gridRoot.getAttribute("role"),ariaRowcount:gridRoot.getAttribute("aria-rowcount"),ariaColcount:gridRoot.getAttribute("aria-colcount"),ariaBusy:gridRoot.getAttribute("aria-busy")??void 0,ariaLabel:gridRoot.getAttribute("aria-label")}:{role:null,ariaRowcount:null,ariaColcount:null,ariaBusy:void 0,ariaLabel:null};const rowgroupScope=gridRoot??host;const rowgroupEls=rowgroupScope.querySelectorAll('[role="rowgroup"]');const rowEls=rowgroupScope.querySelectorAll('[role="row"]');const rows=[];for(let i=0;i<rowEls.length;i++){rows.push(snapshotRow(rowEls[i]))}let quickFilterEl=host.querySelector("[data-sy-grid-quick-filter]");if(!quickFilterEl){quickFilterEl=host.querySelector(".sy-grid__quick-filter-input")}const quickFilter=quickFilterEl?{ariaLabel:quickFilterEl.getAttribute("aria-label")}:null;let paginationEl=host.querySelector("[data-sy-grid-pagination]");if(!paginationEl){paginationEl=host.querySelector(".sy-grid__pagination")}let pagination=null;if(paginationEl){const prev=paginationEl.querySelector('[data-direction="prev"]')??paginationEl.querySelector(".sy-grid__pagination-button--prev");const next=paginationEl.querySelector('[data-direction="next"]')??paginationEl.querySelector(".sy-grid__pagination-button--next");const pageSize=paginationEl.querySelector("[data-page-size]")??paginationEl.querySelector(".sy-grid__page-size");pagination={prevAriaLabel:prev?prev.getAttribute("aria-label"):null,nextAriaLabel:next?next.getAttribute("aria-label"):null,hasPageSize:pageSize!==null,pageSizeAriaLabel:pageSize?pageSize.getAttribute("aria-label"):null}}const filterButtonEls=[];const dataFilterEls=host.querySelectorAll("[data-column-filter]");for(let i=0;i<dataFilterEls.length;i++){filterButtonEls.push(dataFilterEls[i])}if(filterButtonEls.length===0){const cssFilterEls=host.querySelectorAll(".sy-grid__filter-icon");for(let i=0;i<cssFilterEls.length;i++){filterButtonEls.push(cssFilterEls[i])}}const filterButtons=filterButtonEls.map(el=>({ariaLabel:el.getAttribute("aria-label")}));let activeCell=extras.activeCell??null;if(extras.activeCell===void 0){outer:for(const row of rows){if(row.ariaRowindex===1)continue;for(const cell of row.cells){if(cell.tabindex===0&&Number.isFinite(row.ariaRowindex)){activeCell={row:row.ariaRowindex-2,col:cell.ariaColindex-1};break outer}}}}return{root,rowgroupCount:rowgroupEls.length,rows,quickFilter,pagination,filterButtons,loading:extras.loading===true,activeCell,resolvedThemeTokens:extras.resolvedThemeTokens}}

package/dist/collection/components/grid/core/api/base-types.js

@@ -0,0 +1 @@
+export{};

package/dist/collection/components/grid/core/api/contracts.js

@@ -0,0 +1 @@
+export function defineSyGridBindings(bindings){return bindings}export function getSyGridApi(element){if(element===null||typeof element!=="object"){throw new TypeError("getSyGridApi expected a connected <sy-grid> DOM element.")}const candidate=element;const tagName=typeof candidate.tagName==="string"?candidate.tagName.toLowerCase():null;if(candidate.nodeType!==1||candidate.localName!=="sy-grid"||tagName!=="sy-grid"||candidate.isConnected!==true||candidate.ownerDocument===null||typeof candidate.ownerDocument!=="object"||typeof candidate.getApi!=="function"||typeof candidate.getColumn!=="function"||typeof candidate.addEventListener!=="function"||typeof candidate.removeEventListener!=="function"||typeof candidate.dispatchEvent!=="function"){throw new TypeError("getSyGridApi expected a connected <sy-grid> DOM element.")}return element}

package/dist/collection/components/grid/core/api/index.js

@@ -0,0 +1 @@
+export*from"./base-types.js";export*from"./contracts.js";export*from"./live-object-model.js";

package/dist/collection/components/grid/core/api/live-object-model.js

@@ -0,0 +1 @@
+const KIND_INDEX={column:0,columnGroup:1,row:2};const MUTATION_DIFFS={"column:setWidth":[["column","widthChanged","actualWidth"]],"column:setVisible":[["column","visibilityChanged","visible"],["columnGroup","visibilityChanged","displayed"]],"column:setPinned":[["column","pinnedChanged","pinned"]],"column:setSort":[["column","sortChanged","sort"]],"column:setAggFunc":[["column","aggregationChanged","aggFunc"]],"columnGroup:setExpanded":[["columnGroup","expandedChanged","expanded"],["columnGroup","visibilityChanged","displayed"],["column","visibilityChanged","visible"]],"row:setSelected":[["row","selectionChanged","selected"]],"row:setExpanded":[["row","expandedChanged","expanded"]]};class LiveRef{id;model;#valid=true;#reason=null;generation=0;listeners=new Map;constructor(id,model){this.id=id;this.model=model}isValid(){return this.#valid}getInvalidationReason(){return this.#reason}addEventListener(type,listener){if(!this.#valid)return()=>void 0;const set=this.listeners.get(type)??new Set;set.add(listener);this.listeners.set(type,set);return()=>this.removeEventListener(type,listener)}removeEventListener(type,listener){const set=this.listeners.get(type);set?.delete(listener);if(set?.size===0)this.listeners.delete(type)}dispatch(event){for(const listener of[...this.listeners.get(event.type)??[],...this.listeners.get("*")??[]]){try{listener(event)}catch(error){this.model?.reportListenerError(error,event)}}}markInvalid(reason){if(!this.#valid)return false;this.#valid=false;this.#reason=reason;this.generation+=1;return true}dispatchInvalidation(reason){const model=this.model;try{model?.publishInvalidation(this,reason)}finally{this.listeners.clear();this.model=null}}ensureValid(){if(!this.#valid||!this.model)throw new Error(`Grid ${this.kind} ref "${String(this.id)}" is invalid (${this.#reason}).`)}state(){return this.model?.snapshot(this.kind,this.id)??null}read(field,fallback){return this.state()?.[field]??fallback}mutate(type,detail={}){this.ensureValid();return this.model.run(this,{...detail,kind:this.kind,id:this.id,type})}}class ColumnRef extends LiveRef{kind="column";getDefinition(){return this.read("definition",null)}getActualWidth(){return this.read("actualWidth",null)}isVisible(){return this.read("visible",false)}getPinned(){return this.read("pinned",null)}getSort(){return this.read("sort",null)}getAggFunc(){return this.read("aggFunc",null)}isPivotActive(){return this.read("pivotActive",false)}getParent(){const id=this.read("parentId",null);return id?this.model?.getColumnGroup(id)??null:null}setWidth(value){if(!Number.isFinite(value)||value<=0)return Promise.resolve(false);return this.mutate("setWidth",{value})}setVisible(value){return this.mutate("setVisible",{value})}setPinned(value){return this.mutate("setPinned",{value})}setSort(value,options={}){return this.mutate("setSort",{value,multi:options.multi===true})}setAggFunc(value){return this.mutate("setAggFunc",{value})}async getFilterModel(){if(!this.isValid())return null;const hook=this.model?.adapterColumnFilter();if(!hook)return null;return hook.getModel(this.id)}async setFilterModel(model){if(!this.isValid())return false;const hook=this.model?.adapterColumnFilter();if(!hook)return false;return hook.setModel(this.id,model)}}class ColumnGroupRef extends LiveRef{kind="columnGroup";getDefinition(){return this.read("definition",null)}getChildren(){return this.read("childIds",[]).flatMap(item=>{const ref=item.kind==="column"?this.model?.getColumn(item.id):this.model?.getColumnGroup(item.id);return ref?[ref]:[]})}getLeafColumns(){return this.read("leafIds",[]).flatMap(id=>{const ref=this.model?.getColumn(id);return ref?[ref]:[]})}getParent(){const id=this.read("parentId",null);return id?this.model?.getColumnGroup(id)??null:null}isExpanded(){return this.read("expanded",false)}isPadding(){return this.read("padding",false)}isDisplayed(){return this.read("displayed",false)}setExpanded(value){return this.mutate("setExpanded",{value})}}class RowRef extends LiveRef{kind="row";getSourceIndex(){return this.read("sourceIndex",null)}getDisplayIndex(){return this.read("displayIndex",null)}getData(){return this.read("data",null)}getParent(){const id=this.read("parentId",null);return id===null||id===void 0?null:this.model?.getRow(id)??null}getChildren(){return this.read("childIds",[]).flatMap(id=>{const ref=this.model?.getRow(id);return ref?[ref]:[]})}isGroup(){return this.read("group",false)}isLeaf(){return this.read("leaf",false)}isMaster(){return this.read("master",false)}isDetail(){return this.read("detail",false)}getLevel(){return this.read("level",0)}getRoute(){return this.read("route",[])}isSelected(){return this.read("selected",false)}isExpanded(){return this.read("expanded",false)}setSelected(value){return this.#run("setSelected",value)}setExpanded(value){return this.#run("setExpanded",value)}setData(value){return this.#run("setData",value)}updateData(value){return this.#run("updateData",value)}setValue(field,value){return this.mutate("setValue",{field,value})}setHeight(value){if(value!==null&&(!Number.isFinite(value)||value<=0))return Promise.resolve(false);return this.#run("setHeight",value)}focus(field){return this.mutate("focus",{field})}startEditing(field){return this.mutate("startEditing",{field})}#run(type,value){return this.mutate(type,{value})}}export class GridLiveObjectModel{#adapter;adapterColumnFilter(){return this.#adapter.columnFilter??null}#refs=[new Map,new Map,new Map];states=[new Map,new Map,new Map];#sourceRowOrder=[];#displayedRowOrder=[];#displayedRowByIndex=new Map;#lastRowsInput=null;pendingMutations=new WeakMap;#sequence=0;constructor(adapter){this.#adapter=adapter;this.reconcile()}reconcile(reason="removed"){if(!this.#adapter.isConnected())return this.invalidateAll("disconnected");const columns=new Map(this.#adapter.columns().map(item=>[item.id,item]));const groups=new Map(this.#adapter.columnGroups().map(item=>[item.id,item]));const rowsInput=this.#adapter.rows();const reuseRows=rowsInput===this.#lastRowsInput&&reason!=="data-replaced";const rows=reuseRows?this.states[2]:new Map(rowsInput.map(item=>[item.id,item]));const next=[columns,groups,rows];const removed=[];for(let index=0;index<3;index+=1){if(index!==2||!reuseRows){removed.push(...this.#detachMissing(this.#refs[index],next[index]))}}this.states[0]=columns;this.states[1]=groups;if(!reuseRows)this.#installRows(rows,rowsInput);this.#invalidateDetached(removed,reason)}invalidateAll(reason){const removed=this.#refs.flatMap(refs=>[...refs.values()]);for(const refs of this.#refs)refs.clear();this.states[0].clear();this.states[1].clear();this.#installRows(new Map,null);this.#invalidateDetached(removed,reason)}invalidateRows(reason){const removed=[...this.#refs[2].values()];this.#refs[2].clear();this.#installRows(new Map,null);this.#invalidateDetached(removed,reason)}invalidateRow(id,reason){if(!this.states[2].has(id)&&!this.#refs[2].has(id))return;const rows=new Map(this.states[2]);rows.delete(id);const removed=this.#refs[2].get(id);this.#refs[2].delete(id);this.#installRows(rows,null);if(removed)this.#invalidateDetached([removed],reason)}getColumn(id){return this.#resolveRef("column",id)}getColumns(){return[...this.states[0].keys()].map(id=>this.getColumn(String(id))).filter(Boolean)}getColumnGroup(id){return this.#resolveRef("columnGroup",id)}getColumnGroups(){return[...this.states[1].keys()].map(id=>this.getColumnGroup(String(id))).filter(Boolean)}getRow(id){return this.#resolveRef("row",id)}getDisplayedRowAtIndex(index){const id=this.#displayedRowByIndex.get(index);return id===void 0?null:this.getRow(id)}forEachRow(callback){this.#iterate("sourceIndex",callback)}forEachDisplayedRow(callback){this.#iterate("displayIndex",callback)}snapshot(kind,id){return this.states[KIND_INDEX[kind]].get(id)??null}async run(ref,action){const controller=new AbortController;const pending=this.pendingMutations.get(ref)??new Set;pending.add(controller);this.pendingMutations.set(ref,pending);try{const startedAt=ref.generation;const before=this.#captureMutationDiff(action);const result=await this.#adapter.mutate(action,controller.signal);if(controller.signal.aborted||!result.applied)return false;const uninterrupted=ref.generation===startedAt&&this.#isCurrentRef(ref);this.reconcile();if(controller.signal.aborted||!uninterrupted||ref.generation!==startedAt||!this.#isCurrentRef(ref))return false;this.#emitPublications(this.#mutationPublications(action,result,before));return true}catch(error){if(controller.signal.aborted)return false;throw error}finally{pending.delete(controller);if(pending.size===0)this.pendingMutations.delete(ref)}}publish(kind,id,type,source,detail={}){return this.publishBatch([{kind,id,type,source,detail}])[0]}publishBatch(changes){if(changes.length===0)return[];this.reconcile();return this.#emitPublications(changes)}#emitPublications(changes){return changes.map(change=>this.#emit(change))}reportListenerError(error,event){if(this.#adapter.reportListenerError){this.#adapter.reportListenerError(error,event);return}console.error("[Syidax] sy-grid: live object listener threw; mutation continued.",error)}publishInvalidation(ref,reason){const source=reason==="disconnected"?"disconnect":reason==="definitions-replaced"?"columnDefs":reason==="data-replaced"?"rowData":"state";this.#emit({kind:ref.kind,id:ref.id,type:"invalidated",source,detail:{reason}},ref)}#mintMutationId(){const minted=this.#adapter.mintMutationId?.();if(minted!==void 0)return minted;this.#sequence+=1;return`grid-mutation-${this.#sequence}`}#emit(change,target){const{kind,id,type,source,detail={}}=change;const event=Object.freeze({...detail,mutationId:this.#mintMutationId(),kind,id,type,source,timestamp:Date.now()});(target??this.#refs[KIND_INDEX[kind]].get(id))?.dispatch(event);this.#adapter.emitGridEvent(event);return event}#detachMissing(refs,next){const removed=[];for(const[id,ref]of refs){if(!next.has(id)){refs.delete(id);removed.push(ref)}}return removed}#invalidateDetached(refs,reason){const pending=refs.filter(ref=>ref.markInvalid(reason));for(const ref of pending){for(const controller of this.pendingMutations.get(ref)??[])controller.abort()}let firstError;let failed=false;for(const ref of pending){try{ref.dispatchInvalidation(reason)}catch(error){if(!failed)firstError=error;failed=true}}if(failed)throw firstError}#isCurrentRef(ref){return ref.isValid()&&this.#refs[KIND_INDEX[ref.kind]].get(ref.id)===ref}#resolveRef(kind,id){const index=KIND_INDEX[kind];if(!this.states[index].has(id))return null;let ref=this.#refs[index].get(id);if(!ref){ref=kind==="column"?new ColumnRef(id,this):kind==="columnGroup"?new ColumnGroupRef(id,this):new RowRef(id,this);this.#refs[index].set(id,ref)}return ref}#captureMutationDiff(action){return(MUTATION_DIFFS[`${action.kind}:${action.type}`]??[]).map(([kind,type,field])=>{const before=new Map;for(const[id,snapshot]of this.states[KIND_INDEX[kind]]){before.set(id,this.#diffValue(snapshot,field))}return[kind,type,field,before]})}#mutationPublications(action,result,lanes){const primary={kind:action.kind,id:action.id,type:result.eventType,source:"api",detail:result};const publications=[primary];for(const[kind,type,field,values]of lanes){const afterState=this.states[KIND_INDEX[kind]];for(const[id,before]of values){const snapshot=afterState.get(id);if(!snapshot)continue;const after=this.#diffValue(snapshot,field);const same=Object.is(before,after)||field==="sort"&&before?.direction===after?.direction&&before?.index===after?.index;if(same||kind===primary.kind&&Object.is(id,primary.id)&&type===primary.type)continue;publications.push({kind,id,type,source:"api",detail:{before,after}})}}return publications}#diffValue(snapshot,field){const value=snapshot[field];if(field!=="sort"||value===null||typeof value!=="object")return value;const sort=value;return{direction:sort.direction,index:sort.index}}#installRows(rows,input){this.states[2]=rows;[this.#sourceRowOrder,this.#displayedRowOrder,this.#displayedRowByIndex]=this.#indexRows(rows);this.#lastRowsInput=input}#indexRows(rows){const source=[];const displayed=[];let sourceAlreadyOrdered=true;let previousSourceIndex=Number.NEGATIVE_INFINITY;let directDisplayIndex=true;let maxDisplayIndex=-1;for(const snapshot of rows.values()){const row=snapshot;if(row.sourceIndex!==null){sourceAlreadyOrdered&&=row.sourceIndex>=previousSourceIndex;previousSourceIndex=row.sourceIndex;source.push(row)}if(row.displayIndex!==null){directDisplayIndex&&=Number.isSafeInteger(row.displayIndex)&&row.displayIndex>=0;maxDisplayIndex=Math.max(maxDisplayIndex,row.displayIndex);displayed.push(row)}}if(!sourceAlreadyOrdered){source.sort((a,b)=>(a.sourceIndex??0)-(b.sourceIndex??0))}const displayedByIndex=new Map;let displayedOrder;const directIndexLimit=Math.max(1024,displayed.length*4);if(directDisplayIndex&&maxDisplayIndex<=directIndexLimit){const slots=new Array(maxDisplayIndex+1);for(const row of displayed){const index=row.displayIndex;const slot=slots[index];if(slot===void 0){slots[index]=row.id;displayedByIndex.set(index,row.id)}else if(Array.isArray(slot)){slot.push(row.id)}else{slots[index]=[slot,row.id]}}displayedOrder=[];for(const slot of slots){if(slot===void 0)continue;if(Array.isArray(slot))displayedOrder.push(...slot);else displayedOrder.push(slot)}}else{displayed.sort((a,b)=>(a.displayIndex??0)-(b.displayIndex??0));displayedOrder=displayed.map(row=>{if(!displayedByIndex.has(row.displayIndex)){displayedByIndex.set(row.displayIndex,row.id)}return row.id})}return[source.map(row=>row.id),displayedOrder,displayedByIndex]}#iterate(index,callback){const order=index==="sourceIndex"?this.#sourceRowOrder:this.#displayedRowOrder;const snapshot=order.map(id=>this.getRow(id)).filter(Boolean);for(const row of snapshot)callback(row)}}

package/dist/collection/components/grid/core/audit/audit-export.js

@@ -0,0 +1 @@
+import{escapeCsvSpreadsheetCell}from"../export/csv.js";export const AUDIT_CSV_COLUMNS=["seq","ts","kind","source","txId","rowId","field","oldValue","newValue","added","updated","removed","selectedCount","addedIds","removedIds","action","undoDepth","redoDepth"];function childPath(path,key){if(typeof key==="number")return`${path}[${key}]`;return/^[A-Za-z_$][\w$]*$/.test(key)?`${path}.${key}`:`${path}[${JSON.stringify(key)}]`}export function normalizeAuditJsonValue(value){const ancestors=new Map;const normalize=(input,path)=>{if(input===null||typeof input==="string"||typeof input==="boolean")return input;if(typeof input==="number"){if(Number.isFinite(input))return input;return`[Number:${Number.isNaN(input)?"NaN":input>0?"Infinity":"-Infinity"}]`}if(typeof input==="bigint")return`[BigInt:${input.toString()}]`;if(typeof input==="undefined")return"[Undefined]";if(typeof input==="symbol")return`[Symbol:${input.description??""}]`;if(typeof input==="function")return`[Function:${input.name||"anonymous"}]`;if(typeof input!=="object")return"[Unsupported:Value]";const circularPath=ancestors.get(input);if(circularPath!==void 0)return`[Circular:${circularPath}]`;if(input instanceof Date)return Number.isNaN(input.getTime())?null:input.toISOString();if(input instanceof RegExp)return`[RegExp:${input.toString()}]`;ancestors.set(input,path);try{if(input instanceof ArrayBuffer){return{$type:"ArrayBuffer",bytes:Array.from(new Uint8Array(input))}}if(ArrayBuffer.isView(input)){return{$type:input.constructor.name,bytes:Array.from(new Uint8Array(input.buffer,input.byteOffset,input.byteLength))}}if(input instanceof Map){return{$type:"Map",entries:Array.from(input.entries(),([key,item],index)=>[normalize(key,`${path}.entries[${index}][0]`),normalize(item,`${path}.entries[${index}][1]`)])}}if(input instanceof Set){return{$type:"Set",items:Array.from(input.values(),(item,index)=>normalize(item,`${path}.items[${index}]`))}}if(input instanceof Error){return{$type:input.name||"Error",message:input.message}}if(Array.isArray(input)){const out2=new Array(input.length);for(let i=0;i<input.length;i+=1){try{out2[i]=normalize(input[i],childPath(path,i))}catch{out2[i]="[Unserializable:ArrayItem]"}}return out2}const out=Object.create(null);let keys;try{keys=Object.keys(input)}catch{return"[Unserializable:Object]"}if(keys.length===0&&Object.getPrototypeOf(input)!==Object.prototype){return`[Unsupported:${input.constructor?.name??"Object"}]`}for(const key of keys){try{out[key]=normalize(input[key],childPath(path,key))}catch{out[key]="[Unserializable:Property]"}}return out}finally{ancestors.delete(input)}};return normalize(value,"$")}function cellString(value){if(value===null||value===void 0)return"";const normalized=normalizeAuditJsonValue(value);return typeof normalized==="object"&&normalized!==null?JSON.stringify(normalized):String(normalized)}function columnValue(entry,col){return entry[col]}export function auditEntriesToCsv(entries,options={}){const delimiter=options.delimiter??",";const newline=options.newline??"\r\n";const lines=[];if(options.header!==false){lines.push(AUDIT_CSV_COLUMNS.map(c=>escapeCsvSpreadsheetCell(c,delimiter)).join(delimiter))}for(const entry of entries){const cells=AUDIT_CSV_COLUMNS.map(col=>escapeCsvSpreadsheetCell(cellString(columnValue(entry,col)),delimiter));lines.push(cells.join(delimiter))}return lines.join(newline)}export function auditEntriesToJson(entries,pretty=false){return JSON.stringify(normalizeAuditJsonValue(entries),null,pretty?2:void 0)}

package/dist/collection/components/grid/core/audit/audit-log.js

@@ -0,0 +1 @@
+import{structuralClone}from"../utils/structural.js";const DEFAULT_MAX=1e3;function normalizeMaxEntries(value){const floored=Number.isFinite(value)?Math.floor(value):0;return floored>0?floored:DEFAULT_MAX}export class AuditLog{maxEntries;now;buf=[];seqCounter=0;recordedCount=0;constructor(options={}){this.maxEntries=normalizeMaxEntries(options.maxEntries??DEFAULT_MAX);this.now=options.now??Date.now}record(input){this.seqCounter+=1;this.recordedCount+=1;const entry=structuralClone({...input,seq:this.seqCounter,ts:input.ts??this.now()});this.buf.push(entry);if(this.buf.length>this.maxEntries)this.buf.splice(0,this.buf.length-this.maxEntries);return structuralClone(entry)}entries(filter){if(filter===void 0)return structuralClone(this.buf);const kinds=filter.kind===void 0?null:new Set(Array.isArray(filter.kind)?filter.kind:[filter.kind]);const sources=filter.source===void 0?null:new Set(Array.isArray(filter.source)?filter.source:[filter.source]);return structuralClone(this.buf.filter(e=>(kinds===null||kinds.has(e.kind))&&(sources===null||sources.has(e.source))&&(filter.sinceSeq===void 0||e.seq>=filter.sinceSeq)&&(filter.sinceTs===void 0||e.ts>=filter.sinceTs)))}size(){return this.buf.length}totalRecorded(){return this.recordedCount}last(){return this.buf.length>0?structuralClone(this.buf[this.buf.length-1]):null}resize(maxEntries){this.maxEntries=normalizeMaxEntries(maxEntries);if(this.buf.length>this.maxEntries)this.buf.splice(0,this.buf.length-this.maxEntries)}clear(){this.buf=[]}}

package/dist/collection/components/grid/core/brand/grid-brand.js

@@ -0,0 +1,2 @@
+import{BRAND_FEATURE,decideBrand,describeBrandLogoProblem,parseBrandLogo}from"../../../_shared/brand/brand-logo.js";export const GRID_BRAND_FEATURE=BRAND_FEATURE.grid;export const GRID_BRAND_MEMBER="brandLogo";export class GridBrand{value=void 0;request=parseBrandLogo(void 0);last=null;requestFor(value){if(value!==this.value){this.value=value;this.request=parseBrandLogo(value)}return this.request}needsEntitlement(value){const kind=this.requestFor(value).kind;return kind==="none"||kind==="custom"}decide(value,entitlement,pendingTimedOut=false){const request=this.requestFor(value);const pro=request.kind==="none"||request.kind==="custom";const state=pro?entitlement():void 0;const timedOut=pro&&state==="pending"&&pendingTimedOut===true;const last=this.last;if(last!==null&&last.request===request&&last.state===state&&last.timedOut===timedOut)return last.decision;const decision=decideBrand({requested:request,entitlementState:state,pendingTimedOut:timedOut});this.last={request,state,timedOut,decision};return decision}}const reported=new Set;export function gridBrandProblem(decision,tag="sy-grid"){const reason=decision?.invalid;if(reason===void 0)return null;const key=`${tag}
+${reason}`;if(reported.has(key))return null;reported.add(key);return`[Syidax] <${tag}> ${describeBrandLogoProblem(reason)}`}

package/dist/collection/components/grid/core/build-tier.js

@@ -0,0 +1 @@
+export const GRID_BUILD_TIER="community";export const GRID_FORMULA_WASM_DIAGNOSTICS=true;

package/dist/collection/components/grid/core/cell/cell-class-rules.js

@@ -0,0 +1 @@
+import{evaluateGridExpression,parseGridExpression,warnGridExpression}from"./expression-runtime.js";const WARN_PREFIX="[Syidax] sy-grid:";function isWhitespace(c){return c===" "||c==="	"||c==="\n"||c==="\r"||c==="\f"||c==="\v"}export function parseCellClassRuleExpression(expr){return parseGridExpression(expr,true)}export function evaluateCellClassRule(rule,params){if(typeof rule==="function"){try{return Boolean(rule(params))}catch(err){warnGridExpression("RULE-FN",params.colId,params.node.rowIndex,void 0,err);return false}}if(typeof rule==="string"){let parsed;try{parsed=parseCellClassRuleExpression(rule)}catch(err){const msg=err instanceof Error?err.message:String(err);warnGridExpression("RULE-PARSE",params.colId,params.node.rowIndex,msg);return false}const lookup=name=>{if(name==="value")return params.value;const data=params.data;if(data===null||data===void 0||typeof data!=="object"){return void 0}return data[name]};try{return Boolean(evaluateGridExpression(parsed.ast,lookup))}catch(err){warnGridExpression("RULE-EVAL",params.colId,params.node.rowIndex,void 0,err);return false}}warnGridExpression("RULE-TYPE",params.colId,params.node.rowIndex);return false}function isValidClassName(name){if(typeof name!=="string")return false;if(name.length===0)return false;for(let i=0;i<name.length;i++){if(isWhitespace(name[i]))return false}return true}function splitOnWhitespace(s){const out=[];let buf="";for(let i=0;i<s.length;i++){const c=s[i];if(isWhitespace(c)){if(buf.length>0){out.push(buf);buf=""}continue}buf+=c}if(buf.length>0)out.push(buf);return out}export function applyCellClassRules(input){if(input==null||typeof input!=="object"){console.warn(`${WARN_PREFIX} applyCellClassRules called with non-object input.`);return""}const params={value:input.value,data:input.row,node:{rowIndex:input.rowIndex},colId:input.colId,formatted:input.formatted,colDef:input.colDef,context:input.context,api:input.api};const seen=new Set;const out=[];const warnedKeys=new Set;const base=input.cellClass;if(base!==void 0&&base!==null){if(typeof base==="function"){let result;try{result=base(params)}catch(err){if(!warnedKeys.has("__cellClass_fn")){warnedKeys.add("__cellClass_fn");console.warn(`${WARN_PREFIX} cellClass function threw on column "${input.colId}":`,err)}result=""}if(typeof result==="string"&&result.length>0){const tokens=splitOnWhitespace(result);for(let i=0;i<tokens.length;i++){pushIfValid(tokens[i],seen,out,warnedKeys,input.colId)}}else if(result!==""&&typeof result!=="string"){if(!warnedKeys.has("__cellClass_fn_shape")){warnedKeys.add("__cellClass_fn_shape");console.warn(`${WARN_PREFIX} cellClass function on column "${input.colId}" returned non-string; ignoring.`)}}}else if(typeof base==="string"){const tokens=splitOnWhitespace(base);for(let i=0;i<tokens.length;i++){pushIfValid(tokens[i],seen,out,warnedKeys,input.colId)}}else if(Array.isArray(base)){for(let i=0;i<base.length;i++){const entry=base[i];if(typeof entry==="string"){pushIfValid(entry,seen,out,warnedKeys,input.colId)}else{if(!warnedKeys.has("__cellClass_array_shape")){warnedKeys.add("__cellClass_array_shape");console.warn(`${WARN_PREFIX} cellClass array on column "${input.colId}" contains non-string; ignoring.`)}}}}else{if(!warnedKeys.has("__cellClass_shape")){warnedKeys.add("__cellClass_shape");console.warn(`${WARN_PREFIX} cellClass on column "${input.colId}" must be string | string[] | function; ignoring.`)}}}const rules=input.cellClassRules;if(rules!==void 0&&rules!==null&&typeof rules==="object"){const keys=Object.keys(rules);for(let i=0;i<keys.length;i++){const className=keys[i];if(!isValidClassName(className)){const warnKey=`name:${className}`;if(!warnedKeys.has(warnKey)){warnedKeys.add(warnKey);console.warn(`${WARN_PREFIX} cellClassRules class name on column "${input.colId}" is empty / contains whitespace; skipping.`)}continue}const rule=rules[className];if(rule===void 0||rule===null){const warnKey=`null:${className}`;if(!warnedKeys.has(warnKey)){warnedKeys.add(warnKey);console.warn(`${WARN_PREFIX} cellClassRules rule for "${className}" on column "${input.colId}" is null; skipping.`)}continue}const matched=evaluateCellClassRule(rule,params);if(matched){if(!seen.has(className)){seen.add(className);out.push(className)}}}}else if(rules!==void 0&&rules!==null){if(!warnedKeys.has("__rules_shape")){warnedKeys.add("__rules_shape");console.warn(`${WARN_PREFIX} cellClassRules on column "${input.colId}" must be an object; ignoring.`)}}return out.join(" ")}function pushIfValid(name,seen,out,warnedKeys,colId){if(!isValidClassName(name)){const warnKey=`name:${name}`;if(!warnedKeys.has(warnKey)){warnedKeys.add(warnKey);console.warn(`${WARN_PREFIX} cellClass entry on column "${colId}" is empty / contains whitespace; skipping ("${name}").`)}return}if(seen.has(name))return;seen.add(name);out.push(name)}

package/dist/collection/components/grid/core/cell/cell-style.js

@@ -0,0 +1 @@
+const WARN_PREFIX="[Syidax] sy-grid:";const CAMEL_CSS_KEY=/^[a-z][a-zA-Z0-9-]*$/;const KEBAB_CSS_KEY=/^-?[a-z][a-z0-9-]*$/;export function validateCssKey(key){if(typeof key!=="string")return false;if(key.length===0)return false;return CAMEL_CSS_KEY.test(key)||KEBAB_CSS_KEY.test(key)}function coerceCssValue(value){if(typeof value==="string"){if(value.length===0)return null;return value}if(typeof value==="number"){if(!Number.isFinite(value))return null;return String(value)}return null}function applyObjectSpec(spec,acc,warnedKeys,colId){const keys=Object.keys(spec);for(let i=0;i<keys.length;i++){const key=keys[i];if(!validateCssKey(key)){const warnKey=`key:${key}`;if(!warnedKeys.has(warnKey)){warnedKeys.add(warnKey);console.warn(`${WARN_PREFIX} cellStyle key on column "${colId}" is not a valid CSS property name; skipping ("${key}").`)}continue}const raw=spec[key];const coerced=coerceCssValue(raw);if(coerced===null){const warnKey=`value:${key}`;if(!warnedKeys.has(warnKey)){warnedKeys.add(warnKey);console.warn(`${WARN_PREFIX} cellStyle value on column "${colId}" key "${key}" is not a finite string / number; skipping.`)}continue}acc[key]=coerced}}function applyFunctionSpec(fn,params,acc,warnedKeys,colId){let result;try{result=fn(params)}catch(err){if(!warnedKeys.has("__fn_throw")){warnedKeys.add("__fn_throw");console.warn(`${WARN_PREFIX} cellStyle function on column "${colId}" threw:`,err)}return}if(result===null||result===void 0){return}if(typeof result!=="object"||Array.isArray(result)){if(!warnedKeys.has("__fn_shape")){warnedKeys.add("__fn_shape");console.warn(`${WARN_PREFIX} cellStyle function on column "${colId}" must return an object / null / undefined; ignoring.`)}return}applyObjectSpec(result,acc,warnedKeys,colId)}function applyArraySpec(arr,params,acc,warnedKeys,colId){for(let i=0;i<arr.length;i++){const entry=arr[i];if(entry===null||entry===void 0){continue}if(typeof entry==="function"){applyFunctionSpec(entry,params,acc,warnedKeys,colId);continue}if(Array.isArray(entry)){applyArraySpec(entry,params,acc,warnedKeys,colId);continue}if(typeof entry==="object"){applyObjectSpec(entry,acc,warnedKeys,colId);continue}if(!warnedKeys.has(`__arr_entry:${i}`)){warnedKeys.add(`__arr_entry:${i}`);console.warn(`${WARN_PREFIX} cellStyle array entry on column "${colId}" must be object / function / array; ignoring (index ${i}).`)}}}export function mergeCellStyles(specs){const out={};if(!Array.isArray(specs))return out;for(let i=0;i<specs.length;i++){const spec=specs[i];if(spec===null||spec===void 0)continue;if(typeof spec!=="object")continue;const keys=Object.keys(spec);for(let j=0;j<keys.length;j++){const key=keys[j];const value=spec[key];if(typeof value!=="string")continue;out[key]=value}}return out}export function applyCellStyle(input){const empty={style:{},meta:{kind:"none",appliedKeys:0}};if(input===null||input===void 0||typeof input!=="object"){console.warn(`${WARN_PREFIX} applyCellStyle called with non-object input.`);return empty}const spec=input.cellStyle;if(spec===void 0||spec===null){return empty}const colId=typeof input.colId==="string"?input.colId:"";const params={value:input.value,data:input.row,node:{rowIndex:input.rowIndex},colId,formatted:input.formatted,colDef:input.colDef,context:input.context,api:input.api};const acc={};const warnedKeys=new Set;let kind="none";if(typeof spec==="function"){kind="function";applyFunctionSpec(spec,params,acc,warnedKeys,colId)}else if(Array.isArray(spec)){kind="array";applyArraySpec(spec,params,acc,warnedKeys,colId)}else if(typeof spec==="object"){kind="object";applyObjectSpec(spec,acc,warnedKeys,colId)}else{console.warn(`${WARN_PREFIX} cellStyle on column "${colId}" must be object / function / array; ignoring.`);return empty}return{style:acc,meta:{kind,appliedKeys:Object.keys(acc).length}}}

package/dist/collection/components/grid/core/cell/expression-runtime.js

@@ -0,0 +1 @@
+function syntaxError(code,pos,token){return new Error(`SG-EXPR-${code} pos=${pos}${token===void 0?"":` token="${token}"`}`)}export function warnGridExpression(code,field,row,detail,cause){const message=`[Syidax] sy-grid: SG-EXPR-${code} field="${field}" row=${row}${detail===void 0?"":` ${detail}`}`;if(cause===void 0)console.warn(message);else console.warn(message,cause)}function isWhitespace(c){return c===" "||c==="	"||c==="\n"||c==="\r"||c==="\f"||c==="\v"}function isIdentStart(c){if(c==="_"||c==="$")return true;const code=c.charCodeAt(0);return code>=65&&code<=90||code>=97&&code<=122}function isIdentCont(c){if(isIdentStart(c))return true;const code=c.charCodeAt(0);return code>=48&&code<=57}function isDigit(c){const code=c.charCodeAt(0);return code>=48&&code<=57}function tokenize(src,allowRuleOperators){const tokens=[];const len=src.length;let i=0;while(i<len){const c=src[i];if(isWhitespace(c)){i++;continue}if(isDigit(c)){const start=i;while(i<len&&isDigit(src[i]))i++;if(i<len&&src[i]==="."){i++;while(i<len&&isDigit(src[i]))i++}const slice=src.slice(start,i);const value=Number(slice);if(!Number.isFinite(value)){throw syntaxError("NUM",start,slice)}tokens.push({kind:"number",value,pos:start});continue}if(c==='"'||c==="'"){const start=i;const quote=c;i++;const lit=[];while(i<len&&src[i]!==quote){lit.push(src[i]);i++}if(i>=len){throw syntaxError("QUOTE",start,quote)}i++;tokens.push({kind:"string",value:lit.join(""),pos:start});continue}if(isIdentStart(c)){const start=i;while(i<len&&isIdentCont(src[i]))i++;tokens.push({kind:"identifier",name:src.slice(start,i),pos:start});continue}if(allowRuleOperators){const next=i+1<len?src[i+1]:"";if(c==="="&&next==="="){tokens.push({kind:"cmp",op:"==",pos:i});i+=2;continue}if(c==="!"&&next==="="){tokens.push({kind:"cmp",op:"!=",pos:i});i+=2;continue}if(c===">"&&next==="="){tokens.push({kind:"cmp",op:">=",pos:i});i+=2;continue}if(c==="<"&&next==="="){tokens.push({kind:"cmp",op:"<=",pos:i});i+=2;continue}if(c===">"||c==="<"){tokens.push({kind:"cmp",op:c,pos:i});i++;continue}if(c==="&"&&next==="&"){tokens.push({kind:"logic",op:"&&",pos:i});i+=2;continue}if(c==="|"&&next==="|"){tokens.push({kind:"logic",op:"||",pos:i});i+=2;continue}}if(c==="+"||c==="-"||c==="*"||c==="/"){tokens.push({kind:"op",op:c,pos:i});i++;continue}if(c==="("){tokens.push({kind:"lparen",pos:i});i++;continue}if(c===")"){tokens.push({kind:"rparen",pos:i});i++;continue}if(c===".")throw syntaxError("PROP",i,c);if(c==="["||c==="]")throw syntaxError("BRACKET",i,c);if(c==="=")throw syntaxError("ASSIGN",i,c);if(c==="<"||c===">")throw syntaxError("CMP",i,c);if(c==="|"||c==="&"||c==="^"||c==="~"){throw syntaxError("BITWISE",i,c)}if(c==="!")throw syntaxError("NOT",i,c);if(c==="?"||c===":")throw syntaxError("TERNARY",i,c);if(c===",")throw syntaxError("COMMA",i,c);if(c===";")throw syntaxError("STMT",i,c);if(c==="`")throw syntaxError("TEMPLATE",i,c);if(c==="%")throw syntaxError("MOD",i,c);throw syntaxError("CHAR",i,c)}return tokens}function peek(state){return state.pos<state.tokens.length?state.tokens[state.pos]:null}function consume(state){const token=state.tokens[state.pos];state.pos++;return token}function parseExpr(state){return parseOr(state)}function parseOr(state){let left=parseAnd(state);while(true){const token=peek(state);if(token===null||token.kind!=="logic"||token.op!=="||")break;consume(state);left={kind:"binary",op:"||",left,right:parseAnd(state)}}return left}function parseAnd(state){let left=parseComparison(state);while(true){const token=peek(state);if(token===null||token.kind!=="logic"||token.op!=="&&")break;consume(state);left={kind:"binary",op:"&&",left,right:parseComparison(state)}}return left}function parseComparison(state){const left=parseAdd(state);const token=peek(state);if(token===null||token.kind!=="cmp")return left;consume(state);const right=parseAdd(state);const next=peek(state);if(next!==null&&next.kind==="cmp"){throw syntaxError("CHAIN",next.pos,next.op)}return{kind:"binary",op:token.op,left,right}}function parseAdd(state){let left=parseMul(state);while(true){const token=peek(state);if(token===null||token.kind!=="op"||token.op!=="+"&&token.op!=="-"){break}consume(state);left={kind:"binary",op:token.op,left,right:parseMul(state)}}return left}function parseMul(state){let left=parseUnary(state);while(true){const token=peek(state);if(token===null||token.kind!=="op"||token.op!=="*"&&token.op!=="/"){break}consume(state);left={kind:"binary",op:token.op,left,right:parseUnary(state)}}return left}function parseUnary(state){const token=peek(state);if(token!==null&&token.kind==="op"&&token.op==="-"){consume(state);return{kind:"unary",op:"-",operand:parseUnary(state)}}return parsePrimary(state)}function parsePrimary(state){const token=peek(state);if(token===null)throw syntaxError("END",state.end);if(token.kind==="number"){consume(state);return{kind:"number",value:token.value}}if(token.kind==="string"){consume(state);return{kind:"string",value:token.value}}if(token.kind==="identifier"){consume(state);const next=peek(state);if(next!==null&&next.kind==="lparen"){throw syntaxError("CALL",next.pos,token.name)}state.identifiers.add(token.name);return{kind:"identifier",name:token.name}}if(token.kind==="lparen"){consume(state);const inner=parseExpr(state);const close=peek(state);if(close===null||close.kind!=="rparen"){throw syntaxError("RPAREN",close===null?state.end:close.pos,close===null?")":describeToken(close))}consume(state);return{kind:"group",inner}}throw syntaxError("TOKEN",token.pos,describeToken(token))}function describeToken(token){if(token.kind==="op"||token.kind==="cmp"||token.kind==="logic"){return token.op}if(token.kind==="lparen")return"(";if(token.kind==="rparen")return")";if(token.kind==="number")return String(token.value);if(token.kind==="string")return`"${token.value}"`;return token.name}export function parseGridExpression(expr,allowRuleOperators){if(typeof expr!=="string")throw syntaxError("TYPE",0);if(expr.trim().length===0)throw syntaxError("EMPTY",0);const tokens=tokenize(expr,allowRuleOperators);if(tokens.length===0)throw syntaxError("EMPTY",0);const state={tokens,pos:0,identifiers:new Set,end:expr.length};const ast=parseExpr(state);if(state.pos<tokens.length){const trailing=tokens[state.pos];throw syntaxError("TRAIL",trailing.pos,describeToken(trailing))}return{ast,identifiers:Array.from(state.identifiers)}}export function evaluateGridExpression(ast,getIdentifier){if(ast.kind==="number")return ast.value;if(ast.kind==="string")return ast.value;if(ast.kind==="identifier")return getIdentifier(ast.name);if(ast.kind==="group")return evaluateGridExpression(ast.inner,getIdentifier);if(ast.kind==="unary"){return-Number(evaluateGridExpression(ast.operand,getIdentifier))}const op=ast.op;if(op==="&&"){const left2=evaluateGridExpression(ast.left,getIdentifier);return left2?evaluateGridExpression(ast.right,getIdentifier):left2}if(op==="||"){const left2=evaluateGridExpression(ast.left,getIdentifier);return left2?left2:evaluateGridExpression(ast.right,getIdentifier)}const left=evaluateGridExpression(ast.left,getIdentifier);const right=evaluateGridExpression(ast.right,getIdentifier);if(op==="+"){return typeof left==="string"||typeof right==="string"?String(left)+String(right):Number(left)+Number(right)}if(op==="-")return Number(left)-Number(right);if(op==="*")return Number(left)*Number(right);if(op==="/")return Number(left)/Number(right);if(op==="==")return left===right;if(op==="!=")return left!==right;if(op===">")return Number(left)>Number(right);if(op==="<")return Number(left)<Number(right);if(op===">=")return Number(left)>=Number(right);return Number(left)<=Number(right)}

package/dist/collection/components/grid/core/cell/index.js

@@ -0,0 +1 @@
+export*from"./renderer-registry.js";export*from"./value-getter.js";export*from"./value-formatter.js";export*from"./cell-class-rules.js";export*from"./cell-style.js";

package/dist/collection/components/grid/core/cell/renderer-registry.js

@@ -0,0 +1 @@
+export function normalizeRenderOutput(output){if(output===null||typeof output!=="object")return{kind:"invalid"};const candidate=output;const cls=typeof candidate.class==="string"?candidate.class:"";if(candidate.kind==="text"){return{kind:"text",text:typeof candidate.text==="string"?candidate.text:"",class:cls}}if(candidate.kind==="html"){return{kind:"html",html:typeof candidate.html==="string"?candidate.html:"",class:cls}}if(candidate.kind==="vnode"){return{kind:"vnode",vnode:candidate.vnode}}return{kind:"invalid"}}const FALLBACK_TEXT="—";const DEFAULT_CURRENCY="USD";const DEFAULT_TRUE_LABEL="✓";const DEFAULT_FALSE_LABEL="";const BUILTIN_NAMES=["text","number","currency","percent","date","boolean","link","progressBar","sparkline","miniChart","image","icon"];function readMetaString(meta,key,fallback){if(!meta)return fallback;const raw=meta[key];if(typeof raw==="string"&&raw.length>0)return raw;return fallback}function readMetaNumber(meta,key,fallback){if(!meta)return fallback;const raw=meta[key];if(typeof raw==="number"&&Number.isFinite(raw))return raw;return fallback}function clampNumber(n,lo,hi){return n<lo?lo:n>hi?hi:n}function readMetaNumberFormat(meta,key){if(!meta)return void 0;const raw=meta[key];if(raw&&typeof raw==="object"){return raw}return void 0}function readMetaDateFormat(meta,key){if(!meta)return void 0;const raw=meta[key];if(raw&&typeof raw==="object"){return raw}return void 0}function toFiniteOrNaN(v){if(typeof v==="number")return Number.isFinite(v)?v:NaN;if(typeof v==="string"){const t=v.trim();if(t==="")return NaN;const n=Number(t);return Number.isFinite(n)?n:NaN}if(typeof v==="bigint"){const n=Number(v);return Number.isFinite(n)?n:NaN}return NaN}function coerceNumberArray(value){if(Array.isArray(value)){return value.map(toFiniteOrNaN).filter(v=>Number.isFinite(v))}if(typeof value==="string"&&value.trim().length>0){const text=value.trim();if(text.startsWith("[")){try{const parsed=JSON.parse(text);if(Array.isArray(parsed))return parsed.map(toFiniteOrNaN).filter(v=>Number.isFinite(v))}catch{}}return text.split(",").map(s=>s.trim()).filter(s=>s.length>0).map(toFiniteOrNaN).filter(v=>Number.isFinite(v))}return[]}function safeString(v){try{return String(v)}catch{return""}}function coerceFiniteNumber(value){if(typeof value==="number"&&Number.isFinite(value))return value;if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(Number.isFinite(parsed))return parsed}return null}function coerceDate(value){if(value instanceof Date){if(Number.isFinite(value.getTime()))return value;return null}if(typeof value==="string"&&value.length>0){const parsed=new Date(value);if(Number.isFinite(parsed.getTime()))return parsed}if(typeof value==="number"&&Number.isFinite(value)){const parsed=new Date(value);if(Number.isFinite(parsed.getTime()))return parsed}return null}function escapeHtml(s){return s.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function escapeAttr(s){return escapeHtml(s)}function isUnsafeUrl(url){return/^\s*(?:javascript|data|vbscript)\s*:/i.test(url)}function isUnsafeImageUrl(url){const trimmed=url.replace(/^\s+/,"");if(/^(?:javascript|vbscript)\s*:/i.test(trimmed))return true;if(/^data\s*:/i.test(trimmed))return!/^data\s*:\s*image\//i.test(trimmed);return false}function builtinText(input){if(typeof input.formatted==="string"){return{kind:"text",text:input.formatted}}if(input.value==null)return{kind:"text",text:""};return{kind:"text",text:safeString(input.value)}}function builtinNumber(input){const n=coerceFiniteNumber(input.value);if(n===null)return{kind:"text",text:FALLBACK_TEXT};const opts=readMetaNumberFormat(input.meta,"numberFormat");try{const formatter=new Intl.NumberFormat(void 0,opts);return{kind:"text",text:formatter.format(n)}}catch{return{kind:"text",text:String(n)}}}function builtinCurrency(input){const n=coerceFiniteNumber(input.value);if(n===null)return{kind:"text",text:FALLBACK_TEXT};const overrides=readMetaNumberFormat(input.meta,"numberFormat");const currency=readMetaString(input.meta,"currency",DEFAULT_CURRENCY);const opts={style:"currency",currency,...overrides??{}};try{const formatter=new Intl.NumberFormat(void 0,opts);return{kind:"text",text:formatter.format(n)}}catch{return{kind:"text",text:String(n)}}}function builtinPercent(input){const n=coerceFiniteNumber(input.value);if(n===null)return{kind:"text",text:FALLBACK_TEXT};const overrides=readMetaNumberFormat(input.meta,"numberFormat");const opts={style:"percent",...overrides??{}};try{const formatter=new Intl.NumberFormat(void 0,opts);return{kind:"text",text:formatter.format(n)}}catch{return{kind:"text",text:String(n)}}}function builtinDate(input){const d=coerceDate(input.value);if(d===null)return{kind:"text",text:FALLBACK_TEXT};const opts=readMetaDateFormat(input.meta,"dateFormat");try{const formatter=new Intl.DateTimeFormat(void 0,opts);return{kind:"text",text:formatter.format(d)}}catch{return{kind:"text",text:d.toISOString()}}}function builtinBoolean(input){const v=input.value;if(v===true){return{kind:"text",text:readMetaString(input.meta,"trueLabel",DEFAULT_TRUE_LABEL)}}if(v===false){return{kind:"text",text:readMetaString(input.meta,"falseLabel",DEFAULT_FALSE_LABEL)}}return{kind:"text",text:FALLBACK_TEXT}}function builtinLink(input){const hrefField=readMetaString(input.meta,"hrefField","");if(hrefField.length===0){return builtinText(input)}const row=input.row;if(!row||typeof row!=="object"){return builtinText(input)}const rawHref=row[hrefField];if(typeof rawHref!=="string"||rawHref.length===0){return builtinText(input)}if(isUnsafeUrl(rawHref)){return builtinText(input)}const labelSource=typeof input.formatted==="string"?input.formatted:input.value==null?"":safeString(input.value);const label=labelSource.length>0?labelSource:rawHref;const html=`<a href="${escapeAttr(rawHref)}">${escapeHtml(label)}</a>`;return{kind:"html",html}}function builtinProgressBar(input){const n=coerceFiniteNumber(input.value);if(n===null)return{kind:"text",text:FALLBACK_TEXT};const min=readMetaNumber(input.meta,"min",0);const max=readMetaNumber(input.meta,"max",100);const span=max-min;const pct=span===0?n>=max?100:0:clampNumber((n-min)/span*100,0,100);const width=Math.round(pct*10)/10;const showLabel=input.meta?.showLabel!==false;const label=typeof input.formatted==="string"&&input.formatted.length>0?input.formatted:`${Math.round(pct)}%`;const barClass=readMetaString(input.meta,"barClass","");const fillClass=barClass.length>0?`sy-grid__cell-progress-fill ${escapeAttr(barClass)}`:"sy-grid__cell-progress-fill";const wrapStyle="display:flex;align-items:center;gap:6px;width:100%;min-width:0";const trackStyle="position:relative;flex:1 1 auto;min-width:0;height:8px;border-radius:4px;overflow:hidden;background:var(--sy-grid-progress-track,rgba(15,23,42,0.1))";const fillStyle=`width:${width}%;height:100%;border-radius:4px;background:var(--sy-grid-progress-fill,var(--sy-color-primary,#2563eb))`;const labelStyle="flex:0 0 auto;font-size:11px;color:var(--sy-grid-text-muted,#6b7280);font-variant-numeric:tabular-nums";const labelHtml=showLabel?`<span class="sy-grid__cell-progress-label" style="${labelStyle}">${escapeHtml(label)}</span>`:"";const html=`<div class="sy-grid__cell-progress" style="${wrapStyle}" role="progressbar" aria-valuenow="${escapeAttr(String(n))}" aria-valuemin="${escapeAttr(String(min))}" aria-valuemax="${escapeAttr(String(max))}"><div class="sy-grid__cell-progress-track" style="${trackStyle}"><div class="${fillClass}" style="${fillStyle}"></div></div>${labelHtml}</div>`;return{kind:"html",html}}const SPARKLINE_TYPES=["line","area","column","pie","stock"];function builtinSparkline(input){const values=coerceNumberArray(input.value);if(values.length===0)return{kind:"text",text:FALLBACK_TEXT};const typeRaw=readMetaString(input.meta,"type","line");const type=SPARKLINE_TYPES.includes(typeRaw)?typeRaw:"line";const width=readMetaNumber(input.meta,"width",100);const height=readMetaNumber(input.meta,"height",28);const color=readMetaString(input.meta,"color","");const showValue=input.meta?.showValue===true;const attrs=[`values="${escapeAttr(values.join(","))}"`,`type="${escapeAttr(type)}"`,`width="${width}"`,`height="${height}"`,color.length>0?`color="${escapeAttr(color)}"`:"",showValue?"show-value":""].filter(a=>a.length>0).join(" ");return{kind:"html",html:`<sy-sparkline-chart ${attrs}></sy-sparkline-chart>`}}function builtinMiniChart(input){const values=coerceNumberArray(input.value);if(values.length===0)return{kind:"text",text:FALLBACK_TEXT};const type=readMetaString(input.meta,"type","line")==="bar"?"bar":"line";const width=readMetaNumber(input.meta,"width",100);const height=readMetaNumber(input.meta,"height",28);const color=escapeAttr(readMetaString(input.meta,"color","#2563eb"));const pad=2;const innerW=Math.max(1,width-pad*2);const innerH=Math.max(1,height-pad*2);const min=Math.min(...values);const max=Math.max(...values);const flat=max===min;const normOf=v=>flat?.5:(v-min)/(max-min);const yOf=v=>pad+innerH-normOf(v)*innerH;let inner;if(type==="bar"){const slot=innerW/values.length;const barW=Math.max(1,slot*.7);inner=values.map((v,i)=>{const barH=Math.max(1.5,normOf(v)*innerH);const x=pad+i*slot+(slot-barW)/2;const y=pad+innerH-barH;return`<rect x="${x.toFixed(1)}" y="${y.toFixed(1)}" width="${barW.toFixed(1)}" height="${barH.toFixed(1)}" fill="${color}" rx="0.5"></rect>`}).join("")}else if(values.length===1){inner=`<circle cx="${(pad+innerW/2).toFixed(1)}" cy="${yOf(values[0]).toFixed(1)}" r="1.75" fill="${color}"></circle>`}else{const xOf=i=>pad+i/(values.length-1)*innerW;const points=values.map((v,i)=>`${xOf(i).toFixed(1)},${yOf(v).toFixed(1)}`).join(" ");inner=`<polyline points="${points}" fill="none" stroke="${color}" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></polyline>`}const label=escapeAttr(`chart: ${values.join(", ")}`);const html=`<svg class="sy-grid__cell-minichart" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${label}">${inner}</svg>`;return{kind:"html",html}}function builtinImage(input){const raw=input.value;const url=typeof raw==="string"?raw.trim():"";if(url.length===0||isUnsafeImageUrl(url))return builtinText(input);const altField=readMetaString(input.meta,"altField","");const altRaw=altField.length>0&&input.row&&typeof input.row==="object"?input.row[altField]:"";const alt=escapeAttr(typeof altRaw==="string"?altRaw:"");const width=readMetaNumber(input.meta,"width",0);const height=readMetaNumber(input.meta,"height",0);const rounded=input.meta?.rounded===true;const sizeAttrs=`${width>0?` width="${width}"`:""}${height>0?` height="${height}"`:""}`;const style=rounded?`max-width:100%;max-height:100%;object-fit:cover;vertical-align:middle;border-radius:9999px`:`max-width:100%;max-height:100%;object-fit:contain;vertical-align:middle`;return{kind:"html",html:`<img src="${escapeAttr(url)}" alt="${alt}"${sizeAttrs} loading="lazy" style="${style}">`}}function builtinIcon(input){const raw=input.value;const map=input.meta?.map;const key=raw==null?"":safeString(raw);let glyph=key;if(map&&typeof map==="object"&&key.length>0){const mapped=map[key];if(typeof mapped==="string")glyph=mapped}if(glyph.length===0)return{kind:"text",text:FALLBACK_TEXT};const title=readMetaString(input.meta,"title","");const titleAttr=title.length>0?` title="${escapeAttr(title)}" aria-label="${escapeAttr(title)}"`:"";if(/^(https?:)?\/\//i.test(glyph)&&!isUnsafeUrl(glyph)){const size2=readMetaNumber(input.meta,"size",16);return{kind:"html",html:`<img src="${escapeAttr(glyph)}" alt="${escapeAttr(title)}" width="${size2}" height="${size2}" loading="lazy" style="vertical-align:middle">`}}const color=readMetaString(input.meta,"color","");const size=readMetaNumber(input.meta,"size",0);const style=`${color.length>0?`color:${escapeAttr(color)};`:""}${size>0?`font-size:${size}px;`:""}line-height:1`;return{kind:"html",html:`<span class="sy-grid__cell-icon"${titleAttr} style="${style}">${escapeHtml(glyph)}</span>`}}function buildBuiltinEntries(){return[["text",builtinText],["number",builtinNumber],["currency",builtinCurrency],["percent",builtinPercent],["date",builtinDate],["boolean",builtinBoolean],["link",builtinLink],["progressBar",builtinProgressBar],["sparkline",builtinSparkline],["miniChart",builtinMiniChart],["image",builtinImage],["icon",builtinIcon]]}export function createRendererRegistry(opts={}){const map=new Map;if(opts.includeBuiltins!==false){for(const[name,renderer]of buildBuiltinEntries()){map.set(name,renderer)}}function register(name,renderer){if(typeof name!=="string"||name.trim().length===0){console.warn("[sy-grid] renderer-registry.register: name must be a non-empty string.");return false}if(typeof renderer!=="function"){console.warn(`[sy-grid] renderer-registry.register("${name}"): renderer must be a function.`);return false}if(map.has(name)){console.warn(`[sy-grid] renderer-registry.register("${name}"): name already registered; use replace() to overwrite.`);return false}map.set(name,renderer);return true}function replace(name,renderer){if(typeof name!=="string"||name.trim().length===0)return false;if(typeof renderer!=="function")return false;if(!map.has(name))return false;map.set(name,renderer);return true}function unregister(name){if(typeof name!=="string")return false;if(!map.has(name))return false;map.delete(name);return true}function get(name){if(typeof name!=="string")return null;const found=map.get(name);return found??null}function has(name){if(typeof name!=="string")return false;return map.has(name)}function list(){return Array.from(map.keys())}function clear(){map.clear()}return{register,replace,unregister,get,has,list,clear}}export const BUILTIN_RENDERER_NAMES=BUILTIN_NAMES;

package/dist/collection/components/grid/core/cell/value-formatter.js

@@ -0,0 +1 @@
+const WARN_PREFIX="[Syidax] sy-grid:";const DEFAULT_LOCALE="en";export function parseValueFormatterTemplate(template){if(typeof template!=="string"){return{segments:[{kind:"literal",text:""}]}}const segments=[];const len=template.length;let i=0;let literalStart=0;while(i<len){if(template[i]==="{"&&i+1<len&&template[i+1]==="{"){if(i>literalStart){segments.push({kind:"literal",text:template.slice(literalStart,i)})}const slotStart=i;i+=2;let close=-1;for(let j=i;j+1<len;j++){if(template[j]==="}"&&template[j+1]==="}"){close=j;break}}if(close<0){console.warn(`${WARN_PREFIX} valueFormatter template missing closing "}}" starting at ${slotStart}.`);segments.push({kind:"literal",text:template.slice(slotStart)});return{segments}}const inner=template.slice(i,close);segments.push(parseInterpolation(inner));i=close+2;literalStart=i;continue}i++}if(literalStart<len){segments.push({kind:"literal",text:template.slice(literalStart)})}if(segments.length===0){segments.push({kind:"literal",text:""})}return{segments}}function parseInterpolation(body){const parts=body.split("|").map(s=>s.trim());const varName=parts[0]??"";const pipes=[];for(let p=1;p<parts.length;p++){const segment=parts[p];if(segment.length===0)continue;const colonIdx=segment.indexOf(":");if(colonIdx<0){pipes.push({name:segment,args:[]});continue}const name=segment.slice(0,colonIdx).trim();const argRaw=segment.slice(colonIdx+1);const args=[argRaw];pipes.push({name,args})}return{kind:"interp",varName,pipes}}export function applyPipes(value,pipes,locale){let cur=value;const warnedKeys=new Set;for(let i=0;i<pipes.length;i++){const p=pipes[i];cur=applyOnePipe(cur,p,locale,warnedKeys)}return coerceToString(cur)}function applyOnePipe(value,pipe,locale,warnedKeys){const name=pipe.name;const arg0=pipe.args.length>0?pipe.args[0]:void 0;if(name==="upper"){return coerceToString(value).toUpperCase()}if(name==="lower"){return coerceToString(value).toLowerCase()}if(name==="trim"){return coerceToString(value).trim()}if(name==="round"){if(value===null||value===void 0)return"";const n=parsePipeIntArg(arg0,0,name,warnedKeys);const num=Number(value);if(!Number.isFinite(num)){return coerceToString(value)}return num.toFixed(n)}if(name==="percent"){if(value===null||value===void 0)return"";const n=parsePipeIntArg(arg0,0,name,warnedKeys);const num=Number(value);if(!Number.isFinite(num)){return coerceToString(value)}return(num*100).toFixed(n)+"%"}if(name==="currency"){if(value===null||value===void 0)return"";const code=typeof arg0==="string"&&arg0.length>0?arg0:"USD";const num=Number(value);if(!Number.isFinite(num)){return coerceToString(value)}try{return new Intl.NumberFormat(locale,{style:"currency",currency:code}).format(num)}catch(err){const key=`currency:${code}`;if(!warnedKeys.has(key)){warnedKeys.add(key);console.warn(`${WARN_PREFIX} valueFormatter currency pipe rejected code "${code}":`,err)}return num.toFixed(2)}}if(name==="date"){const fmt=typeof arg0==="string"&&arg0.length>0?arg0:"YYYY-MM-DD";return formatDateValue(value,fmt)}if(name==="default"){if(isEmptyValue(value)){return typeof arg0==="string"?arg0:""}return value}if(!warnedKeys.has(`unknown:${name}`)){warnedKeys.add(`unknown:${name}`);console.warn(`${WARN_PREFIX} valueFormatter unknown pipe "${name}"; skipping.`)}return value}function parsePipeIntArg(arg,defaultN,pipeName,warnedKeys){if(arg===void 0)return defaultN;const trimmed=arg.trim();if(trimmed.length===0)return defaultN;const n=Number(trimmed);if(!Number.isFinite(n)){const key=`arg:${pipeName}:${trimmed}`;if(!warnedKeys.has(key)){warnedKeys.add(key);console.warn(`${WARN_PREFIX} valueFormatter "${pipeName}" arg "${trimmed}" is not a number; using ${defaultN}.`)}return defaultN}const floored=Math.floor(n);if(floored<0)return 0;if(floored>100)return 100;return floored}function formatDateValue(value,fmt){const d=toDate(value);if(d===null)return coerceToString(value);const Y=String(d.getFullYear()).padStart(4,"0");const M=String(d.getMonth()+1).padStart(2,"0");const D=String(d.getDate()).padStart(2,"0");const H=String(d.getHours()).padStart(2,"0");const m=String(d.getMinutes()).padStart(2,"0");const s=String(d.getSeconds()).padStart(2,"0");return fmt.replace(/YYYY/g,Y).replace(/MM/g,M).replace(/DD/g,D).replace(/HH/g,H).replace(/mm/g,m).replace(/ss/g,s)}function toDate(value){if(value instanceof Date){return Number.isFinite(value.getTime())?value:null}if(typeof value==="number"){const d=new Date(value);return Number.isFinite(d.getTime())?d:null}if(typeof value==="string"){const t=Date.parse(value);if(!Number.isFinite(t))return null;return new Date(t)}return null}function isEmptyValue(value){if(value===null||value===void 0)return true;if(typeof value==="string"&&value.length===0)return true;return false}function coerceToString(value){if(value===null||value===void 0)return"";if(typeof value==="string")return value;return String(value)}function renderParsedTemplate(parsed,value,locale,warnedKeys){const out=[];for(let i=0;i<parsed.segments.length;i++){const seg=parsed.segments[i];if(seg.kind==="literal"){out.push(seg.text);continue}if(seg.varName==="value"){out.push(applyPipesWithSharedWarnBudget(value,seg.pipes,locale,warnedKeys));continue}const key=`var:${seg.varName}`;if(!warnedKeys.has(key)){warnedKeys.add(key);console.warn(`${WARN_PREFIX} valueFormatter unknown variable "${seg.varName}".`)}out.push(reconstructInterpolation(seg))}return out.join("")}function applyPipesWithSharedWarnBudget(value,pipes,locale,warnedKeys){let cur=value;for(let i=0;i<pipes.length;i++){cur=applyOnePipe(cur,pipes[i],locale,warnedKeys)}return coerceToString(cur)}function reconstructInterpolation(seg){const parts=[seg.varName];for(let i=0;i<seg.pipes.length;i++){const p=seg.pipes[i];parts.push(p.args.length>0?`${p.name}:${p.args.join(":")}`:p.name)}return`{{${parts.join(" | ")}}}`}export function formatCellValue(input){if(input==null||typeof input!=="object"){console.warn(`${WARN_PREFIX} formatCellValue called with non-object input.`);return""}const value=input.value;const valueFormatter=input.valueFormatter;const locale=typeof input.locale==="string"&&input.locale.length>0?input.locale:DEFAULT_LOCALE;if(valueFormatter===void 0||valueFormatter===null){return value==null?"":String(value)}if(typeof valueFormatter==="function"){try{const result=valueFormatter({value,data:input.row,node:{rowIndex:input.rowIndex},colId:input.colId,locale,context:input.context,api:input.api});return typeof result==="string"?result:coerceToString(result)}catch(err){console.warn(`${WARN_PREFIX} valueFormatter for "${input.colId}" threw on row ${input.rowIndex}:`,err);return value==null?"":String(value)}}if(typeof valueFormatter==="string"){if(valueFormatter.indexOf("{{")<0){return valueFormatter}const parsed=parseValueFormatterTemplate(valueFormatter);const warnedKeys=new Set;return renderParsedTemplate(parsed,value,locale,warnedKeys)}console.warn(`${WARN_PREFIX} valueFormatter for "${input.colId}" is not a function / string; ignoring.`);return value==null?"":String(value)}

package/dist/collection/components/grid/core/cell/value-getter.js

@@ -0,0 +1 @@
+import{evaluateGridExpression,parseGridExpression,warnGridExpression}from"./expression-runtime.js";const WARN_PREFIX="[Syidax] sy-grid:";function isSafeFieldPathSegment(segment){return segment.length>0&&segment!=="__proto__"&&segment!=="prototype"&&segment!=="constructor"}function parseSafeFieldPath(path){if(typeof path!=="string"||path.length===0)return null;const segments=path.split(".");return segments.every(isSafeFieldPathSegment)?segments:null}function isFieldPathContainer(value){if(value===null||typeof value!=="object")return false;if(Array.isArray(value))return true;const prototype=Object.getPrototypeOf(value);return prototype===Object.prototype||prototype===null}function arrayIndexForSegment(segment){const index=+segment>>>0;return index<4294967295&&String(index)===segment?index:null}function cloneContainerWithOwnValue(container,segment,value){if(Array.isArray(container)){const clone2=container.slice();clone2[+segment]=value;return clone2}const clone={...container,[segment]:value};Object.setPrototypeOf(clone,Object.getPrototypeOf(container));return clone}export function readOwnFieldPath(row,path){if(typeof path!=="string"||path.length===0)return void 0;if(path.indexOf(".")===-1){return isSafeFieldPathSegment(path)&&row!==null&&typeof row==="object"&&Object.hasOwn(row,path)?row[path]:void 0}const segments=parseSafeFieldPath(path);if(segments===null)return void 0;let current=row;for(const segment of segments){if(current===null||typeof current!=="object"||!Object.hasOwn(current,segment)){return void 0}current=current[segment]}return current}export function setOwnFieldPathImmutable(root,path,value){const segments=parseSafeFieldPath(path);if(segments===null||!isFieldPathContainer(root))return root;const chain=[root];for(let index=0;index<segments.length-1;index++){const current2=chain[index];const segment=segments[index];if(Array.isArray(current2)&&arrayIndexForSegment(segment)===null||!Object.hasOwn(current2,segment)){return root}const next=current2[segment];if(!isFieldPathContainer(next))return root;chain.push(next)}const current=chain[chain.length-1];const leaf=segments[segments.length-1];if(Array.isArray(current)){const arrayIndex=arrayIndexForSegment(leaf);if(arrayIndex===null||arrayIndex>current.length)return root}let nextValue=value;for(let index=chain.length-1;index>=0;index--){nextValue=cloneContainerWithOwnValue(chain[index],segments[index],nextValue)}return nextValue}export function parseValueGetterExpression(expr){return parseGridExpression(expr,false)}export function evaluateExpression(ast,getIdentifier){return evaluateGridExpression(ast,getIdentifier)}export function resolveCellValue(input){if(input==null||typeof input!=="object"){console.warn(`${WARN_PREFIX} resolveCellValue called with non-object input.`);return null}const row=input.row;if(row==null||typeof row!=="object"){console.warn(`${WARN_PREFIX} resolveCellValue: row is not an object.`);return null}const fieldKey=typeof input.field==="string"&&input.field.length>0?input.field:input.colId;if(typeof fieldKey!=="string"||fieldKey.length===0){console.warn(`${WARN_PREFIX} resolveCellValue: colId / field is empty.`);return null}const valueGetter=input.valueGetter;if(valueGetter===void 0||valueGetter===null){return readOwnFieldPath(row,fieldKey)}const inFlight=input.inFlight??new Set;const seededFieldKey=!inFlight.has(fieldKey);if(seededFieldKey)inFlight.add(fieldKey);const getOther=input.getOtherValue;function getValue(otherColId){if(typeof otherColId!=="string"||otherColId.length===0){return void 0}if(inFlight.has(otherColId)){warnGridExpression("VG-CYCLE",otherColId,input.rowIndex);return null}inFlight.add(otherColId);try{if(typeof getOther==="function"){return getOther(otherColId)}return readOwnFieldPath(row,otherColId)}finally{inFlight.delete(otherColId)}}try{if(typeof valueGetter==="function"){const params={data:row,node:{rowIndex:input.rowIndex,rowId:input.rowId},colId:fieldKey,getValue,colDef:input.colDef,rowIndex:input.rowIndex,context:input.context,api:input.api};try{return valueGetter(params)}catch(err){warnGridExpression("VG-FN",fieldKey,input.rowIndex,void 0,err);return null}}if(typeof valueGetter==="string"){let parsed;try{parsed=parseValueGetterExpression(valueGetter)}catch(err){const msg=err instanceof Error?err.message:String(err);warnGridExpression("VG-PARSE",fieldKey,input.rowIndex,msg);return null}const lookup=name=>getValue(name);try{return evaluateExpression(parsed.ast,lookup)}catch(err){warnGridExpression("VG-EVAL",fieldKey,input.rowIndex,void 0,err);return null}}warnGridExpression("VG-TYPE",fieldKey,input.rowIndex);return readOwnFieldPath(row,fieldKey)}finally{if(seededFieldKey)inFlight.delete(fieldKey)}}