@veevarts/design-system 2.0.0-beta.7 → 2.0.0-csm.1

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

@@ -10,13 +10,13 @@ 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, } 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 +31,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 +43,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';
@@ -56,19 +58,21 @@ export type { TableSkeletonProps, TableSkeletonClassNames } from './TableSkeleto
 export { AdminTable, adminRowClass, adminTableClass, adminTableFooterClass, adminTdClass, adminThClass, } from './AdminTable';
 export type { AdminTableProps, AdminTableColumn, AdminTableClassNames } from './AdminTable';
 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 type { UnderlineTabsProps, UnderlineTabItem, UnderlineTabsSize, UnderlineTabsLevel } from './UnderlineTabs';
 export { AdminFieldLabel, AdminTextField, adminFieldErrorClass, adminFieldHintClass, adminFieldLabelClass, adminFieldLabelSuffixClass, adminInputClass, adminInputReadOnlyClass, adminInputWrapperClass, } from './AdminTextField';
 export type { AdminTextFieldProps } from './AdminTextField';
 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 +82,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 +99,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 +128,65 @@ 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 { AssistantMessage } from './AssistantMessage';
+export type { AssistantMessageAuthor, AssistantMessageBaseProps, AssistantMessageClassNames, AssistantMessageProps, AssistantMessageStatus, AssistantMessageStatusLabel, AssistantMessageStatusProps, } from './AssistantMessage';
+export { AssistantActivity, formatAssistantDuration } from './AssistantActivity';
+export type { AssistantActivityItem, AssistantActivityProps, AssistantActivityState } from './AssistantActivity';
+export { AssistantNotice } from './AssistantNotice';
+export type { AssistantNoticeClassNames, AssistantNoticeKind, AssistantNoticeProps } from './AssistantNotice';
+export { AssistantComposer } from './AssistantComposer';
+export type { AssistantComposerProps, AssistantComposerSuggestion } from './AssistantComposer';
+export { ScrollToLatest } from './ScrollToLatest';
+export type { ScrollToLatestClassNames, ScrollToLatestProps } from './ScrollToLatest';
+export { AssistantMarkdown, defaultAssistantLinkPolicy } from './AssistantMarkdown';
+export type { AssistantMarkdownLinkPolicy, AssistantMarkdownProps } from './AssistantMarkdown';
+export { CitationMarker } from './CitationMarker';
+export type { CitationMarkerProps } from './CitationMarker';
+export { SourcePill } from './SourcePill';
+export type { SourcePillProps } from './SourcePill';
+export { SourceList } from './SourceList';
+export type { SourceListHandle, SourceListItem, SourceListProps } from './SourceList';
+export { ArtifactCard } from './ArtifactCard';
+export type { ArtifactCardProps, ArtifactCardStatus } from './ArtifactCard';

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,19 @@
 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;
 }
