@syidax/advanced 0.0.0-stage → 1.0.1

package/dist/collection/components/grid/core/row-model/client-side.js

@@ -0,0 +1 @@
+export function createClientSideRowModel(initialRows=[]){let rows=[...initialRows];const listeners=new Set;const snapshot=()=>Object.freeze([...rows]);const fire=event=>{for(const listener of[...listeners]){try{listener(event)}catch(err){console.error("[Syidax] sy-grid row model listener threw:",err)}}};const setRowData=next=>{rows=[...next];const view=snapshot();fire({type:"set",rows:view,affected:view})};const getRows=()=>snapshot();const getRowCount=()=>rows.length;const getRow=index=>rows[index];const applyTransaction=tx=>{const result={added:[],updated:[],removed:[],ignored:0};if(tx.add&&tx.add.length>0){rows=[...rows,...tx.add];result.added.push(...tx.add);const view=snapshot();fire({type:"add",rows:view,affected:Object.freeze([...result.added])})}if(tx.update&&tx.update.length>0){let mutated=false;for(const op of tx.update){if(typeof op.index==="number"){if(op.index<0||op.index>=rows.length){console.warn(`[Syidax] sy-grid row model: applyTransaction({ update }) — index ${op.index} is out of range (rows=${rows.length}). Op ignored.`);result.ignored+=1;continue}if(!mutated){rows=[...rows];mutated=true}rows[op.index]=op.row;result.updated.push(op.row);continue}const targetIndex=rows.indexOf(op.row);if(targetIndex<0){console.warn("[Syidax] sy-grid row model: applyTransaction({ update }) — row reference not found in store. Op ignored.");result.ignored+=1;continue}if(!mutated){rows=[...rows];mutated=true}rows[targetIndex]=op.row;result.updated.push(op.row)}if(result.updated.length>0){const view=snapshot();fire({type:"update",rows:view,affected:Object.freeze([...result.updated])})}}if(tx.remove&&tx.remove.length>0){const preRemove=rows;const valid=[];const seen=new Set;for(const idx of tx.remove){if(!Number.isInteger(idx)||idx<0||idx>=preRemove.length){console.warn(`[Syidax] sy-grid row model: applyTransaction({ remove }) — index ${idx} is out of range (rows=${preRemove.length}). Op ignored.`);result.ignored+=1;continue}if(seen.has(idx)){console.warn(`[Syidax] sy-grid row model: applyTransaction({ remove }) — duplicate index ${idx}. Op ignored.`);result.ignored+=1;continue}seen.add(idx);valid.push(idx);result.removed.push(preRemove[idx])}if(valid.length>0){rows=[...rows];const desc=[...valid].sort((a,b)=>b-a);for(const idx of desc){rows.splice(idx,1)}const view=snapshot();fire({type:"remove",rows:view,affected:Object.freeze([...result.removed])})}}return result};const subscribe=listener=>{listeners.add(listener);return()=>{listeners.delete(listener)}};return{setRowData,getRows,getRowCount,getRow,applyTransaction,subscribe}}

package/dist/collection/components/grid/core/row-model/datasource.js

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

package/dist/collection/components/grid/core/row-model/index.js

@@ -0,0 +1 @@
+export{createClientSideRowModel}from"./client-side.js";

package/dist/collection/components/grid/core/row-model/infinite.js

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

package/dist/collection/components/grid/core/row-model/placeholder-row.js

@@ -0,0 +1 @@
+import{lookupRow,virtualRowCount}from"./block-cache.js";export function makeLoadingPlaceholderRow(rowIndex,status){return{__syLoadingRow:true,rowIndex,status}}export function isLoadingPlaceholderRow(row){return typeof row==="object"&&row!==null&&row.__syLoadingRow===true}export function materializeInfiniteRows(cache){const count=virtualRowCount(cache);const out=new Array(count);for(let i=0;i<count;i++){const hit=lookupRow(cache,i);out[i]=hit.status==="loaded"?hit.row:makeLoadingPlaceholderRow(i,hit.status)}return out}

package/dist/collection/components/grid/core/row-model/viewport-adapters.js

@@ -0,0 +1 @@
+const defaultSocketFactory=(url,protocols)=>{const Ctor=globalThis.WebSocket;if(typeof Ctor!=="function")throw new Error("WebSocket is not available in this environment");return new Ctor(url,protocols)};const defaultScheduler={setTimer:(fn,ms)=>{const h=globalThis.setTimeout(fn,ms);return()=>globalThis.clearTimeout(h)}};function defaultParseViewportMessage(raw){let obj=raw;if(typeof raw==="string"){try{obj=JSON.parse(raw)}catch{return null}}if(obj===null||typeof obj!=="object")return null;const m=obj;const seq=typeof m.seq==="number"?m.seq:void 0;if(m.type==="count"&&typeof m.rowCount==="number"){return{type:"count",rowCount:m.rowCount,seq}}if(m.type==="rows"&&typeof m.startIndex==="number"&&Array.isArray(m.rows)){return{type:"rows",startIndex:m.startIndex,rows:m.rows,seq}}if(m.type==="update"&&Array.isArray(m.updates)){const updates=m.updates.filter(u=>u!==null&&typeof u==="object"&&typeof u.index==="number");return{type:"update",updates,seq}}return null}const clampInt=(n,dflt,min=0)=>typeof n==="number"&&Number.isFinite(n)&&n>=min?Math.floor(n):dflt;export function createWebSocketViewportDatasource(config){const factory=config.socketFactory??defaultSocketFactory;const scheduler=config.scheduler??defaultScheduler;const parse=config.parseMessage??defaultParseViewportMessage;const reconnectEnabled=config.reconnect!==false;const baseDelay=clampInt(config.reconnectDelayMs,500,1);const maxDelay=clampInt(config.maxReconnectDelayMs,1e4,1);let callbacks=null;let socket=null;let open=false;let destroyed=false;let lastRange=null;let lastSeq=-Infinity;let attempt=0;let cancelReconnect=null;const rawSend=payload=>{if(socket===null||!open)return;try{socket.send(JSON.stringify(payload))}catch{}};const rangeMessage=(firstRow,lastRow)=>config.buildRangeRequest?config.buildRangeRequest(firstRow,lastRow):{type:"range",firstRow,lastRow};const handleMessage=raw=>{if(callbacks===null)return;const msg=parse(raw);if(msg===null)return;if(typeof msg.seq==="number"){if(msg.seq<=lastSeq)return;lastSeq=msg.seq}if(msg.type==="count"){callbacks.setRowCount(msg.rowCount)}else if(msg.type==="rows"){callbacks.setRowData(msg.startIndex,msg.rows)}else{for(const u of msg.updates)callbacks.setRowData(u.index,[u.row])}};const scheduleReconnect=()=>{if(destroyed||!reconnectEnabled)return;const delay=Math.min(maxDelay,baseDelay*2**attempt);attempt+=1;cancelReconnect?.();cancelReconnect=scheduler.setTimer(()=>{cancelReconnect=null;connect()},delay)};const connect=()=>{if(destroyed)return;let s;try{s=factory(config.url,config.protocols)}catch{return}socket=s;open=false;s.onopen=()=>{attempt=0;open=true;lastSeq=-Infinity;rawSend(config.buildSubscribe?config.buildSubscribe():{type:"subscribe"});if(lastRange!==null)rawSend(rangeMessage(lastRange.firstRow,lastRange.lastRow))};s.onmessage=event=>handleMessage(event.data);s.onclose=()=>{if(socket===s)socket=null;open=false;if(!destroyed&&reconnectEnabled)scheduleReconnect()};s.onerror=()=>{}};return{init(cb){callbacks=cb;destroyed=false;attempt=0;connect()},setViewportRange(firstRow,lastRow){lastRange={firstRow,lastRow};rawSend(rangeMessage(firstRow,lastRow))},destroy(){destroyed=true;open=false;cancelReconnect?.();cancelReconnect=null;if(socket!==null){try{socket.close()}catch{}socket=null}callbacks=null}}}

package/dist/collection/components/grid/core/selection/canonical-ranges.js

@@ -0,0 +1 @@
+const sanitizeIndex=raw=>Number.isFinite(raw)?Math.max(0,Math.floor(raw)):0;const sanitizeCell=cell=>{const row=sanitizeIndex(cell.row);const col=sanitizeIndex(cell.col);return row===cell.row&&col===cell.col?cell:{row,col}};const clampIndex=(raw,count)=>Math.min(sanitizeIndex(raw),count-1);export function canonicalRangeBounds(range){return{top:Math.min(range.anchor.row,range.focus.row),left:Math.min(range.anchor.col,range.focus.col),bottom:Math.max(range.anchor.row,range.focus.row),right:Math.max(range.anchor.col,range.focus.col)}}export function isCellInCanonicalRanges(set,row,col){for(const range of set.ranges){const b=canonicalRangeBounds(range);if(row>=b.top&&row<=b.bottom&&col>=b.left&&col<=b.right)return true}return false}export function createCanonicalRangeSet(){return{ranges:[],nextId:1}}export function addCanonicalRange(set,anchor,focus){const cleanAnchor=sanitizeCell(anchor);const range={id:set.nextId,anchor:cleanAnchor,focus:focus===void 0?cleanAnchor:sanitizeCell(focus)};return{set:{ranges:[...set.ranges,range],nextId:set.nextId+1},changes:[{kind:"added",id:range.id,range}]}}export function extendCanonicalRange(set,id,focus){const index=set.ranges.findIndex(range2=>range2.id===id);if(index<0)return{set,changes:[]};const current=set.ranges[index];const nextFocus=sanitizeCell(focus);if(nextFocus.row===current.focus.row&&nextFocus.col===current.focus.col){return{set,changes:[]}}const range={id:current.id,anchor:current.anchor,focus:nextFocus};const ranges=[...set.ranges];ranges[index]=range;return{set:{ranges,nextId:set.nextId},changes:[{kind:"extended",id:range.id,range}]}}const sanitizeBounds=bounds=>{const top=sanitizeIndex(bounds.top);const left=sanitizeIndex(bounds.left);const bottom=sanitizeIndex(bounds.bottom);const right=sanitizeIndex(bounds.right);return{top:Math.min(top,bottom),left:Math.min(left,right),bottom:Math.max(top,bottom),right:Math.max(left,right)}};const rectangleRange=(id,top,left,bottom,right)=>({id,anchor:{row:top,col:left},focus:{row:bottom,col:right}});export function subtractCanonicalRange(set,bounds){const cut=sanitizeBounds(bounds);const ranges=[];const changes=[];let nextId=set.nextId;let changed=false;for(const range of set.ranges){const b=canonicalRangeBounds(range);const top=Math.max(b.top,cut.top);const bottom=Math.min(b.bottom,cut.bottom);const left=Math.max(b.left,cut.left);const right=Math.min(b.right,cut.right);if(top>bottom||left>right){ranges.push(range);continue}changed=true;changes.push({kind:"removed",id:range.id,range});const remainders=[];if(b.top<top)remainders.push(rectangleRange(nextId++,b.top,b.left,top-1,b.right));if(bottom<b.bottom){remainders.push(rectangleRange(nextId++,bottom+1,b.left,b.bottom,b.right))}if(b.left<left)remainders.push(rectangleRange(nextId++,top,b.left,bottom,left-1));if(right<b.right)remainders.push(rectangleRange(nextId++,top,right+1,bottom,b.right));for(const remainder of remainders){ranges.push(remainder);changes.push({kind:"subtracted",id:remainder.id,range:remainder,sourceId:range.id})}}if(!changed)return{set,changes:[]};return{set:{ranges,nextId},changes}}export function clampCanonicalRanges(set,counts){const{rowCount,columnCount}=counts;const changes=[];const dropped=[];const trimmed=[];if(rowCount<=0||columnCount<=0){if(set.ranges.length===0)return{set,changes:[],report:{dropped,trimmed}};for(const range of set.ranges){dropped.push(range);changes.push({kind:"removed",id:range.id,range})}return{set:{ranges:[],nextId:set.nextId},changes,report:{dropped,trimmed}}}const ranges=[];let changed=false;for(const range of set.ranges){const b=canonicalRangeBounds(range);if(b.top>=rowCount||b.left>=columnCount){changed=true;dropped.push(range);changes.push({kind:"removed",id:range.id,range});continue}const anchor={row:clampIndex(range.anchor.row,rowCount),col:clampIndex(range.anchor.col,columnCount)};const focus={row:clampIndex(range.focus.row,rowCount),col:clampIndex(range.focus.col,columnCount)};if(anchor.row===range.anchor.row&&anchor.col===range.anchor.col&&focus.row===range.focus.row&&focus.col===range.focus.col){ranges.push(range);continue}changed=true;const after={id:range.id,anchor,focus};ranges.push(after);trimmed.push({before:range,after});changes.push({kind:"extended",id:after.id,range:after})}if(!changed)return{set,changes:[],report:{dropped,trimmed}};return{set:{ranges,nextId:set.nextId},changes,report:{dropped,trimmed}}}export function toLegacyRanges(set){return set.ranges.map(range=>({anchorRow:range.anchor.row,anchorCol:range.anchor.col,focusRow:range.focus.row,focusCol:range.focus.col}))}export function fromLegacyRanges(ranges){let result={set:createCanonicalRangeSet(),changes:[]};const changes=[];for(const range of ranges){result=addCanonicalRange(result.set,{row:range.anchorRow,col:range.anchorCol},{row:range.focusRow,col:range.focusCol});changes.push(...result.changes)}return{set:result.set,changes}}

package/dist/collection/components/grid/core/selection/checkbox-column.js

@@ -0,0 +1 @@
+export const SELECTION_CHECKBOX_COLUMN=Object.freeze({kind:"selection-checkbox",width:40,field:"__sy_selection__",sortable:false,resizable:false,filter:false});export function headerCheckboxAttrs(state,ariaLabel){const ariaChecked=state==="all"?"true":state==="partial"?"mixed":"false";const safeLabel=typeof ariaLabel==="string"&&ariaLabel.length>0?ariaLabel:"Select all visible rows";return{role:"checkbox","aria-checked":ariaChecked,"aria-label":safeLabel,tabindex:0}}export function bodyCheckboxAttrs(isSelected,ariaLabel){const safeLabel=typeof ariaLabel==="string"&&ariaLabel.length>0?ariaLabel:"Select row";return{role:"checkbox","aria-checked":isSelected?"true":"false","aria-label":safeLabel,tabindex:0}}export function isCheckboxToggleKey(event){if(event===null||event===void 0)return false;if(typeof event!=="object")return false;const key=event.key;if(typeof key!=="string")return false;return key===" "||key==="Spacebar"||key==="Enter"}export function isSelectionCheckboxColumn(col){if(col===null||col===void 0)return false;if(typeof col!=="object")return false;const kind=col.kind;return kind==="selection-checkbox"}

package/dist/collection/components/grid/core/selection/range-bounds.js

@@ -0,0 +1 @@
+export function normalizeRange(range){return{top:Math.min(range.anchorRow,range.focusRow),left:Math.min(range.anchorCol,range.focusCol),bottom:Math.max(range.anchorRow,range.focusRow),right:Math.max(range.anchorCol,range.focusCol)}}

package/dist/collection/components/grid/core/selection/row.js

