@ahrowe/ui 0.35.0 → 0.36.0

package/dist/cjs-types/common/virtualList/virtualList.utils.d.ts

@@ -0,0 +1,126 @@
+import { ColumnWidthSpec, SortValue, VirtualListColumn, VirtualListSort } from './virtualList.types.js';
+export declare function buildOffsets(keys: (string | number)[], heightsMap: Map<string | number, number>, estimatedRowHeight: number, rowGap?: number): {
+    offsets: number[];
+    totalHeight: number;
+};
+/** Index of the row that sits at `scrollTop` — i.e. the first row whose bottom edge is below it. */
+export declare function findStartIndex(offsets: number[], scrollTop: number, itemCount: number): number;
+export declare function getVisibleRange(offsets: number[], scrollTop: number, containerHeight: number, overscan: number, itemCount: number): {
+    startIndex: number;
+    endIndex: number;
+};
+/**
+ * Decides where a dragged row should move to, applying midpoint hysteresis: a
+ * move only happens once the pointer has crossed the centre of the row it is
+ * over (downwards when moving down, upwards when moving up). Returns the target
+ * index, or null if no move should occur. Pure for easy unit testing.
+ */
+export declare function resolveReorderTarget(fromIndex: number, overIndex: number, pointerY: number, rowTop: number, rowHeight: number): number | null;
+/**
+ * Decides where a tree-reorder drop should land relative to the row under the
+ * pointer. Group rows expose three zones (top third → `before`, middle →
+ * `inside`, bottom third → `after`); leaf rows split in half (`before`/`after`)
+ * since they can't receive children. Pure for easy unit testing.
+ */
+export declare function resolveTreeDropTarget(pointerY: number, rowTop: number, rowHeight: number, isGroup: boolean): 'before' | 'inside' | 'after';
+/**
+ * Index of the last descendant of the node at `index` in a depth-tagged flat
+ * list (a contiguous run of following rows with a greater depth). Returns
+ * `index` itself when the node has no children. A drop is forbidden anywhere in
+ * `[index, lastDescendantIndex]` — that's the node and its own subtree.
+ */
+export declare function lastDescendantIndex(index: number, depths: number[]): number;
+export declare function buildColumnTemplate(columns: {
+    key: string;
+    width: ColumnWidthSpec;
+}[], fitWidths?: Record<string, number>): string;
+/**
+ * What counts as a control inside a row, and so what gets held out of the tab
+ * order while its row is not the one being used.
+ *
+ * `[tabindex="-1"]` is deliberately excluded. The row's own select checkbox sits
+ * there and is reached with Space, and an element the consumer has already taken
+ * out of the tab order stays out.
+ */
+export declare const ROW_FOCUSABLE_SELECTOR = "a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";
+/** Marks an element parked at `tabindex="-1"` by the list rather than by the consumer. */
+export declare const ROW_PARKED_ATTRIBUTE = "data-vl-parked";
+/**
+ * What `F2` steps into: the controls of a row, including the ones parked out of
+ * the tab order. Without the second half it would find nothing at all in a row
+ * whose controls are custom elements carrying a `tabindex`, because parking them
+ * is exactly what takes them out of the selector above.
+ */
+export declare const ROW_ENTER_SELECTOR = "a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"]), [data-vl-parked]";
+/**
+ * The content width of one cell, in px. `scrollWidth` reports the true content
+ * width even when the cell is pinned narrower than its content, which is what
+ * lets a column recover from having been measured while it was still empty.
+ *
+ * Two corrections on top of it, both only resolved when they can apply, so the
+ * hot scroll path stays cheap for a plain in-flow cell:
+ *
+ * - `scrollWidth` includes the left padding but drops the right one once the
+ *   content overflows, so add it back.
+ * - A cell whose only children are FontAwesome icons reports just its padding:
+ *   their boxes overflow via `overflow: visible`, carry no intrinsic width, and
+ *   so never count towards `scrollWidth` (right-aligned, they even overflow
+ *   into negative offsets). Only then walk the descendants for their true span.
+ *   Once a real width pins, the cell is no longer collapsed and this stops.
+ */
+export declare function measureCellWidth(el: HTMLElement): number;
+/** Attribute selector for one column's cells. Column keys are arbitrary strings. */
+export declare function columnCellSelector(key: string): string;
+/** Floor for a user-resized column, unless the column raises it with `minWidth`. */
+export declare const MIN_COLUMN_WIDTH = 48;
+/**
+ * Width given to a column that gains one while the layout is already frozen,
+ * i.e. one revealed from the gear menu after the first resize. Every visible
+ * column has to be an exact px track for the total width (and so the horizontal
+ * scroll range) to be exact, and there is nothing measured to go on yet.
+ */
+export declare const DEFAULT_FROZEN_WIDTH = 160;
+/**
+ * Custom property carrying one column's width. Column keys are arbitrary
+ * strings, so anything a custom property can't contain is folded to `_`; two
+ * keys that differ only in those characters would share a track.
+ */
+export declare function columnWidthVar(key: string): string;
+/** Px width for a column the user hasn't sized, at the moment the layout freezes. */
+export declare function resolveFrozenWidth<T>(col: VirtualListColumn<T>): number;
+/**
+ * Grid template for a frozen layout: every column reads its own custom property,
+ * so a drag can rewrite one width with a single DOM write and have the header
+ * and every row follow in the same layout pass, without React rendering.
+ */
+export declare function buildFrozenTemplate<T>(columns: VirtualListColumn<T>[]): string;
+export declare const COLUMN_STORAGE_PREFIX = "ahroweui:virtuallist:columns:";
+export interface PersistedColumns {
+    visible: string[];
+    known: string[];
+    /** User-resized column widths in px. Absent in entries saved before resizing existed. */
+    widths?: Record<string, number>;
+}
+export declare function loadPersistedColumns(persistKey: string | undefined): PersistedColumns | null;
+/** Whether a column should start visible, honouring saved settings then `defaultHidden`. */
+export declare function isColumnInitiallyVisible<T>(col: VirtualListColumn<T>, persisted: PersistedColumns | null): boolean;
+/** Values with no order of their own, parked at the end of the list either way. */
+export declare function isEmptySortValue(value: SortValue): boolean;
+/**
+ * Ascending comparison of two non-empty `sortValue` results. Dates and booleans
+ * are normalised to numbers; anything with a string on either side goes through
+ * the collator, which is also what makes a mixed-type column produce a stable
+ * (if arbitrary) order rather than a random one.
+ */
+export declare function compareSortValues(a: SortValue, b: SortValue): number;
+/** Whether a header click on this column should do anything at all. */
+export declare function isColumnSortable<T>(col: VirtualListColumn<T>): boolean;
+/** The asc → desc → unsorted cycle a header click steps through. */
+export declare function nextSort(current: VirtualListSort | null, key: string): VirtualListSort | null;
+/**
+ * Returns `items` reordered by `sort`, or the same array reference when nothing
+ * applies: no sort, no such column, or a `sortable` column that only reports
+ * (its data is sorted by the consumer). Callers rely on that identity to tell
+ * "the list sorted this" from "the list left it alone".
+ */
+export declare function sortItems<T>(items: T[], sort: VirtualListSort | null | undefined, columns: VirtualListColumn<T>[] | undefined): T[];

