@veevarts/design-system 2.0.0-alpha.6 → 2.0.0-alpha.61

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

@@ -0,0 +1,4 @@
+export { VerticalSteps } from './VerticalSteps';
+export { StepsReadiness } from './StepsReadiness';
+export { StepPager } from './StepPager';
+export type { VerticalStep, VerticalStepStatus, VerticalStepsProps, VerticalStepsStatusLabels, StepsReadinessProps, StepsReadinessVariant, StepPagerProps, } from './types';

package/dist/patterns/VerticalSteps/styles.d.ts

@@ -0,0 +1,54 @@
+import { StepsReadinessVariant, VerticalStepStatus } from './types';
+/** One glyph per status, so the state reads by shape before color. */
+export declare const STEP_STATUS_ICON: Record<VerticalStepStatus, string>;
+/**
+ * `icon` paints the glyph; `meta` the line under the label.
+ *
+ * The optional ring is `--muted` (gray-400, 2.54:1): it is decorative, the
+ * visible word "Optional" carries the state. Every text tone is `--sub`
+ * (gray-500, 4.83:1) or darker; `--warn` is warning-700, 5.02:1 on white.
+ */
+export declare const STEP_STATUS_TONE: Record<VerticalStepStatus, {
+    icon: string;
+    meta: string;
+}>;
+/** Label color for every row. */
+export declare const STEP_LABEL_COLOR: string;
+export declare const READINESS_ICON: Record<StepsReadinessVariant, string>;
+/** Fill plus the one text tone on it. Both pairs are held to 4.5:1 in `admin-surface.test.ts`. */
+export declare const READINESS_TONE: Record<StepsReadinessVariant, {
+    fill: string;
+    text: string;
+}>;
+export declare const verticalStepsClass: {
+    /** Scrolls inside once `maxHeight` (or the parent) caps it. */
+    readonly root: "flex min-h-0 flex-col gap-3 overflow-y-auto overscroll-contain";
+    readonly nav: "rounded-2xl border border-acct-border bg-acct-surface p-1.5";
+    readonly list: "m-0 flex list-none flex-col gap-0.5 p-0";
+    /**
+     * The DS Button supplies the hit target, the focus ring and press
+     * handling; its centered single-line box is undone so a row can wrap.
+     */
+    readonly row: string;
+    readonly rowCurrent: "bg-acct-hair data-[hover=true]:bg-acct-hair";
+    readonly icon: "mt-px size-5 shrink-0";
+    readonly text: "flex min-w-0 flex-1 flex-col gap-0.5";
+    readonly label: "text-sm leading-5";
+    readonly labelCurrent: "font-semibold";
+    readonly meta: "text-xs leading-4 [overflow-wrap:anywhere]";
+};
+export declare const stepsReadinessClass: {
+    readonly root: "flex items-start gap-2.5 rounded-2xl px-4 py-3";
+    readonly icon: "mt-0.5 size-5 shrink-0";
+    readonly text: "flex min-w-0 flex-col";
+    readonly title: "text-sm font-semibold leading-5";
+    readonly description: "text-xs leading-4";
+};
+export declare const stepPagerClass: {
+    readonly root: "flex flex-wrap items-center justify-between gap-3";
+    /** Keeps the progress text centered when one side has no button. */
+    readonly spacer: "min-w-0 flex-1 basis-0";
+    readonly progress: "shrink-0 text-xs text-acct-sub";
+    readonly endSlot: "flex min-w-0 flex-1 basis-0 justify-end";
+    readonly arrow: "size-4";
+};

package/dist/patterns/VerticalSteps/types.d.ts