@@ -0,0 +1 @@
+export function isValidRowId(id){if(typeof id==="string")return id.length>0;if(typeof id==="number")return Number.isFinite(id);return false}function warnInvalidRowId(callerName){console.warn(`[Syidax] sy-grid: ${callerName} ignored invalid rowId.`)}export function createSelectionState(mode){const safeMode=mode==="single"||mode==="multi"||mode==="none"?mode:"none";if(safeMode!==mode){console.warn(`[Syidax] sy-grid: unknown rowSelection mode "${String(mode)}", falling back to "none".`)}return{mode:safeMode,selectedRowIds:new Set}}export function isRowSelected(state,rowId){if(!isValidRowId(rowId))return false;return state.selectedRowIds.has(rowId)}export function getSelectedIds(state){return Array.from(state.selectedRowIds)}export function getSelectionCount(state){return state.selectedRowIds.size}export function selectRow(state,rowId){if(!isValidRowId(rowId)){warnInvalidRowId("selectRow");return state}if(state.mode==="none")return state;if(state.mode==="single"){if(state.selectedRowIds.size===1&&state.selectedRowIds.has(rowId)){return state}const next2=new Set([rowId]);return{mode:state.mode,selectedRowIds:next2}}if(state.selectedRowIds.has(rowId))return state;const next=new Set(state.selectedRowIds);next.add(rowId);return{mode:state.mode,selectedRowIds:next}}export function deselectRow(state,rowId){if(!isValidRowId(rowId)){warnInvalidRowId("deselectRow");return state}if(!state.selectedRowIds.has(rowId))return state;const next=new Set(state.selectedRowIds);next.delete(rowId);return{mode:state.mode,selectedRowIds:next}}export function toggleRow(state,rowId){if(!isValidRowId(rowId)){warnInvalidRowId("toggleRow");return state}if(state.selectedRowIds.has(rowId)){return deselectRow(state,rowId)}return selectRow(state,rowId)}export function clearSelection(state){if(state.selectedRowIds.size===0)return state;return{mode:state.mode,selectedRowIds:new Set}}export function setSelectionMode(state,newMode){const safeMode=newMode==="single"||newMode==="multi"||newMode==="none"?newMode:"none";if(safeMode!==newMode){console.warn(`[Syidax] sy-grid: unknown rowSelection mode "${String(newMode)}", falling back to "none".`)}if(safeMode===state.mode){return state}if(safeMode==="none"){if(state.selectedRowIds.size===0){return{mode:"none",selectedRowIds:state.selectedRowIds}}return{mode:"none",selectedRowIds:new Set}}if(safeMode==="single"&&state.selectedRowIds.size>1){const iter=state.selectedRowIds.values();const first=iter.next();const next=new Set;if(!first.done)next.add(first.value);return{mode:"single",selectedRowIds:next}}return{mode:safeMode,selectedRowIds:state.selectedRowIds}}export function selectRowsBatch(state,rowIds){if(!Array.isArray(rowIds)||rowIds.length===0)return state;if(state.mode==="none")return state;if(state.mode==="single"){let first;for(const candidate of rowIds){if(isValidRowId(candidate)){first=candidate;break}}if(rowIds.length>1){console.warn("[Syidax] sy-grid: selectRowsBatch in single mode kept only the first id.")}if(first===void 0){warnInvalidRowId("selectRowsBatch");return state}return selectRow(state,first)}let next=null;for(const id of rowIds){if(!isValidRowId(id)){warnInvalidRowId("selectRowsBatch");continue}if(state.selectedRowIds.has(id)&&next===null)continue;if(next===null){next=new Set(state.selectedRowIds)}next.add(id)}if(next===null)return state;return{mode:state.mode,selectedRowIds:next}}export function deselectRowsBatch(state,rowIds){if(!Array.isArray(rowIds)||rowIds.length===0)return state;if(state.selectedRowIds.size===0){for(const id of rowIds){if(!isValidRowId(id)){warnInvalidRowId("deselectRowsBatch")}}return state}let next=null;for(const id of rowIds){if(!isValidRowId(id)){warnInvalidRowId("deselectRowsBatch");continue}if(!state.selectedRowIds.has(id))continue;if(next===null){next=new Set(state.selectedRowIds)}next.delete(id)}if(next===null)return state;return{mode:state.mode,selectedRowIds:next}}export function headerCheckboxState(state,visibleRowIds){if(!Array.isArray(visibleRowIds)||visibleRowIds.length===0){return"none"}let selectedCount=0;let consideredCount=0;for(const id of visibleRowIds){if(!isValidRowId(id))continue;consideredCount++;if(state.selectedRowIds.has(id))selectedCount++}if(consideredCount===0)return"none";if(selectedCount===0)return"none";if(selectedCount===consideredCount)return"all";return"partial"}export function findAnchorIndex(visibleRowIds,anchorRowId){if(anchorRowId===null)return null;if(!Array.isArray(visibleRowIds)||visibleRowIds.length===0)return null;if(!isValidRowId(anchorRowId))return null;for(let i=0;i<visibleRowIds.length;i++){if(visibleRowIds[i]===anchorRowId)return i}return null}export function selectRange(input){const{state,visibleRowIds,anchorRowId,targetRowId}=input;const additive=input.additive===true;if(state.mode==="none")return state;if(!isValidRowId(targetRowId)){warnInvalidRowId("selectRange");return state}if(state.mode==="single"){return selectRow(state,targetRowId)}if(anchorRowId===null){return selectRow(state,targetRowId)}if(!Array.isArray(visibleRowIds)||visibleRowIds.length===0){console.warn("[Syidax] sy-grid: selectRange called with empty visibleRowIds, treating as plain click.");return selectRow(state,targetRowId)}const anchorIndex=findAnchorIndex(visibleRowIds,anchorRowId);if(anchorIndex===null){console.warn("[Syidax] sy-grid: selectRange anchor not visible, treating as plain click.");return selectRow(state,targetRowId)}let targetIndex=-1;for(let i=0;i<visibleRowIds.length;i++){if(visibleRowIds[i]===targetRowId){targetIndex=i;break}}if(targetIndex===-1){console.warn("[Syidax] sy-grid: selectRange target not in visibleRowIds, dropping.");return state}const lo=Math.min(anchorIndex,targetIndex);const hi=Math.max(anchorIndex,targetIndex);const rangeIds=[];for(let i=lo;i<=hi;i++){const id=visibleRowIds[i];if(isValidRowId(id))rangeIds.push(id)}if(rangeIds.length===0)return state;if(additive){let next=null;for(const id of rangeIds){if(state.selectedRowIds.has(id))continue;if(next===null){next=new Set(state.selectedRowIds)}next.add(id)}if(next===null)return state;return{mode:state.mode,selectedRowIds:next}}if(state.selectedRowIds.size===rangeIds.length){let identical=true;for(const id of rangeIds){if(!state.selectedRowIds.has(id)){identical=false;break}}if(identical)return state}return{mode:state.mode,selectedRowIds:new Set(rangeIds)}}export function diffSelection(prev,next){const added=[];const removed=[];for(const id of next.selectedRowIds){if(!prev.selectedRowIds.has(id))added.push(id)}for(const id of prev.selectedRowIds){if(!next.selectedRowIds.has(id))removed.push(id)}return{addedIds:added,removedIds:removed}}

package/dist/collection/components/grid/core/side-bar/side-bar.js

@@ -0,0 +1 @@
+export const SIDE_BAR_PANEL_IDS=Object.freeze(["columns","filters"]);export const DEFAULT_SIDE_BAR_PANELS=Object.freeze([{id:"columns"},{id:"filters"}]);function isPanelId(value){return typeof value==="string"&&SIDE_BAR_PANEL_IDS.includes(value)}export function resolveSideBar(input){if(input===false||input===null||input===void 0)return null;if(input===true)return{panels:DEFAULT_SIDE_BAR_PANELS,defaultOpen:null,invalid:[]};if(typeof input==="string"){if(isPanelId(input))return{panels:[{id:input}],defaultOpen:input,invalid:[]};return{panels:DEFAULT_SIDE_BAR_PANELS,defaultOpen:null,invalid:[input]}}if(typeof input!=="object"){return{panels:DEFAULT_SIDE_BAR_PANELS,defaultOpen:null,invalid:[`sideBar value "${String(input)}" is not boolean/string/object`]}}const panelsInput=input.panels;const invalid=[];let panels;if(Array.isArray(panelsInput)){panels=[];const seen=new Set;for(const entry of panelsInput){const id=entry!==null&&typeof entry==="object"?entry.id:entry;if(!isPanelId(id)){invalid.push(String(id));continue}if(seen.has(id))continue;seen.add(id);panels.push({id})}}else if(panelsInput===void 0){panels=[...DEFAULT_SIDE_BAR_PANELS]}else{invalid.push("sideBar.panels is not an array");panels=[...DEFAULT_SIDE_BAR_PANELS]}const defaultOpenRaw=input.defaultOpen;let defaultOpen=null;if(defaultOpenRaw!==void 0&&defaultOpenRaw!==null){if(isPanelId(defaultOpenRaw)&&panels.some(p=>p.id===defaultOpenRaw)){defaultOpen=defaultOpenRaw}else{invalid.push(`defaultOpen: ${String(defaultOpenRaw)}`)}}return{panels,defaultOpen,invalid}}

package/dist/collection/components/grid/core/snapshot/snapshot-diff.js

@@ -0,0 +1 @@
+import{structuralClone,structuralEqual}from"../utils/structural.js";function defaultRowId(row,index){const r=row;if(r!==null&&typeof r==="object"&&"id"in r&&r.id!==void 0&&r.id!==null)return r.id;return`__index_${index}`}function isValidRowId(value){return typeof value==="string"&&value.length>0||typeof value==="number"&&Number.isFinite(value)}function displayRowId(value){if(typeof value==="string")return JSON.stringify(value);return Object.is(value,-0)?"-0":String(value)}function indexRows(rows,side,getRowId){const rowsById=new Map;const firstIndexById=new Map;for(let index=0;index<rows.length;index+=1){let id;try{id=getRowId(rows[index],index)}catch(cause){const error=new Error(`Snapshot diff ${side} row ${index} id resolver threw.`);error.cause=cause;throw error}if(!isValidRowId(id)){throw new TypeError(`Snapshot diff ${side} row ${index} has an invalid row id; expected a non-empty string or finite number.`)}if(rowsById.has(id)){throw new Error(`Snapshot diff ${side} rows ${firstIndexById.get(id)} and ${index} share duplicate row id ${displayRowId(id)}.`)}rowsById.set(id,rows[index]);firstIndexById.set(id,index)}return rowsById}function fieldKeys(a,b){const keys=new Set;for(const k of Object.keys(a))keys.add(k);for(const k of Object.keys(b))keys.add(k);return[...keys]}function rowFieldChanges(before,after){const out=[];for(const field of fieldKeys(before,after)){if(!structuralEqual(before[field],after[field])){out.push({field,before:structuralClone(before[field]),after:structuralClone(after[field])})}}return out}export function diffSnapshots(before,after,getRowId=defaultRowId){const beforeById=indexRows(before,"before",getRowId);const afterById=indexRows(after,"after",getRowId);const added=[];const removed=[];const changed=[];for(const[id,afterRow]of afterById){const beforeRow=beforeById.get(id);if(beforeRow===void 0){added.push(structuralClone(afterRow));continue}const fields=rowFieldChanges(beforeRow,afterRow);if(fields.length>0)changed.push({rowId:structuralClone(id),fields})}for(const[id,beforeRow]of beforeById){if(!afterById.has(id))removed.push(structuralClone(beforeRow))}return{added,removed,changed,summary:{added:added.length,removed:removed.length,changed:changed.length}}}

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

@@ -0,0 +1 @@
+import{structuralClone}from"../utils/structural.js";export const DEFAULT_MAX_SNAPSHOTS=20;export function normalizeSnapshotCap(value){const floored=Number.isFinite(value)?Math.floor(value):0;return floored>0?floored:DEFAULT_MAX_SNAPSHOTS}export function deepCloneRows(rows){if(typeof structuredClone==="function"){try{return structuredClone(rows)}catch{}}return structuralClone(rows)}export function createSnapshot(rows,meta){return{id:meta.id,name:meta.name,ts:meta.ts,rows:deepCloneRows(rows)}}export function snapshotMeta(snap){return{id:snap.id,name:snap.name,ts:snap.ts,rowCount:snap.rows.length}}export function addSnapshot(list,snap,maxSnapshots){const next=[...list,snap];const cap=normalizeSnapshotCap(maxSnapshots);return next.length>cap?next.slice(next.length-cap):next}export function removeSnapshot(list,id){return list.filter(s=>s.id!==id)}export function getSnapshot(list,id){return list.find(s=>s.id===id)??null}

package/dist/collection/components/grid/core/sort-cycle.js

@@ -0,0 +1 @@
+export function nextSortDirection(current){if(current===null)return"asc";if(current==="asc")return"desc";return null}export function cycleActiveSort(prev,field){if(!prev||prev.field!==field){return{field,direction:"asc"}}const nextDir=nextSortDirection(prev.direction);if(nextDir===null)return null;return{field,direction:nextDir}}export function pickInitialActiveSort(columns){for(const col of columns){if(!col||typeof col.field!=="string"||!col.field)continue;if(col.sortable===false)continue;if(col.sort==="asc"||col.sort==="desc"){return{field:col.field,direction:col.sort}}}return null}

package/dist/collection/components/grid/core/sort-model.js

@@ -0,0 +1 @@
+import{cycleActiveSort,nextSortDirection,pickInitialActiveSort}from"./sort-cycle.js";export function cycleSortModel(prev,field,mode){const existing=prev.find(entry=>entry.field===field)??null;if(mode==="replace"){const next=cycleActiveSort(existing?{field:existing.field,direction:existing.direction}:null,field);return next===null?[]:[{field:next.field,direction:next.direction}]}if(existing===null){return[...prev,{field,direction:"asc"}]}const nextDirection=nextSortDirection(existing.direction);if(nextDirection===null){return prev.filter(entry=>entry.field!==field)}return prev.map(entry=>entry.field===field?{field,direction:nextDirection}:entry)}export function seedInitialSortModel(columns,opts){if(!opts.multi){const single=pickInitialActiveSort(columns);return single===null?[]:[{field:single.field,direction:single.direction}]}const seeds=[];const seen=new Set;for(let position=0;position<columns.length;position++){const col=columns[position];if(!col||typeof col.field!=="string"||!col.field)continue;if(col.sortable===false)continue;if(col.sort!=="asc"&&col.sort!=="desc")continue;if(seen.has(col.field))continue;seen.add(col.field);seeds.push({entry:{field:col.field,direction:col.sort},sortIndex:typeof col.sortIndex==="number"&&Number.isFinite(col.sortIndex)?col.sortIndex:Number.POSITIVE_INFINITY,position})}seeds.sort((a,b)=>a.sortIndex-b.sortIndex||a.position-b.position);return seeds.map(seed=>seed.entry)}export function sortModelsEqual(a,b){if(a.length!==b.length)return false;for(let i=0;i<a.length;i++){if(a[i].field!==b[i].field||a[i].direction!==b[i].direction)return false}return true}export function normalizeSortModel(model){if(!Array.isArray(model))return[];const out=[];const seen=new Set;for(const raw of model){if(!raw||typeof raw!=="object")continue;const field=raw.field;const direction=raw.direction;if(typeof field!=="string"||field==="")continue;if(direction!=="asc"&&direction!=="desc")continue;if(seen.has(field))continue;seen.add(field);out.push({field,direction})}return out}

package/dist/collection/components/grid/core/spreadsheet-text.js

@@ -0,0 +1 @@
+const LEADING_CONTROL=/^[\u0000-\u001f\u007f-\u009f]/;const FORMULA_AFTER_IGNORABLE_PREFIX=/^[\s\u0000-\u001f\u007f-\u009f\ufeff]*[=+\-@\uff1d\uff0b\uff0d\uff20]/;export function hasSpreadsheetFormulaPrefix(value){if(typeof value!=="string"||value.length===0)return false;return LEADING_CONTROL.test(value)||FORMULA_AFTER_IGNORABLE_PREFIX.test(value)}export function isTextualSpreadsheetValue(value){if(value===null||value===void 0)return false;if(typeof value==="string")return true;if(typeof value==="number"||typeof value==="bigint"||typeof value==="boolean")return false;if(value instanceof Date)return false;return true}export function neutralizeSpreadsheetText(value,options={}){const text=typeof value==="string"?value:String(value??"");const textual=options.textual??isTextualSpreadsheetValue(value);if(options.escapeFormulae===false||!textual||!hasSpreadsheetFormulaPrefix(text))return text;return`'${text}`}

package/dist/collection/components/grid/core/state/canonical.js

@@ -0,0 +1 @@
+export const MAX_GRID_STATE_DEPTH=32;const issue=(path,kind,detail)=>({path,kind,detail});function isPlainObject(value){const prototype=Object.getPrototypeOf(value);return prototype===Object.prototype||prototype===null}function canonicalizeInto(value,path,depth,seen,issues){if(value===null)return null;switch(typeof value){case"string":case"boolean":return value;case"number":if(!Number.isFinite(value)){issues.push(issue(path,"non-finite-number",`${value} is not JSON-serializable`));return null}return value===0?0:value;case"bigint":issues.push(issue(path,"bigint","bigint is not JSON-serializable"));return null;case"function":issues.push(issue(path,"function","functions cannot be part of grid state"));return null;case"symbol":issues.push(issue(path,"symbol","symbols cannot be part of grid state"));return null;case"undefined":issues.push(issue(path,"undefined-in-array","undefined is not JSON-serializable"));return null;default:break}const objectValue=value;if(depth>=MAX_GRID_STATE_DEPTH){issues.push(issue(path,"excessive-depth",`nesting exceeds ${MAX_GRID_STATE_DEPTH} levels`));return null}if(seen.has(objectValue)){issues.push(issue(path,"circular-reference","value references itself"));return null}if(Array.isArray(objectValue)){seen.add(objectValue);const result2=[];for(let index=0;index<objectValue.length;index+=1){const slot=`${path}/${index}`;if(!Object.hasOwn(objectValue,index)||objectValue[index]===void 0){issues.push(issue(slot,"undefined-in-array","arrays may not contain undefined holes"));continue}result2.push(canonicalizeInto(objectValue[index],slot,depth+1,seen,issues))}seen.delete(objectValue);return result2}if(!isPlainObject(objectValue)){const name=objectValue.constructor?.name??"unknown";issues.push(issue(path,"unsupported-object",`${name} instances are not plain serializable objects`));return null}seen.add(objectValue);const record=objectValue;const result={};for(const key of Object.keys(record).sort()){if(record[key]===void 0)continue;if(key==="__proto__"){issues.push(issue(`${path}/${key}`,"unsupported-object","prototype-pollution key rejected"));continue}result[key]=canonicalizeInto(record[key],`${path}/${key}`,depth+1,seen,issues)}seen.delete(objectValue);return result}export function canonicalizeGridStateValue(value){const issues=[];const canonical=canonicalizeInto(value,"$",0,new WeakSet,issues);return issues.length>0?{value:null,issues}:{value:canonical,issues}}export function stringifyCanonicalGridState(value){return JSON.stringify(value)}export function canonicalGridStateEquals(left,right){const leftResult=canonicalizeGridStateValue(left);if(leftResult.issues.length>0)return false;const rightResult=canonicalizeGridStateValue(right);if(rightResult.issues.length>0)return false;return stringifyCanonicalGridState(leftResult.value)===stringifyCanonicalGridState(rightResult.value)}

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

@@ -0,0 +1 @@
+export const SY_GRID_STATE_VERSION="sy-grid-state/1.0.0";export const SY_GRID_STATE_SLICE_KEYS=Object.freeze(["columns","filter","rowGrouping","pivot","expansion","selection","focus","scroll","pagination","pinnedRows","sideBar","find"]);

package/dist/collection/components/grid/core/state/filter-handlers.js

@@ -0,0 +1 @@
+import{canonicalizeGridStateValue,stringifyCanonicalGridState}from"./canonical.js";export function createFilterHandlerRegistry(){const handlers=new Map;return{register(colId,handler){if(typeof colId!=="string"||colId.length===0){throw new TypeError("filter handler colId must be a non-empty string")}if(handlers.has(colId)){throw new TypeError(`duplicate filter handler for column "${colId}"`)}if(typeof handler?.doesPass!=="function"||typeof handler.serverSerializable!=="boolean"){throw new TypeError(`filter handler for "${colId}" is malformed`)}handlers.set(colId,handler)},resolve(colId){return handlers.get(colId)??null},get size(){return handlers.size}}}const INJECTION_KEYS=new Set(["__proto__","constructor","prototype"]);const INJECTION_SCAN_MAX_DEPTH=32;const hasInjectionKey=(value,path,issues,depth=0,seen=new WeakSet)=>{if(value===null||typeof value!=="object")return;if(depth>=INJECTION_SCAN_MAX_DEPTH){issues.push({path,detail:`nesting exceeds ${INJECTION_SCAN_MAX_DEPTH} levels`});return}if(seen.has(value)){issues.push({path,detail:"circular reference rejected"});return}seen.add(value);if(Array.isArray(value)){value.forEach((entry,index)=>hasInjectionKey(entry,`${path}/${index}`,issues,depth+1,seen));seen.delete(value);return}for(const key of Object.keys(value)){if(INJECTION_KEYS.has(key)){issues.push({path:`${path}/${key}`,detail:"prototype-pollution key rejected"});continue}hasInjectionKey(value[key],`${path}/${key}`,issues,depth+1,seen)}seen.delete(value)};export function deserializeFilterHandlerModel(raw){const issues=[];hasInjectionKey(raw,"$",issues);const canonical=canonicalizeGridStateValue(raw);for(const violation of canonical.issues){issues.push({path:violation.path,detail:`${violation.kind}: ${violation.detail}`})}return issues.length>0?{ok:false,model:null,issues}:{ok:true,model:canonical.value,issues:[]}}export function evaluateFilterHandlers(rows,models,registry){const unsupportedColumns=[];const active=[];for(const colId of Object.keys(models).sort()){const handler=registry.resolve(colId);if(handler===null){unsupportedColumns.push(colId);continue}active.push({handler,model:models[colId]})}const rowsOut=unsupportedColumns.length>0?[]:rows.filter(row=>active.every(entry=>entry.handler.doesPass(row,entry.model)));return{rows:rowsOut,report:{unsupportedColumns}}}export function serializeFilterHandlerModels(models,registry){const withheldColumns=[];const serializable={};for(const colId of Object.keys(models).sort()){const handler=registry.resolve(colId);if(handler===null||!handler.serverSerializable){withheldColumns.push(colId);continue}const canonical=canonicalizeGridStateValue(models[colId]);if(canonical.issues.length>0){withheldColumns.push(colId);continue}serializable[colId]=canonical.value}const canonicalPayload=canonicalizeGridStateValue(serializable);return{payload:stringifyCanonicalGridState(canonicalPayload.value),report:{withheldColumns}}}

