@veevarts/design-system 1.18.0 → 1.19.0

package/dist/patterns/CheckboxCardGroup/CheckboxCardGroup.d.ts

@@ -0,0 +1,53 @@
+import { default as React } from 'react';
+export interface CheckboxCardOption {
+    /** Stable identifier surfaced through `onChange`. */
+    key: string;
+    /** Visible label. */
+    label: string;
+    /** Optional secondary line under the label. */
+    description?: string;
+    /** Iconify name (`'solar:ticket-outline'`) or a custom node. */
+    icon?: string | React.ReactNode;
+    /** Disable just this card. */
+    isDisabled?: boolean;
+    /** Override per-card test id; defaults to `${dataTestId}-${key}`. */
+    'data-testid'?: string;
+}
+export interface CheckboxCardGroupClassNames {
+    base?: string;
+    grid?: string;
+    card?: string;
+    hint?: string;
+}
+export interface CheckboxCardGroupProps {
+    /** Options to render in order. */
+    options: readonly CheckboxCardOption[];
+    /** Currently selected option keys. */
+    selectedKeys: readonly string[];
+    /** Fires with the next full selection whenever a card is toggled. Keys are emitted in the original option order (not selection order); any selected key not present in `options` is preserved. */
+    onChange: (keys: string[]) => void;
+    /** Optional heading rendered above the grid (labels the group). */
+    heading?: string;
+    /** `aria-label` for the group when `heading` is omitted. Default `'Select options'`. */
+    ariaLabel?: string;
+    /** Grid columns on >= sm. Default `2`. */
+    columnsDesktop?: 2 | 3 | 4;
+    /** Grid columns on mobile. Default `1`. */
+    columnsMobile?: 1 | 2;
+    /**
+     * Minimum number of selections. When set, the group auto-derives its
+     * invalid state (`selectedKeys.length < minSelected`) and a default hint,
+     * unless `isInvalid` / `hint` are explicitly supplied.
+     */
+    minSelected?: number;
+    /** Helper text under the grid. Overrides the `minSelected` default hint. */
+    hint?: React.ReactNode;
+    /** Error styling + `aria-invalid`. Overrides the `minSelected`-derived state. */
+    isInvalid?: boolean;
+    /** Disable every card. */
+    isDisabled?: boolean;
+    className?: string;
+    classNames?: CheckboxCardGroupClassNames;
+    'data-testid'?: string;
+}
+export declare const CheckboxCardGroup: React.FC<CheckboxCardGroupProps>;

package/dist/patterns/CheckboxCardGroup/index.d.ts

@@ -0,0 +1,2 @@
+export { CheckboxCardGroup } from './CheckboxCardGroup';
+export type { CheckboxCardGroupProps, CheckboxCardGroupClassNames, CheckboxCardOption, } from './CheckboxCardGroup';

package/dist/patterns/ConfirmDialog/ConfirmDialog.d.ts

@@ -1,21 +1,34 @@
 import { default as React } from 'react';
+export type ConfirmDialogVariant = 'danger' | 'warning';
 export interface ConfirmDialogProps {
-    /** Whether the dialog is currently open. Controlled by the host. */
+    /** Whether the dialog is open. Controlled by the host. */
     isOpen: boolean;
     /** Title rendered as the dialog heading. */
     title: string;
-    /** Body copy explaining the consequences of confirming. */
-    body: string;
     /** Label for the confirm action. */
     confirmLabel: string;
-    /** Visual variant of the confirm button. Default `'danger'`. */
-    confirmVariant?: 'danger' | 'primary';
-    /** Label for the dismiss action. */
-    dismissLabel: string;
     /** Fires when the user confirms. */
     onConfirm: () => void;
-    /** Fires when the user dismisses (Cancel button OR Esc / outside click). */
-    onDismiss: () => void;
+    /** HeroUI open-change; fires with `false` on cancel / Esc / outside click. */
+    onOpenChange?: (open: boolean) => void;
+    /** Rich body content. Overrides `description`. */
+    children?: React.ReactNode;
+    /** Body copy explaining the consequences of confirming. */
+    description?: React.ReactNode;
+    /** Label for the cancel action. Default `'Cancel'`. */
+    cancelLabel?: string;
+    /** Semantic variant driving the icon tile + confirm colour. Default `'danger'`. */
+    variant?: ConfirmDialogVariant;
+    /** Spinner on confirm + locks every dismissal channel while true. Default `false`. */
+    isPending?: boolean;
+    /** Override backdrop dismissability. Defaults to `!isPending`. */
+    isDismissable?: boolean;
+    /** Disable Esc-to-close. Forced on while `isPending`. Default `false`. */
+    isKeyboardDismissDisabled?: boolean;
+    /** Hide the header icon tile. */
+    hideIcon?: boolean;
+    /** Override the header icon (iconify name or node). Defaults to the variant icon. */
+    icon?: string | React.ReactNode;
     'data-testid'?: string;
 }
 export declare const ConfirmDialog: React.FC<ConfirmDialogProps>;

