@vuu-ui/vuu-table-extras 3.3.8 → 3.3.10

package/types/src/column-picker/useTableColumnPickerDeprecated.d.ts

@@ -0,0 +1,14 @@
+import type { DataSource } from "@vuu-ui/vuu-data-types";
+import { ColumnDescriptor, TableConfigChangeHandler } from "@vuu-ui/vuu-table-types";
+export type TableColumnChangeHandler = (columns: ColumnDescriptor[], change: unknown) => void;
+export interface ColumnPickerHookProps {
+    readonly availableColumns: ColumnDescriptor[];
+    dataSource: DataSource;
+    readonly selectedColumns: ColumnDescriptor[];
+    onTableColumnChange?: TableColumnChangeHandler;
+}
+export declare const useTableColumnPickerDeprecated: ({ availableColumns, dataSource, onTableColumnChange, selectedColumns: initialSelectedColumns, }: ColumnPickerHookProps) => {
+    onTableConfigChange: TableConfigChangeHandler;
+    showColumnPicker: (title?: string) => void;
+    selectedColumns: ColumnDescriptor[];
+};

package/types/src/column-settings-panel/ColumnNameLabel.d.ts

@@ -0,0 +1,7 @@
+import { ColumnDescriptor } from "@vuu-ui/vuu-table-types";
+import { MouseEventHandler } from "react";
+export interface ColumnNameLabelProps {
+    column: ColumnDescriptor;
+    onClick?: MouseEventHandler;
+}
+export declare const ColumnNameLabel: ({ column, onClick }: ColumnNameLabelProps) => import("react").JSX.Element;

package/types/src/column-settings-panel/ColumnSettingsPanel.d.ts

@@ -0,0 +1,5 @@
+import { ColumnSettingsProps } from "./useColumnSettings";
+export interface ColumnSettinsPanelProps extends ColumnSettingsProps {
+    onClickEditCalculatedColumn?: () => void;
+}
+export declare const ColumnSettingsPanel: ({ column: columnProp, columnModel, onClickEditCalculatedColumn, onConfigChange, }: ColumnSettinsPanelProps) => import("react").JSX.Element;

package/types/src/column-settings-panel/useColumnSettings.d.ts

@@ -0,0 +1,30 @@
+import { ColumnDescriptor, TableConfig, ColumnTypeFormatting } from "@vuu-ui/vuu-table-types";
+import { CellRendererDescriptor, ColumnRenderPropsChangeHandler } from "@vuu-ui/vuu-utils";
+import { VuuColumnDataType, VuuTable } from "@vuu-ui/vuu-protocol-types";
+import { FormEventHandler } from "react";
+import { DataValueTypeSimple } from "@vuu-ui/vuu-data-types";
+import { ColumnModel } from "../column-picker/ColumnModel";
+/**
+ * Describes the props for a Column Configuration Editor, for which
+ * an implementation is provided in vuu-table-extras
+ */
+export interface ColumnSettingsProps {
+    column: ColumnDescriptor;
+    columnModel: ColumnModel;
+    onConfigChange?: (config: TableConfig) => void;
+    vuuTable?: VuuTable;
+}
+export declare const useColumnSettings: ({ column: columnProp, columnModel, }: Omit<ColumnSettingsProps, "vuuTable">) => {
+    availableRenderers: CellRendererDescriptor[];
+    column: ColumnDescriptor;
+    navigateNextColumn: () => void;
+    navigatePrevColumn: () => void;
+    onChange: FormEventHandler;
+    onChangeCalculatedColumnName: (name: string) => void;
+    onChangeFormatting: (formatting: ColumnTypeFormatting) => void;
+    onChangeRendering: ColumnRenderPropsChangeHandler;
+    onChangeServerDataType: (serverDataType: VuuColumnDataType) => void;
+    onChangeToggleButton: FormEventHandler;
+    onChangeType: (type: DataValueTypeSimple) => void;
+    onInputCommit: () => void;
+};

package/types/src/csv-export/export-utils.d.ts

