@nicorp/nui 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -771,6 +771,8 @@ export declare interface EmptyStateProps {
     className?: string;
 }
 
+export declare const en: NUILocale;
+
 export declare interface FileItem {
     id?: string;
     name: string;
@@ -1009,6 +1011,121 @@ export declare const navigationMenuTriggerStyle: (props?: ClassProp | undefined)
 
 export declare const NavigationMenuViewport: React_2.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuViewportProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
 
+export declare interface NUILocale {
+    chatInput_placeholder: string;
+    chatInput_attachFile: string;
+    chatInput_stopGenerating: string;
+    chatInput_sendMessage: string;
+    conversationList_newChat: string;
+    conversationList_searchPlaceholder: string;
+    conversationList_noResults: string;
+    conversationList_empty: string;
+    conversationList_today: string;
+    conversationList_yesterday: string;
+    conversationList_previous7Days: string;
+    conversationList_older: string;
+    conversationList_rename: string;
+    conversationList_delete: string;
+    chatHeader_online: string;
+    chatHeader_offline: string;
+    chatHeader_typing: string;
+    chatHeader_back: string;
+    chatHeader_clearConversation: string;
+    chatHeader_settings: string;
+    reasoning_title: string;
+    reasoning_thinking: string;
+    /** Use {duration} placeholder */
+    reasoning_thoughtFor: string;
+    /** Use {name} placeholder */
+    toolCall_calling: string;
+    /** Use {name} placeholder */
+    toolCall_failed: string;
+    toolCall_arguments: string;
+    toolCall_result: string;
+    toolCall_error: string;
+    messageActions_copy: string;
+    messageActions_retry: string;
+    messageActions_edit: string;
+    messageActions_like: string;
+    messageActions_dislike: string;
+    messageActions_share: string;
+    messageActions_copied: string;
+    followUp_freeTextPlaceholder: string;
+    followUp_send: string;
+    sourceCitation_sources: string;
+    aiLoading_thinking: string;
+    /** Use {name} placeholder */
+    filePreview_remove: string;
+    modelSelector_placeholder: string;
+    modelSelector_searchPlaceholder: string;
+    modelSelector_noResults: string;
+    common_close: string;
+    common_search: string;
+    common_noResults: string;
+    common_previous: string;
+    common_next: string;
+    common_more: string;
+    common_copyCode: string;
+    combobox_placeholder: string;
+    combobox_searchPlaceholder: string;
+    combobox_empty: string;
+    multiselect_placeholder: string;
+    multiselect_searchPlaceholder: string;
+    multiselect_empty: string;
+    /** Use {count} placeholder */
+    multiselect_selected: string;
+    datePicker_placeholder: string;
+    dataTable_searchPlaceholder: string;
+    dataTable_noResults: string;
+    /** Use {page} and {total} placeholders */
+    dataTable_pageOf: string;
+    dataTable_previous: string;
+    dataTable_next: string;
+    fileUpload_dragDrop: string;
+    /** Use {size} placeholder */
+    fileUpload_maxSize: string;
+    tagInput_placeholder: string;
+    pagination_previous: string;
+    pagination_next: string;
+    pagination_morePages: string;
+    pagination_goToPrevious: string;
+    pagination_goToNext: string;
+    modeToggle_toggleTheme: string;
+    modeToggle_light: string;
+    modeToggle_dark: string;
+    modeToggle_system: string;
+    modeToggle_colorTheme: string;
+    carousel_previousSlide: string;
+    carousel_nextSlide: string;
+    breadcrumb_more: string;
+}
+
+/**
+ * Provides a locale dictionary to every NUI AI component in the tree.
+ *
+ * @example
+ * ```tsx
+ * <NUIProvider locale="ru">
+ *   <App />
+ * </NUIProvider>
+ * ```
+ *
+ * @example Custom locale
+ * ```tsx
+ * <NUIProvider locale={{ chatInput_placeholder: "Ask anything…" }}>
+ *   <App />
+ * </NUIProvider>
+ * ```
+ */
+export declare function NUIProvider({ locale, children }: NUIProviderProps): JSX_2.Element;
+
+export declare interface NUIProviderProps {
+    /** Built-in locale key ("en" | "ru") or a custom (partial) locale dictionary.
+     *  Missing keys fall back to English. */
+    locale?: "en" | "ru" | (string & {}) | Partial<NUILocale>;
+    children: React_2.ReactNode;
+}
+
 export declare function NumberInput({ value, onChange, min, max, step, disabled, className, }: NumberInputProps): JSX_2.Element;
 
 export declare interface NumberInputProps {
@@ -1107,6 +1224,8 @@ export declare interface ReasoningBlockProps extends React_2.HTMLAttributes<HTML
     title?: string;
 }
 
+export declare const ru: NUILocale;
+
 export declare const ScrollArea: React_2.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & {
     orientation?: ScrollAreaOrientation;
 } & React_2.RefAttributes<HTMLDivElement>>;
@@ -1395,8 +1514,25 @@ export declare const TooltipProvider: React_2.FC<TooltipPrimitive.TooltipProvide
 
 export declare const TooltipTrigger: React_2.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
 
+/**
+ * Simple template interpolation: replaces `{key}` placeholders.
+ *
+ * @example
+ * ```ts
+ * t("Calling {name}...", { name: "search" })
+ * // → "Calling search..."
+ * ```
+ */
+export declare function tpl(template: string, vars: Record<string, string | number>): string;
+
 declare type UseCarouselParameters = Parameters<typeof default_2>;
 
+/**
+ * Returns the current NUI locale dictionary.
+ * Falls back to English when used outside a `<NUIProvider>`.
+ */
+export declare function useNUILocale(): NUILocale;
+
 export declare function useTheme(): ThemeProviderState;
 
 export declare const VStack: React_2.ForwardRefExoticComponent<StackProps & React_2.RefAttributes<HTMLDivElement>>;