package/dist/collection/components/grid/core/state/find-state.js

@@ -0,0 +1 @@
+export function validateFindSlice(value){if(value===null||typeof value!=="object"||Array.isArray(value)){return[{path:"$",detail:"find slice must be an object"}]}const issues=[];const record=value;if(typeof record.query!=="string"){issues.push({path:"$/query",detail:"query must be a string"})}if(typeof record.caseSensitive!=="boolean"){issues.push({path:"$/caseSensitive",detail:"caseSensitive must be a boolean"})}if(record.scope!=="visible"&&record.scope!=="all"){issues.push({path:"$/scope",detail:'scope must be "visible" or "all"'})}if(record.displayValues!==void 0&&typeof record.displayValues!=="boolean")issues.push({path:"$/displayValues",detail:"displayValues must be a boolean"});return issues}

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

@@ -0,0 +1 @@
+import{SY_GRID_STATE_SLICE_KEYS,SY_GRID_STATE_VERSION}from"./contracts.js";import{validateGridStateEnvelope}from"./validate.js";import{canonicalizeGridStateValue}from"./canonical.js";import{applyColumnsSlice,captureColumnsSlice,validateColumnsSlice}from"./slices/columns.js";import{applyFilterSlice,captureFilterSlice,validateFilterSlice}from"./slices/filter.js";import{applyRowsSlices,captureRowsSlices,validateExpansionSlice,validatePivotSlice,validateRowGroupingSlice,validateSelectionSlice}from"./slices/rows.js";import{captureUiSlices,planUiRestore,validateFocusSlice,validatePaginationSlice,validatePinnedRowsSlice,validateScrollSlice,validateSideBarSlice}from"./slices/ui.js";import{validateFindSlice}from"./find-state.js";export function buildGridState(input){const columns=captureColumnsSlice(input.columns);const filter=captureFilterSlice(input.filter);const rows=captureRowsSlices(input.rows);const ui=captureUiSlices(input.ui);const validation=validateGridStateEnvelope({version:SY_GRID_STATE_VERSION,slices:{columns,filter:filter.slice,rowGrouping:rows.rowGrouping,pivot:rows.pivot,expansion:rows.expansion,selection:rows.selection,focus:ui.focus,scroll:ui.scroll,pagination:ui.pagination,pinnedRows:ui.pinnedRows,sideBar:ui.sideBar,...input.find===void 0?{}:{find:input.find}}});if(!validation.ok||validation.state===null){throw new TypeError(`grid state capture produced an invalid envelope: ${validation.issues.map(issue=>`${issue.path} ${issue.detail}`).join("; ")}`)}return{state:validation.state,issues:filter.issues}}const SLICE_VALIDATORS={columns:validateColumnsSlice,filter:validateFilterSlice,rowGrouping:validateRowGroupingSlice,pivot:validatePivotSlice,expansion:validateExpansionSlice,selection:validateSelectionSlice,focus:validateFocusSlice,scroll:validateScrollSlice,pagination:validatePaginationSlice,pinnedRows:validatePinnedRowsSlice,sideBar:validateSideBarSlice,find:validateFindSlice};const EMPTY_ROWS={rowGrouping:{collapsedGroupRoutes:[]},pivot:{collapsedGroupRoutes:[]},expansion:{collapsedTreeNodePaths:[],expandedDetailRowIds:[]},selection:{rows:{mode:"none",ids:[]},ranges:[]}};const EMPTY_UI={focus:{activeCell:null},scroll:{top:0,left:0},pagination:{pageIndex:0,pageSize:25},sideBar:{openPanelId:null},pinnedRows:{topRowIds:[],bottomRowIds:[]}};export function planGridStateApply(value,contexts,options={}){const envelope=validateGridStateEnvelope(value,{unknownSlices:"report-and-ignore"});const issues=[...envelope.issues];if(!envelope.ok||envelope.state===null){return{ok:false,issues,requestedAbsentSlices:[],unrestorableSlices:[],appliedSlices:[],columns:null,filter:null,rows:null,ui:null}}const state=envelope.state;const present=SY_GRID_STATE_SLICE_KEYS.filter(key=>key in state.slices);const requested=options.slices===void 0?present:SY_GRID_STATE_SLICE_KEYS.filter(key=>options.slices?.includes(key));const requestedAbsentSlices=requested.filter(key=>!present.includes(key));const selected=new Set(requested.filter(key=>present.includes(key)));const unrestorableSlices=[];if(selected.has("find")&&contexts.findAvailable!==true){selected.delete("find");unrestorableSlices.push("find")}for(const key of selected){for(const issue of SLICE_VALIDATORS[key](state.slices[key])){issues.push({code:"non-serializable",path:`$/slices/${key}${issue.path.slice(1)}`,detail:issue.detail})}}const fatal=issues.some(issue=>issue.code!=="unknown-slice");if(fatal){return{ok:false,issues,requestedAbsentSlices,unrestorableSlices,appliedSlices:[],columns:null,filter:null,rows:null,ui:null}}const columns=selected.has("columns")?applyColumnsSlice(state.slices.columns,contexts.liveFields,{applyOrder:options.applyOrder??true}):null;const filter=selected.has("filter")?applyFilterSlice(state.slices.filter,contexts.filter):null;const rowsSelected=["rowGrouping","pivot","expansion","selection"].filter(key=>selected.has(key));const rows=rowsSelected.length>0?applyRowsSlices({rowGrouping:selected.has("rowGrouping")?state.slices.rowGrouping:EMPTY_ROWS.rowGrouping,pivot:selected.has("pivot")?state.slices.pivot:EMPTY_ROWS.pivot,expansion:selected.has("expansion")?state.slices.expansion:EMPTY_ROWS.expansion,selection:selected.has("selection")?state.slices.selection:EMPTY_ROWS.selection},contexts.rows):null;const uiSelected=["focus","scroll","pagination","pinnedRows","sideBar"].filter(key=>selected.has(key));const ui=uiSelected.length>0?planUiRestore({focus:selected.has("focus")?state.slices.focus:EMPTY_UI.focus,scroll:selected.has("scroll")?state.slices.scroll:EMPTY_UI.scroll,pagination:selected.has("pagination")?state.slices.pagination:EMPTY_UI.pagination,sideBar:selected.has("sideBar")?state.slices.sideBar:EMPTY_UI.sideBar,pinnedRows:selected.has("pinnedRows")?state.slices.pinnedRows:EMPTY_UI.pinnedRows},contexts.ui):null;return{ok:true,issues,requestedAbsentSlices,unrestorableSlices,appliedSlices:[...selected].sort(),...selected.has("find")?{find:state.slices.find}:{},columns,filter,rows,ui}}export function summarizeGridStatePlan(plan,afterDataPending){return{ok:plan.ok,issues:plan.issues,appliedSlices:plan.appliedSlices,requestedAbsentSlices:plan.requestedAbsentSlices,unrestorableSlices:plan.unrestorableSlices,columns:plan.columns?.report??null,filter:plan.filter?.report??null,rows:plan.rows?.report??null,uiUnavailable:plan.ui?.unavailable??[],afterDataPending,appliedMigrations:[],droppedSlices:[]}}export function cloneGridState(state){const canonical=canonicalizeGridStateValue(state);if(canonical.issues.length>0){throw new TypeError("grid state failed to clone canonically")}return canonical.value}

package/dist/collection/components/grid/core/state/migrate.js

@@ -0,0 +1 @@
+import{SY_GRID_STATE_VERSION}from"./contracts.js";import{parseGridStateVersion,validateGridStateEnvelope}from"./validate.js";const isRecord=value=>value!==null&&typeof value==="object"&&!Array.isArray(value);const versionBelow=(left,boundary)=>{const[major,minor,patch]=boundary.split(".").map(Number);if(left.major!==major)return left.major<major;if(left.minor!==minor)return left.minor<minor;return left.patch<patch};export const GRID_STATE_MIGRATIONS=Object.freeze([{id:"v0.8-flat-bags-to-v0.9-slices",untilVersion:"0.9.0",migrate(value,context){const slices=isRecord(value.slices)?{...value.slices}:{};if("columnState"in slices){slices.columns=slices.columnState;delete slices.columnState}if("filterState"in slices){slices.filter=slices.filterState;delete slices.filterState}if("panels"in slices){context.dropSlice("panels","the 0.8 panels bag has no modern equivalent");delete slices.panels}return{...value,version:"sy-grid-state/0.9.0",slices}}},{id:"v0.9-to-v1.0-envelope",untilVersion:"1.0.0",migrate(value){return{...value,version:SY_GRID_STATE_VERSION}}}]);export function migrateGridState(value,migrations=GRID_STATE_MIGRATIONS){const failure=(issues,applied2=[],dropped2=[])=>({ok:false,state:null,issues,appliedMigrations:applied2,droppedSlices:dropped2});if(!isRecord(value)){return failure([{code:"not-an-object",path:"$",detail:"grid state must be a plain object envelope"}])}const parsed=parseGridStateVersion(value.version);if(!parsed){return failure([{code:"malformed-version",path:"$/version",detail:`"${String(value.version)}" does not match sy-grid-state/<major>.<minor>.<patch>`}])}if("slices"in value&&!isRecord(value.slices)){return failure([{code:"malformed-slices",path:"$/slices",detail:"slices must be a plain object keyed by slice name"}])}const current=parseGridStateVersion(SY_GRID_STATE_VERSION);if(current&&parsed.major>current.major){return failure([{code:"newer-major-version",path:"$/version",detail:`state major ${parsed.major} is newer than runtime major ${current.major}; refusing to migrate backwards`}])}const applied=[];const dropped=[];const context={dropSlice(slice,reason){dropped.push({slice,reason})}};let working={...value};for(const step of migrations){const version=parseGridStateVersion(working.version);if(!version||!versionBelow(version,step.untilVersion))continue;let next;try{next=step.migrate(working,context)}catch(error){return failure([{code:"non-serializable",path:"$",detail:`migration ${step.id} threw: ${error instanceof Error?error.message:String(error)}`}],applied,dropped)}if(!isRecord(next)||!parseGridStateVersion(next.version)){return failure([{code:"malformed-version",path:"$/version",detail:`migration ${step.id} produced an invalid envelope version`}],applied,dropped)}working=next;applied.push(step.id)}const validation=validateGridStateEnvelope(working,{unknownSlices:"report-and-ignore"});if(!validation.ok||validation.state===null){return failure(validation.issues.map(issue=>({...issue,detail:applied.length>0?`${issue.detail} (after ${applied[applied.length-1]})`:issue.detail})),applied,dropped)}return{ok:true,state:{version:SY_GRID_STATE_VERSION,slices:validation.state.slices},issues:validation.issues,appliedMigrations:applied,droppedSlices:dropped}}

package/dist/collection/components/grid/core/state/ownership.js

@@ -0,0 +1 @@
+export const SY_GRID_STATE_SLICE_OWNERS=Object.freeze({columns:"column-model",filter:"filter-model",rowGrouping:"row-grouping",pivot:"pivot",expansion:"row-expansion",selection:"selection-model",focus:"navigation",scroll:"viewport",pagination:"pagination",pinnedRows:"pinned-rows",sideBar:"side-bar",find:"find"});

package/dist/collection/components/grid/core/state/persistence.js

@@ -0,0 +1 @@
+import{canonicalGridStateEquals,canonicalizeGridStateValue,stringifyCanonicalGridState}from"./canonical.js";import{migrateGridState}from"./migrate.js";export const DEFAULT_GRID_STATE_TRANSPORT_BUDGET_BYTES=6*1024;export const GRID_STATE_PII_BEARING_SLICES=Object.freeze(["filter","find"]);const BASE64_URL_ALPHABET="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";const toBase64Url=json=>{const bytes=new TextEncoder().encode(json);let out="";for(let index=0;index<bytes.length;index+=3){const a=bytes[index];const b=index+1<bytes.length?bytes[index+1]:null;const c=index+2<bytes.length?bytes[index+2]:null;out+=BASE64_URL_ALPHABET[a>>2];out+=BASE64_URL_ALPHABET[(a&3)<<4|(b??0)>>4];if(b!==null)out+=BASE64_URL_ALPHABET[(b&15)<<2|(c??0)>>6];if(c!==null)out+=BASE64_URL_ALPHABET[c&63]}return out};const fromBase64Url=encoded=>{if(!/^[A-Za-z0-9_-]+$/u.test(encoded))return null;const values=[];for(const char of encoded){const value=BASE64_URL_ALPHABET.indexOf(char);if(value<0)return null;values.push(value)}if(values.length%4===1)return null;const bytes=[];for(let index=0;index<values.length;index+=4){const[a,b,c,d]=[values[index],values[index+1],values[index+2],values[index+3]];if(b===void 0)return null;bytes.push((a<<2|b>>4)&255);if(c!==void 0)bytes.push((b<<4|c>>2)&255);if(d!==void 0)bytes.push((c<<6|d)&255)}try{return new TextDecoder("utf-8",{fatal:true}).decode(Uint8Array.from(bytes))}catch{return null}};export function encodeGridStateForTransport(state,{maxJsonBytes=DEFAULT_GRID_STATE_TRANSPORT_BUDGET_BYTES}={}){const canonical=canonicalizeGridStateValue(state);if(canonical.issues.length>0){return{ok:false,encoded:null,jsonBytes:0,issues:canonical.issues.map(issue=>({code:"non-serializable",path:issue.path,detail:`${issue.kind}: ${issue.detail}`}))}}const json=stringifyCanonicalGridState(canonical.value);const jsonBytes=new TextEncoder().encode(json).byteLength;if(jsonBytes>maxJsonBytes){return{ok:false,encoded:null,jsonBytes,issues:[{code:"non-serializable",path:"$",detail:`state is ${jsonBytes} bytes, over the ${maxJsonBytes}-byte transport budget; persist fewer slices or use a server profile`}]}}return{ok:true,encoded:toBase64Url(json),jsonBytes,issues:[]}}export function decodeGridStateFromTransport(encoded){const json=typeof encoded==="string"&&encoded.length>0?fromBase64Url(encoded):null;if(json===null){return{ok:false,state:null,issues:[{code:"not-an-object",path:"$",detail:"transported grid state is not valid base64url"}],appliedMigrations:[],droppedSlices:[]}}let parsed;try{parsed=JSON.parse(json)}catch{return{ok:false,state:null,issues:[{code:"not-an-object",path:"$",detail:"transported grid state is not valid JSON"}],appliedMigrations:[],droppedSlices:[]}}return migrateGridState(parsed)}export function redactGridState(state,slices=GRID_STATE_PII_BEARING_SLICES){const remaining={};const redacted=[];for(const[key,value]of Object.entries(state.slices)){if(slices.includes(key)){redacted.push(key)}else{remaining[key]=value}}return{state:{version:state.version,slices:remaining},redactedSlices:redacted.sort()}}export function gridStatesEquivalent(left,right){return canonicalGridStateEquals(left,right)}export function namespacedGridStateKey(namespace,gridId){if(typeof namespace!=="string"||namespace.length===0||typeof gridId!=="string"||gridId.length===0){throw new TypeError("namespace and gridId must be non-empty strings")}return`sy-grid-state:${namespace}:${gridId}`}

package/dist/collection/components/grid/core/state/slices/columns.js

