@youp-grid/core 0.2.2 → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seungyoup Baek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -9,3 +9,17 @@ npm install @youp-grid/core
 ```ts
 import { buildRowModel, type ColumnDef } from "@youp-grid/core";
 ```
+
+## What It Owns
+
+- column normalization
+- row model generation
+- sorting, filtering, and pagination helpers
+- selection and column state helpers
+- clipboard, fill handle, history, CSV, aggregation, and grouping utilities
+
+UI adapters should reuse this package instead of duplicating data semantics.
+
+## License
+
+MIT. See the repository license.

package/dist/index.d.ts

@@ -13,9 +13,11 @@ export { applyPagination } from "./pagination.ts";
 export { buildRowModel } from "./row-model.ts";
 export { applyRowGrouping, isRowGroupNode } from "./row-grouping.ts";
 export { applySorting } from "./sorting.ts";
+export { applyTreeData } from "./tree-data.ts";
+export type { ApplyTreeDataOptions } from "./tree-data.ts";
 export { clearSelection, setRowSelected, setSelectedRows, toggleRowSelected } from "./selection.ts";
-export { clearFilter, clearSort, acknowledgeRemoteCache, cancelRemoteRequest, createRemoteCacheKey, createGridState, failRemoteRequest, finishRemoteRequest, invalidateRemoteCache, isActiveRemoteRequest, setCursorPage, setCursorPageSize, setCursorPagination, setAggregation, setFilter, setPagination, setRemoteCache, setRowGrouping, setSort, startRemoteRequest, toggleRowGroupExpanded, toggleSort, } from "./state.ts";
+export { clearFilter, clearSort, acknowledgeRemoteCache, cancelRemoteRequest, createRemoteCacheKey, createGridState, failRemoteRequest, finishRemoteRequest, invalidateRemoteCache, isActiveRemoteRequest, setCursorPage, setCursorPageSize, setCursorPagination, setAggregation, setFilter, setPagination, setRemoteCache, setRowGrouping, setSort, setTreeExpandedRows, startRemoteRequest, toggleRowGroupExpanded, toggleTreeRowExpanded, toggleSort, } from "./state.ts";
 export { getVirtualRange } from "./virtualizer.ts";
 export { createValueHistoryState, invertValueHistoryEntry, pushValueHistoryEntry, redoValueHistory, undoValueHistory, } from "./history.ts";
 export type { GridCellValueHistoryChange, GridValueHistoryEntry, GridValueHistoryState, } from "./history.ts";
-export type { Accessor, AggregationFunctionName, AggregationResult, AggregationRule, BuildRowModelOptions, ColumnAlign, ColumnPin, ColumnState, ColumnComparator, ColumnDef, ColumnEditor, ColumnEditorOption, ColumnEditorOptionValue, ColumnFilterPredicate, CursorPaginationState, FilterOperator, FilterRule, GridRowId, GridRowModelType, GridState, InfiniteScrollTrigger, InfiniteScrollTriggerOptions, PaginationState, ResolvedColumnDef, RemoteCacheState, RemoteRequestState, RemoteRequestStatus, RowModel, RowDisplayNode, RowGroupNode, RowGroupingState, RowNode, SortDirection, SortRule, ValueFormatter, ValueParser, VirtualItem, VirtualRange, VirtualRangeOptions, } from "./types.ts";
+export type { Accessor, AggregationFunctionName, AggregationResult, AggregationRule, BuildRowModelOptions, ColumnAlign, ColumnPin, ColumnState, ColumnComparator, ColumnDef, ColumnEditor, ColumnEditorOption, ColumnEditorOptionValue, ColumnFilterPredicate, CursorPaginationState, FilterOperator, FilterRule, GridRowId, GridRowModelType, GridState, InfiniteScrollTrigger, InfiniteScrollTriggerOptions, PaginationState, ResolvedColumnDef, RemoteCacheState, RemoteRequestState, RemoteRequestStatus, RowModel, RowDisplayNode, RowGroupNode, RowGroupingState, RowNode, SortDirection, SortRule, TreeDataState, ValueFormatter, ValueParser, VirtualItem, VirtualRange, VirtualRangeOptions, } from "./types.ts";

package/dist/index.js

@@ -10,7 +10,8 @@ export { applyPagination } from "./pagination.js";
 export { buildRowModel } from "./row-model.js";
 export { applyRowGrouping, isRowGroupNode } from "./row-grouping.js";
 export { applySorting } from "./sorting.js";
