@vuu-ui/vuu-utils 4.1.0 → 5.0.0-alpha.2

package/package.json

@@ -1,11 +1,11 @@
 {
-  "version": "4.1.0",
+  "version": "5.0.0-alpha.2",
   "author": "heswell",
   "main": "./src/index.js",
   "license": "Apache-2.0",
   "types": "types/index.d.ts",
+  "type": "module",
   "scripts": {
-    "build:dev": "node ../../scripts/run-build.mjs",
     "build": "node ../../scripts/run-build-rslib.ts",
     "test": "vitest run",
     "type-defs": "node ../../scripts/build-type-defs.mjs"
@@ -15,14 +15,14 @@
   },
   "devDependencies": {
     "@dnd-kit/react": "^0.5.0",
-    "@vuu-ui/vuu-data-types": "4.1.0",
-    "@vuu-ui/vuu-table-types": "4.1.0",
-    "@vuu-ui/vuu-filter-types": "4.1.0",
-    "@vuu-ui/vuu-protocol-types": "4.1.0"
+    "@vuu-ui/vuu-data-types": "5.0.0-alpha.2",
+    "@vuu-ui/vuu-table-types": "5.0.0-alpha.2",
+    "@vuu-ui/vuu-filter-types": "5.0.0-alpha.2",
+    "@vuu-ui/vuu-protocol-types": "5.0.0-alpha.2"
   },
   "peerDependencies": {
     "@internationalized/date": "^3.0.0",
-    "@vuu-ui/vuu-filter-parser": "4.1.0",
+    "@vuu-ui/vuu-filter-parser": "5.0.0-alpha.2",
     "clsx": "^2.0.0",
     "react": "^19.2.3",
     "react-dom": "^19.2.3"
@@ -36,12 +36,11 @@
   ],
   "exports": {
     ".": {
+      "types": "./types/index.d.ts",
       "import": "./src/index.js",
-      "default": "./src/index.js",
-      "types": "./types/index.d.ts"
+      "default": "./src/index.js"
     }
   },
   "module": "./src/index.js",
-  "name": "@vuu-ui/vuu-utils",
-  "type": "module"
+  "name": "@vuu-ui/vuu-utils"
 }

package/src/column-utils.js

@@ -1,8 +1,8 @@
 import { moveItem } from "./array-utils.js";
 import { getTemporalInfo } from "./date/temporal.js";
 import { queryClosest } from "./html-utils.js";
-const SORT_ASC = "asc";
 const NO_HEADINGS = [];
+const SORT_ASC = "asc";
 const DEFAULT_COL_WIDTH = 100;
 const DEFAULT_MAX_WIDTH = 250;
 const DEFAULT_MIN_WIDTH = 50;
@@ -314,7 +314,7 @@ const measurePinnedColumns = (columns, selectionEndSize)=>{
         unpinnedWidth
     };
 };