@@ -0,0 +1,42 @@
+import type { CopyOption, DataSource, SessionDataSourceOverrides } from "@vuu-ui/vuu-data-types";
+export type ExportColumnDescriptor<TName extends string = string> = {
+    name: TName;
+    /** Override the column name used as the CSV header label. */
+    label?: string;
+    exportFormatter?: (value: unknown) => string;
+};
+export interface ExportToCsvOptions<TName extends string = string> {
+    filename?: string;
+    copyOption?: CopyOption;
+    excludeColumns?: string[];
+    maxRows?: number;
+    columnDescriptors?: ExportColumnDescriptor<TName>[];
+    overrides?: SessionDataSourceOverrides;
+    /** Timeout in milliseconds before the export times out. Default: 30_000ms (0 to disable). */
+    timeout?: number;
+    onError?: (error: Error) => void;
+    onSuccess?: () => void;
+}
+export interface ExportCsvTemplateOptions {
+    filename?: string;
+    excludeColumns?: string[];
+    columns?: string[];
+    overrides?: SessionDataSourceOverrides;
+    /** Timeout in milliseconds before template generation times out. Default: 10_000ms (0 to disable). */
+    timeout?: number;
+    onError?: (error: Error) => void;
+    onSuccess?: () => void;
+}
+/** Downloads a single-row CSV containing only the column headers, for use as an import template. */
+export declare const exportCsvTemplate: (dataSource: DataSource, options?: ExportCsvTemplateOptions) => Promise<void>;
+/**
+ * Subscribes to `dataSource` (creating an export session data source if a view data source is passed),
+ * collects all rows in memory in index order, serialises them to CSV (excluding internal session columns),
+ * then triggers a browser download. The session data source is unsubscribed automatically once the download
+ * is initiated.
+ */
+export declare const exportSessionTableToCsv: <TName extends string = string>(dataSource: DataSource, options?: ExportToCsvOptions<TName>) => Promise<void>;
+/**
+ * Creates an export session table from `dataSource`, collects all rows in memory, then triggers a CSV download.
+ */
+export declare const exportToCsv: <TName extends string = string>(dataSource: DataSource, options?: ExportToCsvOptions<TName>) => Promise<void>;

package/types/src/csv-export/index.d.ts

@@ -0,0 +1,2 @@
+export { exportCsvTemplate, exportSessionTableToCsv, exportToCsv, type ExportColumnDescriptor, type ExportCsvTemplateOptions, type ExportToCsvOptions, } from "./export-utils";
+export { useCsvExport, type UseCsvExportProps, type UseCsvExportResult, } from "./useCsvExport";

package/types/src/csv-export/useCsvExport.d.ts

@@ -0,0 +1,14 @@
+import type { DataSource } from "@vuu-ui/vuu-data-types";
+import { type ExportCsvTemplateOptions, type ExportToCsvOptions } from "./export-utils";
+export interface UseCsvExportProps {
+    dataSource?: DataSource;
+    onError?: (error: Error) => void;
+    onSuccess?: () => void;
+}
+export interface UseCsvExportResult {
+    isExporting: boolean;
+    error: Error | null;
+    exportCsv: <TName extends string = string>(options?: ExportToCsvOptions<TName>, overrideDataSource?: DataSource) => Promise<void>;
+    exportTemplate: (options?: ExportCsvTemplateOptions, overrideDataSource?: DataSource) => Promise<void>;
+}
+export declare function useCsvExport(propsOrDataSource?: DataSource | UseCsvExportProps): UseCsvExportResult;

package/types/src/csv-upload/CsvUpload.d.ts

@@ -0,0 +1,68 @@
+import { type ReactNode } from "react";
+import type { RowDefaultDataItemValues, EditSession } from "@vuu-ui/vuu-data-editing";
+import type { CsvParseError, CsvParseOptions } from "./parse/csv-parse";
+import type { CsvValidationStructuredError } from "./parse/csv-schema-validation";
+import type { DataSource, TableSchema } from "@vuu-ui/vuu-data-types";
+import type { VuuTable } from "@vuu-ui/vuu-protocol-types";
+import type { CsvUploadTableData } from "./parse/csv-upload-utils";
+export type CsvUploadImportedResult = {
+    tableData: CsvUploadTableData;
+};
+export type CsvUploadPreviewResult = {
+    dataSource: DataSource;
+    editSession: EditSession;
+    tableData: CsvUploadTableData;
+};
+export type CsvUploadErrors = {
+    schemaError?: CsvUploadError;
+    validationError?: CsvUploadError;
+    importError?: CsvUploadError;
+};
+export type CsvUploadError = {
+    message: string;
+    parseError?: CsvParseError;
+    validationError?: CsvValidationStructuredError;
+    source: "schema" | "validation" | "import";
+};
+export type CsvUploadErrorResult = {
+    errors: CsvUploadErrors;
+};
+export type CsvUploadSessionTable = VuuTable;
+export type CsvUploadSessionEndReason = "saved" | "discarded" | "failed";
+export type CsvUploadSessionEndResult = {
+    reason: CsvUploadSessionEndReason;
+    sessionTable?: CsvUploadSessionTable;
+};
+export type CsvUploadPhase = "idle" | "processing" | "preview-ready" | "importing" | "imported" | "failed";
+export interface CsvUploadProps {
+    children?: ReactNode;
+    dataSource: DataSource;
+    embedded?: boolean;
+    /**
+     * Schema of the import table, where it differs from the target table. Used to validate
+     * the CSV and to determine the session datasource columns. If omitted and importTable is
+     * provided, the schema is fetched via getTableSchema. Pass a stable reference.
+     */
+    importSchema?: TableSchema;
+    /** Expected import table, used to validate the session table returned by the server. */
+    importTable?: VuuTable;
+    onImportSessionStarted?: (dataSource: DataSource) => void;
+    onImportSessionEnded?: (result: CsvUploadSessionEndResult) => void;
+    onError?: (result: CsvUploadErrorResult | undefined) => void;
+    onImported?: (result: CsvUploadImportedResult) => void;
+    onPreview?: (result: CsvUploadPreviewResult) => void;
+    onProcessingStarted?: () => void;
+    dialogTitle?: string;
+    maxRows?: number;
+    onCancel?: () => void;
+    onClose?: () => void;
+    open?: boolean;
+    parseOptions?: CsvParseOptions;
+    importMode?: "direct" | "preview";
+    rowDefaults?: RowDefaultDataItemValues;
+    /**
+     * Custom renderer for the error panel.
+     */
+    renderError?: (error: CsvUploadErrorResult) => ReactNode;
+}
+export declare const CsvUpload: (props: CsvUploadProps) => import("react").JSX.Element;

