@algenium/blocks 1.5.0 → 1.6.0

package/dist/index.d.cts

@@ -677,6 +677,11 @@ interface ChatSidebarProps {
 }
 declare function ChatSidebar({ currentUserId, config, labels, roleLabel, roomTypeLabel, mobileTopOffset, className, }: ChatSidebarProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * Debounces a value — useful for ZIP lookups and autocomplete queries.
+ */
+declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
@@ -753,6 +758,119 @@ declare function PopoverAnchor({ ...props }: React.ComponentProps<typeof Popover
 declare function ScrollArea({ className, children, ...props }: React.ComponentProps<typeof ScrollAreaPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare function ScrollBar({ className, orientation, ...props }: React.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>): react_jsx_runtime.JSX.Element;
 
+interface CardTokenResult {
+    tokenId: string;
+    brand: string;
+    last4: string;
+    expMonth: number;
+    expYear: number;
+    masked: string;
+    holderName?: string | null;
+}
+interface CardInputLabels {
+    number: string;
+    expiry: string;
+    cvc: string;
+    holderName: string;
+    tokenize: string;
+    tokenized: string;
+    replace: string;
+    invalidNumber: string;
+    expiredCard: string;
+    invalidCvc: string;
+    tokenizeFailed: string;
+}
+interface CardInputProps {
+    tokenize: (input: {
+        pan: string;
+        expMonth: number;
+        expYear: number;
+        cvc: string;
+        holderName?: string;
+    }) => Promise<CardTokenResult>;
+    value?: CardTokenResult | null;
+    onChange: (token: CardTokenResult | null) => void;
+    acceptedBrands?: string[];
+    requireHolderName?: boolean;
+    labels: CardInputLabels;
+    disabled?: boolean;
+    largeText?: boolean;
+    className?: string;
+    onError?: (message: string) => void;
+}
+declare function CardInput({ tokenize, value, onChange, acceptedBrands, requireHolderName, labels, disabled, largeText, className, onError, }: CardInputProps): react_jsx_runtime.JSX.Element;
+
+interface USAddressValue {
+    street: string;
+    street2?: string;
+    city: string;
+    state: string;
+    zip: string;
+    country: "US";
+}
+interface USAddressInputLabels {
+    street: string;
+    street2?: string;
+    city: string;
+    state: string;
+    zip: string;
+    searchPlaceholder: string;
+    uspsValidate: string;
+    uspsValidating: string;
+    uspsSuggested: string;
+    uspsUseSuggestion: string;
+    uspsKeepMine: string;
+    uspsApplied: string;
+    uspsUnavailable: string;
+    zipLookupFailed: string;
+    placeLookupFailed: string;
+    autocompleteUnavailable: string;
+    /** Optional copy for the autocomplete toggle header */
+    autocompleteTitle?: string;
+    /** Optional copy under the autocomplete toggle title */
+    autocompleteDescription?: string;
+    /** Optional placeholders for fields */
+    streetPlaceholder?: string;
+    street2Placeholder?: string;
+    cityPlaceholder?: string;
+    statePlaceholder?: string;
+    zipPlaceholder?: string;
+    /** Shown next to street2 label (e.g. "(optional)") */
+    street2OptionalHint?: string;
+    /** Fixed country line (US-only component) */
+    countryLabel?: string;
+}
+interface AddressAutocompleteAdapter {
+    search: (q: string, sessionToken: string, signal: AbortSignal) => Promise<Array<{
+        placeId: string;
+        mainText: string;
+        secondaryText: string;
+    }>>;
+    details: (placeId: string, signal: AbortSignal) => Promise<USAddressValue>;
+}
+interface USAddressInputProps {
+    value?: USAddressValue;
+    onChange: (value: USAddressValue) => void;
+    lookupZip?: (zip: string, signal: AbortSignal) => Promise<{
+        city: string;
+        state: string;
+    }>;
+    validateAddress?: (addr: USAddressValue, signal: AbortSignal) => Promise<{
+        standardized: USAddressValue;
+        dpvMatch?: "Y" | "N" | "S" | "D" | "";
+        changed: boolean;
+    }>;
+    autocomplete?: AddressAutocompleteAdapter;
+    labels: USAddressInputLabels;
+    disabled?: boolean;
+    largeText?: boolean;
+    className?: string;
+    onError?: (message: string) => void;
+    /** When false, hide the autocomplete on/off row (autocomplete still works if forced on externally — prefer leaving default true when adapter exists). */
+    showAutocompleteToggle?: boolean;
+}
+declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, showAutocompleteToggle, }: USAddressInputProps): react_jsx_runtime.JSX.Element;
+
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useEnvironmentContext, useLanguageContext, useNotificationsContext };
+export { type AddressAutocompleteAdapter, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, CardInput, type CardInputLabels, type CardInputProps, type CardTokenResult, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, type USAddressInputLabels, type USAddressInputProps, type USAddressValue, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useEnvironmentContext, useLanguageContext, useNotificationsContext };

