@ansh-ui/react 0.3.0 → 0.3.1

package/dist/{motion-DsQPOsTT.d.cts → motion-C6WfBFES.d.cts}

@@ -1,25 +1,9 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, ElementType, ForwardRefExoticComponent, ComponentPropsWithoutRef, RefAttributes } from 'react';
+import { ElementType, CSSProperties, ReactNode, ForwardRefExoticComponent, ComponentPropsWithoutRef, RefAttributes } from 'react';
 import * as _ansh_ui_core from '@ansh-ui/core';
 import { EasingInput, SpringOptions, springs, StaggerFrom, resolvePalette, BaseBehaviourOptions, BehaviourDefinition, ReducedMotionMode } from '@ansh-ui/core';
 import './use-observers-DvA7hSz4.cjs';
 
-/**
- * Declarative motion.
- *
- * A deliberately **small** subset of what a full motion library does: transform properties and
- * opacity, animated from `initial` to `animate`, plus hover and press states and an exit animation
- * when paired with `AnimatePresence`.
- *
- * That scope is a decision, not a gap. Layout animation (FLIP), shared-element transitions and
- * variant propagation each need machinery an order of magnitude larger than this file, and a
- * half-implementation of them is worse than none — it works in the demo and fails on the real page.
- * For those, use a dedicated library; for the 90% case of "fade this in, slide that up, spring the
- * card on hover", this costs a fraction of the bundle.
- *
- * Values are written straight to the element's `style` from the ticker's write phase. React never
- * re-renders during an animation.
- */
 interface MotionValues {
     opacity?: number;
     x?: number;
@@ -59,6 +43,23 @@ type MotionElementProps = {
     style?: CSSProperties;
     children?: ReactNode;
 };
+
+/**
+ * Declarative motion.
+ *
+ * A deliberately **small** subset of what a full motion library does: transform properties and
+ * opacity, animated from `initial` to `animate`, plus hover and press states and an exit animation
+ * when paired with `AnimatePresence`.
+ *
+ * That scope is a decision, not a gap. Layout animation (FLIP), shared-element transitions and
+ * variant propagation each need machinery an order of magnitude larger than this file, and a
+ * half-implementation of them is worse than none — it works in the demo and fails on the real page.
+ * For those, use a dedicated library; for the 90% case of "fade this in, slide that up, spring the
+ * card on hover", this costs a fraction of the bundle.
+ *
+ * Values are written straight to the element's `style` from the ticker's write phase. React never
+ * re-renders during an animation.
+ */
 /**
  * An animated element.
  *
@@ -69,6 +70,7 @@ type MotionElementProps = {
  * ```
  */
 declare function Motion({ as: Component, initial, animate: target, exit: _exit, transition, whileHover, whileTap, whileInView, inViewAmount, className, style, children, ...rest }: MotionElementProps & Record<string, unknown>): react.JSX.Element;
+
 interface AnimatePresenceProps {
     children: ReactNode;
     /** Seconds to keep a removed child mounted. Default `0.35`. */
@@ -85,6 +87,7 @@ interface AnimatePresenceProps {
  * React reuses element positions and this sees no removal to animate.
  */
 declare function AnimatePresence({ children, exitDuration }: AnimatePresenceProps): react.JSX.Element;
+
 interface DraggableProps {
     /** Constrain movement. */
     axis?: 'x' | 'y' | 'both';

package/dist/{motion-DoT_sTl1.d.ts → motion-ugXmf505.d.ts}

@@ -1,25 +1,9 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, ElementType, ForwardRefExoticComponent, ComponentPropsWithoutRef, RefAttributes } from 'react';
+import { ElementType, CSSProperties, ReactNode, ForwardRefExoticComponent, ComponentPropsWithoutRef, RefAttributes } from 'react';
 import * as _ansh_ui_core from '@ansh-ui/core';
 import { EasingInput, SpringOptions, springs, StaggerFrom, resolvePalette, BaseBehaviourOptions, BehaviourDefinition, ReducedMotionMode } from '@ansh-ui/core';
 import './use-observers-DvA7hSz4.js';
 
-/**
- * Declarative motion.
- *
- * A deliberately **small** subset of what a full motion library does: transform properties and
- * opacity, animated from `initial` to `animate`, plus hover and press states and an exit animation
- * when paired with `AnimatePresence`.
- *
- * That scope is a decision, not a gap. Layout animation (FLIP), shared-element transitions and
- * variant propagation each need machinery an order of magnitude larger than this file, and a
- * half-implementation of them is worse than none — it works in the demo and fails on the real page.
- * For those, use a dedicated library; for the 90% case of "fade this in, slide that up, spring the
- * card on hover", this costs a fraction of the bundle.
- *
- * Values are written straight to the element's `style` from the ticker's write phase. React never
- * re-renders during an animation.
- */
 interface MotionValues {
     opacity?: number;
     x?: number;
@@ -59,6 +43,23 @@ type MotionElementProps = {
     style?: CSSProperties;
     children?: ReactNode;
 };
+
+/**
+ * Declarative motion.
+ *
+ * A deliberately **small** subset of what a full motion library does: transform properties and
+ * opacity, animated from `initial` to `animate`, plus hover and press states and an exit animation
+ * when paired with `AnimatePresence`.
+ *
+ * That scope is a decision, not a gap. Layout animation (FLIP), shared-element transitions and
+ * variant propagation each need machinery an order of magnitude larger than this file, and a
+ * half-implementation of them is worse than none — it works in the demo and fails on the real page.
+ * For those, use a dedicated library; for the 90% case of "fade this in, slide that up, spring the
+ * card on hover", this costs a fraction of the bundle.
+ *
+ * Values are written straight to the element's `style` from the ticker's write phase. React never
+ * re-renders during an animation.
+ */
 /**
  * An animated element.
  *
@@ -69,6 +70,7 @@ type MotionElementProps = {
  * ```
  */
 declare function Motion({ as: Component, initial, animate: target, exit: _exit, transition, whileHover, whileTap, whileInView, inViewAmount, className, style, children, ...rest }: MotionElementProps & Record<string, unknown>): react.JSX.Element;
+
 interface AnimatePresenceProps {
     children: ReactNode;
     /** Seconds to keep a removed child mounted. Default `0.35`. */
@@ -85,6 +87,7 @@ interface AnimatePresenceProps {
  * React reuses element positions and this sees no removal to animate.
  */
 declare function AnimatePresence({ children, exitDuration }: AnimatePresenceProps): react.JSX.Element;
+
 interface DraggableProps {
     /** Constrain movement. */
     axis?: 'x' | 'y' | 'both';

package/dist/motion.cjs

@@ -1,7 +1,7 @@
 'use client';
 'use strict';
 
-var chunkIZ6T7LO3_cjs = require('./chunk-IZ6T7LO3.cjs');
+var chunkMPX7QT4R_cjs = require('./chunk-MPX7QT4R.cjs');
 var chunkTEPQGFR4_cjs = require('./chunk-TEPQGFR4.cjs');
 require('./chunk-SFU5EPSN.cjs');
 
@@ -9,67 +9,67 @@ require('./chunk-SFU5EPSN.cjs');
 
 Object.defineProperty(exports, "AnimatePresence", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.AnimatePresence; }
+  get: function () { return chunkMPX7QT4R_cjs.AnimatePresence; }
 });
 Object.defineProperty(exports, "AnimatedText", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.AnimatedText; }
+  get: function () { return chunkMPX7QT4R_cjs.AnimatedText; }
 });
 Object.defineProperty(exports, "Draggable", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.Draggable; }
+  get: function () { return chunkMPX7QT4R_cjs.Draggable; }
 });
 Object.defineProperty(exports, "GradientText", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.GradientText; }
+  get: function () { return chunkMPX7QT4R_cjs.GradientText; }
 });
 Object.defineProperty(exports, "MagneticButton", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.MagneticButton; }