package/dist/cjs-types/common/virtualList/virtualListHeader.d.ts

@@ -0,0 +1,35 @@
+import { default as React } from 'react';
+import { UseColumnsResult } from './useColumns.js';
+import { UseColumnResizeResult } from './useColumnResize.js';
+import { SlotClassNames, SlotStyles } from '../types/slots.types.js';
+import { VirtualListColumn, VirtualListLabels, VirtualListSlots, VirtualListSort } from './virtualList.types.js';
+interface VirtualListHeaderProps<T> {
+    headerRef: React.RefObject<HTMLDivElement | null>;
+    /** Every column, including hidden ones: the toggle menu lists them all. */
+    columns: VirtualListColumn<T>[];
+    cols: UseColumnsResult<T>;
+    resize: UseColumnResizeResult<T>;
+    sort: VirtualListSort | null;
+    onSort: (key: string) => void;
+    multiSelect: boolean;
+    allSelected: boolean;
+    someSelected: boolean;
+    onSelectAll: () => void;
+    labels: Required<VirtualListLabels>;
+    classNames?: SlotClassNames<VirtualListSlots>;
+    styles?: SlotStyles<VirtualListSlots>;
+}
+/**
+ * The table-mode header row: one cell per visible column, each optionally a sort
+ * button and a resize handle, plus the column-visibility menu pinned to the
+ * right. It is a grid with the same template as every row, which is what keeps
+ * the columns aligned across the separate grids.
+ *
+ * The whole header is a single tab stop (see `useHeaderNavigation`). Focus lands
+ * on a header cell rather than on the button inside it, so every key a column
+ * understands is handled in one place: Enter or Space sorts, Alt plus the arrow
+ * keys resizes, Alt+Home and Alt+End take the column to its minimum or to its
+ * content width.
+ */
+declare function VirtualListHeader<T>({ headerRef, columns, cols, resize, sort, onSort, multiSelect, allSelected, someSelected, onSelectAll, labels, classNames, styles: slotStyles, }: VirtualListHeaderProps<T>): React.JSX.Element;
+export default VirtualListHeader;

package/dist/cjs-types/common/virtualList/virtualRow.d.ts

@@ -0,0 +1,62 @@
+import { default as React } from 'react';
+import { TreeDropPosition } from './virtualList.types.js';
+export interface VirtualRowProps {
+    index: number;
+    /** Referenced by the list's `aria-activedescendant` while this row is active. */
+    id?: string;
+    top: number;
+    /** Padding applied to the row (already normalised to a CSS string). */
+    padding?: string;
+    columnTemplate: string | undefined;
+    isSelected: boolean;
+    /** The row the arrow keys are on. Distinct from selection. */
+    isActive?: boolean;
+    /**
+     * Hold this row's own controls out of the tab order unless it is the row being
+     * used. Off when the list leaves the keyboard to its rows.
+     */
+    manageTabStops?: boolean;
+    /** This is the row being used, so its controls are reachable with Tab. */
+    isEntered?: boolean;
+    activeClassName?: string;
+    activeStyle?: React.CSSProperties;
+    showDivider: boolean;
+    hover: boolean;
+    onClick: () => void;
+    observer: ResizeObserver | null;
+    ariaRowIndex?: number;
+    ariaPosInSet?: number;
+    ariaSetSize?: number;
+    rowRole: string;
+    reorderable?: boolean;
+    /**
+     * Native mouse DnD is active for the list. Distinct from `draggable`, which in
+     * `dragHandle` mode is only set on the row the pointer has armed.
+     */
+    mouseDragEnabled?: boolean;
+    draggable?: boolean;
+    isDragging?: boolean;
+    reserveToggleGutter?: boolean;
+    onMouseDown?: (e: React.MouseEvent<HTMLDivElement>) => void;
+    onMouseOver?: (e: React.MouseEvent<HTMLDivElement>) => void;
+    onMouseLeave?: (e: React.MouseEvent<HTMLDivElement>) => void;
+    onDragStart?: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragOver?: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragEnd?: () => void;
+    onDrop?: (e: React.DragEvent<HTMLDivElement>) => void;
+    onTouchStart?: (e: React.TouchEvent<HTMLDivElement>) => void;
+    dropPosition?: TreeDropPosition;
+    dropIndentPx?: number;
+    dropIndicatorClassName?: string;
+    dropIndicatorStyle?: React.CSSProperties;
+    rowClassName?: string;
+    rowStyle?: React.CSSProperties;
+    children: React.ReactNode;
+}
+/**
+ * A single virtualized row: absolutely positioned at its `top`, optionally a
+ * grid (table mode), registering itself with the shared ResizeObserver and
+ * carrying all the drag / drop-indicator wiring the parent assigns it.
+ */
+declare function VirtualRow({ index, id, top, padding, columnTemplate, isSelected, isActive, manageTabStops, isEntered, activeClassName, activeStyle, showDivider, hover, onClick, observer, ariaRowIndex, ariaPosInSet, ariaSetSize, rowRole, reorderable, mouseDragEnabled, draggable, isDragging, reserveToggleGutter, onMouseDown, onMouseOver, onMouseLeave, onDragStart, onDragOver, onDragEnd, onDrop, onTouchStart, dropPosition, dropIndentPx, dropIndicatorClassName, dropIndicatorStyle, rowClassName, rowStyle, children, }: VirtualRowProps): React.JSX.Element;
+export default VirtualRow;