package/dist/index.d.ts

@@ -677,6 +677,11 @@ interface ChatSidebarProps {
 }
 declare function ChatSidebar({ currentUserId, config, labels, roleLabel, roomTypeLabel, mobileTopOffset, className, }: ChatSidebarProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * Debounces a value — useful for ZIP lookups and autocomplete queries.
+ */
+declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
@@ -753,6 +758,119 @@ declare function PopoverAnchor({ ...props }: React.ComponentProps<typeof Popover
 declare function ScrollArea({ className, children, ...props }: React.ComponentProps<typeof ScrollAreaPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare function ScrollBar({ className, orientation, ...props }: React.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>): react_jsx_runtime.JSX.Element;
 
+interface CardTokenResult {
+    tokenId: string;
+    brand: string;
+    last4: string;
+    expMonth: number;
+    expYear: number;
+    masked: string;
+    holderName?: string | null;
+}
+interface CardInputLabels {
+    number: string;
+    expiry: string;
+    cvc: string;
+    holderName: string;
+    tokenize: string;
+    tokenized: string;
+    replace: string;
+    invalidNumber: string;
+    expiredCard: string;
+    invalidCvc: string;
+    tokenizeFailed: string;
+}
+interface CardInputProps {
+    tokenize: (input: {
+        pan: string;
+        expMonth: number;
+        expYear: number;
+        cvc: string;
+        holderName?: string;
+    }) => Promise<CardTokenResult>;
+    value?: CardTokenResult | null;
+    onChange: (token: CardTokenResult | null) => void;
+    acceptedBrands?: string[];
+    requireHolderName?: boolean;
+    labels: CardInputLabels;
+    disabled?: boolean;
+    largeText?: boolean;
+    className?: string;
+    onError?: (message: string) => void;
+}
+declare function CardInput({ tokenize, value, onChange, acceptedBrands, requireHolderName, labels, disabled, largeText, className, onError, }: CardInputProps): react_jsx_runtime.JSX.Element;
+
+interface USAddressValue {
+    street: string;
+    street2?: string;
+    city: string;
+    state: string;
+    zip: string;
+    country: "US";
+}
+interface USAddressInputLabels {
+    street: string;
+    street2?: string;
+    city: string;
+    state: string;
+    zip: string;
+    searchPlaceholder: string;
+    uspsValidate: string;
+    uspsValidating: string;
+    uspsSuggested: string;
+    uspsUseSuggestion: string;
+    uspsKeepMine: string;
+    uspsApplied: string;
+    uspsUnavailable: string;
+    zipLookupFailed: string;
+    placeLookupFailed: string;
+    autocompleteUnavailable: string;
+    /** Optional copy for the autocomplete toggle header */
+    autocompleteTitle?: string;
+    /** Optional copy under the autocomplete toggle title */
+    autocompleteDescription?: string;
+    /** Optional placeholders for fields */
+    streetPlaceholder?: string;
+    street2Placeholder?: string;
+    cityPlaceholder?: string;
+    statePlaceholder?: string;
+    zipPlaceholder?: string;
+    /** Shown next to street2 label (e.g. "(optional)") */
+    street2OptionalHint?: string;
+    /** Fixed country line (US-only component) */
+    countryLabel?: string;
+}
+interface AddressAutocompleteAdapter {
+    search: (q: string, sessionToken: string, signal: AbortSignal) => Promise<Array<{
+        placeId: string;
+        mainText: string;
+        secondaryText: string;
+    }>>;
+    details: (placeId: string, signal: AbortSignal) => Promise<USAddressValue>;
+}
+interface USAddressInputProps {
+    value?: USAddressValue;
+    onChange: (value: USAddressValue) => void;
+    lookupZip?: (zip: string, signal: AbortSignal) => Promise<{
+        city: string;
+        state: string;
+    }>;
+    validateAddress?: (addr: USAddressValue, signal: AbortSignal) => Promise<{
+        standardized: USAddressValue;
+        dpvMatch?: "Y" | "N" | "S" | "D" | "";
+        changed: boolean;
+    }>;
+    autocomplete?: AddressAutocompleteAdapter;
+    labels: USAddressInputLabels;
+    disabled?: boolean;
+    largeText?: boolean;
+    className?: string;
+    onError?: (message: string) => void;
+    /** When false, hide the autocomplete on/off row (autocomplete still works if forced on externally — prefer leaving default true when adapter exists). */
+    showAutocompleteToggle?: boolean;
+}
+declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, showAutocompleteToggle, }: USAddressInputProps): react_jsx_runtime.JSX.Element;
+
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useEnvironmentContext, useLanguageContext, useNotificationsContext };
+export { type AddressAutocompleteAdapter, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, CardInput, type CardInputLabels, type CardInputProps, type CardTokenResult, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, type USAddressInputLabels, type USAddressInputProps, type USAddressValue, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useEnvironmentContext, useLanguageContext, useNotificationsContext };