@vuu-ui/vuu-utils 4.0.0-alpha.9 → 4.0.0-beta.1

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

@@ -1,243 +0,0 @@
-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";
-/**
- * ColumnMap provides a lookup of the index position of a data item within a row
- * by column name.
- */
-export interface ColumnMap {
-    [columnName: string]: number;
-}
-export interface ReverseColumnMap {
-    [columnIndex: number]: string;
-}
-export type SortCriteriaItem = string | [string, "asc"];
-export declare const AggregationType: {
-    [key: string]: VuuAggType;
-};
-export declare function mapSortCriteria(sortCriteria: SortCriteriaItem[], columnMap: ColumnMap, metadataOffset?: number): [number, "asc"][];
-export declare const getDefaultAlignment: (serverDataType?: VuuColumnDataType) => ColumnAlignment;
-export type EditOperation = "insert" | "update";
-export declare const isDataValueEditable: (dataDescriptor: Pick<DataValueDescriptor, "editable">, operation: EditOperation, defaultValue?: boolean) => boolean;
-export declare const getRuntimeColumnWidth: (col: ColumnDescriptor, runtimeColumns: RuntimeColumnDescriptor[]) => number;
-export declare const applyRuntimeColumnWidthsToConfig: (tableConfig: TableConfig, columns: RuntimeColumnDescriptor[]) => TableConfig;
-export declare const isValidColumnAlignment: (v: string) => v is ColumnAlignment;
-export declare const isValidPinLocation: (v: string) => v is PinLocation;
-export type CalculatedColumn = {
-    name: string;
-    expression: string;
-    serverDataType: VuuColumnDataType;
-};
-export declare const isVuuColumnDataType: (value: string | undefined | null) => value is VuuColumnDataType;
-export declare const fromServerDataType: (serverDataType: VuuColumnDataType) => DataValueTypeSimple;
-export declare const isNanoTimestampColumn: ({ serverDataType, }: DataValueDescriptor) => boolean;
-export declare const isTimestampColumn: (column: ColumnDescriptor) => boolean;
-export declare const isNumericColumn: ({ serverDataType, type }: ColumnDescriptor) => boolean;
-export declare const isDateTimeDataType: (column: ColumnDescriptor) => column is DateTimeDataValueDescriptor;
-export declare const isTimeDataType: (column: ColumnDescriptor) => column is TimeDataValueDescriptor;
-export declare const isDateTimeDataValue: (column: ColumnDescriptor) => boolean;
-export declare const isTimeDataValue: (column?: ColumnDescriptor) => column is TimeDataValueDescriptor;
-export declare const isPinned: (column: ColumnDescriptor) => boolean;
-export declare const hasHeadings: (column: ColumnDescriptor) => boolean;
-export declare const isResizing: (column: RuntimeColumnDescriptor) => boolean | undefined;
-export declare const isTextColumn: ({ serverDataType }: ColumnDescriptor) => boolean;
-export declare const toColumnDescriptor: (name: string, serverDataType?: ColumnDescriptor["serverDataType"]) => ColumnDescriptor;
-/**
- *
- */
-export declare const isTypeDescriptor: (type?: DataValueType) => type is DataValueTypeDescriptor;
-export declare const isColumnTypeRenderer: (renderer?: unknown) => renderer is ColumnTypeRendering;
-export declare const hasCustomRenderer: (type?: DataValueType) => type is DataValueTypeDescriptor;
-export declare const isLookupRenderer: (renderer?: unknown) => renderer is LookupRenderer;
-export declare const isValueListRenderer: (renderer?: unknown) => renderer is ValueListRenderer;
-export declare const hasValidationRules: (type?: DataValueType) => type is ColumnTypeWithValidationRules;
-export declare const isMappedValueTypeRenderer: (renderer?: unknown) => renderer is MappedValueTypeRenderer;
-export declare function buildColumnMap(columns?: readonly (ColumnDescriptor | SchemaColumn | string)[]): ColumnMap;
-export declare function projectUpdates(updates: number[]): number[];
-export declare const metadataKeys: {
-    readonly IDX: 0;
-    readonly RENDER_IDX: 1;
-    readonly IS_LEAF: 2;
-    readonly IS_EXPANDED: 3;
-    readonly DEPTH: 4;
-    readonly COUNT: 5;
-    readonly KEY: 6;
-    readonly SELECTED: 7;
-    readonly TIMESTAMP: 8;
-    readonly IS_NEW: 9;
-    readonly count: 10;
-    readonly PARENT_IDX: "parent_idx";
-    readonly IDX_POINTER: "idx_pointer";
-    readonly FILTER_COUNT: "filter_count";
-    readonly NEXT_FILTER_IDX: "next_filter_idx";
-};
-export declare const flattenColumnGroup: (columns: RuntimeColumnDescriptor[]) => RuntimeColumnDescriptor[];
-export declare function extractGroupColumn({ availableWidth, columns, groupBy, confirmed, }: ColumnGroupProps): [
-    GroupColumnDescriptor | null,
-    RuntimeColumnDescriptor[]
-];
-export declare const isGroupColumn: (column: RuntimeColumnDescriptor) => column is GroupColumnDescriptor;
-/**
- *  groupConfirmed is currently the only 'pending' attribute we use. A
- * value of true is only reset by a follow-up value of false. Intermediary
- * values of undefined are discounted.
- */
-export declare const checkConfirmationPending: (previousConfig?: TableModel) => boolean | undefined;
-export declare const isJsonAttribute: (value: unknown) => boolean;
-export declare const isJsonGroup: (column: RuntimeColumnDescriptor, dataRow: DataRow) => boolean;
-export declare const isJsonColumn: (column: RuntimeColumnDescriptor) => boolean;
-export declare const sortPinnedColumns: (columns: RuntimeColumnDescriptor[], selectionBookendWidth?: number) => RuntimeColumnDescriptor[];
-export declare const measurePinnedColumns: (columns: RuntimeColumnDescriptor[], selectionEndSize: number) => {
-    pinnedWidthLeft: number;
-    pinnedWidthRight: number;
-    unpinnedWidth: number;
-};
-export declare const getTableHeadings: (columns: RuntimeColumnDescriptor[]) => TableHeadings;
-export declare const getColumnStyle: ({ pin, pinnedOffset, pinnedWidth, width, }: RuntimeColumnDescriptor) => CSSProperties;
-export declare const getAllCellsInColumn: (container: HTMLElement | null, colIndex: number) => HTMLDivElement[];
-export type PinState = {
-    /**
-     * The pinned 'endPin' cell
-     */
-    cell: HTMLElement;
-    /**
-     * With multiple columns pinned, left pinned columns that follow
-     * // the resized column. These will need pinOffset adjustments.
-     */
-    pinnedCells?: HTMLElement[];
-    pinnedWidth: number;
-};
-export declare const getAriaRowIndex: (rowElement: HTMLElement | null) => number;
-export declare const getAriaColIndex: (cellElement: HTMLElement | null) => number;
-export declare const getPinStateFromElement: (cell: HTMLElement) => PinState | undefined;
-export declare const setAggregations: (aggregations: VuuAggregation[], column: ColumnDescriptor, aggType: VuuAggType) => VuuAggregation[];
-export type ColumnGroupProps = {
-    columns: RuntimeColumnDescriptor[];
-    groupBy: VuuGroupBy;
-    confirmed?: boolean;
-    availableWidth: number;
-};
-export declare const applyGroupByToColumns: (props: ColumnGroupProps) => RuntimeColumnDescriptor[];
-export declare const applySortToColumns: (columns: RuntimeColumnDescriptor[], sort: VuuSort) => RuntimeColumnDescriptor[];
-export declare const removeSort: (columns: RuntimeColumnDescriptor[]) => RuntimeColumnDescriptor[];
-export declare const existingSort: (columns: RuntimeColumnDescriptor[]) => boolean;
-export declare const getColumnName: (name: string) => string;
-export declare const getColumnLabel: (column: ColumnDescriptor) => string;
-export declare const findColumn: (columns: RuntimeColumnDescriptor[], columnName: string) => RuntimeColumnDescriptor | undefined;
-export declare function updateColumn<T extends ColumnDescriptor>(columns: readonly T[], column: T): T[];
-export declare function updateColumn(columns: readonly RuntimeColumnDescriptor[], column: string, options: Partial<ColumnDescriptor>): RuntimeColumnDescriptor[];
-export declare const toDataSourceColumns: (column: ColumnDescriptor) => string;
-export declare const dataSourceRowToDataRowDto: (row: DataSourceRow, columnMap: ColumnMap) => VuuDataRowDto;
-export declare const isDataLoading: (columns: RuntimeColumnDescriptor[]) => boolean;
-export declare const getColumnsInViewport: (columns: RuntimeColumnDescriptor[], vpStart: number, vpEnd: number) => [RuntimeColumnDescriptor[], number];
-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 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;
-export declare function updateColumnType<T extends ColumnDescriptor = ColumnDescriptor>(column: T, type: DataValueTypeSimple): T;
-export declare const updateColumnRenderProps: <T extends ColumnDescriptor = ColumnDescriptor>(column: T, renderer: ColumnTypeRendering) => T;
-export declare const getTypeFormattingFromColumn: (column: ColumnDescriptor) => ColumnTypeFormatting;
-/**
- * Check that columnDescriptors are included in provided list of subscribec column names (unless they
- * atr 'client side' columns).
- */
-export declare const assertAllColumnsAreIncludedInSubscription: (columns: readonly ColumnDescriptor[], columnNames: string[]) => void;
-/**
- * Return a filter predicate that will reject columns, names of which
- * are not in provided list. Exception made for columns explicitly
- * configured as client columns.
- */
-export declare const subscribedOnly: (columnNames?: string[]) => (column: ColumnDescriptor) => boolean | undefined;
-/**
- * Called from TableSettings.ColumnList when a column is added to subscription.
- *
- * @param subscribedColumns
- * @param availableColumns
- * @param columnName
- * @returns
- */
-export declare const addColumnToSubscribedColumns: (subscribedColumns: readonly ColumnDescriptor[], availableColumns: readonly SchemaColumn[], columnName: string) => ColumnDescriptor[];
-export declare function getServerDataType(column: ColumnDescriptor): VuuColumnDataType | undefined;
-export declare function getServerDataType(column: ColumnDescriptor, throwIfUndefined: true): VuuColumnDataType;
-export declare const isCalculatedColumn: (columnName?: string) => boolean;
-export declare const getCalculatedColumnDetails: (column: ColumnDescriptor | string) => Partial<CalculatedColumn>;
-export declare const setCalculatedColumnName: (column: ColumnDescriptor, name: string) => ColumnDescriptor;
-export declare const setCalculatedColumnType: (column: ColumnDescriptor, serverDataType: VuuColumnDataType) => ColumnDescriptor;
-export declare const setCalculatedColumnExpression: (column: ColumnDescriptor, expression: string) => ColumnDescriptor;
-export declare const moveColumnTo: (columns: ColumnDescriptor[], column: ColumnDescriptor, newIndex: number) => ColumnDescriptor[];
-export declare function replaceColumn<C extends ColumnDescriptor = RuntimeColumnDescriptor>(columns: readonly C[], column: C): C[];
-export declare const applyDefaultColumnConfig: ({ columns: columnsProp, table }: TableSchema, getDefaultColumnConfig?: DefaultColumnConfiguration, includeVuuDefaultColumns?: boolean) => (SchemaColumn | {
-    aggregate?: VuuAggType;
-    align?: ColumnAlignment;
-    allowColumnHeaderMenu?: false;
-    className?: string;
-    colHeaderContentRenderer?: string;
-    colHeaderLabelRenderer?: string;
-    exportFormatter?: (value: unknown) => string;
-    flex?: number;
-    getIcon?: (row: DataRow) => string | undefined;
-    groupable?: boolean;
-    heading?: string[];
-    hidden?: boolean;
-    isSystemColumn?: boolean;
-    locked?: Exclude<PinLocation, "left"> | false;
-    maxWidth?: number;
-    minWidth?: number;
-    pin?: PinLocation | false;
-    removeable?: boolean;
-    resizeable?: boolean;
-    selected?: boolean;
-    sortable?: boolean;
-    source?: "client" | "server";
-    status?: import("@salt-ds/core").ValidationStatus;
-    width?: number;
-    editableBulk?: import("@vuu-ui/vuu-data-types").BulkEdit;
-    label?: string;
-    required?: boolean;
-    type?: DataValueType;
-    editable?: import("@vuu-ui/vuu-data-types").DataEditable | undefined;
-    name: string;
-    serverDataType: VuuColumnDataType;
-})[] | readonly SchemaColumn[];
-export type columnOptions = {
-    availableWidth?: number;
-    columnLayout?: ColumnLayout;
-    defaultWidth?: number;
-    defaultMinWidth?: number;
-    defaultMaxWidth?: number;
-    defaultFlex?: number;
-};
-type ColumnLayoutOptions = Pick<columnOptions, "defaultMinWidth" | "defaultMaxWidth" | "defaultWidth">;
-interface StaticColumnLayoutOptions extends ColumnLayoutOptions {
-    columnLayout: "manual" | "static";
-}
-interface FitColumnLayoutOptions extends ColumnLayoutOptions {
-    availableWidth?: number;
-    columnLayout: "fit";
-}
-export declare function applyWidthToColumns(columns: RuntimeColumnDescriptor[], options: StaticColumnLayoutOptions | FitColumnLayoutOptions): RuntimeColumnDescriptor[];
-/**
- * A memo compare function for cell renderers. Can be used to suppress
- * render where column and data are both unchanged. Avoids render
- * when row changes, where changes in row are unrelated to this cell.
- * Suitabnle only for readonly cell renderers. See below for editable
- * cell renderers.
- */
-export declare const dataAndColumnUnchanged: (p: TableCellRendererProps, p1: TableCellRendererProps) => boolean;
-/**
- * A memo compare function for cell renderers. Can be used to suppress
- * render where column, row key  and data are all unchanged. Avoids render
- * when row changes, where changes in row are unrelated to this cell.
- * Suitable for editable cells. Including key in compare is not strictly
- * necessary for rendering, but it is important in the event that user
- * edits data - ensures we never have a stale key.
- */
-export declare const dataColumnAndKeyUnchanged: (p: TableCellRendererProps, p1: TableCellRendererProps) => boolean;
-export declare const toColumnName: (column: ColumnDescriptor) => string;
-export declare const isStringColumn: (column: ColumnDescriptor) => boolean;
-export declare const columnByAriaIndex: (columns: RuntimeColumnDescriptor[], ariaColIndex: number) => RuntimeColumnDescriptor;
-export {};

