@veevarts/design-system 1.17.0-alpha.2 → 1.17.0-alpha.4

package/dist/patterns/ActingAsToggle/ActingAsToggle.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { ActingAsToggleProps } from './types';
+export declare const ActingAsToggle: React.FC<ActingAsToggleProps>;

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

@@ -0,0 +1,2 @@
+export { ActingAsToggle } from './ActingAsToggle';
+export type { ActingAsToggleProps, ActingRole, ActingAsToggleLabels } from './types';

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

@@ -0,0 +1,13 @@
+export type ActingRole = 'manager' | 'cashier';
+export interface ActingAsToggleLabels {
+    legend?: string;
+    manager?: string;
+    cashier?: string;
+}
+export interface ActingAsToggleProps {
+    role: ActingRole;
+    onChange: (role: ActingRole) => void;
+    labels?: ActingAsToggleLabels;
+    className?: string;
+    'data-testid'?: string;
+}

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

@@ -16,8 +16,18 @@
  * measurements, pinned rather than rounded to the nearest scale step: these
  * surfaces are pixel-ports of signed-off designs.
  */
-/** Uppercase column header. `bg-transparent` overrides HeroUI's own header fill. */
-export declare const adminThClass = "text-left text-[11px] font-semibold uppercase tracking-[.04em] text-acct-muted px-4 pt-4 pb-3 whitespace-nowrap bg-transparent";
+/**
+ * Uppercase column header. `bg-transparent` overrides HeroUI's own header fill.
+ *
+ * The tone is `--sub`, not `--muted`. The two admin screens this class was
+ * distilled from had each picked one — the ledger `--sub`, the governance tables
+ * `--muted` — so unifying them was going to change one of the two either way.
+ * `--muted` (gray-400) measures 2.54:1 on the card, and these labels are 11px,
+ * which WCAG AA counts as small text needing 4.5:1; `--sub` (gray-500) measures
+ * 4.83:1. Same reasoning as `--warn` in the token module: pick the readable end
+ * of our own scale rather than keep a value that cannot be read.
+ */
+export declare const adminThClass = "text-left text-[11px] font-semibold uppercase tracking-[.04em] text-acct-sub px-4 pt-4 pb-3 whitespace-nowrap bg-transparent";
 /** Body cell. */
 export declare const adminTdClass = "px-4 text-[13.5px] text-acct-ink2 align-middle";
 /**

package/dist/patterns/CustomAmountField/CustomAmountField.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { CustomAmountFieldProps } from './types';
+export declare const CustomAmountField: React.FC<CustomAmountFieldProps>;

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

@@ -0,0 +1,2 @@
+export { CustomAmountField } from './CustomAmountField';
+export type { CustomAmountFieldProps, CustomAmountFieldLabels, CustomAmountFieldValue } from './types';

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

@@ -0,0 +1,21 @@
+import { Money } from '../../utils/money';
+export type { Money } from '../../utils/money';
+export interface CustomAmountFieldLabels {
+    amountLabel?: string;
+    descriptionLabel?: string;
+    maxHint?: string;
+}
+export interface CustomAmountFieldValue {
+    amount: number | null;
+    description: string;
+}
+export interface CustomAmountFieldProps {
+    amount: number | null;
+    description: string;
+    max: Money;
+    error?: string;
+    onChange: (value: CustomAmountFieldValue) => void;
+    labels?: CustomAmountFieldLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/MoneyBackMethods/MoneyBackMethods.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { MoneyBackMethodsProps } from './types';
+export declare const MoneyBackMethods: React.FC<MoneyBackMethodsProps>;
+export default MoneyBackMethods;

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

@@ -0,0 +1,2 @@
+export { MoneyBackMethods } from './MoneyBackMethods';
+export type { MoneyBackMethodsProps, MoneyBackMethodsLabels, TenderView, TenderKind } from './types';

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

@@ -0,0 +1,44 @@
+import { Money } from '../../utils/money';
+import { MoneyBackError } from '..';
+export type { Money } from '../../utils/money';
+export type TenderKind = 'card' | 'cash' | 'check' | 'other';
+export interface TenderView {
+    /** Stable identifier returned via `onSelect`. */
+    tenderId: string;
+    /**
+     * One-line description shown on the tile. Examples:
+     *   - `'Visa •••4242'`
+     *   - `'Cash'`
+     */
+    label: string;
+    /** Canonical category used to pick the tile icon. */
+    kind: TenderKind;
+    /** Amount still refundable to this tender. */
+    maxRefundable: Money;
+}
+export interface MoneyBackMethodsLabels {
+    /** Optional heading rendered above the tile grid. */
+    title?: string;
+    split?: string;
+    declinedTitle?: string;
+    declinedBody?: string;
+    networkTitle?: string;
+    networkBody?: string;
+    retry?: string;
+    chooseDifferent?: string;
+}
+export interface MoneyBackMethodsProps {
+    /** Refundable tenders, one tile each. */
+    tenders: TenderView[];
+    /** Currently selected tender `tenderId`. `null` = no selection. */
+    selectedTenderId: string | null;
+    /** Fires when a tender tile is selected. */
+    onSelect: (tenderId: string) => void;
+    /** Fires when the "split across multiple methods" tile is selected. */
+    onSplit: () => void;
+    /** Processor-declined / network-error banner, shown above the tiles. */
+    error?: MoneyBackError;
+    labels?: MoneyBackMethodsLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/NotesField/NotesField.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { NotesFieldProps } from './types';
+export declare const NotesField: React.FC<NotesFieldProps>;

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

@@ -0,0 +1,2 @@
+export { NotesField } from './NotesField';
+export type { NotesFieldProps, NotesFieldLabels } from './types';

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

@@ -0,0 +1,12 @@
+export interface NotesFieldLabels {
+    toggle?: string;
+    optionalTag?: string;
+}
+export interface NotesFieldProps {
+    value: string;
+    onChange: (value: string) => void;
+    maxLength?: number;
+    labels?: NotesFieldLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/PaymentSubAmountInput/PaymentSubAmountInput.d.ts

@@ -49,6 +49,15 @@ export interface PaymentSubAmountInputProps {
      * guard is value-based. Omit for no cap.
      */
     maxAmount?: number;
+    /**
+     * Visually hides the section heading and the input's own label
+     * (via `sr-only`) for compact compositions that already supply
+     * their own surrounding label context (e.g. `CustomAmountField`,
+     * `RefundItemList`'s partial-amount box). Both stay in the DOM so
+     * the accessible name is preserved for assistive tech. Default
+     * `false` — zero behavior change for existing consumers.
+     */
+    hideHeading?: boolean;
     'data-testid'?: string;
     className?: string;
 }

package/dist/patterns/ReasonSelect/ReasonSelect.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { ReasonSelectProps } from './types';
+export declare const ReasonSelect: React.FC<ReasonSelectProps>;

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

@@ -0,0 +1,2 @@
+export { ReasonSelect } from './ReasonSelect';
+export type { ReasonSelectProps, ReasonOption, ReasonSelectLabels } from './types';

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

@@ -0,0 +1,17 @@
+export interface ReasonOption {
+    id: string;
+    label: string;
+}
+export interface ReasonSelectLabels {
+    label?: string;
+    placeholder?: string;
+}
+export interface ReasonSelectProps {
+    options: ReasonOption[];
+    value: string | null;
+    onChange: (id: string) => void;
+    error?: string;
+    labels?: ReasonSelectLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/RefundCompleteView/RefundCompleteView.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { RefundCompleteViewProps } from './types';
+export declare const RefundCompleteView: React.FC<RefundCompleteViewProps>;

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

@@ -0,0 +1,2 @@
+export { RefundCompleteView } from './RefundCompleteView';
+export type { RefundCompleteViewProps, RefundCompleteViewLabels } from './types';

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

@@ -0,0 +1,22 @@
+import { RefundDestinationLine } from '..';
+export type { RefundDestinationLine, RefundDestinationStatus } from '..';
+export interface RefundCompleteViewLabels {
+    processing?: string;
+    title?: string;
+    destinationsTitle?: string;
+    sendReceipt?: string;
+    email?: string;
+    print?: string;
+    done?: string;
+    pending?: string;
+    succeeded?: string;
+}
+export interface RefundCompleteViewProps {
+    state: 'processing' | 'complete';
+    destinations: RefundDestinationLine[];
+    onSendReceipt?: (channel: 'email' | 'print') => void;
+    onDone: () => void;
+    labels?: RefundCompleteViewLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/RefundItemList/RefundItemList.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { RefundItemListProps } from './types';
+export declare const RefundItemList: React.FC<RefundItemListProps>;

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

@@ -0,0 +1,2 @@
+export { RefundItemList } from './RefundItemList';
+export type { RefundItemListProps, RefundItemView, RefundItemState, RefundItemRestockView, ItemSelection, RefundItemListLabels, } from './types';

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

@@ -0,0 +1,40 @@
+import { Money } from '../../utils/money';
+export type { Money } from '../../utils/money';
+export type RefundItemState = 'selectable' | 'already_refunded' | 'non_refundable';
+export interface RefundItemRestockView {
+    available: boolean;
+    unavailableHint?: string;
+    on: boolean;
+}
+export interface RefundItemView {
+    id: string;
+    name: string;
+    quantity: number;
+    paidAmount: Money;
+    state: RefundItemState;
+    warning?: string;
+    restock: RefundItemRestockView;
+}
+export interface ItemSelection {
+    selected: boolean;
+    mode: 'full' | 'partial';
+    partialAmount?: number;
+}
+export interface RefundItemListLabels {
+    refunded?: string;
+    ineligible?: string;
+    partialLink?: string;
+    partialOf?: string;
+    partialCancel?: string;
+    restockTitle?: string;
+    restockHint?: string;
+}
+export interface RefundItemListProps {
+    items: RefundItemView[];
+    selections: Record<string, ItemSelection>;
+    onSelectionChange: (itemId: string, selection: ItemSelection) => void;
+    onRestockToggle: (itemId: string, on: boolean) => void;
+    labels?: RefundItemListLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/RefundTotalBar/RefundTotalBar.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { RefundTotalBarProps } from './types';
+export declare const RefundTotalBar: React.FC<RefundTotalBarProps>;

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

@@ -0,0 +1,2 @@
+export { RefundTotalBar } from './RefundTotalBar';
+export type { RefundTotalBarProps, RefundTotalBarLabels } from './types';

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

@@ -0,0 +1,13 @@
+import { Money } from '../../utils/money';
+export type { Money } from '../../utils/money';
+export interface RefundTotalBarLabels {
+    title?: string;
+    partialBadge?: string;
+}
+export interface RefundTotalBarProps {
+    total: Money;
+    isPartial: boolean;
+    labels?: RefundTotalBarLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/SplitRefundPanel/SplitRefundPanel.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { SplitRefundPanelProps } from './types';
+export declare const SplitRefundPanel: React.FC<SplitRefundPanelProps>;
+export default SplitRefundPanel;

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

@@ -0,0 +1,2 @@
+export { SplitRefundPanel } from './SplitRefundPanel';
+export type { SplitRefundPanelProps, SplitRefundPanelLabels, SplitPartView } from './types';

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

@@ -0,0 +1,51 @@
+import { Money } from '../../utils/money';
+import { MoneyBackError } from '..';
+export type { Money } from '../../utils/money';
+export interface SplitPartView {
+    /** Stable identifier for the tender this part refunds to. */
+    tenderId: string;
+    /** One-line description, e.g. `'Visa •••4242'` or `'Cash'`. */
+    label: string;
+    /** Amount already refunded for this part. `null` = not executed yet. */
+    refunded: Money | null;
+}
+export interface SplitRefundPanelLabels {
+    title?: string;
+    refundedSoFar?: string;
+    remaining?: string;
+    amountForPart?: string;
+    submit?: string;
+    back?: string;
+    partDeclinedBody?: string;
+    partNetworkBody?: string;
+    retry?: string;
+    chooseDifferent?: string;
+}
+export interface SplitRefundPanelProps {
+    /** Every part of the split, executed and pending, in entry order. */
+    parts: SplitPartView[];
+    /** Sum already refunded across executed parts. */
+    refundedSoFar: Money;
+    /** Amount left to refund across the remaining parts. */
+    remaining: Money;
+    /** The part currently being entered. */
+    current: {
+        /** Tender selected for the part being entered. `null` = not chosen yet. */
+        tenderId: string | null;
+        /** Amount typed so far, in major units. */
+        amount: number;
+        /** Fires on every keystroke with the parsed major-unit amount. */
+        onAmountChange: (next: number) => void;
+    };
+    /** Fires when the cashier submits the current part. */
+    onRefundPart: () => void;
+    /** Processor-declined / network-error banner for the current part. */
+    partError?: MoneyBackError;
+    /** Fires when the cashier navigates back out of the split flow. */
+    onBack: () => void;
+    /** Disables the submit action and shows its loading state. */
+    busy?: boolean;
+    labels?: SplitRefundPanelLabels;
+    className?: string;
+    'data-testid'?: string;
+}

package/dist/patterns/SupervisorPinField/SupervisorPinField.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+import { SupervisorPinFieldProps } from './types';
+export declare const SupervisorPinField: React.FC<SupervisorPinFieldProps>;

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

@@ -0,0 +1,2 @@
+export { SupervisorPinField } from './SupervisorPinField';
+export type { SupervisorPinFieldProps, SupervisorPinFieldLabels } from './types';

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

@@ -0,0 +1,12 @@
+export interface SupervisorPinFieldLabels {
+    label?: string;
+    placeholder?: string;
+}
+export interface SupervisorPinFieldProps {
+    pin: string;
+    onChange: (pin: string) => void;
+    error?: string;
+    labels?: SupervisorPinFieldLabels;
+    className?: string;
+    'data-testid'?: string;
+}

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

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { WizardShellProps } from './types';
+export declare const WizardShell: React.FC<WizardShellProps>;
+export default WizardShell;

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

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

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

@@ -0,0 +1,29 @@
+import { ReactNode } from 'react';
+export type WizardStepState = 'upcoming' | 'active' | 'done' | 'skipped';
+export interface WizardStep {
+    id: string;
+    label: string;
+    state: WizardStepState;
+}
+export interface WizardShellPrimaryAction {
+    label: string;
+    onClick: () => void;
+    disabled?: boolean;
+    loading?: boolean;
+}
+export interface WizardShellLabels {
+    back?: string;
+    close?: string;
+}
+export interface WizardShellProps {
+    onClose?: () => void;
+    steps: WizardStep[];
+    activeStepId: string;
+    onBack?: () => void;
+    primaryAction: WizardShellPrimaryAction;
+    footerSummary?: ReactNode;
+    labels?: WizardShellLabels;
+    className?: string;
+    'data-testid'?: string;
+    children: ReactNode;
+}

package/dist/patterns/index.d.ts

@@ -68,7 +68,7 @@ export type { PaginationSummaryProps, PaginationSummaryClassNames } from './Pagi
 export { ListPanel } from './ListPanel';
 export type { ListPanelProps, ListPanelClassNames } from './ListPanel';
 export { CashTenderForm } from './CashTenderForm';
-export type { CashTenderFormProps, CashTenderValue, CashTenderLabels, } from './CashTenderForm';
+export type { CashTenderFormProps, CashTenderValue, CashTenderLabels } from './CashTenderForm';
 export { CheckTenderForm } from './CheckTenderForm';
 export type { CheckTenderFormProps, CheckTenderValue, CheckTenderLabels } from './CheckTenderForm';
 export { OtherTenderForm } from './OtherTenderForm';
@@ -76,7 +76,7 @@ export type { OtherTenderFormProps, OtherTenderValue, OtherTenderLabels, OtherTe
 export { SplitPaymentSummary } from './SplitPaymentSummary';
 export type { SplitPaymentSummaryProps, SplitPaymentSummaryLabels, TenderRow, TenderRowStatus, TenderRowType, } from './SplitPaymentSummary';
 export { ModalShell, ModalShellHeader, ModalShellFooter } from './ModalShell';
-export type { ModalShellProps, ModalShellHeaderProps, ModalShellFooterProps, } from './ModalShell';
+export type { ModalShellProps, ModalShellHeaderProps, ModalShellFooterProps } from './ModalShell';
 export { TileSelect } from './TileSelect';
 export type { TileSelectProps, TileSelectOption } from './TileSelect';
 export { PaymentTotalBanner } from './PaymentTotalBanner';
@@ -93,3 +93,26 @@ export { ConfirmDialog } from './ConfirmDialog';
 export type { ConfirmDialogProps, ConfirmDialogVariant } from './ConfirmDialog';
 export { Summary } from './Summary';
 export type { SummaryProps, SummaryLineItem, SummaryItemDetail, SummaryServiceFee, SummaryTotalRow, SummaryPostTotalRow, SummaryPrimaryAction, SummaryLabels, } from './Summary';
+export { WizardShell } from './WizardShell';
+export type { WizardShellProps, WizardStep, WizardStepState, WizardShellPrimaryAction, WizardShellLabels, } from './WizardShell';
+export type { MoneyBackError, RefundDestinationLine, RefundDestinationStatus } from './refund-shared';
+export { RefundItemList } from './RefundItemList';
+export type { RefundItemListProps, RefundItemView, ItemSelection, RefundItemState, RefundItemRestockView, RefundItemListLabels, } from './RefundItemList';
+export { CustomAmountField } from './CustomAmountField';
+export type { CustomAmountFieldProps, CustomAmountFieldLabels, CustomAmountFieldValue } from './CustomAmountField';
+export { RefundTotalBar } from './RefundTotalBar';
+export type { RefundTotalBarProps, RefundTotalBarLabels } from './RefundTotalBar';
+export { ReasonSelect } from './ReasonSelect';
+export type { ReasonSelectProps, ReasonOption, ReasonSelectLabels } from './ReasonSelect';
+export { NotesField } from './NotesField';
+export type { NotesFieldProps, NotesFieldLabels } from './NotesField';
+export { ActingAsToggle } from './ActingAsToggle';
+export type { ActingAsToggleProps, ActingRole, ActingAsToggleLabels } from './ActingAsToggle';
+export { MoneyBackMethods } from './MoneyBackMethods';
+export type { MoneyBackMethodsProps, TenderView, TenderKind, MoneyBackMethodsLabels } from './MoneyBackMethods';
+export { SplitRefundPanel } from './SplitRefundPanel';
+export type { SplitRefundPanelProps, SplitPartView, SplitRefundPanelLabels } from './SplitRefundPanel';
+export { SupervisorPinField } from './SupervisorPinField';
+export type { SupervisorPinFieldProps, SupervisorPinFieldLabels } from './SupervisorPinField';
+export { RefundCompleteView } from './RefundCompleteView';
+export type { RefundCompleteViewProps, RefundCompleteViewLabels } from './RefundCompleteView';

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

@@ -0,0 +1 @@
+export type { MoneyBackError, RefundDestinationLine, RefundDestinationStatus } from './types';

package/dist/patterns/refund-shared/types.d.ts

@@ -0,0 +1,12 @@
+import { Money } from '../../utils/money';
+export interface MoneyBackError {
+    kind: 'processor_declined' | 'network';
+    onRetry: () => void;
+    onChooseDifferent: () => void;
+}
+export type RefundDestinationStatus = 'succeeded' | 'pending';
+export interface RefundDestinationLine {
+    label: string;
+    amount: Money;
+    status: RefundDestinationStatus;
+}

package/package.json

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