@@ -0,0 +1 @@
+import{computeApplyColumnState,computeColumnState}from"../../column/column-state.js";const indexOfField=(fields,field)=>{if(!fields)return null;const index=fields.indexOf(field);return index<0?null:index};export function captureColumnsSlice(input){const base=computeColumnState(input);const entries=base.map(entry=>({colId:entry.field,width:entry.width,order:entry.order,hidden:entry.hidden,pinned:entry.pinned??null,sort:entry.isSorted&&entry.sortDirection!==null?{direction:entry.sortDirection,index:typeof entry.sortIndex==="number"?entry.sortIndex:0}:null,aggFunc:input.aggFuncs?.get(entry.field)??null,rowGroupIndex:indexOfField(input.rowGroupFields,entry.field),pivotRowGroupIndex:indexOfField(input.pivotRowGroupFields,entry.field),pivotIndex:indexOfField(input.pivotFields,entry.field),valueIndex:indexOfField(input.valueFields,entry.field)}));return{entries,collapsedGroupIds:[...input.collapsedGroupIds??[]].sort(),pivotMode:input.pivotMode??false}}const byIndex=(entries,read)=>entries.map((entry,position)=>({entry,position,index:read(entry)})).filter(item=>item.index!==null).sort((left,right)=>left.index-right.index||left.position-right.position).map(item=>item.entry.colId);export function applyColumnsSlice(slice,liveFields,options={}){const liveSet=new Set(liveFields);const sliceIds=new Set;const known=[];const missingColumns=[];for(const entry of slice.entries){if(sliceIds.has(entry.colId))continue;sliceIds.add(entry.colId);if(liveSet.has(entry.colId))known.push(entry);else missingColumns.push(entry.colId)}const newColumns=liveFields.filter(field=>!sliceIds.has(field));const columnEntries=known.map(entry=>({field:entry.colId,width:entry.width,order:entry.order,hidden:entry.hidden,sortDirection:entry.sort?.direction??null,isSorted:entry.sort!==null,sortIndex:entry.sort?.index??null,pinned:entry.pinned}));const aggFuncs=new Map;for(const entry of known)aggFuncs.set(entry.colId,entry.aggFunc);const computed=computeApplyColumnState(columnEntries,{applyOrder:options.applyOrder??true});const pristineOrder=known.length>0&&known.every(entry=>entry.order===null);const columnState=pristineOrder?{...computed,order:null}:computed;return{columnState,aggFuncs,rowGroupFields:byIndex(known,entry=>entry.rowGroupIndex),pivotRowGroupFields:byIndex(known,entry=>entry.pivotRowGroupIndex),pivotMode:slice.pivotMode,pivotFields:byIndex(known,entry=>entry.pivotIndex),valueFields:byIndex(known,entry=>entry.valueIndex),collapsedGroupIds:[...slice.collapsedGroupIds].sort(),report:{missingColumns,newColumns}}}const isRecord=value=>value!==null&&typeof value==="object"&&!Array.isArray(value);const isNullableString=value=>value===null||typeof value==="string";const isNullableInteger=value=>value===null||typeof value==="number"&&Number.isInteger(value)&&value>=0;export function validateColumnsSlice(value){const issues=[];if(!isRecord(value)){return[{path:"$",detail:"columns slice must be an object"}]}if(!Array.isArray(value.entries)){issues.push({path:"$/entries",detail:"entries must be an array"})}else{const seen=new Set;value.entries.forEach((entry,index)=>{const path=`$/entries/${index}`;if(!isRecord(entry)){issues.push({path,detail:"entry must be an object"});return}if(typeof entry.colId!=="string"||entry.colId.length===0){issues.push({path:`${path}/colId`,detail:"colId must be a non-empty string"})}else if(seen.has(entry.colId)){issues.push({path:`${path}/colId`,detail:`duplicate colId "${entry.colId}"`})}else{seen.add(entry.colId)}if(entry.width!==null&&(typeof entry.width!=="number"||!Number.isFinite(entry.width)||entry.width<0)){issues.push({path:`${path}/width`,detail:"width must be null or a non-negative finite number"})}if(!isNullableInteger(entry.order)){issues.push({path:`${path}/order`,detail:"order must be null or a non-negative integer"})}if(typeof entry.hidden!=="boolean"){issues.push({path:`${path}/hidden`,detail:"hidden must be a boolean"})}if(entry.pinned!==null&&entry.pinned!=="left"&&entry.pinned!=="right"){issues.push({path:`${path}/pinned`,detail:'pinned must be null, "left", or "right"'})}if(entry.sort!==null){if(!isRecord(entry.sort)||entry.sort.direction!=="asc"&&entry.sort.direction!=="desc"||!Number.isInteger(entry.sort.index)||entry.sort.index<0){issues.push({path:`${path}/sort`,detail:"sort must be null or { direction: asc|desc, index: >=0 }"})}}if(!isNullableString(entry.aggFunc)){issues.push({path:`${path}/aggFunc`,detail:"aggFunc must be null or a string"})}for(const key of["rowGroupIndex","pivotRowGroupIndex","pivotIndex","valueIndex"]){if(!isNullableInteger(entry[key])){issues.push({path:`${path}/${key}`,detail:`${key} must be null or a non-negative integer`})}}})}if(!Array.isArray(value.collapsedGroupIds)||value.collapsedGroupIds.some(id=>typeof id!=="string"||id.length===0)){issues.push({path:"$/collapsedGroupIds",detail:"collapsedGroupIds must be an array of non-empty strings"})}if(typeof value.pivotMode!=="boolean"){issues.push({path:"$/pivotMode",detail:"pivotMode must be a boolean"})}return issues}

package/dist/collection/components/grid/core/state/slices/filter.js

@@ -0,0 +1 @@
+import{parseConditionTree,serializeConditionTree,validateConditionNode}from"../../filter/condition-builder.js";import{canonicalizeGridStateValue}from"../canonical.js";const FILTER_KINDS=new Set(["text","number","date","set","multi"]);export function captureFilterSlice(input){const issues=[];const builtIn={};for(const field of Object.keys(input.activeFilters).sort()){const filter=input.activeFilters[field];const canonical=canonicalizeGridStateValue(filter);if(canonical.issues.length>0){for(const violation of canonical.issues){issues.push({path:`$/builtIn/${field}${violation.path.slice(1)}`,detail:`built-in filter not serializable (${violation.kind}): ${violation.detail}`})}continue}builtIn[field]=canonical.value}let customModels=null;if(input.customModels!==null){customModels={};for(const colId of Object.keys(input.customModels).sort()){const canonical=canonicalizeGridStateValue(input.customModels[colId]);if(canonical.issues.length>0){for(const violation of canonical.issues){issues.push({path:`$/customModels/${colId}${violation.path.slice(1)}`,detail:`custom filter model not serializable (${violation.kind}): ${violation.detail}`})}continue}customModels[colId]=canonical.value}}for(const error of input.customModelErrors??[]){issues.push({path:"$/customModels",detail:`facade snapshot error: ${error}`})}let conditionTree=null;if(input.conditionTree!==null){try{conditionTree=serializeConditionTree(input.conditionTree)}catch(error){issues.push({path:"$/conditionTree",detail:`condition tree failed to serialize: ${error instanceof Error?error.message:String(error)}`})}}return{slice:{builtIn,customModels,quickFilter:input.quickFilter,conditionTree,externalFilterActive:input.externalFilterActive},issues}}const isRecord=value=>value!==null&&typeof value==="object"&&!Array.isArray(value);export function applyFilterSlice(slice,context){const liveFields=new Set(context.fields);const builtIn={};const unknownBuiltInColumns=[];const invalidBuiltIn=[];for(const colId of Object.keys(slice.builtIn).sort()){const entry=slice.builtIn[colId];if(!liveFields.has(colId)){unknownBuiltInColumns.push(colId);continue}if(!isRecord(entry)||typeof entry.kind!=="string"||!FILTER_KINDS.has(entry.kind)||entry.field!==colId||!isRecord(entry.spec)){invalidBuiltIn.push({path:`$/builtIn/${colId}`,detail:"entry must be an ActiveFilter whose field matches its column id"});continue}builtIn[colId]=entry}const customModels={};const unavailableCustomFilters=[];for(const colId of Object.keys(slice.customModels??{}).sort()){if(context.customFilterColumnIds.has(colId)){customModels[colId]=slice.customModels[colId]}else{unavailableCustomFilters.push(colId)}}let conditionTree=null;let conditionTreeError=null;if(slice.conditionTree!==null){try{const parsed=parseConditionTree(slice.conditionTree);const validation=validateConditionNode(parsed);if(validation.ok){conditionTree=parsed}else{conditionTreeError=validation.errors.join("; ")}}catch(error){conditionTreeError=error instanceof Error?error.message:String(error)}}return{builtIn,customModels,quickFilter:slice.quickFilter,conditionTree,report:{unknownBuiltInColumns,invalidBuiltIn,unavailableCustomFilters,conditionTreeError,externalFilterWasActive:slice.externalFilterActive}}}export function validateFilterSlice(value){const issues=[];if(!isRecord(value)){return[{path:"$",detail:"filter slice must be an object"}]}if(!isRecord(value.builtIn)){issues.push({path:"$/builtIn",detail:"builtIn must be an object keyed by column id"})}if(value.customModels!==null&&!isRecord(value.customModels)){issues.push({path:"$/customModels",detail:"customModels must be null or an object keyed by column id"})}if(value.quickFilter!==null&&typeof value.quickFilter!=="string"){issues.push({path:"$/quickFilter",detail:"quickFilter must be null or a string"})}if(value.conditionTree!==null&&typeof value.conditionTree!=="string"){issues.push({path:"$/conditionTree",detail:"conditionTree must be null or a condition wire string"})}if(typeof value.externalFilterActive!=="boolean"){issues.push({path:"$/externalFilterActive",detail:"externalFilterActive must be a boolean"})}return issues}

package/dist/collection/components/grid/core/state/slices/rows.js

@@ -0,0 +1 @@
+export function compareRowIds(left,right){const leftIsNumber=typeof left==="number";const rightIsNumber=typeof right==="number";if(leftIsNumber&&rightIsNumber)return left-right;if(leftIsNumber)return-1;if(rightIsNumber)return 1;return left<right?-1:left>right?1:0}const sortedStrings=values=>[...values].sort();const sortedIds=values=>[...values].sort(compareRowIds);export function captureRowsSlices(input){return{rowGrouping:{collapsedGroupRoutes:sortedStrings(input.collapsedGroupRoutes)},pivot:{collapsedGroupRoutes:sortedStrings(input.pivotCollapsedGroupRoutes)},expansion:{collapsedTreeNodePaths:sortedStrings(input.collapsedTreeNodePaths),expandedDetailRowIds:sortedIds(input.expandedDetailRowIds)},selection:{rows:{mode:input.rowSelection.mode,ids:sortedIds(input.rowSelection.selectedRowIds)},ranges:input.cellRanges.map(range=>({...range}))}}}const splitIds=(ids,live)=>{if(live===null){return{applied:[...ids],missing:[],unverified:[...ids]}}const applied=[];const missing=[];for(const id of ids)(live.has(id)?applied:missing).push(id);return{applied,missing,unverified:[]}};const splitPaths=(paths,live)=>{if(live===null){return{applied:[...paths],missing:[],unverified:[...paths]}}const applied=[];const missing=[];for(const path of paths)(live.has(path)?applied:missing).push(path);return{applied,missing,unverified:[]}};const rangeInBounds=(range,rowCount,columnCount)=>[range.anchorRow,range.focusRow].every(row=>row>=0&&row<rowCount)&&[range.anchorCol,range.focusCol].every(col=>col>=0&&col<columnCount);export function applyRowsSlices(slices,context){const detail=splitIds(slices.expansion.expandedDetailRowIds,context.liveRowIds);const selected=splitIds(slices.selection.rows.ids,context.liveRowIds);const tree=splitPaths(slices.expansion.collapsedTreeNodePaths,context.liveTreeNodePaths);const ranges=[];const droppedRanges=[];for(const range of slices.selection.ranges){if(rangeInBounds(range,context.rowCount,context.columnCount)){ranges.push({...range})}else{droppedRanges.push({...range})}}return{collapsedGroupRoutes:[...slices.rowGrouping.collapsedGroupRoutes],pivotCollapsedGroupRoutes:[...slices.pivot.collapsedGroupRoutes],collapsedTreeNodePaths:tree.applied,expandedDetailRowIds:detail.applied,selection:{mode:slices.selection.rows.mode,ids:selected.applied},ranges,report:{missingDetailRowIds:detail.missing,unverifiedDetailRowIds:detail.unverified,missingSelectedRowIds:selected.missing,unverifiedSelectedRowIds:selected.unverified,missingTreeNodePaths:tree.missing,unverifiedTreeNodePaths:tree.unverified,deferredPivotRoutes:context.pivotModeActive?[]:[...slices.pivot.collapsedGroupRoutes],droppedRanges}}}const isRecord=value=>value!==null&&typeof value==="object"&&!Array.isArray(value);const isRowId=value=>typeof value==="string"&&value.length>0||typeof value==="number"&&Number.isFinite(value);const validateStringArray=(value,path,issues)=>{if(!Array.isArray(value)||value.some(entry=>typeof entry!=="string")){issues.push({path,detail:"must be an array of strings"})}};const validateIdArray=(value,path,issues)=>{if(!Array.isArray(value)||value.some(entry=>!isRowId(entry))){issues.push({path,detail:"must be an array of non-empty-string or finite-number row ids"})}};export function validateRowGroupingSlice(value){if(!isRecord(value))return[{path:"$",detail:"rowGrouping slice must be an object"}];const issues=[];validateStringArray(value.collapsedGroupRoutes,"$/collapsedGroupRoutes",issues);return issues}export function validatePivotSlice(value){if(!isRecord(value))return[{path:"$",detail:"pivot slice must be an object"}];const issues=[];validateStringArray(value.collapsedGroupRoutes,"$/collapsedGroupRoutes",issues);return issues}export function validateExpansionSlice(value){if(!isRecord(value))return[{path:"$",detail:"expansion slice must be an object"}];const issues=[];validateStringArray(value.collapsedTreeNodePaths,"$/collapsedTreeNodePaths",issues);validateIdArray(value.expandedDetailRowIds,"$/expandedDetailRowIds",issues);return issues}export function validateSelectionSlice(value){if(!isRecord(value))return[{path:"$",detail:"selection slice must be an object"}];const issues=[];if(!isRecord(value.rows)){issues.push({path:"$/rows",detail:"rows must be an object"})}else{if(value.rows.mode!=="none"&&value.rows.mode!=="single"&&value.rows.mode!=="multi"){issues.push({path:"$/rows/mode",detail:"mode must be none, single, or multi"})}validateIdArray(value.rows.ids,"$/rows/ids",issues)}if(!Array.isArray(value.ranges)){issues.push({path:"$/ranges",detail:"ranges must be an array"})}else{value.ranges.forEach((range,index)=>{if(!isRecord(range)||["anchorRow","anchorCol","focusRow","focusCol"].some(key=>typeof range[key]!=="number"||!Number.isInteger(range[key])||range[key]<0)){issues.push({path:`$/ranges/${index}`,detail:"range must carry non-negative integer anchor/focus row and column indices"})}})}return issues}

package/dist/collection/components/grid/core/state/slices/ui.js

@@ -0,0 +1 @@
+export const DEFAULT_UI_PAGINATION=Object.freeze({pageIndex:0,pageSize:25});export function captureUiSlices(input){return{focus:{activeCell:input.activeCell===null?null:{rowIndex:input.activeCell.rowIndex,colIndex:input.activeCell.colIndex}},scroll:{top:Math.max(0,input.scrollTop),left:Math.max(0,input.scrollLeft)},pagination:input.pagination===null?DEFAULT_UI_PAGINATION:{pageIndex:input.pagination.pageIndex,pageSize:input.pagination.pageSize},sideBar:{openPanelId:input.openPanelId},pinnedRows:input.pinnedRows===void 0?{topRowIds:[],bottomRowIds:[]}:{topRowIds:[...input.pinnedRows.topRowIds],bottomRowIds:[...input.pinnedRows.bottomRowIds]}}}export function planUiRestore(slices,context){const unavailable=[];let focus=slices.focus;if(focus.activeCell!==null&&(focus.activeCell.rowIndex>=context.rowCount||focus.activeCell.colIndex>=context.columnCount)){unavailable.push({slice:"focus",path:"$/focus/activeCell",reason:`active cell (${focus.activeCell.rowIndex}, ${focus.activeCell.colIndex}) is outside the ${context.rowCount}x${context.columnCount} display`});focus={activeCell:null}}const pinnedRequested=slices.pinnedRows.topRowIds.length>0||slices.pinnedRows.bottomRowIds.length>0;if(!context.pinnedRowsSupported&&pinnedRequested){unavailable.push({slice:"pinnedRows",path:"$/pinnedRows",reason:"pinned top/bottom rows are not supported by this build (Phase F Day 65 feature)"})}return{immediate:{sideBar:slices.sideBar,pagination:slices.pagination},afterData:{scroll:slices.scroll,focus,pinnedRows:context.pinnedRowsSupported&&pinnedRequested?slices.pinnedRows:null},unavailable}}const isRecord=value=>value!==null&&typeof value==="object"&&!Array.isArray(value);const nonNegativeInteger=value=>typeof value==="number"&&Number.isInteger(value)&&value>=0;const nonNegativeFinite=value=>typeof value==="number"&&Number.isFinite(value)&&value>=0;const isRowId=value=>typeof value==="string"&&value.length>0||typeof value==="number"&&Number.isFinite(value);export function validateFocusSlice(value){if(!isRecord(value))return[{path:"$",detail:"focus slice must be an object"}];if(value.activeCell===null)return[];if(!isRecord(value.activeCell)||!nonNegativeInteger(value.activeCell.rowIndex)||!nonNegativeInteger(value.activeCell.colIndex)){return[{path:"$/activeCell",detail:"activeCell must be null or non-negative integer indices"}]}return[]}export function validateScrollSlice(value){if(!isRecord(value))return[{path:"$",detail:"scroll slice must be an object"}];const issues=[];if(!nonNegativeFinite(value.top))issues.push({path:"$/top",detail:"top must be a non-negative number"});if(!nonNegativeFinite(value.left))issues.push({path:"$/left",detail:"left must be a non-negative number"});return issues}export function validatePaginationSlice(value){if(!isRecord(value))return[{path:"$",detail:"pagination slice must be an object"}];const issues=[];if(!nonNegativeInteger(value.pageIndex)){issues.push({path:"$/pageIndex",detail:"pageIndex must be a non-negative integer"})}if(!nonNegativeInteger(value.pageSize)||value.pageSize===0){issues.push({path:"$/pageSize",detail:"pageSize must be a positive integer"})}return issues}export function validateSideBarSlice(value){if(!isRecord(value))return[{path:"$",detail:"sideBar slice must be an object"}];if(value.openPanelId!==null&&value.openPanelId!=="columns"&&value.openPanelId!=="filters"){return[{path:"$/openPanelId",detail:'openPanelId must be null, "columns", or "filters"'}]}return[]}export function validatePinnedRowsSlice(value){if(!isRecord(value))return[{path:"$",detail:"pinnedRows slice must be an object"}];const issues=[];for(const key of["topRowIds","bottomRowIds"]){if(!Array.isArray(value[key])||value[key].some(id=>!isRowId(id))){issues.push({path:`$/${key}`,detail:`${key} must be an array of row ids`})}}return issues}

package/dist/collection/components/grid/core/state/state-events.js