package/types/src/common-types.d.ts

@@ -1,6 +0,0 @@
-export type orientationType = "horizontal" | "vertical";
-type measureProp = keyof DOMRect;
-type measureType = Record<string, measureProp>;
-type measuresType = Record<orientationType, measureType>;
-export declare const MEASURES: measuresType;
-export {};

package/types/src/component-registry.d.ts

@@ -1,65 +0,0 @@
-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";
-export interface CellConfigPanelProps extends HTMLAttributes<HTMLDivElement> {
-    onConfigChange: () => void;
-}
-export type PropertyChangeHandler = (propertyName: string, propertyValue: string | number | boolean) => void;
-export type ColumnRenderPropsChangeHandler = (renderProps: ColumnTypeRendering) => void;
-export interface ConfigurationEditorProps {
-    column: ColumnDescriptorCustomRenderer;
-    onChangeRendering: ColumnRenderPropsChangeHandler;
-}
-export type RowClassNameGenerator = (dataRow: DataRow) => string | undefined;
-export type RowClassGenerator = {
-    id: string;
-    fn: RowClassNameGenerator;
-};
-export type ConfigEditorComponent = FC<CellConfigPanelProps>;
-export type layoutComponentType = "container" | "view";
-export type ComponentType = layoutComponentType | "cell-renderer" | "cell-config-panel" | "column-header-content-renderer" | "column-header-label-renderer" | "component" | "data-edit-validator" | "row-class-generator";
-/**
- * The CellRenderer Options provide configuration for the Column Settings panel
- */
-type CellRendererOptions = {
-    configEditor?: string;
-    description?: string;
-    label?: string;
-    serverDataType?: VuuColumnDataType | VuuColumnDataType[] | "json" | "private";
-    userCanAssign?: boolean;
-};
-export interface CellRendererDescriptor extends CellRendererOptions {
-    name: string;
-}
-/**
- * This check is performed during construction of UI from JSON. If component
- * is not registered, it will log a warning.
- */
-export declare const isContainer: (componentType: string) => boolean;
-/**
- * This check is performed during construction of UI from JSON. If component
- * is not registered, it will log a warning.
- */
-export declare const isView: (componentType: string) => boolean;
-/**
- * This check is performed during construction of UI from JSON. If component
- * is not registered, it will log a warning.
- */
-export declare const isLayoutComponent: (componentType: string) => componentType is layoutComponentType;
-export declare function registerComponent(componentName: string, component: RowClassGenerator, componentType: "row-class-generator", options?: CellRendererOptions): void;
-export declare function registerComponent(componentName: string, component: EditRuleValidator, componentType: "data-edit-validator", options?: CellRendererOptions): void;
-export declare function registerComponent(componentName: string, component: FC<any>, componentType: Omit<ComponentType, "data-edit-validator" | "row-class-generator">, options?: CellRendererOptions): void;
-export declare const registerConfigurationEditor: (componentName: string, configurationEditor: FC<ConfigurationEditorProps>) => void;
-type CellRendererDataType = VuuColumnDataType | "json";
-export declare const getRegisteredCellRenderers: (cellRendererDataType?: CellRendererDataType) => CellRendererDescriptor[];
-export declare const getLayoutComponent: (componentName: string) => FC<any>;
-export declare const getCellRendererOptions: (renderName: string) => CellRendererOptions | undefined;
-export declare function getCellRenderer(column: ColumnDescriptor): FC<TableCellRendererProps> | undefined;
-export declare function getColumnHeaderContentRenderer(column: ColumnDescriptor): FC<Omit<HeaderCellProps, "id" | "index">> | undefined;
-export declare function getColumnHeaderLabelRenderer(column: ColumnDescriptor): FC<Omit<HeaderCellProps, "id" | "index">> | undefined;
-export declare const getRowClassNameGenerator: (generatorId: string) => RowClassGenerator | undefined;
-export declare function getConfigurationEditor(configEditor?: string): FC<ConfigurationEditorProps> | undefined;
-export declare function getCellConfigPanelRenderer(name: string): ConfigEditorComponent | undefined;
-export declare function getEditRuleValidator(name: string): EditRuleValidator | undefined;
-export {};