package/types/src/csv-upload/data-upload-preview/DataUploadPreview.d.ts

@@ -0,0 +1,10 @@
+import type { TableSchema } from "@vuu-ui/vuu-data-types";
+import { type EditSession } from "@vuu-ui/vuu-data-editing";
+import type { HTMLAttributes } from "react";
+export interface DataUploadPreviewProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    editSession: EditSession;
+    onClose: () => void;
+    saveLabel?: string;
+    tableSchema: TableSchema;
+}
+export declare const DataUploadPreview: ({ className, editSession, onClose, saveLabel, tableSchema, ...htmlAttributes }: DataUploadPreviewProps) => import("react").JSX.Element;

package/types/src/csv-upload/data-upload-preview/useDataUploadPreview.d.ts

@@ -0,0 +1,17 @@
+import type { DataSource } from "@vuu-ui/vuu-data-types";
+import type { EditSession } from "@vuu-ui/vuu-data-editing";
+export interface UseDataUploadPreviewProps {
+    dataSource: DataSource;
+    editSession: EditSession;
+    onClose: () => void;
+}
+export declare const getSessionDataSource: (editSession: EditSession) => DataSource;
+export declare const useDataUploadPreview: ({ dataSource, editSession, onClose, }: UseDataUploadPreviewProps) => {
+    canCancel: boolean;
+    canSave: boolean;
+    hasSelection: boolean;
+    onCancel: () => Promise<void>;
+    onDelete: () => Promise<import("@vuu-ui/vuu-protocol-types").RpcResult>;
+    onSave: (force?: boolean) => Promise<void>;
+    sessionError: string | undefined;
+};

package/types/src/csv-upload/index.d.ts

@@ -0,0 +1,7 @@
+export { CsvUpload, type CsvUploadError, type CsvUploadProps, type CsvUploadErrorResult, type CsvUploadErrors, type CsvUploadPhase, type CsvUploadImportedResult, type CsvUploadPreviewResult, type CsvUploadSessionEndReason, type CsvUploadSessionEndResult, type CsvUploadSessionTable, } from "./CsvUpload";
+export { useCsvUpload, type CsvUploadHookProps, type UseCsvUploadReturn, } from "./useCsvUpload";
+export { DataUploadPreview, type DataUploadPreviewProps, } from "./data-upload-preview/DataUploadPreview";
+export { validateCsvAgainstSchema, type CsvValidationOptions, type CsvValidationResult, } from "./parse/csv-schema-validation";
+export { parseCsv, type CsvParseOptions, type CsvParseResult, } from "./parse/csv-parse";
+export { CsvValidationErrorEnum, CsvParseErrorEnum, type CsvError, type CsvErrorMap, type CsvStructuredError, type CsvValidationError, type CsvValidationErrorMap, type CsvValidationErrorType, type CsvValidationStructuredError, type CsvParseError, type CsvParseErrorMap, } from "./parse/csv-errors";
+export { CSV_FIRST_DATA_ROW_NUMBER, CSV_HEADER_ROW_NUMBER, } from "./parse/csv-constants";

package/types/src/csv-upload/parse/csv-constants.d.ts

@@ -0,0 +1,3 @@
+export declare const CSV_HEADER_ROW_NUMBER = 1;
+export declare const CSV_FIRST_DATA_ROW_NUMBER = 2;
+export declare const MAX_ROWS_IN_CSV = 10000;

package/types/src/csv-upload/parse/csv-errors.d.ts

