@danxbot/ui 16.1.0 → 16.2.1

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

@@ -259,7 +259,10 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * 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.
+         * is a hair short of a 16px line and leaves the ring floating in it. Its
+         * track is thinner than every other size's (`RING_GEOMETRY`), so the icon
+         * fits inside it. Like `xs`, always pair with `showValue={false}`: two
+         * digits do not fit a 16px circle, and nothing clips or shrinks them.
          */
         row: "size-4";
         sm: "size-10";
@@ -290,7 +293,10 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * 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.
+         * is a hair short of a 16px line and leaves the ring floating in it. Its
+         * track is thinner than every other size's (`RING_GEOMETRY`), so the icon
+         * fits inside it. Like `xs`, always pair with `showValue={false}`: two
+         * digits do not fit a 16px circle, and nothing clips or shrinks them.
          */
         row: "size-4";
         sm: "size-10";
@@ -321,7 +327,10 @@ declare const ring: import("tailwind-variants").TVReturnType<{
          * 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.
+         * is a hair short of a 16px line and leaves the ring floating in it. Its
+         * track is thinner than every other size's (`RING_GEOMETRY`), so the icon
+         * fits inside it. Like `xs`, always pair with `showValue={false}`: two
+         * digits do not fit a 16px circle, and nothing clips or shrinks them.
          */
         row: "size-4";
         sm: "size-10";

package/dist/types/components/focus-web/layout.d.ts

@@ -30,3 +30,26 @@ export interface PlacedRingNode {
  * against its own node array by index without a lookup.
  */
 export declare function layoutRing(ids: readonly string[], threshold?: number): PlacedRingNode[];
+/** One slot's measured vertical box, for `labelOverhang`. `height` is the slot body's own layout height (disc plus
+    label), `disc` the disc's diameter: both in px, both read untransformed so a glide in flight cannot skew them. */
+export interface SlotBox {
+    topPct: number;
+    height: number;
+    disc: number;
+    placement: "above" | "below" | "beside";
+    /** A caller's own body: centred whole on its point (see `slotTranslate` in FocusWeb.tsx). */
+    custom: boolean;
+}
+/**
+ * DX-4219: how far the slots' boxes run above and below the plane's own `planeHeight`-px box. The plane is a fixed
+ * aspect ratio and the ring sits at fixed percentages of it, so a top node's label (it grows UP from its disc) or a
+ * bottom node's (it grows DOWN) leaves the plane by however many lines it wraps to — into whatever sits above or
+ * below the web. The component pads the web by exactly this, so every label sits inside the web's own area.
+ *
+ * The vertical placement mirrors `slotTranslate` in FocusWeb.tsx: that function is the one place the slot's
+ * `translate` is decided, and this is its arithmetic on measured sizes.
+ */
+export declare function labelOverhang(boxes: readonly SlotBox[], planeHeight: number): {
+    top: number;
+    bottom: number;
+};

package/package.json

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