@danxbot/ui 15.16.1 → 15.18.0

package/dist/types/components/Dialog.d.ts

@@ -108,7 +108,7 @@ export declare function Dialog({ trigger, open, onOpenChange, title, description
 export declare function DialogClose({ children }: {
     children: ReactNode;
 }): import("react").JSX.Element;
-export interface AlertDialogProps {
+interface AlertDialogBaseProps {
     trigger?: ReactNode;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
@@ -116,13 +116,30 @@ export interface AlertDialogProps {
     description?: ReactNode;
     confirmLabel?: string;
     cancelLabel?: string;
-    /** Styles the confirm button as destructive. */
-    destructive?: boolean;
     loading?: boolean;
     onConfirm?: () => void;
     className?: string;
     ref?: Ref<HTMLDivElement>;
 }
+/**
+ * The severity of what the dialog asks.
+ *
+ * `destructive` and `tone="warning"` are different questions and cannot both be
+ * true, so the type refuses the pair rather than letting one silently win:
+ *   - `destructive` — "this cannot be undone": a red medallion and a red confirm.
+ *   - `tone="warning"` — "this can be done, but not in the state things are in
+ *     right now" (promote docs before the plan is complete): an amber
+ *     medallion and an amber confirm, with the caller's description saying what
+ *     may go wrong. Reversible, so the confirm is not red; unusual, so it is not
+ *     the plain accent either.
+ */
+export type AlertDialogProps = AlertDialogBaseProps & ({
+    destructive: true;
+    tone?: never;
+} | {
+    destructive?: false;
+    tone?: "default" | "warning";
+});
 /**
  * A dialog that must be answered — no outside click, no Escape.
  *
@@ -131,5 +148,5 @@ export interface AlertDialogProps {
  * the pointer travelling in from the panel's content reaches the safe option
  * before the destructive one, and keyboard focus lands on cancel by default.
  */
-export declare function AlertDialog({ trigger, open, onOpenChange, title, description, confirmLabel, cancelLabel, destructive, loading, onConfirm, className, ref, }: AlertDialogProps): import("react").JSX.Element;
+export declare function AlertDialog({ trigger, open, onOpenChange, title, description, confirmLabel, cancelLabel, destructive, tone, loading, onConfirm, className, ref, }: AlertDialogProps): import("react").JSX.Element;
 export {};

package/dist/types/components/IconStack.d.ts

@@ -0,0 +1,28 @@
+import type { HTMLAttributes, Ref } from "react";
+import { type IconName } from "./Icon";
+export type IconStackTone = "neutral" | "accent" | "success" | "warning" | "danger" | "info" | "muted";
+export interface IconStackBadge {
+    icon: IconName;
+    tone?: IconStackTone;
+}
+export interface IconStackItem {
+    icon: IconName;
+    tone?: IconStackTone;
+    /**
+     * The fact is ABSENT: a dashed, quiet outline in place of the filled chip.
+     * `tone` is ignored — an absent mark is always the muted one.
+     */
+    empty?: boolean;
+    /** A smaller mark pinned to this chip's bottom-right corner. */
+    badge?: IconStackBadge;
+}
+export type IconStackSize = "sm" | "md" | "lg";
+export interface IconStackProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children" | "aria-label"> {
+    /** Marks in paint order: the LAST one is on top. At least one. */
+    items: readonly IconStackItem[];
+    /** The whole combination, in words. REQUIRED — the marks carry no text. */
+    label: string;
+    size?: IconStackSize;
+    ref?: Ref<HTMLSpanElement>;
+}
+export declare function IconStack({ items, label, size, className, ref, ...props }: IconStackProps): import("react").JSX.Element;

package/dist/types/components/Menu.d.ts

@@ -21,15 +21,15 @@ export interface MenuProps {
 }
 export declare function Menu({ trigger, side, align, open, onOpenChange, className, children, }: MenuProps): import("react").JSX.Element;
 /**
- * Neutral, or destructive.
+ * Neutral, destructive, or a caution.
  *
- * The same two-value union `IconButtonTone` declares, and named to match it
- * rather than to be exhaustive: a menu row is not a palette, and every tone
- * beyond "this one deletes something" would be a colour choice rather than a
- * property of the action. `Badge` has seven because a badge's whole job is to
- * carry a state; a menu item's job is to be picked.
+ * Not a palette: a menu row is picked, not read, so each tone beyond neutral
+ * is a property of the ACTION. `danger` says "this deletes something";
+ * `warning` says "this works, but not in the state the thing is in right
+ * now" (promote docs before the plan is complete, publish a draft). `Badge`
+ * has seven because a badge's whole job is to carry a state.
  */
-export type MenuItemTone = "neutral" | "danger";
+export type MenuItemTone = "neutral" | "danger" | "warning";
 export interface MenuItemProps extends Omit<BaseMenu.Item.Props, "className"> {
     className?: string;
     /**
@@ -70,9 +70,16 @@ export interface MenuItemProps extends Omit<BaseMenu.Item.Props, "className"> {
      * being the current choice in the first place.
      */
     tone?: MenuItemTone;
+    /**
+     * A second, quieter line saying what picking the row DOES (or why it is
+     * cautioned) — shown under the label, like `MenuCheckboxItem.description`.
+     * Without it a caller hand-builds a two-line `children` stack, and the row's
+     * icon (absolutely positioned for a one-line row) stops lining up with it.
+     */
+    description?: ReactNode;
     ref?: Ref<HTMLDivElement>;
 }
-export declare function MenuItem({ className, icon, selected, tone, children, ref, ...props }: MenuItemProps): import("react").JSX.Element;
+export declare function MenuItem({ className, icon, selected, tone, description, children, ref, ...props }: MenuItemProps): import("react").JSX.Element;
 export interface MenuRadioGroupProps extends Omit<BaseMenu.RadioGroup.Props, "className"> {
     className?: string;
 }
@@ -83,6 +90,35 @@ export interface MenuRadioItemProps extends Omit<BaseMenu.RadioItem.Props, "clas
     ref?: Ref<HTMLDivElement>;
 }
 export declare function MenuRadioItem({ className, children, ref, ...props }: MenuRadioItemProps): import("react").JSX.Element;
+export interface MenuCheckboxItemProps extends Omit<BaseMenu.CheckboxItem.Props, "className"> {
+    className?: string;
+    /** Leading icon — same slot, and same reason it is a prop, as `MenuItem.icon`. */
+    icon?: ReactNode;
+    /**
+     * A second, quieter line saying what the toggle DOES — shown under the label.
+     * A switch row that cannot say what it controls sends the reader to a help
+     * page; one line here is the whole help page.
+     */
+    description?: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+}
+/**
+ * An independent on/off setting inside a menu.
+ *
+ * A `MenuItem` is an ACTION and closes the menu when picked; a setting that is
+ * flipped three at a time must not. Base UI's checkbox item keeps the menu open
+ * (`closeOnClick` defaults to `false` here, not by our choice) and announces
+ * itself as `menuitemcheckbox` with `aria-checked`, which a `MenuItem` carrying
+ * a hand-drawn tick cannot — that is the reason this is its own row and not a
+ * `selected` `MenuItem`.
+ *
+ * The state is drawn as a small trailing switch rather than a leading tick:
+ * every other row in the same popup puts its icon on the left, and a tick there
+ * reads as "this is the current choice among alternatives" (`MenuRadioItem`),
+ * not "this is on". The track is fill AND thumb position, so on/off survives
+ * the loss of colour.
+ */
+export declare function MenuCheckboxItem({ className, icon, description, children, ref, ...props }: MenuCheckboxItemProps): import("react").JSX.Element;
 export interface MenuGroupProps {
     /**
      * The group's heading. A prop rather than a child component, so a label

package/dist/types/icons/data.d.ts

@@ -355,6 +355,9 @@ export declare const coreIcons: {
     readonly "loader-circle": readonly [readonly ["path", {
         readonly d: "M21 12a9 9 0 1 1-6.219-8.56";
     }]];
+    readonly shield: readonly [readonly ["path", {
+        readonly d: "M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z";
+    }]];
     readonly "shield-check": readonly [readonly ["path", {
         readonly d: "M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z";
     }], readonly ["path", {
@@ -381,6 +384,11 @@ export declare const coreIcons: {
     }], readonly ["path", {
         readonly d: "M8.668 3.01A6 6 0 0 1 18 8c0 2.687.77 4.653 1.707 6.05";
     }]];
+    readonly "book-open": readonly [readonly ["path", {
+        readonly d: "M12 7v14";
+    }], readonly ["path", {
+        readonly d: "M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z";
+    }]];
     readonly bookmark: readonly [readonly ["path", {
         readonly d: "m19 21-7-4-7 4V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2v16z";
     }]];

package/dist/types/index.d.ts

@@ -38,7 +38,7 @@ export { TriStateSwitch, type TriStateSwitchProps, type TriStateSwitchSize, } fr
 export { Dialog, DialogClose, AlertDialog, type DialogProps, type AlertDialogProps, } from "./components/Dialog";
 export { Popover, PopoverClose, Tooltip, TooltipProvider, type PopoverProps, type TooltipProps, } from "./components/Popover";
 export { Toaster, ToastProvider, useToast, type ToasterProps, type ToastProviderProps, type ToastOptions, type ToastTone, } from "./components/Toast";
-export { Menu, MenuItem, MenuGroup, MenuRadioGroup, MenuRadioItem, MenuSeparator, type MenuProps, type MenuItemProps, type MenuItemTone, type MenuGroupProps, type MenuRadioGroupProps, type MenuRadioItemProps, } from "./components/Menu";
+export { Menu, MenuItem, MenuGroup, MenuRadioGroup, MenuRadioItem, MenuCheckboxItem, MenuSeparator, type MenuProps, type MenuItemProps, type MenuItemTone, type MenuGroupProps, type MenuRadioGroupProps, type MenuRadioItemProps, type MenuCheckboxItemProps, } from "./components/Menu";
 export { ThemeMenu, type ThemeMenuProps } from "./components/ThemeMenu";
 export { AppShell, type AppShellProps, type NavItem, type NavSection, } from "./components/AppShell";
 export { FileUpload, type FileUploadProps, type UploadFile } from "./components/FileUpload";
@@ -72,6 +72,7 @@ export { DataTable, TableEmptyState, CellStack, type DataTableProps, type TableD
 export { CodeEditor, CodeEditorToolbar, CodeEditorCaption, CodeEditorCopyButton, CodeEditorWrapToggle, CodeEditorViewSwitch, type CodeEditorProps, type CodeEditorToolbarProps, type CodeEditorView, } from "./components/CodeEditor";
 export { Markdown, CodeBlock, type MarkdownProps, type CodeBlockProps } from "./components/Markdown";
 export { LineDiff, type LineDiffProps } from "./components/LineDiff";
+export { IconStack, type IconStackProps, type IconStackItem, type IconStackBadge, type IconStackTone, type IconStackSize, } from "./components/IconStack";
 export { MarkdownEditor, type MarkdownEditorProps, type MarkdownEditorHandle, } from "./components/MarkdownEditor";
 export { ReadMore, type ReadMoreProps } from "./components/ReadMore";
 export { MarkdownSurface, type SurfaceOptions, type Splice } from "./lib/markdown/surface";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "15.16.1",
+  "version": "15.18.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",