@llmnative/react 1.20.0 → 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/llms-full.txt

@@ -765,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
@@ -802,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.20.0",
+  "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',