package/types/src/context-definitions/DataContext.d.ts

@@ -1,21 +0,0 @@
-import type { DataSource, DataSourceConstructorProps, ServerAPI, TableSchema } from "@vuu-ui/vuu-data-types";
-export type DataSourceConstructor = {
-    new (props: DataSourceConstructorProps): DataSource;
-};
-export interface DataContextProps {
-    VuuDataSource: DataSourceConstructor;
-    isLocalData: boolean;
-    getServerAPI: () => Promise<Pick<ServerAPI, "getTableList" | "getTableSchema" | "rpcCall">>;
-    /**
-     * A tableSchema would normally be requested via the serverAPI.
-     * schemas can be injected, in which case these 'local' schemas
-     * will be returned from the getTableSchema API call.
-     * The key is formed from concatenation of module and tableName
-     * from VuuTable e.g 'SIMUL:instruments'
-     */
-    tableSchemas?: Record<string, TableSchema>;
-}
-export declare class NullDataSourceConstructor {
-    constructor(_: DataSourceConstructorProps);
-}
-export declare const DataContext: import("react").Context<DataContextProps>;

package/types/src/context-definitions/DataProvider.d.ts

@@ -1,7 +0,0 @@
-import { ReactNode } from "react";
-import { DataContextProps } from "./DataContext";
-export declare const DataProvider: ({ children, getServerAPI, isLocalData, VuuDataSource, }: Omit<DataContextProps, "isLocalData"> & {
-    children: ReactNode;
-    isLocalData?: boolean;
-}) => import("react").JSX.Element;
-export declare const useData: () => DataContextProps;

