@dcs-tech/ui 0.2.0 → 0.4.0

package/dist/types/{shared-types/src/ui → core/types}/select.types.d.ts

@@ -60,15 +60,6 @@ export interface VirtualScrollConfig {
     overscan?: number;
     maxHeight?: number;
 }
-/**
- * @deprecated Superseded by `FieldKeyboardConfig`, which every field now takes.
- *
- * All six were per-component restatements of decisions the shared resolver
- * makes: `preventEnter`/`preventEnterToOpen`/`selectOnEnter` are what Enter does
- * given the popup state, `closeOnEscape`/`closeOnTab` are what Escape and Tab
- * do, and `navigateWithArrows` is law L1. They are accepted and ignored so
- * existing call sites keep compiling; nothing reads them.
- */
 export interface KeyboardConfig {
     preventEnter?: boolean;
     preventEnterToOpen?: boolean;
@@ -96,10 +87,6 @@ export interface LoadingConfig {
     loadingText?: string;
     renderLoadingState?: () => ReactNode;
 }
-/**
- * @deprecated Superseded by `FieldA11yProps` in `field.types`, which every field
- * now gets from `BaseFieldProps`. Kept because the published barrel exports it.
- */
 export interface SelectAccessibilityConfig {
     'aria-label'?: string;
     'aria-labelledby'?: string;
@@ -107,19 +94,9 @@ export interface SelectAccessibilityConfig {
     'aria-required'?: boolean;
     'aria-invalid'?: boolean;
 }
-/**
- * Select has no DOM event to forward, so it emits the shared shape directly.
- *
- * It used to carry `target.attributes.cellindex.value`, mimicking a DOM node so
- * a grid could read the cell back off the event. Nothing ever read it — the
- * grid tracks focus through `onCellFocus` — and its presence meant a handler
- * typed for any other field could not be passed to a Select. Removing it is
- * what makes one `(e: FieldChangeEvent) => void` work across the whole family.
- */
 export type SelectEvent = FieldChangeEvent<any>;
 export interface SelectProps extends TextFieldProps<any, HTMLDivElement, SelectEvent>, FieldPopupProps {
     options: (string | number | SelectOption)[];
-    /** Required, unlike the base: a Select that cannot report a choice is inert. */
     onChange: (event: SelectEvent) => void;
     defaultText?: string;
     autoFocusSearch?: boolean;
@@ -130,15 +107,6 @@ export interface SelectProps extends TextFieldProps<any, HTMLDivElement, SelectE
     reorder?: boolean | ReorderConfig;
     group?: boolean | GroupConfig;
     virtualScroll?: boolean | VirtualScrollConfig;
-    /**
-     * The shared policy, intersected with Select's own six booleans.
-     *
-     * `KeyboardConfig`'s members are all expressible in `FieldKeyboardConfig`
-     * — `preventEnter`, `selectOnEnter` and `navigateWithArrows` are exactly the
-     * per-widget rules the shared resolver owns — so this intersection is the
-     * transition state, not the destination. Step 0c folds the six in and
-     * deletes `KeyboardConfig`.
-     */
     keyboard?: FieldKeyboardConfig & KeyboardConfig;
     position?: DropdownPosition | PositionConfig;
     emptyState?: EmptyStateConfig;
@@ -159,9 +127,7 @@ export interface SelectProps extends TextFieldProps<any, HTMLDivElement, SelectE
     renderOption?: (option: SelectOption, isSelected: boolean, isHighlighted: boolean) => ReactNode;
     renderSelectedValue?: (value: any | any[], options: SelectOption[]) => ReactNode;
     renderChip?: (option: SelectOption, onRemove: () => void) => ReactNode;
-    /** @deprecated Use `onOpenChange`, which reports *why* — the grid needs the reason. */
     onOpen?: () => void;
-    /** @deprecated Use `onOpenChange`. */
     onClose?: () => void;
     onSearch?: (searchTerm: string) => void;
     onSelect?: (value: any) => void;
@@ -194,17 +160,10 @@ export interface UseSelectReturn {
         handleToggle: () => void;
         handleSelect: (option: SelectOption) => void;
         handleMultiSelect: (option: SelectOption) => void;
-        /**
-         * Highlight primitives, driven by `resolveFieldKey` through `useField`.
-         * They replace a `handleKeyDown` that returned a boolean telling the
-         * parent whether to also handle the key — the second of this
-         * component's two arbitration mechanisms.
-         */
         highlightNext: () => void;
         highlightPrev: () => void;
         highlightFirst: () => void;
         highlightLast: () => void;
-        /** @returns whether an option was actually picked. */
         pickHighlighted: () => boolean;
         handleSearchChange: (event: ChangeEvent<HTMLInputElement>) => void;
         handleClickOutside: (event: MouseEvent) => void;

package/dist/types/{shared-types/src/ui → core/types}/suggest.types.d.ts

@@ -47,9 +47,7 @@ export interface SuggestionItemProps {
 export interface SuggestionListProps<T = any> {
     suggestions: T[];
     renderKeys: RenderKey[];
-    /** Drives the shared popup list's size variables. Defaults to `small`. */
     size?: SuggestSize;
-    /** Decides the popup's shape — joined to a boxed field, or a floating panel. */
     variant?: SuggestVariant;
     onSelect: (item: T) => void;
     highlightedIndex: number;
@@ -65,6 +63,7 @@ export interface SuggestionListProps<T = any> {
     containerRef: RefObject<HTMLDivElement | null>;
     portal?: boolean;
     zIndex?: number;
+    exiting?: boolean;
     renderItem?: (item: T, isHighlighted: boolean, searchValue: string) => ReactNode;
     renderEmptyState?: (searchValue: string) => ReactNode;
     renderGroup?: (groupName: string, items: T[]) => ReactNode;
@@ -72,9 +71,7 @@ export interface SuggestionListProps<T = any> {
 export interface SuggestProps extends TextFieldProps<string, HTMLInputElement, ChangeEvent<HTMLInputElement>>, FieldPopupProps {
     data: any[];
     config: SuggestionConfig;
-    /** Required, unlike the base: a Suggest with no value has nothing to search on. */
     value: string;
-    /** Required, unlike the base: a Suggest that cannot report typing is inert. */
     onChange: (event: ChangeEvent<HTMLInputElement>) => void;
     onSelect?: (item: any, inputName?: string) => void;
     onClear?: () => void;
@@ -119,16 +116,10 @@ export interface UseSuggestReturn {
     loading: boolean;
     handleInputChange: (event: ChangeEvent<HTMLInputElement>) => void;
     handleSelect: (item: any, index: number) => void;
-    /**
-     * Highlight primitives, driven by `resolveFieldKey` through `useField`.
-     * These replace the hook's old `handleKeyDown`, which claimed the arrow keys
-     * whether or not the list was open.
-     */
     highlightNext: () => void;
     highlightPrev: () => void;
     highlightFirst: () => void;
     highlightLast: () => void;
-    /** @returns whether an item was actually picked. */
     pickHighlighted: () => boolean;
     handleFocus: () => void;
     handleBlur: () => void;

package/dist/types/{shared-types/src/ui → core/types}/switch.types.d.ts

@@ -8,10 +8,6 @@ export type SwitchColor = FieldColor;
 export interface SwitchProps extends ToggleFieldProps<string | number, HTMLInputElement, ChangeEvent<HTMLInputElement>> {
     checked?: boolean;
     defaultChecked?: boolean;
-    /**
-     * @deprecated Use `hint` — the shared name for this slot, which is what
-     * FieldWrapper renders. Kept until the components migrate (step 0c).
-     */
     helperText?: string | ReactNode;
     onText?: string;
     offText?: string;

package/dist/types/{shared-types/src/ui → core/types}/table.types.d.ts

@@ -1,17 +1,4 @@
 import type { ReactNode } from 'react';
-/**
- * The table vocabulary, shared.
- *
- * These are the client `Table`'s own column and summary props
- * (`apps/web/client/src/Utils/CustomElements/Table/types.ts`), lifted into the
- * shared layer so the editable table can speak the same language. A developer
- * who has configured a report table already knows every name here — `width`,
- * `minWidth`, `align`, `sticky`, `summable`, `summary`, `cell`, `cellStyle` —
- * and a summary written for a report table works on an editable one unchanged.
- *
- * The rule the editable table follows: **everything is a prop, and where the
- * Table already has a prop for something, use that exact prop.**
- */
 export type ColumnAlign = 'left' | 'center' | 'right';
 export type ColumnSticky = 'left' | 'right';
 export interface CellStyle {
@@ -31,11 +18,6 @@ export interface ColumnSummaryConfig<T = any> {
     filter?: (row: T) => boolean;
     formatter?: (value: number, rows: T[]) => string;
 }
-/**
- * What a summary `compute` receives. Shaped like the Table's context so a
- * summary written there runs here; the members an editable table has no
- * equivalent for (selection, filters) are optional.
- */
 export interface SummaryContext {
     allRows: any[];
     visibleColumns: string[];
@@ -43,7 +25,6 @@ export interface SummaryContext {
     filters?: unknown[];
     context?: Record<string, any>;
 }
-/** The Table names this `LicenseConfig`; renamed here only to avoid a barrel collision. */
 export interface SummaryLicenseConfig {
     tab: string;
     subtab: string;
@@ -52,12 +33,6 @@ export interface SummaryLicenseConfig {
 export interface SummaryItem<T = any> {
     id: string;
     label: string;
-    /**
-     * `resolved` carries every column total and every earlier item, keyed by id —
-     * so *average cost = total cost / total qty* reads the column totals rather
-     * than recomputing them. Column totals use the Table's id scheme,
-     * `col_<column>_<type>`, unless the column's summary names its own `id`.
-     */
     compute: (data: T[], context: SummaryContext, resolved: Record<string, number | string>) => string | number;
     format?: SummaryFormat;
     decimals?: number;
@@ -81,7 +56,6 @@ export interface SummaryGroupKey {
     formatter?: (value: any) => string;
     bold?: boolean;
     color?: string;
-    /** Force-hide. Left unset, a key the group's `compute` omitted is hidden automatically. */
     hidden?: boolean;
 }
 export interface SummaryGroup<T = any> {
@@ -121,71 +95,38 @@ export interface ResolvedSummaryGroup {
     hidden: boolean;
     license?: SummaryLicenseConfig;
 }
-/** One column's total, for the footer row. */
 export interface ResolvedColumnTotal {
-    /** The column's `name`. */
     column: string;
-    /** Table-compatible id — `summary.id` or `col_<column>_<type>`. */
     id: string;
     type: SummaryAggregation;
     label: string;
     rawValue: number;
     value: string;
 }
-/**
- * The layout and display half of a table column — the Table's props.
- *
- * On an editable table these sit beside the field definition (`field`, `name`,
- * `fprop`…). Every one is optional: when a column names none of them,
- * `resolveColumnLayout` supplies a default by widget, so an unconfigured column
- * still lays out well. **Prop → default**, the same order as `size` and
- * `keyboard`.
- */
 export interface TableColumnDisplayProps<T = any> {
-    /** Fixed width in px. A column with a width is fixed; one without shares the remaining space. */
     width?: number;
-    /** Floor in px before the table scrolls sideways. Ignored for a fixed column, whose floor is its width. */
     minWidth?: number;
     align?: ColumnAlign;
-    /** Pin while scrolling sideways. A sticky column is always fixed-width, so offsets stay exact. */
     sticky?: ColumnSticky;
-    /** Shorthand for `summary: { type: 'sum' }`. */
     summable?: boolean;
     summary?: ColumnSummaryConfig<T>;
-    /**
-     * Render the value as text instead of a field. For derived values — T.Cost —
-     * that are results, not inputs. Keyboard navigation skips a read-only cell.
-     */
     readOnly?: boolean;
-    /** Custom read-only content. Implies `readOnly`. */
     cell?: (value: any, row: T, index: number) => ReactNode;
     cellStyle?: (value: any, row: T) => CellStyle | undefined;
 }
-/** What `resolveColumnLayout` hands the renderer — every decision made, nothing optional left to guess. */
 export interface ResolvedColumnLayout {
-    /** Present for fixed columns; absent for flexible ones, which share the remainder. */
     width?: number;
     minWidth: number;
     align: ColumnAlign;
     fixed: boolean;
     sticky?: ColumnSticky;
-    /** px from the pinned edge, cumulative across pinned columns on the same side. */
     stickyOffset?: number;
-    /** The innermost pinned column on its side — draws the divider where scrolling content passes under. */
     stickyEdge?: boolean;
-    /**
-     * Flexible columns only: this column's share of the space the fixed columns leave,
-     * in proportion to its floor. Proportional rather than equal on purpose — an equal
-     * split can hand a 300px-floor column less than its floor while a 50px one gets
-     * spare, even though the table as a whole is above its minimum width.
-     */
     flexShare?: number;
 }
 export interface ResolvedTableLayout {
     columns: ResolvedColumnLayout[];
-    /** Σ of every column's floor. The table scrolls sideways only below this. */
     minTableWidth: number;
-    /** Σ of the fixed columns' widths — what a flexible column's share is taken from the rest of. */
     fixedWidthTotal: number;
     hasSticky: boolean;
 }

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

@@ -0,0 +1,43 @@
+import type { ReactElement, ReactNode } from 'react';
+export type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+export type TooltipTrigger = 'icon' | 'control';
+export type TooltipAnchorTo = 'auto' | 'element' | 'pointer';
+export interface TooltipConfig {
+    content: ReactNode;
+    placement?: TooltipPlacement;
+    anchorTo?: TooltipAnchorTo;
+    delay?: number;
+    closeDelay?: number;
+    disabled?: boolean;
+    className?: string;
+}
+export type TooltipProp = ReactNode | TooltipConfig;
+export interface TooltipProps extends TooltipConfig {
+    children: ReactElement;
+    id?: string;
+}
+export interface TooltipRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export interface TooltipPositionInput {
+    anchor: TooltipRect;
+    tooltip: {
+        width: number;
+        height: number;
+    };
+    viewport: {
+        width: number;
+        height: number;
+    };
+    placement: TooltipPlacement;
+    offset: number;
+    margin?: number;
+}
+export interface TooltipPosition {
+    top: number;
+    left: number;
+    placement: TooltipPlacement;
+}

package/dist/types/{shared-types/src/ui → core/types}/typography.types.d.ts

@@ -28,10 +28,6 @@ export interface TypographyProps extends DataAttributes {
     gutterBottom?: boolean;
     noWrap?: boolean;
     truncate?: boolean | TruncateConfig;
-    /**
-     * Explicit tooltip. Without it, `truncate.tooltip` supplies one from the text
-     * itself — and that one only appears when the text is genuinely clipped.
-     */
     tooltip?: TooltipProp;
     inline?: boolean;
     gradient?: GradientConfig;

package/dist/types/index.d.ts

@@ -0,0 +1,86 @@
+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, } 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 } from './components/UIProvider';
+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 { 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,62 +1,63 @@
 {
   "name": "@dcs-tech/ui",
-  "version": "0.2.0",
+  "version": "0.4.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 @pdfinvoice/* packages are BUILD-TIME only. The build inlines them into dist, and they are private — if they were runtime dependencies npm would try to fetch them from the registry and every install would fail.",
-  "devDependencies": {
-    "@pdfinvoice/shared-logic": "*",
-    "@pdfinvoice/shared-styles": "*",
-    "@pdfinvoice/shared-types": "*",
-    "@pdfinvoice/shared-web-ui": "*",
-    "@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": {
-    "fuse.js": "^7.5.0",
-    "match-sorter": "^8.1.0"
-  }
+  ]
 }

package/dist/types/published/dcs-ui/src/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * The public API of @dcs-tech/ui.
- *
- * The reference above is load-bearing: the declaration bundler builds its program
- * from this entry file alone, ignoring tsconfig `include`, so without it the
- * ambient `*.module.css` declaration is missing and every component that imports
- * a stylesheet fails with TS2307.
- *
- * This barrel IS the published surface. Nothing reaches the registry unless it is
- * re-exported here, which is why the library can live in a monorepo alongside
- * private business code without leaking any of it.
- *
- * TWO KINDS OF LINE BELOW, and the difference matters:
- *
- *   `export *` from shared-web-ui
- *       Automatic. That package is components-only — it imports UI types and
- *       nothing else — so a new component appears in the next release with no
- *       edit here.
- *
- *   Named exports from shared-logic
- *       Deliberate. Those packages also contain this business's own domain, so
- *       exporting by name is the gate that keeps it private. NEVER turn these
- *       into `export *`.
- *
- * And note what this barrel does NOT govern: `tsc` emits declarations for the whole
- * program, so it never controlled `dist/types/`. That is what `src/publicLogic.ts` and
- * `src/publicTypes.ts` are for, and what `verify:no-leak` checks.
- */
-export * from '../../../shared-web-ui/src';
-export { buildFieldControlClassKeys, buildPopupListClassKeys, buildPopupRowClassKeys, computeTooltipPosition, normalizeTooltip, resolveTooltipPlacementOrder, shouldAnchorToPointer, useMergeRefs, } from './publicLogic';
-export type { FieldControlClassOptions, PopupListClassOptions, PopupRowClassOptions, TooltipAnchorDecision, } from './publicLogic';
-import '../../../shared-styles/index.css';

package/dist/types/published/dcs-ui/src/publicLogic.d.ts

@@ -1,35 +0,0 @@
-/**
- * What `@pdfinvoice/shared-logic` means INSIDE the published build.
- *
- * `tsconfig.json` maps the package specifier to this file, so every `from
- * './publicLogic'` in the component sources — 58 of them in `shared-web-ui` alone —
- * resolves here instead of to the package barrel. The domain folders beside `ui/` then never enter the TypeScript program, so no declaration is ever emitted for them.
- *
- * This is the fix for the leak audited on 2026-09-28: `tsc` emits declarations for the whole
- * PROGRAM, so the `export *` gate in `index.ts` — which governs the JS surface, and does govern
- * it correctly — never applied to `dist/types/`. Mapping the specifier is what makes the two
- * surfaces agree.
- *
- * Anything added here ships publicly. The bar: is it generic UI, or is it this business?
- */
-export * from '../../../shared-logic/src/ui';
-/**
- * The report engine, which is deliberately publishable.
- *
- * `ReportDesigner` is a published component and its props are typed in terms of these, so they
- * are part of the public API whether or not they are named here. That is sound: the banded
- * template model was designed DOMAIN-FREE from the start precisely so it could be published —
- * it describes bands, columns and placeholders, not invoices. See `docs/REPORT_ENGINE.md`.
- *
- * `export *` here, unlike the package barrel, and the difference is verified rather than
- * assumed: `report/` imports NO domain sibling at all (checked 2026-09-28 — not one relative
- * import escapes the folder into a business module). It is a closed, generic module, so
- * re-exporting it whole cannot pull the business in behind it.
- *
- * Listing these by name was tried first and is not practical: `ReportDesigner` and
- * `ReportPreview` are published components typed against ~30 of these symbols, so a named list
- * would be a second copy of `report/index` that silently rots whenever an editor gains a
- * prop. The guard that matters is `verify:no-leak`, which fails the build if a domain term
- * ever reaches `dist/` — including through this line, should `report/` stop being closed.
- */
-export * from '../../../shared-logic/src/report/index';

package/dist/types/published/dcs-ui/src/publicTypes.d.ts

@@ -1,14 +0,0 @@
-/**
- * What `@pdfinvoice/shared-types` means INSIDE the published build.
- *
- * The twin of `publicLogic.ts`, for the same reason and by the same mechanism: `tsconfig.json`
- * maps the package specifier here, so the component sources resolve to this instead of to the
- * package barrel — so the folders describing this business's own records never enter the
- * program, or the declarations emitted from it.
- *
- * Both halves are verified self-contained (2026-09-28): neither `shared-types/src/ui` nor
- * `shared-types/src/report` imports a domain sibling, so re-exporting them whole cannot pull
- * the business in behind them. `verify:no-leak` is the standing guard if that ever changes.
- */
-export * from '../../../shared-types/src/ui';
-export * from '../../../shared-types/src/report';

package/dist/types/shared-logic/src/report/aggregate.d.ts

@@ -1,29 +0,0 @@
-/**
- * Report engine — the fixed aggregate set.
- *
- * Eight functions, and deliberately no ninth mechanism. Crystal Reports' expression language is
- * a parser, an editor, a sandbox and a debugger, and it is where projects like this one die.
- * Anything past this list becomes a field the app computes. See `docs/REPORT_ENGINE.md` §7.
- *
- * What an aggregate covers is named in the call itself:
- *   `agg.sum(row.total)`     — the rows of the table or section the text sits in
- *   `agg.sum(group.qty)`     — one group value, across the rows under a group column
- *   `agg.sum(items.total)`   — a whole row set, exactly as the app passed it
- */
-import type { ReportAggregate } from '../../../published/dcs-ui/src/publicTypes';
-/** `%agg.sum(row.total)%` — parsed once so the resolver does not re-parse per row. */
-export interface AggregateCall {
-    kind: ReportAggregate;
-    /** `row`, `group`, or a row set key. */
-    over: string;
-    /** Path within each row, e.g. `total`. */
-    field: string;
-}
-/** Returns null when `expr` is not an aggregate call, so callers can fall through to a path read. */
-export declare const parseAggregate: (expr: string) => AggregateCall | null;
-/**
- * `count` counts rows, not values — a row with a blank total still happened. `distinct` counts the
- * different non-blank values. Every other aggregate ignores rows where the field is absent, so an
- * average is over the rows that have one.
- */
-export declare const computeAggregate: (call: Pick<AggregateCall, "kind" | "field">, rows: Array<Record<string, unknown>>) => number;