@tallyui/components 2.0.0 → 3.0.0-next.0

package/dist/index.d.ts

@@ -8,8 +8,8 @@ import { VariantProps } from 'class-variance-authority';
 import { SvgProps } from 'react-native-svg';
 import { Separator as Separator$1, Label as Label$1, Tabs as Tabs$1, Dialog as Dialog$1, AlertDialog as AlertDialog$1, Select as Select$1, Combobox as Combobox$1, DropdownMenu as DropdownMenu$1, ContextMenu as ContextMenu$1, Popover as Popover$1, Tooltip as Tooltip$1, HoverCard as HoverCard$1, Accordion as Accordion$1, Collapsible as Collapsible$1, Checkbox as Checkbox$1, Switch as Switch$1, RadioGroup as RadioGroup$1, Toggle as Toggle$1, ToggleGroup as ToggleGroup$1, Progress as Progress$1, Slider as Slider$1, Image } from '@tallyui/primitives';
 export { TextClassContext } from '@tallyui/primitives';
-import { Money, ProductTraits, StoreSettingsChoices, StoreSettingsChoice } from '@tallyui/core';
-import { useRegisterSession, MovementType, useSale, AppliedDiscount, Discount, CatalogueEntry, Order, OutboxState, PosOrder } from '@tallyui/pos';
+import { Money, CustomerTraits, Customer, CustomerInput, ProductTraits, SyncNotice, StoreSettingsChoices, StoreSettingsChoice } from '@tallyui/core';
+import { useRegisterSession, MovementType, useSale, AppliedDiscount, Discount, CatalogueEntry, SentOrder, OutboxState, PosOrder } from '@tallyui/pos';
 
 declare const textVariants: (props?: ({
     variant?: "link" | "default" | null | undefined;
@@ -481,10 +481,9 @@ interface ProductGridProps extends Omit<VStackProps, 'children'> {
     className?: string;
 }
 /**
- * A scrollable product grid with optional search and filter slots.
+ * A virtualized product grid with optional search and filter slots.
  *
- * Uses ScrollView + flexWrap for cross-platform grid layout rather than
- * FlatList numColumns, which keeps things predictable in both native and web.
+ * Uses FlatList numColumns to render rows near the viewport on native and web.
  *
  * ```tsx
  * <ProductGrid
@@ -663,19 +662,21 @@ interface QuantityStepperProps extends Omit<ViewProps, 'children'> {
 }
 declare function QuantityStepper({ defaultQuantity, quantity: controlledQuantity, onChangeQuantity, min, max, className, ...viewProps }: QuantityStepperProps): react_jsx_runtime.JSX.Element;
 
-interface CustomerCardProps extends Omit<VStackProps, 'children'> {
-    doc: any;
+interface CustomerCardProps<Doc = any> extends Omit<VStackProps, 'children'> {
+    doc: Doc;
+    traits?: CustomerTraits<Doc>;
     className?: string;
 }
-declare function CustomerCard({ doc, className, ...props }: CustomerCardProps): react_jsx_runtime.JSX.Element | null;
+declare function CustomerCard<Doc>({ doc, traits, className, ...props }: CustomerCardProps<Doc>): react_jsx_runtime.JSX.Element;
 
-interface CustomerSelectProps extends Omit<VStackProps, 'children'> {
+interface CustomerSelectProps<Doc = any> extends Omit<VStackProps, 'children'> {
     /** Customer documents to display as options */
-    customers: any[];
+    customers: Doc[];
     /** Currently selected customer (if any) */
-    selected?: any;
+    selected?: Doc | null;
     /** Called when a customer is selected */
-    onSelect: (customer: any) => void;
+    onSelect: (customer: Doc) => void;
+    traits?: CustomerTraits<Doc>;
     /** Called when the search text changes */
     onSearch: (query: string) => void;
     /** Placeholder text for the search input */
@@ -702,7 +703,7 @@ interface CustomerSelectProps extends Omit<VStackProps, 'children'> {
  * />
  * ```
  */
-declare function CustomerSelect({ customers, selected, onSelect, onSearch, placeholder, className, ...props }: CustomerSelectProps): react_jsx_runtime.JSX.Element;
+declare function CustomerSelect<Doc>(props: CustomerSelectProps<Doc>): react_jsx_runtime.JSX.Element;
 
 interface CustomerFormValues {
     firstName: string;
@@ -716,9 +717,10 @@ interface CustomerFormProps extends Omit<ViewProps, 'children'> {
     onChangeField: (field: keyof CustomerFormValues, value: string) => void;
     onSubmit?: () => void;
     submitLabel?: string;
+    showAddress?: boolean;
     className?: string;
 }
-declare function CustomerForm({ values, onChangeField, onSubmit, submitLabel, className, ...viewProps }: CustomerFormProps): react_jsx_runtime.JSX.Element;
+declare function CustomerForm({ values, onChangeField, onSubmit, submitLabel, showAddress, className, ...viewProps }: CustomerFormProps): react_jsx_runtime.JSX.Element;
 
 interface CustomerOrderHistoryProps extends Omit<ViewProps, 'children'> {
     orders: any[];
@@ -728,6 +730,23 @@ interface CustomerOrderHistoryProps extends Omit<ViewProps, 'children'> {
 }
 declare function CustomerOrderHistory({ orders, renderItem, emptyState, className, ...viewProps }: CustomerOrderHistoryProps): react_jsx_runtime.JSX.Element;
 
+interface CustomerPickerProps {
+    /** The connector's searchCustomers, bound to its context by the app. */
+    search: (query: string) => Promise<Customer[]>;
+    /** The connector's createCustomer, bound; absent hides "New customer". */
+    create?: (input: CustomerInput) => Promise<Customer>;
+    selected: Customer | null;
+    onSelect: (customer: Customer | null) => void;
+    /** Called for errors the picker can't explain to the cashier, including ConnectorUnauthorizedError, which means the app should sign in again. */
+    onError?: (error: unknown) => void;
+    /** false disables search and create (online only in v1). */
+    online: boolean;
+    /** Debounce before a search, ms. */
+    debounceMs?: number;
+    className?: string;
+}
+declare function CustomerPicker({ search, create, selected, onSelect, onError, online, debounceMs, className }: CustomerPickerProps): react_jsx_runtime.JSX.Element;
+
 interface PaymentMethodCardProps extends Omit<PressableProps, 'children'> {
     label: string;
     selected: boolean;
@@ -1235,12 +1254,14 @@ declare function Catalogue<Doc>({ products, traits, currency, onSelect, statusTe
     products: Doc[];
     traits: ProductTraits<Doc>;
     currency: string;
+    /** Receives the chosen product and variant with the nearest ConnectorProvider's stock overlay applied (a copy). */
     onSelect: (entry: CatalogueEntry<Doc>) => void;
     statusText?: string;
     /** Rendered at the end of the status line, e.g. a register control at phone width; the row renders even without `statusText`. */
     statusAccessory?: ReactNode;
     lastSyncedAt: Date | null;
-    /** The last completed stock reconcile pass, persisted across restarts; the later of this and lastSyncedAt wins. */
+    /** The last completed stock reconcile pass, persisted across restarts. The "stock as of" time shown is the
+     * latest of this, the provider's stockOverlayAsOf (when valid) and lastSyncedAt; null and omitted alike. */
     lastStockCheckAt?: Date | null;
     /** Whether to show a 12- or 24-hour clock in the stock-as-of time; undefined keeps the locale default. A platform
      * reads this off its own device APIs (e.g. expo-localization's getCalendars()) and passes it in. */
@@ -1254,7 +1275,7 @@ declare function Catalogue<Doc>({ products, traits, currency, onSelect, statusTe
 /** `store`/`taxLabel`/`topInset`/`formatDate` replace the app's Medusa settings, hard-coded VAT (default matches
  * TV6a's `Cart`), outbox strip and date util, so `Receipt` stays platform-neutral (ADR-052). */
 declare function Receipt({ order, store, cashier, registerId, newSale, taxLabel, topInset, formatDate }: {
-    order: Order;
+    order: SentOrder;
     store: {
         name: string;
         address?: string;
@@ -1269,18 +1290,27 @@ declare function Receipt({ order, store, cashier, registerId, newSale, taxLabel,
 
 declare function injectPrintStyle(): void;
 
-declare function SyncStatus({ state }: {
+/**
+ * `pluginName` names the store's plugin in the detail, as its owners know it; `registerState` counts till updates.
+ * `pullNotice` (a stopped product pull) shows as its own line and detail, above the outbox line.
+ */
+declare function SyncStatus({ state, registerState, pluginName, pullNotice }: {
     state: OutboxState;
+    registerState?: OutboxState;
+    pluginName?: string;
+    pullNotice?: SyncNotice;
 }): react_jsx_runtime.JSX.Element;
 
 /** The "Needs attention" (when not empty) and "Recent" orders, lifted from medusapos/app's orders screen (ADR-052).
  * `onRetry` is the outbox's `requeue`; `formatDate` replaces the app's date util; `footer` is the app's own content
- * (medusapos: the feedback link). The router and session redirect stay in the app. */
-declare function OrdersList({ orders, onRetry, formatDate, footer }: {
+ * (medusapos: the feedback link). The router and session redirect stay in the app. `stuck` is the outbox's
+ * `state.stuck` (`useOrderOutbox`): those pending orders need attention too, each with its own entry's reason and since. */
+declare function OrdersList({ orders, onRetry, formatDate, footer, stuck }: {
     orders: PosOrder[];
     onRetry(orderIds: string[]): Promise<number>;
     formatDate?: (iso: string) => string;
     footer?: ReactNode;
+    stuck?: OutboxState['stuck'];
 }): react_jsx_runtime.JSX.Element;
 
 interface POSLayoutProps extends Omit<ViewProps, 'children'> {
@@ -1361,4 +1391,4 @@ interface StoreSettingsChoiceScreenProps extends Omit<ViewProps, 'children'> {
  */
 declare function StoreSettingsChoiceScreen({ choices, initial, onSubmit, countryName, locale, title, body, regionLabel, countryLabel, channelLabel, submitLabel, className, ...viewProps }: StoreSettingsChoiceScreenProps): react_jsx_runtime.JSX.Element;
 
-export { APPROVAL_REQUIRED_TEXT, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Cart, type CartAction, CartBar, CartLine, CartLineActions, type CartLineActionsProps, type CartLineProps, CartNoteInput, type CartNoteInputProps, CartPanel, type CartPanelProps, CartTotal, type CartTotalProps, CashCountInput, type CashCountInputProps, CashTendered, type CashTenderedProps, Catalogue, type CategoryItem, CategoryNav, type CategoryNavProps, ChangeDisplay, type ChangeDisplayProps, Checkbox, CheckoutLayout, type CheckoutLayoutProps, type ChipItem, ClosureSheet, type ClosureSheetProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxTrigger, type ConnectionStatus, ConnectorStatus, type ConnectorStatusProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, CustomerCard, type CustomerCardProps, CustomerForm, type CustomerFormProps, type CustomerFormValues, CustomerOrderHistory, type CustomerOrderHistoryProps, CustomerSelect, type CustomerSelectProps, type Denomination, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiscountBadge, type DiscountBadgeProps, DiscountChips, DiscountForm, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, FilterChip, FilterChipGroup, type FilterChipGroupProps, type FilterChipProps, HStack, type HStackProps, HoverCard, HoverCardContent, HoverCardTrigger, Icon, IconButton, type IconButtonProps, type IconProps, Input, InputField, InputRoot, type InputRootProps, InputSlot, Label, type LabelProps, LiveTabScreen, type LiveTabScreenProps, type LiveTabScreenState, Loader, type LoaderProps, MovementSheet, type MovementSheetProps, OpenRegisterCard, type OpenRegisterCardProps, OrderCard, type OrderCardProps, OrderDetail, type OrderDetailLineItem, type OrderDetailProps, OrderList, type OrderListProps, type OrderStatus, OrderStatusBadge, type OrderStatusBadgeProps, OrderSummary, OrderSummaryLine, type OrderSummaryLineProps, type OrderSummaryPayment, type OrderSummaryProps, OrdersList, POSLayout, type POSLayoutProps, type PaymentMethod, PaymentMethodCard, type PaymentMethodCardProps, PaymentSelector, type PaymentSelectorProps, Popover, PopoverContent, PopoverTrigger, ProductCard, type ProductCardProps, ProductGrid, type ProductGridProps, ProductImage, type ProductImageProps, ProductList, type ProductListProps, ProductPrice, type ProductPriceProps, ProductSku, type ProductSkuProps, ProductStockBadge, type ProductStockBadgeProps, ProductTitle, type ProductTitleProps, ProductVariantPicker, type ProductVariantPickerProps, Progress, type ProgressProps, QuantityStepper, type QuantityStepperProps, RadioGroup, RadioGroupItem, Receipt, type ReceiptItem, ReceiptPreview, type ReceiptPreviewProps, RegisterBar, type RegisterBarPill, type RegisterBarProps, RegisterColumn, type RegisterColumnProps, RegisterCount, type RegisterCountProps, RegisterOpenClose, type RegisterOpenCloseProps, RegisterPanel, type RegisterPanelProps, RegisterPicker, type RegisterPickerProps, type RegisterPickerRegister, RegisterSummary, type RegisterSummaryProps, SearchIcon, SearchInput, type SearchInputProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, type SeparatorProps, SettingsGroup, type SettingsGroupProps, SettingsLayout, type SettingsLayoutProps, SettingsRow, type SettingsRowProps, Slider, type SliderProps, StoreSettingsChoiceScreen, type StoreSettingsChoiceScreenProps, type SvgIconProps, Switch, SyncStatus, Table, TableBody, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Tender, Text, type TextProps, Textarea, type TextareaProps, Toast, ToastClose, ToastDescription, type ToastProps, ToastTitle, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, Tooltip, TooltipContent, TooltipTrigger, type TransactionSummary, VStack, type VStackProps, type VariantOption, avatarVariants, badgeTextVariants, badgeVariants, buttonTextVariants, buttonVariants, createSvgIcon, describeRegisterBarPill, discountLabel, formatStockSyncTime, hstackVariants, iconButtonVariants, iconVariants, injectPrintStyle, loaderVariants, parseDiscount, textVariants, toastVariants, toggleTextVariants, toggleVariants, useInputContext, vstackVariants };
+export { APPROVAL_REQUIRED_TEXT, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Cart, type CartAction, CartBar, CartLine, CartLineActions, type CartLineActionsProps, type CartLineProps, CartNoteInput, type CartNoteInputProps, CartPanel, type CartPanelProps, CartTotal, type CartTotalProps, CashCountInput, type CashCountInputProps, CashTendered, type CashTenderedProps, Catalogue, type CategoryItem, CategoryNav, type CategoryNavProps, ChangeDisplay, type ChangeDisplayProps, Checkbox, CheckoutLayout, type CheckoutLayoutProps, type ChipItem, ClosureSheet, type ClosureSheetProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxTrigger, type ConnectionStatus, ConnectorStatus, type ConnectorStatusProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, CustomerCard, type CustomerCardProps, CustomerForm, type CustomerFormProps, type CustomerFormValues, CustomerOrderHistory, type CustomerOrderHistoryProps, CustomerPicker, type CustomerPickerProps, CustomerSelect, type CustomerSelectProps, type Denomination, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiscountBadge, type DiscountBadgeProps, DiscountChips, DiscountForm, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, FilterChip, FilterChipGroup, type FilterChipGroupProps, type FilterChipProps, HStack, type HStackProps, HoverCard, HoverCardContent, HoverCardTrigger, Icon, IconButton, type IconButtonProps, type IconProps, Input, InputField, InputRoot, type InputRootProps, InputSlot, Label, type LabelProps, LiveTabScreen, type LiveTabScreenProps, type LiveTabScreenState, Loader, type LoaderProps, MovementSheet, type MovementSheetProps, OpenRegisterCard, type OpenRegisterCardProps, OrderCard, type OrderCardProps, OrderDetail, type OrderDetailLineItem, type OrderDetailProps, OrderList, type OrderListProps, type OrderStatus, OrderStatusBadge, type OrderStatusBadgeProps, OrderSummary, OrderSummaryLine, type OrderSummaryLineProps, type OrderSummaryPayment, type OrderSummaryProps, OrdersList, POSLayout, type POSLayoutProps, type PaymentMethod, PaymentMethodCard, type PaymentMethodCardProps, PaymentSelector, type PaymentSelectorProps, Popover, PopoverContent, PopoverTrigger, ProductCard, type ProductCardProps, ProductGrid, type ProductGridProps, ProductImage, type ProductImageProps, ProductList, type ProductListProps, ProductPrice, type ProductPriceProps, ProductSku, type ProductSkuProps, ProductStockBadge, type ProductStockBadgeProps, ProductTitle, type ProductTitleProps, ProductVariantPicker, type ProductVariantPickerProps, Progress, type ProgressProps, QuantityStepper, type QuantityStepperProps, RadioGroup, RadioGroupItem, Receipt, type ReceiptItem, ReceiptPreview, type ReceiptPreviewProps, RegisterBar, type RegisterBarPill, type RegisterBarProps, RegisterColumn, type RegisterColumnProps, RegisterCount, type RegisterCountProps, RegisterOpenClose, type RegisterOpenCloseProps, RegisterPanel, type RegisterPanelProps, RegisterPicker, type RegisterPickerProps, type RegisterPickerRegister, RegisterSummary, type RegisterSummaryProps, SearchIcon, SearchInput, type SearchInputProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, type SeparatorProps, SettingsGroup, type SettingsGroupProps, SettingsLayout, type SettingsLayoutProps, SettingsRow, type SettingsRowProps, Slider, type SliderProps, StoreSettingsChoiceScreen, type StoreSettingsChoiceScreenProps, type SvgIconProps, Switch, SyncStatus, Table, TableBody, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Tender, Text, type TextProps, Textarea, type TextareaProps, Toast, ToastClose, ToastDescription, type ToastProps, ToastTitle, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, Tooltip, TooltipContent, TooltipTrigger, type TransactionSummary, VStack, type VStackProps, type VariantOption, avatarVariants, badgeTextVariants, badgeVariants, buttonTextVariants, buttonVariants, createSvgIcon, describeRegisterBarPill, discountLabel, formatStockSyncTime, hstackVariants, iconButtonVariants, iconVariants, injectPrintStyle, loaderVariants, parseDiscount, textVariants, toastVariants, toggleTextVariants, toggleVariants, useInputContext, vstackVariants };