@@ -0,0 +1,100 @@
+import { default as React, ReactNode } from 'react';
+/**
+ * Where a step stands. `done` and `optional` need nothing; `needs-fix` is
+ * what stops the page from being ready, and carries a `reason`.
+ */
+export type VerticalStepStatus = 'done' | 'needs-fix' | 'optional';
+/** One row of a {@link VerticalSteps} panel, and one page of a {@link StepPager}. */
+export interface VerticalStep {
+    /** Stable id. Keys the row and its default test id. */
+    key: string;
+    /** Step name. The row prefixes its 1-based number; the pager shows it bare. */
+    label: string;
+    /** One line under the label: "3 tickets", "Nov 1 – Dec 31". */
+    summary?: ReactNode;
+    status: VerticalStepStatus;
+    /** What to fix ("Add the end date"). Shown instead of `summary` while `needs-fix`. */
+    reason?: ReactNode;
+    /** Override the row's test id; defaults to `${data-testid}-step-${key}`. */
+    testId?: string;
+}
+/**
+ * The status words, translated by the host. `optional` is visible
+ * ("Optional · 2 rules"); `done` and `needsFix` are read out only, before the
+ * summary or the reason, so include the punctuation your language wants there
+ * (`'Done.'`, `'Needs a fix:'`).
+ */
+export interface VerticalStepsStatusLabels {
+    done: string;
+    needsFix: string;
+    optional: string;
+}
+/**
+ * Same position model as `HorizontalSteps`: an index, controlled or not,
+ * with `onStepChange` and an `isStepReachable` gate.
+ */
+export interface VerticalStepsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    steps: VerticalStep[];
+    /** Controlled index of the active step. Omit for uncontrolled mode. */
+    currentStep?: number;
+    /** Starting index in uncontrolled mode. */
+    defaultStep?: number;
+    onStepChange?: (stepIndex: number) => void;
+    /**
+     * Steps for which this returns `false` render disabled and cannot be
+     * pressed. When omitted every step is reachable, which is the program
+     * page's case: no step is locked.
+     */
+    isStepReachable?: (stepIndex: number) => boolean;
+    /** Accessible name of the `<nav>` that holds the rows ("Program steps"). */
+    ariaLabel: string;
+    statusLabels: VerticalStepsStatusLabels;
+    /** Above the rows: a {@link StepsReadiness}, or anything else. */
+    header?: ReactNode;
+    /**
+     * Cap on the panel's height; past it the panel scrolls inside. Any CSS
+     * length (`'calc(100vh - 7rem)'`) or px number. The panel never sets
+     * `position: sticky` itself: the page that places it decides that.
+     */
+    maxHeight?: string | number;
+    'data-testid'?: string;
+}
+/**
+ * `ready` and `live` are the success tone and mark the panel ready
+ * (`data-ready="true"`); `fix` is the warning tone.
+ */
+export type StepsReadinessVariant = 'ready' | 'fix' | 'live';
+export interface StepsReadinessProps {
+    variant: StepsReadinessVariant;
+    /** "Ready to publish", "2 things to fix", "Live — visitors can buy". */
+    title: ReactNode;
+    /** The sub-line: "Fix them before you can publish." */
+    description?: ReactNode;
+    className?: string;
+    'data-testid'?: string;
+}
+export interface StepPagerProps {
+    steps: VerticalStep[];
+    /** Index of the step on screen; the same index `VerticalSteps` uses. */
+    currentStep: number;
+    onStepChange: (stepIndex: number) => void;
+    /** The middle text: `(n, total) => \`Step ${n} of ${total}\``. `n` is 1-based. */
+    progressLabel: (stepNumber: number, total: number) => ReactNode;
+    /** The forward button: `(step) => \`Next: ${step.label}\``. */
+    nextLabel: (step: VerticalStep) => ReactNode;
+    /** The back button. Defaults to the previous step's label. */
+    previousLabel?: (step: VerticalStep) => ReactNode;
+    /**
+     * Shown in place of Next on the last step ("Review and publish"). Omit it,
+     * or `onFinalAction`, and the last step has no forward button.
+     */
+    finalActionLabel?: ReactNode;
+    onFinalAction?: () => void;
+    isFinalActionDisabled?: boolean;
+    className?: string;
+    /** Root test id. The buttons' ids default to `${data-testid}-prev` / `-next` / `-final`. */
+    'data-testid'?: string;
+    previousTestId?: string;
+    nextTestId?: string;
+    finalActionTestId?: string;
+}

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

@@ -1,2 +1,2 @@
 export { WizardShell } from './WizardShell';
-export type { WizardShellProps, WizardStep, WizardStepState, WizardShellPrimaryAction, WizardShellSecondaryAction, WizardShellTotalRow, WizardShellLabels, } from './types';
+export type { WizardShellProps, WizardStep, WizardStepState, WizardShellPrimaryAction, WizardShellSecondaryAction, WizardShellTotalRow, WizardShellTotalBadge, WizardShellLabels, } from './types';

package/dist/patterns/WizardShell/types.d.ts