+  get: function () { return chunkMPX7QT4R_cjs.MagneticButton; }
 });
 Object.defineProperty(exports, "Marquee", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.Marquee; }
+  get: function () { return chunkMPX7QT4R_cjs.Marquee; }
 });
 Object.defineProperty(exports, "Motion", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.Motion; }
+  get: function () { return chunkMPX7QT4R_cjs.Motion; }
 });
 Object.defineProperty(exports, "MotionConfig", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.MotionConfig; }
+  get: function () { return chunkMPX7QT4R_cjs.MotionConfig; }
 });
 Object.defineProperty(exports, "Parallax", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.Parallax; }
+  get: function () { return chunkMPX7QT4R_cjs.Parallax; }
 });
 Object.defineProperty(exports, "Ripple", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.Ripple; }
+  get: function () { return chunkMPX7QT4R_cjs.Ripple; }
 });
 Object.defineProperty(exports, "ScrollReveal", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.ScrollReveal; }
+  get: function () { return chunkMPX7QT4R_cjs.ScrollReveal; }
 });
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.ThemeProvider; }
+  get: function () { return chunkMPX7QT4R_cjs.ThemeProvider; }
 });
 Object.defineProperty(exports, "TiltCard", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.TiltCard; }
+  get: function () { return chunkMPX7QT4R_cjs.TiltCard; }
 });
 Object.defineProperty(exports, "themeScript", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.themeScript; }