package/types/src/context-definitions/DataSourceProvider.d.ts

@@ -1,12 +0,0 @@
-import { DataSource } from "@vuu-ui/vuu-data-types";
-import { ReactNode } from "react";
-export interface DataSourceContextProps {
-    dataSource?: DataSource;
-}
-export declare const DataSourceContext: import("react").Context<DataSourceContextProps>;
-export declare const DataSourceProvider: ({ children, dataSource, }: {
-    children: ReactNode;
-    dataSource: DataSource;
-}) => import("react").JSX.Element;
-export declare function useDataSource(throwIfNoDataSource: true): DataSource;
-export declare function useDataSource(throwIfNoDataSource: false | undefined): DataSource | undefined;

package/types/src/context-definitions/WorkspaceContext.d.ts

@@ -1,17 +0,0 @@
-import React from "react";
-import { ApplicationSetting, ApplicationSettings, LayoutJSON } from "../json-types";
-import { LayoutMetadata, LayoutMetadataDto } from "../layout-types";
-export interface WorkspaceContextProps {
-    layoutMetadata: LayoutMetadata[];
-    layoutPlaceholderJSON?: LayoutJSON;
-    getApplicationSettings: (key?: keyof ApplicationSettings) => ApplicationSettings | ApplicationSetting | undefined;
-    loadLayoutById: (id: string) => void;
-    saveApplicationSettings: (settings: ApplicationSettings | ApplicationSetting, key?: keyof ApplicationSettings) => void;
-    saveLayout: (n: LayoutMetadataDto) => void;
-    saveApplicationLayout: (layout: LayoutJSON) => void;
-    workspaceJSON?: LayoutJSON | LayoutJSON[];
-}
-export declare const WorkspaceContext: React.Context<WorkspaceContextProps>;
-export declare const usePlaceholderJSON: () => LayoutJSON<{
-    [key: string]: any;
-}> | undefined;

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

