@dcs-tech/ui 0.4.0 → 0.6.0

package/dist/types/core/types/fileEngine.types.d.ts

@@ -0,0 +1,65 @@
+export type FileFormat = 'pdf' | 'xlsx' | 'csv' | 'html' | 'json' | 'xml' | 'png';
+export type FileDeliveryAction = 'download' | 'share' | 'preview' | 'print' | 'open';
+export type FileJobAction = FileDeliveryAction | 'none';
+export type FileJobPriority = 'high' | 'normal' | 'low';
+export type FileJobStatus = 'queued' | 'running' | 'ready' | 'delivered' | 'failed' | 'cancelled';
+export interface FileJob {
+    id: string;
+    format: FileFormat;
+    filename: string;
+    title?: string;
+    action: FileJobAction;
+    priority: FileJobPriority;
+    dedupeKey?: string;
+    status: FileJobStatus;
+    progress: number;
+    attempts: number;
+    retry: number;
+    seq: number;
+    createdAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    error?: string;
+    awaitingClick?: boolean;
+    notify: 'all' | 'awaiting-click';
+}
+export interface FileEngineOptions {
+    concurrency?: number;
+    maxQueued?: number;
+    timeoutMs?: number;
+    keepFinished?: number;
+    workers?: 'auto' | 'off';
+}
+export type XlsxCellValue = string | number | boolean | Date | null;
+export interface XlsxColumnSpec {
+    header: string;
+    width?: number;
+    numFmt?: string;
+    align?: 'left' | 'center' | 'right';
+}
+export interface XlsxSheetSpec {
+    name: string;
+    columns: XlsxColumnSpec[];
+    rows: XlsxCellValue[][];
+    freezeHeader?: boolean;
+}
+export interface XlsxWorkbookSpec {
+    sheets: XlsxSheetSpec[];
+}
+export interface PdfTaskFonts {
+    fonts?: Record<string, {
+        normal: string;
+        bold: string;
+        italics: string;
+        bolditalics: string;
+    }>;
+    vfs?: Record<string, string>;
+}
+export type FileTask = {
+    kind: 'pdf';
+    document: Record<string, unknown>;
+    fonts?: PdfTaskFonts;
+} | {
+    kind: 'xlsx';
+    workbook: XlsxWorkbookSpec;
+};

package/dist/types/core/types/format.types.d.ts

@@ -0,0 +1,15 @@
+import type { DateDisplayFormat } from './datePicker.types';
+export interface UIFormatSettings {
+    locale?: string;
+    currency?: string;
+    dateFormat?: DateDisplayFormat;
+}
+export interface UIFormat {
+    locale: string | undefined;
+    currency: string | undefined;
+    dateFormat: DateDisplayFormat;
+    number: (value: number, decimals?: number) => string;
+    money: (value: number, decimals?: number) => string;
+    percent: (value: number, decimals?: number) => string;
+    day: (value: unknown) => string;
+}

package/dist/types/core/types/index.d.ts

@@ -20,3 +20,5 @@ export * from './table.types';
 export * from './editableTable.types';
 export * from './navigation.types';
 export type { DataAttributes } from './common.types';
+export * from './fileEngine.types';
+export * from './format.types';

package/dist/types/core/types/table.types.d.ts

