@danxbot/ui 15.36.0 → 15.38.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/chat/Attachment.d.ts

@@ -53,6 +53,9 @@ export interface AttachmentActionProps {
     /**
      * On a tile the buttons sit over imagery, so they need their own ground —
      * and they FADE IN on hover rather than sitting permanently over the picture.
+     * A device with no hover at all (`(hover: none)`, a phone or tablet) has
+     * nothing to fade them in with, so there they are visible at rest (DX-4039);
+     * keyboard focus still reveals them on a hover-capable one.
      *
      * Pass `layout === "tile"`. Getting it wrong is not a style preference: a
      * tinted control on a row is dark-on-dark, and an untinted one on a tile is
@@ -105,7 +108,7 @@ export interface AttachmentPreviewProps {
  * Video is recognised by mime type OR extension, because attachments from chat
  * integrations arrive as `application/octet-stream`.
  */
-export declare function AttachmentPreview({ file, onOpenChange, onDownload, renderBody, }: AttachmentPreviewProps): import("react").JSX.Element;
+export declare function AttachmentPreview({ file: openFile, onOpenChange, onDownload, renderBody, }: AttachmentPreviewProps): import("react").JSX.Element;
 export interface AttachmentListProps {
     files: ChatFile[];
     layout?: AttachmentLayout;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "15.36.0",
+  "version": "15.38.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",
@@ -74,7 +74,7 @@
     "gates": "npm run shoot && npm run a11y && node scripts/shoot-overlays.mjs && npm run probe",
     "a11y": "node scripts/a11y-scan.mjs",
     "shoot": "node scripts/shoot.mjs",
-    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs && node scripts/probe-tabs-overflow.mjs && node scripts/probe-stat-row.mjs && node scripts/probe-packaging.mjs && node scripts/probe-containment.mjs && node scripts/probe-popover-containment.mjs && node scripts/probe-popover-panel-width.mjs && node scripts/probe-theme-menu-overflow.mjs && node scripts/probe-shell.mjs && node scripts/probe-nav-trigger-tap-target.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.mjs && node scripts/probe-read-more.mjs && node scripts/probe-section-nav.mjs",
+    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs && node scripts/probe-tabs-overflow.mjs && node scripts/probe-stat-row.mjs && node scripts/probe-packaging.mjs && node scripts/probe-containment.mjs && node scripts/probe-popover-containment.mjs && node scripts/probe-popover-panel-width.mjs && node scripts/probe-theme-menu-overflow.mjs && node scripts/probe-shell.mjs && node scripts/probe-nav-trigger-tap-target.mjs && node scripts/probe-attachment-touch.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.mjs && node scripts/probe-read-more.mjs && node scripts/probe-section-nav.mjs",
     "sync": "node scripts/sync.mjs",
     "visual": "node scripts/visual-docker.mjs",
     "visual:update": "node scripts/visual-docker.mjs --update-snapshots",