package/dist/cjs-types/common/wizard/index.d.ts

@@ -0,0 +1 @@
+export { default } from './wizard.js';

package/dist/cjs-types/common/wizard/wizard.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { WizardProps } from './wizard.types.js';
+export default function Wizard({ currentStep, stepCount, renderStep, className, style, classNames, styles: slotStyles, ...rest }: WizardProps): React.JSX.Element;

package/dist/cjs-types/common/wizard/wizard.types.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types.js';
+export type WizardSlots = 'root' | 'container' | 'step' | 'stepContent';
+export interface WizardProps extends HtmlProps {
+    currentStep?: number;
+    stepCount?: number;
+    renderStep?: (index: number) => React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    classNames?: SlotClassNames<WizardSlots>;
+    styles?: SlotStyles<WizardSlots>;
+}

package/dist/cjs-types/hooks/useWindowSize.d.ts

@@ -0,0 +1,6 @@
+export interface WindowSize {
+    width: number;
+    height: number;
+    isMobileSize: boolean;
+}
+export default function useWindowSize(): WindowSize;

package/dist/cjs-types/index.d.ts

@@ -0,0 +1,154 @@
+export { default as Accordion } from './common/accordion/index.js';
+export * from './common/accordion/index.js';
+export * from './common/actionButtons/index.js';
+export { default as ActionIcon } from './common/actionIcon/index.js';
+export * from './common/actionIcon/index.js';
+export { default as Alert } from './common/alert/index.js';
+export * from './common/alert/index.js';
+export { default as AnimatedLogo } from './common/animatedLogo/index.js';
+export * from './common/animatedLogo/index.js';
+export { default as AnimatedText } from './common/animatedText/index.js';
+export * from './common/animatedText/index.js';
+export { default as Avatar } from './common/avatar/index.js';
+export * from './common/avatar/index.js';
+export { default as Badge } from './common/badge/index.js';
+export * from './common/badge/index.js';
+export { default as BodyEnd } from './common/bodyEnd/index.js';
+export * from './common/bodyEnd/index.js';
+export { default as Breadcrumb } from './common/breadcrumb/index.js';
+export * from './common/breadcrumb/index.js';
+export { default as Button } from './common/button/index.js';
+export * from './common/button/index.js';
+export { default as ButtonGroup } from './common/buttonGroup/index.js';
+export * from './common/buttonGroup/index.js';
+export { default as Card } from './common/card/index.js';
+export * from './common/card/index.js';
+export { default as Carousel } from './common/carousel/index.js';
+export * from './common/carousel/index.js';
+export { default as Checkbox } from './common/checkbox/index.js';
+export * from './common/checkbox/index.js';
+export { default as Chip } from './common/chip/index.js';
+export * from './common/chip/index.js';
+export { default as ColorPicker } from './common/colorPicker/index.js';
+export * from './common/colorPicker/index.js';
+export { default as ConfigProvider } from './common/configProvider/index.js';
+export * from './common/configProvider/index.js';
+export { default as ConfirmModal } from './common/confirmModal/index.js';
+export * from './common/confirmModal/index.js';
+export { default as DatePicker } from './common/datePicker/index.js';
+export * from './common/datePicker/index.js';
+export { default as Divider } from './common/divider/index.js';
+export * from './common/divider/index.js';
+export { default as Drawer } from './common/drawer/index.js';
+export * from './common/drawer/index.js';
+export { default as DropZone } from './common/dropZone/index.js';
+export * from './common/dropZone/index.js';
+export { default as Dropdown } from './common/dropdown/index.js';
+export * from './common/dropdown/index.js';
+export { default as EmptyState } from './common/emptyState/index.js';
+export * from './common/emptyState/index.js';
+export { default as ErrorBoundary } from './common/errorBoundary/index.js';
+export * from './common/errorBoundary/index.js';
+export { default as Fab } from './common/fab/index.js';
+export * from './common/fab/index.js';
+export { default as Flip } from './common/flip/index.js';
+export * from './common/flip/index.js';
+export * from './common/floorPlan/index.js';
+export { default as IconPicker } from './common/iconPicker/index.js';
+export * from './common/iconPicker/index.js';
+export { default as IdleManager } from './common/idleManager/index.js';
+export * from './common/idleManager/index.js';
+export { default as Input } from './common/input/index.js';
+export * from './common/input/index.js';
+export { default as InputDropdown } from './common/inputDropdown/index.js';
+export * from './common/inputDropdown/index.js';
+export { default as InteractableDiv } from './common/interactableDiv/index.js';
+export * from './common/interactableDiv/index.js';
+export { default as KanbanBoard } from './common/kanbanBoard/index.js';
+export * from './common/kanbanBoard/index.js';
+export { default as KlipyPicker } from './common/klipyPicker/index.js';
+export * from './common/klipyPicker/index.js';
+export * from './common/loading/index.js';
+export { default as Menu } from './common/menu/index.js';
+export * from './common/menu/index.js';
+export { default as Modal } from './common/modal/index.js';
+export * from './common/modal/index.js';
+export { default as MultiSelect } from './common/multiSelect/index.js';
+export * from './common/multiSelect/index.js';
+export { default as NumberInput } from './common/numberInput/index.js';
+export * from './common/numberInput/index.js';
+export { default as OptionPicker } from './common/optionPicker/index.js';
+export * from './common/optionPicker/index.js';
+export { default as OtpInput } from './common/otpInput/index.js';
+export * from './common/otpInput/index.js';
+export { default as Overscroll } from './common/overscroll/index.js';
+export * from './common/overscroll/index.js';
+export { default as Pagination } from './common/pagination/index.js';
+export * from './common/pagination/index.js';
+export { default as Popover } from './common/popover/index.js';
+export * from './common/popover/index.js';
+export { default as ProgressBar } from './common/progressBar/index.js';
+export * from './common/progressBar/index.js';
+export { default as RadioGroup } from './common/radioGroup/index.js';
+export * from './common/radioGroup/index.js';
+export { default as Rating } from './common/rating/index.js';
+export * from './common/rating/index.js';
+export { default as RevealLens } from './common/revealLens/index.js';
+export * from './common/revealLens/index.js';
+export { default as Ripple } from './common/ripple/index.js';
+export * from './common/ripple/index.js';
+export { default as RoomDrawer } from './common/roomDrawer/index.js';
+export * from './common/roomDrawer/index.js';
+export { default as RoomViewer } from './common/roomViewer/index.js';
+export * from './common/roomViewer/index.js';
+export { default as ScrollFade } from './common/scrollFade/index.js';
+export * from './common/scrollFade/index.js';
+export { default as ScrollbarProvider } from './common/scrollbarProvider/index.js';
+export * from './common/scrollbarProvider/index.js';
+export { default as SearchInput } from './common/searchInput/index.js';
+export * from './common/searchInput/index.js';
+export { default as SectionHeader } from './common/sectionHeader/index.js';
+export * from './common/sectionHeader/index.js';
+export { default as Skeleton } from './common/skeleton/index.js';
+export * from './common/skeleton/index.js';
+export { default as Slider } from './common/slider/index.js';
+export * from './common/slider/index.js';
+export { default as SplitButton } from './common/splitButton/index.js';
+export * from './common/splitButton/index.js';
+export { default as Stepper } from './common/stepper/index.js';
+export * from './common/stepper/index.js';
+export { default as Sticky } from './common/sticky/index.js';
+export * from './common/sticky/index.js';
+export { default as Switch } from './common/switch/index.js';
+export * from './common/switch/index.js';
+export { default as TabHeader } from './common/tabHeader/index.js';
+export * from './common/tabHeader/index.js';
+export { default as Textarea } from './common/textarea/index.js';
+export * from './common/textarea/index.js';
+export { default as ThemeProvider } from './common/themeProvider/index.js';
+export * from './common/themeProvider/index.js';
+export { useTheme } from './common/themeProvider/useTheme.js';
+export { default as Tilt } from './common/tilt/index.js';
+export * from './common/tilt/index.js';
+export { default as TiltGroup } from './common/tiltGroup/index.js';
+export * from './common/tiltGroup/index.js';
+export { default as TimeInput } from './common/timeInput/index.js';
+export * from './common/timeInput/index.js';
+export { default as Timeline } from './common/timeline/index.js';
+export * from './common/timeline/index.js';
+export { default as Timer } from './common/timer/index.js';
+export * from './common/timer/index.js';
+export { default as ToastProvider } from './common/toast/index.js';
+export * from './common/toast/index.js';
+export { default as Tooltip } from './common/tooltip/index.js';
+export * from './common/tooltip/index.js';
+export { default as Tree } from './common/tree/index.js';
+export * from './common/tree/index.js';
+export { default as VirtualList } from './common/virtualList/index.js';
+export * from './common/virtualList/index.js';
+export { default as Wizard } from './common/wizard/index.js';
+export * from './common/wizard/index.js';
+export { FormValidator, FormValidatorGroup, Validators, ValidatableComponent, useFormValidator, useFormValidatorGroup, } from './services/formValidation/index.js';
+export type { ValidationError, ValidatorFunction, ErrorParser, FormValidatorGroupOptions, InferGroupValues, MergedValues, } from './services/formValidation/index.js';
+export { mapLocale, setLocale, getLocale } from './services/localization.js';
+export { isNumber, isDate, isISODate, isEmail, isBic, isURL, hasEightPasswordChars, hasOnePasswordLetter, hasOnePasswordDigit, isPassword, } from '@ahrowe/form-validation';

