@rokkit/data 1.1.1 → 1.1.4

package/dist/src/index.d.ts

@@ -8,3 +8,4 @@ export { parseFilters } from "./parser";
 export { innerJoin, leftJoin, rightJoin, fullJoin, crossJoin, antiJoin, semiJoin } from "./join";
 export { deriveColumns, deriveMetadata, deriveSortableColumn, inferScale, addScales, deriveColumnDefs, mergeColumnEnhancements } from "./infer";
 export { filterData, filterObjectArray } from "./filter";
+export { nestByPath, nestByColumns } from "./nest";

package/dist/src/nest.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Nesting helpers
+ *
+ * Convert flat tabular shapes into the nested children-array shape consumed
+ * by hierarchical components (TreeTable, Tree).
+ *
+ *   nestByPath     — rows with a separator-delimited path field
+ *   nestByColumns  — rows with one or more group-by columns
+ */
+/**
+ * Convert flat rows that carry a separator-delimited path string into
+ * nested rows with a `children` array.
+ *
+ * Synthesizes intermediate parent rows when a path segment has no own row
+ * — the synthetic row carries only the path-field set to the partial path.
+ *
+ * @param {Array<Record<string, unknown>>} rows
+ * @param {{ column: string, separator?: string, keepPath?: boolean }} options
+ * @returns {Array<Record<string, unknown>>}
+ */
+export function nestByPath(rows: Array<Record<string, unknown>>, { column, separator, keepPath }: {
+    column: string;
+    separator?: string;
+    keepPath?: boolean;
+}): Array<Record<string, unknown>>;
+/**
+ * Convert flat rows into nested rows by grouping on one or more columns.
+ *
+ * Each entry in `columns` produces a level of grouping. Synthesized group
+ * rows carry `__group: true`, the grouped column name on a `__column` key,
+ * and the column value under the column's own field name so cell snippets
+ * can read it normally.
+ *
+ * @param {Array<Record<string, unknown>>} rows
+ * @param {string[]} columns
+ * @param {{ groupRowFactory?: (col: string, value: unknown, children: Array) => Record<string, unknown> }} [options]
+ * @returns {Array<Record<string, unknown>>}
+ */
+export function nestByColumns(rows: Array<Record<string, unknown>>, columns: string[], options?: {
+    groupRowFactory?: (col: string, value: unknown, children: any[]) => Record<string, unknown>;
+}): Array<Record<string, unknown>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rokkit/data",
-  "version": "1.1.1",
+  "version": "1.1.4",
   "description": "Contains generic data manipulation functions that can be used in various components.",
   "repository": {
     "type": "git",
@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@lukeed/uuid": "^2.0.1",
-    "@rokkit/core": "1.1.1",
+    "@rokkit/core": "1.1.4",
     "d3-array": "^3.2.4",
     "d3-collection": "^1.0.7",
     "ramda": "^0.32.0",

package/src/index.js

@@ -17,3 +17,4 @@ export {
 } from './infer'
 export { parseFilters } from './parser'
 export { filterData, filterObjectArray } from './filter'
+export { nestByPath, nestByColumns } from './nest'