@llmnative/react 1.19.5 → 1.21.0

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

@@ -56,6 +56,7 @@ export interface SideNavTheme {
     overlayClassName?: string;
     headerClassName?: string;
     navClassName?: string;
+    bottomNavClassName?: string;
     footerClassName?: string;
     groupLabelClassName?: string;
     groupDividerClassName?: string;

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

@@ -24,6 +24,12 @@ export interface SideNavProps {
     menuKey?: string;
     /** Explicit items — alternative to menuKey */
     items?: SideNavItemDef[];
+    /**
+     * Items pinned at the bottom of the sidebar, above the footer and outside the scrolling
+     * list (e.g. Settings). Same shape as `items`: groups, children, badges and active state
+     * work the same way. In `embedded` mode they follow the main items, separated by a border.
+     */
+    bottomItems?: SideNavItemDef[];
     /** Initial collapsed state for UNCONTROLLED usage (ignored once `collapsed` is passed —
      * see below). Default false. */
     defaultCollapsed?: boolean;
@@ -59,4 +65,4 @@ export interface SideNavProps {
      */
     embedded?: boolean;
 }
-export default function SideNav({ menuKey, items: itemsProp, defaultCollapsed, collapsed: collapsedProp, onCollapsedChange, showIcons, showCollapseButton, footer, header, embedded, }: SideNavProps): React.JSX.Element | null;
+export default function SideNav({ menuKey, items: itemsProp, bottomItems, defaultCollapsed, collapsed: collapsedProp, onCollapsedChange, showIcons, showCollapseButton, footer, header, embedded, }: SideNavProps): React.JSX.Element | null;

package/dist/types/src/components/ui/Modal.d.ts

@@ -38,6 +38,8 @@ export interface ModalProps extends MotionUIProps {
     footerClassName?: string;
     /** Close the modal when the user clicks the backdrop. Defaults to `true`. */
     closeOnBackdrop?: boolean;
+    /** Close the modal with the Escape key (only the top-most open modal reacts). Defaults to `true`. */
+    closeOnEscape?: boolean;
     /** CSS `z-index` override (useful when stacking modals). */
     zIndex?: number;
     /**

package/llms-full.txt

@@ -551,11 +551,13 @@ Quando `commands` e presente in `mode="run"`, `Prompt` monta internamente `Conte
 <Modal title="Conferma" size="md" position="center" onClose={() => {}} onSave={handleSave} onDelete={handleDelete} motion="fade" allowFullscreen stackedBehind>
   {content}
 </Modal>
-<Modal.YesNo title="Sicuro?" onClose={() => {}} onYes={async () => true} />
-<Modal.Ok title="Completato!" onClose={() => {}} />
+<ModalYesNo title="Sicuro?" onClose={() => {}} onYes={async () => true}>Eliminare il record?</ModalYesNo>
+<ModalOk title="Completato!" onClose={() => {}}>Salvato.</ModalOk>
 ```
 `size`: `'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'fullscreen'`
 `position`: `'center' | 'top' | 'left' | 'right' | 'bottom'`
+`ModalYesNo` e `ModalOk` sono export separati: `Modal.YesNo` e `Modal.Ok` non esistono.
+Tastiera: Esc chiude il modal in cima alla pila (`closeOnEscape`, default `true`).
 Accessibilità: il dialog ha `role="dialog"`, `aria-modal="true"` (non con `stackedBehind`) e `aria-labelledby` verso `title` (o `header` stringa) — nei test si trova con `getByRole('dialog', { name })`.
 
 | Prop | Tipo | Note |
@@ -570,6 +572,7 @@ Accessibilità: il dialog ha `role="dialog"`, `aria-modal="true"` (non con `stac
 | `showCancel` | `boolean` | Default `true` |
 | `stackedBehind` | `boolean` | Modal seconda in pila |
 | `closeOnBackdrop` | `boolean` | Default `true` |
+| `closeOnEscape` | `boolean` | Default `true` — solo il modal in cima reagisce |
 | `zIndex` | `number` | |
 | `motion` | `MotionReference` | Preset animazione |
 | Classi CSS header/title/subtitle/body/footer | `string` | |
@@ -762,7 +765,7 @@ utile quando un comando cambia famiglia sintattica (per esempio da `{{ ... }}` a
 ### Altre primitive
 ```tsx
 <Icon name="user" size={20} />           // usa provider icone configurato
-<ImageAvatar src="..." label="Mario" size={40} />
+<ImageAvatar src="..." title="Mario" alt="Mario" width={40} height={40} />
 <Loader show={isLoading}>{content}</Loader> // indicatore al posto dei figli finché show è true
 <Loader show>{null}</Loader>             // solo indicatore (es. pagina in caricamento)
 <Code language="tsx">{snippet}</Code>   // syntax highlight
@@ -799,6 +802,37 @@ utile quando un comando cambia famiglia sintattica (per esempio da `{{ ... }}` a
 | `width` / `height` | `number` |
 | `wrapperClassName` / `className` / `logoClassName` / `labelClassName` | `string` |
 
+**SideNav:**
+| Prop | Tipo |
+|---|---|
+| `items` | `SideNavItemDef[]` (in alternativa a `menuKey`) |
+| `menuKey` | `string` — voci dal menu registrato in `<App>` |
+| `bottomItems` | `SideNavItemDef[]` — voci fissate in fondo, sopra il footer e fuori dalla lista scorrevole (es. Impostazioni) |
+| `header` / `footer` | `ReactNode` |
+| `collapsed` + `onCollapsedChange` / `defaultCollapsed` | `boolean` — compressione controllata o no |
+| `showIcons` / `showCollapseButton` | `boolean` (default `true`) |
+| `embedded` | `boolean` — solo le voci, senza guscio (drawer, pannelli); `bottomItems` seguono le voci principali |
+
+`SideNavItemDef`: `{ path, title?, icon?, group?, end?, badge?, children? }`. La voce attiva ha
+`aria-current="page"`.
+
+```tsx
+<SideNav
+  items={[{ path: '/dashboard', title: 'Dashboard', icon: 'home' }]}
+  bottomItems={[{ path: '/settings', title: 'Impostazioni', icon: 'settings' }]}
+/>
+```
+
+**ImageAvatar:**
+| Prop | Tipo |
+|---|---|
+| `src` | `string` (obbligatoria) |
+| `width` / `height` | `number` |
+| `title` / `alt` | `string` |
+| `fit` | `AvatarFit` |
+| `badge` | `BadgeDescriptor` |
+| `feedback` | `ReactNode` |
+
 **Search:**
 | Prop | Tipo |
 |---|---|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.19.5",
+  "version": "1.21.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",

package/themes/cyber.ts

@@ -353,6 +353,7 @@ export const components: Theme = {
         overlayClassName: 'shadow-[0_0_32px_rgba(16,185,129,0.18)]',
         headerClassName: 'border-b border-border px-1.5 py-2',
         navClassName: 'px-1.5 py-2',
+        bottomNavClassName: 'border-t border-border px-1.5 py-2',
         footerClassName: 'border-t border-border px-1.5 py-2',
         groupLabelClassName: 'text-[10px] font-semibold uppercase tracking-[0.18em] text-muted-foreground/70 select-none',
         groupDividerClassName: 'bg-border/70',

package/themes/default.ts

@@ -367,6 +367,7 @@ export const components: Theme = {
         overlayClassName: 'shadow-xl',
         headerClassName: 'border-b border-border/60 px-1.5 py-2',
         navClassName: 'px-1.5 py-2',
+        bottomNavClassName: 'border-t border-border/60 px-1.5 py-2',
         footerClassName: 'border-t border-border/60 px-1.5 py-2',
         groupLabelClassName: 'text-[10.5px] font-semibold uppercase tracking-widest text-muted-foreground/60 select-none',
         groupDividerClassName: 'bg-border/50',

package/themes/flat.ts

@@ -353,6 +353,7 @@ export const components: Theme = {
         overlayClassName: 'shadow-lg',
         headerClassName: 'border-b border-border px-1.5 py-2',
         navClassName: 'px-1.5 py-2',
+        bottomNavClassName: 'border-t border-border px-1.5 py-2',
         footerClassName: 'border-t border-border px-1.5 py-2',
         groupLabelClassName: 'text-[10px] font-semibold uppercase tracking-[0.16em] text-muted-foreground/70 select-none',
         groupDividerClassName: 'bg-border/60',