package/dist/cjs-types/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs-types/services/formValidation/FormValidatorGroupWithForm.d.ts

@@ -0,0 +1,18 @@
+import { FormValidatorGroup, FormGroup, FormValidatorGroupOptions, InferGroupValues } from '@ahrowe/form-validation';
+import { default as React } from 'react';
+/**
+ * FormValidatorGroup with `this.Form` automatically attached.
+ * Kept in a .tsx file so formValidatorGroup.ts stays framework-agnostic.
+ *
+ * This is the class you should use everywhere — it is a drop-in replacement
+ * for FormValidatorGroup with one extra property: `this.Form`.
+ *
+ * Also injects the default toast-based onSubmitError so both hook and class-component
+ * consumers surface errors out of the box; pass options.onSubmitError to override.
+ */
+export default class FormValidatorGroupWithForm<TGroup extends FormGroup = FormGroup, TInitial = InferGroupValues<TGroup>> extends FormValidatorGroup<TGroup, TInitial> {
+    Form: React.FC<React.FormHTMLAttributes<HTMLFormElement>>;
+    constructor(groupDef: TGroup, component?: {
+        forceUpdate: () => void;
+    } | null, options?: FormValidatorGroupOptions<TGroup, TInitial>);
+}

package/dist/cjs-types/services/formValidation/index.d.ts

