@ishibashi0112/spreadsheet-grid-core 0.39.0 → 0.41.0

package/dist/engine/filterPopoverCommands.js

@@ -195,22 +195,22 @@ var h = (e, t) => {
 			return;
 		}
 		a(e.setColumnFilter(o, n(s)));
-	}, D = (e) => {
-		let { updateNumberDraft: t, openedFilterType: n } = m();
-		if (t(e), n !== "numberSet") return;
-		let r = s(e);
-		E(r !== null, (e) => ({
+	}, D = (e, t) => {
+		let { updateNumberDraft: n, openedFilterType: r } = m();
+		if (n(e), r !== "numberSet" || t?.commit === !1) return;
+		let i = s(e);
+		E(i !== null, (e) => ({
 			kind: "numberSet",
-			condition: r,
+			condition: i,
 			set: e
 		}));
-	}, O = (e) => {
-		let { updateTextDraft: t, openedFilterType: n } = m();
-		if (t(e), n !== "textSet") return;
-		let r = l(e);
-		E(r !== null, (e) => ({
+	}, O = (e, t) => {
+		let { updateTextDraft: n, openedFilterType: r } = m();
+		if (n(e), r !== "textSet" || t?.commit === !1) return;
+		let i = l(e);
+		E(i !== null, (e) => ({
 			kind: "textSet",
-			condition: r,
+			condition: i,
 			set: e
 		}));
 	}, k = (e) => {

package/dist/engine/gridApi.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/grouping.cjs"),t=require("../logic/detailRow.cjs"),n=require("../model/gridActions.cjs"),r=require("../logic/geometry.cjs"),i=require("../model/gridSelectors.cjs"),a=require("../logic/validation.cjs"),o=require("../logic/verticalGeometry.cjs"),s=require("../logic/rowSelection.cjs"),c=require("../logic/gridState.cjs"),l=require("../logic/scrollTargets.cjs"),u=require("../logic/exportCsv.cjs"),d=require("../logic/exportData.cjs"),f=require("../logic/exportScope.cjs");var p=()=>{let p=null,m=(e,t,n=`auto`)=>{let r=Math.max(e.scrollHeight-e.clientHeight,0),i=Math.max(e.scrollWidth-e.clientWidth,0),a=Math.min(Math.max(t.top,0),r),o=Math.min(Math.max(t.left,0),i);(Math.round(a)!==Math.round(e.scrollTop)||Math.round(o)!==Math.round(e.scrollLeft))&&p?.markApiScroll(),e.scrollTo({top:a,left:o,behavior:n})},h=(e,t)=>{let n=p?.scrollContainerRef.current??null,r=p;!n||!r||m(n,{top:e===null?n.scrollTop:o.logicalToPhysicalScrollTop(e,r.verticalScaleFactor),left:t===null?n.scrollLeft:t})},g=(e,t)=>{let n=p?.scrollContainerRef.current??null,r=p;if(!n||!r||r.viewRowCount===0)return null;let i=Math.min(Math.max(e,0),r.viewRowCount-1);return l.computeVerticalScrollTarget({rowTop:r.rowMetrics.rowTop(i),rowHeight:r.rowMetrics.cellHeight(i),headerHeight:r.headerHeight,viewportHeight:n.clientHeight,currentScrollTop:o.physicalToLogicalScrollTop(n.scrollTop,r.verticalScaleFactor),align:t})},_=(e,t)=>{let n=p?.scrollContainerRef.current??null,i=p;if(!n||!i)return null;let a=r.computeSinglePaneColumnExtent(i.paneLayout,e);return!a||a.pane!==`center`?null:l.computeHorizontalScrollTarget({cellLeft:i.leftPaneTotalWidth+i.centerLeadingWidth+a.extent.start,cellWidth:a.extent.width,leftPaneWidth:i.leftPaneTotalWidth,rightPaneWidth:i.rightPaneTotalWidth,viewportWidth:n.clientWidth,currentScrollLeft:n.scrollLeft,align:t})},v=(e,t,n)=>{h(g(e,n),_(t,n))},y=e=>{let t=p;if(!t)return null;let n=e=>t.rowModel.getRow(e),r=t.isRowExportable,a=r?(e,n)=>r(e,{viewRowIndex:n,rowKey:t.rowModel.getRowKey(n)??n}):void 0,o=r?(e,n)=>r(e,{viewRowIndex:n,rowKey:t.resolvedRowKeyGetter(e,n)}):void 0,s=f.normalizeExportScope(e);if(s===`raw`)return t.isServerSide?(console.warn(`SpreadsheetGrid: scope 'raw' は serverSide では未ロード行を取得できないため、'view'(ロード済みビュー行)として扱います。全件エクスポートはサーバ側での実施を推奨します。`),{getRow:n,startRow:0,endRow:t.viewRowCount,columns:t.orderedColumns,isRowIncluded:a}):{getRow:e=>t.rows[e],startRow:0,endRow:t.rows.length,columns:t.orderedColumns,isRowIncluded:o};if(s===`rendered`)return{getRow:n,startRow:t.windowFirstRow,endRow:t.windowLastRow>=t.windowFirstRow?t.windowLastRow+1:t.windowFirstRow,columns:t.orderedColumns,isRowIncluded:a};if(s===`selection`){let e=t.uiState.selection;if(!e)return null;if(e.type===`cell`){let r=i.normalizeCellRange(e.range);return{getRow:n,startRow:r.start.row,endRow:r.end.row+1,columns:t.orderedColumns.slice(r.start.col,r.end.col+1),isRowIncluded:a}}if(e.type===`row`){let r=i.normalizeRowRange(e.startRow,e.endRow);return{getRow:n,startRow:r.startRow,endRow:r.endRow+1,columns:t.orderedColumns,isRowIncluded:a}}let r=i.normalizeColumnRange(e.startCol,e.endCol);return{getRow:n,startRow:0,endRow:t.viewRowCount,columns:t.orderedColumns.slice(r.startCol,r.endCol+1),isRowIncluded:a}}return{getRow:n,startRow:0,endRow:t.viewRowCount,columns:t.orderedColumns,isRowIncluded:a}},b=e=>e.filter(e=>!t.isSyntheticColumnKey(e.key)),x=e=>{let t=y(e?.scope??`view`);return t?u.serializeRowsToCsv({getRow:t.getRow,startRow:t.startRow,endRow:t.endRow,columns:b(t.columns),delimiter:e?.delimiter,includeHeaders:e?.includeHeaders,bom:e?.bom,isRowIncluded:t.isRowIncluded}):e?.bom?``:``},S=e=>{let t=y(e?.scope??`view`);return t?d.buildGridExportData({getRow:t.getRow,startRow:t.startRow,endRow:t.endRow,columns:b(t.columns),isRowIncluded:t.isRowIncluded}):{columns:[],rows:[]}};return{update:e=>{p=e},handle:{scrollToRow:(e,t)=>h(g(e,t?.align??`auto`),null),scrollToCell:(e,t,n)=>v(e,t,n?.align??`auto`),scrollToTop:()=>{let e=p?.scrollContainerRef.current??null;e&&m(e,{top:0,left:e.scrollLeft})},scrollToBottom:()=>{let e=p?.scrollContainerRef.current??null,t=p;!e||!t||m(e,{top:Math.max(t.headerHeight+t.physicalBodyHeight-e.clientHeight,0),left:e.scrollLeft})},getScrollPosition:()=>{let e=p?.scrollContainerRef.current??null;return e?{top:e.scrollTop,left:e.scrollLeft}:null},setScrollPosition:(e,t)=>{let n=p?.scrollContainerRef.current??null;n&&m(n,{top:e.top??n.scrollTop,left:e.left??n.scrollLeft},t?.behavior??`auto`)},getVisibleRowRange:()=>{let e=p;return!e||e.windowLastRow<e.windowFirstRow?null:{startIndex:e.windowFirstRow,endIndex:e.windowLastRow+1}},getActiveCell:()=>{let e=p?.uiState.activeCell;return e?{row:e.row,col:e.col}:null},setActiveCell:(e,t)=>{let r=p;r&&(r.dispatch(n.gridActions.activateCell(e)),e&&t?.scrollIntoView&&v(e.row,e.col,`auto`))},getSelection:()=>p?.uiState.selection??null,selectCell:(e,t,r)=>{let i=p;if(!i)return;let a={row:e,col:t};i.dispatch(n.gridActions.startSelection(a)),i.dispatch(n.gridActions.endSelection()),r?.scrollIntoView&&v(e,t,`auto`)},selectRange:(e,t)=>{let r=p;r&&(r.dispatch(n.gridActions.startSelection(e.start)),r.dispatch(n.gridActions.updateSelection(e.end)),r.dispatch(n.gridActions.endSelection()),t?.scrollIntoView&&v(e.end.row,e.end.col,`auto`))},clearSelection:()=>{p?.dispatch(n.gridActions.clearSelection())},getSelectedRows:()=>{let e=p;if(!e)return[];let t=e.uiState.selection;if(!t)return[];let n=[],r=t=>{let r=e.rowModel.getRow(t);r&&n.push(r)};if(t.type===`cell`){let e=i.normalizeCellRange(t.range);for(let t=e.start.row;t<=e.end.row;t+=1)r(t)}else if(t.type===`row`){let e=i.normalizeRowRange(t.startRow,t.endRow);for(let t=e.startRow;t<=e.endRow;t+=1)r(t)}else for(let t=0;t<e.viewRowCount;t+=1)r(t);return n},exportCsv:e=>x(e),downloadCsv:(e,t)=>{if(typeof document>`u`)return;let n=x({...t,bom:t?.bom??!0}),r=new Blob([n],{type:`text/csv;charset=utf-8;`}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=e??`export.csv`,document.body.appendChild(a),a.click(),document.body.removeChild(a),URL.revokeObjectURL(i)},getExportData:e=>S(e),getState:()=>{let e=p;return e?c.buildGridState(e.uiState.columnWidths,e.uiState.filters,e.uiState.sort,c.extractColumnState(e.columns)):c.buildGridState({},{globalText:``,columnFilters:{}},[],[])},applyState:e=>{let t=p;if(!t)return;let r=c.migrateGridState(e);t.onColumnsChange&&r.columns&&t.onColumnsChange(c.applyColumnState(t.columns,r.columns,r.columnWidths)),t.dispatch(n.gridActions.resetColumnWidths(r.columnWidths)),t.dispatch(n.gridActions.setAllFilters(r.filters)),t.dispatch(n.gridActions.setSort(r.sort))},getRowSelection:()=>{let e=p;return e?s.rowSelectionToModel(e.uiState.rowSelection):{type:`include`,rowKeys:[]}},setRowSelection:e=>{p?.commitRowSelection(s.rowSelectionFromModel(e))},getSelectedRowKeys:()=>{let e=p;if(!e)return[];let t=e.uiState.rowSelection;if(t.mode===`include`)return Array.from(t.keys);let n=[],r=e.rowModel.getRowCount();for(let i=0;i<r;i+=1){if(!e.rowModel.getRow(i))continue;let r=e.rowModel.getRowKey(i)??i;t.keys.has(r)||n.push(r)}return n},getSelectedRowData:()=>{let e=p;if(!e)return[];let t=e.uiState.rowSelection,n=[],r=e.rowModel.getRowCount();for(let i=0;i<r;i+=1){let r=e.rowModel.getRow(i);r&&s.resolveIsRowSelected(t,e.rowModel.getRowKey(i)??i)&&n.push(r)}return n},getSelectedRowCount:()=>{let e=p;return e?s.countSelectedRows(e.uiState.rowSelection,e.leafRowCount):0},isRowSelected:e=>{let t=p;return t?s.resolveIsRowSelected(t.uiState.rowSelection,e):!1},selectAllRows:()=>{p?.commitRowSelection(s.selectAllRows())},clearRowSelection:()=>{p?.commitRowSelection(s.clearRowSelection())},undo:()=>{p?.undoRows()},redo:()=>{p?.redoRows()},canUndo:()=>p?.canUndoRows()??!1,canRedo:()=>p?.canRedoRows()??!1,clearUndoHistory:()=>{p?.clearUndoHistory()},setGroupCollapsed:(e,t)=>{p?.dispatch(n.gridActions.setGroupCollapsed(e,t))},expandAllGroups:()=>{p?.dispatch(n.gridActions.setCollapsedGroupKeys(new Set))},collapseAllGroups:()=>{let t=p;!t||!t.groupTree||t.dispatch(n.gridActions.setCollapsedGroupKeys(new Set(e.collectAllGroupKeys(t.groupTree))))},getGroupRows:()=>{let t=p;return t?.groupTree?e.collectAllGroupRows(t.groupTree):[]},setDetailRowExpanded:(e,r)=>{let i=p;if(!(!i||!i.detailRowEnabled)){if(r&&i.detailIsExpandable){let n=t.findDetailRowIndex(i.rowModel,e,i.detailIndexCacheRef.current,!i.isServerSide);if(n>=0){let t=i.rowModel.getRow(n);if(t!=null&&!i.detailIsExpandable(t,{rowKey:e,sourceRowIndex:i.rowModel.getSourceIndex(n)}))return}}i.dispatch(n.gridActions.setDetailRowExpanded(e,r))}},getExpandedDetailRowKeys:()=>{let e=p;return e&&e.detailRowEnabled?Array.from(e.uiState.expandedDetailRowKeys):[]},collapseAllDetailRows:()=>{let e=p;!e||!e.detailRowEnabled||e.dispatch(n.gridActions.setExpandedDetailRowKeys(new Set))},moveRow:(e,t)=>{p?.moveRowByKey(e,t)},getInvalidCells:()=>{let e=p;return e?e.isServerSide?(console.warn(`[SpreadsheetGrid] getInvalidCells は serverSide モードでは利用できません(空配列を返します)。`),[]):a.scanInvalidCells(e.rows,e.columns,e.resolvedRowKeyGetter):[]},refreshServerSide:()=>{let e=p;if(e){if(!e.isServerSide){console.warn(`[SpreadsheetGrid] refreshServerSide は clientSide(rows)モードでは何もしません(dataSource 指定時のみ有効です)。`);return}e.serverSideRefresh()}},openFilterManager:()=>{p?.openToolPanel(`filter`)},closeFilterManager:()=>{let e=p;e&&e.activeToolPanelTab===`filter`&&e.closeToolPanel()}},applyScroll:h,verticalTargetFor:g,horizontalTargetFor:_,scrollToCellInternal:v}};exports.createGridApi=p;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/grouping.cjs"),t=require("../logic/detailRow.cjs"),n=require("../model/gridActions.cjs"),r=require("../logic/geometry.cjs"),i=require("../model/gridSelectors.cjs"),a=require("../logic/validation.cjs"),o=require("../logic/verticalGeometry.cjs"),s=require("../logic/rowSelection.cjs"),c=require("../logic/gridState.cjs"),l=require("../logic/scrollTargets.cjs"),u=require("../logic/exportCsv.cjs"),d=require("../logic/exportData.cjs"),f=require("../logic/exportScope.cjs");var p=()=>{let p=null,m=(e,t,n=`auto`)=>{let r=Math.max(e.scrollHeight-e.clientHeight,0),i=Math.max(e.scrollWidth-e.clientWidth,0),a=Math.min(Math.max(t.top,0),r),o=Math.min(Math.max(t.left,0),i);(Math.round(a)!==Math.round(e.scrollTop)||Math.round(o)!==Math.round(e.scrollLeft))&&p?.markApiScroll(),e.scrollTo({top:a,left:o,behavior:n})},h=(e,t)=>{let n=p?.scrollContainerRef.current??null,r=p;!n||!r||m(n,{top:e===null?n.scrollTop:o.logicalToPhysicalScrollTop(e,r.verticalScaleFactor),left:t===null?n.scrollLeft:t})},g=(e,t)=>{let n=p?.scrollContainerRef.current??null,r=p;if(!n||!r||r.viewRowCount===0)return null;let i=Math.min(Math.max(e,0),r.viewRowCount-1);return l.computeVerticalScrollTarget({rowTop:r.rowMetrics.rowTop(i),rowHeight:r.rowMetrics.cellHeight(i),headerHeight:r.headerHeight,viewportHeight:n.clientHeight,currentScrollTop:o.physicalToLogicalScrollTop(n.scrollTop,r.verticalScaleFactor),align:t})},_=(e,t)=>{let n=p?.scrollContainerRef.current??null,i=p;if(!n||!i)return null;let a=r.computeSinglePaneColumnExtent(i.paneLayout,e);return!a||a.pane!==`center`?null:l.computeHorizontalScrollTarget({cellLeft:i.leftPaneTotalWidth+i.centerLeadingWidth+a.extent.start,cellWidth:a.extent.width,leftPaneWidth:i.leftPaneTotalWidth,rightPaneWidth:i.rightPaneTotalWidth,viewportWidth:n.clientWidth,currentScrollLeft:n.scrollLeft,align:t})},v=(e,t,n)=>{h(g(e,n),_(t,n))},y=(e,t=!1)=>{let n=p;if(!n)return null;let r=e=>n.rowModel.getRow(e),a=n.labelRowExport,o=e=>{if(!a)return[];let t=a.exportText?a.exportText(e):a.getLabel(e);return typeof t==`string`?[t]:t},s=t&&a&&n.rowModel.getLabelRow?e=>{let t=n.rowModel.getLabelRow?.(e);return t?o(t.row):void 0}:void 0,c=n.isRowExportable,l=c?(e,t)=>c(e,{viewRowIndex:t,rowKey:n.rowModel.getRowKey(t)??t}):void 0,u=c?(e,t)=>c(e,{viewRowIndex:t,rowKey:n.resolvedRowKeyGetter(e,t)}):void 0,d=f.normalizeExportScope(e);if(d===`raw`){if(n.isServerSide)return console.warn(`SpreadsheetGrid: scope 'raw' は serverSide では未ロード行を取得できないため、'view'(ロード済みビュー行)として扱います。全件エクスポートはサーバ側での実施を推奨します。`),{getRow:r,startRow:0,endRow:n.viewRowCount,columns:n.orderedColumns,isRowIncluded:l};let e=e=>a!==void 0&&n.rows[e]!==void 0&&a.isLabelRow(n.rows[e],e);return{getRow:t=>e(t)?void 0:n.rows[t],startRow:0,endRow:n.rows.length,columns:n.orderedColumns,isRowIncluded:u,getLabelLine:t&&a?t=>e(t)?o(n.rows[t]):void 0:void 0}}if(d===`rendered`)return{getRow:r,startRow:n.windowFirstRow,endRow:n.windowLastRow>=n.windowFirstRow?n.windowLastRow+1:n.windowFirstRow,columns:n.orderedColumns,isRowIncluded:l,getLabelLine:s};if(d===`selection`){let e=n.uiState.selection;if(!e)return null;if(e.type===`cell`){let t=i.normalizeCellRange(e.range);return{getRow:r,startRow:t.start.row,endRow:t.end.row+1,columns:n.orderedColumns.slice(t.start.col,t.end.col+1),isRowIncluded:l,getLabelLine:s}}if(e.type===`row`){let t=i.normalizeRowRange(e.startRow,e.endRow);return{getRow:r,startRow:t.startRow,endRow:t.endRow+1,columns:n.orderedColumns,isRowIncluded:l,getLabelLine:s}}let t=i.normalizeColumnRange(e.startCol,e.endCol);return{getRow:r,startRow:0,endRow:n.viewRowCount,columns:n.orderedColumns.slice(t.startCol,t.endCol+1),isRowIncluded:l,getLabelLine:s}}return{getRow:r,startRow:0,endRow:n.viewRowCount,columns:n.orderedColumns,isRowIncluded:l,getLabelLine:s}},b=e=>e.filter(e=>!t.isSyntheticColumnKey(e.key)),x=e=>{let t=y(e?.scope??`view`,e?.includeLabelRows===!0);return t?u.serializeRowsToCsv({getRow:t.getRow,startRow:t.startRow,endRow:t.endRow,columns:b(t.columns),delimiter:e?.delimiter,includeHeaders:e?.includeHeaders,bom:e?.bom,isRowIncluded:t.isRowIncluded,getLabelLine:t.getLabelLine}):e?.bom?``:``},S=e=>{let t=y(e?.scope??`view`,e?.includeLabelRows===!0);return t?d.buildGridExportData({getRow:t.getRow,startRow:t.startRow,endRow:t.endRow,columns:b(t.columns),isRowIncluded:t.isRowIncluded,getLabelLine:t.getLabelLine}):{columns:[],rows:[]}};return{update:e=>{p=e},handle:{scrollToRow:(e,t)=>h(g(e,t?.align??`auto`),null),scrollToCell:(e,t,n)=>v(e,t,n?.align??`auto`),scrollToTop:()=>{let e=p?.scrollContainerRef.current??null;e&&m(e,{top:0,left:e.scrollLeft})},scrollToBottom:()=>{let e=p?.scrollContainerRef.current??null,t=p;!e||!t||m(e,{top:Math.max(t.headerHeight+t.physicalBodyHeight-e.clientHeight,0),left:e.scrollLeft})},getScrollPosition:()=>{let e=p?.scrollContainerRef.current??null;return e?{top:e.scrollTop,left:e.scrollLeft}:null},setScrollPosition:(e,t)=>{let n=p?.scrollContainerRef.current??null;n&&m(n,{top:e.top??n.scrollTop,left:e.left??n.scrollLeft},t?.behavior??`auto`)},getVisibleRowRange:()=>{let e=p;return!e||e.windowLastRow<e.windowFirstRow?null:{startIndex:e.windowFirstRow,endIndex:e.windowLastRow+1}},getActiveCell:()=>{let e=p?.uiState.activeCell;return e?{row:e.row,col:e.col}:null},setActiveCell:(e,t)=>{let r=p;r&&(r.dispatch(n.gridActions.activateCell(e)),e&&t?.scrollIntoView&&v(e.row,e.col,`auto`))},getSelection:()=>p?.uiState.selection??null,selectCell:(e,t,r)=>{let i=p;if(!i)return;let a={row:e,col:t};i.dispatch(n.gridActions.startSelection(a)),i.dispatch(n.gridActions.endSelection()),r?.scrollIntoView&&v(e,t,`auto`)},selectRange:(e,t)=>{let r=p;r&&(r.dispatch(n.gridActions.startSelection(e.start)),r.dispatch(n.gridActions.updateSelection(e.end)),r.dispatch(n.gridActions.endSelection()),t?.scrollIntoView&&v(e.end.row,e.end.col,`auto`))},clearSelection:()=>{p?.dispatch(n.gridActions.clearSelection())},getSelectedRows:()=>{let e=p;if(!e)return[];let t=e.uiState.selection;if(!t)return[];let n=[],r=t=>{let r=e.rowModel.getRow(t);r&&n.push(r)};if(t.type===`cell`){let e=i.normalizeCellRange(t.range);for(let t=e.start.row;t<=e.end.row;t+=1)r(t)}else if(t.type===`row`){let e=i.normalizeRowRange(t.startRow,t.endRow);for(let t=e.startRow;t<=e.endRow;t+=1)r(t)}else for(let t=0;t<e.viewRowCount;t+=1)r(t);return n},exportCsv:e=>x(e),downloadCsv:(e,t)=>{if(typeof document>`u`)return;let n=x({...t,bom:t?.bom??!0}),r=new Blob([n],{type:`text/csv;charset=utf-8;`}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=e??`export.csv`,document.body.appendChild(a),a.click(),document.body.removeChild(a),URL.revokeObjectURL(i)},getExportData:e=>S(e),getState:()=>{let e=p;return e?c.buildGridState(e.uiState.columnWidths,e.uiState.filters,e.uiState.sort,c.extractColumnState(e.columns)):c.buildGridState({},{globalText:``,columnFilters:{}},[],[])},applyState:e=>{let t=p;if(!t)return;let r=c.migrateGridState(e);t.onColumnsChange&&r.columns&&t.onColumnsChange(c.applyColumnState(t.columns,r.columns,r.columnWidths)),t.dispatch(n.gridActions.resetColumnWidths(r.columnWidths)),t.dispatch(n.gridActions.setAllFilters(r.filters)),t.dispatch(n.gridActions.setSort(r.sort))},getRowSelection:()=>{let e=p;return e?s.rowSelectionToModel(e.uiState.rowSelection):{type:`include`,rowKeys:[]}},setRowSelection:e=>{p?.commitRowSelection(s.rowSelectionFromModel(e))},getSelectedRowKeys:()=>{let e=p;if(!e)return[];let t=e.uiState.rowSelection;if(t.mode===`include`)return Array.from(t.keys);let n=[],r=e.rowModel.getRowCount();for(let i=0;i<r;i+=1){if(!e.rowModel.getRow(i))continue;let r=e.rowModel.getRowKey(i)??i;t.keys.has(r)||n.push(r)}return n},getSelectedRowData:()=>{let e=p;if(!e)return[];let t=e.uiState.rowSelection,n=[],r=e.rowModel.getRowCount();for(let i=0;i<r;i+=1){let r=e.rowModel.getRow(i);r&&s.resolveIsRowSelected(t,e.rowModel.getRowKey(i)??i)&&n.push(r)}return n},getSelectedRowCount:()=>{let e=p;return e?s.countSelectedRows(e.uiState.rowSelection,e.leafRowCount):0},isRowSelected:e=>{let t=p;return t?s.resolveIsRowSelected(t.uiState.rowSelection,e):!1},selectAllRows:()=>{p?.commitRowSelection(s.selectAllRows())},clearRowSelection:()=>{p?.commitRowSelection(s.clearRowSelection())},undo:()=>{p?.undoRows()},redo:()=>{p?.redoRows()},canUndo:()=>p?.canUndoRows()??!1,canRedo:()=>p?.canRedoRows()??!1,clearUndoHistory:()=>{p?.clearUndoHistory()},setGroupCollapsed:(e,t)=>{p?.dispatch(n.gridActions.setGroupCollapsed(e,t))},expandAllGroups:()=>{p?.dispatch(n.gridActions.setCollapsedGroupKeys(new Set))},collapseAllGroups:()=>{let t=p;!t||!t.groupTree||t.dispatch(n.gridActions.setCollapsedGroupKeys(new Set(e.collectAllGroupKeys(t.groupTree))))},getGroupRows:()=>{let t=p;return t?.groupTree?e.collectAllGroupRows(t.groupTree):[]},setDetailRowExpanded:(e,r)=>{let i=p;if(!(!i||!i.detailRowEnabled)){if(r&&i.detailIsExpandable){let n=t.findDetailRowIndex(i.rowModel,e,i.detailIndexCacheRef.current,!i.isServerSide);if(n>=0){let t=i.rowModel.getRow(n);if(t!=null&&!i.detailIsExpandable(t,{rowKey:e,sourceRowIndex:i.rowModel.getSourceIndex(n)}))return}}i.dispatch(n.gridActions.setDetailRowExpanded(e,r))}},getExpandedDetailRowKeys:()=>{let e=p;return e&&e.detailRowEnabled?Array.from(e.uiState.expandedDetailRowKeys):[]},collapseAllDetailRows:()=>{let e=p;!e||!e.detailRowEnabled||e.dispatch(n.gridActions.setExpandedDetailRowKeys(new Set))},moveRow:(e,t)=>{p?.moveRowByKey(e,t)},getInvalidCells:()=>{let e=p;return e?e.isServerSide?(console.warn(`[SpreadsheetGrid] getInvalidCells は serverSide モードでは利用できません(空配列を返します)。`),[]):a.scanInvalidCells(e.rows,e.columns,e.resolvedRowKeyGetter):[]},refreshServerSide:()=>{let e=p;if(e){if(!e.isServerSide){console.warn(`[SpreadsheetGrid] refreshServerSide は clientSide(rows)モードでは何もしません(dataSource 指定時のみ有効です)。`);return}e.serverSideRefresh()}},openFilterManager:()=>{p?.openToolPanel(`filter`)},closeFilterManager:()=>{let e=p;e&&e.activeToolPanelTab===`filter`&&e.closeToolPanel()}},applyScroll:h,verticalTargetFor:g,horizontalTargetFor:_,scrollToCellInternal:v}};exports.createGridApi=p;

package/dist/engine/gridApi.d.ts

@@ -4,6 +4,7 @@ import { type GridPaneLayout } from '../logic/geometry';
 import { type RowMetrics } from '../logic/verticalGeometry';
 import { type DetailIndexCache } from '../logic/detailRow';
 import { type GroupTree } from '../logic/grouping';
+import { type LabelExportLine } from '../logic/exportCsv';
 import type { ToolPanelTab } from '../controllers/toolPanelController';
 type ReadonlyRef<V> = {
     readonly current: V;
@@ -34,6 +35,11 @@ export type GridApiArgs<T> = {
     serverSideRefresh: () => void;
     resolvedRowKeyGetter: (row: T, sourceRowIndex: number) => GridRowKey;
     isRowExportable: SpreadsheetGridProps<T>['isRowExportable'];
+    labelRowExport?: {
+        isLabelRow: (row: T, sourceIndex: number) => boolean;
+        getLabel: (row: T) => string;
+        exportText: ((row: T) => string | LabelExportLine) | undefined;
+    } | undefined;
     activeToolPanelTab: ToolPanelTab | null;
     openToolPanel: (tab: ToolPanelTab) => void;
     closeToolPanel: () => void;

package/dist/engine/gridApi.js

@@ -53,77 +53,94 @@ var D = () => {
 		});
 	}, M = (e, t, n) => {
 		k(A(e, n), j(t, n));
-	}, N = (e) => {
-		let t = D;
-		if (!t) return null;
-		let n = (e) => t.rowModel.getRow(e), r = t.isRowExportable, i = r ? (e, n) => r(e, {
-			viewRowIndex: n,
-			rowKey: t.rowModel.getRowKey(n) ?? n
-		}) : void 0, a = r ? (e, n) => r(e, {
-			viewRowIndex: n,
-			rowKey: t.resolvedRowKeyGetter(e, n)
-		}) : void 0, l = E(e);
-		if (l === "raw") return t.isServerSide ? (console.warn("SpreadsheetGrid: scope 'raw' は serverSide では未ロード行を取得できないため、'view'(ロード済みビュー行)として扱います。全件エクスポートはサーバ側での実施を推奨します。"), {
-			getRow: n,
-			startRow: 0,
-			endRow: t.viewRowCount,
-			columns: t.orderedColumns,
-			isRowIncluded: i
-		}) : {
-			getRow: (e) => t.rows[e],
-			startRow: 0,
-			endRow: t.rows.length,
-			columns: t.orderedColumns,
-			isRowIncluded: a
-		};
-		if (l === "rendered") return {
-			getRow: n,
-			startRow: t.windowFirstRow,
-			endRow: t.windowLastRow >= t.windowFirstRow ? t.windowLastRow + 1 : t.windowFirstRow,
-			columns: t.orderedColumns,
-			isRowIncluded: i
+	}, N = (e, t = !1) => {
+		let n = D;
+		if (!n) return null;
+		let r = (e) => n.rowModel.getRow(e), i = n.labelRowExport, a = (e) => {
+			if (!i) return [];
+			let t = i.exportText ? i.exportText(e) : i.getLabel(e);
+			return typeof t == "string" ? [t] : t;
+		}, l = t && i && n.rowModel.getLabelRow ? (e) => {
+			let t = n.rowModel.getLabelRow?.(e);
+			return t ? a(t.row) : void 0;
+		} : void 0, u = n.isRowExportable, d = u ? (e, t) => u(e, {
+			viewRowIndex: t,
+			rowKey: n.rowModel.getRowKey(t) ?? t
+		}) : void 0, f = u ? (e, t) => u(e, {
+			viewRowIndex: t,
+			rowKey: n.resolvedRowKeyGetter(e, t)
+		}) : void 0, p = E(e);
+		if (p === "raw") {
+			if (n.isServerSide) return console.warn("SpreadsheetGrid: scope 'raw' は serverSide では未ロード行を取得できないため、'view'(ロード済みビュー行)として扱います。全件エクスポートはサーバ側での実施を推奨します。"), {
+				getRow: r,
+				startRow: 0,
+				endRow: n.viewRowCount,
+				columns: n.orderedColumns,
+				isRowIncluded: d
+			};
+			let e = (e) => i !== void 0 && n.rows[e] !== void 0 && i.isLabelRow(n.rows[e], e);
+			return {
+				getRow: (t) => e(t) ? void 0 : n.rows[t],
+				startRow: 0,
+				endRow: n.rows.length,
+				columns: n.orderedColumns,
+				isRowIncluded: f,
+				getLabelLine: t && i ? (t) => e(t) ? a(n.rows[t]) : void 0 : void 0
+			};
+		}
+		if (p === "rendered") return {
+			getRow: r,
+			startRow: n.windowFirstRow,
+			endRow: n.windowLastRow >= n.windowFirstRow ? n.windowLastRow + 1 : n.windowFirstRow,
+			columns: n.orderedColumns,
+			isRowIncluded: d,
+			getLabelLine: l
 		};
-		if (l === "selection") {
-			let e = t.uiState.selection;
+		if (p === "selection") {
+			let e = n.uiState.selection;
 			if (!e) return null;
 			if (e.type === "cell") {
-				let r = o(e.range);
+				let t = o(e.range);
 				return {
-					getRow: n,
-					startRow: r.start.row,
-					endRow: r.end.row + 1,
-					columns: t.orderedColumns.slice(r.start.col, r.end.col + 1),
-					isRowIncluded: i
+					getRow: r,
+					startRow: t.start.row,
+					endRow: t.end.row + 1,
+					columns: n.orderedColumns.slice(t.start.col, t.end.col + 1),
+					isRowIncluded: d,
+					getLabelLine: l
 				};
 			}
 			if (e.type === "row") {
-				let r = c(e.startRow, e.endRow);
+				let t = c(e.startRow, e.endRow);
 				return {
-					getRow: n,
-					startRow: r.startRow,
-					endRow: r.endRow + 1,
-					columns: t.orderedColumns,
-					isRowIncluded: i
+					getRow: r,
+					startRow: t.startRow,
+					endRow: t.endRow + 1,
+					columns: n.orderedColumns,
+					isRowIncluded: d,
+					getLabelLine: l
 				};
 			}
-			let r = s(e.startCol, e.endCol);
+			let t = s(e.startCol, e.endCol);
 			return {
-				getRow: n,
+				getRow: r,
 				startRow: 0,
-				endRow: t.viewRowCount,
-				columns: t.orderedColumns.slice(r.startCol, r.endCol + 1),
-				isRowIncluded: i
+				endRow: n.viewRowCount,
+				columns: n.orderedColumns.slice(t.startCol, t.endCol + 1),
+				isRowIncluded: d,
+				getLabelLine: l
 			};
 		}
 		return {
-			getRow: n,
+			getRow: r,
 			startRow: 0,
-			endRow: t.viewRowCount,
-			columns: t.orderedColumns,
-			isRowIncluded: i
+			endRow: n.viewRowCount,
+			columns: n.orderedColumns,
+			isRowIncluded: d,
+			getLabelLine: l
 		};
 	}, P = (e) => e.filter((e) => !r(e.key)), F = (e) => {
-		let t = N(e?.scope ?? "view");
+		let t = N(e?.scope ?? "view", e?.includeLabelRows === !0);
 		return t ? w({
 			getRow: t.getRow,
 			startRow: t.startRow,
@@ -132,16 +149,18 @@ var D = () => {
 			delimiter: e?.delimiter,
 			includeHeaders: e?.includeHeaders,
 			bom: e?.bom,
-			isRowIncluded: t.isRowIncluded
+			isRowIncluded: t.isRowIncluded,
+			getLabelLine: t.getLabelLine
 		}) : e?.bom ? "" : "";
 	}, I = (e) => {
-		let t = N(e?.scope ?? "view");
+		let t = N(e?.scope ?? "view", e?.includeLabelRows === !0);
 		return t ? T({
 			getRow: t.getRow,
 			startRow: t.startRow,
 			endRow: t.endRow,
 			columns: P(t.columns),
-			isRowIncluded: t.isRowIncluded
+			isRowIncluded: t.isRowIncluded,
+			getLabelLine: t.getLabelLine
 		}) : {
 			columns: [],
 			rows: []

package/dist/engine/notifiers.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/gridState.cjs");var t=()=>{let e=null,t=null;return{update:t=>{e=t},applyHoveredRowChange:n=>{if(e===null||!e.enableRowHover)return;let r=t,i=typeof n==`function`?n(r):n;i!==r&&(t=i,e.isHoverControlled||e.setHoveredRowIndex(i),e.onHoveredRowChange?.(i,{source:`pointer`}))}}},n=()=>{let e=null;return{update:({expandedKeys:t,onChange:n})=>{if(e===null){e=t;return}Object.is(e,t)||(e=t,n?.(Array.from(t)))}}},r=()=>{let t=null,n=null,r=(e,t)=>Object.is(e.columnWidths,t.columnWidths)&&Object.is(e.filters,t.filters)&&Object.is(e.sort,t.sort)&&Object.is(e.dragState,t.dragState)&&Object.is(e.columns,t.columns);return{update:i=>{let a=t===null||!r(t,i);if(t=i,!a||!i.onStateChange)return;let o=e.buildGridState(i.columnWidths,i.filters,i.sort,e.extractColumnState(i.columns)),s=e.decideStateChangeEmit(n,o,i.dragState!==null);n=s.nextLast,s.emit&&i.onStateChange(o)}}};exports.createDetailKeysNotifier=n,exports.createHoverRowNotifier=t,exports.createStateChangeNotifier=r;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/gridState.cjs");var t=()=>{let e=null,t=null;return{update:t=>{e=t},applyHoveredRowChange:n=>{if(e===null||!e.enableRowHover)return;let r=t,i=typeof n==`function`?n(r):n;i!==r&&(t=i,e.isHoverControlled||e.setHoveredRowIndex(i),e.onHoveredRowChange?.(i,{source:`pointer`}))}}},n=()=>{let e=null;return{update:({expandedKeys:t,onChange:n})=>{if(e===null){e=t;return}Object.is(e,t)||(e=t,n?.(Array.from(t)))}}},r=()=>{let t=null,n=null,r=(e,t)=>Object.is(e.columnWidths,t.columnWidths)&&Object.is(e.filters,t.filters)&&Object.is(e.sort,t.sort)&&Object.is(e.dragState,t.dragState)&&Object.is(e.columns,t.columns);return{update:i=>{let a=t,o=a===null||!r(a,i);if(t=i,!o||(a!==null&&(i.onFiltersChange&&!Object.is(a.filters,i.filters)&&!e.isSameFilterState(a.filters,i.filters)&&i.onFiltersChange(e.cloneFilterState(i.filters)),i.onSortChange&&!Object.is(a.sort,i.sort)&&!e.isSameSortState(a.sort,i.sort)&&i.onSortChange(e.cloneSortState(i.sort))),!i.onStateChange))return;let s=e.buildGridState(i.columnWidths,i.filters,i.sort,e.extractColumnState(i.columns)),c=e.decideStateChangeEmit(n,s,i.dragState!==null);n=c.nextLast,c.emit&&i.onStateChange(s)}}};exports.createDetailKeysNotifier=n,exports.createHoverRowNotifier=t,exports.createStateChangeNotifier=r;

package/dist/engine/notifiers.d.ts

@@ -1,4 +1,4 @@
-import type { GridColumn, GridRowKey, GridSortState, GridState, GridUiState } from '../model/gridTypes.unbound';
+import type { GridColumn, GridFilterState, GridRowKey, GridSortState, GridState, GridUiState } from '../model/gridTypes.unbound';
 export type HoverRowNotifierArgs = {
     enableRowHover: boolean;
     isHoverControlled: boolean;
@@ -28,6 +28,8 @@ export type StateChangeNotifierArgs<T> = {
     dragState: GridUiState['dragState'];
     columns: GridColumn<T>[];
     onStateChange: ((state: GridState) => void) | undefined;
+    onFiltersChange?: ((filters: GridFilterState) => void) | undefined;
+    onSortChange?: ((sort: GridSortState) => void) | undefined;
 };
 export type StateChangeNotifier<T> = {
     update: (args: StateChangeNotifierArgs<T>) => void;

package/dist/engine/notifiers.js

@@ -1,6 +1,6 @@
-import { buildGridState as e, decideStateChangeEmit as t, extractColumnState as n } from "../logic/gridState.js";
+import { buildGridState as e, cloneFilterState as t, cloneSortState as n, decideStateChangeEmit as r, extractColumnState as i, isSameFilterState as a, isSameSortState as o } from "../logic/gridState.js";
 //#region src/engine/notifiers.ts
-var r = () => {
+var s = () => {
 	let e = null, t = null;
 	return {
 		update: (t) => {
@@ -12,7 +12,7 @@ var r = () => {
 			i !== r && (t = i, e.isHoverControlled || e.setHoveredRowIndex(i), e.onHoveredRowChange?.(i, { source: "pointer" }));
 		}
 	};
-}, i = () => {
+}, c = () => {
 	let e = null;
 	return { update: ({ expandedKeys: t, onChange: n }) => {
 		if (e === null) {
@@ -21,14 +21,14 @@ var r = () => {
 		}
 		Object.is(e, t) || (e = t, n?.(Array.from(t)));
 	} };
-}, a = () => {
-	let r = null, i = null, a = (e, t) => Object.is(e.columnWidths, t.columnWidths) && Object.is(e.filters, t.filters) && Object.is(e.sort, t.sort) && Object.is(e.dragState, t.dragState) && Object.is(e.columns, t.columns);
-	return { update: (o) => {
-		let s = r === null || !a(r, o);
-		if (r = o, !s || !o.onStateChange) return;
-		let c = e(o.columnWidths, o.filters, o.sort, n(o.columns)), l = t(i, c, o.dragState !== null);
-		i = l.nextLast, l.emit && o.onStateChange(c);
+}, l = () => {
+	let s = null, c = null, l = (e, t) => Object.is(e.columnWidths, t.columnWidths) && Object.is(e.filters, t.filters) && Object.is(e.sort, t.sort) && Object.is(e.dragState, t.dragState) && Object.is(e.columns, t.columns);
+	return { update: (u) => {
+		let d = s, f = d === null || !l(d, u);
+		if (s = u, !f || (d !== null && (u.onFiltersChange && !Object.is(d.filters, u.filters) && !a(d.filters, u.filters) && u.onFiltersChange(t(u.filters)), u.onSortChange && !Object.is(d.sort, u.sort) && !o(d.sort, u.sort) && u.onSortChange(n(u.sort))), !u.onStateChange)) return;
+		let p = e(u.columnWidths, u.filters, u.sort, i(u.columns)), m = r(c, p, u.dragState !== null);
+		c = m.nextLast, m.emit && u.onStateChange(p);
 	} };
 };
 //#endregion
-export { i as createDetailKeysNotifier, r as createHoverRowNotifier, a as createStateChangeNotifier };
+export { c as createDetailKeysNotifier, s as createHoverRowNotifier, l as createStateChangeNotifier };

package/dist/engine/rowPipeline.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../utils/permissions.cjs"),t=require("../logic/grouping.cjs"),n=require("../logic/rowReorder.cjs"),r=require("../logic/filtering.cjs"),i=require("../logic/sorting.cjs"),a=require("./memo.cjs"),o=require("../logic/serverSideQuery.cjs");var s={},c={},l=[],u=`\0`,d=()=>{let d=a.createMemo(e=>r.createSourceOrder(e)),f=a.createMemo((e,t)=>{let n=[];for(let i of e)r.columnFilterUsesNumericKey(t[i.key])&&n.push(i.key);return n.join(u)}),p=a.createMemo((t,n,i)=>{let a=new Map;if(i.length===0)return a;let o=new Set(i.split(u)),s=t.length;for(let i of n){if(!o.has(i.key))continue;let n=new Float64Array(s);for(let a=0;a<s;a+=1)n[a]=r.coerceNumberFilterCellValue(e.getCellValue(t[a],i));a.set(i.key,n)}return a}),m=a.createMemo((e,t,n,i,a)=>r.filterOrderByColumns(e,t,n,i,a)),h=a.createMemo((e,t,n,r)=>i.sortOrder(e,t,n,r)),g=a.createMemo((e,t,r)=>e&&n.isIdentityOrder(t,r)),_=a.createMemo((e,n,r,i,a)=>e?t.buildGroupTree(n,r,i,a):null),v=a.createMemo((e,n)=>e?t.flattenGroupTree(e,n):null),y=a.createMemo((e,n,r,i)=>{if(e){let{displayOrder:n,groups:a}=e;return{getRowCount:()=>n.length,getRow:e=>r[n[e]],getSourceIndex:e=>{let t=n[e];return t>=0?t:void 0},getRowKey:e=>{let o=n[e];return t.isGroupOrderValue(o)?t.groupRowKey(a[t.groupIndexOfOrderValue(o)]):i(r[o],o)},getGroupRow:e=>{let r=n[e];return t.isGroupOrderValue(r)?a[t.groupIndexOfOrderValue(r)]:void 0}}}return{getRowCount:()=>n.length,getRow:e=>r[n[e]],getSourceIndex:e=>n[e],getRowKey:e=>i(r[n[e]],n[e])}}),b=a.createMemo((e,t,n,r,i,a,u)=>e?o.buildServerSideQuery({globalText:t?n:``,columnFilters:r?i:c,sort:a?u:l}):s),x=a.createMemo((e,t)=>e?o.serializeServerSideQuery(t):``),S=a.createMemo((e,t)=>({query:e,queryKey:t}));return{resolveBaseOrder:e=>d(e),resolveOrder:e=>{let{rows:t,visibleColumns:r,columnFilters:i,globalFilteredOrder:a,sort:o,rowDragAvailable:s}=e,c=f(r,i),l=p(t,r,c),u=m(t,a,r,i,l),d=h(t,u,r,o),_=g(s,d,t.length);return{order:d,orderIsIdentity:_,rowDragOperable:n.isRowDragOperable(s,_)}},resolveClientSideRowModel:e=>{let{rows:t,order:n,rowGroupingActive:r,groupColumns:i,aggColumns:a,collapsedGroupKeys:o,rowKeyGetter:s}=e,c=_(r,t,n,i,a),l=v(c,o);return{groupTree:c,groupedDisplay:l,rowModel:y(l,n,t,s)}},resolveServerSideQuery:e=>{let{isServerSide:t,globalFilterEnabled:n,globalText:r,columnFilterEnabled:i,columnFilters:a,sortingEnabled:o,sort:s}=e,c=b(t,n,r,i,a,o,s);return S(c,x(t,c))}}};exports.createRowPipelineResolver=d;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../utils/permissions.cjs"),t=require("../logic/sorting.cjs"),n=require("../logic/grouping.cjs"),r=require("../logic/rowReorder.cjs"),i=require("../logic/labelRows.cjs"),a=require("../logic/filtering.cjs"),o=require("./memo.cjs"),s=require("../logic/serverSideQuery.cjs");var c={},l={},u=[],d=`\0`,f=()=>{let f=o.createMemo(e=>a.createSourceOrder(e)),p=o.createMemo((e,t)=>t?i.resolveLabelRowLayout(e,t):null),m=o.createMemo((e,t)=>i.createLabelFreeOrder(e,t)),h=o.createMemo((e,t)=>{let n=[];for(let r of e)a.columnFilterUsesNumericKey(t[r.key])&&n.push(r.key);return n.join(d)}),g=o.createMemo((t,n,r)=>{let i=new Map;if(r.length===0)return i;let o=new Set(r.split(d)),s=t.length;for(let r of n){if(!o.has(r.key))continue;let n=new Float64Array(s);for(let i=0;i<s;i+=1)n[i]=a.coerceNumberFilterCellValue(e.getCellValue(t[i],r));i.set(r.key,n)}return i}),_=o.createMemo((e,t,n,r,i)=>a.filterOrderByColumns(e,t,n,r,i)),v=o.createMemo((e,n,r,i)=>t.sortOrder(e,n,r,i)),y=o.createMemo((e,t,n)=>e&&r.isIdentityOrder(t,n)),b=o.createMemo((e,t,n)=>e&&i.isSameOrder(t,n)),x=o.createMemo((e,t,r,i,a)=>e?n.buildGroupTree(t,r,i,a):null),S=o.createMemo((e,t)=>e?n.flattenGroupTree(e,t):null),C=o.createMemo((e,t,n,r,a,o,s)=>e&&s?i.buildLabelDisplay({rows:t,order:n,layout:e,sortMode:r,keepEmptySections:a,sortActive:o,getLabel:s}):null),w=o.createMemo((e,t,r,a,o)=>{if(t)return i.createLabelRowModel(t,a,o);if(e){let{displayOrder:t,groups:r}=e;return{getRowCount:()=>t.length,getRow:e=>a[t[e]],getSourceIndex:e=>{let n=t[e];return n>=0?n:void 0},getRowKey:e=>{let i=t[e];return n.isGroupOrderValue(i)?n.groupRowKey(r[n.groupIndexOfOrderValue(i)]):o(a[i],i)},getGroupRow:e=>{let i=t[e];return n.isGroupOrderValue(i)?r[n.groupIndexOfOrderValue(i)]:void 0}}}return{getRowCount:()=>r.length,getRow:e=>a[r[e]],getSourceIndex:e=>r[e],getRowKey:e=>o(a[r[e]],r[e])}}),T=o.createMemo((e,t,n,r,i,a,o)=>e?s.buildServerSideQuery({globalText:t?n:``,columnFilters:r?i:l,sort:a?o:u}):c),E=o.createMemo((e,t)=>e?s.serializeServerSideQuery(t):``),D=o.createMemo((e,t)=>({query:e,queryKey:t}));return{resolveLabelRowLayout:(e,t)=>p(e,t),resolveBaseOrder:(e,t)=>t?m(t,e):f(e),resolveOrder:e=>{let{rows:t,visibleColumns:n,globalFilteredOrder:i,rowDragAvailable:a,labelLayout:o}=e,s=e.manualFiltering?l:e.columnFilters,c=e.manualSorting?u:e.sort,d=h(n,s),f=g(t,n,d),p=_(t,i,n,s,f),x=v(t,p,n,c),S=o?b(a,x,m(o,t.length)):y(a,x,t.length);return{order:x,orderIsIdentity:S,rowDragOperable:r.isRowDragOperable(a,S)}},resolveClientSideRowModel:e=>{let{rows:t,order:n,rowGroupingActive:r,groupColumns:i,aggColumns:a,collapsedGroupKeys:o,rowKeyGetter:s,labelLayout:c,labelSortMode:l=`section`,keepEmptySections:u=!1,sortActive:d=!1,getLabel:f}=e,p=x(r,t,n,i,a),m=S(p,o),h=C(r?null:c??null,t,n,l,u,d,f);return{groupTree:p,groupedDisplay:m,labelDisplay:h,rowModel:w(m,h,n,t,s)}},resolveServerSideQuery:e=>{let{isServerSide:t,globalFilterEnabled:n,globalText:r,columnFilterEnabled:i,columnFilters:a,sortingEnabled:o,sort:s}=e,c=T(t,n,r,i,a,o,s);return D(c,E(t,c))}}};exports.createRowPipelineResolver=f;

package/dist/engine/rowPipeline.d.ts

@@ -1,13 +1,17 @@
-import type { ColumnFilterValue, GridColumn, GridRowKey, GridSortState, RowModel, ServerSideQuery } from '../model/gridTypes.unbound';
+import type { ColumnFilterValue, GridColumn, GridRowKey, GridSortState, LabelRowSortMode, RowModel, ServerSideQuery } from '../model/gridTypes.unbound';
 import { type RowOrder } from '../logic/filtering';
 import { type GroupTree, type GroupedDisplay } from '../logic/grouping';
+import { type LabelDisplay, type LabelRowLayout } from '../logic/labelRows';
 export type RowOrderInputs<T> = {
     rows: T[];
+    labelLayout?: LabelRowLayout | null;
     visibleColumns: GridColumn<T>[];
     columnFilters: Record<string, ColumnFilterValue>;
     globalFilteredOrder: RowOrder;
     sort: GridSortState;
     rowDragAvailable: boolean;
+    manualFiltering?: boolean;
+    manualSorting?: boolean;
 };
 export type RowOrderResolution = {
     order: RowOrder;
@@ -18,6 +22,11 @@ export type ClientSideRowModelInputs<T> = {
     rows: T[];
     order: RowOrder;
     rowGroupingActive: boolean;
+    labelLayout?: LabelRowLayout | null;
+    labelSortMode?: LabelRowSortMode;
+    keepEmptySections?: boolean;
+    sortActive?: boolean;
+    getLabel?: (row: T) => string;
     groupColumns: GridColumn<T>[];
     aggColumns: GridColumn<T>[];
     collapsedGroupKeys: ReadonlySet<string>;
@@ -26,6 +35,7 @@ export type ClientSideRowModelInputs<T> = {
 export type ClientSideRowModelResolution<T> = {
     groupTree: GroupTree<T> | null;
     groupedDisplay: GroupedDisplay | null;
+    labelDisplay: LabelDisplay<T> | null;
     rowModel: RowModel<T>;
 };
 export type ServerSideQueryInputs = {
@@ -42,7 +52,8 @@ export type ServerSideQueryResolution = {
     queryKey: string;
 };
 export declare const createRowPipelineResolver: <T>() => {
-    resolveBaseOrder: (rowCount: number) => RowOrder;
+    resolveLabelRowLayout: (rows: T[], isLabelRow: ((row: T, sourceIndex: number) => boolean) | undefined) => LabelRowLayout | null;
+    resolveBaseOrder: (rowCount: number, labelLayout?: LabelRowLayout | null) => RowOrder;
     resolveOrder: (inputs: RowOrderInputs<T>) => RowOrderResolution;
     resolveClientSideRowModel: (inputs: ClientSideRowModelInputs<T>) => ClientSideRowModelResolution<T>;
     resolveServerSideQuery: (inputs: ServerSideQueryInputs) => ServerSideQueryResolution;

package/dist/engine/rowPipeline.js

@@ -1,84 +1,96 @@
 import { getCellValue as e } from "../utils/permissions.js";
-import { buildGroupTree as t, flattenGroupTree as n, groupIndexOfOrderValue as r, groupRowKey as i, isGroupOrderValue as a } from "../logic/grouping.js";
-import { isIdentityOrder as o, isRowDragOperable as s } from "../logic/rowReorder.js";
-import { coerceNumberFilterCellValue as c, columnFilterUsesNumericKey as l, createSourceOrder as u, filterOrderByColumns as d } from "../logic/filtering.js";
-import { sortOrder as f } from "../logic/sorting.js";
-import { createMemo as p } from "./memo.js";
-import { buildServerSideQuery as m, serializeServerSideQuery as h } from "../logic/serverSideQuery.js";
+import { sortOrder as t } from "../logic/sorting.js";
+import { buildGroupTree as n, flattenGroupTree as r, groupIndexOfOrderValue as i, groupRowKey as a, isGroupOrderValue as o } from "../logic/grouping.js";
+import { isIdentityOrder as s, isRowDragOperable as c } from "../logic/rowReorder.js";
+import { buildLabelDisplay as l, createLabelFreeOrder as u, createLabelRowModel as d, isSameOrder as f, resolveLabelRowLayout as p } from "../logic/labelRows.js";
+import { coerceNumberFilterCellValue as m, columnFilterUsesNumericKey as h, createSourceOrder as g, filterOrderByColumns as _ } from "../logic/filtering.js";
+import { createMemo as v } from "./memo.js";
+import { buildServerSideQuery as y, serializeServerSideQuery as b } from "../logic/serverSideQuery.js";
 //#region src/engine/rowPipeline.ts
-var g = {}, _ = {}, v = [], y = "\0", b = () => {
-	let b = p((e) => u(e)), x = p((e, t) => {
+var x = {}, S = {}, C = [], w = "\0", T = () => {
+	let T = v((e) => g(e)), E = v((e, t) => t ? p(e, t) : null), D = v((e, t) => u(e, t)), O = v((e, t) => {
 		let n = [];
-		for (let r of e) l(t[r.key]) && n.push(r.key);
-		return n.join(y);
-	}), S = p((t, n, r) => {
+		for (let r of e) h(t[r.key]) && n.push(r.key);
+		return n.join(w);
+	}), k = v((t, n, r) => {
 		let i = /* @__PURE__ */ new Map();
 		if (r.length === 0) return i;
-		let a = new Set(r.split(y)), o = t.length;
+		let a = new Set(r.split(w)), o = t.length;
 		for (let r of n) {
 			if (!a.has(r.key)) continue;
 			let n = new Float64Array(o);
-			for (let i = 0; i < o; i += 1) n[i] = c(e(t[i], r));
+			for (let i = 0; i < o; i += 1) n[i] = m(e(t[i], r));
 			i.set(r.key, n);
 		}
 		return i;
-	}), C = p((e, t, n, r, i) => d(e, t, n, r, i)), w = p((e, t, n, r) => f(e, t, n, r)), T = p((e, t, n) => e && o(t, n)), E = p((e, n, r, i, a) => e ? t(n, r, i, a) : null), D = p((e, t) => e ? n(e, t) : null), O = p((e, t, n, o) => {
+	}), A = v((e, t, n, r, i) => _(e, t, n, r, i)), j = v((e, n, r, i) => t(e, n, r, i)), M = v((e, t, n) => e && s(t, n)), N = v((e, t, n) => e && f(t, n)), P = v((e, t, r, i, a) => e ? n(t, r, i, a) : null), F = v((e, t) => e ? r(e, t) : null), I = v((e, t, n, r, i, a, o) => e && o ? l({
+		rows: t,
+		order: n,
+		layout: e,
+		sortMode: r,
+		keepEmptySections: i,
+		sortActive: a,
+		getLabel: o
+	}) : null), L = v((e, t, n, r, s) => {
+		if (t) return d(t, r, s);
 		if (e) {
-			let { displayOrder: t, groups: s } = e;
+			let { displayOrder: t, groups: n } = e;
 			return {
 				getRowCount: () => t.length,
-				getRow: (e) => n[t[e]],
+				getRow: (e) => r[t[e]],
 				getSourceIndex: (e) => {
 					let n = t[e];
 					return n >= 0 ? n : void 0;
 				},
 				getRowKey: (e) => {
 					let c = t[e];
-					return a(c) ? i(s[r(c)]) : o(n[c], c);
+					return o(c) ? a(n[i(c)]) : s(r[c], c);
 				},
 				getGroupRow: (e) => {
-					let n = t[e];
-					return a(n) ? s[r(n)] : void 0;
+					let r = t[e];
+					return o(r) ? n[i(r)] : void 0;
 				}
 			};
 		}
 		return {
-			getRowCount: () => t.length,
-			getRow: (e) => n[t[e]],
-			getSourceIndex: (e) => t[e],
-			getRowKey: (e) => o(n[t[e]], t[e])
+			getRowCount: () => n.length,
+			getRow: (e) => r[n[e]],
+			getSourceIndex: (e) => n[e],
+			getRowKey: (e) => s(r[n[e]], n[e])
 		};
-	}), k = p((e, t, n, r, i, a, o) => e ? m({
+	}), R = v((e, t, n, r, i, a, o) => e ? y({
 		globalText: t ? n : "",
-		columnFilters: r ? i : _,
-		sort: a ? o : v
-	}) : g), A = p((e, t) => e ? h(t) : ""), j = p((e, t) => ({
+		columnFilters: r ? i : S,
+		sort: a ? o : C
+	}) : x), z = v((e, t) => e ? b(t) : ""), B = v((e, t) => ({
 		query: e,
 		queryKey: t
 	}));
 	return {
-		resolveBaseOrder: (e) => b(e),
+		resolveLabelRowLayout: (e, t) => E(e, t),
+		resolveBaseOrder: (e, t) => t ? D(t, e) : T(e),
 		resolveOrder: (e) => {
-			let { rows: t, visibleColumns: n, columnFilters: r, globalFilteredOrder: i, sort: a, rowDragAvailable: o } = e, c = x(n, r), l = S(t, n, c), u = C(t, i, n, r, l), d = w(t, u, n, a), f = T(o, d, t.length);
+			let { rows: t, visibleColumns: n, globalFilteredOrder: r, rowDragAvailable: i, labelLayout: a } = e, o = e.manualFiltering ? S : e.columnFilters, s = e.manualSorting ? C : e.sort, l = O(n, o), u = k(t, n, l), d = A(t, r, n, o, u), f = j(t, d, n, s), p = a ? N(i, f, D(a, t.length)) : M(i, f, t.length);
 			return {
-				order: d,
-				orderIsIdentity: f,
-				rowDragOperable: s(o, f)
+				order: f,
+				orderIsIdentity: p,
+				rowDragOperable: c(i, p)
 			};
 		},
 		resolveClientSideRowModel: (e) => {
-			let { rows: t, order: n, rowGroupingActive: r, groupColumns: i, aggColumns: a, collapsedGroupKeys: o, rowKeyGetter: s } = e, c = E(r, t, n, i, a), l = D(c, o);
+			let { rows: t, order: n, rowGroupingActive: r, groupColumns: i, aggColumns: a, collapsedGroupKeys: o, rowKeyGetter: s, labelLayout: c, labelSortMode: l = "section", keepEmptySections: u = !1, sortActive: d = !1, getLabel: f } = e, p = P(r, t, n, i, a), m = F(p, o), h = I(r ? null : c ?? null, t, n, l, u, d, f);
 			return {
-				groupTree: c,
-				groupedDisplay: l,
-				rowModel: O(l, n, t, s)
+				groupTree: p,
+				groupedDisplay: m,
+				labelDisplay: h,
+				rowModel: L(m, h, n, t, s)
 			};
 		},
 		resolveServerSideQuery: (e) => {
-			let { isServerSide: t, globalFilterEnabled: n, globalText: r, columnFilterEnabled: i, columnFilters: a, sortingEnabled: o, sort: s } = e, c = k(t, n, r, i, a, o, s);
-			return j(c, A(t, c));
+			let { isServerSide: t, globalFilterEnabled: n, globalText: r, columnFilterEnabled: i, columnFilters: a, sortingEnabled: o, sort: s } = e, c = R(t, n, r, i, a, o, s);
+			return B(c, z(t, c));
 		}
 	};
 };
 //#endregion
-export { b as createRowPipelineResolver };
+export { T as createRowPipelineResolver };

package/dist/engine/verticalLayout.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/rowHeightStore.cjs"),t=require("../logic/detailRow.cjs"),n=require("../logic/verticalGeometry.cjs"),r=require("./memo.cjs");var i=[],a=[],o=20,s=()=>{let s=r.createMemo(e=>e.some(e=>e.autoHeight===!0)),c=r.createMemo((t,n,r,i,a)=>t?e.buildRowHeightStore(n,r,i.getRowKey,a):null),l=r.createMemo((t,r,i,a,o)=>t&&r?e.createAutoHeightRowMetrics(r):n.createUniformRowMetrics(a,o)),u=r.createMemo((e,n,r,a,o,s,c)=>e?t.resolveDetailRowExtras({expandedKeys:n,rowModel:r,height:a,isExpandable:o,cache:s.current,allowScan:!c}):i),d=r.createMemo((e,t,r)=>e?n.createDetailRowMetrics(t,r):t),f=r.createMemo((e,t,r,i,a,s,c)=>e?n.computeAutoHeightVerticalGeometry({headerHeight:a,viewportHeight:s,scrollTop:c,overscan:o},t):n.computeVerticalGeometry({rowCount:r,rowHeight:i,headerHeight:a,viewportHeight:s,scrollTop:c,overscan:o,maxBodyPx:n.MAX_BODY_PX})),p=r.createMemo((e,t,n)=>{if(!e)return a;let r=[];for(let e of t)e.detailSize!==void 0&&e.detailSize>0&&r.push({rowKey:n.getRowKey(e.index)??e.index,virtualRow:e});return r});return e=>{let{isServerSide:t,autoHeight:r,visibleColumns:i,viewRowCount:a,estimateRowHeight:o,rowHeight:m,headerHeight:h,viewportHeight:g,scrollTop:_,rowModel:v,measuredHeights:y,autoHeightVersion:b,detailRowEnabled:x,expandedDetailRowKeys:S,detailHeight:C,detailIsExpandable:w,detailIndexCacheRef:T}=e,E=s(i),D=!t&&n.shouldUseAutoHeight(r,E,a,5e4),O=c(D,a,o,v,y),k=l(D,O,b,a,m),A=u(x,S,v,C,w,T,t),j=A.length>0&&k.totalBodyHeight+A.reduce((e,t)=>e+t.height,0)<=15e6,M=d(j,k,A),N=f(D||j,M,a,m,h,g,_),P=N.rows,F=p(j,P,v);return{hasAutoHeightColumn:E,autoHeightActive:D,rowHeightStore:O,baseRowMetrics:k,detailExtras:A,detailActive:j,rowMetrics:M,verticalGeometry:N,virtualRows:P,virtualRowIndexes:N.rowIndexSet,detailEntries:F,windowFirstRow:P.length>0?P[0].index:0,windowLastRow:P.length>0?P[P.length-1].index:-1,physicalBodyHeight:N.physicalBodyHeight,bodyLayerTransform:N.translateY===0?void 0:`translateY(${N.translateY}px)`,verticalScaleFactor:N.scaleFactor,overlayBaseOffset:N.windowBaseOffsetPx}}};exports.createVerticalLayoutResolver=s;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/rowHeightStore.cjs"),t=require("../logic/detailRow.cjs"),n=require("../logic/verticalGeometry.cjs"),r=require("./memo.cjs");var i=[],a=[],o=[],s=20,c=()=>{let c=r.createMemo(e=>e.some(e=>e.autoHeight===!0)),l=r.createMemo((t,n,r,i,a)=>t?e.buildRowHeightStore(n,r,i.getRowKey,a):null),u=r.createMemo((t,r,i,a,o)=>t&&r?e.createAutoHeightRowMetrics(r):n.createUniformRowMetrics(a,o)),d=r.createMemo((e,n,r,a,o,s,c)=>e?t.resolveDetailRowExtras({expandedKeys:n,rowModel:r,height:a,isExpandable:o,cache:s.current,allowScan:!c}):i),f=r.createMemo((e,t)=>{if(!e||t===void 0||e.labels.length===0)return a;let n=[];for(let r=0;r<e.labels.length;r+=1){let i=e.labels[r];n.push({index:e.labelViewIndexes[r],height:typeof t==`function`?t(i.row):t})}return n}),p=r.createMemo((e,t)=>t.length>0?n.createRowHeightOverrideMetrics(e,t):e),m=r.createMemo((e,t,r)=>e?n.createDetailRowMetrics(t,r):t),h=r.createMemo((e,t,r,i,a,o,c)=>e?n.computeAutoHeightVerticalGeometry({headerHeight:a,viewportHeight:o,scrollTop:c,overscan:s},t):n.computeVerticalGeometry({rowCount:r,rowHeight:i,headerHeight:a,viewportHeight:o,scrollTop:c,overscan:s,maxBodyPx:n.MAX_BODY_PX})),g=r.createMemo((e,t,n)=>{if(!e)return o;let r=[];for(let e of t)e.detailSize!==void 0&&e.detailSize>0&&r.push({rowKey:n.getRowKey(e.index)??e.index,virtualRow:e});return r});return e=>{let{isServerSide:t,autoHeight:r,visibleColumns:i,viewRowCount:a,estimateRowHeight:o,rowHeight:s,headerHeight:_,viewportHeight:v,scrollTop:y,rowModel:b,measuredHeights:x,autoHeightVersion:S,detailRowEnabled:C,expandedDetailRowKeys:w,detailHeight:T,detailIsExpandable:E,detailIndexCacheRef:D,labelDisplay:O,labelRowHeight:k}=e,A=c(i),j=!t&&n.shouldUseAutoHeight(r,A,a,5e4),M=l(j,a,o,b,x),N=u(j,M,S,a,s),P=d(C,w,b,T,E,D,t),F=f(t?null:O,k),I=p(N,F),L=I!==N&&I.totalBodyHeight<=15e6,R=L?I:N,z=P.length>0&&R.totalBodyHeight+P.reduce((e,t)=>e+t.height,0)<=15e6,B=m(z,R,P),V=h(j||z||L,B,a,s,_,v,y),H=V.rows,U=g(z,H,b);return{hasAutoHeightColumn:A,autoHeightActive:j,rowHeightStore:M,baseRowMetrics:N,labelHeightActive:L,detailExtras:P,detailActive:z,rowMetrics:B,verticalGeometry:V,virtualRows:H,virtualRowIndexes:V.rowIndexSet,detailEntries:U,windowFirstRow:H.length>0?H[0].index:0,windowLastRow:H.length>0?H[H.length-1].index:-1,physicalBodyHeight:V.physicalBodyHeight,bodyLayerTransform:V.translateY===0?void 0:`translateY(${V.translateY}px)`,verticalScaleFactor:V.scaleFactor,overlayBaseOffset:V.windowBaseOffsetPx}}};exports.createVerticalLayoutResolver=c;

package/dist/engine/verticalLayout.d.ts

@@ -2,6 +2,7 @@ import type { GridColumn, GridRowKey, RowModel } from '../model/gridTypes.unboun
 import { type DetailRowExtra, type RowMetrics, type VerticalGeometry, type VerticalRow } from '../logic/verticalGeometry';
 import { type RowHeightStore } from '../logic/rowHeightStore';
 import { resolveDetailRowExtras, type DetailIndexCache } from '../logic/detailRow';
+import type { LabelDisplay } from '../logic/labelRows';
 type ReadonlyRef<V> = {
     readonly current: V;
 };
@@ -28,12 +29,15 @@ export type VerticalLayoutInputs<T> = {
     detailHeight: number;
     detailIsExpandable: DetailIsExpandable<T>;
     detailIndexCacheRef: ReadonlyRef<DetailIndexCache>;
+    labelDisplay?: LabelDisplay<T> | null;
+    labelRowHeight?: number | ((row: T) => number);
 };
 export type VerticalLayoutResolution = {
     hasAutoHeightColumn: boolean;
     autoHeightActive: boolean;
     rowHeightStore: RowHeightStore | null;
     baseRowMetrics: RowMetrics;
+    labelHeightActive: boolean;
     detailExtras: readonly DetailRowExtra[];
     detailActive: boolean;
     rowMetrics: RowMetrics;