package/dist/patterns/ConfirmDialog/index.d.ts

@@ -1,2 +1,2 @@
 export { ConfirmDialog } from './ConfirmDialog';
-export type { ConfirmDialogProps } from './ConfirmDialog';
+export type { ConfirmDialogProps, ConfirmDialogVariant } from './ConfirmDialog';

package/dist/patterns/ListPanel/ListPanel.d.ts

@@ -0,0 +1,45 @@
+import { default as React } from 'react';
+export interface ListPanelClassNames {
+    base?: string;
+    state?: string;
+}
+export interface ListPanelProps {
+    /** Show the loading state. Highest precedence (loading > error > empty > children). */
+    isLoading?: boolean;
+    /** Show the error state. Wins over empty and children. */
+    isError?: boolean;
+    /** Show the empty state. Wins over children. */
+    isEmpty?: boolean;
+    /** Loading headline. Default `'Loading…'`. */
+    loadingTitle?: React.ReactNode;
+    /** Replace the whole loading state. */
+    loadingContent?: React.ReactNode;
+    /** Error headline. Default `'Something went wrong'`. */
+    errorTitle?: React.ReactNode;
+    /** Error supporting copy. */
+    errorDescription?: React.ReactNode;
+    /** Retry button label. Default `'Retry'`. Rendered only when `onRetry` is set. */
+    retryLabel?: React.ReactNode;
+    /** Retry handler; when set, a Retry button appears in the error state. */
+    onRetry?: () => void;
+    /** Replace the error state's action area (overrides the Retry button). */
+    errorActions?: React.ReactNode;
+    /** Replace the whole error state. */
+    errorContent?: React.ReactNode;
+    /** Empty headline. Default `'Nothing here yet'`. */
+    emptyTitle?: React.ReactNode;
+    /** Empty supporting copy. */
+    emptyDescription?: React.ReactNode;
+    /** Iconify name or node for the empty state. */
+    emptyIcon?: string | React.ReactNode | false;
+    /** Empty-state CTA area. */
+    emptyActions?: React.ReactNode;
+    /** Replace the whole empty state. */
+    emptyContent?: React.ReactNode;
+    /** The table/list rendered when none of the async states apply. */
+    children?: React.ReactNode;
+    className?: string;
+    classNames?: ListPanelClassNames;
+    'data-testid'?: string;
+}
+export declare const ListPanel: React.FC<ListPanelProps>;

package/dist/patterns/ListPanel/index.d.ts

@@ -0,0 +1,2 @@
+export { ListPanel } from './ListPanel';
+export type { ListPanelProps, ListPanelClassNames } from './ListPanel';

package/dist/patterns/PageHeader/PageHeader.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+export interface PageHeaderClassNames {
+    base?: string;
+    iconWrapper?: string;
+    eyebrow?: string;
+    title?: string;
+    subtitle?: string;
+    actions?: string;
+}
+export interface PageHeaderProps {
+    /** Main heading. */
+    title: React.ReactNode;
+    /** Supporting copy under the title. */
+    subtitle?: React.ReactNode;
+    /** Small uppercase label above the title (e.g. a section or category name). */
+    eyebrow?: React.ReactNode;
+    /** Iconify name (`'solar:tag-outline'`) or a custom node for the tile. */
+    icon?: string | React.ReactNode;
+    /** Short text rendered in the tile when no `icon` is given (e.g. "DT"). */
+    initials?: string;
+    /**
+     * Right-aligned action area. Compose the primary CTA here, with an
+     * optional secondary button alongside it (caller-composed). Style the
+     * tile via `classNames.iconWrapper`.
+     */
+    actions?: React.ReactNode;
+    /** Heading level for the title element. Default `'h1'`. */
+    titleAs?: 'h1' | 'h2' | 'h3';
+    className?: string;
+    classNames?: PageHeaderClassNames;
+    'data-testid'?: string;
+}
+export declare const PageHeader: React.FC<PageHeaderProps>;