+  get: function () { return chunkMPX7QT4R_cjs.themeScript; }
 });
 Object.defineProperty(exports, "useMotionConfig", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.useMotionConfig; }
+  get: function () { return chunkMPX7QT4R_cjs.useMotionConfig; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
-  get: function () { return chunkIZ6T7LO3_cjs.useTheme; }
+  get: function () { return chunkMPX7QT4R_cjs.useTheme; }
 });
 Object.defineProperty(exports, "useMergedRef", {
   enumerable: true,

package/dist/motion.d.cts

@@ -1,4 +1,4 @@
-export { A as AnimatePresence, a as AnimatePresenceProps, b as AnimatedText, c as AnimatedTextProps, D as Draggable, f as DraggableProps, G as GradientText, g as GradientTextProps, M as MagneticButton, h as Marquee, i as Motion, j as MotionConfig, k as MotionConfigProps, l as MotionConfigValue, m as MotionTransition, n as MotionValues, P as Parallax, R as Ripple, S as ScrollReveal, T as ThemeContextValue, o as ThemeProvider, p as ThemeProviderProps, q as ThemeSetting, r as TiltCard, t as themeScript, v as useMotionConfig, w as useTheme } from './motion-DsQPOsTT.cjs';
+export { A as AnimatePresence, a as AnimatePresenceProps, b as AnimatedText, c as AnimatedTextProps, D as Draggable, f as DraggableProps, G as GradientText, g as GradientTextProps, M as MagneticButton, h as Marquee, i as Motion, j as MotionConfig, k as MotionConfigProps, l as MotionConfigValue, m as MotionTransition, n as MotionValues, P as Parallax, R as Ripple, S as ScrollReveal, T as ThemeContextValue, o as ThemeProvider, p as ThemeProviderProps, q as ThemeSetting, r as TiltCard, t as themeScript, v as useMotionConfig, w as useTheme } from './motion-C6WfBFES.cjs';
 export { c as useMergedRef } from './use-observers-DvA7hSz4.cjs';
 import 'react';
 import '@ansh-ui/core';

package/dist/motion.d.ts

@@ -1,4 +1,4 @@
-export { A as AnimatePresence, a as AnimatePresenceProps, b as AnimatedText, c as AnimatedTextProps, D as Draggable, f as DraggableProps, G as GradientText, g as GradientTextProps, M as MagneticButton, h as Marquee, i as Motion, j as MotionConfig, k as MotionConfigProps, l as MotionConfigValue, m as MotionTransition, n as MotionValues, P as Parallax, R as Ripple, S as ScrollReveal, T as ThemeContextValue, o as ThemeProvider, p as ThemeProviderProps, q as ThemeSetting, r as TiltCard, t as themeScript, v as useMotionConfig, w as useTheme } from './motion-DoT_sTl1.js';
+export { A as AnimatePresence, a as AnimatePresenceProps, b as AnimatedText, c as AnimatedTextProps, D as Draggable, f as DraggableProps, G as GradientText, g as GradientTextProps, M as MagneticButton, h as Marquee, i as Motion, j as MotionConfig, k as MotionConfigProps, l as MotionConfigValue, m as MotionTransition, n as MotionValues, P as Parallax, R as Ripple, S as ScrollReveal, T as ThemeContextValue, o as ThemeProvider, p as ThemeProviderProps, q as ThemeSetting, r as TiltCard, t as themeScript, v as useMotionConfig, w as useTheme } from './motion-ugXmf505.js';
 export { c as useMergedRef } from './use-observers-DvA7hSz4.js';
 import 'react';
 import '@ansh-ui/core';

package/dist/motion.js

@@ -1,5 +1,5 @@
 'use client';
-export { AnimatePresence, AnimatedText, Draggable, GradientText, MagneticButton, Marquee, Motion, MotionConfig, Parallax, Ripple, ScrollReveal, ThemeProvider, TiltCard, themeScript, useMotionConfig, useTheme } from './chunk-PVDQPVYF.js';
+export { AnimatePresence, AnimatedText, Draggable, GradientText, MagneticButton, Marquee, Motion, MotionConfig, Parallax, Ripple, ScrollReveal, ThemeProvider, TiltCard, themeScript, useMotionConfig, useTheme } from './chunk-NJUVVMJV.js';
 export { useMergedRef } from './chunk-P5MRISBP.js';
 import './chunk-H34OXXJU.js';
 //# sourceMappingURL=motion.js.map

package/dist/navigation.cjs

@@ -1,7 +1,7 @@
 'use client';
 'use strict';
 
-var chunkDATBU46V_cjs = require('./chunk-DATBU46V.cjs');
+var chunkXYT6OXKP_cjs = require('./chunk-XYT6OXKP.cjs');
 var chunkZWAFLHC2_cjs = require('./chunk-ZWAFLHC2.cjs');
 require('./chunk-PO5DU3FU.cjs');
 require('./chunk-SFU5EPSN.cjs');
@@ -10,31 +10,31 @@ require('./chunk-SFU5EPSN.cjs');
 
 Object.defineProperty(exports, "Accordion", {
   enumerable: true,
-  get: function () { return chunkDATBU46V_cjs.Accordion; }
+  get: function () { return chunkXYT6OXKP_cjs.Accordion; }
 });
 Object.defineProperty(exports, "Breadcrumbs", {
   enumerable: true,
-  get: function () { return chunkDATBU46V_cjs.Breadcrumbs; }
+  get: function () { return chunkXYT6OXKP_cjs.Breadcrumbs; }
 });
 Object.defineProperty(exports, "Collapsible", {
   enumerable: true,
-  get: function () { return chunkDATBU46V_cjs.Collapsible; }
+  get: function () { return chunkXYT6OXKP_cjs.Collapsible; }
 });
 Object.defineProperty(exports, "DisclosureList", {
   enumerable: true,
-  get: function () { return chunkDATBU46V_cjs.DisclosureList; }
+  get: function () { return chunkXYT6OXKP_cjs.DisclosureList; }
 });
 Object.defineProperty(exports, "NavigationMenu", {
   enumerable: true,
-  get: function () { return chunkDATBU46V_cjs.NavigationMenu; }
+  get: function () { return chunkXYT6OXKP_cjs.NavigationMenu; }
 });
 Object.defineProperty(exports, "Stepper", {
   enumerable: true,
-  get: function () { return chunkDATBU46V_cjs.Stepper; }
+  get: function () { return chunkXYT6OXKP_cjs.Stepper; }
 });
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
-  get: function () { return chunkDATBU46V_cjs.Tabs; }
+  get: function () { return chunkXYT6OXKP_cjs.Tabs; }
 });
 Object.defineProperty(exports, "AppShell", {
   enumerable: true,

package/dist/navigation.js

@@ -1,5 +1,5 @@
 'use client';
-export { Accordion, Breadcrumbs, Collapsible, DisclosureList, NavigationMenu, Stepper, Tabs } from './chunk-OLTS6G5M.js';
+export { Accordion, Breadcrumbs, Collapsible, DisclosureList, NavigationMenu, Stepper, Tabs } from './chunk-GNA33V2J.js';
 export { AppShell, Sidebar } from './chunk-5CFQFMP5.js';
 import './chunk-LXCIXR5T.js';
 import './chunk-H34OXXJU.js';

package/dist/overlay.cjs

@@ -1,7 +1,7 @@
 'use client';
 'use strict';
 
-var chunkYACOHFYJ_cjs = require('./chunk-YACOHFYJ.cjs');
+var chunk2U7BHYIQ_cjs = require('./chunk-2U7BHYIQ.cjs');
 require('./chunk-KTLTYHAT.cjs');
 require('./chunk-XMXECSQO.cjs');
 require('./chunk-PO5DU3FU.cjs');
@@ -11,59 +11,59 @@ require('./chunk-SFU5EPSN.cjs');
 
 Object.defineProperty(exports, "AlertDialog", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.AlertDialog; }
+  get: function () { return chunk2U7BHYIQ_cjs.AlertDialog; }
 });
 Object.defineProperty(exports, "CommandPalette", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.CommandPalette; }