@@ -1,9 +0,0 @@
-export declare const getCookieValue: (name: string) => string | undefined;
-/**
- * Sets a cookie value.
- *
- * @param {string} name - Cookie name
- * @param {string} value - Cookie value
- * @param {number} [days] - Optional: number of days until the cookie expires
- */
-export declare function setCookieValue(name: string, value: string, days?: number): void;

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

@@ -1 +0,0 @@
-export declare const importCSS: (path: string) => Promise<CSSStyleSheet>;

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

@@ -1,33 +0,0 @@
-import { DataValueDescriptor } from "@vuu-ui/vuu-data-types";
-export type valueChangeDirection = "up1" | "up2" | "down1" | "down2" | "";
-export declare const UP1 = "up1";
-export declare const UP2 = "up2";
-export declare const DOWN1 = "down1";
-export declare const DOWN2 = "down2";
-export declare const stringIsValidInt: (val: string) => boolean;
-export declare const stringIsValidLong: (val: string) => boolean;
-export declare const stringIsValidDecimal: (val: string) => boolean;
-export declare const stringIsValidNumber: (val: string) => boolean;
-export declare const numericTypeOfStringValue: (val: string) => "NaN" | "double" | "int";
-export declare const isValidNumber: (n: unknown) => n is number;
-export declare const shallowEquals: (o1?: {
-    [key: string]: unknown;
-}, o2?: {
-    [key: string]: unknown;
-}) => boolean;
-export declare function getMovingValueDirection(newValue?: number, direction?: valueChangeDirection, prevValue?: number, 
-/** the number of decimal places to take into account when highlighting a change  */
-decimalPlaces?: number): valueChangeDirection;
-/**
- * Convert a value to integer.
- * If value is a number, remove any decimals.
- * If value is a string, parse as integer. If NaN,
- * return defaultValue else throw.
- * If value is integer numeric, return value.
- *
- * @param value
- * @param defaultValue
- * @returns
- */
-export declare function asInteger(value: number | string | undefined, defaultValue?: number): number;
-export declare const dataDescriptorTypeToVuuRowDataItemType: ({ serverDataType, }: DataValueDescriptor) => "string" | "number" | "boolean";