@@ -0,0 +1 @@
+export const STATE_ATOM_SLICES=Object.freeze({columnWidths:"columns",columnOrder:"columns",columnHidden:"columns",columnPinned:"columns",activeSortModel:"columns",collapsedGroups:"columns",columnDefs:"columns",groupBy:"columns",pivotMode:"columns",pivotRowGroupColumns:"columns",pivotColumns:"columns",pivotValueColumns:"columns",activeFilters:"filter",quickFilterValue:"filter",activeConditionTree:"filter",lifecycleFilterVersion:"filter",collapsedRowGroups:"rowGrouping",pivotCollapsedRowGroups:"pivot",collapsedTreeNodes:"expansion",expandedDetailRows:"expansion",selectionState:"selection",rangeState:"selection",activeCell:"focus",hScrollLeft:"scroll",scrollTop:"scroll",activePagination:"pagination",openToolPanelId:"sideBar"});export function createStateChangeTracker(){let previous=null;return{diff(current){const before=previous;previous=current;if(before===null)return[];const changed=new Set;for(const key of Object.keys(STATE_ATOM_SLICES)){if(!Object.is(before[key],current[key])){changed.add(STATE_ATOM_SLICES[key])}}return[...changed].sort()}}}export function createStateEventCoalescer(){const slices=new Set;const sources=new Set;let batches=0;let finalized=false;return{note(changed,source="interactive"){if(finalized||changed.length===0)return false;const hadPending=batches>0;for(const key of changed)slices.add(key);sources.add(source);batches+=1;return!hadPending},hasPending(){return batches>0},takeFlush(){if(finalized||batches===0)return null;const flush={changedSlices:[...slices].sort(),sources:[...sources].sort(),coalescedBatches:batches};slices.clear();sources.clear();batches=0;return flush},finalizeOnce(){if(finalized)return false;finalized=true;return true},isFinalized(){return finalized}}}

package/dist/collection/components/grid/core/state/validate.js