+  get: function () { return chunk2U7BHYIQ_cjs.CommandPalette; }
 });
 Object.defineProperty(exports, "ContextMenu", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.ContextMenu; }
+  get: function () { return chunk2U7BHYIQ_cjs.ContextMenu; }
 });
 Object.defineProperty(exports, "Dialog", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.Dialog; }
+  get: function () { return chunk2U7BHYIQ_cjs.Dialog; }
 });
 Object.defineProperty(exports, "DialogFooter", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.DialogFooter; }
+  get: function () { return chunk2U7BHYIQ_cjs.DialogFooter; }
 });
 Object.defineProperty(exports, "Drawer", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.Drawer; }
+  get: function () { return chunk2U7BHYIQ_cjs.Drawer; }
 });
 Object.defineProperty(exports, "DropdownMenu", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.DropdownMenu; }
+  get: function () { return chunk2U7BHYIQ_cjs.DropdownMenu; }
 });
 Object.defineProperty(exports, "HoverCard", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.HoverCard; }
+  get: function () { return chunk2U7BHYIQ_cjs.HoverCard; }
 });
 Object.defineProperty(exports, "Popover", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.Popover; }
+  get: function () { return chunk2U7BHYIQ_cjs.Popover; }
 });
 Object.defineProperty(exports, "PopoverContent", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.PopoverContent; }