-export declare function HeroUIProvider({ children }: HeroUIProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function HeroUIProvider({ children, closeLabel, locale }: HeroUIProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};

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,5 @@
 export { HeroUIProvider } from './HeroUIProvider';
+export { DensityProvider } from './DensityProvider';
+export type { DensityProviderProps } from './DensityProvider';
+export { useDensity, useControlSize } from './density';
+export type { Density, ControlSize } from './density';

package/dist/tailwind/index.cjs

@@ -23,6 +23,9 @@ __export(index_exports, {
   adminSurfaceCss: () => adminSurfaceCss,
   adminSurfaceTailwindColors: () => adminSurfaceTailwindColors,
   adminSurfaceTokens: () => adminSurfaceTokens,
+  assistantSurfacePlugin: () => assistantSurfacePlugin,
+  assistantSurfaceTailwindColors: () => assistantSurfaceTailwindColors,
+  assistantSurfaceTokens: () => assistantSurfaceTokens,
   colors: () => colors,
   createHeroUIConfig: () => createHeroUIConfig,
   deepMerge: () => deepMerge,
@@ -258,12 +261,12 @@ function adminSurfaceCss({
   scope = ".acct",
   fontFamily = "'NeueMontreal', system-ui, sans-serif"
 } = {}) {
-  const declarations = Object.entries(adminSurfaceTokens).map(([name, value]) => `  ${name}: ${value};`).join("\n");
+  const declarations2 = Object.entries(adminSurfaceTokens).map(([name, value]) => `  ${name}: ${value};`).join("\n");
   const typography2 = fontFamily ? `
   font-family: ${fontFamily};
   color: var(--ink);` : "";
   return `${scope} {
-${declarations}${typography2}
+${declarations2}${typography2}
 }
 `;
 }
@@ -274,6 +277,17 @@ var posSurfaceTokens = {
   line: "#E7E7E9",
   /** `--line2`: the lighter hairline under list rows and above the role bar. */
   "line-2": "#F1F1F3",
+  hair: "#F0F0F1",
+  page: "#FBFBFB",
+  field: "#E5E5E5",
+  /** A hairline under the pointer (`default-300`). */
+  "line-strong": "#D4D4D8",
+  /** `--ink`: body text (`default-900`). */
+  ink: "#18181B",
+  /** `--muted`: secondary text and eyebrows, 4.83:1 on white (`default-500`). */
+  muted: "#71717A",
+  /** Placeholder text (`default-400`). Never for content: 2.56:1 on white. */
+  faint: "#A1A1AA",
   /** `--okb` / `--okf` */
   "ok-fill": "#EAF3DE",
   ok: "#3B6D11",
@@ -288,11 +302,79 @@ var posSurfaceTokens = {
   /** `--ib` / `--if` */
   "info-fill": "#EAF1FC",
   info: "#1D4FA8",
+  "violet-fill": "#F1ECFB",
+  violet: "#6D28D9",
+  "neutral-fill": "#F4F4F5",
+  neutral: "#52525B",
   /** `.btn-dstr` — the fill behind an irreversible confirmation. */
   destructive: "#A32D2D"
 };
 var posSurfaceTailwindColors = { ...posSurfaceTokens };
 
+// src/tokens/assistant-surface.ts
+var info = colors.palettes.info;
+var HEROUI_CONTENT = {
+  light: { content1: "#ffffff", content2: "#f4f4f5" },
+  dark: { content1: "#18181b", content2: "#27272a" }
+};
+var ASSISTANT_SURFACE_TOKEN_NAMES = [
+  /** Text and icon tone that marks something as the assistant's. */
+  "accent",
+  /** Tint behind small assistant marks (an avatar disc, an info notice). */
+  "fill",
+  /** Hairline around assistant regions. */
+  "border",
+  /** Fill of the person's own turn. */
+  "user-bubble",
+  /** Fill of the assistant's turn, where an app draws it as a bubble. */
+  "assistant-bubble",
+  /** Focus ring inside assistant surfaces. */
+  "focus"
+];
+var assistantSurfaceTokens = {
+  light: {
+    accent: info[600],
+    fill: info[100],
+    border: info[200],
+    "user-bubble": HEROUI_CONTENT.light.content2,
+    "assistant-bubble": HEROUI_CONTENT.light.content1,
+    focus: info[500]
+  },
+  dark: {
+    accent: info[300],
+    fill: info[900],
+    border: info[800],
+    "user-bubble": HEROUI_CONTENT.dark.content2,
+    "assistant-bubble": HEROUI_CONTENT.dark.content1,
+    focus: info[400]
+  }
+};
+function hexToChannels(hex) {
+  if (!/^#[0-9a-f]{6}$/i.test(hex)) throw new Error(`bad hex: ${hex}`);
+  return [1, 3, 5].map((start) => parseInt(hex.slice(start, start + 2), 16)).join(" ");
+}
+var assistantSurfaceVar = (name) => `--ai-${name}`;
+var declarations = (theme) => Object.fromEntries(
+  ASSISTANT_SURFACE_TOKEN_NAMES.map((name) => [
+    assistantSurfaceVar(name),
+    hexToChannels(assistantSurfaceTokens[theme][name])
+  ])
+);
+var ASSISTANT_SURFACE_SELECTORS = {
+  light: ':root, .light, [data-theme="light"]',
+  dark: ".dark"
+};
+var assistantSurfaceBase = {
+  [ASSISTANT_SURFACE_SELECTORS.light]: declarations("light"),
+  [ASSISTANT_SURFACE_SELECTORS.dark]: declarations("dark")
+};
+var assistantSurfaceTailwindColors = Object.fromEntries(
+  ASSISTANT_SURFACE_TOKEN_NAMES.map((name) => [
+    name,
+    `rgb(var(${assistantSurfaceVar(name)}, ${hexToChannels(assistantSurfaceTokens.light[name])}) / <alpha-value>)`
+  ])
+);
+
 // src/tailwind/index.ts
 var tailwindTheme = {
   colors: {
@@ -308,13 +390,26 @@ var tailwindTheme = {
     // `danger`/`info`/`warn` do not shadow the semantic palettes, and fed
     // from the token object so utility and token cannot disagree.
     // See src/tokens/pos-surface.ts.
-    pos: posSurfaceTailwindColors
+    pos: posSurfaceTailwindColors,
+    // Assistant palette. Unlike `acct`/`pos` these resolve to CSS custom
+    // properties, because they have a dark value: the preset's plugin
+    // below writes the properties. See src/tokens/assistant-surface.ts.
+    ai: assistantSurfaceTailwindColors
   },
   fontFamily: typography.fontFamily,
   spacing,
   fontSize: typography.fontSize,
   fontWeight: typography.fontWeight,
-  lineHeight: typography.lineHeight
+  lineHeight: typography.lineHeight,
+  keyframes: {
+    "record-shimmer": {
+      "0%": { backgroundPosition: "-25rem 0" },
+      "100%": { backgroundPosition: "25rem 0" }
+    }
+  },
+  animation: {
+    "record-shimmer": "record-shimmer 1.3s linear infinite"
+  }
 };
 function deepMerge(target, source) {
   if (!source || typeof source !== "object") {
@@ -378,11 +473,15 @@ var veevartContent = [
   "./node_modules/@heroui/theme/dist/**/*.{js,ts,jsx,tsx}",
   "./node_modules/@veevarts/design-system/dist/**/*.{js,mjs,jsx,tsx}"
 ];
+function assistantSurfacePlugin({ addBase }) {
+  addBase(assistantSurfaceBase);
+}
 var veevartPreset = {
   theme: {
     extend: tailwindTheme
   },
-  darkMode: "class"
+  darkMode: "class",
+  plugins: [assistantSurfacePlugin]
 };
 var tokens = {
   colors,
@@ -395,6 +494,9 @@ var tokens = {
   adminSurfaceCss,
   adminSurfaceTailwindColors,
   adminSurfaceTokens,
+  assistantSurfacePlugin,
+  assistantSurfaceTailwindColors,
+  assistantSurfaceTokens,
   colors,
   createHeroUIConfig,
   deepMerge,