@danxbot/ui 15.17.0 → 15.19.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/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;
 }
@@ -93,6 +100,18 @@ export interface MenuCheckboxItemProps extends Omit<BaseMenu.CheckboxItem.Props,
      * page; one line here is the whole help page.
      */
     description?: ReactNode;
+    /**
+     * Draws the state in place of the trailing switch.
+     *
+     * For a setting whose on/off is better said by a meaningful glyph than by a
+     * generic track and thumb - a plan's sign-off, say: a filled check when signed,
+     * an empty "not approved" mark when not. The caller hands in the glyph for the
+     * CURRENT state (it already holds `checked`); the switch is then not drawn at
+     * all, so the row never states its state twice. The row stays a
+     * `menuitemcheckbox` carrying `aria-checked`, which is what assistive tech
+     * reads - the indicator is decoration and is hidden from it.
+     */
+    indicator?: ReactNode;
     ref?: Ref<HTMLDivElement>;
 }
 /**
@@ -111,7 +130,7 @@ export interface MenuCheckboxItemProps extends Omit<BaseMenu.CheckboxItem.Props,
  * 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 declare function MenuCheckboxItem({ className, icon, description, indicator, 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/package.json

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