@nicorp/nui 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -17,6 +17,7 @@ import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import { Legend } from 'recharts';
+import { LucideIcon } from 'lucide-react';
 import * as NavigationMenuPrimitive from '@radix-ui/react-navigation-menu';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
@@ -218,6 +219,28 @@ export declare const ChartLegend: typeof Legend;
 
 export declare const ChartTooltip: typeof Tooltip_2;
 
+export declare const ChatActionCard: React_2.ForwardRefExoticComponent<ChatActionCardProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatActionCardProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Card variant/type */
+    type?: "success" | "info" | "warning";
+    /** Main title text */
+    title: string;
+    /** Subtitle or description */
+    description?: string;
+    /** Custom icon (overrides type icon) */
+    icon?: LucideIcon;
+    /** Action button config */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** Allow card dismissal */
+    dismissible?: boolean;
+    /** Called when card is dismissed */
+    onDismiss?: () => void;
+}
+
 export declare const ChatBubble: React_2.ForwardRefExoticComponent<ChatBubbleProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare const ChatBubbleActions: React_2.ForwardRefExoticComponent<ChatBubbleActionsProps & React_2.RefAttributes<HTMLDivElement>>;
@@ -257,6 +280,27 @@ export declare const ChatContainer: React_2.ForwardRefExoticComponent<ChatContai
 export declare interface ChatContainerProps extends React_2.HTMLAttributes<HTMLDivElement> {
 }
 
+export declare const ChatEntityPreview: React_2.ForwardRefExoticComponent<ChatEntityPreviewProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatEntityPreviewProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Entity type */
+    type: "task" | "project" | "file" | "custom";
+    /** Entity title */
+    title: string;
+    /** Entity ID or badge text */
+    id?: string;
+    /** Status text */
+    status?: string;
+    /** Key-value properties to display */
+    properties?: Record<string, string>;
+    /** Link URL */
+    link?: string;
+    /** Custom icon (overrides type icon) */
+    icon?: LucideIcon;
+    /** Called when card is clicked (if link is not provided) */
+    onNavigate?: () => void;
+}
+
 export declare const ChatFollowUp: React_2.ForwardRefExoticComponent<ChatFollowUpProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface ChatFollowUpProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
@@ -418,6 +462,35 @@ export declare interface ChatModeSelectorProps extends Omit<React_2.HTMLAttribut
     size?: "sm" | "default";
 }
 