@@ -0,0 +1,46 @@
+export declare enum CsvParseErrorEnum {
+    EMPTY_FILE = "EMPTY_FILE",
+    INVALID_SEPARATOR = "INVALID_SEPARATOR",
+    INVALID_FORMAT = "INVALID_FORMAT",
+    UNQUOTED_VALUE = "UNQUOTED_VALUE",
+    EMPTY_HEADER_COLUMN = "EMPTY_HEADER_COLUMN",
+    DUPLICATE_HEADER_COLUMN = "DUPLICATE_HEADER_COLUMN",
+    ROW_COLUMN_COUNT_MISMATCH = "ROW_COLUMN_COUNT_MISMATCH"
+}
+export declare enum CsvValidationErrorEnum {
+    MISSING_KEY_COLUMN = "MISSING_KEY_COLUMN",
+    UNKNOWN_COLUMN = "UNKNOWN_COLUMN",
+    MAX_ROWS_EXCEEDED = "MAX_ROWS_EXCEEDED",
+    EMPTY_NON_STRING_VALUE = "EMPTY_NON_STRING_VALUE",
+    TYPE_MISMATCH = "TYPE_MISMATCH"
+}
+export type CsvErrorMap<TError extends string> = {
+    rowErrors: Record<number, Record<string, TError[]>>;
+    fileErrors: Record<string, TError[]>;
+};
+export type CsvStructuredError<TError extends string> = {
+    rowNum: number;
+    column: string;
+    value: string;
+    message: string;
+    errorEnum: TError;
+};
+export type CsvError<TError extends string> = {
+    errorMap: CsvErrorMap<TError>;
+    errors: CsvStructuredError<TError>[];
+    message: string;
+};
+export type CsvErrorState<TError extends string> = {
+    errorMap: CsvErrorMap<TError>;
+    errors: CsvStructuredError<TError>[];
+};
+export declare const createCsvErrorState: <TError extends string>() => CsvErrorState<TError>;
+export declare const addCsvFileError: <TError extends string>(state: CsvErrorState<TError>, columnName: string, error: TError, message: string, value?: string) => void;
+export declare const addCsvRowError: <TError extends string>(state: CsvErrorState<TError>, rowNum: number, columnName: string, error: TError, message: string, value?: string) => void;
+export declare const hasCsvErrors: <TError extends string>(errorMap: CsvErrorMap<TError>) => boolean;
+export type CsvParseErrorMap = CsvErrorMap<CsvParseErrorEnum>;
+export type CsvParseError = CsvError<CsvParseErrorEnum>;
+export type CsvValidationErrorType = CsvValidationErrorEnum | CsvParseErrorEnum;
+export type CsvValidationErrorMap = CsvErrorMap<CsvValidationErrorEnum>;
+export type CsvValidationStructuredError = CsvError<CsvValidationErrorType>;
+export type CsvValidationError = CsvStructuredError<CsvValidationErrorType>;

package/types/src/csv-upload/parse/csv-parse.d.ts

@@ -0,0 +1,11 @@
+import { type CsvParseError } from "./csv-errors";
+export { CsvParseErrorEnum, type CsvError, type CsvErrorMap, type CsvStructuredError, type CsvParseError, type CsvParseErrorMap, } from "./csv-errors";
+export type CsvParseResult = {
+    error?: CsvParseError;
+    header: string[];
+    rows: string[][];
+};
+export type CsvParseOptions = {
+    requireQuotedValues?: boolean;
+};
+export declare const parseCsv: (csvText: string, options?: CsvParseOptions) => CsvParseResult;

package/types/src/csv-upload/parse/csv-schema-validation.d.ts

@@ -0,0 +1,16 @@
+import type { TableSchema } from "@vuu-ui/vuu-data-types";
+import type { VuuRowDataItemType } from "@vuu-ui/vuu-protocol-types";
+import type { CsvValidationError, CsvValidationErrorMap, CsvParseError } from "./csv-errors";
+import type { CsvParseResult } from "./csv-parse";
+export { CsvValidationErrorEnum, type CsvValidationError, type CsvValidationErrorMap, type CsvValidationErrorType, type CsvValidationStructuredError, } from "./csv-errors";
+export type CsvValidationResult = {
+    columns: string[];
+    errorMap: CsvValidationErrorMap;
+    errors: CsvValidationError[];
+    parseRowError?: CsvParseError;
+    rows: Record<string, VuuRowDataItemType>[];
+};
+export type CsvValidationOptions = {
+    maxRows?: number;
+};
+export declare const validateCsvAgainstSchema: (parsed: CsvParseResult, tableSchema: TableSchema, options?: CsvValidationOptions) => CsvValidationResult;

package/types/src/csv-upload/parse/csv-upload-utils.d.ts