-const getTableHeadings = (columns)=>{
+const getTableHeadings = (columns, selectionBookendWidth = 0)=>{
     if (columns.some(hasHeadings)) {
         const maxHeadingDepth = columns.reduce((max, { heading })=>Math.max(max, heading?.length ?? 0), 0);
         let heading;
@@ -322,8 +322,9 @@ const getTableHeadings = (columns)=>{
         let tableHeadingsRow;
         for(let level = 0; level < maxHeadingDepth; level++){
             tableHeadingsRow = [];
-            columns.forEach(({ heading: columnHeading = NO_HEADINGS, width })=>{
+            columns.forEach(({ heading: columnHeading = NO_HEADINGS, hidden, width })=>{
                 const label = columnHeading[level] ?? "";
+                if (hidden) return;
                 if (heading && heading.label === label) heading.width += width;
                 else {
                     heading = {
@@ -335,6 +336,10 @@ const getTableHeadings = (columns)=>{
             });
             tableHeadings.push(tableHeadingsRow);
         }
+        if (selectionBookendWidth > 0) tableHeadings.forEach((tableHeading)=>{
+            tableHeading[0].width += selectionBookendWidth;
+            tableHeading[tableHeading.length - 1].width += selectionBookendWidth;
+        });
         return tableHeadings;
     }
     return NO_HEADINGS;
@@ -526,6 +531,11 @@ const getGroupIcon = (columns, dataRow)=>{
         return getIcon?.(dataRow);
     }
 };
+const getGroupAdornment = (columns, dataRow)=>{
+    const { depth, isLeaf } = dataRow;
+    if (isLeaf || 0 === depth || depth > columns.length) return null;
+    return columns[depth - 1].getGroupAdornment?.(dataRow) ?? null;
+};
 const getGroupValue = (columns, dataRow)=>{
     const { depth, isLeaf } = dataRow;
     if (isLeaf || depth > columns.length) return null;
@@ -644,7 +654,7 @@ const getCalculatedColumnDetails = (column)=>{
             serverDataType: isVuuColumnDataType(serverDataType) ? serverDataType : void 0
         };
     }
-    throw Error("column.name is nor a calculated column");
+    throw Error('column.name is not a calculated column');
 };
 const setCalculatedColumnName = (column, name)=>{
     const [, type, expression] = column.name.split(":");
@@ -791,7 +801,7 @@ const stretchColumnsToFillAvailableSpace = (columns, availableWidth, totalWidth,
     return adjustedColumns;
 };
 const dataAndColumnUnchanged = (p, p1)=>p.column === p1.column && p.column.valueFormatter(p.dataRow[p.column.name]) === p1.column.valueFormatter(p1.dataRow[p1.column.name]);
-const dataColumnAndKeyUnchanged = (p, p1)=>p.column === p1.column && p.dataRow.key === p1.dataRow.key && p.column.valueFormatter(p.dataRow[p.column.name]) === p1.column.valueFormatter(p1.dataRow[p1.column.name]);
+const dataColumnAndKeyUnchanged = (p, p1)=>p.column === p1.column && p.dataRow.key === p1.dataRow.key && p.dataRow.vuu_action === p1.dataRow.vuu_action && p.column.valueFormatter(p.dataRow[p.column.name]) === p1.column.valueFormatter(p1.dataRow[p1.column.name]);
 const toColumnName = (column)=>column.name;
 const isStringColumn = (column)=>"string" === column.serverDataType;
 const columnByAriaIndex = (columns, ariaColIndex)=>{
@@ -802,4 +812,4 @@ const columnByAriaIndex = (columns, ariaColIndex)=>{
     }
     throw Error(`no column with aria-colIndex ${ariaColIndex}`);
 };
-export { AggregationType, addColumnToSubscribedColumns, applyDefaultColumnConfig, applyGroupByToColumns, applyRuntimeColumnWidthsToConfig, applySortToColumns, applyWidthToColumns, assertAllColumnsAreIncludedInSubscription, buildColumnMap, checkConfirmationPending, columnByAriaIndex, dataAndColumnUnchanged, dataColumnAndKeyUnchanged, dataSourceRowToDataRowDto, existingSort, extractGroupColumn, findColumn, flattenColumnGroup, fromServerDataType, getAllCellsInColumn, getAriaColIndex, getAriaRowIndex, getCalculatedColumnDetails, getColumnLabel, getColumnName, getColumnStyle, getColumnsInViewport, getDefaultAlignment, getDefaultColumnType, getGroupIcon, getGroupValue, getPinStateFromElement, getRuntimeColumnWidth, getServerDataType, getTableHeadings, getTypeFormattingFromColumn, hasCustomRenderer, hasHeadings, hasValidationRules, isCalculatedColumn, isColumnTypeRenderer, isDataLoading, isDataValueEditable, isDateTimeDataType, isDateTimeDataValue, isGroupColumn, isJsonAttribute, isJsonColumn, isJsonGroup, isLookupRenderer, isMappedValueTypeRenderer, isNanoTimestampColumn, isNotHidden, isNumericColumn, isPinned, isResizing, isStringColumn, isTemporalColumn, isTextColumn, isTimeDataType, isTimeDataValue, isTimeDataValueWithMilliseconds, isTimestampColumn, isTypeDescriptor, isValidColumnAlignment, isValidPinLocation, isValueListRenderer, isVuuColumnDataType, mapSortCriteria, measurePinnedColumns, metadataKeys, moveColumnTo, projectUpdates, removeSort, replaceColumn, setAggregations, setCalculatedColumnExpression, setCalculatedColumnName, setCalculatedColumnType, sortPinnedColumns, subscribedOnly, toColumnDescriptor, toColumnName, toDataSourceColumns, updateColumn, updateColumnFormatting, updateColumnRenderProps, updateColumnType, visibleColumnAtIndex };
+export { AggregationType, NO_HEADINGS, addColumnToSubscribedColumns, applyDefaultColumnConfig, applyGroupByToColumns, applyRuntimeColumnWidthsToConfig, applySortToColumns, applyWidthToColumns, assertAllColumnsAreIncludedInSubscription, buildColumnMap, checkConfirmationPending, columnByAriaIndex, dataAndColumnUnchanged, dataColumnAndKeyUnchanged, dataSourceRowToDataRowDto, existingSort, extractGroupColumn, findColumn, flattenColumnGroup, fromServerDataType, getAllCellsInColumn, getAriaColIndex, getAriaRowIndex, getCalculatedColumnDetails, getColumnLabel, getColumnName, getColumnStyle, getColumnsInViewport, getDefaultAlignment, getDefaultColumnType, getGroupAdornment, getGroupIcon, getGroupValue, getPinStateFromElement, getRuntimeColumnWidth, getServerDataType, getTableHeadings, getTypeFormattingFromColumn, hasCustomRenderer, hasHeadings, hasValidationRules, isCalculatedColumn, isColumnTypeRenderer, isDataLoading, isDataValueEditable, isDateTimeDataType, isDateTimeDataValue, isGroupColumn, isJsonAttribute, isJsonColumn, isJsonGroup, isLookupRenderer, isMappedValueTypeRenderer, isNanoTimestampColumn, isNotHidden, isNumericColumn, isPinned, isResizing, isStringColumn, isTemporalColumn, isTextColumn, isTimeDataType, isTimeDataValue, isTimeDataValueWithMilliseconds, isTimestampColumn, isTypeDescriptor, isValidColumnAlignment, isValidPinLocation, isValueListRenderer, isVuuColumnDataType, mapSortCriteria, measurePinnedColumns, metadataKeys, moveColumnTo, projectUpdates, removeSort, replaceColumn, setAggregations, setCalculatedColumnExpression, setCalculatedColumnName, setCalculatedColumnType, sortPinnedColumns, subscribedOnly, toColumnDescriptor, toColumnName, toDataSourceColumns, updateColumn, updateColumnFormatting, updateColumnRenderProps, updateColumnType, visibleColumnAtIndex };

package/src/component-registry.js

@@ -1,4 +1,4 @@
-import { hasCustomRenderer, isColumnTypeRenderer, isTemporalColumn, isTypeDescriptor } from "./column-utils.js";
+import { hasCustomRenderer, isColumnTypeRenderer, isDataValueEditable, isTemporalColumn, isTypeDescriptor } from "./column-utils.js";
 const containersSet = new Set();
 const viewsSet = new Set();
 const layoutComponentsMap = new Map();
@@ -77,7 +77,7 @@ function getEditRuleValidator(name) {
 function dataCellRenderer(column) {
     if ("boolean" === column.serverDataType && !hasCustomRenderer(column.type)) return cellRenderersMap.get("checkbox-cell");
     if (column.editable && !hasCustomRenderer(column.type) && isTemporalColumn(column) && cellRenderersMap.has("temporal-input-cell")) return cellRenderersMap.get("temporal-input-cell");
-    if (column.editable && !hasCustomRenderer(column.type)) return cellRenderersMap.get("input-cell");
+    if (isDataValueEditable(column, "update") && !hasCustomRenderer(column.type)) return cellRenderersMap.get("input-cell");
     if (isTypeDescriptor(column.type) && isColumnTypeRenderer(column.type.renderer)) return cellRenderersMap.get(column.type.renderer?.name);
     if ("boolean" === column.serverDataType) return cellRenderersMap.get("checkbox-cell");
 }

package/src/event-emitter.js

@@ -59,7 +59,9 @@ class EventEmitter {
         return listeners === listener;
     }
     invokeHandler(handler, args) {
-        if (isArrayOfListeners(handler)) handler.slice().forEach((listener)=>this.invokeHandler(listener, args));
+        if (isArrayOfListeners(handler)) handler.slice().forEach((listener)=>{
+            this.invokeHandler(listener, args);
+        });
         else switch(args.length){
             case 0:
                 handler();

package/src/feature-utils.js

@@ -1,7 +1,7 @@
-import { partition } from "./array-utils.js";
-import { wordify } from "./text-utils.js";
 import react from "react";
+import { partition } from "./array-utils.js";
 import { getLayoutComponent } from "./component-registry.js";
+import { wordify } from "./text-utils.js";
 const env = process.env.NODE_ENV;
 const importFeatureByUrl = (url)=>import(/* @vite-ignore */ url);
 let featureImporter = importFeatureByUrl;
@@ -16,13 +16,11 @@ function featureFromJson({ type }) {
     if (void 0 === componentType) throw Error(`layoutUtils unable to create feature component from JSON, unknown type ${type}`);
     return react.createElement(componentType);
 }
-const isCustomFeature = (feature)=>"vuu-features" === feature.leftNavLocation;
+const isCustomFeature = (feature)=>(feature.leftNavLocation ?? "vuu-features") === "vuu-features";
 const isWildcardSchema = (vuuTables)=>"*" === vuuTables;
 const isVuuTables = (vuuTables)=>Array.isArray(vuuTables);
 const hasFilterTableFeatureProps = (props)=>"object" == typeof props.ComponentProps && null !== props.ComponentProps && "tableSchema" in props.ComponentProps;
-const isSameTable = (t1, t2)=>{
-    t1.module === t2.module && (t1.table, t2.table);
-};
+const isSameTable = (t1, t2)=>t1.module === t2.module && t1.table === t2.table;
 const byModule = (schema1, schema2)=>{
     const m1 = schema1.table.module.toLowerCase();
     const m2 = schema2.table.module.toLowerCase();
@@ -80,7 +78,9 @@ const getCustomAndTableFeatures = (dynamicFeatures, tableSchemas)=>{
                     map[`${vuuTable.table}Schema`] = tableSchemas.find((tableSchema)=>isSameTable(vuuTable, tableSchema.table));
                     return map;
                 }, {}),
-                ViewProps: viewProps
+                ...void 0 === viewProps ? {} : {
+                    ViewProps: viewProps
+                }
             });
         } else customFeatures.push(feature);
     }

package/src/index.js

@@ -14,6 +14,7 @@ export * from "./datasource/datasource-utils.js";
 export * from "./date/index.js";
 export * from "./debug-utils.js";
 export * from "./event-emitter.js";
+export * from "./errors.js";
 export * from "./feature-utils.js";
 export * from "./filters/index.js";
 export * from "./form-utils.js";

package/src/react-utils.js

@@ -1,14 +1,8 @@
 import { Children, isValidElement, useEffect, useMemo, useRef } from "react";
 const EMPTY_ARRAY = [];
 const asReactElements = (children)=>{
-    const isArray = Array.isArray(children);
-    const count = isArray ? children.length : Children.count(children);
-    if (isArray && children.every(isValidElement)) return children;
-    if (1 === count && !isArray && isValidElement(children)) return [
-        children
-    ];
-    if (count > 1) return children;
-    return EMPTY_ARRAY;
+    const elements = Children.toArray(children).filter(isValidElement);
+    return 0 === elements.length ? EMPTY_ARRAY : elements;
 };
 const useIsMounted = (id = "")=>{
     const isMountedRef = useRef(false);

package/src/table-schema-utils.js

@@ -1,9 +1,3 @@
-const toSchemaColumn = ({ editable, name, required, serverDataType = "string" })=>({
-        editable,
-        name,
-        required,
-        serverDataType
-    });
 const getVuuTable = (schemaTable)=>{
     if (!schemaTable.session) return schemaTable;
     {
@@ -14,4 +8,9 @@ const getVuuTable = (schemaTable)=>{
         };
     }
 };
+const toSchemaColumn = ({ editable, name, serverDataType = 'string' })=>({
+        editable: true === editable || 'object' == typeof editable,
+        name,
+        serverDataType
+    });
 export { getVuuTable, toSchemaColumn };

package/src/tree-utils.js

@@ -35,9 +35,9 @@ const addChildValues = (rows, treeSourceNodes, cols, iconProvider, index = {
         type: "string"
     });
     for(let i = 0; i < treeSourceNodes.length; i++, index.value += 1){
-        const { childNodes, icon, label, nodeData } = treeSourceNodes[i];
+        const { childNodes, icon, keySegment = treeSourceNodes[i].label, label, nodeData } = treeSourceNodes[i];
         const blanks = Array(depth - 1).fill("");
-        const fullKey = `${keyBase}|${label}`;
+        const fullKey = `${keyBase}|${keySegment}`;
         const row = [
             index.value,
             index.value,

package/types/column-utils.d.ts

@@ -1,8 +1,8 @@
 import type { DataSourceRow, DataValueDescriptor, DataValueType, DataValueTypeSimple, DateTimeDataValueDescriptor, SchemaColumn, TableSchema, TimeDataValueDescriptor } from "@vuu-ui/vuu-data-types";
 import type { VuuAggType, VuuAggregation, VuuColumnDataType, VuuDataRowDto, VuuGroupBy, VuuSort } from "@vuu-ui/vuu-protocol-types";
-import { TableModel } from "@vuu-ui/vuu-table";
 import type { ColumnAlignment, ColumnDescriptor, ColumnLayout, ColumnTypeFormatting, ColumnTypeRendering, ColumnTypeWithValidationRules, DataRow, DataValueTypeDescriptor, DefaultColumnConfiguration, GroupColumnDescriptor, LookupRenderer, MappedValueTypeRenderer, PinLocation, RuntimeColumnDescriptor, TableCellRendererProps, TableConfig, TableHeadings, ValueListRenderer } from "@vuu-ui/vuu-table-types";
-import { type CSSProperties } from "react";
+import type { TableModel } from "@vuu-ui/vuu-table";
+import type { CSSProperties, ReactNode } from "react";
 /**
  * ColumnMap provides a lookup of the index position of a data item within a row
  * by column name.
@@ -13,6 +13,7 @@ export interface ColumnMap {
 export interface ReverseColumnMap {
     [columnIndex: number]: string;
 }
+export declare const NO_HEADINGS: TableHeadings;
 export type SortCriteriaItem = string | [string, "asc"];
 export declare const AggregationType: {
     [key: string]: VuuAggType;
@@ -129,7 +130,7 @@ export declare const measurePinnedColumns: (columns: RuntimeColumnDescriptor[],
     pinnedWidthRight: number;
     unpinnedWidth: number;
 };
-export declare const getTableHeadings: (columns: RuntimeColumnDescriptor[]) => TableHeadings;
+export declare const getTableHeadings: (columns: RuntimeColumnDescriptor[], selectionBookendWidth?: number) => TableHeadings;
 export declare const getColumnStyle: ({ pin, pinnedOffset, pinnedWidth, width, }: RuntimeColumnDescriptor) => CSSProperties;
 export declare const getAllCellsInColumn: (container: HTMLElement | null, colIndex: number) => HTMLDivElement[];
 export type PinState = {
@@ -170,6 +171,7 @@ export declare const getColumnsInViewport: (columns: RuntimeColumnDescriptor[],
 export declare const isNotHidden: (column: RuntimeColumnDescriptor) => boolean;
 export declare const visibleColumnAtIndex: (columns: RuntimeColumnDescriptor[], index: number) => RuntimeColumnDescriptor | undefined;
 export declare const getGroupIcon: (columns: RuntimeColumnDescriptor[], dataRow: DataRow) => string | undefined;
+export declare const getGroupAdornment: (columns: RuntimeColumnDescriptor[], dataRow: DataRow) => ReactNode;
 export declare const getGroupValue: (columns: RuntimeColumnDescriptor[], dataRow: DataRow) => string | null;
 export declare const getDefaultColumnType: (serverDataType?: VuuColumnDataType) => DataValueTypeSimple;
 export declare const updateColumnFormatting: <T extends ColumnDescriptor = ColumnDescriptor>(column: T, formatting: ColumnTypeFormatting) => T;

package/types/component-registry.d.ts

@@ -1,7 +1,7 @@
-import { EditRuleValidator } from "@vuu-ui/vuu-data-types";
-import { VuuColumnDataType } from "@vuu-ui/vuu-protocol-types";
-import { ColumnDescriptor, ColumnDescriptorCustomRenderer, ColumnTypeRendering, DataRow, HeaderCellProps, TableCellRendererProps } from "@vuu-ui/vuu-table-types";
-import { FunctionComponent as FC, HTMLAttributes } from "react";
+import type { EditRuleValidator } from "@vuu-ui/vuu-data-types";
+import type { VuuColumnDataType } from "@vuu-ui/vuu-protocol-types";
+import type { ColumnDescriptor, ColumnDescriptorCustomRenderer, ColumnTypeRendering, DataRow, HeaderCellProps, TableCellRendererProps } from "@vuu-ui/vuu-table-types";
+import type { FunctionComponent as FC, HTMLAttributes } from "react";
 export interface CellConfigPanelProps extends HTMLAttributes<HTMLDivElement> {
     onConfigChange: () => void;
 }

package/types/feature-utils.d.ts

@@ -1,9 +1,9 @@
-import type { TableSchema } from "@vuu-ui/vuu-data-types";
+import type { RemoteModuleConnection, TableSchema } from "@vuu-ui/vuu-data-types";
 import type { VuuTable } from "@vuu-ui/vuu-protocol-types";
 import type { ListOption } from "@vuu-ui/vuu-table-types";
 import React, { type ReactElement } from "react";
 export type PathMap = {
-    [key: string]: Pick<DynamicFeatureDescriptor, "css" | "url">;
+    [key: string]: string;
 };
 export type Environment = "development" | "production";
 export declare const env: Environment;
@@ -21,12 +21,11 @@ export interface DynamicFeatureProps<P extends object | undefined = object> {
     ViewProps?: ViewConfig;
     css?: string;
     height?: number;
+    mfComponent: string;
+    mfScope: string;
+    mfUrl: string;
+    vuu?: RemoteModuleConnection;
     title?: string;
-    /**
-     The url of javascript bundle to lazily load. Bundle must provide a default export
-     and that export must be a React component.
-     */
-    url: string;
     width?: number;
 }
 export type FeatureModule = {
@@ -47,20 +46,30 @@ declare global {
     const vuuConfig: Promise<VuuConfig>;
 }
 export interface DynamicFeatureDescriptor {
-    /**
-     * url for css file for feature
-     */
-    css?: string;
+    description: string;
     featureProps?: {
         vuuTables?: "*" | VuuTable[];
     };
-    leftNavLocation: "vuu-features" | "vuu-tables";
+    id: string;
+    leftNavLocation?: "vuu-features" | "vuu-tables";
+    location: string;
     name: string;
-    title: string;
     /**
-     * url for javascript bundle to load feature
+     * Module federation - the name of remote component to be imported
      */
-    url: string;
+    mfComponent: string;
+    /**
+     * Module federation - the identifier of remote module
+     */
+    mfScope: string;
+    /**
+     * Module federation - the url of remote module manifest
+     */
+    mfUrl: string;
+    path: string;
+    title: string;
+    vuu?: RemoteModuleConnection;
+    version: number;
     viewProps?: ViewConfig;
 }
 export interface StaticFeatureDescriptor {
@@ -79,10 +88,11 @@ export declare function featureFromJson({ type }: {
     type: string;
 }): ReactElement;
 export interface VuuConfig {
-    features: DynamicFeatures;
-    authUrl?: string;
-    websocketUrl: string;
+    authUrl: string;
+    moduleRegistryUrl: string;
+    restUrl: string;
     ssl: boolean;
+    websocketUrl: string;
 }
 /**
  * We currently categorize 'features' simply by the leftNavLocation
@@ -96,7 +106,7 @@ export interface FeaturePropsWithFilterTableFeature extends Omit<DynamicFeatureP
     ComponentProps: FilterTableFeatureProps;
 }
 export declare const hasFilterTableFeatureProps: (props: DynamicFeatureProps) => props is FeaturePropsWithFilterTableFeature;
-export declare const isSameTable: (t1: VuuTable, t2: VuuTable) => void;
+export declare const isSameTable: (t1: VuuTable, t2: VuuTable) => boolean;
 export declare const byModule: (schema1: TableSchema, schema2: TableSchema) => -1 | 0 | 1;
 export type GetFeaturePaths = (params: {
     env: Environment;

package/types/filters/filter-utils.d.ts

@@ -29,6 +29,7 @@ export declare const stripFilterFromColumns: (columns: RuntimeColumnDescriptor[]
     exportable?: boolean;
     exportFormatter?: (value: unknown, row: import("@vuu-ui/vuu-table-types").RowAccessor) => string;
     getIcon?: (row: import("@vuu-ui/vuu-table-types").DataRow) => string | undefined;
+    getGroupAdornment?: (row: import("@vuu-ui/vuu-table-types").DataRow) => import("react").ReactNode;
     groupable?: boolean;
     hidden?: boolean;
     locked?: Exclude<import("@vuu-ui/vuu-table-types").PinLocation, "left"> | false;

package/types/index.d.ts

@@ -21,6 +21,7 @@ export * from "./debug-utils";
 export { isInlineEditingSession } from "./edit-utils";
 export { StaleUpdateError } from "./errors";
 export * from "./event-emitter";
+export * from "./errors";
 export * from "./feature-utils";
 export * from "./filters";
 export * from "./form-utils";

package/types/react-utils.d.ts

@@ -1,4 +1,4 @@
-import { ReactElement, ReactNode, SetStateAction } from "react";
+import { type ReactElement, type ReactNode, type SetStateAction } from "react";
 export declare const asReactElements: (children: ReactNode) => ReactElement[];
 export declare const useIsMounted: (id?: string) => import("react").RefObject<boolean>;
 export declare const isSimpleStateValue: <T>(arg: SetStateAction<T>) => arg is T;

package/types/sort-utils.d.ts

@@ -1,5 +1,5 @@
-import { ColumnDescriptor } from "@vuu-ui/vuu-table-types";
-import { VuuSort, VuuSortType } from "@vuu-ui/vuu-protocol-types";
+import type { ColumnDescriptor } from "@vuu-ui/vuu-table-types";
+import type { VuuSort, VuuSortType } from "@vuu-ui/vuu-protocol-types";
 export declare const toggleOrApplySort: ({ sortDefs }: VuuSort, { name: column }: ColumnDescriptor, extendSort?: boolean, sortType?: VuuSortType) => VuuSort;
 export declare const setSortColumn: ({ sortDefs }: VuuSort, column: ColumnDescriptor, sortType?: "A" | "D") => VuuSort;
 export declare const addSortColumn: ({ sortDefs }: VuuSort, column: ColumnDescriptor, sortType?: "A" | "D") => VuuSort;

package/types/table-schema-utils.d.ts

@@ -1,5 +1,5 @@
-import type { ColumnDescriptor } from "@vuu-ui/vuu-table-types";
 import type { SchemaColumn, TableSchemaTable } from "@vuu-ui/vuu-data-types";
 import type { VuuTable } from "@vuu-ui/vuu-protocol-types";
-export declare const toSchemaColumn: ({ editable, name, required, serverDataType, }: ColumnDescriptor) => SchemaColumn;
+import type { ColumnDescriptor } from "@vuu-ui/vuu-table-types";
 export declare const getVuuTable: (schemaTable: TableSchemaTable) => VuuTable;
+export declare const toSchemaColumn: ({ editable, name, serverDataType }: ColumnDescriptor) => SchemaColumn;

package/types/tree-types.d.ts

@@ -4,6 +4,11 @@ export interface TreeSourceNode<T = unknown> {
     icon?: string;
     header?: boolean;
     label: string;
+    /**
+     * Segment used to build the row key for this node, defaults to label.
+     * Allows a display label to differ from a stable key.
+     */
+    keySegment?: string;
     childNodes?: TreeSourceNode<T>[];
     /** node is rendered expanded initially */
     expanded?: boolean;

package/types/src/Clock.d.ts

@@ -1,20 +0,0 @@
-export interface ClockProps {
-    year?: number;
-    month?: number;
-    day?: number;
-    hours?: number;
-    minutes?: number;
-    seconds?: number;
-    milliseconds?: number;
-}
-export type ClockTimeUnit = "minutes" | "seconds" | "ms";
-export declare class Clock {
-    #private;
-    constructor(props?: ClockProps);
-    goBack(value: number, units?: ClockTimeUnit): this;
-    advance(value: number, units?: ClockTimeUnit): this;
-    set showCurrentTime(value: boolean);
-    toString(): string;
-    get now(): number;
-    get date(): Date;
-}

package/types/src/PageVisibilityObserver.d.ts

@@ -1,36 +0,0 @@
-import { EventEmitter } from "./event-emitter";
-export type PageVisibilityEvents = {
-    /**
-     * emits when page has been hidden for this period of time
-     */
-    "inactive-timeout": () => void;
-    /**
-     * emits when page is hidden
-     */
-    hidden: () => void;
-    /**
-     * emits when page is made visible
-     */
-    visible: () => void;
-    /**
-     * emits when page visibility status changes
-     */
-    visibilityChange: (hidden: boolean) => void;
-};
-export interface PageVisibilityObserverConstructorProps {
-    /**
-     * timeout period in seconds. Defaults to zero which will never timeout
-     */
-    inactiveTimeout?: number;
-    onHidden?: () => void;
-    onInactiveTimeout?: () => void;
-    onVisible?: () => void;
-    onVisibilityChange?: () => void;
-}
-export declare class PageVisibilityObserver extends EventEmitter<PageVisibilityEvents> {
-    #private;
-    visibilityChangeHandler: () => void;
-    constructor({ inactiveTimeout, onHidden, onInactiveTimeout, onVisibilityChange, onVisible, }?: PageVisibilityObserverConstructorProps);
-    clear(): void;
-    private set hidden(value);
-}

package/types/src/ScaledDecimal.d.ts

@@ -1,12 +0,0 @@
-export declare class ScaledDecimal {
-    protected readonly value: string;
-    private readonly decimals;
-    constructor(value: string, decimals?: number);
-    get asLong(): string;
-    toJSON(): string;
-    toString(): string;
-}
-export declare const ScaledDecimal2: (value: string) => ScaledDecimal;
-export declare const ScaledDecimal4: (value: string) => ScaledDecimal;
-export declare const ScaledDecimal6: (value: string) => ScaledDecimal;
-export declare const ScaledDecimal8: (value: string) => ScaledDecimal;

package/types/src/ShellContext.d.ts

@@ -1,11 +0,0 @@
-import type { RpcResponseHandler } from "@vuu-ui/vuu-data-types";
-import type { DefaultColumnConfiguration, DefaultTableConfiguration } from "@vuu-ui/vuu-table-types";
-import { LookupTableProvider } from "./feature-utils";
-export interface ShellContextProps {
-    getDefaultColumnConfig?: DefaultColumnConfiguration;
-    getDefaultTableConfig?: DefaultTableConfiguration;
-    getLookupValues?: LookupTableProvider;
-    handleRpcResponse?: RpcResponseHandler;
-}
-export declare const ShellContext: import("react").Context<ShellContextProps>;
-export declare const useShellContext: () => ShellContextProps;

package/types/src/ThemeProvider.d.ts

@@ -1,32 +0,0 @@
-import { type ReactNode } from "react";
-export declare const DEFAULT_DENSITY: Density;
-export declare const DEFAULT_THEME = "salt-theme";
-export declare const DEFAULT_THEME_MODE: ThemeMode;
-export type Density = "high" | "medium" | "low" | "touch";
-export type ThemeMode = "light" | "dark";
-export type TargetElement = "root" | "scope" | "child";
-export interface ThemeContextProps {
-    density: Density;
-    theme: string;
-    themeMode: ThemeMode;
-}
-export declare const ThemeContext: import("react").Context<ThemeContextProps>;
-export type ThemeClasses = [string, string, ThemeMode];
-export type ThemeAttributes = {
-    themeClass: string;
-    densityClass: string;
-    dataMode: ThemeMode;
-};
-export declare const useThemeAttributes: (themeAttributes?: ThemeAttributes) => [string, string, ThemeMode];
-interface ThemeProviderProps {
-    applyThemeClasses?: boolean;
-    children: ReactNode;
-    density?: Density;
-    theme?: string;
-    themeMode?: ThemeMode;
-}
-export declare function ThemeProvider({ applyThemeClasses, children, theme: themeProp, themeMode: themeModeProp, density: densityProp, }: ThemeProviderProps): import("react").JSX.Element;
-export declare namespace ThemeProvider {
-    var displayName: string;
-}
-export {};

package/types/src/array-utils.d.ts

@@ -1,16 +0,0 @@
-export type PartitionTest<T> = (value: T, index: number) => boolean;
-export declare function partition<T>(array: T[], test: PartitionTest<T>, pass?: T[], fail?: T[]): [T[], T[]];
-export declare function itemsChanged<T = unknown>(currentItems: T[], newItems: T[], identityProperty?: string): boolean;
-export declare function itemsOrOrderChanged<T = unknown>(currentItems: T[], newItems: T[], identityProperty?: string): boolean;
-export declare const moveItemDeprecated: <T = unknown>(items: T[], item: T, moveTo: number) => T[];
-export declare const moveItem: <T = unknown>(items: T[], fromIndex: number, toIndex: number) => T[];
-export declare const getAddedItems: <T>(values: undefined | T[], newValues: T[]) => T[];
-export declare const getMissingItems: <T, I>(sourceItems: T[], items: I[], identity: (s: T) => I) => I[];
-/**
- * Given an ordered list of item names, return items in same order
- */
-export declare const reorderItems: <T extends {
-    name: string;
-} = {
-    name: string;
-}>(originalItems: readonly T[], orderedNames: string[]) => T[];

package/types/src/box-utils.d.ts

@@ -1,24 +0,0 @@
-export interface rect {
-    bottom: number;
-    left: number;
-    right: number;
-    top: number;
-}
-export type rectTuple = [number, number, number, number];
-export type dimension = "width" | "height";
-export declare function boxContainsPoint(rect: rect, x: number, y: number): boolean | undefined;
-export type GridLayoutSplitDirection = "north" | "south" | "east" | "west";
-export type GridLayoutDropPosition = GridLayoutSplitDirection | "header" | "centre";
-export declare function getCenteredBox({ right, left, top, bottom }: rect, pctSize: number): {
-    left: number;
-    top: number;
-    right: number;
-    bottom: number;
-};
-export declare function pointPositionWithinRect(x: number, y: number, rect: rect, borderZone?: number): {
-    pctX: number;
-    pctY: number;
-    closeToTheEdge: number;
-};
-export declare const isGridLayoutSplitDirection: (position: GridLayoutDropPosition) => position is GridLayoutSplitDirection;
-export declare function getPositionWithinBox(x: number, y: number, rect: rect, pctX: number, pctY: number): GridLayoutDropPosition;

package/types/src/broadcast-channel.d.ts

@@ -1,16 +0,0 @@
-interface VuuBroadcastChannelEventMap<T> {
-    message: MessageEvent<T>;
-    messageerror: MessageEvent<T>;
-}
-export interface VuuBroadcastChannel<T> extends EventTarget {
-    readonly name: string;
-    onmessage: ((this: BroadcastChannel, evt: MessageEvent<T>) => void) | null;
-    onmessageerror: ((this: BroadcastChannel, evt: MessageEvent<T>) => void) | null;
-    close(): void;
-    postMessage<M extends T = T>(message: M): void;
-    addEventListener<K extends keyof VuuBroadcastChannelEventMap<T>>(type: K, listener: (this: BroadcastChannel, evt: VuuBroadcastChannelEventMap<T>[K]) => void, options?: boolean | AddEventListenerOptions): void;
-    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-    removeEventListener<K extends keyof VuuBroadcastChannelEventMap<T>>(type: K, listener: (this: BroadcastChannel, evt: VuuBroadcastChannelEventMap<T>[K]) => void, options?: boolean | EventListenerOptions): void;
-    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-}
-export {};