@@ -0,0 +1 @@
+import{SY_GRID_STATE_SLICE_KEYS,SY_GRID_STATE_VERSION}from"./contracts.js";import{canonicalizeGridStateValue}from"./canonical.js";const VERSION_PATTERN=/^sy-grid-state\/(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;export function parseGridStateVersion(value){if(typeof value!=="string")return null;const match=value.match(VERSION_PATTERN);if(!match)return null;return{major:Number(match[1]),minor:Number(match[2]),patch:Number(match[3])}}const CURRENT_VERSION=(()=>{const parsed=parseGridStateVersion(SY_GRID_STATE_VERSION);if(!parsed){throw new TypeError("SY_GRID_STATE_VERSION must satisfy the version pattern")}return parsed})();const KNOWN_SLICES=new Set(SY_GRID_STATE_SLICE_KEYS);const isRecord=value=>value!==null&&typeof value==="object"&&!Array.isArray(value);export function validateGridStateEnvelope(value,options={}){const unknownSlices=options.unknownSlices??"reject";const issues=[];if(!isRecord(value)){return{ok:false,state:null,issues:[{code:"not-an-object",path:"$",detail:"grid state must be a plain object envelope"}]}}const version=value.version;if(version===void 0){issues.push({code:"missing-version",path:"$/version",detail:"grid state must declare its version"})}else{const parsed=parseGridStateVersion(version);if(!parsed){issues.push({code:"malformed-version",path:"$/version",detail:`"${String(version)}" does not match sy-grid-state/<major>.<minor>.<patch>`})}else if(parsed.major>CURRENT_VERSION.major){issues.push({code:"newer-major-version",path:"$/version",detail:`state major ${parsed.major} is newer than runtime major ${CURRENT_VERSION.major}`})}}const slices=value.slices;if(slices===void 0){issues.push({code:"missing-slices",path:"$/slices",detail:"grid state must carry a slices object (empty is allowed)"})}else if(!isRecord(slices)){issues.push({code:"malformed-slices",path:"$/slices",detail:"slices must be a plain object keyed by slice name"})}const canonicalSlices={};if(isRecord(slices)){const presentKeys=Object.keys(slices);for(const key of presentKeys){if(!KNOWN_SLICES.has(key)){issues.push({code:"unknown-slice",path:`$/slices/${key}`,detail:unknownSlices==="reject"?`unknown slice "${key}" rejected by policy`:`unknown slice "${key}" reported and ignored by policy`});continue}if(slices[key]===void 0)continue;const canonical=canonicalizeGridStateValue(slices[key]);if(canonical.issues.length>0){for(const serializability of canonical.issues){issues.push({code:"non-serializable",path:`$/slices/${key}${serializability.path.slice(1)}`,detail:`${serializability.kind}: ${serializability.detail}`})}continue}canonicalSlices[key]=canonical.value}}const fatal=issues.some(entry=>entry.code!=="unknown-slice"||unknownSlices==="reject");if(fatal){return{ok:false,state:null,issues}}const ordered={};for(const key of SY_GRID_STATE_SLICE_KEYS){if(key in canonicalSlices)ordered[key]=canonicalSlices[key]}return{ok:true,state:{version,slices:ordered},issues}}export function createEmptyGridState(){return{version:SY_GRID_STATE_VERSION,slices:{}}}

package/dist/collection/components/grid/core/status-bar/status-bar.js

@@ -0,0 +1 @@
+export const STATUS_PANEL_IDS=Object.freeze(["totalRows","filteredRows","totalAndFilteredRows","selectedRows","aggregation"]);const ALIGNS=Object.freeze(["left","center","right"]);export const DEFAULT_STATUS_PANELS=Object.freeze([{panel:"totalAndFilteredRows",align:"left"},{panel:"selectedRows",align:"right"},{panel:"aggregation",align:"right"}]);export function resolveStatusBar(input){if(input===false||input===null||input===void 0)return null;if(input===true)return{panels:DEFAULT_STATUS_PANELS,invalid:[]};if(typeof input!=="object"){return{panels:DEFAULT_STATUS_PANELS,invalid:[`statusBar value "${String(input)}" is not boolean/object`]}}const panelsInput=input.panels;if(!Array.isArray(panelsInput)){return{panels:DEFAULT_STATUS_PANELS,invalid:["statusBar.panels is not an array"]}}const panels=[];const invalid=[];for(const entry of panelsInput){if(entry===null||typeof entry!=="object"){invalid.push(String(entry));continue}const id=entry.panel;if(typeof id!=="string"||!STATUS_PANEL_IDS.includes(id)){invalid.push(String(id));continue}const alignRaw=entry.align;const align=typeof alignRaw==="string"&&ALIGNS.includes(alignRaw)?alignRaw:"left";panels.push({panel:id,align})}return{panels,invalid}}

package/dist/collection/components/grid/core/sync/array.js

@@ -0,0 +1 @@
+import{opIdFromTimestamp,opIdEqual,encodeOpId}from"./id.js";export class SyncArray{name;doc;start=null;tail=null;visibleLength=0;byId=new Map;constructor(doc,name){this.name=name;this.doc=doc;doc.registerShared(this)}insert(index,value){const clamped=index<0?0:index>this.visibleLength?this.visibleLength:index;const left=clamped>0?this.nthVisible(clamped-1):null;const right=this.nthVisible(clamped);const op={ts:this.doc.tick(),target:this.name,kind:"insert",originLeft:left!==null?left.id:null,originRight:right!==null?right.id:null,content:value};this.integrate(op);this.doc.addOp(op)}push(value){let left=this.tail;while(left!==null&&left.deleted)left=left.left;const op={ts:this.doc.tick(),target:this.name,kind:"insert",originLeft:left!==null?left.id:null,originRight:null,content:value};this.integrate(op);this.doc.addOp(op)}delete(index){return this.deleteRange(index,1)}deleteRange(index,count){const targets=[];for(let i=0;i<count;i+=1){const item=this.nthVisible(index+i);if(item!==null)targets.push(item.id)}if(targets.length===0)return false;const op={ts:this.doc.tick(),target:this.name,kind:"delete",targets};this.applyDelete(op);this.doc.addOp(op);return true}move(from,to){const value=this.get(from);if(value===void 0&&this.nthVisible(from)===null)return false;this.delete(from);const clamped=to<0?0:to>this.length?this.length:to;this.insert(clamped,value);return true}get length(){return this.visibleLength}get(index){const item=this.nthVisible(index);return item!==null?item.content:void 0}toArray(){const out=[];for(let o=this.start;o!==null;o=o.right)if(!o.deleted)out.push(o.content);return out}applyOp(op){if(op.kind==="insert")this.integrate(op);else if(op.kind==="delete")this.applyDelete(op)}applyDelete(op){for(const id of op.targets){const item=this.resolve(id);if(item!==null&&!item.deleted){item.deleted=true;this.visibleLength-=1}}}exportItems(){const out=[];for(let o=this.start;o!==null;o=o.right){out.push({id:o.id,origin:o.origin,rightOrigin:o.rightOrigin,content:o.content,deleted:o.deleted})}return out}loadItems(items){this.start=null;this.byId.clear();this.visibleLength=0;let prev=null;for(const s of items){const item={id:s.id,origin:s.origin,rightOrigin:s.rightOrigin,content:s.content,deleted:s.deleted,left:prev,right:null};if(prev!==null)prev.right=item;else this.start=item;this.byId.set(encodeOpId(item.id),item);if(!s.deleted)this.visibleLength+=1;prev=item}this.tail=prev}gc(minSeen){const referenced=new Set;for(let o2=this.start;o2!==null;o2=o2.right){if(o2.origin!==null)referenced.add(encodeOpId(o2.origin));if(o2.rightOrigin!==null)referenced.add(encodeOpId(o2.rightOrigin))}let removed=0;let o=this.start;while(o!==null){const next=o.right;const key=encodeOpId(o.id);if(o.deleted&&o.id.seq<=(minSeen.get(o.id.userId)??0)&&!referenced.has(key)){if(o.left!==null)o.left.right=o.right;else this.start=o.right;if(o.right!==null)o.right.left=o.left;else this.tail=o.left;this.byId.delete(key);removed+=1}o=next}return removed}nthVisible(index){if(index<0)return null;let i=0;for(let o=this.start;o!==null;o=o.right){if(o.deleted)continue;if(i===index)return o;i+=1}return null}resolve(id){return id!==null?this.byId.get(encodeOpId(id))??null:null}sameOrigin(a,b){if(a===null||b===null)return a===b;return opIdEqual(a,b)}integrate(op){const id=opIdFromTimestamp(op.ts);if(this.byId.has(encodeOpId(id)))return;const item={id,origin:op.originLeft,rightOrigin:op.originRight,content:op.content,deleted:false,left:null,right:null};const leftAnchor=this.resolve(item.origin);const rightAnchor=this.resolve(item.rightOrigin);let left=leftAnchor;let o=left!==null?left.right:this.start;const conflicting=new Set;const seen=new Set;while(o!==null&&o!==rightAnchor){seen.add(o);conflicting.add(o);if(this.sameOrigin(o.origin,item.origin)){if(o.id.userId<item.id.userId){left=o;conflicting.clear()}else if(this.sameOrigin(o.rightOrigin,item.rightOrigin)){break}}else{const oOrigin=this.resolve(o.origin);if(oOrigin!==null&&seen.has(oOrigin)){if(!conflicting.has(oOrigin)){left=o;conflicting.clear()}}else{break}}o=o.right}this.linkAfter(left,item);this.visibleLength+=1}linkAfter(left,item){const right=left!==null?left.right:this.start;item.left=left;item.right=right;if(left!==null)left.right=item;else this.start=item;if(right!==null)right.left=item;else this.tail=item;this.byId.set(encodeOpId(item.id),item)}}

package/dist/collection/components/grid/core/sync/collab-bridge.js

@@ -0,0 +1 @@
+export const NOOP_COLLAB_PROVIDER={connect(){},disconnect(){},getStatus(){return"offline"},send(){},onRemoteOps(){},onStatusChange(){}};export class CollabBridge{doc;provider=NOOP_COLLAB_PROVIDER;forwardLocal;attached=false;signer=null;constructor(doc){this.doc=doc;this.forwardLocal=update=>{if(!update.local)return;if(this.signer===null){this.provider.send(update.ops);return}const signer=this.signer;const provider=this.provider;void Promise.all(update.ops.map(op=>signer.signOp(op))).then(signed=>provider.send(signed))}}setSigner(signer){this.signer=signer}attach(provider){if(this.attached)this.detach();this.provider=provider;provider.onRemoteOps(ops=>this.receive(ops));this.doc.on("update",this.forwardLocal);this.attached=true;provider.connect()}receive(ops){if(this.signer===null){this.doc.applyRemote(ops,"remote");return}const signer=this.signer;void(async()=>{const verified=[];for(const op of ops){if(await signer.verifyOp(op))verified.push(op)}if(verified.length>0)this.doc.applyRemote(verified,"remote")})()}detach(){if(!this.attached)return;this.doc.off("update",this.forwardLocal);this.provider.disconnect();this.provider=NOOP_COLLAB_PROVIDER;this.attached=false}getStatus(){return this.provider.getStatus()}}

package/dist/collection/components/grid/core/sync/id.js

@@ -0,0 +1 @@
+export function makeOpId(userId,seq){return{userId,seq}}export function opIdFromTimestamp(ts){return{userId:ts.userId,seq:ts.seq}}export function compareOpId(a,b){if(a.userId!==b.userId)return a.userId<b.userId?-1:1;if(a.seq!==b.seq)return a.seq<b.seq?-1:1;return 0}export function opIdEqual(a,b){return a.userId===b.userId&&a.seq===b.seq}export function encodeOpId(id){return`${id.seq}@${id.userId}`}export function decodeOpId(key){const at=key.indexOf("@");if(at<=0)throw new RangeError(`decodeOpId: malformed key "${key}"`);const seq=Number(key.slice(0,at));if(!Number.isInteger(seq)||seq<0)throw new RangeError(`decodeOpId: bad seq in "${key}"`);return{userId:key.slice(at+1),seq}}

package/dist/collection/components/grid/core/sync/text.js

@@ -0,0 +1 @@
+import{SyncArray}from"./array.js";export class SyncText{name;doc;seq;constructor(doc,name){this.name=name;this.doc=doc;const existing=doc.getShared(name);this.seq=existing instanceof SyncArray?existing:new SyncArray(doc,name)}insert(index,str){const points=[...str];if(points.length===0)return;this.doc.transact(()=>{for(let i=0;i<points.length;i+=1)this.seq.insert(index+i,points[i])})}delete(index,len){if(len>0)this.seq.deleteRange(index,len)}get length(){return this.seq.length}toString(){return this.seq.toArray().join("")}}

package/dist/collection/components/grid/core/sync/undo-manager.js

@@ -0,0 +1 @@
+const UNDO_ORIGIN=Symbol("sync-undo");const REDO_ORIGIN=Symbol("sync-redo");export class UndoManager{doc;map;captureTimeoutMs;now;current=new Map;undoStack=[];redoStack=[];listener;constructor(doc,map,options={}){this.doc=doc;this.map=map;this.captureTimeoutMs=options.captureTimeoutMs??500;this.now=options.now??Date.now;for(const[k,v]of map.entries())this.current.set(k,v);this.listener=u=>this.observe(u);doc.on("update",this.listener)}canUndo(){return this.undoStack.length>0}canRedo(){return this.redoStack.length>0}clear(){this.undoStack.length=0;this.redoStack.length=0}destroy(){this.doc.off("update",this.listener)}undo(){const entry=this.undoStack.pop();if(entry===void 0)return false;this.doc.transact(()=>{for(let i=entry.changes.length-1;i>=0;i-=1){const c=entry.changes[i];if(c.before.has)this.map.set(c.key,c.before.value);else this.map.delete(c.key)}},UNDO_ORIGIN);this.redoStack.push(entry);return true}redo(){const entry=this.redoStack.pop();if(entry===void 0)return false;this.doc.transact(()=>{for(const c of entry.changes){if(c.after.has)this.map.set(c.key,c.after.value);else this.map.delete(c.key)}},REDO_ORIGIN);this.undoStack.push(entry);return true}observe(u){const tracked=u.local&&u.origin!==UNDO_ORIGIN&&u.origin!==REDO_ORIGIN;const changes=[];for(const op of u.ops){if(op.target!==this.map.name)continue;const mop=op;const before={has:this.current.has(mop.key),value:this.current.get(mop.key)};if(mop.kind==="delete"){if(tracked)changes.push({key:mop.key,before,after:{has:false,value:void 0}});this.current.delete(mop.key)}else{if(tracked)changes.push({key:mop.key,before,after:{has:true,value:mop.value}});this.current.set(mop.key,mop.value)}}if(changes.length===0)return;this.redoStack.length=0;const last=this.undoStack[this.undoStack.length-1];if(last!==void 0&&this.now()-last.at<=this.captureTimeoutMs){for(const c of changes)last.changes.push(c);last.at=this.now()}else{this.undoStack.push({changes,at:this.now()})}}}

package/dist/collection/components/grid/core/theme/apply.js

@@ -0,0 +1 @@
+const defaultTokens=Object.freeze({"--sy-grid-bg":"#ffffff","--sy-grid-viewport-bg":"#ffffff","--sy-grid-toolbar-bg":"#ffffff","--sy-grid-border":"#e5e7eb","--sy-grid-toolbar-border":"#e5e7eb","--sy-grid-text":"#111827","--sy-grid-text-muted":"#6b7280","--sy-grid-header-bg":"#f9fafb","--sy-grid-header-bg-hover":"#f3f4f6","--sy-grid-header-border":"#e5e7eb","--sy-grid-header-color":"#111827","--sy-grid-header-font-weight":"600","--sy-grid-row-height":"32px","--sy-grid-row-bg-odd":"#ffffff","--sy-grid-row-bg-even":"#f9fafb","--sy-grid-row-border":"#f3f4f6","--sy-grid-row-color":"#111827","--sy-grid-row-bg-hover":"rgba(37, 99, 235, 0.06)","--sy-grid-row-bg-selected":"rgba(37, 99, 235, 0.12)","--sy-grid-cell-padding-x":"12px","--sy-grid-cell-font-size":"13px","--sy-grid-cell-editor-bg":"#ffffff","--sy-grid-cell-editor-color":"#111827","--sy-grid-cell-editor-border":"#2563eb","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(37, 99, 235, 0.22)","--sy-grid-active-cell-outline":"#2563eb","--sy-grid-active-row-bg":"rgba(37, 99, 235, 0.08)","--sy-grid-viewport-focus-outline":"#2563eb","--sy-grid-scrollbar-thumb":"rgba(15, 23, 42, 0.18)","--sy-grid-scrollbar-track":"transparent","--sy-grid-sort-indicator-color":"#9ca3af","--sy-grid-sort-indicator-active-color":"#2563eb","--sy-grid-filter-icon-color":"currentColor","--sy-grid-filter-icon-active-color":"#2563eb","--sy-grid-filter-dropdown-bg":"#ffffff","--sy-grid-filter-dropdown-color":"#111827","--sy-grid-filter-dropdown-border":"#e5e7eb","--sy-grid-filter-dropdown-shadow":"0 8px 20px rgba(15, 23, 42, 0.12)","--sy-grid-filter-button-primary-bg":"#2563eb","--sy-grid-filter-button-primary-color":"#ffffff","--sy-grid-quick-filter-input-bg":"#ffffff","--sy-grid-quick-filter-input-color":"#111827","--sy-grid-quick-filter-input-border":"#d1d5db","--sy-grid-quick-filter-input-placeholder":"#9ca3af","--sy-grid-quick-filter-input-focus":"#2563eb","--sy-grid-quick-filter-clear-color":"#6b7280","--sy-grid-quick-filter-clear-hover":"rgba(15, 23, 42, 0.08)","--sy-grid-pagination-bg":"#f9fafb","--sy-grid-pagination-color":"#111827","--sy-grid-pagination-border":"#e5e7eb","--sy-grid-pagination-active-bg":"#2563eb","--sy-grid-pagination-active-color":"#ffffff","--sy-grid-pagination-disabled-color":"#9ca3af","--sy-grid-pagination-hover-bg":"rgba(15, 23, 42, 0.06)","--sy-grid-empty-state-bg":"rgba(255, 255, 255, 0.92)","--sy-grid-empty-state-color":"#4b5563","--sy-grid-empty-state-icon-color":"#9ca3af","--sy-grid-empty-state-action-bg":"#2563eb","--sy-grid-empty-state-action-color":"#ffffff","--sy-grid-loading-backdrop":"rgba(255, 255, 255, 0.7)","--sy-grid-loading-spinner-color":"#2563eb","--sy-grid-loading-message-color":"#4b5563"});function isGridTokenName(name){return Object.prototype.hasOwnProperty.call(defaultTokens,name)}const alpineTokens=Object.freeze({"--sy-grid-bg":"#ffffff","--sy-grid-viewport-bg":"#ffffff","--sy-grid-toolbar-bg":"#ffffff","--sy-grid-border":"#e5e7eb","--sy-grid-toolbar-border":"#e5e7eb","--sy-grid-text":"#111827","--sy-grid-text-muted":"#6b7280","--sy-grid-header-bg":"#f9fafb","--sy-grid-header-bg-hover":"#f3f4f6","--sy-grid-header-border":"#e5e7eb","--sy-grid-header-color":"#111827","--sy-grid-header-font-weight":"600","--sy-grid-row-height":"32px","--sy-grid-row-bg-odd":"#ffffff","--sy-grid-row-bg-even":"#f9fafb","--sy-grid-row-border":"#f3f4f6","--sy-grid-row-color":"#111827","--sy-grid-row-bg-hover":"rgba(37, 99, 235, 0.06)","--sy-grid-row-bg-selected":"rgba(37, 99, 235, 0.12)","--sy-grid-cell-padding-x":"12px","--sy-grid-cell-font-size":"13px","--sy-grid-cell-editor-bg":"#ffffff","--sy-grid-cell-editor-color":"#111827","--sy-grid-cell-editor-border":"#2563eb","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(37, 99, 235, 0.22)","--sy-grid-active-cell-outline":"#2563eb","--sy-grid-active-row-bg":"rgba(37, 99, 235, 0.08)","--sy-grid-viewport-focus-outline":"#2563eb","--sy-grid-sort-indicator-active-color":"#2563eb","--sy-grid-filter-icon-active-color":"#2563eb","--sy-grid-filter-button-primary-bg":"#2563eb","--sy-grid-quick-filter-input-focus":"#2563eb","--sy-grid-pagination-active-bg":"#2563eb","--sy-grid-empty-state-action-bg":"#2563eb","--sy-grid-loading-spinner-color":"#2563eb"});const balhamTokens=Object.freeze({"--sy-grid-bg":"#ffffff","--sy-grid-viewport-bg":"#ffffff","--sy-grid-toolbar-bg":"#f4f6f8","--sy-grid-border":"#bdc3c7","--sy-grid-toolbar-border":"#bdc3c7","--sy-grid-text":"#000000","--sy-grid-text-muted":"#5c6671","--sy-grid-header-bg":"#e2e9eb","--sy-grid-header-bg-hover":"#d2d9db","--sy-grid-header-border":"#9ea7ad","--sy-grid-header-color":"#000000","--sy-grid-header-font-weight":"700","--sy-grid-row-height":"28px","--sy-grid-row-bg-odd":"#ffffff","--sy-grid-row-bg-even":"#fcfdfe","--sy-grid-row-border":"#dde2e4","--sy-grid-row-color":"#000000","--sy-grid-row-bg-hover":"rgba(33, 150, 243, 0.08)","--sy-grid-row-bg-selected":"rgba(33, 150, 243, 0.18)","--sy-grid-cell-padding-x":"8px","--sy-grid-cell-font-size":"12px","--sy-grid-cell-editor-bg":"#ffffff","--sy-grid-cell-editor-color":"#000000","--sy-grid-cell-editor-border":"#0091ea","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(0, 145, 234, 0.22)","--sy-grid-active-cell-outline":"#0091ea","--sy-grid-active-row-bg":"rgba(0, 145, 234, 0.10)","--sy-grid-viewport-focus-outline":"#0091ea","--sy-grid-sort-indicator-color":"#7e8a91","--sy-grid-sort-indicator-active-color":"#0091ea","--sy-grid-filter-icon-active-color":"#0091ea","--sy-grid-filter-button-primary-bg":"#0091ea","--sy-grid-quick-filter-input-focus":"#0091ea","--sy-grid-pagination-bg":"#e2e9eb","--sy-grid-pagination-border":"#bdc3c7","--sy-grid-pagination-active-bg":"#0091ea","--sy-grid-empty-state-action-bg":"#0091ea","--sy-grid-loading-spinner-color":"#0091ea"});const darkAlpineTokens=Object.freeze({"--sy-grid-bg":"#0f172a","--sy-grid-viewport-bg":"#111827","--sy-grid-toolbar-bg":"#111827","--sy-grid-border":"#374151","--sy-grid-toolbar-border":"#374151","--sy-grid-text":"#f3f4f6","--sy-grid-text-muted":"#9ca3af","--sy-grid-header-bg":"#1f2937","--sy-grid-header-bg-hover":"#283447","--sy-grid-header-border":"#374151","--sy-grid-header-color":"#f3f4f6","--sy-grid-row-bg-odd":"#111827","--sy-grid-row-bg-even":"#1f2937","--sy-grid-row-border":"#374151","--sy-grid-row-color":"#f3f4f6","--sy-grid-row-bg-hover":"rgba(96, 165, 250, 0.12)","--sy-grid-row-bg-selected":"rgba(96, 165, 250, 0.22)","--sy-grid-active-cell-outline":"#60a5fa","--sy-grid-active-row-bg":"rgba(96, 165, 250, 0.16)","--sy-grid-viewport-focus-outline":"#60a5fa","--sy-grid-cell-editor-bg":"#0f172a","--sy-grid-cell-editor-color":"#f3f4f6","--sy-grid-cell-editor-border":"#60a5fa","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(96, 165, 250, 0.34)","--sy-grid-sort-indicator-color":"#6b7280","--sy-grid-sort-indicator-active-color":"#60a5fa","--sy-grid-filter-icon-active-color":"#60a5fa","--sy-grid-filter-dropdown-bg":"#1f2937","--sy-grid-filter-dropdown-color":"#f3f4f6","--sy-grid-filter-dropdown-border":"#374151","--sy-grid-filter-dropdown-shadow":"0 8px 20px rgba(0, 0, 0, 0.45)","--sy-grid-filter-button-primary-bg":"#60a5fa","--sy-grid-filter-button-primary-color":"#0f172a","--sy-grid-quick-filter-input-bg":"#1f2937","--sy-grid-quick-filter-input-color":"#f3f4f6","--sy-grid-quick-filter-input-border":"#374151","--sy-grid-quick-filter-input-placeholder":"#6b7280","--sy-grid-quick-filter-input-focus":"#60a5fa","--sy-grid-quick-filter-clear-color":"#9ca3af","--sy-grid-quick-filter-clear-hover":"rgba(255, 255, 255, 0.08)","--sy-grid-pagination-bg":"#111827","--sy-grid-pagination-color":"#f3f4f6","--sy-grid-pagination-border":"#374151","--sy-grid-pagination-active-bg":"#60a5fa","--sy-grid-pagination-active-color":"#0f172a","--sy-grid-pagination-disabled-color":"#4b5563","--sy-grid-pagination-hover-bg":"rgba(255, 255, 255, 0.06)","--sy-grid-empty-state-bg":"rgba(17, 24, 39, 0.9)","--sy-grid-empty-state-color":"#d1d5db","--sy-grid-empty-state-icon-color":"#6b7280","--sy-grid-empty-state-action-bg":"#60a5fa","--sy-grid-empty-state-action-color":"#0f172a","--sy-grid-loading-backdrop":"rgba(17, 24, 39, 0.7)","--sy-grid-loading-spinner-color":"#60a5fa","--sy-grid-loading-message-color":"#d1d5db","--sy-grid-scrollbar-thumb":"rgba(255, 255, 255, 0.18)"});const darkBalhamTokens=Object.freeze({"--sy-grid-bg":"#0d1117","--sy-grid-viewport-bg":"#161b22","--sy-grid-toolbar-bg":"#161b22","--sy-grid-border":"#30363d","--sy-grid-toolbar-border":"#30363d","--sy-grid-text":"#e6edf3","--sy-grid-text-muted":"#8b949e","--sy-grid-header-bg":"#21262d","--sy-grid-header-bg-hover":"#2d333b","--sy-grid-header-border":"#30363d","--sy-grid-header-color":"#e6edf3","--sy-grid-row-bg-odd":"#161b22","--sy-grid-row-bg-even":"#1b2129","--sy-grid-row-border":"#30363d","--sy-grid-row-color":"#e6edf3","--sy-grid-row-bg-hover":"rgba(56, 139, 253, 0.12)","--sy-grid-row-bg-selected":"rgba(56, 139, 253, 0.22)","--sy-grid-active-cell-outline":"#58a6ff","--sy-grid-active-row-bg":"rgba(56, 139, 253, 0.16)","--sy-grid-viewport-focus-outline":"#58a6ff","--sy-grid-cell-editor-bg":"#0d1117","--sy-grid-cell-editor-color":"#e6edf3","--sy-grid-cell-editor-border":"#58a6ff","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(88, 166, 255, 0.34)","--sy-grid-sort-indicator-color":"#6e7681","--sy-grid-sort-indicator-active-color":"#58a6ff","--sy-grid-filter-icon-active-color":"#58a6ff","--sy-grid-filter-dropdown-bg":"#1b2129","--sy-grid-filter-dropdown-color":"#e6edf3","--sy-grid-filter-dropdown-border":"#30363d","--sy-grid-filter-dropdown-shadow":"0 8px 20px rgba(0, 0, 0, 0.55)","--sy-grid-filter-button-primary-bg":"#58a6ff","--sy-grid-filter-button-primary-color":"#0d1117","--sy-grid-quick-filter-input-bg":"#1b2129","--sy-grid-quick-filter-input-color":"#e6edf3","--sy-grid-quick-filter-input-border":"#30363d","--sy-grid-quick-filter-input-placeholder":"#6e7681","--sy-grid-quick-filter-input-focus":"#58a6ff","--sy-grid-quick-filter-clear-color":"#8b949e","--sy-grid-quick-filter-clear-hover":"rgba(255, 255, 255, 0.06)","--sy-grid-pagination-bg":"#161b22","--sy-grid-pagination-color":"#e6edf3","--sy-grid-pagination-border":"#30363d","--sy-grid-pagination-active-bg":"#58a6ff","--sy-grid-pagination-active-color":"#0d1117","--sy-grid-pagination-disabled-color":"#484f58","--sy-grid-pagination-hover-bg":"rgba(255, 255, 255, 0.06)","--sy-grid-empty-state-bg":"rgba(13, 17, 23, 0.9)","--sy-grid-empty-state-color":"#c9d1d9","--sy-grid-empty-state-icon-color":"#6e7681","--sy-grid-empty-state-action-bg":"#58a6ff","--sy-grid-empty-state-action-color":"#0d1117","--sy-grid-loading-backdrop":"rgba(13, 17, 23, 0.7)","--sy-grid-loading-spinner-color":"#58a6ff","--sy-grid-loading-message-color":"#c9d1d9","--sy-grid-scrollbar-thumb":"rgba(255, 255, 255, 0.18)"});function isGridThemePresetName(name){return name==="alpine"||name==="balham"||name==="alpine-dark"||name==="balham-dark"}const MAX_EXTENDS_DEPTH=16;function presetOverrides(name){switch(name){case"alpine":return alpineTokens;case"balham":return balhamTokens;case"alpine-dark":return{...alpineTokens,...darkAlpineTokens};case"balham-dark":return{...balhamTokens,...darkBalhamTokens}}}function flattenTheme(theme,depth){if(theme==null){return{}}if(typeof theme==="string"){if(isGridThemePresetName(theme)){return presetOverrides(theme)}console.warn("theme:name",theme);return presetOverrides("alpine")}if(typeof theme==="object"){if(depth>=MAX_EXTENDS_DEPTH){console.warn("theme:depth",MAX_EXTENDS_DEPTH);return{}}const baseOverrides=flattenTheme(theme.extends??"alpine",depth+1);const own={};if(theme.tokens){for(const key of Object.keys(theme.tokens)){if(!isGridTokenName(key)){console.warn("theme:token",key);continue}const value=theme.tokens[key];if(typeof value==="string"){own[key]=value}}}return{...baseOverrides,...own}}console.warn("theme:type",typeof theme);return presetOverrides("alpine")}export function resolveTheme(theme){const overrides=flattenTheme(theme,0);const out={...defaultTokens};for(const key of Object.keys(overrides)){if(!isGridTokenName(key))continue;const value=overrides[key];if(typeof value==="string"){out[key]=value}}return out}export function themeDataAttribute(theme){if(theme==null)return void 0;if(typeof theme==="string"){return isGridThemePresetName(theme)?theme:"alpine"}if(typeof theme==="object")return"custom";return"alpine"}export function applyTheme(host,theme){if(!host)return;const style=host.style;if(!style||typeof style.setProperty!=="function")return;const resolved=resolveTheme(theme);for(const key of Object.keys(resolved)){style.setProperty(key,resolved[key])}}export function isGridTheme(value){if(value==null)return true;if(typeof value==="string")return isGridThemePresetName(value);if(typeof value==="object")return true;return false}

package/dist/collection/components/grid/core/theme/presets.js

@@ -0,0 +1 @@
+export const alpineTokens=Object.freeze({"--sy-grid-bg":"#ffffff","--sy-grid-viewport-bg":"#ffffff","--sy-grid-toolbar-bg":"#ffffff","--sy-grid-border":"#e5e7eb","--sy-grid-toolbar-border":"#e5e7eb","--sy-grid-text":"#111827","--sy-grid-text-muted":"#6b7280","--sy-grid-header-bg":"#f9fafb","--sy-grid-header-bg-hover":"#f3f4f6","--sy-grid-header-border":"#e5e7eb","--sy-grid-header-color":"#111827","--sy-grid-header-font-weight":"600","--sy-grid-row-height":"32px","--sy-grid-row-bg-odd":"#ffffff","--sy-grid-row-bg-even":"#f9fafb","--sy-grid-row-border":"#f3f4f6","--sy-grid-row-color":"#111827","--sy-grid-row-bg-hover":"rgba(37, 99, 235, 0.06)","--sy-grid-row-bg-selected":"rgba(37, 99, 235, 0.12)","--sy-grid-cell-padding-x":"12px","--sy-grid-cell-font-size":"13px","--sy-grid-cell-editor-bg":"#ffffff","--sy-grid-cell-editor-color":"#111827","--sy-grid-cell-editor-border":"#2563eb","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(37, 99, 235, 0.22)","--sy-grid-active-cell-outline":"#2563eb","--sy-grid-active-row-bg":"rgba(37, 99, 235, 0.08)","--sy-grid-viewport-focus-outline":"#2563eb","--sy-grid-sort-indicator-active-color":"#2563eb","--sy-grid-filter-icon-active-color":"#2563eb","--sy-grid-filter-button-primary-bg":"#2563eb","--sy-grid-quick-filter-input-focus":"#2563eb","--sy-grid-pagination-active-bg":"#2563eb","--sy-grid-empty-state-action-bg":"#2563eb","--sy-grid-loading-spinner-color":"#2563eb"});export const balhamTokens=Object.freeze({"--sy-grid-bg":"#ffffff","--sy-grid-viewport-bg":"#ffffff","--sy-grid-toolbar-bg":"#f4f6f8","--sy-grid-border":"#bdc3c7","--sy-grid-toolbar-border":"#bdc3c7","--sy-grid-text":"#000000","--sy-grid-text-muted":"#5c6671","--sy-grid-header-bg":"#e2e9eb","--sy-grid-header-bg-hover":"#d2d9db","--sy-grid-header-border":"#9ea7ad","--sy-grid-header-color":"#000000","--sy-grid-header-font-weight":"700","--sy-grid-row-height":"28px","--sy-grid-row-bg-odd":"#ffffff","--sy-grid-row-bg-even":"#fcfdfe","--sy-grid-row-border":"#dde2e4","--sy-grid-row-color":"#000000","--sy-grid-row-bg-hover":"rgba(33, 150, 243, 0.08)","--sy-grid-row-bg-selected":"rgba(33, 150, 243, 0.18)","--sy-grid-cell-padding-x":"8px","--sy-grid-cell-font-size":"12px","--sy-grid-cell-editor-bg":"#ffffff","--sy-grid-cell-editor-color":"#000000","--sy-grid-cell-editor-border":"#0091ea","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(0, 145, 234, 0.22)","--sy-grid-active-cell-outline":"#0091ea","--sy-grid-active-row-bg":"rgba(0, 145, 234, 0.10)","--sy-grid-viewport-focus-outline":"#0091ea","--sy-grid-sort-indicator-color":"#7e8a91","--sy-grid-sort-indicator-active-color":"#0091ea","--sy-grid-filter-icon-active-color":"#0091ea","--sy-grid-filter-button-primary-bg":"#0091ea","--sy-grid-quick-filter-input-focus":"#0091ea","--sy-grid-pagination-bg":"#e2e9eb","--sy-grid-pagination-border":"#bdc3c7","--sy-grid-pagination-active-bg":"#0091ea","--sy-grid-empty-state-action-bg":"#0091ea","--sy-grid-loading-spinner-color":"#0091ea"});export const darkAlpineTokens=Object.freeze({"--sy-grid-bg":"#0f172a","--sy-grid-viewport-bg":"#111827","--sy-grid-toolbar-bg":"#111827","--sy-grid-border":"#374151","--sy-grid-toolbar-border":"#374151","--sy-grid-text":"#f3f4f6","--sy-grid-text-muted":"#9ca3af","--sy-grid-header-bg":"#1f2937","--sy-grid-header-bg-hover":"#283447","--sy-grid-header-border":"#374151","--sy-grid-header-color":"#f3f4f6","--sy-grid-row-bg-odd":"#111827","--sy-grid-row-bg-even":"#1f2937","--sy-grid-row-border":"#374151","--sy-grid-row-color":"#f3f4f6","--sy-grid-row-bg-hover":"rgba(96, 165, 250, 0.12)","--sy-grid-row-bg-selected":"rgba(96, 165, 250, 0.22)","--sy-grid-active-cell-outline":"#60a5fa","--sy-grid-active-row-bg":"rgba(96, 165, 250, 0.16)","--sy-grid-viewport-focus-outline":"#60a5fa","--sy-grid-cell-editor-bg":"#0f172a","--sy-grid-cell-editor-color":"#f3f4f6","--sy-grid-cell-editor-border":"#60a5fa","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(96, 165, 250, 0.34)","--sy-grid-sort-indicator-color":"#6b7280","--sy-grid-sort-indicator-active-color":"#60a5fa","--sy-grid-filter-icon-active-color":"#60a5fa","--sy-grid-filter-dropdown-bg":"#1f2937","--sy-grid-filter-dropdown-color":"#f3f4f6","--sy-grid-filter-dropdown-border":"#374151","--sy-grid-filter-dropdown-shadow":"0 8px 20px rgba(0, 0, 0, 0.45)","--sy-grid-filter-button-primary-bg":"#60a5fa","--sy-grid-filter-button-primary-color":"#0f172a","--sy-grid-quick-filter-input-bg":"#1f2937","--sy-grid-quick-filter-input-color":"#f3f4f6","--sy-grid-quick-filter-input-border":"#374151","--sy-grid-quick-filter-input-placeholder":"#6b7280","--sy-grid-quick-filter-input-focus":"#60a5fa","--sy-grid-quick-filter-clear-color":"#9ca3af","--sy-grid-quick-filter-clear-hover":"rgba(255, 255, 255, 0.08)","--sy-grid-pagination-bg":"#111827","--sy-grid-pagination-color":"#f3f4f6","--sy-grid-pagination-border":"#374151","--sy-grid-pagination-active-bg":"#60a5fa","--sy-grid-pagination-active-color":"#0f172a","--sy-grid-pagination-disabled-color":"#4b5563","--sy-grid-pagination-hover-bg":"rgba(255, 255, 255, 0.06)","--sy-grid-empty-state-bg":"rgba(17, 24, 39, 0.9)","--sy-grid-empty-state-color":"#d1d5db","--sy-grid-empty-state-icon-color":"#6b7280","--sy-grid-empty-state-action-bg":"#60a5fa","--sy-grid-empty-state-action-color":"#0f172a","--sy-grid-loading-backdrop":"rgba(17, 24, 39, 0.7)","--sy-grid-loading-spinner-color":"#60a5fa","--sy-grid-loading-message-color":"#d1d5db","--sy-grid-scrollbar-thumb":"rgba(255, 255, 255, 0.18)"});export const darkBalhamTokens=Object.freeze({"--sy-grid-bg":"#0d1117","--sy-grid-viewport-bg":"#161b22","--sy-grid-toolbar-bg":"#161b22","--sy-grid-border":"#30363d","--sy-grid-toolbar-border":"#30363d","--sy-grid-text":"#e6edf3","--sy-grid-text-muted":"#8b949e","--sy-grid-header-bg":"#21262d","--sy-grid-header-bg-hover":"#2d333b","--sy-grid-header-border":"#30363d","--sy-grid-header-color":"#e6edf3","--sy-grid-row-bg-odd":"#161b22","--sy-grid-row-bg-even":"#1b2129","--sy-grid-row-border":"#30363d","--sy-grid-row-color":"#e6edf3","--sy-grid-row-bg-hover":"rgba(56, 139, 253, 0.12)","--sy-grid-row-bg-selected":"rgba(56, 139, 253, 0.22)","--sy-grid-active-cell-outline":"#58a6ff","--sy-grid-active-row-bg":"rgba(56, 139, 253, 0.16)","--sy-grid-viewport-focus-outline":"#58a6ff","--sy-grid-cell-editor-bg":"#0d1117","--sy-grid-cell-editor-color":"#e6edf3","--sy-grid-cell-editor-border":"#58a6ff","--sy-grid-cell-editor-shadow":"inset 0 0 0 1px rgba(88, 166, 255, 0.34)","--sy-grid-sort-indicator-color":"#6e7681","--sy-grid-sort-indicator-active-color":"#58a6ff","--sy-grid-filter-icon-active-color":"#58a6ff","--sy-grid-filter-dropdown-bg":"#1b2129","--sy-grid-filter-dropdown-color":"#e6edf3","--sy-grid-filter-dropdown-border":"#30363d","--sy-grid-filter-dropdown-shadow":"0 8px 20px rgba(0, 0, 0, 0.55)","--sy-grid-filter-button-primary-bg":"#58a6ff","--sy-grid-filter-button-primary-color":"#0d1117","--sy-grid-quick-filter-input-bg":"#1b2129","--sy-grid-quick-filter-input-color":"#e6edf3","--sy-grid-quick-filter-input-border":"#30363d","--sy-grid-quick-filter-input-placeholder":"#6e7681","--sy-grid-quick-filter-input-focus":"#58a6ff","--sy-grid-quick-filter-clear-color":"#8b949e","--sy-grid-quick-filter-clear-hover":"rgba(255, 255, 255, 0.06)","--sy-grid-pagination-bg":"#161b22","--sy-grid-pagination-color":"#e6edf3","--sy-grid-pagination-border":"#30363d","--sy-grid-pagination-active-bg":"#58a6ff","--sy-grid-pagination-active-color":"#0d1117","--sy-grid-pagination-disabled-color":"#484f58","--sy-grid-pagination-hover-bg":"rgba(255, 255, 255, 0.06)","--sy-grid-empty-state-bg":"rgba(13, 17, 23, 0.9)","--sy-grid-empty-state-color":"#c9d1d9","--sy-grid-empty-state-icon-color":"#6e7681","--sy-grid-empty-state-action-bg":"#58a6ff","--sy-grid-empty-state-action-color":"#0d1117","--sy-grid-loading-backdrop":"rgba(13, 17, 23, 0.7)","--sy-grid-loading-spinner-color":"#58a6ff","--sy-grid-loading-message-color":"#c9d1d9","--sy-grid-scrollbar-thumb":"rgba(255, 255, 255, 0.18)"});export const GRID_THEME_PRESET_NAMES=Object.freeze(["alpine","balham","alpine-dark","balham-dark"]);export function isGridThemePresetName(name){return name==="alpine"||name==="balham"||name==="alpine-dark"||name==="balham-dark"}

package/dist/collection/components/grid/core/theme/tokens.js

@@ -0,0 +1 @@
+export const GRID_TOKEN_CATALOGUE=[{name:"--sy-grid-bg",defaultValue:"#ffffff",category:"surface",description:"Outer host background — paints behind every other layer."},{name:"--sy-grid-viewport-bg",defaultValue:"#ffffff",category:"surface",description:"Scrollable viewport background. Visible between row windows."},{name:"--sy-grid-toolbar-bg",defaultValue:"#ffffff",category:"surface",description:"Quick-filter toolbar surface above the header."},{name:"--sy-grid-border",defaultValue:"#e5e7eb",category:"border",description:"Default divider colour — host outline and unspecified borders."},{name:"--sy-grid-toolbar-border",defaultValue:"#e5e7eb",category:"border",description:"Bottom border under the toolbar separating it from the header."},{name:"--sy-grid-text",defaultValue:"#111827",category:"text",description:"Default body text colour — inherits down to cells."},{name:"--sy-grid-text-muted",defaultValue:"#6b7280",category:"text",description:"Muted text — secondary labels, info bars, ellipsis placeholders."},{name:"--sy-grid-header-bg",defaultValue:"#f9fafb",category:"header",description:"Header row background."},{name:"--sy-grid-header-bg-hover",defaultValue:"#f3f4f6",category:"header",description:"Sortable-header hover background."},{name:"--sy-grid-header-border",defaultValue:"#e5e7eb",category:"header",description:"Bottom border under the header / divider between header cells."},{name:"--sy-grid-header-color",defaultValue:"#111827",category:"header",description:"Header label colour."},{name:"--sy-grid-header-font-weight",defaultValue:"600",category:"header",description:"Header label font weight (semibold by default)."},{name:"--sy-grid-row-height",defaultValue:"32px",category:"row",description:"Logical row height — engines also read this to seed virtualizer math."},{name:"--sy-grid-row-bg-odd",defaultValue:"#ffffff",category:"row",description:"Odd-indexed row background."},{name:"--sy-grid-row-bg-even",defaultValue:"#f9fafb",category:"row",description:"Even-indexed row background — drives the zebra stripe."},{name:"--sy-grid-row-border",defaultValue:"#f3f4f6",category:"row",description:"Bottom border between rows."},{name:"--sy-grid-row-color",defaultValue:"#111827",category:"row",description:"Row text colour."},{name:"--sy-grid-row-bg-hover",defaultValue:"rgba(37, 99, 235, 0.06)",category:"row",description:"Row background tint on pointer hover."},{name:"--sy-grid-row-bg-selected",defaultValue:"rgba(37, 99, 235, 0.12)",category:"row",description:"Row background tint when the row is in the selection set."},{name:"--sy-grid-cell-padding-x",defaultValue:"12px",category:"cell",description:"Horizontal cell padding — also drives header cell padding."},{name:"--sy-grid-cell-font-size",defaultValue:"13px",category:"cell",description:"Body cell font size."},{name:"--sy-grid-cell-editor-bg",defaultValue:"#ffffff",category:"cell",description:"Inline cell-editor background while a cell is in edit mode."},{name:"--sy-grid-cell-editor-color",defaultValue:"#111827",category:"cell",description:"Inline cell-editor text colour while a cell is in edit mode."},{name:"--sy-grid-cell-editor-border",defaultValue:"#2563eb",category:"cell",description:"Inline cell-editor border colour while a cell is in edit mode."},{name:"--sy-grid-cell-editor-shadow",defaultValue:"inset 0 0 0 1px rgba(37, 99, 235, 0.22)",category:"cell",description:"Inner ring that makes the active editing surface read as input-like."},{name:"--sy-grid-active-cell-outline",defaultValue:"#2563eb",category:"focus",description:"Inset outline for the keyboard-active cell."},{name:"--sy-grid-active-row-bg",defaultValue:"rgba(37, 99, 235, 0.08)",category:"focus",description:"Tint for the row containing the active cell."},{name:"--sy-grid-viewport-focus-outline",defaultValue:"#2563eb",category:"focus",description:"Outline drawn when the viewport itself has keyboard focus."},{name:"--sy-grid-scrollbar-thumb",defaultValue:"rgba(15, 23, 42, 0.18)",category:"scrollbar",description:"Scrollbar thumb colour (Webkit / Blink custom scrollbar)."},{name:"--sy-grid-scrollbar-track",defaultValue:"transparent",category:"scrollbar",description:"Scrollbar track colour."},{name:"--sy-grid-sort-indicator-color",defaultValue:"#9ca3af",category:"sort-arrow",description:"Inactive (hover-hint) colour for the sort arrow indicator."},{name:"--sy-grid-sort-indicator-active-color",defaultValue:"#2563eb",category:"sort-arrow",description:"Active sort arrow colour for the currently-sorted column."},{name:"--sy-grid-filter-icon-color",defaultValue:"currentColor",category:"filter",description:"Default filter-icon colour. `currentColor` so it inherits header text."},{name:"--sy-grid-filter-icon-active-color",defaultValue:"#2563eb",category:"filter",description:"Filter-icon colour when the column has an active filter."},{name:"--sy-grid-filter-dropdown-bg",defaultValue:"#ffffff",category:"filter",description:"Filter dropdown panel background."},{name:"--sy-grid-filter-dropdown-color",defaultValue:"#111827",category:"filter",description:"Filter dropdown text colour."},{name:"--sy-grid-filter-dropdown-border",defaultValue:"#e5e7eb",category:"filter",description:"Filter dropdown outer border + input borders."},{name:"--sy-grid-filter-dropdown-shadow",defaultValue:"0 8px 20px rgba(15, 23, 42, 0.12)",category:"filter",description:"Drop shadow under the open filter dropdown."},{name:"--sy-grid-filter-button-primary-bg",defaultValue:"#2563eb",category:"filter",description:"Apply button background inside the filter dropdown."},{name:"--sy-grid-filter-button-primary-color",defaultValue:"#ffffff",category:"filter",description:"Apply button text colour."},{name:"--sy-grid-quick-filter-input-bg",defaultValue:"#ffffff",category:"filter",description:"Quick-filter search input background."},{name:"--sy-grid-quick-filter-input-color",defaultValue:"#111827",category:"filter",description:"Quick-filter input text colour."},{name:"--sy-grid-quick-filter-input-border",defaultValue:"#d1d5db",category:"filter",description:"Quick-filter input border."},{name:"--sy-grid-quick-filter-input-placeholder",defaultValue:"#9ca3af",category:"filter",description:"Quick-filter placeholder text colour."},{name:"--sy-grid-quick-filter-input-focus",defaultValue:"#2563eb",category:"filter",description:"Quick-filter input focus ring + border."},{name:"--sy-grid-quick-filter-clear-color",defaultValue:"#6b7280",category:"filter",description:"Quick-filter clear-button (×) icon colour."},{name:"--sy-grid-quick-filter-clear-hover",defaultValue:"rgba(15, 23, 42, 0.08)",category:"filter",description:"Quick-filter clear-button hover background."},{name:"--sy-grid-pagination-bg",defaultValue:"#f9fafb",category:"pagination",description:"Pagination control bar background."},{name:"--sy-grid-pagination-color",defaultValue:"#111827",category:"pagination",description:"Pagination text colour."},{name:"--sy-grid-pagination-border",defaultValue:"#e5e7eb",category:"pagination",description:"Pagination top border + button borders."},{name:"--sy-grid-pagination-active-bg",defaultValue:"#2563eb",category:"pagination",description:"Active page-number background."},{name:"--sy-grid-pagination-active-color",defaultValue:"#ffffff",category:"pagination",description:"Active page-number text colour."},{name:"--sy-grid-pagination-disabled-color",defaultValue:"#9ca3af",category:"pagination",description:"Pagination text/icon colour for disabled prev/next/ellipsis."},{name:"--sy-grid-pagination-hover-bg",defaultValue:"rgba(15, 23, 42, 0.06)",category:"pagination",description:"Pagination button hover background."},{name:"--sy-grid-empty-state-bg",defaultValue:"rgba(255, 255, 255, 0.92)",category:"loading",description:"Empty-state overlay background (no-data / no-matches)."},{name:"--sy-grid-empty-state-color",defaultValue:"#4b5563",category:"loading",description:"Empty-state message text colour."},{name:"--sy-grid-empty-state-icon-color",defaultValue:"#9ca3af",category:"loading",description:"Empty-state icon colour."},{name:"--sy-grid-empty-state-action-bg",defaultValue:"#2563eb",category:"loading",description:"Empty-state action button background."},{name:"--sy-grid-empty-state-action-color",defaultValue:"#ffffff",category:"loading",description:"Empty-state action button text colour."},{name:"--sy-grid-loading-backdrop",defaultValue:"rgba(255, 255, 255, 0.7)",category:"loading",description:"Loading overlay backdrop colour."},{name:"--sy-grid-loading-spinner-color",defaultValue:"#2563eb",category:"loading",description:"Loading spinner colour."},{name:"--sy-grid-loading-message-color",defaultValue:"#4b5563",category:"loading",description:"Loading message text colour beside the spinner."}];export const defaultTokens=(()=>{const out=Object.create(null);for(const entry of GRID_TOKEN_CATALOGUE){out[entry.name]=entry.defaultValue}return Object.freeze(out)})();export const GRID_TOKEN_NAMES=Object.freeze(GRID_TOKEN_CATALOGUE.map(e=>e.name));export function isGridTokenName(name){return Object.prototype.hasOwnProperty.call(defaultTokens,name)}

package/dist/collection/components/grid/core/types.js

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

package/dist/collection/components/grid/core/utils/structural.js

@@ -0,0 +1 @@
+function cloneOwnProperties(source,target,clone){for(const key of Reflect.ownKeys(source)){if(Array.isArray(source)&&key==="length")continue;const descriptor=Object.getOwnPropertyDescriptor(source,key);if(descriptor===void 0)continue;if("value"in descriptor)descriptor.value=clone(descriptor.value);Object.defineProperty(target,key,descriptor)}}export function structuralClone(value){const seen=new Map;const clone=input=>{if(input===null||typeof input!=="object"&&typeof input!=="function")return input;if(typeof input==="function")return input;const cached=seen.get(input);if(cached!==void 0)return cached;if(input instanceof Date){const out2=new Date(input.getTime());seen.set(input,out2);return out2}if(input instanceof RegExp){const out2=new RegExp(input.source,input.flags);out2.lastIndex=input.lastIndex;seen.set(input,out2);return out2}if(input instanceof ArrayBuffer){const out2=input.slice(0);seen.set(input,out2);return out2}if(ArrayBuffer.isView(input)){const clonedBuffer=clone(input.buffer);let out2;if(input instanceof DataView){out2=new DataView(clonedBuffer,input.byteOffset,input.byteLength)}else{const TypedArray=input.constructor;out2=new TypedArray(clonedBuffer,input.byteOffset,input.length)}seen.set(input,out2);return out2}if(input instanceof Map){const out2=new Map;seen.set(input,out2);for(const[key,item]of input)out2.set(clone(key),clone(item));return out2}if(input instanceof Set){const out2=new Set;seen.set(input,out2);for(const item of input)out2.add(clone(item));return out2}if(Array.isArray(input)){const out2=new Array(input.length);seen.set(input,out2);cloneOwnProperties(input,out2,clone);return out2}const out=Object.create(Object.getPrototypeOf(input));seen.set(input,out);cloneOwnProperties(input,out,clone);return out};return clone(value)}function bytesEqual(a,b){if(a.byteLength!==b.byteLength)return false;const left=new Uint8Array(a.buffer,a.byteOffset,a.byteLength);const right=new Uint8Array(b.buffer,b.byteOffset,b.byteLength);for(let i=0;i<left.length;i+=1){if(left[i]!==right[i])return false}return true}export function structuralEqual(a,b){const leftToRight=new Map;const rightToLeft=new Map;const equal=(left,right)=>{if(Object.is(left,right))return true;if(left===null||right===null||typeof left!=="object"||typeof right!=="object")return false;const mappedRight=leftToRight.get(left);if(mappedRight!==void 0)return mappedRight===right;const mappedLeft=rightToLeft.get(right);if(mappedLeft!==void 0)return mappedLeft===left;leftToRight.set(left,right);rightToLeft.set(right,left);if(left instanceof Date||right instanceof Date){return left instanceof Date&&right instanceof Date&&Object.is(left.getTime(),right.getTime())}if(left instanceof RegExp||right instanceof RegExp){return left instanceof RegExp&&right instanceof RegExp&&left.source===right.source&&left.flags===right.flags&&left.lastIndex===right.lastIndex}if(left instanceof ArrayBuffer||right instanceof ArrayBuffer){return left instanceof ArrayBuffer&&right instanceof ArrayBuffer&&bytesEqual(new Uint8Array(left),new Uint8Array(right))}if(ArrayBuffer.isView(left)||ArrayBuffer.isView(right)){return ArrayBuffer.isView(left)&&ArrayBuffer.isView(right)&&left.constructor===right.constructor&&bytesEqual(left,right)}if(left instanceof Map||right instanceof Map){if(!(left instanceof Map)||!(right instanceof Map)||left.size!==right.size)return false;const l=left.entries();const r=right.entries();for(let next=l.next(),other=r.next();!next.done&&!other.done;next=l.next(),other=r.next()){if(!equal(next.value[0],other.value[0])||!equal(next.value[1],other.value[1]))return false}return true}if(left instanceof Set||right instanceof Set){if(!(left instanceof Set)||!(right instanceof Set)||left.size!==right.size)return false;const l=left.values();const r=right.values();for(let next=l.next(),other=r.next();!next.done&&!other.done;next=l.next(),other=r.next()){if(!equal(next.value,other.value))return false}return true}if(Object.getPrototypeOf(left)!==Object.getPrototypeOf(right))return false;const leftKeys=Reflect.ownKeys(left);const rightKeys=Reflect.ownKeys(right);if(leftKeys.length!==rightKeys.length)return false;for(const key of leftKeys){if(!Object.prototype.hasOwnProperty.call(right,key))return false;const leftDescriptor=Object.getOwnPropertyDescriptor(left,key);const rightDescriptor=Object.getOwnPropertyDescriptor(right,key);if(leftDescriptor===void 0||rightDescriptor===void 0)return false;if(leftDescriptor.enumerable!==rightDescriptor.enumerable||leftDescriptor.configurable!==rightDescriptor.configurable||"writable"in leftDescriptor&&leftDescriptor.writable!==rightDescriptor.writable)return false;if("value"in leftDescriptor){if(!("value"in rightDescriptor)||!equal(leftDescriptor.value,rightDescriptor.value))return false}else if("value"in rightDescriptor||leftDescriptor.get!==rightDescriptor.get||leftDescriptor.set!==rightDescriptor.set)return false}return true};return equal(a,b)}

package/dist/collection/components/grid/core/validation/validation.js

@@ -0,0 +1 @@
+const VALID={valid:true};const isBlank=v=>v===null||v===void 0||v==="";function asNumber(v){if(typeof v==="number")return Number.isFinite(v)?v:null;if(typeof v==="string"&&v.trim()!==""){const n=Number(v);return Number.isFinite(n)?n:null}return null}function defaultMessage(rule){switch(rule.type){case"required":return"Required";case"number":return"Must be a number";case"integer":return"Must be a whole number";case"min":return`Must be ≥ ${String(rule.value)}`;case"max":return`Must be ≤ ${String(rule.value)}`;case"range":return`Must be between ${String(rule.value)} and ${String(rule.value2)}`;case"minLength":return`Must be at least ${String(rule.value)} characters`;case"maxLength":return`Must be at most ${String(rule.value)} characters`;case"pattern":return"Invalid format";case"oneOf":return`Must be one of: ${(rule.values??[]).join(", ")}`;case"custom":return"Invalid value";default:return"Invalid value"}}function asLength(v){const n=asNumber(v);return n!==null&&Number.isInteger(n)&&n>=0?n:null}function invalidResult(rule,message){return{valid:false,ruleType:rule.type,message:message??rule.message??defaultMessage(rule)}}function rulePasses(rule,value,data){if(rule.type==="required")return!isBlank(value);if(isBlank(value))return true;switch(rule.type){case"number":return asNumber(value)!==null;case"integer":{const n=asNumber(value);return n!==null&&Number.isInteger(n)}case"min":{const n=asNumber(value);const b=asNumber(rule.value);return n!==null&&b!==null&&n>=b}case"max":{const n=asNumber(value);const b=asNumber(rule.value);return n!==null&&b!==null&&n<=b}case"range":{const n=asNumber(value);const lo=asNumber(rule.value);const hi=asNumber(rule.value2);if(n===null||lo===null||hi===null)return false;return n>=Math.min(lo,hi)&&n<=Math.max(lo,hi)}case"minLength":case"maxLength":{const length=asLength(rule.value);if(length===null)return false;return rule.type==="minLength"?String(value).length>=length:String(value).length<=length}case"pattern":{const src=typeof rule.pattern==="string"?rule.pattern:typeof rule.value==="string"?rule.value:null;if(src===null)return false;try{return new RegExp(src).test(String(value))}catch{return false}}case"oneOf":return Array.isArray(rule.values)&&rule.values.some(v=>v===value||String(v)===String(value));case"custom":if(typeof rule.validator!=="function")return false;try{return rule.validator(value,data)===true}catch{return false}default:return false}}export function evaluateValidationRule(rule,ctx){if(rule===null||typeof rule!=="object")return VALID;if(rule.type==="custom"&&typeof rule.validator==="function"&&!isBlank(ctx.value)){let out;try{out=rule.validator(ctx.value,ctx.data)}catch{return invalidResult(rule)}if(out===true)return VALID;return invalidResult(rule,typeof out==="string"?out:void 0)}return rulePasses(rule,ctx.value,ctx.data)?VALID:invalidResult(rule)}export function evaluateValidation(rules,ctx){if(!Array.isArray(rules)||rules.length===0)return VALID;for(const rule of rules){if(rule.field!==ctx.field)continue;const res=evaluateValidationRule(rule,ctx);if(!res.valid)return res}return VALID}

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

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

package/dist/collection/components/grid/core/virtualizer/column-virtualizer.js

@@ -0,0 +1 @@
+export function computeColumnWindow(input){const widths=input.widths;const total=widths.length;const overscan=input.overscan??3;if(total===0){return{start:0,end:0,leadingPx:0,trailingPx:0,total:0}}const viewStart=Math.max(0,input.scrollLeft);const viewEnd=viewStart+Math.max(0,input.viewportWidth);let start=0;let x=0;while(start<total&&x+widths[start]<=viewStart){x+=widths[start];start++}let end=start;let x2=x;while(end<total&&x2<viewEnd){x2+=widths[end];end++}start=Math.max(0,start-overscan);end=Math.min(total,end+overscan);if(start>=total)start=Math.max(0,total-1);if(end<=start)end=Math.min(total,start+1);let leadingPx=0;for(let i=0;i<start;i++)leadingPx+=widths[i];let trailingPx=0;for(let i=end;i<total;i++)trailingPx+=widths[i];return{start,end,leadingPx,trailingPx,total}}

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

@@ -0,0 +1 @@
+export{computeVirtualWindow,attachVirtualScroll,DEFAULT_OVERSCAN,computeVariableVirtualWindow,createRowHeightCache,DEFAULT_ESTIMATED_ROW_HEIGHT,computeCachedVariableWindow}from"./row-virtualizer.js";

package/dist/collection/components/grid/core/virtualizer/row-virtualizer.js

@@ -0,0 +1 @@
+export const DEFAULT_OVERSCAN=3;const EMPTY_RESULT=Object.freeze({startIndex:0,endIndex:0,paddingTop:0,paddingBottom:0,totalHeight:0,visibleCount:0});function safeNonNegativeInt(value,fallback=0){if(typeof value!=="number")return fallback;if(!Number.isFinite(value))return fallback;if(value<=0)return fallback===0?0:Math.max(0,Math.floor(fallback));return Math.floor(value)}function safeNonNegativeFloat(value,fallback=0){if(typeof value!=="number"||!Number.isFinite(value))return fallback;if(value<=0)return 0;return value}export function computeVirtualWindow(options){const{rowHeight}=options;if(typeof rowHeight!=="number"||!Number.isFinite(rowHeight)||rowHeight<=0){throw new RangeError(`[Syidax] computeVirtualWindow: rowHeight must be a finite positive number, got ${rowHeight}.`)}const totalRows=safeNonNegativeInt(options.totalRows);if(totalRows===0)return EMPTY_RESULT;const viewportHeight=safeNonNegativeFloat(options.viewportHeight);const totalHeight=totalRows*rowHeight;if(viewportHeight===0){return{startIndex:0,endIndex:0,paddingTop:0,paddingBottom:totalHeight,totalHeight,visibleCount:0}}const overscan=safeNonNegativeInt(options.overscan??DEFAULT_OVERSCAN);const maxScrollTop=Math.max(0,totalHeight-viewportHeight);const rawScrollTop=safeNonNegativeFloat(options.scrollTop);const scrollTop=Math.min(rawScrollTop,maxScrollTop);const firstVisible=Math.floor(scrollTop/rowHeight);const lastVisible=Math.ceil((scrollTop+viewportHeight)/rowHeight);const startIndex=Math.max(0,firstVisible-overscan);const endIndex=Math.min(totalRows,lastVisible+overscan);const paddingTop=startIndex*rowHeight;const paddingBottom=(totalRows-endIndex)*rowHeight;const visibleCount=Math.max(0,endIndex-startIndex);return{startIndex,endIndex,paddingTop,paddingBottom,totalHeight,visibleCount}}export function attachVirtualScroll(container,options,onChange){if(!container||typeof container.addEventListener!=="function"){throw new TypeError("[Syidax] attachVirtualScroll: container must be an element with addEventListener.")}if(typeof onChange!=="function"){throw new TypeError("[Syidax] attachVirtualScroll: onChange must be a function.")}const raf=typeof requestAnimationFrame==="function"?cb=>requestAnimationFrame(cb):cb=>setTimeout(cb,16);const cancelRaf=typeof cancelAnimationFrame==="function"?handle=>cancelAnimationFrame(handle):handle=>clearTimeout(handle);let pending=null;let detached=false;const fire=()=>{if(detached)return;let result;try{result=computeVirtualWindow({...options,scrollTop:typeof container.scrollTop==="number"?container.scrollTop:0})}catch(err){console.error("[Syidax] attachVirtualScroll: compute failed:",err);return}try{onChange(result)}catch(err){console.error("[Syidax] attachVirtualScroll: onChange handler threw:",err)}};const handler=()=>{if(detached)return;if(pending!==null)return;pending=raf(()=>{pending=null;fire()})};container.addEventListener("scroll",handler,{passive:true});fire();return()=>{if(detached)return;detached=true;container.removeEventListener("scroll",handler);if(pending!==null){cancelRaf(pending);pending=null}}}export const DEFAULT_ESTIMATED_ROW_HEIGHT=30;const EMPTY_VARIABLE_RESULT=Object.freeze({startIndex:0,endIndex:0,paddingTop:0,paddingBottom:0,totalHeight:0,visibleCount:0});function safeHeight(raw,estimated){if(typeof raw!=="number")return estimated;if(!Number.isFinite(raw))return estimated;if(raw<=0)return estimated;return raw}function binarySearchRowAtOffset(target,totalRows,getOffset){if(totalRows<=0)return 0;if(target<=0)return 0;let lo=0;let hi=totalRows;while(lo<hi){const mid=lo+hi>>>1;const offset=getOffset(mid);if(offset<=target){lo=mid+1}else{hi=mid}}return Math.max(0,lo-1)}function binarySearchFirstRowBelowOffset(target,totalRows,getOffset){if(totalRows<=0)return 0;if(target<=0)return 0;let lo=0;let hi=totalRows;while(lo<hi){const mid=lo+hi>>>1;const offset=getOffset(mid);if(offset<target){lo=mid+1}else{hi=mid}}return lo}export function computeVariableVirtualWindow(options){if(typeof options.rowHeight!=="function"){throw new TypeError("[Syidax] computeVariableVirtualWindow: rowHeight must be a function (index) => number.")}const totalRows=safeNonNegativeInt(options.totalRows);if(totalRows===0)return EMPTY_VARIABLE_RESULT;const estimatedRaw=options.estimatedRowHeight;const estimated=typeof estimatedRaw==="number"&&Number.isFinite(estimatedRaw)&&estimatedRaw>0?estimatedRaw:DEFAULT_ESTIMATED_ROW_HEIGHT;const offsets=new Float64Array(totalRows+1);let acc=0;for(let i=0;i<totalRows;i++){const h=safeHeight(options.rowHeight(i),estimated);offsets[i]=acc;acc+=h}offsets[totalRows]=acc;const totalHeight=acc;const viewportHeight=safeNonNegativeFloat(options.viewportHeight);if(viewportHeight===0){return{startIndex:0,endIndex:0,paddingTop:0,paddingBottom:totalHeight,totalHeight,visibleCount:0}}const overscan=safeNonNegativeInt(options.overscan??DEFAULT_OVERSCAN);const maxScrollTop=Math.max(0,totalHeight-viewportHeight);const rawScrollTop=safeNonNegativeFloat(options.scrollTop);const scrollTop=Math.min(rawScrollTop,maxScrollTop);const getOffset=i=>offsets[i];const firstVisible=binarySearchRowAtOffset(scrollTop,totalRows,getOffset);const bottomTarget=scrollTop+viewportHeight;const lastVisible=binarySearchFirstRowBelowOffset(bottomTarget,totalRows,getOffset);const startIndex=Math.max(0,firstVisible-overscan);const endIndex=Math.min(totalRows,lastVisible+overscan);const paddingTop=offsets[startIndex];const paddingBottom=totalHeight-offsets[endIndex];const visibleCount=Math.max(0,endIndex-startIndex);return{startIndex,endIndex,paddingTop,paddingBottom,totalHeight,visibleCount}}export function createRowHeightCache(estimatedRowHeight=DEFAULT_ESTIMATED_ROW_HEIGHT){const estimated=typeof estimatedRowHeight==="number"&&Number.isFinite(estimatedRowHeight)&&estimatedRowHeight>0?estimatedRowHeight:DEFAULT_ESTIMATED_ROW_HEIGHT;const heights=new Map;const offsetCache=new Map;let highWater=0;offsetCache.set(0,0);const getHeight=index=>{if(typeof index!=="number"||!Number.isFinite(index)||index<0){return estimated}const i=Math.floor(index);const measured=heights.get(i);if(measured===void 0)return estimated;return measured};const setHeight=(index,px)=>{if(typeof index!=="number"||!Number.isFinite(index)||index<0)return;const i=Math.floor(index);const safe=safeHeight(px,estimated);const prev=heights.get(i);if(prev===safe)return;heights.set(i,safe);if(highWater>i){for(let k=i+1;k<=highWater;k++){offsetCache.delete(k)}highWater=i}};const reset=()=>{heights.clear();offsetCache.clear();offsetCache.set(0,0);highWater=0};const getOffset=index=>{if(typeof index!=="number"||!Number.isFinite(index)||index<=0){return 0}const target=Math.floor(index);const cached=offsetCache.get(target);if(cached!==void 0)return cached;let acc=offsetCache.get(highWater)??0;for(let i=highWater;i<target;i++){acc+=getHeight(i);offsetCache.set(i+1,acc)}if(target>highWater)highWater=target;return acc};const getTotalHeight=totalRows=>{const n=safeNonNegativeInt(totalRows);return getOffset(n)};const findRowAtOffset=(y,totalRows)=>{const n=safeNonNegativeInt(totalRows);if(n===0)return 0;if(typeof y!=="number"||!Number.isFinite(y)||y<=0)return 0;getOffset(n);const row=binarySearchRowAtOffset(y,n,i=>offsetCache.get(i)??getOffset(i));return Math.min(n-1,row)};return{getHeight,setHeight,reset,getOffset,getTotalHeight,findRowAtOffset}}export function computeCachedVariableWindow(cache,options){const totalRows=safeNonNegativeInt(options.totalRows);if(totalRows===0)return EMPTY_VARIABLE_RESULT;const totalHeight=cache.getTotalHeight(totalRows);const viewportHeight=safeNonNegativeFloat(options.viewportHeight);if(viewportHeight===0){return{startIndex:0,endIndex:0,paddingTop:0,paddingBottom:totalHeight,totalHeight,visibleCount:0}}const overscan=safeNonNegativeInt(options.overscan??DEFAULT_OVERSCAN);const maxScrollTop=Math.max(0,totalHeight-viewportHeight);const rawScrollTop=safeNonNegativeFloat(options.scrollTop);const scrollTop=Math.min(rawScrollTop,maxScrollTop);const firstVisible=cache.findRowAtOffset(scrollTop,totalRows);const bottomTarget=scrollTop+viewportHeight;const rowAtBottom=cache.findRowAtOffset(bottomTarget,totalRows);const lastVisible=cache.getOffset(rowAtBottom)>=bottomTarget?rowAtBottom:rowAtBottom+1;const startIndex=Math.max(0,firstVisible-overscan);const endIndex=Math.min(totalRows,lastVisible+overscan);const paddingTop=cache.getOffset(startIndex);const paddingBottom=Math.max(0,totalHeight-cache.getOffset(endIndex));const visibleCount=Math.max(0,endIndex-startIndex);return{startIndex,endIndex,paddingTop,paddingBottom,totalHeight,visibleCount}}