@@ -0,0 +1,5 @@
+export { default as FormValidatorGroup } from './FormValidatorGroupWithForm.js';
+export { default as ValidatableComponent } from './validatableComponent.js';
+export { useFormValidatorGroup } from './useFormValidatorGroup.js';
+export { FormValidator, Validators, useFormValidator } from '@ahrowe/form-validation';
+export type { ValidationError, ValidatorFunction, ErrorParser, FormValidatorGroupOptions, InferGroupValues, MergedValues, } from '@ahrowe/form-validation';

package/dist/cjs-types/services/formValidation/useFormValidatorGroup.d.ts

@@ -0,0 +1,10 @@
+import { FormGroup, FormValidatorGroupOptions, InferGroupValues } from '@ahrowe/form-validation';
+import { default as FormValidatorGroupWithForm } from './FormValidatorGroupWithForm.js';
+/**
+ * @ahrowe/ui's flavour of useFormValidatorGroup: the group it creates has
+ * `.Form` attached and defaults `onSubmitError` to an error toast (see
+ * FormValidatorGroupWithForm). Reuses the core package's reactive wiring
+ * (useFormValidatorGroupInstance) so this and the pure hook share one
+ * implementation of "subscribe a function component to a group".
+ */
+export declare function useFormValidatorGroup<TGroup extends FormGroup = FormGroup, TInitial = InferGroupValues<TGroup>>(groupDef: TGroup, { initialValues, onSubmit, onValidate, errorParser, onSubmitError }?: FormValidatorGroupOptions<TGroup, TInitial>): FormValidatorGroupWithForm<TGroup, TInitial>;

package/dist/cjs-types/services/formValidation/validatableComponent.d.ts

@@ -0,0 +1,36 @@
+import { default as React, PureComponent } from 'react';
+import { FormValidator } from '@ahrowe/form-validation';
+export interface ValidatableComponentProps {
+    formValidator?: FormValidator | null;
+    onMouseEnter?: ((event: React.MouseEvent) => void) | null;
+    onMouseLeave?: ((event: React.MouseEvent) => void) | null;
+    onFocus?: ((event: React.FocusEvent) => void) | null;
+    onBlur?: ((event: React.FocusEvent) => void) | null;
+    onChange?: ((value: unknown) => void) | null;
+    errorMessage?: string;
+    isValid?: boolean;
+    isRequired?: boolean;
+    label?: string;
+}
+export interface ValidatableComponentState {
+    isFocused: boolean;
+    isHovered: boolean;
+}
+/**
+ * Base class that extends PureComponent with FormValidator integration.
+ * Manages hover/focus state and renders error tooltips.
+ */
+export default class ValidatableComponent<P extends ValidatableComponentProps = ValidatableComponentProps, S extends ValidatableComponentState = ValidatableComponentState> extends PureComponent<P, S> {
+    static defaultProps: Partial<ValidatableComponentProps>;
+    constructor(props: P);
+    componentDidMount(): void;
+    componentDidUpdate(prevProps: P): void;
+    onMouseEnter(event: React.MouseEvent): void;
+    onMouseLeave(event: React.MouseEvent): void;
+    onFocus(event: React.FocusEvent): void;
+    onBlur(event: React.FocusEvent): void;
+    hasError(): boolean;
+    isRequired(): boolean;
+    renderTooltip(): React.ReactNode;
+    onChange(newVal: unknown): void;
+}

package/dist/cjs-types/services/klipy.d.ts

@@ -0,0 +1,36 @@
+export interface KlipyMediaFormat {
+    url: string;
+    dims: [number, number];
+    size: number;
+}
+export interface KlipyResult {
+    id: string;
+    title: string;
+    media_formats: {
+        gif: KlipyMediaFormat;
+        tinygif: KlipyMediaFormat;
+        mediumgif: KlipyMediaFormat;
+        mp4: KlipyMediaFormat;
+        tinymp4: KlipyMediaFormat;
+    };
+    tags: string[];
+    url: string;
+}
+interface SearchOptions {
+    limit?: number;
+    contentfilter?: 'off' | 'low' | 'medium' | 'high';
+    pos?: string;
+}
+export default class KlipyService {
+    private key;
+    constructor(key: string);
+    search(query: string, options?: SearchOptions): Promise<{
+        results: KlipyResult[];
+        next: string;
+    }>;
+    searchSuggestions(query: string): Promise<{
+        results: string[];
+    }>;
+    registerShare(query: string, id: string): void;
+}
+export {};

package/dist/cjs-types/services/localization.d.ts

@@ -0,0 +1,3 @@
+export declare const mapLocale: (locale: string) => string;
+export declare function setLocale(locale: string): Promise<void>;
+export declare function getLocale(delimiter?: string): string;

