@llmnative/react 1.10.3 → 1.11.0

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

@@ -24,7 +24,24 @@ export interface SideNavProps {
     menuKey?: string;
     /** Explicit items — alternative to menuKey */
     items?: SideNavItemDef[];
+    /** Initial collapsed state for UNCONTROLLED usage (ignored once `collapsed` is passed —
+     * see below). Default false. */
     defaultCollapsed?: boolean;
+    /**
+     * Controlled collapsed state — pass this (together with `onCollapsedChange`) when the
+     * consumer needs to decide collapse state itself, e.g. auto-collapsing to icon-only once
+     * its own layout detects the content area has gotten too narrow (a sibling panel opened,
+     * a responsive breakpoint, ...). SideNav has no notion of viewport/layout on its own by
+     * design (a reusable block can't assume what surrounds it) — the consumer computes the
+     * decision and controls this component the standard React way. Omit both props (the
+     * default) for the previous uncontrolled behavior, driven entirely by the footer toggle
+     * button and `defaultCollapsed`. */
+    collapsed?: boolean;
+    /** Required together with `collapsed` — called with the next value on every user action
+     * that would otherwise flip internal state (the footer toggle button). The consumer owns
+     * the state and decides whether/how to apply it (e.g. only honoring the toggle when its
+     * own auto-collapse condition isn't currently forcing collapsed). */
+    onCollapsedChange?: (collapsed: boolean) => void;
     /** Show icon slot. Default true. */
     showIcons?: boolean;
     /** Show collapse/expand toggle button in the footer. Default true. */
@@ -42,4 +59,4 @@ export interface SideNavProps {
      */
     embedded?: boolean;
 }
-export default function SideNav({ menuKey, items: itemsProp, defaultCollapsed, showIcons, showCollapseButton, footer, header, embedded, }: SideNavProps): React.JSX.Element | null;
+export default function SideNav({ menuKey, items: itemsProp, defaultCollapsed, collapsed: collapsedProp, onCollapsedChange, showIcons, showCollapseButton, footer, header, embedded, }: SideNavProps): React.JSX.Element | null;

package/package.json

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