+export { applyTreeData } from "./tree-data.js";
 export { clearSelection, setRowSelected, setSelectedRows, toggleRowSelected } from "./selection.js";
-export { clearFilter, clearSort, acknowledgeRemoteCache, cancelRemoteRequest, createRemoteCacheKey, createGridState, failRemoteRequest, finishRemoteRequest, invalidateRemoteCache, isActiveRemoteRequest, setCursorPage, setCursorPageSize, setCursorPagination, setAggregation, setFilter, setPagination, setRemoteCache, setRowGrouping, setSort, startRemoteRequest, toggleRowGroupExpanded, toggleSort, } from "./state.js";
+export { clearFilter, clearSort, acknowledgeRemoteCache, cancelRemoteRequest, createRemoteCacheKey, createGridState, failRemoteRequest, finishRemoteRequest, invalidateRemoteCache, isActiveRemoteRequest, setCursorPage, setCursorPageSize, setCursorPagination, setAggregation, setFilter, setPagination, setRemoteCache, setRowGrouping, setSort, setTreeExpandedRows, startRemoteRequest, toggleRowGroupExpanded, toggleTreeRowExpanded, toggleSort, } from "./state.js";
 export { getVirtualRange } from "./virtualizer.js";
 export { createValueHistoryState, invertValueHistoryEntry, pushValueHistoryEntry, redoValueHistory, undoValueHistory, } from "./history.js";

package/dist/row-model.js

@@ -5,6 +5,7 @@ import { applyFilters } from "./filtering.js";
 import { applyPagination } from "./pagination.js";
 import { applyRowGrouping } from "./row-grouping.js";
 import { applySorting } from "./sorting.js";
+import { applyTreeData } from "./tree-data.js";
 export function buildRowModel(options) {
     const columns = applyColumnState(normalizeColumns(options.columns), options.state?.columns);
     const visibleColumns = getVisibleColumns(columns);
@@ -15,13 +16,20 @@ export function buildRowModel(options) {
             columns,
             visibleColumns,
             state: options.state,
+            treeData: options.treeData,
+            getParentRowId: options.getParentRowId,
             serverRowCount: options.serverRowCount,
             serverFilteredRowCount: options.serverFilteredRowCount,
         });
     }
     const filteredRows = applyFilters(allRows, columns, options.state?.filters);
     const sortedRows = applySorting(filteredRows, columns, options.state?.sort);