+export declare const ChatQuestion: React_2.ForwardRefExoticComponent<ChatQuestionProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatQuestionOption {
+    id: string;
+    label: string;
+    description?: string;
+}
+
+export declare interface ChatQuestionProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    /** Unique identifier for this question widget */
+    id?: string;
+    /** The question text */
+    question: string;
+    /** Answer options to display */
+    options: ChatQuestionOption[];
+    /** Called when user picks an option */
+    onSelect?: (optionId: string, label: string) => void;
+    /** ID of the currently selected option (for persistence) */
+    selectedId?: string;
+    /** Disable interaction (shows selection but prevents changes) */
+    disabled?: boolean;
+    /** Allow user to type a custom answer @default false */
+    allowFreeText?: boolean;
+    /** Called when user submits free-text answer */
+    onFreeTextSubmit?: (text: string) => void;
+    /** Grid columns for options @default 1 */
+    columns?: 1 | 2;
+}
+
 export declare const ChatToolCall: React_2.ForwardRefExoticComponent<ChatToolCallProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface ChatToolCallProps extends React_2.HTMLAttributes<HTMLDivElement> {
@@ -910,6 +983,11 @@ export declare interface MessageActionsProps extends React_2.HTMLAttributes<HTML
 
 export declare type MessageActionType = "copy" | "retry" | "edit" | "like" | "dislike" | "share";
 
+/** Recursive JSON dictionary — values are strings or nested objects. */
+export declare type MessageDictionary = {
+    [key: string]: string | MessageDictionary;
+};
+
 export declare function MetricCard({ title, value, description, trend, trendLabel, icon, className, ...props }: MetricCardProps): JSX_2.Element;
 
 declare interface MetricCardProps extends React_2.HTMLAttributes<HTMLDivElement> {
@@ -1394,6 +1472,9 @@ export declare const textVariants: (props?: ({
     leading?: "normal" | "tight" | "relaxed" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+/** Translation function returned by `useLocale()`. */
+export declare type TFunction = (key: string, vars?: Record<string, string | number>) => string;
+
 export declare type Theme = "dark" | "light" | "system";
 
 export declare function ThemeProvider({ children, defaultTheme, storageKey, attribute, enableSystem, disableTransitionOnChange, forcedTheme, nonce, }: ThemeProviderProps): JSX_2.Element;
@@ -1493,46 +1574,84 @@ export declare const TooltipTrigger: React_2.ForwardRefExoticComponent<TooltipPr
  *
  * @example
  * ```ts
- * t("Calling {name}...", { name: "search" })
+ * tpl("Calling {name}...", { name: "search" })
  * // → "Calling search..."
  * ```
  */
 export declare function tpl(template: string, vars: Record<string, string | number>): string;
 
 /**
- * Provides a locale dictionary to every NUI component in the tree.
+ * Provides i18n for both NUI components **and** your own app strings.
  *
- * @example
+ * @example NUI-only (component translations)
  * ```tsx
  * <TranslateProvider locale="ru">
  *   <App />
  * </TranslateProvider>
  * ```
  *
- * @example Custom locale
+ * @example With user JSON dictionaries
  * ```tsx
- * <TranslateProvider locale={{ chatInput_placeholder: "Ask anything…" }}>
+ * import en from "./locales/en.json"
+ * import ru from "./locales/ru.json"
+ *
+ * <TranslateProvider locale="ru" messages={{ en, ru }}>
  *   <App />
  * </TranslateProvider>
  * ```
  */
-declare function TranslateProvider({ locale, children }: TranslateProviderProps): JSX_2.Element;
+declare function TranslateProvider({ locale, messages, children }: TranslateProviderProps): JSX_2.Element;
 export { TranslateProvider as NUIProvider }
 export { TranslateProvider }
 
 export declare interface TranslateProviderProps {
-    /** Built-in locale key ("en" | "ru") or a custom (partial) locale dictionary.
+    /** Built-in locale key ("en" | "ru") or a custom (partial) NUI locale dictionary.
      *  Missing keys fall back to English. */
     locale?: "en" | "ru" | (string & {}) | Partial<NUILocale>;
+    /**
+     * User JSON dictionaries for app-level translations.
+     *
+     * @example
+     * ```tsx
+     * import en from "./locales/en.json"
+     * import ru from "./locales/ru.json"
+     *
+     * <TranslateProvider locale="ru" messages={{ en, ru }}>
+     *   <App />
+     * </TranslateProvider>
+     * ```
+     */
+    messages?: Record<string, MessageDictionary>;
     children: React_2.ReactNode;
 }
 
 declare type UseCarouselParameters = Parameters<typeof default_2>;
 
+/**
+ * Returns `{ t, lang }` for translating your own app strings.
+ *
+ * `t("profile.save")` resolves dot-paths in your JSON dictionaries.
+ * Variables: `t("greeting", { name: "Alex" })` → replaces `{name}`.
+ *
+ * Fallback chain: **active lang → "en" → raw key**.
+ *
+ * @example
+ * ```tsx
+ * function MyButton() {
+ *   const { t } = useLocale()
+ *   return <button>{t("profile.save")}</button>
+ * }
+ * ```
+ */
+export declare function useLocale(): {
+    t: TFunction;
+    lang: string;
+};
+
 export declare function useTheme(): ThemeProviderState;
 
 /**
- * Returns the current NUI locale dictionary.
+ * Returns the current NUI locale dictionary (built-in component strings).
  * Falls back to English when used outside a `<TranslateProvider>`.
  */
 declare function useTranslate(): NUILocale;