package/dist/patterns/PageHeader/index.d.ts

@@ -0,0 +1,2 @@
+export { PageHeader } from './PageHeader';
+export type { PageHeaderProps, PageHeaderClassNames } from './PageHeader';

package/dist/patterns/StatusChip/StatusChip.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+import { ChipProps } from '../../components';
+/** Domain-agnostic lifecycle states an admin row can be in. */
+export type StatusChipStatus = 'active' | 'archived' | 'inactive' | 'draft' | 'pending' | 'success' | 'warning' | 'danger' | 'neutral';
+export interface StatusChipProps {
+    /** Lifecycle state — selects the colour/tone only, never the text. */
+    status: StatusChipStatus;
+    /** Visible label. Caller-supplied so no domain copy lives here. */
+    label: React.ReactNode;
+    /** HeroUI chip variant. Default `'flat'` (soft pill). */
+    variant?: ChipProps['variant'];
+    /** Chip size. Default `'sm'`. */
+    size?: ChipProps['size'];
+    /**
+     * Override the colour derived from `status`. Escape hatch for the
+     * rare state not covered by `StatusChipStatus`.
+     */
+    color?: ChipProps['color'];
+    /** Optional leading element (dot, icon). */
+    startContent?: React.ReactNode;
+    className?: string;
+    'data-testid'?: string;
+}
+export declare const StatusChip: React.FC<StatusChipProps>;

package/dist/patterns/StatusChip/index.d.ts

@@ -0,0 +1,2 @@
+export { StatusChip } from './StatusChip';
+export type { StatusChipProps, StatusChipStatus } from './StatusChip';

package/dist/patterns/grid-columns.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared responsive grid-column class maps for the card-picker patterns
+ * (TileSelect single-select, CheckboxCardGroup multi-select). Kept in one
+ * place so the two siblings never drift on breakpoints or column counts.
+ *
+ * The literal Tailwind classes must stay spelled out (not interpolated) so
+ * the JIT scanner keeps generating them.
+ */
+export declare const GRID_DESKTOP_COLS: Record<2 | 3 | 4, string>;
+export declare const GRID_MOBILE_COLS: Record<1 | 2, string>;

package/dist/patterns/index.d.ts

@@ -41,6 +41,14 @@ export { FilterPopover } from './FilterPopover';
 export type * from './FilterPopover';
 export { SessionTimeline } from './SessionTimeline';
 export type * from './SessionTimeline';
+export { PageHeader } from './PageHeader';
+export type { PageHeaderProps, PageHeaderClassNames } from './PageHeader';
+export { StatusChip } from './StatusChip';
+export type { StatusChipProps, StatusChipStatus } from './StatusChip';
+export { CheckboxCardGroup } from './CheckboxCardGroup';
+export type { CheckboxCardGroupProps, CheckboxCardOption } from './CheckboxCardGroup';
+export { ListPanel } from './ListPanel';
+export type { ListPanelProps, ListPanelClassNames } from './ListPanel';
 export { CashTenderForm } from './CashTenderForm';
 export type { CashTenderFormProps, CashTenderValue, CashTenderLabels, } from './CashTenderForm';
 export { CheckTenderForm } from './CheckTenderForm';
@@ -64,6 +72,6 @@ export type { PaymentCashChangeBannerProps } from './PaymentCashChangeBanner';
 export { PaymentSubAmountInput } from './PaymentSubAmountInput';
 export type { PaymentSubAmountInputProps } from './PaymentSubAmountInput';
 export { ConfirmDialog } from './ConfirmDialog';
-export type { ConfirmDialogProps } from './ConfirmDialog';
+export type { ConfirmDialogProps, ConfirmDialogVariant } from './ConfirmDialog';
 export { Summary } from './Summary';
 export type { SummaryProps, SummaryLineItem, SummaryItemDetail, SummaryServiceFee, SummaryTotalRow, SummaryPrimaryAction, SummaryLabels, } from './Summary';

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@veevarts/design-system",
     "private": false,
-    "version": "1.18.0",
+    "version": "1.19.0",
     "type": "module",
     "main": "dist/index.js",
     "module": "dist/index.js",