-    const paginated = applyPagination(sortedRows, options.state?.pagination);
+    const treeRows = applyTreeData(sortedRows, {
+        enabled: options.treeData,
+        state: options.state?.treeData,
+        getParentRowId: options.getParentRowId,
+    });
+    const paginated = applyPagination(treeRows, options.state?.pagination);
     const aggregation = applyAggregation(filteredRows, columns, options.state?.aggregation);
     const displayRows = applyRowGrouping(paginated.rows, columns, options.state?.rowGrouping);
     return {
@@ -42,18 +50,23 @@ export function buildRowModel(options) {
 function buildServerRowModel(context) {
     const totalRowCount = context.serverRowCount ?? context.allRows.length;
     const filteredRowCount = context.serverFilteredRowCount ?? totalRowCount;
+    const visibleRows = applyTreeData(context.allRows, {
+        enabled: context.treeData,
+        state: context.state?.treeData,
+        getParentRowId: context.getParentRowId,
+    });
     return {
         columns: context.columns,
         visibleColumns: context.visibleColumns,
         allRows: context.allRows,
         filteredRows: context.allRows,
         sortedRows: context.allRows,
-        visibleRows: context.allRows,
-        displayRows: applyRowGrouping(context.allRows, context.columns, context.state?.rowGrouping),
+        visibleRows,
+        displayRows: applyRowGrouping(visibleRows, context.columns, context.state?.rowGrouping),
         aggregation: applyAggregation(context.allRows, context.columns, context.state?.aggregation),
         totalRowCount,
         filteredRowCount,
-        visibleRowCount: context.allRows.length,
+        visibleRowCount: visibleRows.length,
         pageCount: getServerPageCount(filteredRowCount, context.state?.pagination),
     };
 }

package/dist/state.d.ts

@@ -1,4 +1,4 @@
-import type { AggregationRule, CursorPaginationState, FilterRule, GridState, PaginationState, RemoteCacheState, RowGroupingState, SortDirection } from "./types.ts";
+import type { AggregationRule, CursorPaginationState, FilterRule, GridRowId, GridState, PaginationState, RemoteCacheState, RowGroupingState, SortDirection } from "./types.ts";
 export declare function createGridState(state?: GridState): GridState;
 export declare function toggleSort(state: GridState, columnId: string, options?: {
     multi?: boolean;
@@ -17,6 +17,8 @@ export declare function setCursorPageSize(state: GridState, pageSize: number): G
 export declare function setAggregation(state: GridState, aggregation: readonly AggregationRule[]): GridState;
 export declare function setRowGrouping(state: GridState, rowGrouping: RowGroupingState | undefined): GridState;
 export declare function toggleRowGroupExpanded(state: GridState, groupId: string): GridState;
+export declare function setTreeExpandedRows(state: GridState, rowIds: readonly GridRowId[]): GridState;
+export declare function toggleTreeRowExpanded(state: GridState, rowId: GridRowId): GridState;
 export declare function startRemoteRequest(state: GridState, requestId: string): GridState;
 export declare function finishRemoteRequest(state: GridState, requestId: string): GridState;
 export declare function failRemoteRequest(state: GridState, requestId: string, error?: string): GridState;

package/dist/state.js

@@ -12,6 +12,13 @@ export function createGridState(state = {}) {
                     : undefined,
             }
             : undefined,
+        treeData: state.treeData
+            ? {
+                expandedRowIds: state.treeData.expandedRowIds
+                    ? [...state.treeData.expandedRowIds]
+                    : undefined,
+            }
+            : undefined,
         pagination: state.pagination ? { ...state.pagination } : undefined,
         cursorPagination: state.cursorPagination ? { ...state.cursorPagination } : undefined,
         remoteRequest: state.remoteRequest ? { ...state.remoteRequest } : undefined,
@@ -158,6 +165,26 @@ export function toggleRowGroupExpanded(state, groupId) {
         },
     };
 }
+export function setTreeExpandedRows(state, rowIds) {
+    const expandedRowIds = [...new Set(rowIds)];
+    return {
+        ...state,
+        treeData: {
+            ...(state.treeData ?? {}),
+            expandedRowIds: expandedRowIds.length > 0 ? expandedRowIds : undefined,
+        },
+    };
+}
+export function toggleTreeRowExpanded(state, rowId) {
+    const expandedRowIds = new Set(state.treeData?.expandedRowIds ?? []);
+    if (expandedRowIds.has(rowId)) {
+        expandedRowIds.delete(rowId);
+    }
+    else {
+        expandedRowIds.add(rowId);
+    }
+    return setTreeExpandedRows(state, [...expandedRowIds]);
+}
 export function startRemoteRequest(state, requestId) {
     return {
         ...state,
@@ -208,6 +235,7 @@ export function createRemoteCacheKey(state) {
         filters: state.filters ?? [],
         aggregation: state.aggregation ?? [],
         rowGrouping: state.rowGrouping,
+        treeData: state.treeData,
         pagination: state.pagination,
         cursorPagination: state.cursorPagination,
     });

package/dist/tree-data.d.ts

@@ -0,0 +1,7 @@
+import type { GridRowId, RowNode, TreeDataState } from "./types.ts";
+export type ApplyTreeDataOptions<TRow> = {
+    enabled?: boolean;
+    state?: TreeDataState;
+    getParentRowId?: (row: TRow, index: number) => GridRowId | null | undefined;
+};
+export declare function applyTreeData<TRow>(rows: RowNode<TRow>[], options?: ApplyTreeDataOptions<TRow>): RowNode<TRow>[];

package/dist/tree-data.js

@@ -0,0 +1,78 @@
+export function applyTreeData(rows, options = {}) {
+    if (!options.enabled || !options.getParentRowId) {
+        return rows;
+    }
+    const rowById = new Map();
+    const parentIdByRowId = new Map();
+    for (const row of rows) {
+        rowById.set(row.id, row);
+    }
+    const roots = [];
+    const childrenByParentId = new Map();
+    for (const row of rows) {
+        const parentId = options.getParentRowId(row.original, row.index) ?? undefined;
+        const validParentId = parentId !== undefined && parentId !== row.id && rowById.has(parentId)
+            ? parentId
+            : undefined;
+        parentIdByRowId.set(row.id, validParentId);
+        if (validParentId === undefined) {
+            roots.push(row);
+            continue;
+        }
+        const siblings = childrenByParentId.get(validParentId);
+        if (siblings) {
+            siblings.push(row);
+        }
+        else {
+            childrenByParentId.set(validParentId, [row]);
+        }
+    }
+    const expandedRowIds = new Set(options.state?.expandedRowIds ?? []);
+    const visibleRows = [];
+    const emitted = new Set();
+    const reachable = new Set();
+    const markReachable = (row, visiting) => {
+        if (visiting.has(row.id) || reachable.has(row.id)) {
+            return;
+        }
+        const nextVisiting = new Set(visiting);
+        nextVisiting.add(row.id);
+        reachable.add(row.id);
+        for (const child of childrenByParentId.get(row.id) ?? []) {
+            markReachable(child, nextVisiting);
+        }
+    };
+    const appendRow = (row, depth, visiting) => {
+        if (visiting.has(row.id) || emitted.has(row.id)) {
+            return;
+        }
+        const children = childrenByParentId.get(row.id) ?? [];
+        const expanded = children.length > 0 && expandedRowIds.has(row.id);
+        const nextVisiting = new Set(visiting);
+        nextVisiting.add(row.id);
+        visibleRows.push({
+            ...row,
+            depth,
+            parentId: parentIdByRowId.get(row.id),
+            hasChildren: children.length > 0,
+            expanded,
+        });
+        emitted.add(row.id);
+        if (!expanded) {
+            return;
+        }
+        for (const child of children) {
+            appendRow(child, depth + 1, nextVisiting);
+        }
+    };
+    for (const root of roots) {
+        markReachable(root, new Set());
+        appendRow(root, 0, new Set());
+    }
+    for (const row of rows) {
+        if (!reachable.has(row.id)) {
+            appendRow(row, 0, new Set());
+        }
+    }
+    return visibleRows;
+}

package/dist/types.d.ts

@@ -77,6 +77,9 @@ export type RowGroupingState = {
     columnIds: string[];
     collapsedGroupIds?: string[];
 };
+export type TreeDataState = {
+    expandedRowIds?: GridRowId[];
+};
 export type PaginationState = {
     pageIndex: number;
     pageSize: number;
@@ -108,6 +111,7 @@ export type GridState = {
     filters?: FilterRule[];
     aggregation?: AggregationRule[];
     rowGrouping?: RowGroupingState;
+    treeData?: TreeDataState;
     pagination?: PaginationState;
     cursorPagination?: CursorPaginationState;
     remoteRequest?: RemoteRequestState;
@@ -118,6 +122,10 @@ export type RowNode<TRow> = {
     id: GridRowId;
     index: number;
     original: TRow;
+    depth?: number;
+    parentId?: GridRowId;
+    hasChildren?: boolean;
+    expanded?: boolean;
 };
 export type RowGroupNode = {
     type: "group";
@@ -137,6 +145,8 @@ export type BuildRowModelOptions<TRow> = {
     columns: readonly ColumnDef<TRow>[];
     state?: GridState;
     getRowId?: (row: TRow, index: number) => GridRowId;
+    treeData?: boolean;
+    getParentRowId?: (row: TRow, index: number) => GridRowId | null | undefined;
     rowModelType?: GridRowModelType;
     serverRowCount?: number;
     serverFilteredRowCount?: number;

package/package.json

@@ -1,8 +1,17 @@
 {
   "name": "@youp-grid/core",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Framework-agnostic data grid core for Youp Grid.",
+  "license": "MIT",
+  "author": "SeungyoupBaek",
   "type": "module",
+  "keywords": [
+    "data-grid",
+    "grid",
+    "typescript",
+    "table",
+    "headless"
+  ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -13,13 +22,18 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "repository": {
     "type": "git",
     "url": "git+ssh://git@github.com/SeungyoupBaek/youp-grid.git",
     "directory": "packages/core"
   },
+  "bugs": {
+    "url": "https://github.com/SeungyoupBaek/youp-grid/issues"
+  },
+  "homepage": "https://github.com/SeungyoupBaek/youp-grid/tree/main/packages/core#readme",
   "publishConfig": {
     "access": "public"
   },