@alexgorbatchev/shadcn 0.0.46 → 0.0.48

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 export { Button, buttonVariants } from "./components/Button.js";
 export { ButtonLink } from "./components/ButtonLink.js";
 export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, } from "./components/DropdownMenu.js";
+export { ActionsMenu, ActionsMenuTrigger, ActionsMenuContextTarget, ActionsMenuContextContent, } from "./components/ActionsMenu.js";
+export type { IActionsMenuProps, ActionsMenuTriggerProps } from "./components/ActionsMenu.js";
+export { MenuGroup, MenuLabel, MenuLinkItem, MenuItem, MenuCheckboxItem, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuShortcut, MenuSub, MenuSubTrigger, MenuSubContent, } from "./components/MenuParts.js";
+export { FormDialog } from "./components/FormDialog.js";
 export { Accordion, AccordionItem, AccordionTrigger, AccordionContent } from "./components/Accordion.js";
 export { Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, } from "./components/Popover.js";
 export { Skeleton } from "./components/Skeleton.js";

package/dist/index.js

@@ -1,5 +1,14 @@
 import {
   ButtonLink2,
+  ContextMenu2,
+  ContextMenuPortal2,
+  ContextMenuTrigger2,
+  ContextMenuContent2,
+  ActionsMenu2,
+  ActionsMenuTrigger2,
+  ActionsMenuContextTarget2,
+  ActionsMenuContextContent2,
+  FormDialog2,
   Accordion2,
   AccordionItem2,
   AccordionTrigger2,
@@ -76,21 +85,6 @@ import {
   DrawerFooter2,
   DrawerTitle2,
   DrawerDescription2,
-  ContextMenu2,
-  ContextMenuPortal2,
-  ContextMenuTrigger2,
-  ContextMenuContent2,
-  ContextMenuGroup2,
-  ContextMenuLabel2,
-  ContextMenuItem2,
-  ContextMenuSub2,
-  ContextMenuSubTrigger2,
-  ContextMenuSubContent2,
-  ContextMenuCheckboxItem2,
-  ContextMenuRadioGroup2,
-  ContextMenuRadioItem2,
-  ContextMenuSeparator2,
-  ContextMenuShortcut2,
   Menubar2,
   MenubarMenu2,
   MenubarGroup2,
@@ -178,7 +172,7 @@ import {
   StatusTracker2,
   DashboardLayout2,
   BillingUsage2
-} from "./chunk-0qgd06td.js";
+} from "./chunk-svr3r7pj.js";
 import {
   Tabs2,
   tabsListVariants2,
@@ -203,6 +197,8 @@ import {
   ToolbarSeparator2
 } from "./chunk-x6vx0v6d.js";
 import {
+  ScrollArea2,
+  ScrollBar2,
   Combobox2,
   ComboboxValue2,
   ComboboxTrigger2,
@@ -219,8 +215,6 @@ import {
   ComboboxChip2,
   ComboboxChipsInput2,
   useComboboxAnchor2,
-  ScrollArea2,
-  ScrollBar2,
   NumberField2,
   NumberFieldGroup2,
   NumberFieldInput2,
@@ -228,7 +222,7 @@ import {
   NumberFieldIncrement2,
   NumberFieldScrubArea2,
   NumberFieldScrubAreaCursor2
-} from "./chunk-p1eqxz4v.js";
+} from "./chunk-a6mes7w0.js";
 import {
   NativeSelect2,
   NativeSelectOption2,
@@ -238,22 +232,23 @@ import {
   Slider2
 } from "./chunk-2mn2ctsk.js";
 import {
+  MenuPortal,
+  MenuPopup,
+  MenuGroup2,
+  MenuLabel2,
+  MenuItem2,
+  MenuLinkItem2,
+  MenuSub2,
+  MenuSubTrigger2,
+  MenuSubContent2,
+  MenuCheckboxItem2,
+  MenuRadioGroup2,
+  MenuRadioItem2,
+  MenuSeparator2,
+  MenuShortcut2,
   DropdownMenu2,
-  DropdownMenuPortal2,
-  DropdownMenuTrigger2,
-  DropdownMenuContent2,
-  DropdownMenuGroup2,
-  DropdownMenuLabel2,
-  DropdownMenuItem2,
-  DropdownMenuSub2,
-  DropdownMenuSubTrigger2,
-  DropdownMenuSubContent2,
-  DropdownMenuCheckboxItem2,
-  DropdownMenuRadioGroup2,
-  DropdownMenuRadioItem2,
-  DropdownMenuSeparator2,
-  DropdownMenuShortcut2
-} from "./chunk-8wc2z7te.js";
+  DropdownMenuTrigger2
+} from "./chunk-cfnkbp0y.js";
 import {
   Empty2,
   EmptyHeader2,
@@ -466,6 +461,10 @@ export {
   AccordionItem2 as AccordionItem,
   AccordionTrigger2 as AccordionTrigger,
   AccountMenu2 as AccountMenu,
+  ActionsMenu2 as ActionsMenu,
+  ActionsMenuContextContent2 as ActionsMenuContextContent,
+  ActionsMenuContextTarget2 as ActionsMenuContextTarget,
+  ActionsMenuTrigger2 as ActionsMenuTrigger,
   Alert2 as Alert,
   AlertAction2 as AlertAction,
   AlertDescription2 as AlertDescription,
@@ -547,19 +546,19 @@ export {
   ComboboxValue2 as ComboboxValue,
   ConfirmationDialog2 as ConfirmationDialog,
   ContextMenu2 as ContextMenu,
-  ContextMenuCheckboxItem2 as ContextMenuCheckboxItem,
+  MenuCheckboxItem2 as ContextMenuCheckboxItem,
   ContextMenuContent2 as ContextMenuContent,
-  ContextMenuGroup2 as ContextMenuGroup,
-  ContextMenuItem2 as ContextMenuItem,
-  ContextMenuLabel2 as ContextMenuLabel,
+  MenuGroup2 as ContextMenuGroup,
+  MenuItem2 as ContextMenuItem,
+  MenuLabel2 as ContextMenuLabel,
   ContextMenuPortal2 as ContextMenuPortal,
-  ContextMenuRadioGroup2 as ContextMenuRadioGroup,
-  ContextMenuRadioItem2 as ContextMenuRadioItem,
-  ContextMenuSeparator2 as ContextMenuSeparator,
-  ContextMenuShortcut2 as ContextMenuShortcut,
-  ContextMenuSub2 as ContextMenuSub,
-  ContextMenuSubContent2 as ContextMenuSubContent,
-  ContextMenuSubTrigger2 as ContextMenuSubTrigger,
+  MenuRadioGroup2 as ContextMenuRadioGroup,
+  MenuRadioItem2 as ContextMenuRadioItem,
+  MenuSeparator2 as ContextMenuSeparator,
+  MenuShortcut2 as ContextMenuShortcut,
+  MenuSub2 as ContextMenuSub,
+  MenuSubContent2 as ContextMenuSubContent,
+  MenuSubTrigger2 as ContextMenuSubTrigger,
   ContextMenuTrigger2 as ContextMenuTrigger,
   DashboardLayout2 as DashboardLayout,
   DataViewer2 as DataViewer,
@@ -591,19 +590,19 @@ export {
   DrawerTrigger2 as DrawerTrigger,
   DropTarget2 as DropTarget,
   DropdownMenu2 as DropdownMenu,
-  DropdownMenuCheckboxItem2 as DropdownMenuCheckboxItem,
-  DropdownMenuContent2 as DropdownMenuContent,
-  DropdownMenuGroup2 as DropdownMenuGroup,
-  DropdownMenuItem2 as DropdownMenuItem,
-  DropdownMenuLabel2 as DropdownMenuLabel,
-  DropdownMenuPortal2 as DropdownMenuPortal,
-  DropdownMenuRadioGroup2 as DropdownMenuRadioGroup,
-  DropdownMenuRadioItem2 as DropdownMenuRadioItem,
-  DropdownMenuSeparator2 as DropdownMenuSeparator,
-  DropdownMenuShortcut2 as DropdownMenuShortcut,
-  DropdownMenuSub2 as DropdownMenuSub,
-  DropdownMenuSubContent2 as DropdownMenuSubContent,
-  DropdownMenuSubTrigger2 as DropdownMenuSubTrigger,
+  MenuCheckboxItem2 as DropdownMenuCheckboxItem,
+  MenuPopup as DropdownMenuContent,
+  MenuGroup2 as DropdownMenuGroup,
+  MenuItem2 as DropdownMenuItem,
+  MenuLabel2 as DropdownMenuLabel,
+  MenuPortal as DropdownMenuPortal,
+  MenuRadioGroup2 as DropdownMenuRadioGroup,
+  MenuRadioItem2 as DropdownMenuRadioItem,
+  MenuSeparator2 as DropdownMenuSeparator,
+  MenuShortcut2 as DropdownMenuShortcut,
+  MenuSub2 as DropdownMenuSub,
+  MenuSubContent2 as DropdownMenuSubContent,
+  MenuSubTrigger2 as DropdownMenuSubTrigger,
   DropdownMenuTrigger2 as DropdownMenuTrigger,
   Empty2 as Empty,
   EmptyContent2 as EmptyContent,
@@ -623,6 +622,7 @@ export {
   FieldSet2 as FieldSet,
   FieldTitle2 as FieldTitle,
   FilterBar2 as FilterBar,
+  FormDialog2 as FormDialog,
   HoverCard2 as HoverCard,
   HoverCardContent2 as HoverCardContent,
   HoverCardTrigger2 as HoverCardTrigger,
@@ -654,6 +654,18 @@ export {
   Marker2 as Marker,
   MarkerContent2 as MarkerContent,
   MarkerIcon2 as MarkerIcon,
+  MenuCheckboxItem2 as MenuCheckboxItem,
+  MenuGroup2 as MenuGroup,
+  MenuItem2 as MenuItem,
+  MenuLabel2 as MenuLabel,
+  MenuLinkItem2 as MenuLinkItem,
+  MenuRadioGroup2 as MenuRadioGroup,
+  MenuRadioItem2 as MenuRadioItem,
+  MenuSeparator2 as MenuSeparator,
+  MenuShortcut2 as MenuShortcut,
+  MenuSub2 as MenuSub,
+  MenuSubContent2 as MenuSubContent,
+  MenuSubTrigger2 as MenuSubTrigger,
   Menubar2 as Menubar,
   MenubarCheckboxItem2 as MenubarCheckboxItem,
   MenubarContent2 as MenubarContent,

package/dist/menu/types.d.ts

@@ -11,4 +11,7 @@ export type MenuItemProps = Menu.Item.Props & IMenuItemOptions;
 export type MenuSubTriggerProps = Menu.SubmenuTrigger.Props & IMenuInsetProps;
 export type MenuCheckboxItemProps = Menu.CheckboxItem.Props & IMenuInsetProps;
 export type MenuRadioItemProps = Menu.RadioItem.Props & IMenuInsetProps;
+export type MenuPopupProps = Menu.Popup.Props & Pick<Menu.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset"> & IDensityProps & {
+    width?: "content" | "anchor";
+};
 export {};

package/dist/prototype.js

@@ -2051,7 +2051,7 @@ var program = new Command;
 // package.json
 var package_default = {
   name: "@alexgorbatchev/shadcn",
-  version: "0.0.46",
+  version: "0.0.48",
   description: "Sharp, monospace React components with compact and comfortable densities.",
   license: "MIT",
   repository: {
@@ -3462,7 +3462,8 @@ var package_default = {
     "input-otp@1.5.0": "patches/input-otp@1.5.0.patch",
     "@vitest/coverage-istanbul@4.1.11": "patches/@vitest%2Fcoverage-istanbul@4.1.11.patch",
     "storybook@10.6.1": "patches/storybook@10.6.1.patch",
-    "uncontrollable@7.2.1": "patches/uncontrollable@7.2.1.patch"
+    "uncontrollable@7.2.1": "patches/uncontrollable@7.2.1.patch",
+    "@headless-tree/core@1.8.0": "patches/@headless-tree%2Fcore@1.8.0.patch"
   }
 };
 

package/llms/components/forms/InlineEdit.md

@@ -60,8 +60,41 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
 {
     args: {
         onCommit: async () => {
-            throw new Error("Could not save");
+            throw new Error("Private storage diagnostic");
         },
     }
 }
 ```
+
+### UnchangedEnter
+
+```tsx
+{
+    args: { hasChanges: false }
+}
+```
+
+### UnchangedBlur
+
+```tsx
+{
+    args: { hasChanges: false }
+}
+```
+
+### UnchangedCreate
+
+```tsx
+{}
+```
+
+### AuthoredValidationAndRetry
+
+```tsx
+{
+    args: {
+        onCommit: fn(),
+        renderError: () => "A title is required.",
+    }
+}
+```

package/llms/components/navigation/ActionsMenu.md

@@ -0,0 +1,143 @@
+# ActionsMenu
+
+Story: @alexgorbatchev/shadcn/navigation/ActionsMenu
+Source: src/components/stories/navigation/ActionsMenu.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/navigation/ActionsMenu.stories.tsx)
+
+## Public imports
+
+```tsx
+import { ActionsMenu, ActionsMenuContextTarget, ActionsMenuContextContent, ActionsMenuTrigger, MenuGroup, MenuItem, MenuLinkItem, MenuLabel, MenuSeparator, MenuSub, MenuSubContent, MenuSubTrigger, Button } from "@alexgorbatchev/shadcn";
+import { Tree, TreeItem, useTree, syncDataLoaderFeature, hotkeysCoreFeature, selectionFeature } from "@alexgorbatchev/shadcn/tree";
+```
+
+## Supporting imports
+
+```tsx
+import type { ReactElement } from "react";
+```
+
+## Default component
+
+```tsx
+ActionsMenu
+```
+
+## Default args
+
+```tsx
+{
+    label: "Track actions",
+    items: (<MenuGroup>
+        <MenuItem onClick={() => fixture_menuAction("track-42")}>Inspect track</MenuItem>
+      </MenuGroup>),
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### RegisteredTree
+
+```tsx
+{
+    render: () => <RegisteredTreeExample />
+}
+```
+
+### Dropdown
+
+```tsx
+{}
+```
+
+### BothEntryPoints
+
+```tsx
+{
+    args: { contextTarget: <section aria-label="Track"/> },
+    render: (args) => (<ActionsMenu {...args}>
+      <p>Selected track</p>
+      <ActionsMenuTrigger />
+    </ActionsMenu>)
+}
+```
+
+### NativeTableRow
+
+```tsx
+{
+    render: (args) => (<table>
+      <tbody>
+        <ActionsMenu {...args}>
+          <ActionsMenuContextTarget render={<tr ref={fixture_menuTargetRef}/>}>
+            <td>Track title</td>
+            <td>
+              <ActionsMenuTrigger />
+              <ActionsMenuContextContent />
+            </td>
+          </ActionsMenuContextTarget>
+        </ActionsMenu>
+      </tbody>
+    </table>)
+}
+```
+
+### Disabled
+
+```tsx
+{
+    args: { disabled: true, contextTarget: <section aria-label="Protected track"/> }
+}
+```
+
+### Submenu
+
+```tsx
+{
+    args: {
+        trigger: <Button variant="outline"/>,
+        contextTarget: <section aria-label="Playlist track"/>,
+        items: (<>
+        <MenuGroup>
+          <MenuLabel>Track</MenuLabel>
+          <MenuItem disabled>Unavailable action</MenuItem>
+        </MenuGroup>
+        <MenuSeparator />
+        <MenuGroup>
+          <MenuSub>
+            <MenuSubTrigger>Playlist</MenuSubTrigger>
+            <MenuSubContent>
+              <MenuGroup>
+                <MenuItem onClick={() => fixture_menuAction("playlist-7", "track-42")}>Add to favorites</MenuItem>
+              </MenuGroup>
+            </MenuSubContent>
+          </MenuSub>
+        </MenuGroup>
+      </>),
+    },
+    render: (args) => (<ActionsMenu {...args}>
+      <ActionsMenuTrigger>Track options</ActionsMenuTrigger>
+    </ActionsMenu>)
+}
+```
+
+### NativeLink
+
+```tsx
+{
+    args: {
+        size: "sm",
+        items: (<MenuGroup>
+        <MenuLinkItem href="#details" onClick={(event) => {
+                fixture_menuAction(event.currentTarget.hash);
+                event.preventDefault();
+            }}>
+          View details
+        </MenuLinkItem>
+      </MenuGroup>),
+    }
+}
+```

package/llms/components/overlays/ConfirmationDialog.md

@@ -70,8 +70,38 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
 {
     args: {
         onConfirm: async () => {
-            throw new Error("Could not remove image");
+            throw new Error("Private removal diagnostic");
         },
     }
 }
 ```
+
+### AuthoredFailureAndRetry
+
+```tsx
+{
+    args: {
+        onConfirm: fn(),
+        renderError: () => "The image is in use. Close the editor and retry.",
+    }
+}
+```
+
+### LongDescription
+
+```tsx
+{
+    args: { description: "Review this irreversible image removal carefully. ".repeat(300) }
+}
+```
+
+### Pending
+
+```tsx
+{
+    beforeEach: () => {
+        fixture_confirmation.pending = Promise.withResolvers<void>();
+    },
+    args: { onConfirm: fn(() => fixture_confirmation.pending.promise) }
+}
+```

package/llms/components/overlays/FormDialog.md

@@ -0,0 +1,102 @@
+# FormDialog
+
+Story: @alexgorbatchev/shadcn/components/overlays/FormDialog
+Source: src/components/stories/overlays/FormDialog.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/overlays/FormDialog.stories.tsx)
+
+## Public imports
+
+```tsx
+import { FormDialog, Input, Button } from "@alexgorbatchev/shadcn";
+```
+
+## Supporting imports
+
+```tsx
+import { useState, type ReactElement } from "react";
+```
+
+## Default component
+
+```tsx
+FormDialog
+```
+
+## Default args
+
+```tsx
+{
+    open: false,
+    onOpenChange: fn(),
+    title: "Edit project",
+    description: "Change the project name.",
+    submitLabel: "Save project",
+    onSubmit: fn((event) => event.preventDefault()),
+    children: <Input aria-label="Project name" defaultValue="Example"/>,
+}
+```
+
+## Default render
+
+```tsx
+function Example(args): ReactElement {
+    const [open, setOpen] = useState(false);
+    return (<>
+        <Button onClick={() => setOpen(true)}>Edit project</Button>
+        <FormDialog {...args} open={open} onOpenChange={(next) => {
+            args.onOpenChange(next);
+            setOpen(next);
+        }}/>
+      </>);
+}
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.
+
+### Submit
+
+```tsx
+{}
+```
+
+### Busy
+
+```tsx
+{
+    args: { isBusy: true }
+}
+```
+
+### ConsentOnly
+
+```tsx
+{
+    args: {
+        onSubmit: undefined,
+        submitLabel: undefined,
+        primaryAction: <Button onClick={fixture_formDialogAction}>Review changes</Button>,
+    }
+}
+```
+
+### DoneOnly
+
+```tsx
+{
+    args: { onSubmit: undefined, submitLabel: undefined, cancelLabel: "Done" }
+}
+```
+
+### LongContent
+
+```tsx
+{
+    args: {
+        children: Array.from({ length: 60 }, (_, index) => <p key={index}>Project detail {index + 1}</p>),
+        error: "Save failed. Retry after checking the project.",
+    }
+}
+```

package/llms/setup.md

@@ -71,7 +71,7 @@ Import shared controls and providers from `@alexgorbatchev/shadcn`. Import the f
 | `/file-upload`       | FileUpload selection and validation                                  | `bun add react-dropzone@^20.1.4`                                                                    |
 | `/color-picker`      | ColorPicker                                                          | `bun add react-colorful@^5.8.1`                                                                     |
 | `/image-crop`        | ImageCrop and native export helpers                                  | `bun add react-image-crop@^11.1.2`                                                                  |
-| `/tree`              | Tree, native hooks and features                                      | `bun add @headless-tree/core@^1.8.0 @headless-tree/react@^1.8.0`                                    |
+| `/tree`              | Tree, native hooks and features                                      | `bun add @headless-tree/core@^1.8.0 @headless-tree/react@^1.8.0`; patched runtimes are bundled      |
 | `/editor`            | RichTextEditor, native Tiptap hooks and StarterKit                   | `bun add @tiptap/core@^3.32.0 @tiptap/react@^3.32.0 @tiptap/pm@^3.32.0 @tiptap/starter-kit@^3.32.0` |
 | `/event-calendar`    | EventCalendar, EventForm and native calendar APIs                    | `bun add date-fns@^4.4.0`; TypeScript: `bun add -d @types/react-big-calendar@^1.16.3`               |
 | `/gantt`             | Gantt and Roadmap                                                    | `bun add date-fns@^4.4.0 @date-fns/tz@^1.5.0`                                                       |
@@ -86,7 +86,7 @@ import { ChartContainer, type ChartConfig } from "@alexgorbatchev/shadcn/chart";
 import { Carousel, CarouselContent, CarouselItem } from "@alexgorbatchev/shadcn/carousel";
 ```
 
-A production install of this package adds no third-party packages: every library is an optional peer that consumers install themselves, or is bundled into the package. Core peers are listed under Installation; feature peers are listed per entry point above. The patched `sonner`, `input-otp`, and `@shadcn/react` runtimes, and the calendar with its patched `uncontrollable` wrapper, are bundled so consumers receive the fixes even when their package manager does not apply Bun patches; consumers of those three entry points still install the upstream packages for the types the declarations reference; the calendar runtime stays isolated behind `/event-calendar`. Install `@base-ui/utils` at the exact version `@base-ui/react` requires, so the portal components share Base UI's own ref merging without a second copy. Shared providers work across entry points.
+A production install of this package adds no third-party packages: every library is an optional peer that consumers install themselves, or is bundled into the package. Core peers are listed under Installation; feature peers are listed per entry point above. The patched `sonner`, `input-otp`, `@shadcn/react`, and Headless Tree runtimes, and the calendar with its patched `uncontrollable` wrapper, are bundled so consumers receive the fixes even when their package manager does not apply Bun patches. Install their upstream peers for the types the declarations reference; the tree runtime stays behind `/tree` and the calendar runtime behind `/event-calendar`. Import tree hooks and features from this package's `/tree` entry point so they use the bundled native implementation. Install `@base-ui/utils` at the exact version `@base-ui/react` requires, so the portal components share Base UI's own ref merging without a second copy. Shared providers work across entry points.
 
 The optional assistant-ui catalog provides presentational families under `/assistant-ui/<family>` and runtime adapters under `/assistant-ui/native/<family>`. For example, import `ApprovalCard` from `@alexgorbatchev/shadcn/assistant-ui/approval-card`. Add `@alexgorbatchev/shadcn/assistant-ui.css` to your stylesheet. Native threads require an actual assistant-ui runtime and the selected family's optional peers. See the [assistant-ui reference](https://github.com/alexgorbatchev/shadcn/blob/main/docs/internal/assistant-ui.md) for imports, dependency-bearing styles, source inventory, and the SelectionToolbar isolation limitation.
 
@@ -360,7 +360,7 @@ Compose `QuestionnaireItem`, `QuestionnaireTitle`, and answer controls inside `Q
 
 # Inline editing and ratings
 
-`InlineEdit` mounts an edit session with a controlled `value`, `onValueChange`, `onCommit`, and `onCancel`. Mount it in place of the displayed label. Its input focuses and selects its text by default; `shouldSelectOnMount={false}` preserves the initial caret. Enter or blur commits once, Escape cancels without committing, and asynchronous saves disable the input until completion. Rejected saves display an error and allow retry.
+`InlineEdit` mounts an edit session with a controlled `value`, `onValueChange`, `onCommit`, and `onCancel`. Mount it in place of the displayed label. Its input focuses and selects its text by default; `shouldSelectOnMount={false}` preserves the initial caret. Enter or blur commits once, Escape cancels without committing, and asynchronous saves disable the input until completion. Set `hasChanges={false}` to cancel an unchanged edit before calling `onCommit`; the caller owns normalization and comparison. It defaults to true, so creation sessions can commit their initial value. Rejected saves display a generic error and allow retry; `renderError` can map the unknown failure to application-authored guidance.
 
 `VirtualTable` renders a bounded, dynamically measured set of native table rows using TanStack Virtual. Supply `items`, stable `getItemKey`, `header`, `label`, and `renderRow`; spread the supplied measurement props onto each native row. Optional `columns` accepts a `TableColumnGroup`; responsive columns keep their widths aligned with cells that share their `visibleFrom`. `maxHeight` defaults to `65vh`, `estimateRowHeight` to 80 pixels, and `overscan` to five rows. `retainedKeys` keeps editing rows mounted; the focused row is retained automatically. Filtering and selection belong to the consumer.
 
@@ -370,17 +370,25 @@ Column `meta.filter` offers a column in `DataGridFilters`, hidden columns includ
 
 Import `DataGridSelectHeader` and `DataGridSelectCell` from `@alexgorbatchev/shadcn/data-grid`. Pass the current `useTable` result as `table` to both controls, and pass `row` and an accessible `label` to each cell. The header selects selectable filtered rows across all pages and preserves selections hidden by filters. It shows a mixed state when some of those rows are selected and disables itself when none are selectable. Its default label is "Select all filtered rows"; provide `label` to name the scope in your application. Cells follow native row selection rules, including disabled rows and partially selected parents. The controls observe selection changes without requiring the parent table selector to include selection state.
 
+`ActionsMenu` shares one `items` definition between a dropdown action and an optional context menu. Supply an accessible `label`; the default trigger is a ghost icon button. `size="sm"` displays the label, and `variant`, `disabled`, and `trigger` customize the action. Supplying `contextTarget` composes the native context trigger with that element and adds its popup. Compose items with `MenuItem`, `MenuLinkItem`, checkbox/radio parts, groups, labels, separators, shortcuts, and submenu parts; dropdown and context menus share these implementations. `MenuLinkItem` retains its native anchor and menu keyboard semantics.
+
+For nested layouts, compose `ActionsMenuTrigger`, `ActionsMenuContextTarget`, and `ActionsMenuContextContent` explicitly inside `ActionsMenu`. The dropdown trigger owns its local native dropdown root and popup; the context target and content share an independent context root. A tree row can use `TreeItem render={<ActionsMenuContextTarget />}` and put the trigger in its action slot. For a table row, render the context target as the actual `tr`, then place the dropdown trigger and context content inside a `td`: native popup portals insert focus guards at their declaration, which must remain valid table children.
+
 `TreeItem linkProps` places the registered tree item, roving focus, and native drag handlers on an anchor. Pass `href` and anchor events directly, or compose a router link through `linkProps.render`. The outer `render` and `ref` remain available for row overlays; disclosure and `endEnhancer` controls remain siblings of the link. Enter and modified clicks retain native link behavior, while tree arrows retain navigation and expansion behavior. Optional `dropHint={{ content, open, side }}` displays caller-controlled drag feedback without adding a focus target.
 
+Embedded actions, links, menus, editable fields, and media controls retain their own keyboard behavior. Registered anchor and button rows still participate in tree navigation; rename and search inputs retain their completion and cancellation shortcuts.
+
 `PageHeader` accepts an optional `eyebrow` above its single page title. It accepts any React content without introducing another heading. Breadcrumbs, description, actions, and density remain independent slots; long action content wraps within narrow layouts.
 
 `StarRating` takes a controlled numeric `value` from 0 to 5, `onValueChange`, and an accessible `label`. Its native radio buttons support keyboard selection and an Unrated option to clear the rating. Set `disabled` while saving. `Avatar shape="square"` displays square artwork with matching image, fallback, and border corners.
 
 `DialogContent size="wide"` uses a desktop maximum width of 576px; `size="narrow"` uses 192px, and the default uses 384px. Dialogs remain bounded by the viewport. `FieldGroup columns={2}` arranges fields in two columns on desktop and one on mobile.
 
+`FormDialog` supplies a controlled dialog with a fixed heading and footer around a scrolling body. Supply `open`, `onOpenChange`, `title`, and children; `description`, `size`, and `density` are optional. With `onSubmit`, the body and actions use a native form: the caller handles `preventDefault`, validation, submission, and pending state. `submitLabel` adds the stock submit button, with optional `submitVariant` and `submitDisabled`; `primaryAction` supplies a custom action instead. Without `onSubmit`, custom actions can request consent without introducing a form. Without a primary action, `cancelLabel="Done"` gives a close-only footer. `isBusy` blocks native dismissal and disables the stock actions; callers disable their own inputs and custom actions. Pass already-rendered safe guidance through `error`.
+
 `ImagePicker` displays a 256px square preview with upload and unset buttons. Supply the existing `src`, a staged `file` (`undefined` for the existing image, `null` for removal), and `onFileChange`/`onClear` callbacks. It accepts PNG, JPEG, and GIF files and releases local preview URLs when they change or unmount. The consumer owns saving and removal confirmation.
 
-`ConfirmationDialog` uses an alert dialog with Cancel and a destructive confirmation button. Supply `open`, `onOpenChange`, `title`, `description`, `confirmLabel`, and `onConfirm`. It waits for asynchronous work, keeps the dialog open on failure, and prevents cancellation while that work is pending.
+`ConfirmationDialog` uses an alert dialog with Cancel and a destructive confirmation button. Supply `open`, `onOpenChange`, `title`, `description`, `confirmLabel`, and `onConfirm`. It waits for asynchronous work, keeps the dialog open on failure, and prevents cancellation while that work is pending. Its body scrolls within the viewport while the heading and actions stay visible. Failures display generic guidance by default; `renderError` maps unknown failures to application-authored messages.
 
 # Split views
 

package/llms.txt

@@ -431,6 +431,7 @@ Generated from the public package exports and Storybook sources.
 ## navigation
 
 - [AccountMenu](./llms/components/navigation/AccountMenu.md)
+- [ActionsMenu](./llms/components/navigation/ActionsMenu.md)
 - [Breadcrumb](./llms/components/navigation/Breadcrumb.md)
 - [Command](./llms/components/navigation/Command.md)
 - [ContextMenu](./llms/components/navigation/ContextMenu.md)
@@ -449,6 +450,7 @@ Generated from the public package exports and Storybook sources.
 - [ConfirmationDialog](./llms/components/overlays/ConfirmationDialog.md)
 - [Dialog](./llms/components/overlays/Dialog.md)
 - [Drawer](./llms/components/overlays/Drawer.md)
+- [FormDialog](./llms/components/overlays/FormDialog.md)
 - [HoverCard](./llms/components/overlays/HoverCard.md)
 - [Popover](./llms/components/overlays/Popover.md)
 - [Sheet](./llms/components/overlays/Sheet.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexgorbatchev/shadcn",
-  "version": "0.0.46",
+  "version": "0.0.48",
   "description": "Sharp, monospace React components with compact and comfortable densities.",
   "license": "MIT",
   "repository": {