+  get: function () { return chunk2U7BHYIQ_cjs.PopoverContent; }
 });
 Object.defineProperty(exports, "PopoverTrigger", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.PopoverTrigger; }
+  get: function () { return chunk2U7BHYIQ_cjs.PopoverTrigger; }
 });
 Object.defineProperty(exports, "Tooltip", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.Tooltip; }
+  get: function () { return chunk2U7BHYIQ_cjs.Tooltip; }
 });
 Object.defineProperty(exports, "TooltipProvider", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.TooltipProvider; }
+  get: function () { return chunk2U7BHYIQ_cjs.TooltipProvider; }
 });
 Object.defineProperty(exports, "useCommandShortcut", {
   enumerable: true,
-  get: function () { return chunkYACOHFYJ_cjs.useCommandShortcut; }
+  get: function () { return chunk2U7BHYIQ_cjs.useCommandShortcut; }
 });
 //# sourceMappingURL=overlay.cjs.map
 //# sourceMappingURL=overlay.cjs.map

package/dist/overlay.d.cts

@@ -229,18 +229,6 @@ interface DrawerProps {
  */
 declare function Drawer({ open, onOpenChange, side, title, description, size, footer, showClose, modal, dismissable, className, children, }: DrawerProps): react.JSX.Element | null;
 
-/**
- * Menus — dropdown and context.
- *
- * Data-driven (`items={[…]}`) rather than compound. Menus are almost always built from a
- * configuration array anyway — permissions filter entries, a selection decides what's enabled — and
- * expressing that as JSX children means `{canDelete && <MenuItem …/>}` scattered through the tree,
- * which breaks keyboard navigation indices in ways that are painful to debug.
- *
- * Follows the ARIA menu pattern, where **DOM focus moves to the item** (unlike a listbox, which
- * keeps focus on the container). That's what makes Right/Left arrow submenu traversal work the way
- * it does in every desktop application.
- */
 interface MenuItemBase {
     id?: string;
     disabled?: boolean;
@@ -284,6 +272,19 @@ type MenuEntry = MenuAction | MenuCheckbox | MenuRadioGroup | MenuSubmenu | {
     type: 'label';
     label: ReactNode;
 };
+
+/**
+ * Menus — dropdown and context.
+ *
+ * Data-driven (`items={[…]}`) rather than compound. Menus are almost always built from a
+ * configuration array anyway — permissions filter entries, a selection decides what's enabled — and
+ * expressing that as JSX children means `{canDelete && <MenuItem …/>}` scattered through the tree,
+ * which breaks keyboard navigation indices in ways that are painful to debug.
+ *
+ * Follows the ARIA menu pattern, where **DOM focus moves to the item** (unlike a listbox, which
+ * keeps focus on the container). That's what makes Right/Left arrow submenu traversal work the way
+ * it does in every desktop application.
+ */
 interface MenuProps {
     items: readonly MenuEntry[];
     placement?: Placement;
@@ -309,6 +310,7 @@ interface MenuProps {
  * ```
  */
 declare function DropdownMenu({ items, placement, label, className, children, open: controlledOpen, onOpenChange, }: MenuProps): react.JSX.Element;
+
 interface ContextMenuProps {
     items: readonly MenuEntry[];
     label?: string;

package/dist/overlay.d.ts

@@ -229,18 +229,6 @@ interface DrawerProps {
  */
 declare function Drawer({ open, onOpenChange, side, title, description, size, footer, showClose, modal, dismissable, className, children, }: DrawerProps): react.JSX.Element | null;
 
-/**
- * Menus — dropdown and context.
- *
- * Data-driven (`items={[…]}`) rather than compound. Menus are almost always built from a
- * configuration array anyway — permissions filter entries, a selection decides what's enabled — and
- * expressing that as JSX children means `{canDelete && <MenuItem …/>}` scattered through the tree,
- * which breaks keyboard navigation indices in ways that are painful to debug.
- *
- * Follows the ARIA menu pattern, where **DOM focus moves to the item** (unlike a listbox, which
- * keeps focus on the container). That's what makes Right/Left arrow submenu traversal work the way
- * it does in every desktop application.
- */
 interface MenuItemBase {
     id?: string;
     disabled?: boolean;
@@ -284,6 +272,19 @@ type MenuEntry = MenuAction | MenuCheckbox | MenuRadioGroup | MenuSubmenu | {
     type: 'label';
     label: ReactNode;
 };
+
+/**
+ * Menus — dropdown and context.
+ *
+ * Data-driven (`items={[…]}`) rather than compound. Menus are almost always built from a
+ * configuration array anyway — permissions filter entries, a selection decides what's enabled — and
+ * expressing that as JSX children means `{canDelete && <MenuItem …/>}` scattered through the tree,
+ * which breaks keyboard navigation indices in ways that are painful to debug.
+ *
+ * Follows the ARIA menu pattern, where **DOM focus moves to the item** (unlike a listbox, which
+ * keeps focus on the container). That's what makes Right/Left arrow submenu traversal work the way
+ * it does in every desktop application.
+ */
 interface MenuProps {
     items: readonly MenuEntry[];
     placement?: Placement;
@@ -309,6 +310,7 @@ interface MenuProps {
  * ```
  */
 declare function DropdownMenu({ items, placement, label, className, children, open: controlledOpen, onOpenChange, }: MenuProps): react.JSX.Element;
+
 interface ContextMenuProps {
     items: readonly MenuEntry[];
     label?: string;

package/dist/overlay.js

@@ -1,5 +1,5 @@
 'use client';
-export { AlertDialog, CommandPalette, ContextMenu, Dialog, DialogFooter, Drawer, DropdownMenu, HoverCard, Popover, PopoverContent, PopoverTrigger, Tooltip, TooltipProvider, useCommandShortcut } from './chunk-CWYBOVCZ.js';
+export { AlertDialog, CommandPalette, ContextMenu, Dialog, DialogFooter, Drawer, DropdownMenu, HoverCard, Popover, PopoverContent, PopoverTrigger, Tooltip, TooltipProvider, useCommandShortcut } from './chunk-RGGNLAAA.js';
 import './chunk-742E5FQS.js';
 import './chunk-XEP6P7E6.js';
 import './chunk-LXCIXR5T.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ansh-ui/react",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Ansh for React and Next.js — premium animated components and motion hooks.",
   "license": "MIT",
   "type": "module",
@@ -74,8 +74,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ansh-ui/core": "0.3.0",
-    "@ansh-ui/tokens": "0.3.0"
+    "@ansh-ui/core": "0.3.1",
+    "@ansh-ui/tokens": "0.3.1"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0",