h2o-library 1.8.0 → 2.0.0

package/dist/charts/components/src/checkbox/checkbox.d.ts

@@ -0,0 +1,58 @@
+import "./checkbox.css";
+import React from "react";
+import type { TooltipPosition } from "../../../types";
+/**
+ * Checkbox field: extends `HTMLInputElement` props except `type` and design-system `size`.
+ *
+ * @property {boolean} [isIndeterminate] - Sets the native `indeterminate` property (tri-state). Default `false`.
+ * @property {boolean} [isCard] - Card layout vs inline. Default `false`.
+ * @property {"sm"|"md"|"lg"} [size] - Scale. Default `"md"`.
+ * @property {string} [error] - Error text under the field; invalid styles when set.
+ */
+interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    label?: string;
+    containerClassName?: string;
+    labelClassName?: string;
+    isCard?: boolean;
+    isIndeterminate?: boolean;
+    error?: string;
+    note?: string;
+    size?: "sm" | "md" | "lg";
+    tooltip?: string;
+    tooltipPosition?: TooltipPosition;
+}
+/**
+ * Checkbox with optional label, card layout, indeterminate state, note/error rows, and label tooltip.
+ *
+ * @param {CheckboxProps} props - Extends native checkbox props; use `checked` / `onChange` for control.
+ * @param {React.Ref<HTMLInputElement>} ref - Forwarded to `<input type="checkbox">`.
+ * @returns {React.ReactElement} Wrapper and validation region.
+ */
+export declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
+/**
+ * Parent row that coordinates `Checkbox` children: tracks `checkedStates[]` and parent `indeterminate`.
+ *
+ * @property {string} label - Parent (select-all) row label.
+ * @property {React.ReactNode} children - Usually `Checkbox` elements whose `checked`/`defaultChecked` seed state.
+ * @property {(checkedStates: boolean[]) => void} [onChange] - Emits the full boolean array on any child toggle.
+ * @property {boolean} [disabled] - Disables the parent and children when `true`.
+ */
+interface CheckboxGroupProps {
+    label: string;
+    children: React.ReactNode;
+    className?: string;
+    disabled?: boolean;
+    /** Called whenever any child changes, with the full array of checked states. */
+    onChange?: (checkedStates: boolean[]) => void;
+    size?: "sm" | "md" | "lg";
+    tooltip?: string;
+    tooltipPosition?: TooltipPosition;
+}
+/**
+ * Select-all / grouped checkboxes with derived parent `indeterminate` from child states.
+ *
+ * @param {CheckboxGroupProps} props - `label`, `children`, optional `onChange`.
+ * @returns {JSX.Element} Parent checkbox row and nested children.
+ */
+export declare const CheckboxGroup: React.FC<CheckboxGroupProps>;
+export {};

package/dist/charts/components/src/chip/chip.d.ts