@@ -28,10 +28,16 @@ export interface WizardShellSecondaryAction {
  * the return covers less than the order, `owes` reads "Customer owes" when the
  * balance runs the other way.
  */
+export interface WizardShellTotalBadge {
+    label: string;
+    tone: 'warn' | 'neutral' | 'ok';
+}
 export interface WizardShellTotalRow {
     label: string;
     amount?: Money;
-    badge?: 'partial' | 'owes';
+    /** Renders the amount as a counter against this total: "Assigned $40.00 of $46.00". */
+    of?: Money;
+    badge?: 'partial' | 'owes' | WizardShellTotalBadge;
 }
 export interface WizardShellLabels {
     back?: string;
@@ -40,6 +46,8 @@ export interface WizardShellLabels {
     cancel?: string;
     partialBadge?: string;
     owesBadge?: string;
+    /** The word between `totalRow.amount` and `totalRow.of`. */
+    ofSeparator?: string;
 }
 export interface WizardShellProps {
     onClose?: () => void;

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

@@ -6,5 +6,5 @@
  * 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_DESKTOP_COLS: Record<2 | 3 | 4 | 5 | 6, string>;
 export declare const GRID_MOBILE_COLS: Record<1 | 2, string>;

package/dist/patterns/index.d.ts

@@ -4,19 +4,21 @@ export { Stepper } from './Stepper';
 export type { StepperProps } from './Stepper';
 export { HorizontalSteps } from './HorizontalSteps';
 export type { HorizontalStepsProps, HorizontalStepProps } from './HorizontalSteps';
+export { VerticalSteps, StepsReadiness, StepPager } from './VerticalSteps';
+export type { VerticalStep, VerticalStepStatus, VerticalStepsProps, VerticalStepsStatusLabels, StepsReadinessProps, StepsReadinessVariant, StepPagerProps, } from './VerticalSteps';
 export { Footer } from './Footer';
 export { Multiselect } from './Multiselect';
 export type { MultiselectProps } from './Multiselect';
 export { RichTextArea, RICH_TEXT_PRESETS } from './RichText';
 export type { RichTextAreaProps } from './RichText';
 export { DonationAmounts } from './DonationAmounts';
-export type { DonationAmountsProps, DonationAmount, SelectedDonation, DonationLabels } from './DonationAmounts';
+export type { DonationAmountsProps, DonationAmount, SelectedDonation, DonationLabels, DonationAmountsVariant, DonationAmountsCustomAmountPlacement, } from './DonationAmounts';
 export { ExpireCartTimer } from './ExpireCartTimer';
 export type { ExpireCartTimerProps } from './ExpireCartTimer';
-export { EventDetails } from './EventDetails';
-export type { EventDetailsProps } from './EventDetails';
-export { OfferCard, OfferCardList, OfferCardSkeleton, OfferCardError, OfferCardEmpty, offerListVariants, offerCardVariants, formatCurrency as formatOfferCurrency, parseCurrency as parseOfferCurrency, } from './OfferCard';
-export type { Offer, OfferSelection, OfferCardLabels, OfferCardErrorLabels, OfferCardClassNames, OfferCardListClassNames, OfferCardSkeletonClassNames, OfferCardErrorClassNames, OfferCardEmptyClassNames, OfferCardSlots, OfferCardProps, OfferCardListProps, OfferCardSkeletonProps, OfferCardErrorProps, OfferCardEmptyProps, } from './OfferCard';
+export { EventDetails } from './Programs/EventDetails';
+export type { EventDetailsProps } from './Programs/EventDetails';
+export { OfferCard, OfferCardList, OfferCardSkeleton, OfferCardError, OfferCardEmpty, offerListVariants, offerCardVariants, formatCurrency as formatOfferCurrency, parseCurrency as parseOfferCurrency, } from './Programs/OfferCard';
+export type { Offer, OfferSelection, OfferCardLabels, OfferCardErrorLabels, OfferCardClassNames, OfferCardListClassNames, OfferCardSkeletonClassNames, OfferCardErrorClassNames, OfferCardEmptyClassNames, OfferCardSlots, OfferCardProps, OfferCardListProps, OfferCardSkeletonProps, OfferCardErrorProps, OfferCardEmptyProps, } from './Programs/OfferCard';
 export { RevenueDistributionCard, RevenueDistributionSkeleton, RevenueDistributionError, RevenueDistributionEmpty, formatAmount as formatRevenueAmount, formatCurrency as formatRevenueCurrency, getCurrencySymbol, parseCurrency as parseRevenueCurrency, calculateAllocationDifference, generateDistributionId, } from './RevenueDistribution';
 export type { GlAccount, Distribution, RevenueDistributionLabels, RevenueDistributionErrorLabels, RevenueDistributionEmptyLabels, RevenueDistributionCardClassNames, RevenueDistributionSkeletonClassNames, RevenueDistributionErrorClassNames, RevenueDistributionEmptyClassNames, RevenueDistributionCardProps, RevenueDistributionSkeletonProps, RevenueDistributionErrorProps, RevenueDistributionEmptyProps, } from './RevenueDistribution';
 export { InstallmentFundAssignment, InstallmentFundAssignmentSkeleton } from './InstallmentFundAssignment';
@@ -31,8 +33,10 @@ export { MembershipSelectCards } from './MembershipSelectCards';
 export type * from './MembershipSelectCards';
 export { ItemCard } from './ItemCard';
 export type * from './ItemCard';
-export { CatalogItemCard } from './CatalogItemCard';
-export type * from './CatalogItemCard';
+export { CatalogItemCard } from './Programs/CatalogItemCard';
+export type * from './Programs/CatalogItemCard';
+export { ProgramListItem } from './Programs/ProgramListItem';
+export type * from './Programs/ProgramListItem';
 export { FeedbackState, EmptyState, ErrorState, LoadingState, SuccessState } from './FeedbackState';
 export type * from './FeedbackState';
 export { Toggle } from './Toggle';
@@ -41,8 +45,8 @@ export { TicketSelection } from './TicketSelection';
 export type * from './TicketSelection';
 export { FilterPopover } from './FilterPopover';
 export type * from './FilterPopover';
-export { SessionTimeline } from './SessionTimeline';
-export type * from './SessionTimeline';
+export { SessionTimeline } from './Programs/SessionTimeline';
+export type * from './Programs/SessionTimeline';
 export { PageHeader } from './PageHeader';
 export type { PageHeaderProps, PageHeaderClassNames } from './PageHeader';
 export { StatusChip } from './StatusChip';
@@ -55,20 +59,28 @@ export { TableSkeleton } from './TableSkeleton';
 export type { TableSkeletonProps, TableSkeletonClassNames } from './TableSkeleton';
 export { AdminTable, adminRowClass, adminTableClass, adminTableFooterClass, adminTdClass, adminThClass, } from './AdminTable';
 export type { AdminTableProps, AdminTableColumn, AdminTableClassNames } from './AdminTable';
+export { ExpandableTable } from './ExpandableTable';
+export type { ExpandableTableBreakpoint, ExpandableTableColumn, ExpandableTableExpandedChange, ExpandableTableLabels, ExpandableTableProps, ExpandableTableReason, ExpandableTableRowContext, } from './ExpandableTable';
+export { NeedsFixDot, firstNeedsFixKey } from './NeedsFixDot';
+export type { NeedsFixDotProps, NeedsFixItem } from './NeedsFixDot';
 export { AdminToolbar } from './AdminToolbar';
-export type { AdminToolbarProps } from './AdminToolbar';
+export type { AdminToolbarProps, AdminToolbarSearchWidth, AdminToolbarSize } from './AdminToolbar';
 export { ToolbarButton } from './ToolbarButton';
 export type { ToolbarButtonProps } from './ToolbarButton';
 export { UnderlineTabs } from './UnderlineTabs';
-export type { UnderlineTabsProps, UnderlineTabItem } from './UnderlineTabs';
-export { AdminFieldLabel, AdminTextField, adminFieldErrorClass, adminFieldHintClass, adminFieldLabelClass, adminFieldLabelSuffixClass, adminInputClass, adminInputReadOnlyClass, adminInputWrapperClass, } from './AdminTextField';
-export type { AdminTextFieldProps } from './AdminTextField';
+export type { UnderlineTabsProps, UnderlineTabItem, UnderlineTabsSize, UnderlineTabsLevel } from './UnderlineTabs';
+export { AdminFieldLabel, AdminTextField, adminFieldErrorClass, adminFieldHelpButtonClass, adminFieldHelpContentClass, adminFieldHelpIconClass, adminFieldHintClass, adminFieldLabelClass, adminFieldLabelNoAutoMarkClass, adminFieldLabelRowClass, adminFieldLabelSuffixClass, adminFieldRequiredClass, adminInputClass, adminInputReadOnlyClass, adminInputWrapperClass, } from './AdminTextField';
+export type { AdminTextFieldProps, AdminFieldLabelProps, AdminFieldRequiredProps, AdminFieldHelpProps, } from './AdminTextField';
+export { TimeField, parseTimeInput } from './TimeField';
+export type { TimeFieldProps } from './TimeField';
 export { RowActions } from './RowActions';
 export type { RowActionsProps, RowAction } from './RowActions';
 export { PickerRow } from './PickerRow';
 export type { PickerRowProps } from './PickerRow';
+export { EntityRow, EntityList, EntityListSkeleton } from './EntityRow';
+export type { EntityRowProps, EntityRowSize, EntityRowVariant, EntityRowTag, EntityRowTagTone, EntityRowLeading, EntityRowAction, EntityListProps, EntityListSkeletonProps, } from './EntityRow';
 export { PaginationSummary, pageRange } from './PaginationSummary';
-export type { PaginationSummaryProps, PaginationSummaryClassNames } from './PaginationSummary';
+export type { PaginationSummaryProps, PaginationSummaryClassNames, PaginationSummaryRange } from './PaginationSummary';
 export { ListPanel } from './ListPanel';
 export type { ListPanelProps, ListPanelClassNames } from './ListPanel';
 export { CashTenderForm } from './CashTenderForm';
@@ -78,11 +90,11 @@ export type { CheckTenderFormProps, CheckTenderValue, CheckTenderLabels } from '
 export { OtherTenderForm } from './OtherTenderForm';
 export type { OtherTenderFormProps, OtherTenderValue, OtherTenderLabels, OtherTenderMethodOption, } from './OtherTenderForm';
 export { SplitPaymentSummary } from './SplitPaymentSummary';
-export type { SplitPaymentSummaryProps, SplitPaymentSummaryLabels, TenderRow, TenderRowStatus, TenderRowType, } from './SplitPaymentSummary';
+export type { SplitPaymentSummaryProps, SplitPaymentSummaryLabels, SplitPaymentSummaryVariant, TenderRow, TenderRowStatus, TenderRowType, } from './SplitPaymentSummary';
 export { ModalShell, ModalShellHeader, ModalShellFooter } from './ModalShell';
 export type { ModalShellProps, ModalShellHeaderProps, ModalShellFooterProps } from './ModalShell';
 export { TileSelect } from './TileSelect';
-export type { TileSelectProps, TileSelectOption } from './TileSelect';
+export type { TileSelectProps, TileSelectOption, TileSelectVariant, TileSelectSize } from './TileSelect';
 export { PaymentTotalBanner } from './PaymentTotalBanner';
 export type { PaymentTotalBannerProps } from './PaymentTotalBanner';
 export { LoadingOverlay } from './LoadingOverlay';
@@ -95,11 +107,19 @@ export { PaymentSubAmountInput } from './PaymentSubAmountInput';
 export type { PaymentSubAmountInputProps } from './PaymentSubAmountInput';
 export { ConfirmDialog } from './ConfirmDialog';
 export type { ConfirmDialogProps, ConfirmDialogVariant } from './ConfirmDialog';
+export { InlineConfirm } from './InlineConfirm';
+export type { InlineConfirmProps, InlineConfirmVariant, InlineConfirmSize } from './InlineConfirm';
+export { ModalPanels, ModalPanelHeader, useModalPanel, useModalPanels } from './ModalPanels';
+export type { ModalPanelsProps, ModalPanelHeaderProps, ModalPanelState, ModalPanelsController, ModalPanelEntry, } from './ModalPanels';
+export { DiscardGuard, useDiscardGuard, useDiscardGuardActions, useReportUnsavedChanges } from './DiscardGuard';
+export type { DiscardGuardProps, DiscardGuardController, DiscardGuardActions } from './DiscardGuard';
 export { Summary } from './Summary';
 export type { SummaryProps, SummaryLineItem, SummaryItemDetail, SummaryServiceFee, SummaryTotalRow, SummaryPostTotalRow, SummaryPrimaryAction, SummaryLabels, } from './Summary';
+export { StepProgress } from './StepProgress';
+export type { StepProgressProps, StepProgressStep, StepProgressLabels } from './StepProgress';
 export { WizardShell } from './WizardShell';
-export type { WizardShellProps, WizardStep, WizardStepState, WizardShellPrimaryAction, WizardShellSecondaryAction, WizardShellTotalRow, WizardShellLabels, } from './WizardShell';
-export type { TenderError, DestinationLine, DestinationStatus } from './shared';
+export type { WizardShellProps, WizardStep, WizardStepState, WizardShellPrimaryAction, WizardShellSecondaryAction, WizardShellTotalRow, WizardShellTotalBadge, WizardShellLabels, } from './WizardShell';
+export type { TenderError, DestinationLine, DestinationStatus, RecordTone } from './shared';
 export { LineItemList } from './LineItemList';
 export type { LineItemListProps, LineItemView, ItemSelection, LineItemState, LineItemRestockView, ItemDisposition, AmountOnlyView, LineItemListLabels, } from './LineItemList';
 export { MetaCard } from './MetaCard';
@@ -116,7 +136,47 @@ export { TenderMethods } from './TenderMethods';
 export type { TenderMethodsProps, TenderView, TenderKind, TenderMethodsLabels } from './TenderMethods';
 export { SplitTenderPanel } from './SplitTenderPanel';
 export type { SplitTenderPanelProps, SplitPartView, SplitMethodOption, SplitTenderPanelLabels, } from './SplitTenderPanel';
+export { RefundMethodCards } from './RefundMethodCards';
+export type { RefundMethodCardsProps, RefundMethodCardsLabels, RefundMethodCardsError, RefundMethodView, RefundMethodKind, RefundMethodStatus, RefundMethodOption, RefundMethodAnotherMethod, RefundMethodPaidWith, } from './RefundMethodCards';
+export { RefundProgressList } from './RefundProgressList';
+export type { RefundProgressListProps, RefundProgressListLabels, RefundProgressPart, RefundProgressStatus, RefundProgressAction, } from './RefundProgressList';
 export { PinField } from './PinField';
 export type { PinFieldProps, PinFieldLabels } from './PinField';
 export { OutcomeView } from './OutcomeView';
-export type { OutcomeViewProps, OutcomeViewLabels, ReceiptChannel } from './OutcomeView';
+export type { OutcomeViewProps, OutcomeViewLabels, ReceiptChannel, OutcomeViewKind, OutcomePaidWithLine, OutcomeGroup, OutcomeReceiptAction, OutcomeEmailReceipt, OutcomeChangeDue, } from './OutcomeView';
+export { FilterSelect, FilterSelectGroup } from './FilterSelect';
+export type { FilterSelectProps, FilterSelectOption, FilterSelectGroupProps } from './FilterSelect';
+export { LoadMoreFooter } from './LoadMoreFooter';
+export type { LoadMoreFooterProps, LoadMoreStatus } from './LoadMoreFooter';
+export { CardList } from './CardList';
+export type { CardListProps, CardListItem } from './CardList';
+export { RecordHeader } from './RecordHeader';
+export type { RecordHeaderProps, RecordHeaderStat } from './RecordHeader';
+export { RecordLayout } from './RecordLayout';
+export type { RecordLayoutProps } from './RecordLayout';
+export { StatTiles } from './StatTiles';
+export type { StatTilesProps, StatTileItem } from './StatTiles';
+export { PillTabs, pillTabId, pillTabPanelId, pillTabPanelProps } from './PillTabs';
+export type { PillTabsProps, PillTabItem, PillTabsSize } from './PillTabs';
+export { AmountList } from './AmountList';
+export type { AmountListProps, AmountListRow } from './AmountList';
+export { ActivityTimeline } from './ActivityTimeline';
+export type { ActivityTimelineProps, ActivityTimelineEvent } from './ActivityTimeline';
+export { RelatedRecordList } from './RelatedRecordList';
+export type { RelatedRecordListProps, RelatedRecordRow } from './RelatedRecordList';
+export { RecordCard } from './RecordCard';
+export type { RecordCardProps, RecordCardVariant, RecordCardBody, RecordCardSurface } from './RecordCard';
+export { CardStack } from './CardStack';
+export type { CardStackProps, CardStackLayout } from './CardStack';
+export { KeyValueRows } from './KeyValueRows';
+export type { KeyValueRowsProps, KeyValueRow, KeyValueRowsDensity } from './KeyValueRows';
+export { LineItemRows } from './LineItemRows';
+export type { LineItemRowsProps, LineItemRow } from './LineItemRows';
+export { RecordTotals } from './RecordTotals';
+export type { RecordTotalsProps, RecordTotalsRow } from './RecordTotals';
+export { CellText, ChipStack } from './CellText';
+export type { CellTextProps, CellTextVariant, ChipStackProps } from './CellText';
+export { SessionExpiredCard } from './SessionExpiredCard';
+export type { SessionExpiredCardProps } from './SessionExpiredCard';
+export { Notice } from './Notice';
+export type { NoticeProps, NoticeTone, NoticeVariant } from './Notice';

package/dist/patterns/shared/hasContent.d.ts

@@ -0,0 +1,2 @@
+import { ReactNode } from 'react';
+export declare function hasContent(node: ReactNode): boolean;

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

@@ -1 +1,2 @@
 export type { TenderError, DestinationLine, DestinationStatus } from './types';
+export type { RecordTone } from './recordTone';

package/dist/patterns/shared/motion.d.ts

@@ -0,0 +1,6 @@
+export declare const POS_REDUCE_MOTION_ATTRIBUTE = "data-pos-reduce-motion";
+export declare const stillTransitionClass = "motion-reduce:transition-none [html[data-pos-reduce-motion=true]_&]:transition-none";
+export declare const stillAnimationClass = "motion-reduce:animate-none [html[data-pos-reduce-motion=true]_&]:animate-none";
+export declare const shimmerClass = "rounded-[0.375rem] bg-[linear-gradient(90deg,#F0F0F1_0,#F9F9FA_12.5rem,#F0F0F1_25rem)] bg-[length:50rem_100%] animate-record-shimmer motion-reduce:animate-none [html[data-pos-reduce-motion=true]_&]:animate-none";
+export declare function prefersReducedMotion(): boolean;
+export declare function useReducedMotion(): boolean;

package/dist/patterns/shared/recordTone.d.ts

@@ -0,0 +1,9 @@
+import { CSSProperties } from 'react';
+export type RecordTone = 'ok' | 'warn' | 'danger' | 'info' | 'violet' | 'neutral';
+export interface RecordTonePair {
+    fg: string;
+    bg: string;
+}
+export declare const RECORD_TONE: Record<RecordTone, RecordTonePair>;
+export type SignedAmountTone = 'positive' | 'negative' | 'neutral';
+export declare function amountToneStyle(tone: SignedAmountTone | undefined): CSSProperties | undefined;

package/dist/patterns/shared/rem.d.ts

@@ -0,0 +1,4 @@
+export declare const ROOT_FONT_PX = 16;
+export declare const rem: (px: number) => string;
+export declare function rootFontSizePx(): number;
+export declare const atLeastRem: (widthPx: number, rems: number) => boolean;

package/dist/patterns/shared/useContainerWidth.d.ts

@@ -0,0 +1,6 @@
+export declare const CONTAINER_MEDIUM = 768;
+export declare const CONTAINER_WIDE = 1120;
+export declare function useContainerWidth<T extends HTMLElement>(): {
+    ref: import('react').RefObject<T | null>;
+    width: number;
+};

package/dist/patterns/shared/useDecimalDraft.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Keeps the text a cashier typed into a money input separate from the number
+ * the host holds.
+ *
+ * A money input whose display is `String(value)` loses what the cashier is
+ * mid-way through typing: `'40.'` parses to `40` and is re-rendered as `'40'`,
+ * so the next `0` produces `'400'` and `'40.00'` ends up read as 4000. The hook
+ * keeps the typed string and shows it while it still parses to `value` (the
+ * echo of the cashier's own keystroke). When the host holds a number the draft
+ * does not represent (a reset, a prefill, a host that ignores the keystroke),
+ * the input shows `format(value)` instead, so the host stays in control.
+ */
+/**
+ * Whether `text` is one amount, possibly partial, in a currency with
+ * `fractionDigits` minor digits: digits, then at most one `.` or `,` followed
+ * by at most `fractionDigits` digits (`''`, `'40'`, `'40.'`, `'40,5'`, `'.5'`).
+ * Anything else would show one amount while emitting another, because
+ * `parseFloat` reads only a prefix and `,` is the decimal separator: `'40.5.9'`
+ * and `'4a'` would emit 40.5 and 4, and `'1,000'` would emit 1. Callers reject
+ * such a keystroke instead of storing it, so the input keeps what it showed.
+ */
+export declare const isDecimalDraft: (text: string, fractionDigits: number) => boolean;
+/** Parses a typed amount (`'40.5'`, `'40,5'`, `'40.'`); `null` when there is no number yet (`''`, `'.'`, `','`). */
+export declare const parseDecimalDraft: (draft: string) => number | null;
+export interface DecimalDraft {
+    /** The text to show in the input. */
+    draft: string;
+    /** Stores the text the cashier typed. */
+    setDraft: (next: string) => void;
+    /** Rewrites the draft in its canonical form (`'40.'` → `'40'`) without changing its value. */
+    normalize: () => void;
+}
+export declare const useDecimalDraft: (value: number | null | undefined, format: (value: number | null | undefined) => string) => DecimalDraft;

package/dist/patterns/shared/usePrefillEdits.d.ts

@@ -0,0 +1,7 @@
+export interface PrefillEdits<T> {
+    isUntouched: () => boolean;
+    markEdited: (emitted: T) => void;
+    markUntouched: () => void;
+}
+export declare const usePrefillEdits: <T>(source: T, isSame?: (a: T, b: T) => boolean) => PrefillEdits<T>;
+export declare const useReplaceWhileUntouched: (isUntouched: () => boolean, replace: (text: string) => void) => import('react').RefObject<HTMLInputElement | null>;

package/dist/providers/DensityProvider.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+import { Density } from './density';
+export interface DensityProviderProps {
+    density: Density;
+    children: ReactNode;
+}
+export declare function DensityProvider({ density, children }: DensityProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/providers/HeroUIProvider.d.ts

@@ -1,6 +1,25 @@
 import { ReactNode } from 'react';
 interface HeroUIProviderProps {
     children: ReactNode;
+    /**
+     * App-wide accessible name for the corner close button of every DS `Modal` and `Drawer`, e.g. `"Fermer"`.
+     * HeroUI hard-codes `"Close"`, so a localized app sets this once instead of on each overlay.
+     *
+     * A `closeLabel` on a `Modal` / `Drawer` wins over it. A nested provider without one inherits the
+     * outer provider's. With none anywhere, HeroUI's own button is rendered untouched.
+     */
+    closeLabel?: string;
+    /**
+     * BCP 47 locale for the React Aria strings HeroUI renders, e.g. `"fr-FR"`: the hidden "Dismiss"
+     * buttons of overlays, date and number formatting. Without it HeroUI uses `"en-US"`.
+     */
+    locale?: string;
+    /**
+     * How framer-motion animations (overlays, toasts, tabs) treat the OS "reduce motion" setting.
+     * Defaults to `"user"`: follow the OS. HeroUI's own default is `"never"`, which animates regardless.
+     * `"always"` drops them everywhere, e.g. for an app-level reduce-motion preference.
+     */
+    reducedMotion?: 'user' | 'always' | 'never';
 }
-export declare function HeroUIProvider({ children }: HeroUIProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function HeroUIProvider({ children, closeLabel, locale, reducedMotion }: HeroUIProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/providers/ToastProvider.d.ts

@@ -0,0 +1,21 @@
+import { ToastProvider as BaseToastProvider } from '@heroui/react';
+import { ComponentProps, JSX } from 'react';
+export type ToastProviderProps = ComponentProps<typeof BaseToastProvider>;
+/**
+ * Drop-in for HeroUI's `ToastProvider` (same props, same `addToast` queue).
+ *
+ * - Titles wrap instead of truncating.
+ * - From `sm` up the toast takes the width its text needs, between 356px and
+ *   `min(32rem, 100vw - 11rem)`, so it keeps up with a larger root font size.
+ * - The close button sits inside the toast, beside the title, always visible,
+ *   as a 44px target.
+ * - A `toastProps.classNames` you pass is merged after these defaults, slot by
+ *   slot, so it can still restyle any of them.
+ * - Animation is off when the OS or the POS asks for reduced motion, unless
+ *   `disableAnimation` is passed.
+ *
+ * HeroUI merges an `addToast({ classNames })` over the provider's `classNames`
+ * as a whole object, so a per-toast `classNames` drops these defaults for that
+ * toast: its title truncates again and its close button floats on the corner.
+ */
+export declare function ToastProvider({ toastProps, disableAnimation, ...props }: ToastProviderProps): JSX.Element;

package/dist/providers/close-label-context.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The app-wide default accessible name of an overlay's corner close button.
+ *
+ * HeroUI renders that button with the literal `aria-label="Close"`, so a French
+ * or Spanish screen announces English. `HeroUIProvider` carries a translated
+ * label here and the DS `Modal` / `Drawer` read it.
+ *
+ * A leaf file on purpose: `providers/` and `components/` never import each
+ * other. Both import this context, and neither imports the other's barrel.
+ * Split from `HeroUIProvider.tsx` so that file exports a component only (fast
+ * refresh), as `density.ts` does for the density context.
+ *
+ * `undefined` means "no app-wide label": the overlay keeps HeroUI's own button
+ * and its `"Close"` name untouched.
+ */
+export declare const CloseLabelContext: import('react').Context<string | undefined>;
+/** The label of the nearest `HeroUIProvider` that set `closeLabel`; `undefined` outside one. */
+export declare function useCloseLabel(): string | undefined;

package/dist/providers/density.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The density context and the hooks that read it. Split from
+ * `DensityProvider.tsx` so that file exports a component only (fast refresh).
+ */
+export type Density = 'default' | 'touch';
+/** The HeroUI control sizes a density maps onto. */
+export type ControlSize = 'sm' | 'md' | 'lg';
+export declare const DensityContext: import('react').Context<Density>;
+/** The density of the nearest `DensityProvider`; `'default'` outside one. */
+export declare function useDensity(): Density;
+/**
+ * The HeroUI size for a control whose everyday size is `base`.
+ *
+ * A component passes the size it has always had and gets `lg` back only under
+ * `touch`, so a page that never mounts the provider is untouched.
+ */
+export declare function useControlSize<TBase extends ControlSize>(base: TBase): TBase | 'lg';

package/dist/providers/index.d.ts

@@ -1 +1,7 @@
 export { HeroUIProvider } from './HeroUIProvider';
+export { ToastProvider } from './ToastProvider';
+export type { ToastProviderProps } from './ToastProvider';
+export { DensityProvider } from './DensityProvider';
+export type { DensityProviderProps } from './DensityProvider';
+export { useDensity, useControlSize } from './density';
+export type { Density, ControlSize } from './density';