@algenium/blocks 1.5.0 → 1.7.0-rc.1

package/dist/index.d.cts

@@ -677,6 +677,18 @@ 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;
+/**
+ * Like {@link useDebouncedValue} but the returned value is `undefined` until
+ * the first `delayMs` has elapsed for the current `value`, and resets to
+ * `undefined` whenever `value` changes. Use for “only act after user pauses”
+ * (e.g. auto-submit / auto-validate) without firing on the initial tick.
+ */
+declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | undefined;
+
 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 +765,116 @@ 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;
+    /** Kept for backward compatibility; manual validate button removed */
+    uspsValidate: string;
+    uspsValidating: string;
+    uspsVerified: string;
+    uspsSuggested: string;
+    uspsUseSuggestion: string;
+    uspsKeepMine: string;
+    uspsApplied: string;
+    uspsUnavailable: string;
+    zipLookupFailed: string;
+    placeLookupFailed: string;
+    autocompleteUnavailable: string;
+    /** @deprecated Toggle removed; kept for consumer compatibility */
+    autocompleteTitle?: string;
+    /** @deprecated Toggle removed; kept for consumer compatibility */
+    autocompleteDescription?: string;
+    streetPlaceholder?: string;
+    street2Placeholder?: string;
+    cityPlaceholder?: string;
+    statePlaceholder?: string;
+    zipPlaceholder?: string;
+    street2OptionalHint?: string;
+    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;
+}
+declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, }: 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, useDebouncedValueStrict, useEnvironmentContext, useLanguageContext, useNotificationsContext };

package/dist/index.d.ts

@@ -677,6 +677,18 @@ 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;
+/**
+ * Like {@link useDebouncedValue} but the returned value is `undefined` until
+ * the first `delayMs` has elapsed for the current `value`, and resets to
+ * `undefined` whenever `value` changes. Use for “only act after user pauses”
+ * (e.g. auto-submit / auto-validate) without firing on the initial tick.
+ */
+declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | undefined;
+
 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 +765,116 @@ 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;
+    /** Kept for backward compatibility; manual validate button removed */
+    uspsValidate: string;
+    uspsValidating: string;
+    uspsVerified: string;
+    uspsSuggested: string;
+    uspsUseSuggestion: string;
+    uspsKeepMine: string;
+    uspsApplied: string;
+    uspsUnavailable: string;
+    zipLookupFailed: string;
+    placeLookupFailed: string;
+    autocompleteUnavailable: string;
+    /** @deprecated Toggle removed; kept for consumer compatibility */
+    autocompleteTitle?: string;
+    /** @deprecated Toggle removed; kept for consumer compatibility */
+    autocompleteDescription?: string;
+    streetPlaceholder?: string;
+    street2Placeholder?: string;
+    cityPlaceholder?: string;
+    statePlaceholder?: string;
+    zipPlaceholder?: string;
+    street2OptionalHint?: string;
+    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;
+}
+declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, }: 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, useDebouncedValueStrict, useEnvironmentContext, useLanguageContext, useNotificationsContext };