@@ -0,0 +1,37 @@
+import "./chip.css";
+import type React from "react";
+import type { IconType, TooltipPosition } from "../../../types";
+/**
+ * Props for the `Chip` component: extends `HTMLAttributes<HTMLElement>` with H2O badge fields.
+ * `dot` and `icon` are mutually exclusive; if both are set, `icon` wins.
+ *
+ * @property {string} label - Visible text (required).
+ * @property {import("../../../types").IconType} [icon] - Leading icon; overrides `dot` when present.
+ * @property {"neutral"|"primary"|"success"|"warning"|"error"} [variant] - Color family. Default `"neutral"`.
+ * @property {"sm"|"md"|"lg"} [size] - Padding and font. Default `"md"`.
+ * @property {boolean} [dot] - Renders a status dot instead of an icon when no `icon`.
+ * @property {boolean} [showBorder] - Outlined style. Default `false`.
+ * @property {string} [tooltip] - Optional info tooltip on hover/focus.
+ */
+type ChipProps = React.HTMLAttributes<HTMLElement> & {
+    label: string;
+    icon?: IconType;
+    variant?: "neutral" | "primary" | "success" | "warning" | "error";
+    size?: "sm" | "md" | "lg";
+    iconStrokeWidth?: number;
+    iconClassName?: string;
+    iconSize?: number;
+    disabled?: boolean;
+    showBorder?: boolean;
+    dot?: boolean;
+    tooltip?: string;
+    tooltipPosition?: TooltipPosition;
+};
+/**
+ * Small label with optional icon or status dot, tooltip, and semantic `variant` colors.
+ *
+ * @param {ChipProps} props - Extends native element props; includes `label` and presentation.
+ * @returns {JSX.Element} A `span` or `button`-like chip per `onClick` usage.
+ */
+export declare const Chip: ({ label, icon, variant, size, iconStrokeWidth, iconClassName, iconSize, disabled, showBorder, dot, tooltip, tooltipPosition, className, onClick, ...props }: ChipProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/charts/components/src/compact-multi-select/compact-multi-select.d.ts

@@ -0,0 +1,52 @@
+import "./compact-multi-select.css";
+import React from "react";
+import type { TooltipPosition } from "../../../types";
+/**
+ * One row in `CompactMultiSelect` `options`.
+ * @property {string} label - Visible text.
+ * @property {string} value - Stable id in the `onChange` payload.
+ * @property {boolean} [disabled] - Excludes or grays out the option. Default `false`.
+ */
+export interface CompactMultiSelectOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+/**
+ * Compact multi-select: tag list, optional search, max selections, and dropdown direction.
+ * **Controlled** via `value` / `onChange` as an array of {@link CompactMultiSelectOption}.
+ *
+ * @property {CompactMultiSelectOption[]} options - Full list to pick from.
+ * @property {CompactMultiSelectOption[]} [value] - Current selection; default `[]`.
+ * @property {(value: CompactMultiSelectOption[]) => void} [onChange] - Emits the new selection array.
+ * @property {number} [maxSelections] - Upper bound on selected count, if set.
+ */
+interface CompactMultiSelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "value"> {
+    size?: "sm" | "md" | "lg";
+    label?: string;
+    showClear?: boolean;
+    note?: string;
+    error?: string;
+    containerClassName?: string;
+    options: CompactMultiSelectOption[];
+    placeholder?: string;
+    value?: CompactMultiSelectOption[];
+    onChange?: (value: CompactMultiSelectOption[]) => void;
+    disabled?: boolean;
+    enableSearch?: boolean;
+    maxSelections?: number;
+    tooltip?: string;
+    tooltipPosition?: TooltipPosition;
+    direction?: "top" | "bottom" | "auto";
+    onOpen?: () => void;
+    onClose?: () => void;
+}
+/**
+ * Multi-value dropdown in a single row of tags; supports search, tooltips, and panel flip.
+ *
+ * @param {CompactMultiSelectProps} props - Options, selection, and layout props.
+ * @param {React.Ref<HTMLDivElement>} ref - Root wrapper ref.
+ * @returns {React.ReactElement} The field, tags, and open list.
+ */
+export declare const CompactMultiSelect: React.ForwardRefExoticComponent<CompactMultiSelectProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/dist/charts/components/src/content-switch/content-switch.d.ts

@@ -0,0 +1,39 @@
+import "./content-switch.css";
+import type { IconType } from "../../../types";
+/**
+ * Tab-like option in a `ContentSwitch` row (`role="tablist"` / `role="tab"`).
+ * @property {string} value - Passed to `onChange` when selected.
+ * @property {IconType} [icon] - Optional leading icon on the tab.
+ */
+export type ContentSwitchOption = {
+    label: string;
+    value: string;
+    icon?: IconType;
+    disabled?: boolean;
+};
+/**
+ * **Controlled** `selected` value string; `variant` picks primary vs secondary surface styles.
+ *
+ * @property {ContentSwitchOption[]} options - Tab definitions.
+ * @property {string} selected - Must match one `option.value` for the active tab.
+ * @property {(value: string) => void} onChange - Fires with the chosen `value`.
+ * @property {"primary"|"secondary"} [variant] - Style preset. Default `"primary"`.
+ */
+type ContentSwitchProps = {
+    options: ContentSwitchOption[];
+    variant?: "primary" | "secondary";
+    className?: string;
+    optionClassName?: string;
+    selected: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+    ariaLabel?: string;
+};
+/**
+ * Underline / chip style tab strip for switching content; `role="tablist"` with keyboard focus on tabs.
+ *
+ * @param {ContentSwitchProps} props - `options`, `selected`, `onChange`, and global `disabled` to dim all.
+ * @returns {JSX.Element} The tablist container and one `button` tab per option.
+ */
+export declare const ContentSwitch: ({ options, selected, onChange, variant, className, optionClassName, disabled, ariaLabel, }: ContentSwitchProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/charts/components/src/date-picker/date-picker.d.ts

@@ -0,0 +1,35 @@
+import "./date-picker.css";
+/**
+ * Date input with inline `Calendar` popover: single `Date` or start/end `range` tuple.
+ *
+ * @property {"single"|"range"} [mode] - Field format and `value`/`onChange` shape. Default `"single"`.
+ * @property {Date|null|[Date|null,Date|null]} [value] - `null` means cleared; range uses tuple with partial `null` while picking.
+ * @property {(v:Date|null|[Date|null,Date|null]) => void} [onChange] - Emits the same shape as `value`.
+ * @property {Date} [minDate] - Inclusive lower bound for the calendar. Optional.
+ * @property {Date} [maxDate] - Inclusive upper bound. Optional.
+ * @property {Date[]} [disabledDates] - Unselectable days. Default `[]`.
+ * @property {string} [placeholder] - Empty input text. Default `"MM/DD/YYYY"`.
+ */
+interface DatePickerProps {
+    mode?: "single" | "range";
+    value?: Date | null | [Date | null, Date | null];
+    onChange?: (value: Date | null | [Date | null, Date | null]) => void;
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDates?: Date[];
+    placeholder?: string;
+    label?: string;
+    endLabel?: string;
+    disabled?: boolean;
+    className?: string;
+    error?: string;
+    note?: string;
+}
+/**
+ * Renders a text field that opens a `Calendar` for one date or a range, with min/max and disabled day rules.
+ *
+ * @param {DatePickerProps} props - `mode` drives value typing; `label` / `endLabel` for field captions.
+ * @returns {JSX.Element} The field group, popover calendar, and optional note/error.
+ */
+export declare const DatePicker: ({ mode, value, onChange, minDate, maxDate, disabledDates, placeholder, label, endLabel, disabled, className, error, note, }: DatePickerProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/charts/components/src/date-range-picker/date-range-picker.d.ts

@@ -0,0 +1,39 @@
+import "./date-range-picker.css";
+/**
+ * Built-in range shortcut id (e.g. `last_7_days`, `custom` to open the calendar only).
+ * @type {string}
+ */
+export type Preset = "today" | "last_7_days" | "last_30_days" | "last_3_months" | "last_6_months" | "last_12_months" | "month_to_date" | "year_to_date" | "next_7_days" | "next_30_days" | "next_3_months" | "next_6_months" | "next_12_months" | "rest_of_month" | "rest_of_year" | "custom";
+type PresetDirection = "last" | "next";
+/**
+ * Two-field range with preset radio list and embedded `Calendar` for `custom` / adjustments.
+ * **Controlled** via `value: [Date|null, Date|null]`.
+ *
+ * @property {[Date|null,Date|null]} [value] - Inclusive start/end; `null` slot means unset.
+ * @property {(value: [Date|null,Date|null]) => void} [onChange] - Emits the full tuple on change.
+ * @property {PresetDirection} [presetDirection] - `"last"` vs `"next"` preset menu. Default `"last"`.
+ * @property {Preset} [defaultPreset] - Initial active preset. Default `"custom"`.
+ * @property {(date: Date) => string} [formatDate] - Formats the two summary fields; default YYYY/MM/DD.
+ * @property {Date} [minDate] - Forwarded to `Calendar`. Optional.
+ * @property {Date} [maxDate] - Forwarded to `Calendar`. Optional.
+ */
+interface DateRangePickerProps {
+    value?: [Date | null, Date | null];
+    onChange?: (value: [Date | null, Date | null]) => void;
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDates?: Date[];
+    presetDirection?: PresetDirection;
+    defaultPreset?: Preset;
+    /** Custom date display formatter. Defaults to YYYY/MM/DD. */
+    formatDate?: (date: Date) => string;
+    className?: string;
+}
+/**
+ * Renders preset radios plus a range `Calendar` and forwards remaining props (min/max, disabled days) to it.
+ *
+ * @param {DateRangePickerProps} props - `value`/`onChange` tuple, presets, and optional `className`.
+ * @returns {JSX.Element} The preset column, field pair, and popover `Calendar` when `custom` is active.
+ */
+export declare const DateRangePicker: ({ value, onChange, presetDirection, defaultPreset, formatDate, className, ...calendarProps }: DateRangePickerProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/charts/components/src/dropdown/dropdown.d.ts

@@ -0,0 +1,53 @@
+import "./dropdown.css";
+import React from "react";
+import type { TooltipPosition } from "../../../types";
+/**
+ * One selectable item in a `Dropdown` `options` list.
+ *
+ * @property {string} label - User-visible text in the list and when selected.
+ * @property {string} value - Stable value passed to `onChange`.
+ * @property {boolean} [disabled] - When true, the option cannot be selected. Default `false`.
+ */
+export interface DropdownOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+/**
+ * Props for the `Dropdown` component. **Controlled** via `value` and `onChange`
+ * (selected option `value` string, or `undefined` when cleared).
+ *
+ * @property {DropdownOption[]} options - The full list to render and filter.
+ * @property {string|undefined} [value] - Selected option’s `value`, or `undefined` when empty/cleared.
+ * @property {(value: string|undefined) => void} [onChange] - Called on select or clear.
+ * @property {boolean} [enableSearch] - When true, filters options by a search string. Default `false`.
+ * @property {"top"|"bottom"|"auto"} [direction] - Where the panel opens relative to the field. Default `"auto"`.
+ */
+interface DropdownProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "size" | "value" | "onChange"> {
+    size?: "sm" | "md" | "lg";
+    label?: string;
+    showClear?: boolean;
+    note?: string;
+    error?: string;
+    containerClassName?: string;
+    options: DropdownOption[];
+    placeholder?: string;
+    value?: string;
+    onChange?: (value: string | undefined) => void;
+    enableSearch?: boolean;
+    direction?: "top" | "bottom" | "auto";
+    arrowClassName?: string;
+    tooltip?: string;
+    tooltipPosition?: TooltipPosition;
+    onOpen?: () => void;
+    onClose?: () => void;
+}
+/**
+ * Single-select combobox: trigger button, optional in-list search, clear, and field chrome (label, error, note).
+ *
+ * @param {DropdownProps} props - Controlled `value` / `onChange` and `options` list.
+ * @param {React.Ref<HTMLButtonElement>} ref - Reference to the trigger `<button>`.
+ * @returns {React.ReactElement} The closed trigger and absolutely positioned list when open.
+ */
+export declare const Dropdown: React.ForwardRefExoticComponent<DropdownProps & React.RefAttributes<HTMLButtonElement>>;
+export {};

package/dist/charts/components/src/expandable-table/expandable-table.d.ts

@@ -0,0 +1,61 @@
+import "./expandable-table.css";
+import React from "react";
+import type { SortDirection } from "../table/table";
+/**
+ * Column model for `ExpandableTable` (like `TableColumn` with an optional per-row expand body).
+ * @template T - Row type.
+ * @property {string} key - Field accessor and React `key` fragment for this column.
+ * @property {function(unknown, T): React.ReactNode} [render] - Custom cell; args are `row[key]` and `row`.
+ */
+export interface ExpandableTableColumn<T> {
+    key: string;
+    label: string;
+    sortable?: boolean;
+    minWidth?: string;
+    maxWidth?: string;
+    width?: string;
+    render?: (value: unknown, row: T) => React.ReactNode;
+}
+/**
+ * @template T
+ * @property {ExpandableTableColumn<T>[]} columns - Display columns; add `__selection` via table utilities if needed.
+ * @property {T[]} data - Row array.
+ * @property {function(T): React.ReactNode} [renderExpandedContent] - Renders under the row when that row is expanded.
+ * @property {T[]} [selectedRows] - **Controlled** selection; paired with `onSelectionChange` and `rowKey`.
+ * @property {keyof T} [rowKey] - Unique per row for selection keys. Default `id` if present.
+ */
+interface ExpandableTableProps<T extends Record<string, unknown>> {
+    columns: ExpandableTableColumn<T>[];
+    data: T[];
+    renderExpandedContent?: (row: T) => React.ReactNode;
+    isLoading?: boolean;
+    className?: string;
+    containerClassName?: string;
+    rowHeight?: string;
+    sortKey?: string;
+    sortDirection?: SortDirection;
+    currentPage?: number;
+    totalPages?: number;
+    perPage?: number;
+    perPageOptions?: {
+        label: string;
+        value: number;
+    }[];
+    onSort?: (key: string, direction: SortDirection) => void;
+    onPageChange?: (page: number) => void;
+    onPerPageChange?: (perPage: number) => void;
+    maxHeight?: string;
+    selectedRows?: T[];
+    onSelectionChange?: (rows: T[]) => void;
+    rowKey?: keyof T;
+    onRowClick?: (row: T, rowIndex: number) => void;
+}
+/**
+ * Data table with optional expandable row body (`renderExpandedContent`), sort, selection, and pagination.
+ *
+ * @template T - `Record<string, any>` row shape; `rowKey` picks stable identity.
+ * @param {object} props - `columns` / `data` plus optional `renderExpandedContent` for the slide-down.
+ * @returns {JSX.Element} The grid, expansion rows, and optional `Pagination` / `Loader`.
+ */
+export declare function ExpandableTable<T extends Record<string, unknown>>({ columns, data, renderExpandedContent, isLoading, className, rowHeight, sortKey, sortDirection, onSort, currentPage, totalPages, perPage, perPageOptions, onPageChange, onPerPageChange, maxHeight, containerClassName, selectedRows, onSelectionChange, rowKey, onRowClick, }: ExpandableTableProps<T>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/charts/components/src/icon/icon-paths.d.ts

@@ -0,0 +1,3 @@
+import type React from "react";
+import type { IconType } from "../../../types";
+export declare const ICON_PATHS: Record<IconType, React.ReactNode>;

package/dist/charts/components/src/icon/icon.d.ts

@@ -0,0 +1,28 @@
+import type React from "react";
+import type { IconType, TooltipPosition } from "../../../types";
+/**
+ * Props for the `Icon` component. Spreads onto the root `<svg>` (size, `className`, `aria-*`, etc.).
+ *
+ * @property {import("../../../types").IconType} icon - Registry key for the glyph to draw.
+ * @property {number} [size] - Width/height in px. Default `24`.
+ * @property {string|React.ReactNode} [tooltip] - If set, wraps the SVG in `Tooltip` (string → `text`; node → `content`).
+ * @property {import("../../../types").TooltipPosition} [tooltipPosition] - Placement when `tooltip` is set. Default `"top"`.
+ * @property {"dark"|"light"} [tooltipVariant] - Tooltip surface style. Default `"dark"`.
+ * @property {number} [strokeWidth] - SVG stroke width. Default `2`.
+ */
+interface IconProps extends React.SVGProps<SVGSVGElement> {
+    icon: IconType;
+    size?: number;
+    tooltip?: string | React.ReactNode;
+    tooltipPosition?: TooltipPosition;
+    tooltipVariant?: "dark" | "light";
+    strokeWidth?: number;
+}
+/**
+ * Renders a named vector icon from the library map, optionally inside a `Tooltip`.
+ *
+ * @param {IconProps} props - `icon` plus standard `SVGSVGElement` props.
+ * @returns {JSX.Element} A plain `<svg>` or a `Tooltip`-wrapped `<svg>`.
+ */
+export declare const Icon: ({ icon, size, tooltip, tooltipPosition, tooltipVariant, strokeWidth, ...props }: IconProps) => JSX.Element;
+export {};

package/dist/charts/components/src/input/input.d.ts

@@ -0,0 +1,29 @@
+import "./input.css";
+import type { IconType, TooltipPosition } from "../../../types";
+/**
+ * Extends `HTMLInputElement` attributes
+ *
+ * @property {"sm"|"md"|"lg"} [size] - Field height and font scale. Default `"md"`.
+ * @property {import("../../../types").IconType} [leftIcon] - Optional left decorative/action icon.
+ * @property {import("../../../types").IconType} [rightIcon] - Optional right icon; pair with `onRightIconClick` for an action.
+ * @property {boolean} [showClear] - Shows a clear control when the field has a value. Default `false`.
+ * @property {string} [note] - Helper text below the field (non-error).
+ * @property {string} [error] - Error message; styles the field as invalid when set.
+ * @property {string} [tooltip] - Info `Tooltip` on the label (via info icon) when set.
+ * @property {import("../../../types").TooltipPosition} [tooltipPosition] - Tooltip position for `tooltip`. Default `"top"`.
+ */
+interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size"> {
+    size?: "sm" | "md" | "lg";
+    label?: string;
+    leftIcon?: IconType;
+    rightIcon?: IconType;
+    onRightIconClick?: () => void;
+    showClear?: boolean;
+    note?: string;
+    error?: string;
+    containerClassName?: string;
+    tooltip?: string;
+    tooltipPosition?: TooltipPosition;
+}
+export declare const Input: import("react").ForwardRefExoticComponent<InputProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};

package/dist/charts/components/src/loader/loader.d.ts

@@ -0,0 +1,12 @@
+import "./loader.css";
+import type { HTMLAttributes } from "react";
+type LoaderVariant = "dots" | "bars" | "spinner";
+interface LoaderProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Visual style: `dots`, `bars`, or `spinner` (default). */
+    variant?: LoaderVariant;
+}
+/**
+ * Inline loading indicator. Three CSS-only variants; defaults to `spinner`.
+ */
+export declare function Loader({ variant, className, role, "aria-label": ariaLabel, ...props }: LoaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/charts/components/src/logo/logo.d.ts

@@ -0,0 +1,12 @@
+/**
+ * H2O brand mark: inline SVG, inherits `color` for `currentColor` fill.
+ *
+ * @param {object} props
+ * @param {string} [props.className] - Optional classes on the root `<svg>`.
+ * @param {number} [props.size] - Width and height in pixels. Default `36`.
+ * @returns {JSX.Element} The logo `<svg>`.
+ */
+export declare function Logo({ className, size }: {
+    className?: string;
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/charts/components/src/message/message.d.ts

@@ -0,0 +1,34 @@
+import "./message.css";
+/**
+ * Banner tone: drives icon, border/background, and ARIA `role` selection.
+ * @type {("info"|"muted"|"error"|"warning"|"success")}
+ */
+export type MessageVariant = "info" | "muted" | "error" | "warning" | "success";
+/**
+ * Inline alert/banner: icon, optional text or `children`, optional dismiss.
+ *
+ * @property {MessageVariant} variant - Visual and semantic style.
+ * @property {string} [message] - Shorthand body string; if omitted, use `children`.
+ * @property {React.ReactNode} [children] - Rich content; wins over `message` when both set.
+ * @property {() => void} [onDismiss] - When set, shows a close control and calls this on dismiss.
+ * @property {number} [iconSize] - Icon box in px. Default `16`.
+ * @property {number} [iconStrokeWidth] - Stroke width of the left icon. Default `1.5`.
+ */
+interface MessageProps {
+    variant: MessageVariant;
+    className?: string;
+    iconSize?: number;
+    iconStrokeWidth?: number;
+    iconClassName?: string;
+    message?: string;
+    children?: React.ReactNode;
+    onDismiss?: () => void;
+}
+/**
+ * Renders a one-line or short multi-line system message; returns `null` if neither `message` nor `children` is provided.
+ *
+ * @param {MessageProps} props - Variant, content, and optional dismiss.
+ * @returns {JSX.Element | null} The banner, or `null` when there is no content to show.
+ */
+export declare const Message: ({ variant, className, iconSize, iconStrokeWidth, iconClassName, message, children, onDismiss, }: MessageProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/charts/components/src/modal/modal.d.ts

@@ -0,0 +1,35 @@
+import "./modal.css";
+import type React from "react";
+/**
+ * Modal dialog: **controlled** by `isOpen`; optional `onClose` for overlay/Escape/close button.
+ *
+ * @property {boolean} isOpen - Renders the portal and trap when `true`.
+ * @property {() => void} [onClose] - If omitted, the header close is hidden / no-op depending on design.
+ * @property {React.ReactNode} children - Primary dialog body.
+ * @property {React.ReactNode} [footer] - Sticky action row below the body.
+ * @property {"sm"|"md"|"lg"} [size] - Max width of the card. Default `"md"`.
+ */
+interface ModalProps {
+    isOpen: boolean;
+    onClose?: () => void;
+    title?: string;
+    description?: string;
+    children: React.ReactNode;
+    footer?: React.ReactNode;
+    size?: "sm" | "md" | "lg";
+    className?: string;
+    titleContainerClassName?: string;
+    titleClassName?: string;
+    descriptionClassName?: string;
+    closeButtonClassName?: string;
+    headerClassName?: string;
+    contentClassName?: string;
+}
+/**
+ * Centered overlay card with `role="dialog"`, focus trap, and optional title/description slots.
+ *
+ * @param {object} props - `isOpen` and content slots; BEM `className` parts for theming.
+ * @returns {JSX.Element | null} The dialog portal when `isOpen`, else `null`.
+ */
+export declare const Modal: ({ isOpen, onClose, title, description, children, footer, size, className, titleContainerClassName, titleClassName, descriptionClassName, closeButtonClassName, headerClassName, contentClassName, }: ModalProps) => React.ReactPortal | null;
+export {};

package/dist/charts/components/src/month-calendar/month-calendar.d.ts

@@ -0,0 +1,28 @@
+import "./month-calendar.css";
+/**
+ * Month/year picker: grid of 12 months or a decade of years; no day-level selection.
+ *
+ * @property {Date} [value] - Optional controlled selection (month precision; only month/year are meaningful).
+ * @property {(value: Date) => void} [onChange] - Fires with the first day of the selected month.
+ * @property {Date} [minDate] - Inclusive lower bound; whole months before this are disabled.
+ * @property {Date} [maxDate] - Inclusive upper bound; months after are disabled.
+ * @property {Date[]} [disabledDates] - Extra disabled calendar days; months with only disabled coverage may be limited by implementation.
+ * @property {(year: number) => void} [onYearChange] - Fires when the user navigates to another year in month view.
+ */
+interface MonthCalendarProps {
+    value?: Date;
+    onChange?: (value: Date) => void;
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDates?: Date[];
+    onYearChange?: (year: number) => void;
+    className?: string;
+}
+/**
+ * Browses years and months in two views; enforces `minDate` / `maxDate` and optional `disabledDates`.
+ *
+ * @param {MonthCalendarProps} props - Value, change handler, and bounds.
+ * @returns {JSX.Element} The month/year navigation UI and grid.
+ */
+declare const MonthCalendar: ({ value, onChange, minDate, maxDate, onYearChange, className, }: MonthCalendarProps) => JSX.Element;
+export { MonthCalendar };

package/dist/charts/components/src/multi-menu/multi-menu.d.ts

@@ -0,0 +1,39 @@
+import "./multi-menu.css";
+import React from "react";
+/**
+ * One node in a nested `MultiMenu` tree (siblings at the same level need unique `value`s).
+ *
+ * @property {string} label - Menu row label.
+ * @property {string} value - Stable id; must be unique among siblings.
+ * @property {() => void} [onClick] - Fires when a leaf (no `subItems`) is activated; skipped when `subItems` exist.
+ * @property {MultiMenuItem[]} [subItems] - If present, opens a sub-panel with these entries.
+ */
+export interface MultiMenuItem {
+    label: string;
+    value: string;
+    onClick?: () => void;
+    disabled?: boolean;
+    subItems?: MultiMenuItem[];
+}
+/**
+ * Hierarchical “overflow” / actions menu: trigger button and cascading flyouts from `items`.
+ * Extends `HTMLButtonElement` attributes except `size` (use design-system `size` instead).
+ *
+ * @property {MultiMenuItem[]} items - Top-level item tree.
+ * @property {string} [label] - Trigger button text. Default `"Options"`.
+ */
+interface MultiMenuProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "size"> {
+    size?: "sm" | "md" | "lg";
+    label?: string;
+    containerClassName?: string;
+    items: MultiMenuItem[];
+}
+/**
+ * Renders a menu trigger and nested panels; supports keyboard navigation and click-outside close.
+ *
+ * @param {MultiMenuProps} props - Tree in `items` and trigger props.
+ * @param {React.Ref<HTMLButtonElement>} ref - For the top-level menu trigger.
+ * @returns {React.ReactElement} Markup for the trigger and any open flyout(s).
+ */
+export declare const MultiMenu: React.ForwardRefExoticComponent<MultiMenuProps & React.RefAttributes<HTMLButtonElement>>;
+export {};