package/dist/esm/common/carousel/carousel.mjs

@@ -1,2 +1,2 @@
-"use client";import{useComponentDefaults as e}from"../configProvider/useComponentDefaults.mjs";import{useLabels as t}from"../configProvider/useLabels.mjs";import n from"../interactableDiv/index.mjs";import r from"../actionIcon/actionIcon.mjs";import i from"./carousel.module.mjs";import a,{useEffect as o,useLayoutEffect as s,useRef as c,useState as l}from"react";import u from"classnames";import{faChevronLeft as ee,faChevronRight as te}from"@fortawesome/free-solid-svg-icons";import{Fragment as ne,jsx as d,jsxs as f}from"react/jsx-runtime";var p=10,re=.2,ie={previous:`Previous slide`,next:`Next slide`,slides:`Slides`,goToSlide:e=>`Go to slide ${e}`};function m(m){let{children:ae,currentIndex:_,defaultIndex:oe=0,onChange:se=()=>{},loop:ce=!0,autoPlay:v=!1,autoPlayInterval:y=4e3,pauseOnHover:le=!0,showArrows:ue=!0,showDots:de=!0,swipeable:fe=!0,lazyRender:pe=!1,adaptiveHeight:b=!1,className:me,style:he,classNames:x,styles:S,labels:ge,...C}=e(`Carousel`,m),w=t(`Carousel`,ge,ie),_e=a.useId(),T=a.Children.toArray(ae),E=T.length,D=ce&&E>1,O=+!!D,k=D?[T[E-1],...T,T[0]]:T,A=_!==void 0,[ve,ye]=l(()=>g(oe,E,D)),j=g(A?_:ve,E,D),[M,N]=l(j+O),[be,P]=l(!0),F=c(j),[xe,I]=l(!1),[Se,L]=l(!1),[Ce,R]=l(!1),z=c(null),B=c(null),V=c(null),H=k.length>0?100/k.length:100;s(()=>{let e=F.current;if(F.current=j,e===j)return;let t=k.length-1,n=M;D&&M===0?n=E:D&&M===t&&(n=1);let r=D&&e===E-1&&j===0,i=D&&e===0&&j===E-1,a;a=r?n+1:i?n-1:j+O;let o=B.current;n!==M&&o&&(o.style.transition=`none`,o.style.transform=h(n,0,H),o.offsetWidth,o.style.transition=``),P(!0),N(a)},[j]);let[U,we]=l(()=>({min:j+O-1,max:j+O+1})),Te=Math.min(U.min,M-1),Ee=Math.max(U.max,M+1),[De,Oe]=l(void 0);s(()=>{if(!b)return;let e=B.current?.children[M];if(!e)return;let t=()=>Oe(e.offsetHeight);t();let n=new ResizeObserver(t);return n.observe(e),()=>n.disconnect()},[b,M,E]),s(()=>{let e=V.current,t=e?.children[j];e&&t&&(e.scrollLeft=t.offsetLeft-(e.clientWidth-t.offsetWidth)/2)},[j,E]);function W(e){let t=g(e,E,D);A||ye(t),se(t)}function G(){!D&&j>=E-1||W(j+1)}function K(){!D&&j<=0||W(j-1)}function ke(e){e.target===e.currentTarget&&(we({min:M-1,max:M+1}),D&&(M===0?(P(!1),N(E)):M===k.length-1&&(P(!1),N(1))))}let q=v&&le,J=xe||Se||Ce;o(()=>{if(!v||E<=1||J)return;let e=setInterval(G,y);return()=>clearInterval(e)},[v,y,J,j,E]);let Y=c(null);function Ae(e){!fe||E<=1||(Y.current={startX:e.clientX,startY:e.clientY,width:z.current?.getBoundingClientRect().width||1,axisLocked:!1,active:!0,offsetPercent:0})}function je(e){let t=Y.current;if(!t||!t.active)return;let n=e.clientX-t.startX,r=e.clientY-t.startY;if(!t.axisLocked){if(Math.abs(n)<p&&Math.abs(r)<p)return;if(Math.abs(r)>Math.abs(n)){t.active=!1;return}t.axisLocked=!0,e.currentTarget.setPointerCapture?.(e.pointerId),R(!0),P(!1)}t.offsetPercent=n/t.width*100,B.current&&(B.current.style.transform=h(M,t.offsetPercent,H))}function X(){let e=Y.current;if(Y.current=null,!e||!e.axisLocked){R(!1);return}P(!0),R(!1),B.current&&(B.current.style.transition=``,B.current.style.transform=h(M,0,H)),Math.abs(e.offsetPercent)>=re*100&&(e.offsetPercent<0?G():K())}function Me(e){e.defaultPrevented||B.current?.contains(e.target)||(e.key===`ArrowLeft`?(e.preventDefault(),K()):e.key===`ArrowRight`&&(e.preventDefault(),G()))}function Ne(e){let t=null;if(e.key===`ArrowLeft`?t=j-1:e.key===`ArrowRight`?t=j+1:e.key===`Home`?t=0:e.key===`End`&&(t=E-1),t===null)return;e.preventDefault();let n=g(t,E,D);W(n),(V.current?.children[n])?.focus()}let Pe=de&&E>1,Fe=e=>`${_e}-dot-${e}`,Z=e=>`${_e}-slide-${e}`,Ie=C[`aria-label`]!==void 0||C[`aria-labelledby`]!==void 0;function Le(e){return Pe?{id:Z(e),role:`tabpanel`,"aria-labelledby":Fe(e)}:{id:Z(e),role:`group`,"aria-roledescription":`slide`,"aria-label":`${e+1} of ${E}`}}let Q=!D&&j<=0,$=!D&&j>=E-1,Re=h(M,0,H);return f(`div`,{...C,ref:z,role:Ie?`region`:`group`,"aria-roledescription":`carousel`,className:u(i.carousel,b&&i.carouselAdaptive,x?.root,me),style:{height:b?De:void 0,...he,...S?.root},onMouseEnter:q?()=>I(!0):void 0,onMouseLeave:q?()=>I(!1):void 0,onFocus:q?()=>L(!0):void 0,onBlur:q?()=>L(!1):void 0,onKeyDown:Me,children:[d(`div`,{ref:B,className:u(i.carouselTrack,b&&i.carouselTrackAdaptive,x?.track),style:{width:`${k.length*100}%`,transform:Re,transition:be?void 0:`none`,...S?.track},"aria-live":v?`off`:`polite`,onTransitionEnd:ke,onPointerDown:Ae,onPointerMove:je,onPointerUp:X,onPointerCancel:X,children:k.map((e,t)=>{let n=D&&(t===0||t===k.length-1),r=t-O,a=!n&&r===j,o=!pe||t>=Te&&t<=Ee;return d(`div`,{...n?{}:Le(r),className:u(i.carouselSlide,x?.slide),style:{width:`${100/k.length}%`,...S?.slide},inert:!a||void 0,children:o?e:null},`carousel-slide-${t}`)})}),ue&&E>1&&f(ne,{children:[d(r,{icon:ee,title:w.previous,"aria-label":w.previous,"aria-disabled":Q||void 0,onClick:()=>!Q&&K(),className:u(i.carouselPrevButton,Q&&i.carouselButtonDisabled,x?.prevButton),style:S?.prevButton}),d(r,{icon:te,title:w.next,"aria-label":w.next,"aria-disabled":$||void 0,onClick:()=>!$&&G(),className:u(i.carouselNextButton,$&&i.carouselButtonDisabled,x?.nextButton),style:S?.nextButton})]}),Pe&&d(`div`,{ref:V,role:`tablist`,"aria-label":w.slides,className:u(i.carouselDots,x?.dots),style:S?.dots,onKeyDown:Ne,children:T.map((e,t)=>d(n,{id:Fe(t),role:`tab`,"aria-label":w.goToSlide(t+1),"aria-selected":t===j,"aria-controls":Z(t),tabIndex:t===j?0:-1,onClick:()=>W(t),className:u(i.carouselDot,t===j&&i.carouselDotActive,x?.dot),style:S?.dot},`carousel-dot-${t}`))})]})}function h(e,t,n){return`translateX(calc(${-e*n}% + ${n/100*t}%))`}function g(e,t,n){return t===0?0:n?(e%t+t)%t:Math.max(0,Math.min(t-1,e))}export{m as default};
+"use client";import{useComponentDefaults as e}from"../configProvider/useComponentDefaults.mjs";import{useLabels as t}from"../configProvider/useLabels.mjs";import n from"../interactableDiv/index.mjs";import r from"../actionIcon/actionIcon.mjs";import i from"./carousel.module.mjs";import a from"../styles/scrollFade.module.mjs";import o,{useEffect as ee,useLayoutEffect as s,useRef as c,useState as l}from"react";import u from"classnames";import{faChevronLeft as te,faChevronRight as ne}from"@fortawesome/free-solid-svg-icons";import{Fragment as re,jsx as d,jsxs as f}from"react/jsx-runtime";var p=10,ie=.2,ae={previous:`Previous slide`,next:`Next slide`,slides:`Slides`,goToSlide:e=>`Go to slide ${e}`};function m(m){let{children:oe,currentIndex:_,defaultIndex:se=0,onChange:ce=()=>{},loop:le=!0,autoPlay:v=!1,autoPlayInterval:y=4e3,pauseOnHover:ue=!0,showArrows:de=!0,showDots:fe=!0,swipeable:pe=!0,lazyRender:me=!1,adaptiveHeight:b=!1,className:he,style:ge,classNames:x,styles:S,labels:_e,...C}=e(`Carousel`,m),w=t(`Carousel`,_e,ae),T=o.useId(),E=o.Children.toArray(oe),D=E.length,O=le&&D>1,k=+!!O,A=O?[E[D-1],...E,E[0]]:E,j=_!==void 0,[ve,ye]=l(()=>g(se,D,O)),M=g(j?_:ve,D,O),[N,P]=l(M+k),[be,F]=l(!0),I=c(M),[xe,L]=l(!1),[Se,R]=l(!1),[Ce,z]=l(!1),B=c(null),V=c(null),H=c(null),U=A.length>0?100/A.length:100;s(()=>{let e=I.current;if(I.current=M,e===M)return;let t=A.length-1,n=N;O&&N===0?n=D:O&&N===t&&(n=1);let r=O&&e===D-1&&M===0,i=O&&e===0&&M===D-1,a;a=r?n+1:i?n-1:M+k;let o=V.current;n!==N&&o&&(o.style.transition=`none`,o.style.transform=h(n,0,U),o.offsetWidth,o.style.transition=``),F(!0),P(a)},[M]);let[W,we]=l(()=>({min:M+k-1,max:M+k+1})),Te=Math.min(W.min,N-1),Ee=Math.max(W.max,N+1),[De,Oe]=l(void 0);s(()=>{if(!b)return;let e=V.current?.children[N];if(!e)return;let t=()=>Oe(e.offsetHeight);t();let n=new ResizeObserver(t);return n.observe(e),()=>n.disconnect()},[b,N,D]),s(()=>{let e=H.current,t=e?.children[M];e&&t&&(e.scrollLeft=t.offsetLeft-(e.clientWidth-t.offsetWidth)/2)},[M,D]);function G(e){let t=g(e,D,O);j||ye(t),ce(t)}function K(){!O&&M>=D-1||G(M+1)}function q(){!O&&M<=0||G(M-1)}function ke(e){e.target===e.currentTarget&&(we({min:N-1,max:N+1}),O&&(N===0?(F(!1),P(D)):N===A.length-1&&(F(!1),P(1))))}let J=v&&ue,Y=xe||Se||Ce;ee(()=>{if(!v||D<=1||Y)return;let e=setInterval(K,y);return()=>clearInterval(e)},[v,y,Y,M,D]);let X=c(null);function Ae(e){!pe||D<=1||(X.current={startX:e.clientX,startY:e.clientY,width:B.current?.getBoundingClientRect().width||1,axisLocked:!1,active:!0,offsetPercent:0})}function je(e){let t=X.current;if(!t||!t.active)return;let n=e.clientX-t.startX,r=e.clientY-t.startY;if(!t.axisLocked){if(Math.abs(n)<p&&Math.abs(r)<p)return;if(Math.abs(r)>Math.abs(n)){t.active=!1;return}t.axisLocked=!0,e.currentTarget.setPointerCapture?.(e.pointerId),z(!0),F(!1)}t.offsetPercent=n/t.width*100,V.current&&(V.current.style.transform=h(N,t.offsetPercent,U))}function Me(){let e=X.current;if(X.current=null,!e||!e.axisLocked){z(!1);return}F(!0),z(!1),V.current&&(V.current.style.transition=``,V.current.style.transform=h(N,0,U)),Math.abs(e.offsetPercent)>=ie*100&&(e.offsetPercent<0?K():q())}function Ne(e){e.defaultPrevented||V.current?.contains(e.target)||(e.key===`ArrowLeft`?(e.preventDefault(),q()):e.key===`ArrowRight`&&(e.preventDefault(),K()))}function Pe(e){let t=null;if(e.key===`ArrowLeft`?t=M-1:e.key===`ArrowRight`?t=M+1:e.key===`Home`?t=0:e.key===`End`&&(t=D-1),t===null)return;e.preventDefault();let n=g(t,D,O);G(n),(H.current?.children[n])?.focus()}let Fe=fe&&D>1,Ie=e=>`${T}-dot-${e}`,Z=e=>`${T}-slide-${e}`,Le=C[`aria-label`]!==void 0||C[`aria-labelledby`]!==void 0;function Re(e){return Fe?{id:Z(e),role:`tabpanel`,"aria-labelledby":Ie(e)}:{id:Z(e),role:`group`,"aria-roledescription":`slide`,"aria-label":`${e+1} of ${D}`}}let Q=!O&&M<=0,$=!O&&M>=D-1,ze=h(N,0,U);return f(`div`,{...C,ref:B,role:Le?`region`:`group`,"aria-roledescription":`carousel`,className:u(i.carousel,b&&i.carouselAdaptive,x?.root,he),style:{height:b?De:void 0,...ge,...S?.root},onMouseEnter:J?()=>L(!0):void 0,onMouseLeave:J?()=>L(!1):void 0,onFocus:J?()=>R(!0):void 0,onBlur:J?()=>R(!1):void 0,onKeyDown:Ne,children:[d(`div`,{ref:V,className:u(i.carouselTrack,b&&i.carouselTrackAdaptive,x?.track),style:{width:`${A.length*100}%`,transform:ze,transition:be?void 0:`none`,...S?.track},"aria-live":v?`off`:`polite`,onTransitionEnd:ke,onPointerDown:Ae,onPointerMove:je,onPointerUp:Me,onPointerCancel:Me,children:A.map((e,t)=>{let n=O&&(t===0||t===A.length-1),r=t-k,a=!n&&r===M,o=!me||t>=Te&&t<=Ee;return d(`div`,{...n?{}:Re(r),className:u(i.carouselSlide,x?.slide),style:{width:`${100/A.length}%`,...S?.slide},inert:!a||void 0,children:o?e:null},`carousel-slide-${t}`)})}),de&&D>1&&f(re,{children:[d(r,{icon:te,title:w.previous,"aria-label":w.previous,"aria-disabled":Q||void 0,onClick:()=>!Q&&q(),className:u(i.carouselPrevButton,Q&&i.carouselButtonDisabled,x?.prevButton),style:S?.prevButton}),d(r,{icon:ne,title:w.next,"aria-label":w.next,"aria-disabled":$||void 0,onClick:()=>!$&&K(),className:u(i.carouselNextButton,$&&i.carouselButtonDisabled,x?.nextButton),style:S?.nextButton})]}),Fe&&d(`div`,{ref:H,role:`tablist`,"aria-label":w.slides,className:u(i.carouselDots,a.scrollFade,a.scrollFadeX,a.scrollFadeFadedStart,a.scrollFadeFadedEnd,x?.dots),style:S?.dots,onKeyDown:Pe,children:E.map((e,t)=>d(n,{id:Ie(t),role:`tab`,"aria-label":w.goToSlide(t+1),"aria-selected":t===M,"aria-controls":Z(t),tabIndex:t===M?0:-1,onClick:()=>G(t),className:u(i.carouselDot,t===M&&i.carouselDotActive,x?.dot),style:S?.dot},`carousel-dot-${t}`))})]})}function h(e,t,n){return`translateX(calc(${-e*n}% + ${n/100*t}%))`}function g(e,t,n){return t===0?0:n?(e%t+t)%t:Math.max(0,Math.min(t-1,e))}export{m as default};
 //# sourceMappingURL=carousel.mjs.map