@danxbot/ui 17.0.0 → 18.1.0

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

@@ -404,10 +404,11 @@ interface ProgressRingBase extends VariantProps<typeof ring> {
      */
     label: string;
     /**
-     * DX-4062 — opt-in done state: at 100% or more the centre shows a green check
+     * DX-4062 / DX-4257 — done state: at 100% or more the centre shows a green check
      * (the library's `check` icon) instead of "100%". Below 100% nothing changes.
-     * Off by default so no existing ring changes; it takes the place of the
-     * number, so it has no effect with `showValue={false}`.
+     * On by default; pass `false` for a ring whose full value must still read as a
+     * number. It takes the place of the number, so it has no effect with
+     * `showValue={false}`.
      */
     checkWhenFull?: boolean;
     className?: string;

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

@@ -0,0 +1,33 @@
+import { type ButtonProps } from "./Button";
+export type SortDirection = "asc" | "desc";
+export interface SortOption<Field extends string = string> {
+    value: Field;
+    /** The field as a person names it ("Name", "Created"). */
+    label: string;
+    /**
+     * What each direction means for THIS field, in the words that fit it
+     * ("A to Z" / "Z to A", "Oldest first" / "Newest first"). Absent, the
+     * directions read "Ascending" / "Descending". It names the arrows to
+     * assistive technology and appears in their tooltips, so a person is never
+     * left decoding which way an arrow sorts a date.
+     */
+    directions?: {
+        asc: string;
+        desc: string;
+    };
+}
+export interface SortValue<Field extends string = string> {
+    field: Field;
+    direction: SortDirection;
+}
+export interface SortMenuProps<Field extends string = string> {
+    options: readonly SortOption<Field>[];
+    value: SortValue<Field>;
+    onValueChange: (value: SortValue<Field>) => void;
+    /** Names the control for assistive technology, e.g. "Sort plans". The active order is appended to it. */
+    "aria-label": string;
+    size?: ButtonProps["size"];
+    align?: "start" | "center" | "end";
+    className?: string;
+}
+export declare function SortMenu<Field extends string = string>({ options, value, onValueChange, "aria-label": ariaLabel, size, align, className, }: SortMenuProps<Field>): import("react").JSX.Element;

package/dist/types/components/overlay-shell.d.ts

@@ -16,3 +16,23 @@ export declare const OVERLAY_POPUP_SURFACE = "dx-ground-overlay rounded-xl borde
  *  different transform: `Dialog` scales in place, `CommandPalette` also
  *  drifts up a couple pixels), so it is deliberately not included here. */
 export declare const OVERLAY_POPUP_MOTION: string[];
+/** The surface of every popup ANCHORED to a control — `Menu`, `Select`,
+ *  `Combobox`, `MultiCombobox`, `Popover` (DX-4265). Same paint as
+ *  `OVERLAY_POPUP_SURFACE` minus the modal panel's radius, so the five
+ *  stop hand-copying it. `bg-surface-overlay` is opaque in both themes.
+ *  `dx-ground-overlay` tells the interaction ramp what the popup is painted ON:
+ *  without it every hover inside mixes from `--surface`, which on dark is two
+ *  ramp steps below `--surface-overlay`, so the hover fill lands DARKER than
+ *  the popup and reads as nothing happening (tokens.css). */
+export declare const ANCHORED_POPUP_SURFACE = "dx-ground-overlay rounded-lg border border-border bg-surface-overlay shadow-lg outline-none";
+/** The motion every `ANCHORED_POPUP_SURFACE` consumer shares.
+ *
+ *  DX-4265: ENTRY DOES NOT FADE. Opacity animates the whole element, background
+ *  included, so a popup that fades in is see-through for its first
+ *  `--dur-slow`: the page behind it reads through the option list. That is
+ *  invisible in dark, where popup and page are both near-black, and obvious in
+ *  light, where the list is white text-on-white over page text; it was filed as
+ *  "the light popup is translucent" when the surface token was opaque all along.
+ *  The popup arrives by scale + a one-step drift, opaque from the first frame.
+ *  EXIT still fades: a closing popup being see-through says "leaving". */
+export declare const ANCHORED_POPUP_MOTION: string[];

package/dist/types/components/rbac/ApiKeysPanel.d.ts

@@ -3,8 +3,9 @@ import type { Permission, Role } from "./types";
 export interface ApiKey {
     id: number;
     name: string;
-    /** The `Role.id` this key acts with. */
-    roleId: string;
+    /** The label of the role this key acts with. A label, not an id: a key can carry a role of a team other than the one whose
+     *  `roles` the create dialog offers, and only the consumer's server can name that one. */
+    roleLabel: string;
     /** ISO instant. */
     createdAt: string;
     /** ISO instant, or `null`/omitted if it has never been used. */
@@ -17,7 +18,7 @@ export interface ApiKeysPanelProps {
     keys: ApiKey[];
     /** Keys a worker minted on the person's behalf; listed and revocable, never created here. Omitted or empty hides the group. */
     agentKeys?: ApiKey[];
-    /** Every role a key could carry; also resolves each listed key's role label. */
+    /** The roles the create dialog offers. */
     roles: Role[];
     /** The permission catalog, used to name the permissions that make a role unavailable. */
     permissions: Permission[];

package/dist/types/index.d.ts

@@ -57,6 +57,7 @@ export { OTPInput, type OTPInputProps } from "./components/OTPInput";
 export { Combobox, ComboboxItem, ComboboxGroup, MultiCombobox, type ComboboxProps, type ComboboxItemProps, type ComboboxGroupProps, type MultiComboboxProps, } from "./components/Combobox";
 export { Select, SelectItem, SelectGroup, SelectSeparator, type SelectProps, type SelectItemProps, type SelectGroupProps, } from "./components/Select";
 export { StatusSelect, type StatusSelectProps, type StatusOption } from "./components/StatusSelect";
+export { SortMenu, type SortMenuProps, type SortOption, type SortValue, type SortDirection } from "./components/SortMenu";
 export { Card, CardHeader, CardFooter, type CardProps, type CardHeaderProps, } from "./components/Card";
 export { RecordCard, RecordCardHandle, RecordCardEyebrow, RecordCardTitle, RecordCardBadges, RecordCardMedia, RecordCardMeta, type RecordCardProps, type RecordCardMetric, type RecordCardHandleProps, type RecordCardEyebrowProps, type RecordCardTitleProps, type RecordCardBadgesProps, type RecordCardMediaProps, type RecordCardMetaProps, } from "./components/RecordCard";
 export { Tabs, TabList, Tab, TabPanel, type TabsProps, type TabListProps, type TabProps, type TabPanelProps, } from "./components/Tabs";

package/package.json

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