@@ -0,0 +1,21 @@
+import type { VuuRowDataItemType } from "@vuu-ui/vuu-protocol-types";
+import type { CsvUploadError } from "../CsvUpload";
+import type { CsvParseError } from "./csv-parse";
+import type { CsvValidationError, CsvValidationResult } from "./csv-schema-validation";
+export type CsvUploadTableData = {
+    columns: string[];
+    rows: VuuRowDataItemType[][];
+};
+export declare const toErrorMessage: (error: unknown) => string;
+export declare const isCsvParseError: (value: unknown) => value is CsvParseError;
+export declare const hasFileParseErrors: (parseError: CsvParseError) => boolean;
+export declare const createUploadError: (source: CsvUploadError["source"], message: string, parseError?: CsvParseError, validationError?: CsvUploadError["validationError"]) => CsvUploadError;
+export declare const mergeValidationWithParseErrors: (schemaValidation: CsvValidationResult, parseError: CsvParseError | undefined) => CsvValidationResult;
+export declare const buildRowErrorMessage: (prefix: string, rowErrors: string[]) => string;
+export declare const toValidationErrorsFromParseRowErrors: (parseError: CsvParseError) => CsvValidationError[];
+export declare const normalizeTableData: (value: unknown, fallback: CsvUploadTableData) => CsvUploadTableData;
+export type RpcBatchResult = {
+    errors: string[];
+    results: unknown[];
+};
+export declare const executeBatchRpcCalls: <T>(items: T[], executor: (item: T) => Promise<unknown>, errorFormatter: (item: T, error: string) => string) => Promise<RpcBatchResult>;

package/types/src/csv-upload/parse/index.d.ts

@@ -0,0 +1,5 @@
+export { CSV_FIRST_DATA_ROW_NUMBER, CSV_HEADER_ROW_NUMBER, } from "./csv-constants";
+export { CsvParseErrorEnum, CsvValidationErrorEnum, type CsvError, type CsvErrorMap, type CsvErrorState, type CsvParseError, type CsvParseErrorMap, type CsvStructuredError, type CsvValidationError, type CsvValidationErrorMap, type CsvValidationErrorType, type CsvValidationStructuredError, addCsvFileError, addCsvRowError, createCsvErrorState, hasCsvErrors, } from "./csv-errors";
+export { parseCsv, type CsvParseOptions, type CsvParseResult, } from "./csv-parse";
+export { validateCsvAgainstSchema, type CsvValidationOptions, type CsvValidationResult, } from "./csv-schema-validation";
+export { buildRowErrorMessage, executeBatchRpcCalls, hasFileParseErrors, isCsvParseError, mergeValidationWithParseErrors, normalizeTableData, toErrorMessage, toValidationErrorsFromParseRowErrors, type CsvUploadTableData, type RpcBatchResult, } from "./csv-upload-utils";

package/types/src/csv-upload/useCsvUpload.d.ts

@@ -0,0 +1,42 @@
+import type { DataSource, TableSchema } from "@vuu-ui/vuu-data-types";
+import { type RowDefaultDataItemValues } from "@vuu-ui/vuu-data-editing";
+import type { VuuTable } from "@vuu-ui/vuu-protocol-types";
+import { type CsvParseOptions } from "./parse/csv-parse";
+import { type CsvValidationResult } from "./parse/csv-schema-validation";
+import type { CsvUploadErrorResult, CsvUploadImportedResult, CsvUploadPreviewResult, CsvUploadSessionEndResult, CsvUploadSessionTable } from "./CsvUpload";
+export interface CsvUploadHookProps {
+    dataSource: DataSource;
+    importMode?: "direct" | "preview";
+    /**
+     * Schema of the import table, where it differs from the target table. Used to validate
+     * the CSV and to determine the session datasource columns. If omitted and importTable is
+     * provided, the schema is fetched via getTableSchema. Pass a stable reference.
+     */
+    importSchema?: TableSchema;
+    /** Expected import table, used to validate the session table returned by the server. */
+    importTable?: VuuTable;
+    maxRows?: number;
+    onImportSessionEnded?: (result: CsvUploadSessionEndResult) => void;
+    onImportSessionStarted?: (dataSource: DataSource) => void;
+    onError?: (result: CsvUploadErrorResult | undefined) => void;
+    onImported?: (result: CsvUploadImportedResult) => void;
+    onPreview?: (result: CsvUploadPreviewResult) => void;
+    onProcessingStarted?: () => void;
+    parseOptions?: CsvParseOptions;
+    /** Default column values applied to every addRow call. Pass a stable reference — a new object triggers EditSession recreation. */
+    rowDefaults?: RowDefaultDataItemValues;
+}
+export type UseCsvUploadReturn = {
+    canImport: boolean;
+    cancelImport: () => Promise<void>;
+    importData: () => Promise<boolean>;
+    isImporting: boolean;
+    isProcessingFile: boolean;
+    onDrop: (_event: React.DragEvent<HTMLDivElement>, files: File[]) => void;
+    onTriggerChange: (_event: React.ChangeEvent<HTMLInputElement>, files: File[]) => void;
+    sessionTable: CsvUploadSessionTable | undefined;
+    schema: TableSchema | undefined;
+    validation: CsvValidationResult | undefined;
+    error: CsvUploadErrorResult | undefined;
+};
+export declare const useCsvUpload: ({ dataSource, importMode, importSchema, importTable, onImportSessionEnded, onImportSessionStarted, onError, onImported, onPreview, onProcessingStarted, maxRows, parseOptions, rowDefaults, }: CsvUploadHookProps) => UseCsvUploadReturn;