package/types/src/datasource/BaseDataSource.d.ts

@@ -1,63 +0,0 @@
-import type { DataSource, DataSourceConstructorProps, DataSourceEvents, DataSourceFilter, DataSourceSubscribeCallback, DataSourceSubscribeProps, DataSourceSuspenseProps, WithBaseFilter, WithFullConfig } from "@vuu-ui/vuu-data-types";
-import { LinkDescriptorWithLabel, VuuAggregation, VuuRange, VuuSort } from "@vuu-ui/vuu-protocol-types";
-import { EventEmitter } from "../event-emitter";
-import { Range } from "../range-utils";
-import { Filter } from "@vuu-ui/vuu-filter-types";
-export type ConfigWithVisualLink = WithBaseFilter<WithFullConfig> & {
-    visualLink?: LinkDescriptorWithLabel;
-};
-export declare const defaultSuspenseProps: DataSourceSuspenseProps;
-export declare abstract class BaseDataSource extends EventEmitter<DataSourceEvents> implements Pick<DataSource, "config"> {
-    #private;
-    viewport: string;
-    protected _clientCallback: DataSourceSubscribeCallback | undefined;
-    protected _configWithVisualLink: ConfigWithVisualLink;
-    protected _impendingConfigWithVisualLink: ConfigWithVisualLink | undefined;
-    protected _range: Range;
-    protected _size: number;
-    protected _title: string | undefined;
-    protected _defaultSuspenseProps: DataSourceSuspenseProps;
-    private awaitingConfirmationOfConfigChanges;
-    constructor({ aggregations, baseFilterSpec, columns, filterSpec, groupBy, sort, suspenseProps, title, viewport, }: Omit<DataSourceConstructorProps, "table">);
-    subscribe({ baseFilterSpec, columns, aggregations, range, sort, groupBy, filterSpec, viewport, }: DataSourceSubscribeProps, callback: DataSourceSubscribeCallback): void;
-    get aggregations(): VuuAggregation[];
-    set aggregations(aggregations: VuuAggregation[]);
-    get baseFilter(): DataSourceFilter | undefined;
-    set baseFilter(baseFilter: DataSourceFilter | undefined);
-    get columns(): string[];
-    set columns(columns: string[]);
-    get filter(): DataSourceFilter;
-    set filter(filter: DataSourceFilter);
-    setFilter(filter: Filter): void;
-    clearFilter(): void;
-    get isAwaitingConfirmationOfConfigChange(): boolean;
-    protected confirmConfigChange(): void;
-    get config(): WithBaseFilter<WithFullConfig>;
-    set config(config: WithBaseFilter<WithFullConfig>);
-    get impendingConfig(): undefined | WithBaseFilter<WithFullConfig>;
-    /**
-     * This can be set by subclass in cases where we want to await ACK of async request
-     * before we go ahead and apply change to config.
-     * It is set in place of 'config' itself and it is then the responsibility of the client
-     * to call 'confirmConfigChange' once confirmation of the change is received.
-     * Client can check 'isAwaitingConfirmationOfConfigChange' to see if a change is pending
-     * confirmation.
-     */
-    set impendingConfig(config: undefined | WithBaseFilter<WithFullConfig>);
-    get pageCount(): number;
-    set pageCount(pageCount: number);
-    get range(): Range;
-    set range(range: Range);
-    get size(): number;
-    set size(size: number);
-    get sort(): VuuSort;
-    set sort(sort: VuuSort);
-    get title(): string;
-    set title(title: string);
-    private applyConfig;
-    freeze(): void;
-    unfreeze(): void;
-    get freezeTimestamp(): number | undefined;
-    get isFrozen(): boolean;
-    abstract rangeRequest(range: VuuRange): void;
-}

package/types/src/datasource/datasource-action-utils.d.ts

@@ -1,7 +0,0 @@
-import { DataSourceMenusMessage, DataSourceVisualLinkCreatedMessage, DataSourceVisualLinkRemovedMessage, DataSourceVisualLinksMessage, VuuFeatureMessage } from "@vuu-ui/vuu-data-types";
-import { GridAction } from "@vuu-ui/vuu-table-types";
-export declare const isVisualLinksAction: (action: GridAction) => action is DataSourceVisualLinksMessage;
-export declare const isVisualLinkCreatedAction: (action: GridAction) => action is DataSourceVisualLinkCreatedMessage;
-export declare const isVisualLinkRemovedAction: (action: GridAction) => action is DataSourceVisualLinkRemovedMessage;
-export declare const isViewportMenusAction: (action: GridAction) => action is DataSourceMenusMessage;
-export declare const isVuuFeatureAction: (action: GridAction) => action is VuuFeatureMessage;

