@underverse-ui/underverse 1.0.116 → 1.0.118

package/dist/index.d.cts

@@ -899,8 +899,8 @@ declare const DatePicker: React$1.FC<DatePickerProps>;
 interface DateRangePickerProps {
     id?: string;
     startDate?: Date;
-    endDate?: Date;
-    onChange: (start: Date | undefined, end: Date | undefined) => void;
+    endDate?: Date | null;
+    onChange: (start: Date | undefined, end: Date | null | undefined) => void;
     placeholder?: string;
     className?: string;
     label?: string;
@@ -2867,6 +2867,189 @@ declare const VARIANT_STYLES_ALERT: {
     error: string;
 };
 
+/**
+ * Flat i18n config for overriding built-in English labels across all components.
+ * Pass this via the `i18n` prop on `UnderverseNextIntlProvider` or `TranslationProvider`.
+ *
+ * Component-level props (e.g. `searchPlaceholder` on `<Combobox />`) still take
+ * precedence over this global config — this only sets the global default.
+ *
+ * @example
+ * ```tsx
+ * <UnderverseNextIntlProvider
+ *   i18n={{
+ *     searchPlaceholder: "Tìm kiếm...",
+ *     selectPlaceholder: "Chọn...",
+ *     noResults: "Không có kết quả",
+ *     clearAll: "Xóa tất cả",
+ *     selectedCount: (n) => `Đã chọn ${n}`,
+ *     moreCount: (n) => `+${n} khác`,
+ *   }}
+ * >
+ *   <App />
+ * </UnderverseNextIntlProvider>
+ * ```
+ */
+interface GlobalI18nConfig {
+    /** Placeholder for search inputs inside dropdowns. Default: "Search..." */
+    searchPlaceholder?: string;
+    /** Placeholder shown on trigger button/input when nothing is selected. Default: "Select..." */
+    selectPlaceholder?: string;
+    /** Placeholder for CategoryTreeSelect trigger when nothing is selected. Falls back to `selectPlaceholder`. */
+    selectCategoryPlaceholder?: string;
+    /** Text shown when a search returns no results. Default: "No results found" */
+    noResults?: string;
+    /** Text shown when a category tree has no items. Default: "No categories" */
+    noCategories?: string;
+    /** Loading indicator text. Default: "Loading..." */
+    loading?: string;
+    /** "Clear all" button label (MultiCombobox dropdown header + trigger). Default: "Clear all" */
+    clearAll?: string;
+    /** aria-label for the × button that clears a search input. Default: "Clear search" */
+    clearSearch?: string;
+    /** aria-label for the × button that clears the current selection. Default: "Clear selection" */
+    clearSelection?: string;
+    /** Suggestion shown in empty search state. Default: "Try a different keyword" */
+    tryDifferentSearch?: string;
+    /** "Today" button label in DatePicker / CalendarTimeline. Default: "Today" */
+    today?: string;
+    /** "Clear" button label in DatePicker / TimePicker. Default: "Clear" */
+    clear?: string;
+    /** aria-label announced when a valid time is selected in TimePicker. Default: "Valid time selected" */
+    validTimeSelected?: string;
+    /**
+     * Summary shown in the MultiCombobox trigger when items are selected and
+     * there is no `maxSelected` limit. Default: `(n) => \`${n} items selected\``
+     */
+    selectedCount?: (count: number) => string;
+    /**
+     * Summary shown in the MultiCombobox trigger when `maxSelected` is set.
+     * Default: `(count, max) => \`${count}/${max} selected\``
+     */
+    selectedCountWithMax?: (count: number, max: number) => string;
+    /**
+     * Compact summary used in the MultiCombobox dropdown header.
+     * Default: `(n) => \`${n} selected\``
+     */
+    itemSelectedCount?: (count: number) => string;
+    /**
+     * Overflow pill shown when visible tags exceed `maxTagsVisible`.
+     * Default: `(n) => \`+${n} more\``
+     */
+    moreCount?: (count: number) => string;
+    /** aria-label for the × button that closes a modal. Default: "Close modal" */
+    closeModal?: string;
+    /** aria-label for the × button that dismisses a toast. Default: "Close toast" */
+    closeToast?: string;
+    /** aria-label for the × button inside a text input. Default: "Clear input" */
+    clearInput?: string;
+    /** aria-label for the eye button when password is hidden. Default: "Show password" */
+    showPassword?: string;
+    /** aria-label for the eye button when password is visible. Default: "Hide password" */
+    hidePassword?: string;
+    /** aria-label for the + stepper button on a number input. Default: "Increase value" */
+    increaseValue?: string;
+    /** aria-label for the − stepper button on a number input. Default: "Decrease value" */
+    decreaseValue?: string;
+    /** aria-label for the TimePicker trigger button. Default: "Select time" */
+    selectTime?: string;
+    /** aria-label for the inline time text input. Default: "Edit time value" */
+    editTimeValue?: string;
+    /** aria-label for the editable selected-time display. Default: "Edit selected time" */
+    editSelectedTime?: string;
+    /** aria-label for the AM/PM toggle. Default: "Select AM or PM" */
+    selectAmPm?: string;
+    /** aria-label for the "now" button in TimePicker. Default: "Set current time" */
+    setCurrentTime?: string;
+    /** aria-label for the clear button in TimePicker. Default: "Clear selected time" */
+    clearTime?: string;
+    /** title/aria-label for the download button on an uploaded file. Default: "Download" */
+    download?: string;
+    /** title/aria-label for the remove button on an uploaded file. Default: "Remove" */
+    removeFile?: string;
+    /**
+     * aria-label for the × button that removes a tag from TagInput.
+     * Default: `(tag) => \`Remove ${tag}\``
+     */
+    removeTag?: (tag: string) => string;
+    /** aria-label for the × button that removes a dismissible Badge. Default: "Remove badge" */
+    removeBadge?: string;
+    /** aria-label for the ‹ button that goes to the previous slide. Default: "Previous slide" */
+    prevSlide?: string;
+    /** aria-label for the › button that goes to the next slide. Default: "Next slide" */
+    nextSlide?: string;
+    /**
+     * aria-label for a dot/tab button in the Carousel pagination strip.
+     * Default: `(n) => \`Go to slide ${n}\``
+     */
+    goToSlide?: (n: number) => string;
+    /**
+     * aria-label for a thumbnail button in the Carousel thumbnail strip.
+     * Default: `(n) => \`Thumbnail ${n}\``
+     */
+    carouselThumbnail?: (n: number) => string;
+    /**
+     * aria-label for the filter icon in a DataTable column header.
+     * Default: `(column) => \`Filter by ${column}\``
+     */
+    filterByColumn?: (column: string) => string;
+    /**
+     * aria-label for the auto-fit icon in a DataTable column header.
+     * Default: `(column) => \`Auto fit ${column}\``
+     */
+    autoFitColumn?: (column: string) => string;
+    /** Fallback label for the "Sort by" button when no `sortByLabel` prop is provided. Default: "Sort by" */
+    sortBy?: string;
+    /** aria-label for the ColorPicker trigger button. Default: "Open color picker" */
+    openColorPicker?: string;
+    /** aria-label for the MonthYearPicker trigger button. Default: "Select month and year" */
+    selectMonthYear?: string;
+    /** aria-label for the minimum-value thumb on a Slider. Default: "Minimum value" */
+    minimumValue?: string;
+    /** aria-label for the maximum-value thumb on a Slider. Default: "Maximum value" */
+    maximumValue?: string;
+    /** aria-label for the "show all" button inside a collapsed Breadcrumb. Default: "Show all breadcrumb items" */
+    showAllBreadcrumbs?: string;
+    /** aria-label for the Carousel dots / pagination nav. Default: "Carousel pagination" */
+    carouselPagination?: string;
+    /** aria-label for the resize handle on a Sheet panel. Default: "Resize sheet" */
+    resizeSheet?: string;
+    /** aria-label for the row-height resize handle in CalendarTimeline. Default: "Resize row height" */
+    resizeRowHeight?: string;
+    /** aria-label for the resource-column resize handle in CalendarTimeline. Default: "Resize resource column" */
+    resizeResourceColumn?: string;
+    /** aria-label for the battery-level Progress bar. Default: "Battery level" */
+    batteryLevel?: string;
+    /** aria-label for the Breadcrumb `<nav>` landmark. Default: "Breadcrumb navigation" */
+    breadcrumbNavigation?: string;
+    /** aria-label for the step-list container in a Progress component. Default: "Progress steps" */
+    progressSteps?: string;
+    /** title for the preview button on an uploaded file. Default: "Preview" */
+    previewFile?: string;
+    /** title for the retry button on a failed upload. Default: "Retry" */
+    retryUpload?: string;
+    /**
+     * aria-label for the expand/collapse button on a CategoryTreeSelect item.
+     * Receives the category name and the current expanded state.
+     * Default: `(name, expanded) => expanded ? \`Collapse ${name}\` : \`Expand ${name}\``
+     */
+    toggleCategory?: (name: string, expanded: boolean) => string;
+    /** Column header label for the "Hour" spinner in TimePicker. Default: "Hour" */
+    hourLabel?: string;
+    /** Column header label for the "Min" spinner in TimePicker. Default: "Min" */
+    minuteLabel?: string;
+    /** Column header label for the "Sec" spinner in TimePicker. Default: "Sec" */
+    secondLabel?: string;
+    /** Label for the alpha (opacity) slider in ColorPicker. Default: "Alpha" */
+    alphaLabel?: string;
+    /** 12 full month names starting from January. */
+    monthNames?: [string, string, string, string, string, string, string, string, string, string, string, string];
+    /** 7 weekday names starting from Sunday. */
+    weekdayNames?: [string, string, string, string, string, string, string];
+}
+/** Read the nearest `GlobalI18nConfig`. Returns `{}` when no provider is present. */
+declare function useGlobalI18n(): GlobalI18nConfig;
+
 type Locale = "en" | "vi" | "ko" | "ja";
 type Translations = Record<string, Record<string, string | Record<string, string>>>;
 /** Public props for the `TranslationProvider` component. */
@@ -2876,7 +3059,10 @@ interface TranslationProviderProps {
     locale?: Locale;
     /** Custom translations to merge with defaults */
     translations?: Partial<Record<Locale, Translations>>;
+    /** Global flat label overrides — lets callers skip per-component prop drilling for common strings. */
+    i18n?: GlobalI18nConfig;
 }
+
 /**
  * TranslationProvider for Underverse UI components.
  *
@@ -2929,8 +3115,10 @@ interface NextIntlAdapterProps {
     children: React$1.ReactNode;
     locale?: string | null;
     messages?: Record<string, unknown> | null;
+    /** Global flat label overrides — lets callers skip per-component prop drilling for common strings. */
+    i18n?: GlobalI18nConfig;
 }