package/types/src/datasource-stats/DatasourceStats.d.ts

@@ -0,0 +1,17 @@
+import { HTMLAttributes, ReactNode } from "react";
+import { DatasourceStatsHookProps } from "./useDatasourceStats";
+export type ItemLabel = string | {
+    singlular: string;
+    plural: string;
+};
+export interface DataSourceStatsProps extends DatasourceStatsHookProps, Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /**
+     * children will be displayed when selection present. Intended
+     * use case is display of action button(s) that will operate on
+     * selected rows.
+     */
+    children?: ReactNode;
+    selectionActions?: ReactNode;
+    tooltrayActions?: ReactNode;
+}
+export declare const DataSourceStats: ({ children, className, dataSource, showRowStats, tooltrayActions, ...htmlAttributes }: DataSourceStatsProps) => import("react").JSX.Element;

package/types/src/datasource-stats/useDatasourceStats.d.ts

@@ -0,0 +1,15 @@
+import { DataSource } from "@vuu-ui/vuu-data-types";
+import { Range } from "@vuu-ui/vuu-utils";
+export interface DatasourceStatsHookProps {
+    dataSource: DataSource;
+    showFreezeStatus?: boolean;
+    showRowStats?: boolean;
+    showSelectionStats?: boolean;
+}
+export declare const useDatasourceStats: ({ dataSource, }: DatasourceStatsHookProps) => {
+    range: Range;
+    selectedCount: number;
+    size: number;
+    freezeTime: string | undefined;
+    maxScroll: number;
+};

package/types/src/freeze-control/FreezeControl.d.ts

@@ -0,0 +1,15 @@
+import { type FreezeProps } from "./useFreezeControl";
+import { HTMLAttributes } from "react";
+export interface FreezeControlProps extends HTMLAttributes<HTMLDivElement>, FreezeProps {
+    /**
+     * Label shown when the table is frozen next to the new record badge.
+     * @default "New Orders"
+     */
+    newItemsLabel?: string;
+    /**
+     * Duration of the flash animation for the badge (in seconds).
+     * @default 0.25
+     */
+    flashDuration?: number;
+}
+export declare const FreezeControl: ({ dataSource, className, newItemsLabel, flashDuration, ...htmlAttributes }: FreezeControlProps) => import("react").JSX.Element;

package/types/src/freeze-control/FrozenBanner.d.ts

@@ -0,0 +1,6 @@
+import { HTMLAttributes } from "react";
+import { DataSource } from "@vuu-ui/vuu-data-types";
+export interface FrozenBannerProps extends HTMLAttributes<HTMLDivElement> {
+    dataSource: DataSource;
+}
+export declare const FrozenBanner: ({ dataSource, className, ...htmlAttributes }: FrozenBannerProps) => import("react").JSX.Element | null;

package/types/src/freeze-control/freezeControlBadge.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Calculates the badge value and overflow state for FreezeControl
+ * It should max at 99, and when this is exceeded show 99+
+ *
+ * @param newRecordCount - int of new records
+ * @returns An object with `badgeValue` (the displayed number, max 99) and `isOverflow` (whether count exceeds 99)
+ */
+export declare const calculateBadgeState: (newRecordCount: number) => {
+    badgeValue: number;
+    isOverflow: boolean;
+};

package/types/src/freeze-control/useFreezeControl.d.ts

@@ -0,0 +1,10 @@
+import { DataSource } from "@vuu-ui/vuu-data-types";
+import { SyntheticEvent } from "react";
+export interface FreezeProps {
+    dataSource: DataSource;
+}
+export declare const useFreezeControl: ({ dataSource }: FreezeProps) => {
+    isFrozen: boolean;
+    newRecordCount: number;
+    onToggleChange: (evt: SyntheticEvent<HTMLButtonElement>) => void;
+};

package/types/src/index.d.ts

@@ -0,0 +1,26 @@
+export { CalculatedColumnPanel } from "./calculated-column/CalculatedColumnPanel";
+export * from "./csv-export";
+export * from "./csv-upload";
+export * from "./cell-edit-validators";
+export * from "./cell-renderers";
+export * from "./column-expression-input";
+export * from "./column-formatting-settings";
+export type { ColumnDisplayActionHandler, TableSettingsActionHandler, } from "./column-menu/column-action-types";
+export { ColumnMenu } from "./column-menu/ColumnMenu";
+export { useColumnActions } from "./column-menu/useColumnActions";
+export { ColumnChangeSource, ColumnModel, isColumnAdded, isColumnRemoved, isColumnsReordered, SelectedColumnChangeType, type ColumnEvents, type ColumnsChangeHandler, } from "./column-picker/ColumnModel";
+export { ColumnPicker, type ColumnPickerProps, } from "./column-picker/ColumnPicker";
+export { ColumnPickerAction } from "./column-picker/ColumnPickerAction";
+export type { SelectedColumnsChangeHandler } from "./column-picker/useColumnPicker";
+export { useTableColumnPicker } from "./column-picker/useTableColumnPicker";
+export { ColumnSettingsPanel } from "./column-settings-panel/ColumnSettingsPanel";
+export { useColumnSettings } from "./column-settings-panel/useColumnSettings";
+export { DataSourceStats, type DataSourceStatsProps, } from "./datasource-stats/DatasourceStats";
+export { FreezeControl } from "./freeze-control/FreezeControl";
+export { FrozenBanner } from "./freeze-control/FrozenBanner";
+export * from "./inline-add-row";
+export { TabbedTableConfigPanel } from "./tabbed-table-config-panel/TabbedTableConfigPanel";
+export { TabbedTableSettingsAction } from "./tabbed-table-config-panel/TabbedTableSettingsAction";
+export { TableFooter, TableFooterTray } from "./table-footer/TableFooter";
+export { TableProvider, useTableContext } from "./table-provider/TableProvider";
+export { defaultTableSettingsPermissions, TableSettingsPanel, type TableDisplayAttributeChangeHandler, } from "./table-settings-panel/TableSettingsPanel";

package/types/src/inline-add-row/InlineAddRow.d.ts

@@ -0,0 +1,3 @@
+import type { BaseRowProps } from "@vuu-ui/vuu-table-types";
+export type InlineAddRowProps = BaseRowProps;
+export declare const InlineAddRow: ({ ariaRowIndex, className, columns, style, }: InlineAddRowProps) => import("react").JSX.Element;

package/types/src/inline-add-row/index.d.ts

@@ -0,0 +1,2 @@
+export { InlineAddRow, type InlineAddRowProps } from "./InlineAddRow";
+export { useInlineAddRow, type UseInlineAddRowProps } from "./useInlineAddRow";

package/types/src/inline-add-row/useInlineAddRow.d.ts

@@ -0,0 +1,59 @@
+import type { DataRow, RuntimeColumnDescriptor } from "@vuu-ui/vuu-table-types";
+export interface UseInlineAddRowProps {
+    columns: RuntimeColumnDescriptor[];
+}
+export declare const useInlineAddRow: ({ columns }: UseInlineAddRowProps) => {
+    containerRef: import("react").RefObject<HTMLDivElement | null>;
+    dataRow: DataRow;
+    draftRevision: number;
+    inlineAddColumns: {
+        editableBulk?: import("@vuu-ui/vuu-data-types").BulkEdit;
+        name: string;
+        required?: boolean;
+        serverDataType?: import("@vuu-ui/vuu-protocol-types").VuuColumnDataType;
+        type?: import("@vuu-ui/vuu-data-types").DataValueType;
+        aggregate?: import("@vuu-ui/vuu-protocol-types").VuuAggType;
+        allowColumnHeaderMenu?: false;
+        colHeaderContentRenderer?: string;
+        colHeaderLabelRenderer?: string;
+        exportFormatter?: (value: unknown) => string;
+        getIcon?: (row: DataRow) => string | undefined;
+        groupable?: boolean;
+        hidden?: boolean;
+        locked?: Exclude<import("@vuu-ui/vuu-table-types").PinLocation, "left"> | false;
+        maxWidth?: number;
+        minWidth?: number;
+        pin?: import("@vuu-ui/vuu-table-types").PinLocation | false;
+        removeable?: boolean;
+        selected?: boolean;
+        source?: "client" | "server";
+        status?: import("@salt-ds/core").ValidationStatus;
+        align?: "left" | "right";
+        ariaColIndex: number;
+        HeaderCellContentRenderer?: import("react").FunctionComponent<Omit<import("@vuu-ui/vuu-table-types").HeaderCellProps, "id" | "index">>;
+        HeaderCellLabelRenderer?: import("react").FunctionComponent<Omit<import("@vuu-ui/vuu-table-types").HeaderCellProps, "id" | "index">>;
+        canStretch?: boolean;
+        className?: string;
+        clientSideEditValidationCheck?: import("@vuu-ui/vuu-data-types").DataValueValidationChecker;
+        draggable?: boolean;
+        filter?: import("@vuu-ui/vuu-filter-types").Filter;
+        flex?: number;
+        heading?: [...string[]];
+        isGroup?: boolean;
+        isSystemColumn?: boolean;
+        label: string;
+        marginLeft?: number;
+        moving?: boolean;
+        originalIdx?: number;
+        pinnedOffset?: number;
+        pinnedWidth?: number;
+        resizeable?: boolean;
+        resizing?: boolean;
+        sortable?: boolean;
+        sorted?: import("@vuu-ui/vuu-table-types").ColumnSort;
+        valueFormatter: import("@vuu-ui/vuu-table-types").ValueFormatter;
+        width: number;
+        editable: boolean;
+        CellRenderer: import("react").FunctionComponent<import("@vuu-ui/vuu-table-types").TableCellRendererProps> | undefined;
+    }[];
+};

