@danxbot/ui 15.12.3 → 15.13.0

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

@@ -395,6 +395,33 @@ export interface ProgressRingSegmentsProps extends ProgressRingBase {
      * and readers act on different halves of it.
      */
     remainderLabel?: string;
+    /**
+     * Overrides the centre number — and `aria-valuenow` with it — instead of
+     * the library's own `percentOf(used, total)`.
+     *
+     * DX-3766: `percentOf(used, total)` answers "how much of what's DRAWN is
+     * used", which is the right fact only when the segments are a partial fill
+     * (a context window, a disk budget) with real room left on the track. A
+     * caller who draws every category that makes up the whole — a plan
+     * header's In Progress/Ready/Archive/Review/Done breakdown, where the
+     * segments ARE the total by construction — gets a permanent, useless 100%
+     * out of that formula, because `used` always equals `total`. There is no
+     * way to get a DIFFERENT number (e.g. "Done ÷ total") out of the segments
+     * without either lying about what's drawn or losing the multi-arc colour
+     * breakdown entirely.
+     *
+     * A plain number, read the same way the computed percent is: rounded for
+     * display, and separately clamped to [0, 100] for `aria-valuenow` (which
+     * `aria-valuemax` already declares as the ceiling) — the visible digit
+     * still shows the caller's real number even past 100, exactly as the
+     * computed percent does on an over-sum ring; only the announced value is
+     * bounded.
+     *
+     * The ring's description (`aria-describedby`) is NOT affected — it still
+     * names the true segment breakdown, because that fact doesn't change just
+     * because the centre is showing a different number.
+     */
+    centerValue?: number;
     value?: never;
     tone?: never;
 }

package/package.json

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