-declare function NextIntlAdapter({ children, locale, messages }: NextIntlAdapterProps): react_jsx_runtime.JSX.Element;
+declare function NextIntlAdapter({ children, locale, messages, i18n }: NextIntlAdapterProps): react_jsx_runtime.JSX.Element;
 declare const UnderverseNextIntlProvider: typeof NextIntlAdapter;
 
 type LegacyTranslations = Record<string, Record<string, string | Record<string, string>>>;
@@ -5170,4 +5358,4 @@ declare function getUnderverseMessages(locale?: UnderverseLocale): {
     };
 };
 
-export { AccessDenied, type AccessDeniedProps, Alert, Avatar, Badge, Badge as BadgeBase, BatteryProgress, BottomSheet, type BottomSheetProps, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarHoliday, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, type CardProps, Carousel, type CarouselEffectOptions, type CarouselEffectPreset, type Category, CategoryTreeSelect, type CategoryTreeSelectBaseProps, type CategoryTreeSelectLabels, type CategoryTreeSelectMultiProps, type CategoryTreeSelectProps, type CategoryTreeSelectSingleProps, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, CompactDatePicker, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableLabels, type DataTableProps, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, type DrawerProps, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, EmojiPicker, type EmojiPickerProps, FallingIcons, FileUpload, type FileUploadProps, type FilterType, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, type ImageUploadProps, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type LoadingState, type Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NextIntlAdapter, NotificationBadge, NotificationModal, NumberInput, type NumberInputProps, OverlayControls, type OverlayControlsProps, OverlayScrollArea, type OverlayScrollAreaProps, OverlayScrollbarProvider, type OverlayScrollbarProviderProps, PageLoading, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PillTabs, Popover, Progress, PulseBadge, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, type ScrollAreaProps, SearchInput, type SearchInputProps, Section, SegmentedProgress, SelectDropdown, Sheet, type SheetProps, SidebarSheet, type SidebarSheetProps, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, type SlideOverProps, Slider, type SliderProps, SmartImage, type Song, type Sorter, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type TextareaProps, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorFontFamilyOption, type UEditorFontSizeOption, type UEditorInlineUploadedItem, type UEditorLetterSpacingOption, type UEditorLineHeightOption, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, type UnderverseLocale, UnderverseNextIntlProvider, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, type UploadedImage, type UseOverlayScrollbarTargetOptions, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VIETNAM_HOLIDAYS, VerticalTabs, Watermark, type WatermarkProps, cn, cn as cnLocal, extractImageSrcsFromHtml, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, loading, normalizeImageUrl, prepareUEditorContentForSave, shadcnAnimationStyles, underverseMessages, useFormField, useOverlayScrollbarTarget, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };
+export { AccessDenied, type AccessDeniedProps, Alert, Avatar, Badge, Badge as BadgeBase, BatteryProgress, BottomSheet, type BottomSheetProps, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarHoliday, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, type CardProps, Carousel, type CarouselEffectOptions, type CarouselEffectPreset, type Category, CategoryTreeSelect, type CategoryTreeSelectBaseProps, type CategoryTreeSelectLabels, type CategoryTreeSelectMultiProps, type CategoryTreeSelectProps, type CategoryTreeSelectSingleProps, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, CompactDatePicker, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableLabels, type DataTableProps, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, type DrawerProps, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, EmojiPicker, type EmojiPickerProps, FallingIcons, FileUpload, type FileUploadProps, type FilterType, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, type GlobalI18nConfig, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, type ImageUploadProps, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type LoadingState, type Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NextIntlAdapter, NotificationBadge, NotificationModal, NumberInput, type NumberInputProps, OverlayControls, type OverlayControlsProps, OverlayScrollArea, type OverlayScrollAreaProps, OverlayScrollbarProvider, type OverlayScrollbarProviderProps, PageLoading, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PillTabs, Popover, Progress, PulseBadge, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, type ScrollAreaProps, SearchInput, type SearchInputProps, Section, SegmentedProgress, SelectDropdown, Sheet, type SheetProps, SidebarSheet, type SidebarSheetProps, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, type SlideOverProps, Slider, type SliderProps, SmartImage, type Song, type Sorter, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type TextareaProps, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorFontFamilyOption, type UEditorFontSizeOption, type UEditorInlineUploadedItem, type UEditorLetterSpacingOption, type UEditorLineHeightOption, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, type UnderverseLocale, UnderverseNextIntlProvider, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, type UploadedImage, type UseOverlayScrollbarTargetOptions, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VIETNAM_HOLIDAYS, VerticalTabs, Watermark, type WatermarkProps, cn, cn as cnLocal, extractImageSrcsFromHtml, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, loading, normalizeImageUrl, prepareUEditorContentForSave, shadcnAnimationStyles, underverseMessages, useFormField, useGlobalI18n, useOverlayScrollbarTarget, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };

package/dist/index.d.ts

@@ -899,8 +899,8 @@ declare const DatePicker: React$1.FC<DatePickerProps>;
 interface DateRangePickerProps {
     id?: string;
     startDate?: Date;
-    endDate?: Date;
-    onChange: (start: Date | undefined, end: Date | undefined) => void;
+    endDate?: Date | null;
+    onChange: (start: Date | undefined, end: Date | null | undefined) => void;
     placeholder?: string;
     className?: string;
     label?: string;
@@ -2867,6 +2867,189 @@ declare const VARIANT_STYLES_ALERT: {
     error: string;
 };
 
+/**
+ * Flat i18n config for overriding built-in English labels across all components.
+ * Pass this via the `i18n` prop on `UnderverseNextIntlProvider` or `TranslationProvider`.
+ *
+ * Component-level props (e.g. `searchPlaceholder` on `<Combobox />`) still take
+ * precedence over this global config — this only sets the global default.
+ *
+ * @example
+ * ```tsx
+ * <UnderverseNextIntlProvider
+ *   i18n={{
+ *     searchPlaceholder: "Tìm kiếm...",
+ *     selectPlaceholder: "Chọn...",
+ *     noResults: "Không có kết quả",
+ *     clearAll: "Xóa tất cả",
+ *     selectedCount: (n) => `Đã chọn ${n}`,
+ *     moreCount: (n) => `+${n} khác`,
+ *   }}
+ * >
+ *   <App />
+ * </UnderverseNextIntlProvider>
+ * ```
+ */
+interface GlobalI18nConfig {
+    /** Placeholder for search inputs inside dropdowns. Default: "Search..." */
+    searchPlaceholder?: string;
+    /** Placeholder shown on trigger button/input when nothing is selected. Default: "Select..." */
+    selectPlaceholder?: string;
+    /** Placeholder for CategoryTreeSelect trigger when nothing is selected. Falls back to `selectPlaceholder`. */
+    selectCategoryPlaceholder?: string;
+    /** Text shown when a search returns no results. Default: "No results found" */
+    noResults?: string;
+    /** Text shown when a category tree has no items. Default: "No categories" */
+    noCategories?: string;
+    /** Loading indicator text. Default: "Loading..." */
+    loading?: string;
+    /** "Clear all" button label (MultiCombobox dropdown header + trigger). Default: "Clear all" */
+    clearAll?: string;
+    /** aria-label for the × button that clears a search input. Default: "Clear search" */
+    clearSearch?: string;
+    /** aria-label for the × button that clears the current selection. Default: "Clear selection" */
+    clearSelection?: string;
+    /** Suggestion shown in empty search state. Default: "Try a different keyword" */
+    tryDifferentSearch?: string;
+    /** "Today" button label in DatePicker / CalendarTimeline. Default: "Today" */
+    today?: string;
+    /** "Clear" button label in DatePicker / TimePicker. Default: "Clear" */
+    clear?: string;
+    /** aria-label announced when a valid time is selected in TimePicker. Default: "Valid time selected" */
+    validTimeSelected?: string;
+    /**
+     * Summary shown in the MultiCombobox trigger when items are selected and
+     * there is no `maxSelected` limit. Default: `(n) => \`${n} items selected\``
+     */
+    selectedCount?: (count: number) => string;
+    /**
+     * Summary shown in the MultiCombobox trigger when `maxSelected` is set.
+     * Default: `(count, max) => \`${count}/${max} selected\``
+     */
+    selectedCountWithMax?: (count: number, max: number) => string;
+    /**
+     * Compact summary used in the MultiCombobox dropdown header.
+     * Default: `(n) => \`${n} selected\``
+     */
+    itemSelectedCount?: (count: number) => string;
+    /**
+     * Overflow pill shown when visible tags exceed `maxTagsVisible`.
+     * Default: `(n) => \`+${n} more\``
+     */
+    moreCount?: (count: number) => string;
+    /** aria-label for the × button that closes a modal. Default: "Close modal" */
+    closeModal?: string;
+    /** aria-label for the × button that dismisses a toast. Default: "Close toast" */
+    closeToast?: string;
+    /** aria-label for the × button inside a text input. Default: "Clear input" */
+    clearInput?: string;
+    /** aria-label for the eye button when password is hidden. Default: "Show password" */
+    showPassword?: string;
+    /** aria-label for the eye button when password is visible. Default: "Hide password" */
+    hidePassword?: string;
+    /** aria-label for the + stepper button on a number input. Default: "Increase value" */
+    increaseValue?: string;
+    /** aria-label for the − stepper button on a number input. Default: "Decrease value" */
+    decreaseValue?: string;
+    /** aria-label for the TimePicker trigger button. Default: "Select time" */
+    selectTime?: string;
+    /** aria-label for the inline time text input. Default: "Edit time value" */
+    editTimeValue?: string;
+    /** aria-label for the editable selected-time display. Default: "Edit selected time" */
+    editSelectedTime?: string;
+    /** aria-label for the AM/PM toggle. Default: "Select AM or PM" */
+    selectAmPm?: string;
+    /** aria-label for the "now" button in TimePicker. Default: "Set current time" */
+    setCurrentTime?: string;
+    /** aria-label for the clear button in TimePicker. Default: "Clear selected time" */
+    clearTime?: string;
+    /** title/aria-label for the download button on an uploaded file. Default: "Download" */
+    download?: string;
+    /** title/aria-label for the remove button on an uploaded file. Default: "Remove" */
+    removeFile?: string;
+    /**
+     * aria-label for the × button that removes a tag from TagInput.
+     * Default: `(tag) => \`Remove ${tag}\``
+     */
+    removeTag?: (tag: string) => string;
+    /** aria-label for the × button that removes a dismissible Badge. Default: "Remove badge" */
+    removeBadge?: string;
+    /** aria-label for the ‹ button that goes to the previous slide. Default: "Previous slide" */
+    prevSlide?: string;
+    /** aria-label for the › button that goes to the next slide. Default: "Next slide" */
+    nextSlide?: string;
+    /**
+     * aria-label for a dot/tab button in the Carousel pagination strip.
+     * Default: `(n) => \`Go to slide ${n}\``
+     */
+    goToSlide?: (n: number) => string;
+    /**
+     * aria-label for a thumbnail button in the Carousel thumbnail strip.
+     * Default: `(n) => \`Thumbnail ${n}\``
+     */
+    carouselThumbnail?: (n: number) => string;
+    /**
+     * aria-label for the filter icon in a DataTable column header.
+     * Default: `(column) => \`Filter by ${column}\``
+     */
+    filterByColumn?: (column: string) => string;
+    /**
+     * aria-label for the auto-fit icon in a DataTable column header.
+     * Default: `(column) => \`Auto fit ${column}\``
+     */
+    autoFitColumn?: (column: string) => string;
+    /** Fallback label for the "Sort by" button when no `sortByLabel` prop is provided. Default: "Sort by" */
+    sortBy?: string;
+    /** aria-label for the ColorPicker trigger button. Default: "Open color picker" */
+    openColorPicker?: string;
+    /** aria-label for the MonthYearPicker trigger button. Default: "Select month and year" */
+    selectMonthYear?: string;
+    /** aria-label for the minimum-value thumb on a Slider. Default: "Minimum value" */
+    minimumValue?: string;
+    /** aria-label for the maximum-value thumb on a Slider. Default: "Maximum value" */
+    maximumValue?: string;
+    /** aria-label for the "show all" button inside a collapsed Breadcrumb. Default: "Show all breadcrumb items" */
+    showAllBreadcrumbs?: string;
+    /** aria-label for the Carousel dots / pagination nav. Default: "Carousel pagination" */
+    carouselPagination?: string;
+    /** aria-label for the resize handle on a Sheet panel. Default: "Resize sheet" */
+    resizeSheet?: string;
+    /** aria-label for the row-height resize handle in CalendarTimeline. Default: "Resize row height" */
+    resizeRowHeight?: string;
+    /** aria-label for the resource-column resize handle in CalendarTimeline. Default: "Resize resource column" */
+    resizeResourceColumn?: string;
+    /** aria-label for the battery-level Progress bar. Default: "Battery level" */
+    batteryLevel?: string;
+    /** aria-label for the Breadcrumb `<nav>` landmark. Default: "Breadcrumb navigation" */
+    breadcrumbNavigation?: string;
+    /** aria-label for the step-list container in a Progress component. Default: "Progress steps" */
+    progressSteps?: string;
+    /** title for the preview button on an uploaded file. Default: "Preview" */
+    previewFile?: string;
+    /** title for the retry button on a failed upload. Default: "Retry" */
+    retryUpload?: string;
+    /**
+     * aria-label for the expand/collapse button on a CategoryTreeSelect item.
+     * Receives the category name and the current expanded state.
+     * Default: `(name, expanded) => expanded ? \`Collapse ${name}\` : \`Expand ${name}\``
+     */
+    toggleCategory?: (name: string, expanded: boolean) => string;
+    /** Column header label for the "Hour" spinner in TimePicker. Default: "Hour" */
+    hourLabel?: string;
+    /** Column header label for the "Min" spinner in TimePicker. Default: "Min" */
+    minuteLabel?: string;
+    /** Column header label for the "Sec" spinner in TimePicker. Default: "Sec" */
+    secondLabel?: string;
+    /** Label for the alpha (opacity) slider in ColorPicker. Default: "Alpha" */
+    alphaLabel?: string;
+    /** 12 full month names starting from January. */
+    monthNames?: [string, string, string, string, string, string, string, string, string, string, string, string];
+    /** 7 weekday names starting from Sunday. */
+    weekdayNames?: [string, string, string, string, string, string, string];
+}
+/** Read the nearest `GlobalI18nConfig`. Returns `{}` when no provider is present. */
+declare function useGlobalI18n(): GlobalI18nConfig;
+
 type Locale = "en" | "vi" | "ko" | "ja";
 type Translations = Record<string, Record<string, string | Record<string, string>>>;
 /** Public props for the `TranslationProvider` component. */
@@ -2876,7 +3059,10 @@ interface TranslationProviderProps {
     locale?: Locale;
     /** Custom translations to merge with defaults */
     translations?: Partial<Record<Locale, Translations>>;
+    /** Global flat label overrides — lets callers skip per-component prop drilling for common strings. */
+    i18n?: GlobalI18nConfig;
 }
+
 /**
  * TranslationProvider for Underverse UI components.
  *
@@ -2929,8 +3115,10 @@ interface NextIntlAdapterProps {
     children: React$1.ReactNode;
     locale?: string | null;
     messages?: Record<string, unknown> | null;
+    /** Global flat label overrides — lets callers skip per-component prop drilling for common strings. */
+    i18n?: GlobalI18nConfig;
 }