package/types/src/tabbed-table-config-panel/TabbedTableConfigPanel.d.ts

@@ -0,0 +1,17 @@
+import { VuuTable } from "@vuu-ui/vuu-protocol-types";
+import type { TableProps } from "@vuu-ui/vuu-table";
+import { HTMLAttributes } from "react";
+import { ColumnPickerProps } from "../column-picker/ColumnPicker";
+import { TableSettingsPanelProps } from "../table-settings-panel/TableSettingsPanel";
+declare const TabLabels: {
+    readonly "table-settings": "Table";
+    readonly "table-columns": "Columns";
+};
+type TabName = keyof typeof TabLabels;
+export interface TabbedTableConfigPanelProps extends ColumnPickerProps, Pick<TableSettingsPanelProps, "onDisplayAttributeChange">, Pick<TableProps, "config">, HTMLAttributes<HTMLDivElement> {
+    allowCreateCalculatedColumn?: boolean;
+    selectedTab?: TabName;
+    vuuTable?: VuuTable;
+}
+export declare const TabbedTableConfigPanel: ({ allowCreateCalculatedColumn, className, columnModel, config, onDisplayAttributeChange, selectedTab, vuuTable, ...htmlAttributes }: TabbedTableConfigPanelProps) => import("react").JSX.Element;
+export {};

package/types/src/tabbed-table-config-panel/TabbedTableSettingsAction.d.ts

@@ -0,0 +1,7 @@
+import { IconButtonProps } from "@vuu-ui/vuu-ui-controls";
+import { TabbedTableConfigPanelHookProps } from "./useTabbedTableConfigPanel";
+import { TableDisplayAttributeChangeHandler } from "../table-settings-panel/TableSettingsPanel";
+export interface TabbedTableSettingsActionProps extends Partial<IconButtonProps>, TabbedTableConfigPanelHookProps {
+    onDisplayAttributeChange: TableDisplayAttributeChangeHandler;
+}
+export declare const TabbedTableSettingsAction: ({ allowCreateCalculatedColumn, appearance, columnModel, config, icon, onDisplayAttributeChange, sentiment, vuuTable, ...IconButtonProps }: TabbedTableSettingsActionProps) => import("react").JSX.Element;

package/types/src/tabbed-table-config-panel/useTabbedTableConfigPanel.d.ts

@@ -0,0 +1,13 @@
+import { TableSettingsPanelProps } from "../table-settings-panel/TableSettingsPanel";
+import { TableProps } from "@vuu-ui/vuu-table";
+import { ColumnPickerProps } from "../column-picker/ColumnPicker";
+import { VuuTable } from "@vuu-ui/vuu-protocol-types";
+export interface TabbedTableConfigPanelHookProps extends Pick<ColumnPickerProps, "allowCreateCalculatedColumn" | "columnModel">, Pick<TableSettingsPanelProps, "onDisplayAttributeChange">, Pick<TableProps, "config"> {
+    /**
+     * only required for calculated columns
+     */
+    vuuTable?: VuuTable;
+}
+export declare const useTabbedTableConfigPanel: ({ allowCreateCalculatedColumn, columnModel, config, onDisplayAttributeChange, vuuTable, }: TabbedTableConfigPanelHookProps) => {
+    showTabbedTableConfigPanel: (title?: string) => void;
+};

package/types/src/table-footer/TableFooter.d.ts

@@ -0,0 +1,10 @@
+import type { HTMLAttributes, ReactNode } from "react";
+export interface TableFooterProps extends HTMLAttributes<HTMLDivElement> {
+    onInvokeAction?: (action: string) => void;
+    tooltrayActions?: ReactNode;
+}
+export declare const TableFooterTray: ({ children, position }: {
+    children: ReactNode;
+    position?: 'center' | 'end';
+}) => import("react").JSX.Element;
+export declare const TableFooter: ({ children, className, onInvokeAction, tooltrayActions, ...htmlAttributes }: TableFooterProps) => import("react").JSX.Element;