package/types/src/datasource/datasource-filter-utils.d.ts

@@ -1,2 +0,0 @@
-import { WithBaseFilter, WithFullConfig } from "@vuu-ui/vuu-data-types";
-export declare const combineFilters: ({ baseFilterSpec, filterSpec, ...config }: WithBaseFilter<WithFullConfig>) => WithFullConfig;

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

@@ -1,61 +0,0 @@
-import type { ConnectionQualityMetrics, DataSourceCallbackMessage, DataSourceConfig, DataSourceDataMessage, DataSourceRow, DataSourceVisualLinksMessage, TypeaheadSuggestionProvider, VuuUIMessageIn, VuuUIMessageInRPC, VuuUIMessageInTableMeta, VuuUIMessageOutViewport, WithBaseFilter, WithFilter, WithFullConfig, WithGroupBy, WithSort } from "@vuu-ui/vuu-data-types";
-import type { LinkDescriptorWithLabel, VuuColumns, VuuCreateVisualLink, VuuFilter, VuuRemoveVisualLink, VuuRowDataItemType, VuuSort, VuuTable } from "@vuu-ui/vuu-protocol-types";
-import type { ColumnMap } from "../column-utils";
-import type { ConfigWithVisualLink } from "./BaseDataSource";
-export declare const NoFilter: VuuFilter;
-export declare const NoSort: VuuSort;
-export declare const vanillaConfig: WithFullConfig;
-/**
- * Derive the config for a session (edit) datasource from the source (view) datasource config.
- * When the edit table declares its own columns, the view config's filter, groupBy, sort and
- * aggregations are discarded rather than inherited - they may reference view-only columns.
- */
-export declare const sessionDataSourceConfig: (sourceConfig: WithFullConfig, overrideColumns?: VuuColumns) => WithFullConfig;
-/**
- * The session table name is server generated, so only the module is compared.
- */
-export declare const assertExpectedSessionTable: (sessionTable: VuuTable, expectedTable?: VuuTable) => void;
-export declare const stripVisualLink: (configWithVisualLink: ConfigWithVisualLink) => WithBaseFilter<WithFullConfig>;
-export type DataSourceConfigChanges = {
-    aggregationsChanged: boolean;
-    baseFilterChanged: boolean;
-    columnsChanged: boolean;
-    filterChanged: boolean;
-    groupByChanged: boolean;
-    sortChanged: boolean;
-    visualLinkChanged: boolean;
-};
-export type MaybeDataSourceConfigChanges = DataSourceConfigChanges & {
-    noChanges: boolean;
-};
-type DataConfigPredicate = (config: WithBaseFilter<DataSourceConfig>, newConfig: WithBaseFilter<DataSourceConfig>) => boolean;
-export declare const isBaseFilterChanged: DataConfigPredicate;
-export declare const isFilterChanged: DataConfigPredicate;
-export declare const isGroupByChanged: DataConfigPredicate;
-export declare const NO_CONFIG_CHANGES: MaybeDataSourceConfigChanges;
-export declare const isConfigChanged: (config: DataSourceConfig | undefined, newConfig: DataSourceConfig | undefined) => MaybeDataSourceConfigChanges;
-export declare const hasGroupBy: (config?: WithBaseFilter<DataSourceConfig>) => config is WithGroupBy;
-export declare const hasBaseFilter: (config?: WithBaseFilter<DataSourceConfig>) => config is WithFilter;
-export declare const hasFilter: (config?: DataSourceConfig) => config is WithFilter;
-export declare const hasSort: (config?: DataSourceConfig) => config is WithSort;
-export declare const isTypeaheadSuggestionProvider: (source: unknown) => source is TypeaheadSuggestionProvider;
-export declare const isTableSchemaMessage: (message: VuuUIMessageIn) => message is VuuUIMessageInTableMeta;
-export declare const isConnectionQualityMetrics: (msg: object) => msg is ConnectionQualityMetrics;
-export declare const messageHasResult: (msg: object) => msg is VuuUIMessageInRPC;
-export declare const isVisualLinkMessage: (msg: unknown) => msg is VuuCreateVisualLink | VuuRemoveVisualLink;
-export declare const isVisualLinksMessage: (msg: unknown) => msg is DataSourceVisualLinksMessage;
-export declare const isViewportMessage: (msg: object) => msg is VuuUIMessageOutViewport;
-export type DataSourceDataMessageWithRows = Omit<DataSourceDataMessage, "rows"> & {
-    rows: DataSourceRow[];
-};
-export type DataSourceDataMessageWithSize = Omit<DataSourceDataMessage, "size"> & {
-    size: number;
-};
-export declare const messageHasDataRows: (message: DataSourceCallbackMessage) => message is DataSourceDataMessageWithRows;
-export declare const messageHasSize: (message: DataSourceCallbackMessage) => message is DataSourceDataMessageWithSize;
-export declare const withConfigDefaults: (config: WithBaseFilter<DataSourceConfig>) => WithBaseFilter<WithFullConfig> & {
-    visualLink?: LinkDescriptorWithLabel;
-};
-export type Entity = Record<string, VuuRowDataItemType>;
-export declare const dataSourceRowToEntity: <T extends Entity = Entity>(row: DataSourceRow, columnMap: ColumnMap) => T;
-export {};

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