@@ -24,6 +24,7 @@ export interface SummaryContext {
     selectedRows?: any[];
     filters?: unknown[];
     context?: Record<string, any>;
+    locale?: string;
 }
 export interface SummaryLicenseConfig {
     tab: string;

package/dist/types/{components/DataTable/vendor → file}/fileActions.d.ts

@@ -1,19 +1,29 @@
-import type { DataTablePdfFonts } from '../types';
-export type FileFormat = 'pdf' | 'xlsx' | 'csv' | 'html' | 'json' | 'xml' | 'png';
-export type FileAction = 'download' | 'print' | 'share' | 'open' | 'preview';
+export interface PdfFontConfig {
+    fonts?: Record<string, {
+        normal: string;
+        bold: string;
+        italics: string;
+        bolditalics: string;
+    }>;
+    vfs?: Record<string, string>;
+    fontFor?: (text: string) => string | undefined;
+}
+import type { FileFormat, FileDeliveryAction } from '../core/types';
+export type { FileFormat };
+export type FileAction = FileDeliveryAction;
 export declare const EXTENSION_MAP: Record<FileFormat, string>;
 export declare const MIME_MAP: Record<FileFormat, string>;
-export declare function createPdfBlob(docDef: unknown, fontConfig?: DataTablePdfFonts): Promise<Blob>;
-export declare function rawDataToBlob(format: FileFormat, data: any, fontConfig?: DataTablePdfFonts): Promise<Blob>;
+export declare function createPdfBlob(docDef: unknown, fontConfig?: PdfFontConfig): Promise<Blob>;
+export declare function rawDataToBlob(format: FileFormat, data: any, fontConfig?: PdfFontConfig): Promise<Blob>;
 export declare function safeFileBaseName(name: string): string;
 export declare function safeFileName(filename: string): string;
 export declare function downloadBlob(blob: Blob, filename: string): void;
-export declare function shareFile(blob: Blob, filename: string): Promise<boolean>;
+export declare function shareFile(blob: Blob, filename: string, title?: string): Promise<boolean>;
 export declare function openPreview(blob: Blob, format: FileFormat, title?: string): {
     type: "new_tab";
 } | {
     type: "modal";
 };
-export declare function executeFileAction(data: any, filename: string, format: FileFormat, action: string, title?: string, fontConfig?: DataTablePdfFonts): Promise<void>;
+export declare function executeFileAction(data: any, filename: string, format: FileFormat, action: string, title?: string, fontConfig?: PdfFontConfig): Promise<void>;
 export declare function getExtension(format: FileFormat): string;
 export declare function getFormatLabel(format: FileFormat): string;

package/dist/types/file/fileEngine.d.ts

@@ -0,0 +1,48 @@
+import type { FileDeliveryAction, FileEngineOptions, FileFormat, FileJob, FileJobAction, FileJobPriority, FileTask } from '../core/types';
+export interface FileBuildContext {
+    signal: AbortSignal;
+    progress: (fraction: number) => void;
+}
+interface FileJobRequestBase {
+    filename: string;
+    title?: string;
+    action?: FileJobAction;
+    priority?: FileJobPriority;
+    dedupeKey?: string;
+    replace?: boolean;
+    retry?: number;
+    onReady?: (blob: Blob, job: FileJob) => void;
+    notify?: FileJob['notify'];
+}
+export type FileJobRequest = FileJobRequestBase & ({
+    format: FileFormat;
+    build: (context: FileBuildContext) => unknown | Promise<unknown>;
+    task?: never;
+} | {
+    task: FileTask;
+    format?: FileFormat;
+    build?: never;
+});
+export type FileDeliverer = (blob: Blob, job: FileJob, action: FileDeliveryAction) => void | Promise<void>;
+export interface CreateFileEngineOptions extends FileEngineOptions {
+    deliver?: FileDeliverer;
+    createWorker?: () => Worker;
+}
+export type FileEngineErrorCode = 'queue-full' | 'timeout' | 'disposed';
+export declare class FileEngineError extends Error {
+    readonly code: FileEngineErrorCode;
+    constructor(code: FileEngineErrorCode, message: string);
+}
+export interface FileEngine {
+    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;
+    getJobs(): readonly FileJob[];
+    subscribe(listener: () => void): () => void;
+    dispose(): void;
+}
+export declare function createFileEngine(options?: CreateFileEngineOptions): FileEngine;
+export {};

package/dist/types/file/tasks/fileTask.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/file/tasks/runFileTask.d.ts

@@ -0,0 +1,6 @@
+import type { FileTask } from '../../core/types';
+export interface TaskContext {
+    progress: (fraction: number) => void;
+    signal?: AbortSignal;
+}
+export declare function runFileTask(task: FileTask, ctx: TaskContext): Promise<ArrayBuffer>;

package/dist/types/file/workerPool.d.ts

@@ -0,0 +1,17 @@
+import type { FileTask } from '../core/types';
+export declare class WorkerFallback extends Error {
+    readonly reason: 'unavailable' | 'uncloneable';
+    constructor(reason: 'unavailable' | 'uncloneable', detail: string);
+}
+export interface WorkerPool {
+    run(task: FileTask, ctx: {
+        signal: AbortSignal;
+        progress: (fraction: number) => void;
+    }): Promise<ArrayBuffer>;
+    readonly broken: boolean;
+    dispose(): void;
+}
+export declare function createWorkerPool(options: {
+    size: number;
+    create: () => Worker;
+}): WorkerPool;

package/dist/types/index.d.ts

@@ -28,7 +28,7 @@ export { Suggest, SuggestionList, useSuggest } from './components/Suggest';
 export { FORMATTER_UTILITY_CLASSES, SUGGEST_SEARCH_ENGINE_OPTIONS, SUGGEST_SEARCH_MODE_OPTIONS, } from './components/Suggest';
 export type { SuggestProps, SuggestSize, SuggestLayout, SuggestSearchEngine, SuggestSearchMode, RenderKey, SuggestionConfig, SuggestionItemProps, SuggestionListProps, SuggestionGroup, UseSuggestOptions, UseSuggestReturn, SuggestSearchOptions, } from './components/Suggest';
 export { Collapsible, CollapsibleItem, CollapsibleContext, useCollapsibleContext } from './components/Collapsible';
-export type { CollapsibleProps, CollapsibleItemProps, CollapsibleContextValue, CollapsibleVariant, CollapsibleSize, CollapsibleColor, CollapsibleIconPosition, CollapsibleExpansionMode, CollapsibleAuthorize, } from './components/Collapsible';
+export type { CollapsibleProps, CollapsibleItemProps, CollapsibleContextValue, CollapsibleVariant, CollapsibleSize, CollapsibleColor, CollapsibleIconPosition, CollapsibleExpansionMode, CollapsibleAuthorize, CollapsibleDisclosure, CollapsibleTone, CollapsibleHeadingLevel, } from './components/Collapsible';
 export { Fields, Field } from './components/Fields';
 export { useFieldCondition, useFieldRender, useFieldDisabled, useFieldValue, useFieldChange, useFieldBlur, useFieldValidation, useFieldSelect, } from './components/Fields';
 export type { FieldsProps, FieldProps, FieldsBaseProps, FieldsWithSetState, FieldsWithOnChange, FieldDefinition, FieldsDefinition, FieldAuthorize, FieldTooltipProps, FieldComponentRegistry, FieldEditableTableProps, BaseFieldDefinition, InputFieldDefinition, SwitchFieldDefinition, SelectFieldDefinition, SuggestFieldDefinition, RadioFieldDefinition, CheckboxFieldDefinition, ButtonFieldDefinition, ChildFieldDefinition, EditableTableFieldDefinition, ChipInputFieldDefinition, ConditionOperator, ConditionCompareType, ConditionObject, ConditionRegexObject, ConditionFunction, ConditionSimpleKey, Condition, ConditionContext, NestedKeys, NestedValue, ResetKeyConfig, SelectCopyKeyConfig, ChangeContext, ChangeAdditionalDataContext, SelectAdditionalDataContext, EditableTableCustomPropContext, ErrorObject, TouchedObject, } from './components/Fields';
@@ -44,7 +44,9 @@ export * from './components/Charts';
 export * from './components/Scroll';
 export { ColorSchemeSelect } from './components/ColorSchemeSelect';
 export type { ColorSchemeSelectProps } from './components/ColorSchemeSelect';
-export { UIProvider, useUIPortalContainer, useUITheme } from './components/UIProvider';
+export { UIProvider, useUIPortalContainer, useUITheme, FormatProvider, useFormat, LabelsProvider, useUILabels, DEFAULT_UI_LABELS } from './components/UIProvider';
+export type { FormatProviderProps, UILabels, UILabelsInput } from './components/UIProvider';
+export type { UIFormat, UIFormatSettings } from './core/types';
 export type { UIProviderProps, UITheme, ResolvedUITheme, UIThemeValue } from './components/UIProvider';
 export { Skeleton } from './components/Skeleton';
 export type { SkeletonProps, SkeletonVariant, SkeletonAnimation } from './components/Skeleton';
@@ -66,6 +68,11 @@ export { useDialog } from './components/Dialog/DialogHost';
 export type { DialogApi, DialogChoice, DialogActionProps, ConfirmOptions, ChooseOptions, AlertOptions, } from './components/Dialog/DialogHost';
 export { ToastHost, useToast } from './components/Toast';
 export type { ToastApi, ToastDefaults, ToastOptions, ToastPosition, ToastRecord, ToastType, ToastHostProps, } from './components/Toast';
+export { createFileEngine, FileEngineError } from './file/fileEngine';
+export type { FileEngine, CreateFileEngineOptions, FileJobRequest, FileBuildContext, FileDeliverer, FileEngineErrorCode, } from './file/fileEngine';
+export type { FileFormat, FileDeliveryAction, FileJobAction, FileJobPriority, FileJobStatus, FileJob, FileEngineOptions, FileTask, XlsxWorkbookSpec, XlsxSheetSpec, XlsxColumnSpec, XlsxCellValue, PdfTaskFonts, } from './core/types';
+export { FileEngineProvider, FileJobsTray, useFileEngine, useFileJob, DEFAULT_FILE_ENGINE_LABELS, } from './components/FileEngine';
+export type { FileEngineProviderProps, FileJobsTrayProps, UseFileEngineResult, FileEngineLabels, FileEngineLabelsInput, } from './components/FileEngine';
 export { Stepper } from './components/Stepper';
 export type { StepperProps, StepperStep } from './components/Stepper';
 export { Tabs, TabPanel } from './components/Tabs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcs-tech/ui",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "React UI component library — fields, buttons, tooltips, tables and design tokens.",
   "license": "UNLICENSED",
   "type": "module",