@danxbot/ui 15.35.0 → 15.37.0

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

@@ -254,6 +254,14 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * clips or shrinks them automatically if you leave the number on.
          */
         xs: "size-3.5";
+        /**
+         * DX-4099 — the ring that fills exactly ONE text line (1rem, the line
+         * unit of a card face row, `leading-4`), with nothing around it. Built to
+         * carry an `xs` icon in its centre (`children`, `showValue={false}`): the
+         * ring is the indicator and the icon says what it indicates. `xs` (14px)
+         * is a hair short of a 16px line and leaves the ring floating in it.
+         */
+        row: "size-4";
         sm: "size-10";
         md: "size-16";
         lg: "size-24";
@@ -277,6 +285,14 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * clips or shrinks them automatically if you leave the number on.
          */
         xs: "size-3.5";
+        /**
+         * DX-4099 — the ring that fills exactly ONE text line (1rem, the line
+         * unit of a card face row, `leading-4`), with nothing around it. Built to
+         * carry an `xs` icon in its centre (`children`, `showValue={false}`): the
+         * ring is the indicator and the icon says what it indicates. `xs` (14px)
+         * is a hair short of a 16px line and leaves the ring floating in it.
+         */
+        row: "size-4";
         sm: "size-10";
         md: "size-16";
         lg: "size-24";
@@ -300,6 +316,14 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * clips or shrinks them automatically if you leave the number on.
          */
         xs: "size-3.5";
+        /**
+         * DX-4099 — the ring that fills exactly ONE text line (1rem, the line
+         * unit of a card face row, `leading-4`), with nothing around it. Built to
+         * carry an `xs` icon in its centre (`children`, `showValue={false}`): the
+         * ring is the indicator and the icon says what it indicates. `xs` (14px)
+         * is a hair short of a 16px line and leaves the ring floating in it.
+         */
+        row: "size-4";
         sm: "size-10";
         md: "size-16";
         lg: "size-24";
@@ -334,6 +358,31 @@ export interface ProgressRingSegment {
      */
     label: string;
 }
+/**
+ * DX-4099 — what sits in the middle of the ring, as ONE union so the number,
+ * the done check and a caller's own glyph never compete. `children` is only
+ * accepted with `showValue={false}`: a glyph drawn over the percentage would be
+ * two things in one 14-16px circle, and a silent "which wins" rule is exactly
+ * what the `segments`/`value` union below exists to avoid. The glyph is
+ * decoration (`aria-hidden`); the ring's role, name and description are
+ * unchanged and carry the meaning.
+ */
+type ProgressRingCentre = {
+    /**
+     * Draw the number in the middle. On by default, which is the behaviour this
+     * component has always had.
+     *
+     * Worth turning off on a `sm` ring used as an affordance rather than a
+     * readout — two digits inside a 40px circle is a number nobody reads and a
+     * ring nobody can see past.
+     */
+    showValue?: true;
+    children?: never;
+} | {
+    showValue: false;
+    /** A decorative glyph centred over the ring, e.g. `<Icon name="file-code" size="xs" />`. */
+    children?: ReactNode;
+};
 interface ProgressRingBase extends VariantProps<typeof ring> {
     /**
      * REQUIRED, and a plain string.
@@ -345,15 +394,6 @@ interface ProgressRingBase extends VariantProps<typeof ring> {
      * of this component existing.
      */
     label: string;
-    /**
-     * Draw the number in the middle. On by default, which is the behaviour this
-     * component has always had.
-     *
-     * Worth turning off on a `sm` ring used as an affordance rather than a
-     * readout — two digits inside a 40px circle is a number nobody reads and a
-     * ring nobody can see past.
-     */
-    showValue?: boolean;
     /**
      * DX-4062 — opt-in done state: at 100% or more the centre shows a green check
      * (the library's `check` icon) instead of "100%". Below 100% nothing changes.
@@ -364,13 +404,13 @@ interface ProgressRingBase extends VariantProps<typeof ring> {
     className?: string;
 }
 /** A ring showing ONE number. `null` is "working, length unknown". */
-export interface ProgressRingValueProps extends ProgressRingBase {
+export type ProgressRingValueProps = ProgressRingBase & ProgressRingCentre & {
     value: number | null;
     tone?: ProgressTone;
     segments?: never;
     total?: never;
     remainderLabel?: never;
-}
+};
 /**
  * A ring showing a BREAKDOWN: contiguous arcs around one circle.
  *
@@ -378,7 +418,7 @@ export interface ProgressRingValueProps extends ProgressRingBase {
  * `value` and `segments` does not type-check. There is no precedence rule to
  * learn and no silent winner.
  */
-export interface ProgressRingSegmentsProps extends ProgressRingBase {
+export type ProgressRingSegmentsProps = ProgressRingBase & ProgressRingCentre & {
     /** Drawn in order, starting at twelve o'clock and running clockwise. */
     segments: ProgressRingSegment[];
     /**
@@ -431,7 +471,7 @@ export interface ProgressRingSegmentsProps extends ProgressRingBase {
     centerValue?: number;
     value?: never;
     tone?: never;
-}
+};
 export type ProgressRingProps = ProgressRingValueProps | ProgressRingSegmentsProps;
 /** One arc, resolved to the two fractions an SVG dash actually needs. */
 export interface ProgressRingArc {

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

@@ -6,6 +6,11 @@ export interface ProfilePageProps {
     onSave?: (input: ProfileFormSaveInput) => Promise<void>;
     onUploadAvatar?: (file: File) => Promise<string>;
     onAvatarChange?: (avatarUrl: string | null) => void;
+    /** DX-4029: `false` omits the page's own title text (the `<h1>` and the
+     *  team-name line) so a host layout can own the screen's one `<h1>`. The
+     *  read-only avatar (content, not title) stays, and the default `true` is
+     *  the unchanged render. */
+    heading?: boolean;
     className?: string;
 }
-export declare function ProfilePage({ account, onSave, onUploadAvatar, onAvatarChange, className }: ProfilePageProps): import("react").JSX.Element;
+export declare function ProfilePage({ account, onSave, onUploadAvatar, onAvatarChange, heading, className, }: ProfilePageProps): import("react").JSX.Element;

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

@@ -17,6 +17,8 @@ export interface RolesPermissionsPageProps {
     onResetRole?: (roleId: string) => void;
     /** The id of a role currently mid-mutation. Disables just that row's controls, not the whole page. */
     busyRoleId?: string | null;
+    /** DX-4029: `false` omits the page's own title text (the `<h1>` and the explanatory line) so a host layout can own the screen's one `<h1>`. The "New role" button stays: it is the only create-role entry point. Default `true` is the unchanged render. */
+    heading?: boolean;
     className?: string;
 }
-export declare function RolesPermissionsPage({ roles, permissions, editable, onChangePermission, onCreateRole, onRenameRole, onDeleteRole, onResetRole, busyRoleId, className, }: RolesPermissionsPageProps): import("react").JSX.Element;
+export declare function RolesPermissionsPage({ roles, permissions, editable, onChangePermission, onCreateRole, onRenameRole, onDeleteRole, onResetRole, busyRoleId, heading, className, }: RolesPermissionsPageProps): import("react").JSX.Element;

package/package.json

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