@@ -1,39 +0,0 @@
-import { CalendarDate } from "@internationalized/date";
-export declare function toCalendarDate(d: Date): CalendarDate;
-export type oneToFive = 1 | 2 | 3 | 4 | 5;
-export type zeroToFive = 0 | oneToFive;
-export type sixToNine = 6 | 7 | 8 | 9;
-export type zeroToNine = zeroToFive | sixToNine;
-export type oneToNine = oneToFive | sixToNine;
-export type TimeUnit = "hours" | "minutes" | "seconds";
-export type Hours = `${0 | 1}${zeroToNine}` | `2${0 | 1 | 2 | 3}`;
-export type Minutes = `${zeroToFive}${zeroToNine}`;
-export type Seconds = `${zeroToFive}${zeroToNine}`;
-export type TimeUnitValue<T extends TimeUnit> = T extends "hours" ? Hours : T extends "minutes" ? Minutes : Seconds;
-export type TimeString = `${number}${number}:${number}${number}:${number}${number}`;
-type YYYY = `19${zeroToNine}${zeroToNine}` | `20${zeroToNine}${zeroToNine}`;
-type MM = `0${oneToNine}` | `1${0 | 1 | 2}`;
-type DD = `${0}${oneToNine}` | `${1 | 2}${zeroToNine}` | `3${0 | 1}`;
-export type DateStringISO = `${YYYY}-${MM}-${DD}`;
-export declare const zeroTime: TimeString;
-export declare const zeroTimeUnit: TimeUnitValue<TimeUnit>;
-export declare function incrementTimeUnitValue<T extends TimeUnit>(unit: T, value: TimeUnitValue<T>): TimeUnitValue<T> | Hours;
-export declare function decrementTimeUnitValue<T extends TimeUnit>(unit: T, value: TimeUnitValue<T>): TimeUnitValue<T> | Hours;
-export declare function updateTimeString<T extends TimeUnit>(timeString: TimeString, unit: T, value: TimeUnitValue<T>): TimeString;
-export declare const isValidTimeString: (value: unknown) => value is TimeString;
-export declare function asTimeString(value: unknown, allowUndefined: false): TimeString;
-export declare function asTimeString(value: unknown, allowUndefined?: true): TimeString | undefined;
-export interface Time {
-    hours: number;
-    minutes: number;
-    seconds: number;
-    asDate: (date?: Date | DateStringISO) => Date;
-}
-export declare function Time(timeString: TimeString): Time;
-export declare namespace Time {
-    export var millisToTimeString: (timestamp: number) => TimeString;
-    var _a: (hours: number, minutes: number, seconds: number) => TimeString;
-    export { _a as toString };
-    export var isDateInMillis: (dtInMillis: string | number) => boolean;
-}
-export {};

package/types/src/date/dateTimePattern.d.ts

@@ -1,8 +0,0 @@
-import { DateTimeDataValueDescriptor } from "@vuu-ui/vuu-data-types";
-import { DateTimePattern } from "./types";
-export declare const defaultPatternsByType: {
-    readonly time: "hh:mm:ss";
-    readonly date: "dd.mm.yyyy";
-};
-export declare const fallbackDateTimePattern: DateTimePattern;
-export declare function dateTimePattern(type: DateTimeDataValueDescriptor["type"]): DateTimePattern;

package/types/src/date/formatter.d.ts

@@ -1,9 +0,0 @@
-import { DateFormatter } from "@internationalized/date";
-import { DateTimePattern } from "./types";
-type DateTimeFormatConfig = {
-    locale: string;
-    options: Intl.DateTimeFormatOptions;
-};
-export declare function getDateFormatter({ locale, options }: DateTimeFormatConfig): DateFormatter;
-export declare function formatDate(pattern: DateTimePattern): (d: Date) => string;
-export {};

package/types/src/date/index.d.ts

@@ -1,4 +0,0 @@
-export { asTimeString, decrementTimeUnitValue, incrementTimeUnitValue, isValidTimeString, Time, toCalendarDate, type DateStringISO, type Hours, type Minutes, type Seconds, type TimeString, type TimeUnit, type TimeUnitValue, updateTimeString, zeroTime, zeroTimeUnit, } from "./date-utils";
-export { dateTimePattern, defaultPatternsByType, fallbackDateTimePattern, } from "./dateTimePattern";
-export * from "./formatter";
-export { dateTimeLabelByType, isDatePattern, isTimePattern, supportedDateTimePatterns, type DatePattern, type DateTimePattern, type TimePattern, } from "./types";