@llmnative/react 1.31.0 → 1.33.0

package/dist/types/src/I18n.d.ts

@@ -57,6 +57,10 @@ export interface I18nDict {
         filtersRangeMin: string;
         filtersRangeMax: string;
         filtersSelectedCountTemplate: string;
+        tableView: string;
+        galleryView: string;
+        columns: string;
+        fields: string;
     };
     select: {
         placeholder: string;
@@ -88,6 +92,9 @@ export interface I18nDict {
     notifications: {
         title: string;
         seeAll: string;
+        markAllRead: string;
+        empty: string;
+        emptyHint: string;
     };
     code: {
         copyCode: string;
@@ -164,6 +171,13 @@ export interface I18nDict {
         noResponse: string;
         promptLabel: string;
         defaultOption: string;
+        role: string;
+        language: string;
+        voice: string;
+        style: string;
+        temperature: string;
+        stop: string;
+        stopping: string;
     };
     layout: {
         maxElements: string;
@@ -192,6 +206,127 @@ export interface I18nDict {
         notConfigured: string;
         loadError: string;
     };
+    errorBoundary: {
+        title: string;
+        description: string;
+        technicalDetails: string;
+        debugInformation: string;
+        context: string;
+        time: string;
+        agent: string;
+        componentTree: string;
+        copyDebug: string;
+        copied: string;
+        sendReport: string;
+        sending: string;
+        reportSent: string;
+        reportFailed: string;
+        tryAgain: string;
+        goHome: string;
+    };
+    themeSwitcher: {
+        title: string;
+        subtitle: string;
+        colorMode: string;
+        light: string;
+        dark: string;
+        primaryColor: string;
+        borderRadius: string;
+        sharp: string;
+        rounded: string;
+        font: string;
+        statusColors: string;
+        theme: string;
+        themeDescription: string;
+        iconLibrary: string;
+        weight: string;
+        blue: string;
+        violet: string;
+        green: string;
+        rose: string;
+        orange: string;
+        slate: string;
+        success: string;
+        warning: string;
+        info: string;
+        danger: string;
+        lucideDescription: string;
+        phosphorDescription: string;
+        weightThin: string;
+        weightLight: string;
+        weightRegular: string;
+        weightBold: string;
+        weightFill: string;
+    };
+    /** Image fields: `ImageField` and the image dialogs of `RichText`. */
+    imageField: {
+        openOriginal: string;
+        crop: string;
+        cropTitle: string;
+        cropImage: string;
+        editImage: string;
+        generatingVariants: string;
+        responsiveVariants: string;
+        variantsGenerated: string;
+        imageUrl: string;
+        imageUrlHint: string;
+        altText: string;
+        altTextHint: string;
+        altPlaceholder: string;
+        linkUrl: string;
+        optionalHint: string;
+        newTab: string;
+        sameTab: string;
+        insertImage: string;
+        insertImages: string;
+        include: string;
+        insert: string;
+        insertCount: string;
+    };
+    richText: {
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        heading1: string;
+        heading2: string;
+        heading3: string;
+        bulletList: string;
+        orderedList: string;
+        blockquote: string;
+        inlineCode: string;
+        codeBlock: string;
+        link: string;
+        undo: string;
+        redo: string;
+        clearFormat: string;
+        paragraphStyle: string;
+        normal: string;
+        insertTable: string;
+        insertTableSize: string;
+        addRowAbove: string;
+        addRowBelow: string;
+        addColumnLeft: string;
+        addColumnRight: string;
+        deleteRow: string;
+        deleteColumn: string;
+        deleteTable: string;
+        uploadImage: string;
+        uploadDocument: string;
+        sourceCode: string;
+        source: string;
+        words: string;
+        chars: string;
+        editLink: string;
+        removeLink: string;
+        altPlaceholder: string;
+    };
+    tabDynamic: {
+        addTab: string;
+    };
+    breadcrumbs: {
+        label: string;
+    };
 }
 type DeepPartial<T> = {
     [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
@@ -223,4 +358,10 @@ interface I18nProviderProps {
 export declare const I18nProvider: ({ children, config }: I18nProviderProps) => React.JSX.Element;
 export declare function useI18n(): I18nController;
 export declare function useI18n<P extends DotNestedKeyOf<I18nDict>>(namespace: P): PathValue<I18nDict, P>;
+/**
+ * Internal (not exported from the package): the dictionary of the nearest `<I18nProvider>`, or
+ * the English one when there is none — for components that may render outside the provider,
+ * like the root `ErrorBoundary` of `<App>`.
+ */
+export declare function useI18nDictOrEnglish(): I18nDict;
 export {};

package/dist/types/src/components/blocks/Notifications.d.ts

@@ -1,12 +1,32 @@
 import React from "react";
 import type { BadgeProps } from "../ui/Badge";
 import type { MotionReference } from "../../motion";
-interface NotificationItem {
+/** A button on a notification: it acts without opening the notification. */
+export interface NotificationAction {
+    label: string;
+    icon?: string;
+    /** May return a promise: the button shows it is working until it settles. */
+    onClick: () => void | Promise<unknown>;
+    /** `primary` stands out; the default is quiet. */
+    variant?: "primary" | "default";
+    /** Closes the menu once the action is done; by default it stays open. */
+    closeOnClick?: boolean;
+}
+export interface NotificationItem {
+    /** Stable key of the notification (the index otherwise). */
+    id?: string;
     title: string;
-    url: string;
+    /** A line under the title: what and where. */
+    description?: React.ReactNode;
+    /** Where the notification leads: a route of the app, or an address when `external`. Without it, it only shows. */
+    url?: string;
+    /** Opens `url` as an address in a new tab instead of a route of the app. */
+    external?: boolean;
     time: string;
     icon: string;
     read?: boolean;
+    /** Buttons under the notification, to act on it from the menu. */
+    actions?: NotificationAction[];
 }
 interface NotificationsProps {
     items?: NotificationItem[];
@@ -15,9 +35,11 @@ interface NotificationsProps {
     seeAllUrl?: string;
     /** Callback for "mark all as read" — shown in the header only when there are items */
     onMarkAllRead?: () => void;
+    /** Called when a notification is opened (e.g. to mark it read); the menu closes. */
+    onItemClick?: (item: NotificationItem, index: number) => void;
     /** Named motion preset for notification items appearance. */
     motion?: MotionReference;
     className?: string;
 }
-declare function Notifications({ items, badge, seeAllUrl, onMarkAllRead, motion, className, }: NotificationsProps): React.JSX.Element;
+declare function Notifications({ items, badge, seeAllUrl, onMarkAllRead, onItemClick, motion, className, }: NotificationsProps): React.JSX.Element;
 export default Notifications;

package/dist/types/src/components/index.d.ts

@@ -5,6 +5,7 @@ export type { BreadcrumbItem, BreadcrumbsProps, BreadcrumbSchemaOptions } from '
 export { default as Carousel } from './blocks/Carousel';
 export * from './blocks/Dropdown';
 export { default as Notifications } from './blocks/Notifications';
+export type { NotificationItem, NotificationAction } from './blocks/Notifications';
 export { default as Search } from './blocks/Search';
 export { default as Toolbar } from './blocks/Toolbar';
 export type { ToolbarProps } from './blocks/Toolbar';

package/llms-full.txt

@@ -63,6 +63,20 @@ import '@llmnative/react/dist/index.css'
 />
 ```
 
+### Testi dei componenti (i18n)
+
+I testi fissi dei componenti vengono da `I18nDict` e seguono `i18n.locale` (en, it, de, ru, ar, zh
+inclusi): un testo si cambia con `i18n.translations`, non nel codice. Namespace dei componenti:
+`notifications` (`markAllRead`, `empty`, `emptyHint`), `errorBoundary` (schermata d'errore; fuori da
+`<I18nProvider>`, come l'`ErrorBoundary` radice di `<App>`, resta in inglese), `themeSwitcher`,
+`imageField` (anche i dialoghi immagine di `RichText`), `richText`, `tabDynamic` (`addTab`),
+`breadcrumbs` (`label`, l'`aria-label` del `nav`), `grid` (`tableView`, `galleryView`, `columns`,
+`fields`), `prompt` (anche `Chatbot`: `role`, `language`, `voice`, `style`, `temperature`, `stop`).
+
+```tsx
+<App i18n={{ locale: 'it', translations: { it: { notifications: { emptyHint: 'Niente di nuovo' } } } }} />
+```
+
 ### AppThemeProviderConfig
 ```ts
 {
@@ -847,7 +861,8 @@ utile quando un comando cambia famiglia sintattica (per esempio da `{{ ... }}` a
 <Breadcrumbs trail={[{ label: 'Home', href: '/' }, { label: 'Utenti' }]} separator="/" jsonLd />
 <Brand url="/" label="MyApp" logo="/logo.svg" width={120} />
 <Search onQueryChange={(e) => setQ(e.target.value)} />
-<Notifications items={[...]} seeAllUrl="/notifications" onMarkAllRead={() => {}} />
+<Notifications items={[...]} seeAllUrl="/notifications" onMarkAllRead={() => {}} onItemClick={(item) => markRead(item.id)} />
+<Notifications items={[{ id: 'a', title: 'Fonte senza Action', description: 'crm · sources/notes/a.md', url: '/projects/crm', time: 'ora', icon: 'file', actions: [{ label: "Apri l'Action", icon: 'play', onClick: openAction, variant: 'primary' }] }]} />
 <Carousel images={[...]} />
 <Toolbar items={[...]}>
   {children}
@@ -919,8 +934,16 @@ icona; niente rete né storage. Default: `rounded-md bg-muted` (tema `Identicon.
 | `badge` | `BadgeProps` |
 | `seeAllUrl` | `string` |
 | `onMarkAllRead` | `() => void` |
+| `onItemClick` | `(item, index) => void` — una voce aperta (es. per segnarla letta); il menu si chiude |
 | `motion` | `MotionReference` |
 
+`NotificationItem`: `{ id?, title, description?, url?, external?, time, icon, read?, actions? }`. `description` è la
+riga sotto il titolo; senza `url` la voce si mostra e basta; con `external` l'`url` è un indirizzo aperto
+in una nuova scheda (`<a target="_blank">`), altrimenti una rotta (`Link`). `actions`
+(`NotificationAction[]`: `{ label, icon?, onClick, variant?: 'primary' | 'default', closeOnClick? }`) sono
+pulsanti sotto la voce: non la aprono, mostrano il caricamento finché la promessa di `onClick` è in corso
+e lasciano il menu aperto salvo `closeOnClick`.
+
 **ListCard:**
 | Prop | Tipo |
 |---|---|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.31.0",
+  "version": "1.33.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",