@dcs-tech/ui 0.4.0 → 0.7.0

package/dist/{summaryChartData-Djo73zb8.js → summaryChartData-pNvzaEHp.js}

@@ -1,5 +1,5 @@
 "use client";
-import { Tt as e, U as t } from "./geometry-CG2nOEnw.js";
+import { Tt as e, U as t } from "./geometry-ChwYB45B.js";
 // src/components/DataTable/summary/summaryChartData.ts
 function n(e, t) {
 	return {

package/dist/types/components/Charts/parts.d.ts

@@ -9,7 +9,7 @@ export declare function Titled({ title, children }: {
 }): import("react").JSX.Element;
 export declare function formatPercent(p: number): string;
 export declare const funnelDropText: (drop: number) => string;
-export declare function useChartFormat({ locale, format, labels }: ChartFormatProps): {
+export declare function useChartFormat({ locale: localeProp, format, labels }: ChartFormatProps): {
     nf: (n: number) => string;
     L: ChartLabels;
 };

package/dist/types/components/Collapsible/index.d.ts

@@ -1,4 +1,4 @@
 export { default as Collapsible } from './Collapsible';
 export { CollapsibleItem } from './CollapsibleItem';
 export { CollapsibleContext, useCollapsibleContext } from './CollapsibleContext';
-export type { CollapsibleProps, CollapsibleItemProps, CollapsibleContextValue, CollapsibleVariant, CollapsibleSize, CollapsibleColor, CollapsibleIconPosition, CollapsibleExpansionMode, CollapsibleAuthorize, } from '../../core/types';
+export type { CollapsibleProps, CollapsibleItemProps, CollapsibleContextValue, CollapsibleVariant, CollapsibleSize, CollapsibleColor, CollapsibleIconPosition, CollapsibleExpansionMode, CollapsibleAuthorize, CollapsibleDisclosure, CollapsibleTone, CollapsibleHeadingLevel, } from '../../core/types';

package/dist/types/components/DataTable/DataTable.d.ts

@@ -12,5 +12,5 @@ export declare function sameSorting(a: Array<{
     id: string;
     desc: boolean;
 }>): boolean;
-declare function DataTable<TData = any>({ data: dataProp, views, tableId, className, dataSource, persistence: persistenceProp, authorize, exportOptions, initialState: initialStateProp, onStateChange, onRowsChange, apiRef, bulkActions: tableBulkActions, labels: labelsProp, locale, renderDetail: tableRenderDetail, detailBar, openRowId: openRowIdProp, onOpenRowChange, shortcuts: tableShortcutsProp, sharing, renamedViews, prefsVersion, migratePrefs, title, }: DataTableProps<TData>): React.JSX.Element;
+declare function DataTable<TData = any>({ data: dataProp, views, tableId, className, dataSource, persistence: persistenceProp, authorize, exportOptions, initialState: initialStateProp, onStateChange, onRowsChange, apiRef, bulkActions: tableBulkActions, labels: labelsProp, locale: localeProp, renderDetail: tableRenderDetail, detailBar, openRowId: openRowIdProp, onOpenRowChange, shortcuts: tableShortcutsProp, sharing, renamedViews, prefsVersion, migratePrefs, title, }: DataTableProps<TData>): React.JSX.Element;
 export default DataTable;

package/dist/types/components/DataTable/cards/cardFields.d.ts

@@ -1,3 +1,4 @@
+import { type ColumnTextContext } from '../columnValue';
 import { type DataTableCardField, type DataTableCardFields, type DataTableColumn, type DataTableListField, type DataTableListFields } from '../types';
 export interface FieldSet<K extends string> {
     kind: 'card' | 'list';
@@ -22,10 +23,7 @@ export declare function defaultCardFields(columns: DataTableColumn[], configured
 export declare const isListFields: (value: unknown) => value is Partial<DataTableListFields>;
 export declare const normalizeListFields: (raw: Partial<DataTableListFields> | undefined, columns: DataTableColumn[]) => DataTableListFields;
 export declare function defaultListFields(columns: DataTableColumn[], configured: Partial<DataTableListFields> | undefined, card: DataTableCardFields): DataTableListFields;
-export interface CellTextLabels {
-    yes: string;
-    no: string;
-}
+export type CellTextLabels = ColumnTextContext;
 export declare function cellText(column: DataTableColumn, row: unknown, labels: CellTextLabels): string;
 export declare function valueText(column: DataTableColumn, value: unknown, labels: CellTextLabels): string;
 export declare function initialsOf(text: string): string;

package/dist/types/components/DataTable/columnValue.d.ts

@@ -0,0 +1,19 @@
+import type { DateDisplayFormat, UIFormat } from '../../core/types';
+import { type TableDate } from '../../core/logic';
+import type { DataTableColumn } from './types';
+export declare const DEFAULT_TABLE_DATE_FORMAT: DateDisplayFormat;
+export declare function columnValueOf<T>(col: DataTableColumn<T>, row: T): unknown;
+export declare function columnDateOf<T>(col: DataTableColumn<T>, value: unknown, row?: T): TableDate | null;
+export declare const columnDate: <T>(col: DataTableColumn<T>, row: T) => TableDate | null;
+export declare function filterDateOf<T>(col: DataTableColumn<T>, value: unknown, row?: T): TableDate | null;
+export declare function dateCellText<T>(col: DataTableColumn<T>, value: unknown, row?: T): string;
+export interface ColumnTextContext {
+    yes: string;
+    no: string;
+    fmt?: UIFormat;
+}
+export declare function valueText<T>(col: DataTableColumn<T>, value: unknown, ctx: ColumnTextContext, row?: T): string;
+export declare const columnText: <T>(col: DataTableColumn<T>, row: T, ctx: ColumnTextContext) => string;
+export declare function searchTextOf<T>(col: DataTableColumn<T>, row: T, ctx: ColumnTextContext): string;
+export declare function sortKeyOf<T>(col: DataTableColumn<T>, value: unknown, row: T, ctx: ColumnTextContext): unknown;
+export declare function compareSortKeys(a: unknown, b: unknown): number;

package/dist/types/components/DataTable/export/exportCells.d.ts

@@ -0,0 +1,13 @@
+import type { DataTableCellStyle, DataTableColumn, DataTableExportFormat } from '../types';
+import { type ColumnTextContext } from '../columnValue';
+import type { ColumnMeta } from './exportEngine';
+export interface ExportRowsForFormat {
+    headers: string[];
+    rows: Record<string, any>[];
+    exportColumns: DataTableColumn[];
+    cellStyles?: Record<string, DataTableCellStyle>[];
+    columnMeta: ColumnMeta[];
+    totals: Record<string, any> | null;
+}
+export declare function uniqueHeaders(names: string[]): string[];
+export declare function exportRowsFor<TData>(format: DataTableExportFormat, data: TData[], columns: DataTableColumn<TData>[], visibleKeys: string[], ctx: ColumnTextContext, totalKeys?: string[], totalLabel?: string): ExportRowsForFormat;

package/dist/types/components/DataTable/export/exportEngine.d.ts

@@ -1,3 +1,4 @@
+import type { FileTask, PdfTaskFonts, XlsxWorkbookSpec } from '../../../core/types';
 import { type DataTableExportFormat, type DataTableExportMetadata, type DataTableXlsxStyle, type DataTablePdfConfig, type DataTableColumn, type DataTableCellStyle, type DataTableExportSummary } from '../types';
 export { autoFormatValue, prepareExportRows, buildBusinessMeta } from './exportRows';
 export { formatContextLine, formatMetadataLines } from './exportContext';
@@ -8,11 +9,12 @@ export interface ColumnMeta {
     type?: 'string' | 'number' | 'date' | 'boolean' | 'select' | 'array';
     width?: number;
     format?: 'text' | 'number' | 'currency' | 'date' | 'percentage';
+    numFmt?: string;
     cellStyle?: (value: any, row: any) => DataTableCellStyle | undefined;
 }
 export declare function buildColumnMeta(columns: DataTableColumn[], headers: string[]): ColumnMeta[];
 export declare function generateCSV(headers: string[], rows: Record<string, any>[], totals?: Record<string, any> | null, summary?: DataTableExportSummary | null, metadata?: DataTableExportMetadata, subtitle?: string): Blob;
-export declare function generateXLSX(headers: string[], rows: Record<string, any>[], config?: {
+type XlsxConfig = {
     totals?: Record<string, any> | null;
     summary?: DataTableExportSummary | null;
     style?: DataTableXlsxStyle;
@@ -21,7 +23,9 @@ export declare function generateXLSX(headers: string[], rows: Record<string, any
     cellStyles?: Record<string, DataTableCellStyle>[];
     metadata?: DataTableExportMetadata;
     subtitle?: string;
-}): Promise<Blob>;
+};
+export declare function buildTableXlsxSpec(headers: string[], rows: Record<string, any>[], config?: XlsxConfig): XlsxWorkbookSpec;
+export declare function generateXLSX(headers: string[], rows: Record<string, any>[], config?: XlsxConfig): Promise<Blob>;
 export declare function generateJSON(rows: Record<string, any>[], summary?: DataTableExportSummary | null, metadata?: DataTableExportMetadata, subtitle?: string): Blob;
 export declare function generateHTML(headers: string[], rows: Record<string, any>[], config?: {
     title?: string;
@@ -37,7 +41,10 @@ export declare function generateHTML(headers: string[], rows: Record<string, any
         url?: string;
     };
 }): Blob;
-export declare function generateTablePDFDocDef(headers: string[], rows: Record<string, any>[], config?: {
+export type TablePdfTask = Extract<FileTask, {
+    kind: 'pdf';
+}>;
+export declare function generateTablePDFTask(headers: string[], rows: Record<string, any>[], config?: {
     pdfConfig?: DataTablePdfConfig;
     totals?: Record<string, any> | null;
     summary?: DataTableExportSummary | null;
@@ -46,7 +53,8 @@ export declare function generateTablePDFDocDef(headers: string[], rows: Record<s
     cellStyles?: Record<string, DataTableCellStyle>[];
     metadata?: DataTableExportMetadata;
     fontFor?: PdfFontFor;
-}): any;
+    fonts?: PdfTaskFonts;
+}): TablePdfTask;
 export { rawDataToBlob, downloadBlob, shareFile, openPreview, executeFileAction, getExtension, getFormatLabel, } from '../vendor';
 export declare function generateXML(headers: string[], rows: Record<string, any>[], config?: {
     title?: string;
@@ -68,6 +76,7 @@ export declare function buildExportBlob(format: DataTableExportFormat, headers:
     };
     totalKeys?: string[];
     columns?: DataTableColumn[];
+    columnMeta?: ColumnMeta[];
     cellStyles?: Record<string, DataTableCellStyle>[];
     metadata?: DataTableExportMetadata;
     branding?: {

package/dist/types/components/DataTable/export/useTableExport.d.ts

@@ -1,5 +1,6 @@
 import { type DataTableColumn, type DataTableExportTemplate, type DataTableExportFormat, type DataTableExportAction, type DataTableExportSettings, type DataTableActiveFilter, type DataTableExportResult, type DataTableExportConfig, type DataTablePdfConfig, type DataTableExportSummary, type DataTableExportTemplatePrefs, type DataTableExportOptions, type DataTableAllRowsResult, type DataTableAuthorize, type DataTableSelection } from '../types';
 import type { DataTableExportOptionValues } from '../types';
+import type { ColumnTextContext } from '../columnValue';
 import { type DataTableLabels } from '../labels';
 interface UseTableExportOptions<TData> {
     columns: DataTableColumn<TData>[];
@@ -25,6 +26,7 @@ interface UseTableExportOptions<TData> {
     loadAllRows?: (format: DataTableExportFormat, action: DataTableExportAction, params?: Record<string, unknown>) => Promise<DataTableAllRowsResult<TData>>;
     labels?: DataTableLabels;
     locale?: string;
+    text?: ColumnTextContext;
 }
 interface UseTableExportReturn {
     hasExport: boolean;

package/dist/types/components/DataTable/host.d.ts

@@ -1,3 +1,4 @@
+import type { ColumnTextContext } from './columnValue';
 import type { DataTableAuthorize, DataTableExportOptions, DataTableGate } from './types';
 import { type TableFormat, type DataTableLabels } from './labels';
 export interface TableHost {
@@ -7,6 +8,7 @@ export interface TableHost {
     operators?: readonly string[];
     labels: DataTableLabels;
     format: TableFormat;
+    text: ColumnTextContext;
 }
 export declare const TableHostContext: import("react").Context<TableHost>;
 export declare function useTableHost(): TableHost;

package/dist/types/components/DataTable/index.d.ts

@@ -1,5 +1,5 @@
 export { default as DataTable } from './DataTable';
-export type { DataTableProps, DataTableView, DataTableColumn, DataTableColumnType, DataTableComponentProps, DataTableRowAction, DataTableFilterGroup, DataTableFilterCondition, DataTableActiveFilter, DataTableSingleRowView, DataTableSingleRowField, DataTableSingleRowAction, DataTableSelectionConfig, DataTableSelectionShow, DataTablePaginationConfig, DataTableSortingConfig, DataTableFilteringConfig, DataTableQuickFilter, DataTableQuickFilterMode, DataTableSavedFilter, DataTableSavedFilterIssue, DataTableViewPrefs, DataTableExportFormat, DataTableExportAction, DataTableExportTemplate, DataTableQuickExport, DataTableExportConfig, DataTableXlsxStyle, DataTablePdfConfig, DataTableExportGenerator, DataTableExportResult, DataTableExportResultStatus, DataTableExportGeneratorResult, DataTableFilenameContext, DataTableExportMeta, DataTableExportContext, DataTableExportSettings, DataTableExportPrefs, DataTableExportMetadata, DataTableExportSummary, DataTableExportSummaryTable, DataTableExportOptions, DataTableFileNameAs, DataTablePdfFonts, DataTablePdfPageSize, DataTablePdfOrientation, DataTablePdfFontSize, DataTablePdfMargins, DataTableSummaryConfig, DataTableSummaryCard, DataTableSummaryValueCard, DataTableSummaryRatioCard, DataTableSummaryBreakdownCard, DataTableSummaryTrendCard, DataTableSummaryFunnelCard, DataTableSummaryFunnelStep, DataTableSummaryValueTrend, DataTableSummaryPeriod, DataTableSummaryTrendChart, DataTableSummaryValueChart, DataTableSummaryRatioChart, DataTableSummaryAnyChart, DataTableSummaryCardRequest, DataTableSummaryPeriodCount, DataTableSummaryFigure, DataTableSummarySubline, DataTableSummaryStrip, DataTableSummaryChart, DataTableSummaryWidth, DataTableSummaryShow, DataTableSummaryPart, DataTableSummaryUserCard, DataTableSummaryPrefs, DataTableExportSummaryMode, DataTableSummaryPlacement, DataTableSummaryRequest, DataTableSummaryBucket, DataTableSummaryBreakdown, DataTableSummaryFigures, DataTableLicense, DataTableFlashColor, DataTableFlashColors, DataTableCellFlashStyle, DataTableCellStyle, DataTableLayout, DataTableCardFields, DataTableCardField, DataTableListFields, DataTableListField, DataTableRowMenuConfig, DataTableRowMenuItem, DataTableRowMenuBuiltIn, DataTableRowMenuIconAction, DataTableDetailMode, DataTableDetailContext, DataTableDetailRenderer, DataTableDisplayPrefs, DataTableDensity, DataTableFontSize, DataTableColumnWidth, DataTableActionDisplay, DataTableQuery, DataTableDataSource, DataTableRowsResult, DataTableAllRowsResult, DataTableCounts, DataTableInitialState, DataTableApi, DataTablePersistence, DataTableGate, DataTableAuthorize, DataTableManagePrefs, DataTableManageList, DataTableViewsPrefs, DataTableExportTemplatePrefs, DataTableBulkAction, DataTableBulkActionContext, DataTableBulkActionResult, DataTableBulkConfirm, DataTableSelection, DataTableColumnPinning, DataTablePinningConfig, DataTableKeyboardConfig, DataTableShortcut, DataTableVirtualizeConfig, DataTableGroupingConfig, DataTableGroupPathItem, DataTableGroupResult, DataTableGroupSummaryContext, DataTableViewState, DataTableSharedView, DataTableShareAudience, DataTableSharing, } from './types';
+export type { DataTableProps, DataTableView, DataTableColumn, DataTableColumnType, DataTableNumberFormat, DataTableComponentProps, DataTableRowAction, DataTableFilterGroup, DataTableFilterCondition, DataTableActiveFilter, DataTableSingleRowView, DataTableSingleRowField, DataTableSingleRowAction, DataTableSelectionConfig, DataTableSelectionShow, DataTablePaginationConfig, DataTableSortingConfig, DataTableFilteringConfig, DataTableQuickFilter, DataTableQuickFilterMode, DataTableSavedFilter, DataTableSavedFilterIssue, DataTableViewPrefs, DataTableExportFormat, DataTableExportAction, DataTableExportTemplate, DataTableQuickExport, DataTableExportConfig, DataTableXlsxStyle, DataTablePdfConfig, DataTableExportGenerator, DataTableExportResult, DataTableExportResultStatus, DataTableExportGeneratorResult, DataTableFilenameContext, DataTableExportMeta, DataTableExportContext, DataTableExportSettings, DataTableExportPrefs, DataTableExportMetadata, DataTableExportSummary, DataTableExportSummaryTable, DataTableExportOptions, DataTableFileNameAs, DataTablePdfFonts, DataTablePdfPageSize, DataTablePdfOrientation, DataTablePdfFontSize, DataTablePdfMargins, DataTableSummaryConfig, DataTableSummaryCard, DataTableSummaryValueCard, DataTableSummaryRatioCard, DataTableSummaryBreakdownCard, DataTableSummaryTrendCard, DataTableSummaryFunnelCard, DataTableSummaryFunnelStep, DataTableSummaryValueTrend, DataTableSummaryPeriod, DataTableSummaryTrendChart, DataTableSummaryValueChart, DataTableSummaryRatioChart, DataTableSummaryAnyChart, DataTableSummaryCardRequest, DataTableSummaryPeriodCount, DataTableSummaryFigure, DataTableSummarySubline, DataTableSummaryStrip, DataTableSummaryChart, DataTableSummaryWidth, DataTableSummaryShow, DataTableSummaryPart, DataTableSummaryUserCard, DataTableSummaryPrefs, DataTableExportSummaryMode, DataTableSummaryPlacement, DataTableSummaryRequest, DataTableSummaryBucket, DataTableSummaryBreakdown, DataTableSummaryFigures, DataTableLicense, DataTableFlashColor, DataTableFlashColors, DataTableCellFlashStyle, DataTableCellStyle, DataTableLayout, DataTableCardFields, DataTableCardField, DataTableListFields, DataTableListField, DataTableRowMenuConfig, DataTableRowMenuItem, DataTableRowMenuBuiltIn, DataTableRowMenuIconAction, DataTableDetailMode, DataTableDetailContext, DataTableDetailRenderer, DataTableDisplayPrefs, DataTableDensity, DataTableFontSize, DataTableColumnWidth, DataTableActionDisplay, DataTableQuery, DataTableDataSource, DataTableRowsResult, DataTableAllRowsResult, DataTableCounts, DataTableInitialState, DataTableApi, DataTablePersistence, DataTableGate, DataTableAuthorize, DataTableManagePrefs, DataTableManageList, DataTableViewsPrefs, DataTableExportTemplatePrefs, DataTableBulkAction, DataTableBulkActionContext, DataTableBulkActionResult, DataTableBulkConfirm, DataTableSelection, DataTableColumnPinning, DataTablePinningConfig, DataTableKeyboardConfig, DataTableShortcut, DataTableVirtualizeConfig, DataTableGroupingConfig, DataTableGroupPathItem, DataTableGroupResult, DataTableGroupSummaryContext, DataTableViewState, DataTableSharedView, DataTableShareAudience, DataTableSharing, } from './types';
 export { isFilterGroup, CARD_FIELD_LIMITS, LIST_FIELD_LIMITS, SUMMARY_PLACEMENTS_MAX, SUMMARY_SHOWS, SUMMARY_STRIPS, SUMMARY_TREND_COUNTS, SUMMARY_TREND_COUNT_BOUNDS, SUMMARY_KIND_CHARTS, SUMMARY_USER_CARDS_MAX, SUMMARY_WIDTHS } from './types';
 export { DEFAULT_DATA_TABLE_LABELS } from './labels';
 export type { DataTableLabels, DataTableLabelKey } from './labels';

package/dist/types/components/DataTable/labels.d.ts

@@ -459,6 +459,8 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     exportPreviewLoadFailed: string;
     exportLoadFailed: string;
     exportGenerationFailed: string;
+    exportCancelled: (title: string) => string;
+    exportAwaitingClick: (title: string) => string;
     exportValidationFailed: string;
     exportCapped: (shown: string, total: string) => string;
     exportBusiness: string;

package/dist/types/components/DataTable/types.d.ts

@@ -1,6 +1,7 @@
 import { type ComponentType, type ReactNode } from 'react';
 import type { ChartProgressColor, ChartSlot, TrendGood } from '../Charts';
 import type { DataTableLabels } from './labels';
+import type { DateDisplayFormat } from '../../core/types';
 export type DataTableFlashColor = 'green' | 'red' | 'amber' | 'blue' | 'purple' | 'teal' | 'orange' | 'pink';
 export interface DataTableFlashColors {
     up?: DataTableFlashColor;
@@ -33,6 +34,7 @@ export interface DataTableCellStyle {
     fontSize?: number;
     align?: 'left' | 'center' | 'right';
 }
+export type DataTableNumberFormat = 'integer' | 'amount' | 'currency' | 'percent';
 export interface DataTableColumn<TData = any> {
     key: string;
     header: string;
@@ -52,6 +54,15 @@ export interface DataTableColumn<TData = any> {
         value: any;
     }>;
     filterAccessor?: (value: any) => any;
+    parse?: DateDisplayFormat | ((value: any, row: TData) => unknown);
+    dateFormat?: DateDisplayFormat;
+    value?: (row: TData) => unknown;
+    format?: (value: any, row: TData) => string;
+    numberFormat?: DataTableNumberFormat;
+    sortValue?: (value: any, row: TData) => unknown;
+    compare?: (a: any, b: any) => number;
+    searchText?: (value: any, row: TData) => string;
+    groupValue?: (value: any, row: TData) => string | number | boolean | null;
     field?: string;
     groupable?: boolean;
     authorized?: boolean;

package/dist/types/components/DataTable/useTable.d.ts

@@ -1,12 +1,15 @@
+import type { UIFormat } from '../../core/types';
+import { type ColumnTextContext } from './columnValue';
 import { type DataTableView, type DataTableColumn, type UseTableReturn, type DataTableInitialState } from './types';
 import { type DataTableLabels } from './labels';
-export declare function rowMatchesSearch<TData>(row: TData, columns: DataTableColumn<TData>[], search: string): boolean;
+export declare function rowMatchesSearch<TData>(row: TData, columns: DataTableColumn<TData>[], search: string, ctx?: ColumnTextContext): boolean;
 export interface UseTableOptions {
     serverMode?: boolean;
     rowCount?: number;
     initialState?: DataTableInitialState;
     defaultPageSize?: number;
     labels?: DataTableLabels;
+    format?: UIFormat;
     customPaging?: boolean;
 }
 export declare function useTable<TData = any>(data: TData[], config: DataTableView<TData>, options?: UseTableOptions): UseTableReturn<TData>;

package/dist/types/components/DataTable/vendor/index.d.ts

@@ -1,3 +1,3 @@
 export { mergeColumnOrder } from './columnOrder';
 export { extractDifferences, applyDifferences, type DeepPartial } from './diff';
-export { createPdfBlob, rawDataToBlob, downloadBlob, shareFile, openPreview, executeFileAction, getExtension, getFormatLabel, safeFileName, safeFileBaseName, EXTENSION_MAP, MIME_MAP, type FileFormat, type FileAction, } from './fileActions';
+export { createPdfBlob, rawDataToBlob, downloadBlob, shareFile, openPreview, executeFileAction, getExtension, getFormatLabel, safeFileName, safeFileBaseName, EXTENSION_MAP, MIME_MAP, type FileFormat, type FileAction, } from '../../../file/fileActions';

package/dist/types/components/Dialog/DialogHost.d.ts

@@ -37,6 +37,7 @@ export interface DialogApi {
     choose: (opts: ChooseOptions) => Promise<string | null>;
     alert: (opts: AlertOptions) => Promise<void>;
 }
+export declare const useOptionalDialog: () => DialogApi | null;
 export declare const useDialog: () => DialogApi;
 export declare const DialogHost: React.FC<{
     children?: React.ReactNode;

package/dist/types/components/EditableTable/EditableTableCell.d.ts

@@ -7,7 +7,7 @@ export declare function frameProps(layout: ResolvedColumnLayout): {
     'data-sticky-edge'?: '';
     style: React.CSSProperties;
 };
-export declare function formatReadOnlyValue(value: unknown): string;
+export declare function formatReadOnlyValue(value: unknown, locale?: string): string;
 export interface EditableTableCellProps<T> {
     rule?: ResolvedRule;
     landed?: boolean;

package/dist/types/components/FileEngine/FileEngineContext.d.ts

@@ -0,0 +1,17 @@
+import type { FileDeliveryAction, FileJob } from '../../core/types';
+import { type FileEngine, type FileJobRequest } from '../../file/fileEngine';
+export declare const FileEngineContext: import("react").Context<FileEngine | null>;
+export declare function getDefaultFileEngine(): FileEngine;
+export declare function useFileEngineInstance(): FileEngine;
+export interface UseFileEngineResult {
+    jobs: readonly FileJob[];
+    submit: (request: FileJobRequest) => string;
+    cancel: (id: string) => void;
+    retry: (id: string) => void;
+    deliver: (id: string, action?: FileDeliveryAction) => Promise<void>;
+    wait: (id: string) => Promise<FileJob | undefined>;
+    clear: (filter?: (job: FileJob) => boolean) => void;
+    engine: FileEngine;
+}
+export declare function useFileEngine(): UseFileEngineResult;
+export declare function useFileJob(id: string | null | undefined): FileJob | undefined;

package/dist/types/components/FileEngine/FileEngineProvider.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { FileJob } from '../../core/types';
+import { type CreateFileEngineOptions, type FileEngine } from '../../file/fileEngine';
+import { type FileEngineLabels, type FileEngineLabelsInput } from './labels';
+export interface FileEngineProviderProps {
+    children?: React.ReactNode;
+    engine?: FileEngine;
+    options?: CreateFileEngineOptions;
+    notify?: boolean | ((notice: FileJobNotice) => void);
+    labels?: FileEngineLabelsInput;
+}
+export type FileJobNotice = {
+    type: 'awaiting-click';
+    job: FileJob;
+    message: string;
+    actionLabel: string;
+    deliver: () => Promise<void>;
+    dismiss: () => void;
+} | {
+    type: 'failed';
+    job: FileJob;
+    message: string;
+    actionLabel: string;
+    retry: () => void;
+    dismiss: () => void;
+} | {
+    type: 'resolved';
+    job: FileJob;
+};
+export declare function useFileEngineLabels(labels?: FileEngineLabelsInput): FileEngineLabels;
+export declare const FileEngineProvider: React.FC<FileEngineProviderProps>;

package/dist/types/components/FileEngine/FileJobsTray.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { FileJob } from '../../core/types';
+import type { FileEngineLabelsInput } from './labels';
+export interface FileJobsTrayProps {
+    filter?: (job: FileJob) => boolean;
+    labels?: FileEngineLabelsInput;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare const FileJobsTray: React.FC<FileJobsTrayProps>;

package/dist/types/components/FileEngine/index.d.ts

@@ -0,0 +1,8 @@
+export { FileEngineProvider, useFileEngineLabels } from './FileEngineProvider';
+export type { FileEngineProviderProps, FileJobNotice } from './FileEngineProvider';
+export { FileJobsTray } from './FileJobsTray';
+export type { FileJobsTrayProps } from './FileJobsTray';
+export { FileEngineContext, useFileEngine, useFileJob, getDefaultFileEngine } from './FileEngineContext';
+export type { UseFileEngineResult } from './FileEngineContext';
+export { DEFAULT_FILE_ENGINE_LABELS } from './labels';
+export type { FileEngineLabels, FileEngineLabelsInput } from './labels';

package/dist/types/components/FileEngine/labels.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULT_FILE_ENGINE_LABELS: {
+    tray: string;
+    status: {
+        queued: string;
+        running: string;
+        ready: string;
+        delivered: string;
+        failed: string;
+        cancelled: string;
+    };
+    actions: {
+        download: string;
+        share: string;
+        preview: string;
+        print: string;
+        open: string;
+    };
+    cancel: string;
+    retry: string;
+    dismiss: string;
+    readyToast: (filename: string) => string;
+    failedToast: (filename: string) => string;
+};
+export type FileEngineLabels = typeof DEFAULT_FILE_ENGINE_LABELS;
+export type FileEngineLabelsInput = Partial<Omit<FileEngineLabels, 'status' | 'actions'>> & {
+    status?: Partial<FileEngineLabels['status']>;
+    actions?: Partial<FileEngineLabels['actions']>;
+};
+export declare function resolveFileEngineLabels(labels?: FileEngineLabelsInput): FileEngineLabels;

package/dist/types/components/Toast/ToastHost.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { ToastApi, ToastDefaults } from './toast.types';
 export declare const useToast: () => ToastApi;
+export declare const useOptionalToast: () => ToastApi | null;
 export interface ToastHostProps {
     defaults?: ToastDefaults;
     children?: React.ReactNode;

package/dist/types/components/UIProvider/UIFormatContext.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { UIFormat, UIFormatSettings } from '../../core/types';
+export interface FormatProviderProps extends UIFormatSettings {
+    children?: React.ReactNode;
+}
+export declare const FormatProvider: React.FC<FormatProviderProps>;
+export declare function useFormat(): UIFormat;

package/dist/types/components/UIProvider/UIHostContext.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { FileJobNotice } from '../FileEngine/FileEngineProvider';
+export interface UIConfirmRequest {
+    title: string;
+    message: string;
+}
+export interface UIHostDefaults {
+    renderAuthorize?: (authorize: any, children: ReactNode) => ReactNode;
+    onToast?: (type: 'success' | 'error' | 'info' | 'warning', message: string) => void;
+    onNavigate?: (path: string) => void;
+    renderLoading?: (isOpen: boolean, message?: string) => ReactNode;
+    onConfirm?: (request: UIConfirmRequest) => boolean | Promise<boolean>;
+    onFileNotice?: (notice: FileJobNotice) => void;
+}
+export declare const HostProvider: React.FC<{
+    host?: UIHostDefaults;
+    children?: ReactNode;
+}>;
+export declare const useUIHost: () => UIHostDefaults;

package/dist/types/components/UIProvider/UILabelsContext.d.ts

@@ -0,0 +1,116 @@
+import type { DataTableLabels } from '../DataTable/labels';
+import type { ChartLabels } from '../Charts/labels';
+import React from 'react';
+export declare const DEFAULT_UI_LABELS: {
+    common: {
+        loading: string;
+    };
+    dialog: {
+        ok: string;
+        cancel: string;
+        confirm: string;
+        close: string;
+    };
+    toast: {
+        dismiss: string;
+    };
+    input: {
+        clear: string;
+        showPassword: string;
+        hidePassword: string;
+    };
+    select: {
+        clear: string;
+        options: string;
+        search: string;
+        selectAll: string;
+        deselectAll: string;
+        noResults: string;
+        noOptions: string;
+        fixed: string;
+        alwaysDisabled: string;
+        maxReached: string;
+        dragToReorder: string;
+        fixedPosition: string;
+    };
+    suggest: {
+        placeholder: string;
+        loading: string;
+        noResults: string;
+        suggestions: string;
+        otherGroup: string;
+    };
+    commandPalette: {
+        placeholder: string;
+        empty: string;
+        name: string;
+    };
+    datePicker: {
+        clear: string;
+        apply: string;
+        presetRanges: string;
+        previousMonth: string;
+        nextMonth: string;
+        presets: {
+            today: string;
+            yesterday: string;
+            last7: string;
+            last30: string;
+            thisWeek: string;
+            lastWeek: string;
+            thisMonth: string;
+            lastMonth: string;
+            thisQuarter: string;
+            lastQuarter: string;
+            thisFY: string;
+            lastFY: string;
+            ytd: string;
+        };
+    };
+    stepper: {
+        completed: string;
+    };
+    tooltip: {
+        moreInformation: string;
+    };
+    colorScheme: {
+        sample: string;
+    };
+    editableTable: {
+        addRow: string;
+        copyRow: string;
+        deleteRow: string;
+    };
+    sidebar: {
+        name: string;
+        closeNavigation: string;
+    };
+    breadcrumbs: {
+        name: string;
+        related: string;
+        hidden: (count: number) => string;
+    };
+    image: {
+        image: string;
+        images: string;
+        add: string;
+        preparing: string;
+        remove: string;
+        previous: string;
+        next: string;
+    };
+};
+export type UILabels = typeof DEFAULT_UI_LABELS & {
+    table?: Partial<DataTableLabels>;
+    charts?: Partial<ChartLabels>;
+};
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends Record<string, unknown> ? DeepPartial<T[K]> : T[K];
+};
+export type UILabelsInput = DeepPartial<UILabels>;
+export declare const LabelsProvider: React.FC<{
+    labels?: UILabelsInput;
+    children?: React.ReactNode;
+}>;
+export declare const useUILabels: () => UILabels;
+export {};

package/dist/types/components/UIProvider/UIProvider.d.ts

@@ -1,13 +1,20 @@
 import React from 'react';
 import type { FieldProviderProps } from '../../core/types';
 import type { ToastDefaults } from '../Toast/toast.types';
+import type { CreateFileEngineOptions, FileEngine } from '../../file/fileEngine';
+import type { UIFormatSettings } from '../../core/types';
+import { type UILabelsInput } from './UILabelsContext';
+import { type UIHostDefaults } from './UIHostContext';
 import { type ResolvedUITheme, type UITheme } from './UIThemeContext';
-export interface UIProviderProps extends Pick<FieldProviderProps, 'size' | 'variant' | 'layout'> {
+export interface UIProviderProps extends Pick<FieldProviderProps, 'size' | 'variant' | 'layout'>, UIFormatSettings {
     children?: React.ReactNode;
     theme?: UITheme;
     onThemeChange?: (resolved: ResolvedUITheme, requested: UITheme) => void;
     portalContainer?: HTMLElement | false;
     toast?: ToastDefaults;
+    fileEngine?: CreateFileEngineOptions | FileEngine;
+    labels?: UILabelsInput;
+    host?: UIHostDefaults;
 }
 declare const UIProvider: React.FC<UIProviderProps>;
 export default UIProvider;

package/dist/types/components/UIProvider/index.d.ts

@@ -3,3 +3,9 @@ export type { UIProviderProps } from './UIProvider';
 export { useUIPortalContainer, UIPortalContext } from './UIPortalContext';
 export { useUITheme, UIThemeContext } from './UIThemeContext';
 export type { UITheme, ResolvedUITheme, UIThemeValue } from './UIThemeContext';
+export { FormatProvider, useFormat } from './UIFormatContext';
+export type { FormatProviderProps } from './UIFormatContext';
+export { LabelsProvider, useUILabels, DEFAULT_UI_LABELS } from './UILabelsContext';
+export type { UILabels, UILabelsInput } from './UILabelsContext';
+export { HostProvider, useUIHost } from './UIHostContext';
+export type { UIHostDefaults, UIConfirmRequest } from './UIHostContext';

package/dist/types/core/logic/collapsible.logic.d.ts

@@ -1,4 +1,8 @@
-import { CollapsibleVariant, CollapsibleSize, CollapsibleColor, CollapsibleIconPosition, CollapsibleDisclosure, CollapsibleTone } from '../types';
+import { CollapsibleVariant, CollapsibleSize, CollapsibleColor, CollapsibleIconPosition, CollapsibleDisclosure, CollapsibleTone, CollapsibleExpansionMode } from '../types';
+export declare function toExpandedSet(value: string | readonly string[] | undefined): Set<string>;
+export declare function initialExpandedSet(containerDefault: string | readonly string[] | undefined, itemDefaults: readonly string[], mode: CollapsibleExpansionMode): Set<string>;
+export declare function toggleExpanded(current: ReadonlySet<string>, id: string, mode: CollapsibleExpansionMode): Set<string>;
+export declare function expandedValue(expanded: ReadonlySet<string>, mode: CollapsibleExpansionMode): string | string[];
 interface CollapsibleContainerOpts {
     variant: CollapsibleVariant;
     size: CollapsibleSize;
@@ -17,6 +21,7 @@ export declare function buildCollapsibleIconClassKeys(opts: CollapsibleIconOpts)
 interface CollapsibleItemOpts {
     isExpanded: boolean;
     isDisabled: boolean;
+    standaloneSize?: CollapsibleSize;
 }
 export declare function buildCollapsibleItemClassKeys(opts: CollapsibleItemOpts): string[];
 interface CollapsibleHeaderOpts {

package/dist/types/core/logic/datePicker.logic.d.ts

@@ -113,6 +113,7 @@ export interface DatePresetOptions {
     fyStartMonth?: number;
     weekStart?: number;
     only?: string[];
+    labels?: Partial<Record<string, string>>;
 }
 export declare function financialYearOf(day: IsoDay, fyStartMonth?: number): {
     from: IsoDay;
@@ -134,3 +135,7 @@ export declare function viewForRange(from: IsoDay, to: IsoDay, opts?: {
     currentMonthSide?: 'left' | 'right';
 }): IsoDay;
 export declare function extendDateRange(range: Partial<DayRange> | null | undefined, day: IsoDay): DayRange;
+export declare function calendarNames(locale?: string): {
+    months: string[];
+    weekdays: string[];
+};

package/dist/types/core/logic/exportSafety.logic.d.ts

@@ -0,0 +1 @@
+export declare const guardSpreadsheetText: (text: string) => string;