-declare function NextIntlAdapter({ children, locale, messages }: NextIntlAdapterProps): react_jsx_runtime.JSX.Element;
+declare function NextIntlAdapter({ children, locale, messages, i18n }: NextIntlAdapterProps): react_jsx_runtime.JSX.Element;
 declare const UnderverseNextIntlProvider: typeof NextIntlAdapter;
 
 type LegacyTranslations = Record<string, Record<string, string | Record<string, string>>>;
@@ -5170,4 +5358,4 @@ declare function getUnderverseMessages(locale?: UnderverseLocale): {
     };
 };
 
-export { AccessDenied, type AccessDeniedProps, Alert, Avatar, Badge, Badge as BadgeBase, BatteryProgress, BottomSheet, type BottomSheetProps, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarHoliday, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, type CardProps, Carousel, type CarouselEffectOptions, type CarouselEffectPreset, type Category, CategoryTreeSelect, type CategoryTreeSelectBaseProps, type CategoryTreeSelectLabels, type CategoryTreeSelectMultiProps, type CategoryTreeSelectProps, type CategoryTreeSelectSingleProps, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, CompactDatePicker, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableLabels, type DataTableProps, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, type DrawerProps, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, EmojiPicker, type EmojiPickerProps, FallingIcons, FileUpload, type FileUploadProps, type FilterType, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, type ImageUploadProps, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type LoadingState, type Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NextIntlAdapter, NotificationBadge, NotificationModal, NumberInput, type NumberInputProps, OverlayControls, type OverlayControlsProps, OverlayScrollArea, type OverlayScrollAreaProps, OverlayScrollbarProvider, type OverlayScrollbarProviderProps, PageLoading, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PillTabs, Popover, Progress, PulseBadge, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, type ScrollAreaProps, SearchInput, type SearchInputProps, Section, SegmentedProgress, SelectDropdown, Sheet, type SheetProps, SidebarSheet, type SidebarSheetProps, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, type SlideOverProps, Slider, type SliderProps, SmartImage, type Song, type Sorter, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type TextareaProps, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorFontFamilyOption, type UEditorFontSizeOption, type UEditorInlineUploadedItem, type UEditorLetterSpacingOption, type UEditorLineHeightOption, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, type UnderverseLocale, UnderverseNextIntlProvider, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, type UploadedImage, type UseOverlayScrollbarTargetOptions, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VIETNAM_HOLIDAYS, VerticalTabs, Watermark, type WatermarkProps, cn, cn as cnLocal, extractImageSrcsFromHtml, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, loading, normalizeImageUrl, prepareUEditorContentForSave, shadcnAnimationStyles, underverseMessages, useFormField, useOverlayScrollbarTarget, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };
+export { AccessDenied, type AccessDeniedProps, Alert, Avatar, Badge, Badge as BadgeBase, BatteryProgress, BottomSheet, type BottomSheetProps, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarHoliday, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, type CardProps, Carousel, type CarouselEffectOptions, type CarouselEffectPreset, type Category, CategoryTreeSelect, type CategoryTreeSelectBaseProps, type CategoryTreeSelectLabels, type CategoryTreeSelectMultiProps, type CategoryTreeSelectProps, type CategoryTreeSelectSingleProps, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, CompactDatePicker, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableLabels, type DataTableProps, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, type DrawerProps, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, EmojiPicker, type EmojiPickerProps, FallingIcons, FileUpload, type FileUploadProps, type FilterType, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, type GlobalI18nConfig, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, type ImageUploadProps, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type LoadingState, type Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NextIntlAdapter, NotificationBadge, NotificationModal, NumberInput, type NumberInputProps, OverlayControls, type OverlayControlsProps, OverlayScrollArea, type OverlayScrollAreaProps, OverlayScrollbarProvider, type OverlayScrollbarProviderProps, PageLoading, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PillTabs, Popover, Progress, PulseBadge, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, type ScrollAreaProps, SearchInput, type SearchInputProps, Section, SegmentedProgress, SelectDropdown, Sheet, type SheetProps, SidebarSheet, type SidebarSheetProps, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, type SlideOverProps, Slider, type SliderProps, SmartImage, type Song, type Sorter, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type TextareaProps, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorFontFamilyOption, type UEditorFontSizeOption, type UEditorInlineUploadedItem, type UEditorLetterSpacingOption, type UEditorLineHeightOption, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, type UnderverseLocale, UnderverseNextIntlProvider, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, type UploadedImage, type UseOverlayScrollbarTargetOptions, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VIETNAM_HOLIDAYS, VerticalTabs, Watermark, type WatermarkProps, cn, cn as cnLocal, extractImageSrcsFromHtml, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, loading, normalizeImageUrl, prepareUEditorContentForSave, shadcnAnimationStyles, underverseMessages, useFormField, useGlobalI18n, useOverlayScrollbarTarget, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };