@dcs-tech/ui 0.3.0 → 0.6.0

package/dist/types/{shared-web-ui/src/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

@@ -0,0 +1,93 @@
+export { Tooltip, TooltipHelpIcon, useTooltip } from './components/Tooltip';
+export type { TooltipHelpIconProps, UseTooltipResult } from './components/Tooltip';
+export type { TooltipProps, TooltipProp, TooltipConfig, TooltipPlacement, TooltipTrigger, } from './core/types';
+export { Typography } from './components/Typography';
+export type { TypographyProps, TypographyVariant, TypographyColor, TypographyAlign, TypographyWeight, TypographyTransform, TypographyDecoration, TypographyComponent, TruncateConfig, GradientConfig, } from './components/Typography';
+export { Button, ButtonGroup } from './components/Button';
+export type { ButtonProps, ButtonGroupProps, ButtonVariant, ButtonSize, ButtonColor, ButtonShape, LoadingPosition, GroupOrientation, ButtonGroupContextValue, } from './components/Button';
+export { FieldWrapper } from './components/FieldWrapper';
+export type { FieldWrapperProps, FieldLayout, FieldSize, } from './components/FieldWrapper';
+export { FieldContext, FieldProvider, useFieldContext, useFieldSurface, useToggleSurface, useField, useFormKeyboard, } from './components/FieldContext';
+export type { FieldContextValue, FieldProviderProps, FieldSurfaceInput, FieldSurfaceDefaults, ResolvedFieldSurface, ResolvedToggleSurface, UseFieldOptions, UseFieldResult, UseFormKeyboardOptions, } from './components/FieldContext';
+export type { BaseFieldProps, TextFieldProps, ToggleFieldProps, FieldIdentityProps, FieldChromeProps, FieldA11yProps, FieldInteractionProps, FieldSurfaceProps, ControlSurfaceProps, ToggleSurfaceProps, FieldPopupProps, FieldHandle, FieldFocusEvent, OpenReason, FieldKeyboardConfig, FieldWidget, FieldKeyState, FieldKeyAction, KeyResolution, KeyEventLike, NavAction, GridMode, } from './core/types';
+export type { ControlSize, ControlVariant, ControlLayout, ControlLabelPosition, ToggleVariant, SemanticColor, FieldColor, FieldChangeEvent, FieldChangeTarget, FieldCellContext, } from './core/types';
+export { DEFAULT_CONTROL_SIZE } from './core/types';
+export { Checkbox, CheckboxGroup } from './components/Checkbox';
+export type { CheckboxProps, CheckboxGroupProps, CheckboxVariant, CheckboxSize, CheckboxLabelPosition, CheckboxColor, CheckboxGroupContextValue, } from './components/Checkbox';
+export { Radio, RadioGroup } from './components/Radio';
+export type { RadioProps, RadioGroupProps, RadioVariant, RadioSize, RadioLabelPosition, RadioColor, RadioGroupContextValue, } from './components/Radio';
+export { Switch } from './components/Switch';
+export type { SwitchProps, SwitchSize, SwitchLabelPosition, SwitchColor, } from './components/Switch';
+export { Input } from './components/Input';
+export type { InputProps, InputType, InputVariant, InputSize, InputLayout, ValidationConfig, IconConfig, } from './components/Input';
+export { Select, useSelect } from './components/Select';
+export type { SelectProps, SelectOption, SelectSize, SelectLayout, SelectState, SelectEvent, SelectAccessibilityConfig, UseSelectReturn, UseSelectConfig, MultiSelectConfig, SearchConfig, SortConfig, ReorderConfig, GroupConfig, VirtualScrollConfig, KeyboardConfig, DropdownPosition, PositionConfig, EmptyStateConfig, LoadingConfig, ChipProps, GroupDisplayProps, OptionItemProps, AutoScrollState, DropdownDimensions, OptionValue, } from './components/Select';
+export { DatePicker, Calendar } from './components/DatePicker';
+export type { DatePickerProps, DatePickerBaseProps, DatePickerSingleProps, DatePickerRangeProps, DateRangeValue, DateDisplayFormat, DateTextOrder, CalendarProps, } from './components/DatePicker';
+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, 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';
+export { Form } from './components/Form';
+export type { FormProps, FormMethods, FormSection, FormAction, FormValidation, FormHeader, FormFooter, FormCallbacks, FormState, FormLayout, FormSize, FormVariant, } from './components/Form';
+export { ChipInput, useChipSuggestions } from './components/ChipInput';
+export { parseFormat, resolveFormat, extractPlaceholders, validateFormat, } from './components/ChipInput';
+export type { ChipInputProps, ChipInputSize, ChipInputLayout, ChipKey, ChipSource, ChipSources, ChipSuggestionItem, GroupedSuggestions, ParsedSegment, ResolveOptions, ExtractedPlaceholder, FormatValidationResult, UseChipSuggestionsOptions, UseChipSuggestionsReturn, } from './components/ChipInput';
+export { EditableTable, EditableTableRow, EditableTableActions, EditableTableCell, EditableTableSummary, useEditableTable } from './components/EditableTable';
+export type { EditableTableProps, EditableTableRowProps, EditableTableActionsProps, EditableTableColumnDefinition, EditableTableFocusState, EditableTableCopyConfig, EditableTableAddConfig, EditableTableDeleteConfig, EditableTableFooterConfig, EditableTableSummaryContext, EditableTableSummaryActions, TableColumnDisplayProps, TableSummaryConfig, ColumnSummaryConfig, SummaryItem, SummaryGroup, CellStyle, ColumnAlign, ColumnSticky, } from './components/EditableTable';
+export * from './components/DataTable';
+export * from './components/Charts';
+export * from './components/Scroll';
+export { ColorSchemeSelect } from './components/ColorSchemeSelect';
+export type { ColorSchemeSelectProps } from './components/ColorSchemeSelect';
+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';
+export { Badge } from './components/Badge';
+export type { BadgeProps, BadgeColor, BadgeVariant, BadgeSize } from './components/Badge';
+export { Avatar, AvatarGroup } from './components/Avatar';
+export type { AvatarProps, AvatarGroupProps, AvatarSize, AvatarShape } from './components/Avatar';
+export { Card } from './components/Card';
+export type { CardProps, CardVariant, CardPadding } from './components/Card';
+export { Popover } from './components/Popover';
+export type { PopoverProps } from './components/Popover';
+export { DropdownMenu } from './components/DropdownMenu';
+export type { DropdownMenuProps, DropdownMenuItem } from './components/DropdownMenu';
+export { ImagePicker, ImageStrip, ImageViewer, prepareImage, ImagePrepareError } from './components/Image';
+export type { ImagePickerProps, ImagePickerItem, ImageStripProps, StripImage, ImageViewerProps, ViewerImage, PrepareImageOptions, PreparedImage, } from './components/Image';
+export { Dialog } from './components/Dialog';
+export type { DialogProps, DialogPlacement, DialogSize } from './components/Dialog';
+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';
+export type { TabsProps, TabItem, TabsVariant, TabsSize, TabPanelProps } from './components/Tabs';
+export { CommandPalette } from './components/CommandPalette';
+export type { CommandPaletteProps, CommandPaletteItem } from './components/CommandPalette';
+export { Sidebar } from './components/Sidebar';
+export type { SidebarProps } from './components/Sidebar';
+export { AppBar } from './components/AppBar';
+export type { AppBarProps, AppBarSize, AppBarVariant } from './components/AppBar';
+export { Breadcrumbs } from './components/Breadcrumbs';
+export type { BreadcrumbsProps } from './components/Breadcrumbs';
+export type { NavItem } from './core/types';
+export { useArrowKeyFocus } from './components/ArrowKeyFocus/useArrowKeyFocus';
+export type { ArrowKeyFocusOptions, ArrowKeyFocusHandlers } from './components/ArrowKeyFocus/useArrowKeyFocus';
+export { buildFieldControlClassKeys, buildPopupListClassKeys, buildPopupRowClassKeys, computeTooltipPosition, normalizeTooltip, resolveTooltipPlacementOrder, shouldAnchorToPointer, useMergeRefs, } from './core/logic';
+export type { FieldControlClassOptions, PopupListClassOptions, PopupRowClassOptions, TooltipAnchorDecision, } from './core/logic';
+import './styles/index.css';

package/package.json

@@ -1,64 +1,63 @@
 {
   "name": "@dcs-tech/ui",
-  "version": "0.3.0",
+  "version": "0.6.0",
   "description": "React UI component library — fields, buttons, tooltips, tables and design tokens.",
   "license": "UNLICENSED",
   "type": "module",
   "sideEffects": [
     "*.css"
   ],
-  "//files": "Allowlist, not a denylist: only dist ships. package.json, README and LICENSE are always included. Verify with `npm pack --dry-run` before every release.",
   "files": [
     "dist"
   ],
   "main": "./dist/index.js",
-  "types": "./dist/types/published/dcs-ui/src/index.d.ts",
+  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/types/published/dcs-ui/src/index.d.ts",
+      "types": "./dist/types/index.d.ts",
       "import": "./dist/index.js"
     },
     "./style.css": "./dist/style.css",
     "./package.json": "./package.json"
   },
-  "//publishConfig": "Scoped packages default to restricted; this makes every publish public without needing --access public each time.",
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "vite build && npm run build:types && npm run verify:types && npm run verify:no-leak",
-    "prepublishOnly": "npm run build",
-    "pack:check": "npm run build && npm pack --dry-run",
-    "clean": "rm -rf dist",
-    "build:types": "tsc -p tsconfig.json && node scripts/relativize-types.mjs",
+    "build": "vite build && npm run build:types && npm run verify:types && npm run verify:no-leak && npm run verify:tokens",
+    "build:types": "tsc -p tsconfig.build.json",
     "verify:types": "tsc -p tsconfig.verify.json",
-    "//verify:no-leak": "Fails the build if dist/ mentions this business. 0.1.0 shipped the domain type surface publicly; this is what stops it happening twice.",
-    "verify:no-leak": "node scripts/verify-no-leak.mjs"
+    "verify:no-leak": "node scripts/verify-no-leak.mjs",
+    "verify:tokens": "node scripts/verify-tokens.ts",
+    "verify:contrast": "node scripts/verify-contrast.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "pack:check": "npm run build && npm pack --dry-run",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
   },
-  "//devDependencies": "The private sibling packages this is built from are deliberately NOT listed: this file ships, so listing them published their names. The build reads them as relative source paths and through the workspace links, so it needs no entry here.",
-  "devDependencies": {
-    "@vitejs/plugin-react": "^6.0.4",
-    "typescript": "^5.9.3",
-    "vite": "^8.1.5"
+  "dependencies": {
+    "@tanstack/match-sorter-utils": "^8.19.4",
+    "@tanstack/react-table": "^8.21.3",
+    "@tanstack/react-virtual": "3.14.13",
+    "exceljs": "^4.4.0",
+    "fuse.js": "^7.5.0",
+    "match-sorter": "^8.1.0",
+    "pdfmake": "^0.2.7",
+    "react-icons": "^5.7.0"
   },
   "peerDependencies": {
     "react": ">=18",
     "react-dom": ">=18"
   },
+  "devDependencies": {
+    "@storybook/react-vite": "^10.5.5",
+    "@types/pdfmake": "^0.2.7"
+  },
   "keywords": [
     "react",
     "ui",
     "components",
     "design-system"
-  ],
-  "dependencies": {
-    "@tanstack/match-sorter-utils": "^8.19.4",
-    "@tanstack/react-table": "^8.21.3",
-    "@tanstack/react-virtual": "3.14.13",
-    "exceljs": "^4.4.0",
-    "fuse.js": "^7.5.0",
-    "match-sorter": "^8.1.0",
-    "pdfmake": "^0.2.7",
-    "react-icons": "^5.7.0"
-  }
+  ]
 }